---
read_when:
- API anahtarı olmadan web araması yapmak istiyorsunuz
- Parallel'ın ücretli Search API'sini istiyorsunuz
- LLM bağlam verimliliğine göre sıralanmış yoğun alıntılar istiyorsunuz
summary: Paralel Arama -- Web kaynaklarından LLM için optimize edilmiş yoğun alıntılar
title: Paralel arama
x-i18n:
generated_at: "2026-07-27T00:09:11Z"
model: gpt-5.6
postprocess_version: locale-links-v1
prompt_version: 32
provider: openai
source_hash: eff693f286015b287bbdacf44f11ff6f07f2f7d2605ef6f09259e7402b40515e
source_path: tools/parallel-search.md
workflow: 16
---
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](https://parallel.ai/) `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](https://docs.parallel.ai/integrations/mcp/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.
Doğrudan OpenAI Responses modelleri (`api: "openai-responses"`, sağlayıcı
`openai`, resmî API temel URL'si), `tools.web.search.provider` ayarlanmamış, boş,
`"auto"` veya `"openai"` olduğunda OpenAI'ın barındırılan yerel web aramasını
otomatik olarak kullanır; dolayısıyla varsayılan olarak Parallel'ı atlar. Bunları
bunun yerine Parallel üzerinden yönlendirmek için `tools.web.search.provider` değerini
`parallel-free` veya `parallel` olarak ayarlayın. Bkz. [Web Aramasına genel bakış](/tr/tools/web).
## Plugin'i yükleme
```bash
openclaw plugins install @openclaw/parallel-plugin
openclaw 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:
[platform.parallel.ai](https://platform.parallel.ai) adresinden kaydolun ve
kontrol panelinizden bir API anahtarı oluşturun.
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](https://docs.parallel.ai/search/best-practices).
Temel sorunun veya hedefin doğal dilde açıklaması (en fazla 5000
karakter). Kendi başına anlaşılır olmalıdır.
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.
Döndürülecek sonuç sayısı (1-40).
Ö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).
Ç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
- [Web Aramasına genel bakış](/tr/tools/web) -- tüm sağlayıcılar ve otomatik algılama
- [Exa araması](/tr/tools/exa-search) -- içerik çıkarımlı sinirsel arama
- [Perplexity Search](/tr/tools/perplexity-search) -- alan adı filtrelemeli yapılandırılmış sonuçlar