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.
# 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.
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))
python3 tools.pyVerbind 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.