OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Paralel arama

Parallel plugin, her ikisi de yapay zekâ ajanları için oluşturulmuş bir web dizininden sıralanmış, LLM için optimize edilmiş alıntılar döndüren iki Parallel web_search sağlayıcısı sunar:

Sağlayıcı id Kimlik doğrulama
Parallel Search (Ücretsiz) parallel-free Yok -- Parallel'ın ücretsiz Search MCP hizmeti
Parallel Search parallel PARALLEL_API_KEY -- ücretli Search API, daha yüksek hız sınırları ve hedef ayarlama

Birini açıkça seçmek için tools.web.search.provider değerini parallel-free veya parallel olarak ayarlayın; ikisi de otomatik olarak algılanmaz.

Plugin'i yükleme

bash
openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restart

API anahtarı (ücretli sağlayıcı)

parallel-free anahtar gerektirmez ancak yine de açıkça seçilmelidir. Ücretli parallel sağlayıcısı bir API anahtarı gerektirir:

  • Hesap oluşturma

    platform.parallel.ai adresinden kaydolun ve kontrol panelinizden bir API anahtarı oluşturun.

  • Anahtarı saklama

    Gateway ortamında PARALLEL_API_KEY değişkenini ayarlayın veya şu komutla yapılandırın:

    bash
    openclaw configure --section web

    • Yapılandırma

    json5
    {  plugins: {    entries: {      parallel: {        config: {          webSearch: {            apiKey: "par-...", // PARALLEL_API_KEY ayarlanmışsa isteğe bağlı            baseUrl: "https://api.parallel.ai", // isteğe bağlı; OpenClaw /v1/search ekler          },        },      },    },  },  tools: {    web: {      search: {        // ücretsiz Search MCP için "parallel-free" veya burada gösterilen        // ücretli API destekli sağlayıcı için "parallel".        provider: "parallel",      },    },  },}

    Ortam alternatifi: Gateway ortamında PARALLEL_API_KEY değişkenini ayarlayın. Bir gateway kurulumu için bunu ~/.openclaw/.env içine yerleştirin.

    Temel URL'yi geçersiz kılma

    Yalnızca ücretli parallel sağlayıcısı için geçerlidir; parallel-free her zaman https://search.parallel.ai/mcp kullanır ve bu ayarı yok sayar.

    Ücretli istekleri uyumlu bir proxy veya alternatif uç nokta (örneğin Cloudflare AI Gateway) üzerinden yönlendirmek için plugins.entries.parallel.config.webSearch.baseUrl değerini ayarlayın. OpenClaw, başına https:// ekleyerek yalnızca ana makine adından oluşan adresleri normalleştirir ve yol zaten bununla bitmiyorsa /v1/search ekler. Çözümlenen uç nokta, arama önbelleği anahtarının bir parçasıdır; bu nedenle farklı uç noktalardan gelen sonuçlar hiçbir zaman paylaşılmaz.

    Araç parametreleri

    Her iki sağlayıcı da Parallel'ın yerel arama biçimini sunar; böylece model, doğal dilde bir hedef ile birkaç kısa anahtar sözcük sorgusunu doldurur. Bu eşleştirme, en iyi sonuçlar için Parallel tarafından önerilir.

    objectivestringrequired

    Temel sorunun veya hedefin doğal dilde açıklaması (en fazla 5000 karakter). Kendi başına anlaşılır olmalıdır.

    search_queriesstring[]required

    Kısa anahtar sözcük arama sorguları; her biri 3-6 sözcük (1-5 girdi, her biri en fazla 200 karakter). En iyi sonuçlar için birbirinden farklı 2-3 sorgu sağlayın.

    countnumber

    Döndürülecek sonuç sayısı (1-40).

    session_idstring

    Önceki bir sonucun sessionId alanından alınan isteğe bağlı Parallel oturum kimliği. Parallel'ın ilgili çağrıları gruplandırması ve sonraki sonuçları iyileştirmesi için aynı görevdeki takip aramalarına bunu aktarın. parallel üzerinde en fazla 1000 karakterdir; ücretsiz parallel-free Search MCP bunu 100 ile sınırlar. Sınırı aşan bir kimlik kaldırılır (ücretli) veya yeni bir kimlik oluşturulur (ücretsiz).

    client_modelstring

    Çağrıyı yapan modelin isteğe bağlı tanımlayıcısı (ör. claude-opus-4-7, gpt-5.6-sol); en fazla 100 karakter. Parallel'ın varsayılan ayarları modelinizin yeteneklerine göre uyarlamasını sağlar. Etkin modelin tam kısa adını aktarın; bir aile takma adına kısaltmayın.

    Notlar

    • Parallel, sonuçları insanların bağlantılara tıklaması için değil, LLM akıl yürütme faydası için sıralar ve sıkıştırır; tam sayfa içerik yerine sonuç başına yoğun alıntılar bekleyin.
    • Sonuç alıntıları excerpts dizisi olarak döner ve genel web_search sözleşmesiyle uyumluluk için description içinde de birleştirilir.
    • Her iki sağlayıcı da bir session_id döndürür; OpenClaw, çağıranların takip aramalarını gruplandırabilmesi için bunu araç yükünde sessionId olarak sunar. Parallel tarafından oluşturulan bir oturum kimliği (çağıranın sağlamadığı bir kimlik), aynı sorgulara sahip ilgisiz görevlerin bunu devralmaması için önbellek girdisine dahil edilmez.
    • Parallel'dan gelen searchId, warnings ve usage, mevcut olduklarında değiştirilmeden aktarılır.
    • OpenClaw, çözümlenmiş sonuç sayısını Parallel'a her zaman advanced_settings.max_results (parallel) olarak iletir veya Parallel'ın sabit boyutlu yanıtından sonra istemci tarafında count uygular (parallel-free). Önce çağıranın count argümanı, ardından tools.web.search.maxResults, aksi hâlde OpenClaw'ın genel web_search varsayılanı (5) geçerlidir; Parallel'ın kendi API varsayılanı 10'dur.
    • Sonuçlar varsayılan olarak 15 dakika önbelleğe alınır (cacheTtlMinutes).
    • Çağıran bir kimlik sağlamadığında parallel-free, MCP el sıkışması aracılığıyla her çağrı için yeni bir session_id oluşturur; parallel ise bu durumda değeri ayarlanmamış bırakır.

    İlgili

    Was this useful?
    On this page

    On this page