Ga naar de inhoud
NL
API-sleutel ophalen

Werkstromen / Python

Google en YouTube zoekgereedschappen toevoegen aan een AI-agent

Wrap zoek-en transcript verzoeken als Python tools, behoud bron referenties en laat uw agent kiezen wanneer gegevens te halen.

FlashData · Gepubliceerd

Een agent verbonden met webzoek- en videogegevenstools

Definieer de gereedschapsgrens

Geef uw agent kleine tools met duidelijke ingangen en uitgangen: doorzoek het web, discover video's, en lees een beschikbare video. Je agent kiest wanneer hij ze moet bellen en hoe hij het bewijs moet gebruiken.

De onderstaande code levert de ophaalfuncties. Registreer ze met uw bestaande agent framework; ze werken onafhankelijk van welk model of orkestratie bibliotheek u kiest.

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

Implementeer de ophaaltools

De volgende Python 3 code gebruikt de standaardbibliotheek. Bewaar het als tools.py. Het uitvoeren ervan maakt rechtstreeks een Google zoekopdracht; het importeren ervan laat uw toepassing registreren van de drie functies als gereedschap.

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

Verbind het gereedschap met uw agent

Beschrijf elk hulpmiddel argumenten en resultaten in uw framework tool schema. Houden query, video_id en language als expliciete input zodat het model de benodigde gegevens kan aanvragen.

  • search_web(query) geeft Google resultaten terug met bron URLs en knipsels.

  • find_videos(query) geeft video's terug en de IDs die nodig is voor vervolgverzoeken.

  • read_video_transcript(video_id, language) geeft beschikbare bijschriftsegmenten met tijdstempels terug.

Geef nuttige gereedschapsfouten terug wanneer een verzoek mislukt of een titeltrack niet beschikbaar is. Pas uw applicatie het krediet toe en vraag budgetten aan, en laat de agent beslissen of u een andere query wilt proberen of een andere bron wilt gebruiken.

Bronnen en tijdstempels behouden

Een zoekfragment is een voorbeeld van een pagina. Bewaar zijn URL en vermijd het behandelen van het knipsel als het volledige artikel. Voor transcripten, houd de video ID, taal en segment tijden, zodat de agent de oorspronkelijke passage kan citeren.

Voor een video-kennisbestand, sla de videotitel en de tijd gestempelde bronlink op bij elke tekstblok. Uw ophaalsysteem kan dan zowel de inhoud als de referentie die wordt gebruikt om een antwoord te ondersteunen.