Langkau ke kandungan
MS
Dapatkan kunci API

Aliran kerja / Python

Andikaid Google dan YouTube Alat pencarian ke agen AI

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

FlashData · Diterbitkan

Agen agen yang terhubung ke pencarian web dan alat data video

Takrifkan batas alat

KARENA Anda memberikan alat kecil kepada agen Anda dengan masukan dan keluaran yang jelas: cari web, video discover, dan baca transkrip video yang tersedia. Agenmu memilih kapan untuk menelepon mereka dan bagaimana menggunakan bukti.

Kode di bawah ini memasok fungsi pengambilan kembali. Register mereka dengan kerangka agen Anda yang sudah ada; mereka bekerja secara independen dari model atau perpustakaan orkestra mana yang Anda pilih.

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

Implementasi sarana penerimaan

Kode Python 3 berikut menggunakan standard library. Simpan sebagai tools.py. Menjalankannya 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 alat-alat ke agen Anda

Terangkan argumen setiap alat dan hasilkan skema alat bingkai kerja Anda. Jaga query, video_id Dan language KHAQ sebagai input eksplisit sehingga model dapat meminta data yang dibutuhkan.

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

  • find_videos(query) 2) mengembalikan video dan IDs yang dibutuhkan untuk permintaan susulan.

  • read_video_transcript(video_id, language) 2) mengembalikan segmen kapsi yang tersedia dengan timestamp.

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

Sumber-sumber dan timestamps

Snippet penelusuran snippet adalah suatu preview dari sebuah halaman. Simpan URL-nya dan hindari memperlakukan snippet sebagai artikel lengkap. Untuk transkrip, simpan video ID, waktu bahasa dan segmen sehingga agen dapat mengutip bagian aslinya.

Untuk basis pengetahuan video, simpan judul video dan link sumber bertanda waktu dengan setiap potongan teks. Sistem pengambilan kembali Anda kemudian dapat mengembalikan konten maupun referensi yang digunakan untuk mendukung jawaban.