Tools
Tavily
Tavily adalah API pencarian yang dirancang untuk aplikasi AI. OpenClaw mengeksposnya dalam dua cara:
- sebagai penyedia
web_searchuntuk alat pencarian generik - sebagai alat Plugin eksplisit:
tavily_searchdantavily_extract
Tavily mengembalikan hasil terstruktur yang dioptimalkan untuk konsumsi LLM dengan kedalaman pencarian yang dapat dikonfigurasi, pemfilteran topik, filter domain, ringkasan jawaban yang dihasilkan AI, dan ekstraksi konten dari URL (termasuk halaman yang dirender JavaScript).
| Properti | Nilai |
|---|---|
| ID Plugin | tavily |
| Paket | @openclaw/tavily-plugin |
| Autentikasi | TAVILY_API_KEY atau config apiKey |
| URL Dasar | https://api.tavily.com (default) |
| Alat | tavily_search, tavily_extract |
Memulai
Install the plugin
openclaw plugins install @openclaw/tavily-pluginGet an API key
Buat akun Tavily di tavily.com, lalu buat kunci API di dasbor.
Configure the plugin and provider
{ plugins: { entries: { tavily: { enabled: true, config: { webSearch: { apiKey: "tvly-...", // optional if TAVILY_API_KEY is set baseUrl: "https://api.tavily.com", }, }, }, }, }, tools: { web: { search: { provider: "tavily", }, }, },}Verify search runs
Picu web_search dari agen mana pun, atau panggil tavily_search secara langsung.
Referensi alat
tavily_search
Gunakan ini saat Anda menginginkan kontrol pencarian khusus Tavily alih-alih web_search generik.
| Parameter | Jenis | Batasan / default | Deskripsi |
|---|---|---|---|
query |
string | wajib | String kueri pencarian. Jaga agar di bawah 400 karakter. |
search_depth |
enum | basic (default), advanced |
advanced lebih lambat tetapi relevansinya lebih tinggi. |
topic |
enum | general (default), news, finance |
Filter berdasarkan keluarga topik. |
max_results |
integer | 1-20 | Jumlah hasil. |
include_answer |
boolean | default false |
Sertakan ringkasan jawaban yang dihasilkan AI Tavily. |
time_range |
enum | day, week, month, year |
Filter hasil berdasarkan kebaruan. |
include_domains |
array string | (tidak ada) | Hanya sertakan hasil dari domain ini. |
exclude_domains |
array string | (tidak ada) | Kecualikan hasil dari domain ini. |
Tradeoff kedalaman pencarian:
| Kedalaman | Kecepatan | Relevansi | Paling cocok untuk |
|---|---|---|---|
basic |
Lebih cepat | Tinggi | Kueri serbaguna (default). |
advanced |
Lebih lambat | Tertinggi | Riset presisi dan pencarian fakta. |
tavily_extract
Gunakan ini untuk mengekstrak konten bersih dari satu atau beberapa URL. Menangani halaman yang dirender JavaScript dan mendukung pemotongan berbasis kueri untuk ekstraksi terarah.
| Parameter | Jenis | Batasan / default | Deskripsi |
|---|---|---|---|
urls |
array string | wajib, 1-20 | URL untuk mengekstrak konten. |
query |
string | (opsional) | Urutkan ulang potongan yang diekstrak berdasarkan relevansi terhadap kueri ini. |
extract_depth |
enum | basic (default), advanced |
Gunakan advanced untuk halaman berat JS, SPA, atau tabel dinamis. |
chunks_per_source |
integer | 1-5; memerlukan query |
Potongan yang dikembalikan per URL. Error jika diatur tanpa query. |
include_images |
boolean | default false |
Sertakan URL gambar dalam hasil. |
Tradeoff kedalaman ekstraksi:
| Kedalaman | Kapan digunakan |
|---|---|
basic |
Halaman sederhana. Coba ini terlebih dahulu. |
advanced |
SPA yang dirender JS, konten dinamis, tabel. |
Memilih alat yang tepat
| Kebutuhan | Alat |
|---|---|
| Pencarian web cepat, tanpa opsi khusus | web_search |
| Pencarian dengan kedalaman, topik, jawaban AI | tavily_search |
| Ekstrak konten dari URL tertentu | tavily_extract |
Konfigurasi lanjutan
API key resolution order
Klien Tavily mencari kunci API-nya dalam urutan ini:
plugins.entries.tavily.config.webSearch.apiKey(di-resolve melalui SecretRefs).TAVILY_API_KEYdari lingkungan gateway.
tavily_extract memunculkan error penyiapan jika tidak ada yang tersedia.
Custom base URL
Timpa plugins.entries.tavily.config.webSearch.baseUrl jika Anda menempatkan Tavily di belakang proxy. Default-nya adalah https://api.tavily.com.
`chunks_per_source` requires `query`
tavily_extract menolak panggilan yang meneruskan chunks_per_source tanpa query. Tavily memeringkat potongan berdasarkan relevansi kueri, sehingga parameter ini tidak bermakna tanpa kueri.
