Lewati ke isi
ID
Dapatkan kunci API

Aliran Kerja / Python

Tambahkan Google dan YouTube alat pencarian ke agen AI

Lipat permintaan pencarian dan transkrip sebagai Python alat, simpan referensi sumber dan biarkan agen Anda memilih kapan untuk mengambil data.

FlashData · Diterbitkan

Seorang agen terhubung ke web search and video data tools

Tentukan batas alat

Berikan alat kecil Anda dengan masukan dan keluaran yang jelas: cari di web, video discover, dan baca transkrip video yang tersedia. Agenmu memilih kapan menghubungi mereka dan bagaimana menggunakan bukti.

Kode di bawah ini menyediakan fungsi pengambilan. Daftarkan mereka dengan kerangka kerja agen yang ada; mereka bekerja secara independen dengan model atau perpustakaan orkestra mana yang Anda pilih.

bash
# Replace YOUR_API_KEY near the top of the code below.

Implement perangkat pengambilan

Berikut Python 3 kode menggunakan perpustakaan standar. Simpan sebagai tools.py. Menjalankan secara langsung membuat satu permintaan pencarian Google; mengimpornya memungkinkan aplikasi Anda mendaftarkan tiga fungsi sebagai alat.

python
import json
import gzip
import os
import urllib.error
import urllib.request

API_URL = "https://data.flashdata.dev"
API_KEY = "YOUR_API_KEY"


def api_request(path, payload=None, response_headers=None, base_url=API_URL):
    target = path if path.startswith(("https://", "http://")) else base_url + path
    request = urllib.request.Request(
        target,
        data=json.dumps(payload).encode() if payload is not None else None,
        headers={"X-API-Key": API_KEY, "Content-Type": "application/json"},
        method="POST" if payload is not None else "GET",
    )
    with urllib.request.urlopen(request, timeout=60) as response:
        if response_headers is not None:
            response_headers.update(response.headers)
        return json.load(response)


class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, request, file_pointer, code, message, headers, new_url):
        return None


def result_request(url):
    request = urllib.request.Request(url, headers={"X-API-Key": API_KEY}, method="GET")
    try:
        with urllib.request.build_opener(NoRedirect).open(request, timeout=60):
            raise RuntimeError("Results endpoint did not redirect to storage")
    except urllib.error.HTTPError as response:
        if response.code != 302 or not response.headers.get("Location"):
            raise
        storage_url = response.headers["Location"]
        response.close()
    storage_request = urllib.request.Request(storage_url, headers={"Accept-Encoding": "gzip"})
    with urllib.request.urlopen(storage_request, timeout=60) as response:
        body = response.read()
        if response.headers.get("Content-Encoding") == "gzip":
            body = gzip.decompress(body)
        return json.loads(body)["results"]


def search_web(query):
    """Search the web and return titles, URLs and result snippets."""
    response = api_request("/v1/queries/realtime", {
        "source": "google_search", "query": query,
    })
    return response["results"][0]


def find_videos(query):
    """Discover YouTube videos and their video IDs."""
    response = api_request("/v1/queries/realtime", {
        "source": "youtube_search", "query": query,
        "params": {"max_results": 5},
    })
    return response["results"][0]["results"]


def read_video_transcript(video_id, language="en"):
    """Read available captions with timestamps; captions may be unavailable."""
    response = api_request("/v1/queries/realtime", {
        "source": "youtube_transcript", "video_id": video_id,
        "params": {"language": language, "auto": True},
    })
    return response["results"][0]


# Register these functions as tools in your own agent framework.
# The agent chooses when to call them and how to use the evidence.
if __name__ == "__main__":
    print(json.dumps(search_web("distributed systems"), indent=2))
bash
python3 tools.py

Hubungkan perangkat ke agen Anda

Jelaskan argumen dan hasil setiap alat dalam skema alat kerangka kerja Anda. Simpan query, video_id dan language sebagai masukan eksplisit sehingga model dapat meminta data yang dibutuhkan.

  • search_web(query) kembali Google hasil dengan sumber URLs dan snippet.

  • find_videos(query) mengembalikan video dan permintaan IDs untuk diikuti.

  • read_video_transcript(video_id, language) mengembalikan segmen judul yang tersedia dengan penanda waktu.

Kembalikan kesalahan alat yang berguna ketika permintaan gagal atau trek judul tidak tersedia. Terapkan kredit aplikasi Anda dan minta anggaran, dan biarkan agen memutuskan apakah akan mencoba permintaan berbeda atau menggunakan sumber lain.

Simpan sumber dan penanda waktu

Suatu snippet pencarian adalah pratilik dari suatu halaman. Pertahankan URL nya dan hindari memperlakukan snippet sebagai artikel lengkap. Untuk transkrip, simpan video ID, bahasa dan segmen kali sehingga agen dapat mengutip bagian asli.

Untuk dasar pengetahuan video, simpan judul video dan link sumber yang distempel waktu dengan setiap potongan teks. Sistem pengambilan Anda kemudian dapat kembali kedua isi dan referensi yang digunakan untuk mendukung jawaban.