> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Exa araması

OpenClaw, `web_search` sağlayıcısı olarak [Exa AI](https://exa.ai/) desteği sunar. Exa
yerleşik içerik çıkarma (vurgular, metin, özetler) ile nöral, anahtar kelime
ve hibrit arama modları sunar.

## Plugin yükle

Resmi Plugin'i yükleyin, ardından Gateway'i yeniden başlatın:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/exa-plugin
openclaw gateway restart
```

## API anahtarı alın

<Steps>
  <Step title="Hesap oluşturun">
    [exa.ai](https://exa.ai/) adresinde kaydolun ve panonuzdan bir API anahtarı
    oluşturun.
  </Step>

  <Step title="Anahtarı saklayın">
    Gateway ortamında `EXA_API_KEY` ayarlayın veya şununla yapılandırın:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw configure --section web
    ```
  </Step>
</Steps>

## Yapılandırma

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      exa: {
        config: {
          webSearch: {
            apiKey: "exa-...", // optional if EXA_API_KEY is set
            baseUrl: "https://api.exa.ai", // optional; OpenClaw appends /search
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "exa",
      },
    },
  },
}
```

**Ortam alternatifi:** Gateway ortamında `EXA_API_KEY` ayarlayın.
Bir gateway kurulumu için bunu `~/.openclaw/.env` içine koyun.

## Temel URL geçersiz kılma

Exa arama isteklerinin uyumlu bir proxy veya alternatif Exa uç noktası
üzerinden gitmesi gerektiğinde `plugins.entries.exa.config.webSearch.baseUrl`
ayarlayın. OpenClaw, çıplak ana bilgisayar adlarını başına `https://` ekleyerek
normalleştirir ve yol zaten orada bitmiyorsa `/search` ekler. Çözümlenen uç
nokta arama önbelleği anahtarına dahil edilir, bu nedenle farklı Exa uç
noktalarından gelen sonuçlar paylaşılmaz.

## Araç parametreleri

<ParamField path="query" type="string" required>
  Arama sorgusu.
</ParamField>

<ParamField path="count" type="number">
  Döndürülecek sonuçlar (1-100).
</ParamField>

<ParamField path="type" type="'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'">
  Arama modu.
</ParamField>

<ParamField path="freshness" type="'day' | 'week' | 'month' | 'year'">
  Zaman filtresi.
</ParamField>

<ParamField path="date_after" type="string">
  Bu tarihten sonraki sonuçlar (`YYYY-MM-DD`).
</ParamField>

<ParamField path="date_before" type="string">
  Bu tarihten önceki sonuçlar (`YYYY-MM-DD`).
</ParamField>

<ParamField path="contents" type="object">
  İçerik çıkarma seçenekleri (aşağıya bakın).
</ParamField>

### İçerik çıkarma

Exa, arama sonuçlarının yanında çıkarılmış içerik döndürebilir. Etkinleştirmek
için bir `contents` nesnesi geçirin:

```javascript theme={"theme":{"light":"min-light","dark":"min-dark"}}
await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // full page text
    highlights: { numSentences: 3 }, // key sentences
    summary: true, // AI summary
  },
});
```

| İçerik seçeneği | Tür                                                                   | Açıklama                    |
| --------------- | --------------------------------------------------------------------- | --------------------------- |
| `text`          | `boolean \| { maxCharacters }`                                        | Tam sayfa metnini çıkar     |
| `highlights`    | `boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }` | Ana cümleleri çıkar         |
| `summary`       | `boolean \| { query }`                                                | AI tarafından üretilen özet |

### Arama modları

| Mod              | Açıklama                           |
| ---------------- | ---------------------------------- |
| `auto`           | Exa en iyi modu seçer (varsayılan) |
| `neural`         | Anlamsal/anlam tabanlı arama       |
| `fast`           | Hızlı anahtar kelime araması       |
| `deep`           | Kapsamlı derin arama               |
| `deep-reasoning` | Akıl yürütmeli derin arama         |
| `instant`        | En hızlı sonuçlar                  |

## Notlar

* `contents` seçeneği sağlanmazsa, Exa varsayılan olarak `{ highlights: true }`
  kullanır, böylece sonuçlar ana cümle alıntıları içerir
* Sonuçlar, mevcut olduğunda Exa API yanıtındaki `highlightScores` ve `summary`
  alanlarını korur
* Sonuç açıklamaları önce vurgulardan, ardından özetten, ardından tam metinden
  çözümlenir; hangisi mevcutsa
* `freshness` ve `date_after`/`date_before` birleştirilemez; tek bir zaman
  filtresi modu kullanın
* Sorgu başına en fazla 100 sonuç döndürülebilir (Exa arama türü sınırlarına
  tabidir)
* Sonuçlar varsayılan olarak 15 dakika önbelleğe alınır (`cacheTtlMinutes`
  ile yapılandırılabilir)
* Exa, yapılandırılmış JSON yanıtları olan resmi bir API entegrasyonudur

## İlgili

* [Web Arama genel bakışı](/tr/tools/web) -- tüm sağlayıcılar ve otomatik algılama
* [Brave Search](/tr/tools/brave-search) -- ülke/dil filtreleriyle yapılandırılmış sonuçlar
* [Perplexity Search](/tr/tools/perplexity-search) -- alan adı filtrelemeyle yapılandırılmış sonuçlar