Bu rehberde: Yapay zekâ ajanları için tasarlanmış arama servisi Tavily'yi bağlarsınız. Ücretsiz ayda 1.000 kredi verir. Serper'a alternatif veya tamamlayıcıdır.
⏱ 5 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | TAVILY |
| Kategori | Araştırma |
| Kimlik doğrulama | API anahtarı |
| Kapsam | Organizasyon geneli |
| Webhook | Hayır |
| Yetenekler | Web araması |
| Kullanan kutular | Web araması |
| Kullanan ajanlar | Market Analyst, Competitor Analyst, SEO & Traffic, Content Creator, Lead Researcher, Custom |
Ne işe yarar?
Tavily sorguya doğrudan yanıt, sonuç başına temizlenmiş içerik özeti ve alan adı filtreleri sunar. Pazar araştırması ve uzun içerik özetlemede daha az token harcatır.
Ön koşullar
- app.tavily.com hesabı. Ücretsiz plan ayda 1.000 kredi.
Adım adım kurulum
A) Tavily
- app.tavily.com → kaydolun. Sol menü ① API Keys → + Create.
- ② Ad verin (örneğin
orqlabs). ③ Üretim için Production anahtarı seçin; Development anahtarları düşük hız sınırına sahiptir.
- ①
tvly-...anahtarını kopyalayın. ② Usage sayfasında kalan kredi.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Tavily → Bağla. ② Organizasyon geneli.
- ① API key →
tvly-.... - ③ Bağla. Bağlantıyı test et tek bir arama yapar (1 kredi).
Kredi sistemi
| İşlem | Kredi | OrqLabs'ta ne zaman |
|---|---|---|
| Arama (basic) | 1 | Web araması kutusu, ajan araması |
| Arama (advanced) | 2 | Market Analyst derin tarama |
Yanıt (include_answer) | Aramaya dahil | Ajan sorusuna doğrudan yanıt |
Tipik tüketim: Market Analyst standart 15-25 kredi, derin 40-80; Content Creator 0-3.
Limitler
| Konu | Sınır |
|---|---|
| Ücretsiz plan | 1.000 kredi/ay |
| Hız sınırı | Development 100 istek/dk; Production 1.000 istek/dk |
| Sonuç | İstek başına en fazla 20 |
| Sorgu uzunluğu | 400 karakter |
| Ülke | Sınırlı; Türkçe sonuçlar için sorguyu Türkçe yazın |
Bağlantıyı test etme
② Bağlantıyı test et kısa bir arama yapıp kalan krediyi döndürür.
Kimlik bilgilerini yenileme
- API Keys → eski anahtarı silin, yeni oluşturun → entegrasyon kartı → Kimlik bilgileri → Güncelle → API key.
- Kredi bittiğinde 432/429 döner; plan yükseltin veya ay başını bekleyin.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AUTH – 401 | Anahtar yanlış | Yeni anahtar |
RATE_LIMIT – 429 | Development anahtar 100/dk | Production anahtarı |
RATE_LIMIT – 432 "Usage limit exceeded" | Aylık kredi bitti | Plan yükseltin |
INVALID – 400 "query too long" | 400 karakter aşımı | Sorguyu kısaltın |
| Sonuçlar İngilizce ağırlıklı | Ülke hedefleme zayıf | Sorguyu Türkçe yazın |
Sık sorulan sorular
Serper varken Tavily gerekir mi? Zorunlu değil. Tavily uzun içerik özetlemede daha verimlidir; Serper aday araştırmada. İkisi de bağlıysa ajan türüne göre seçersiniz.
Kredi nasıl hesaplanır? Basit arama 1, gelişmiş arama 2 kredi. Market Analyst derin taramada gelişmiş arama kullanır.