도구 경계를 정의
명확한 입력 및 출력을 가진 대리인 작은 공구를 주십시오: 웹, discover 영상을 검색하고, 영상의 유효한 성적표를 읽으십시오. 당신의 대리인은 그(것)들을 부르고 증거를 사용하는 방법 선택합니다.
아래 코드는 retrieval 함수를 공급합니다. 기존의 에이전트 프레임 워크와 함께 등록하십시오. 그들은 당신이 선택한 모델 또는 관현 도서관의 독립적으로 작동합니다.
# Replace YOUR_API_KEY near the top of the code below.retrieval 도구 구현
다음 Python 3 코드는 표준 라이브러리를 사용합니다. 으로 저장 tools.py. 직접 실행 한 Google 검색 요청; 가져 오기 응용 프로그램은 도구로 세 가지 기능을 등록 할 수 있습니다.
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.py당신의 에이전트에 도구를 연결
프레임워크의 도구 스키마에 각 도구의 인수와 결과를 정의하세요. 다음을 유지하세요 query, video_id 으로 language 명시된 입력으로 모델은 필요한 데이터를 요청할 수 있습니다.
search_web(query)Google 결과를 소스 URLs 및 스니펫으로 반환합니다.find_videos(query)비디오와 IDs를 반환하면 후속 요청이 필요합니다.read_video_transcript(video_id, language)반환 가능한 캡션 세그먼트와 타임스탬프.
요청이 실패하거나 캡션 트랙이 사용할 수 없을 때 유용한 도구 오류를 반환합니다. 응용 프로그램의 신용 및 요청 예산을 적용하고 에이전트가 다른 쿼리를 시도하거나 다른 소스를 사용 여부를 결정합니다.
소스 및 타임스탬프 유지
검색 스니펫은 페이지의 미리보기입니다. URL를 보존하고 전체 기사로 스니펫을 치료하는 것을 피하십시오. 성적표에 대해서는, 화상 ID, 언어 및 세그먼트 시간을 유지하므로 에이전트는 원래의 통과를 인용할 수 있습니다.
비디오 지식 베이스의 경우, 각 텍스트 펑크와 비디오 제목과 타임스탬프 소스 링크를 저장합니다. 당신의 retrieval 체계는 그 때 응답을 지원하기 위하여 이용된 내용 및 참고 둘 다 돌려보낼 수 있습니다.