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

Tools

Tavily

Tavily adalah API pencarian yang dirancang untuk aplikasi AI. OpenClaw menyediakannya dalam dua cara:

  • sebagai penyedia web_search untuk alat pencarian generik
  • sebagai alat Plugin eksplisit: tavily_search dan tavily_extract

Tavily mengembalikan hasil terstruktur yang dioptimalkan untuk digunakan oleh LLM, dengan kedalaman pencarian yang dapat dikonfigurasi, pemfilteran topik, filter domain, ringkasan jawaban yang dihasilkan AI, serta ekstraksi konten dari URL (termasuk halaman yang dirender dengan JavaScript).

Properti Nilai
ID Plugin tavily
Paket @openclaw/tavily-plugin
Autentikasi variabel lingkungan TAVILY_API_KEY atau konfigurasi apiKey
URL dasar https://api.tavily.com (bawaan); variabel lingkungan TAVILY_BASE_URL atau konfigurasi baseUrl untuk menggantinya
Batas waktu pencarian 30 dtk., ekstraksi 60 dtk. (bawaan)
Alat tavily_search, tavily_extract

Memulai

  • Instal Plugin

    bash
    openclaw plugins install @openclaw/tavily-plugin

  • Dapatkan kunci API

    Buat akun Tavily di tavily.com, lalu buat kunci API di dasbor.

  • Konfigurasikan Plugin dan penyedia

    json5
    {  plugins: {    entries: {      tavily: {        enabled: true,        config: {          webSearch: {            apiKey: "tvly-...", // opsional jika TAVILY_API_KEY ditetapkan            baseUrl: "https://api.tavily.com",          },        },      },    },  },  tools: {    web: {      search: {        provider: "tavily",      },    },  },}

  • Verifikasi pencarian berjalan

    Picu web_search dari agen mana pun, atau panggil tavily_search secara langsung.

    • Referensi alat

    Gunakan ini ketika Anda menginginkan kontrol pencarian khusus Tavily, bukan web_search generik.

    Parameter Tipe Batasan / bawaan Deskripsi
    query string wajib String kueri pencarian.
    search_depth enum basic (bawaan), advanced advanced lebih lambat, tetapi relevansinya lebih tinggi.
    topic enum general (bawaan), news, finance Filter berdasarkan kelompok topik.
    max_results integer 1-20, bawaan 5 Jumlah hasil.
    include_answer boolean bawaan 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-domain ini.
    exclude_domains array string (tidak ada) Kecualikan hasil dari domain-domain ini.

    Kompromi kedalaman pencarian:

    Kedalaman Kecepatan Relevansi Paling sesuai untuk
    basic Lebih cepat Tinggi Kueri serbaguna (bawaan).
    advanced Lebih lambat Tertinggi Riset presisi dan pencarian fakta.

    tavily_extract

    Gunakan ini untuk mengekstrak konten bersih dari satu atau beberapa URL. Mendukung halaman yang dirender dengan JavaScript serta pembagian potongan yang berfokus pada kueri untuk ekstraksi tertarget.

    Parameter Tipe Batasan / bawaan Deskripsi
    urls array string wajib, 1-20 URL sumber konten yang akan diekstrak.
    query string (opsional) Urutkan ulang potongan hasil ekstraksi berdasarkan relevansinya dengan kueri ini.
    extract_depth enum basic (bawaan), advanced Gunakan advanced untuk halaman sarat JS, SPA, atau tabel dinamis.
    chunks_per_source integer 1-5; memerlukan query Jumlah potongan yang dikembalikan per URL. Menghasilkan galat jika ditetapkan tanpa query.
    include_images boolean bawaan false Sertakan URL gambar dalam hasil.

    Kompromi kedalaman ekstraksi:

    Kedalaman Waktu penggunaan
    basic Halaman sederhana. Coba ini terlebih dahulu.
    advanced SPA yang dirender JS, konten dinamis, dan tabel.

    Memilih alat yang tepat

    Kebutuhan Alat
    Pencarian web cepat tanpa opsi khusus web_search
    Pencarian dengan kedalaman, topik, jawaban AI tavily_search
    Mengekstrak konten dari URL tertentu tavily_extract

    Konfigurasi lanjutan

    Urutan resolusi kunci API

    Klien Tavily mencari kunci API dalam urutan berikut:

    1. plugins.entries.tavily.config.webSearch.apiKey (diresolusikan melalui SecretRefs).
    2. TAVILY_API_KEY dari lingkungan Gateway.

    tavily_search dan tavily_extract sama-sama memunculkan galat penyiapan jika keduanya tidak tersedia.

    URL dasar khusus

    Ganti plugins.entries.tavily.config.webSearch.baseUrl, atau tetapkan TAVILY_BASE_URL, jika Anda mengakses Tavily melalui proksi. Konfigurasi diprioritaskan daripada variabel lingkungan. Nilai bawaannya adalah https://api.tavily.com.

    `chunks_per_source` memerlukan `query`

    tavily_extract menolak panggilan yang meneruskan chunks_per_source tanpa query. Tavily mengurutkan potongan berdasarkan relevansinya dengan kueri, sehingga parameter tersebut tidak bermakna tanpa kueri.

    Terkait

    Ikhtisar Pencarian Web

    Semua penyedia dan aturan deteksi otomatis.
    Firecrawl

    Pencarian beserta pengambilan data dengan ekstraksi konten.
    Pencarian Exa

    Pencarian neural dengan ekstraksi konten.
    Konfigurasi

    Skema konfigurasi lengkap untuk entri Plugin dan perutean alat.
    Was this useful?
    On this page

    On this page