Перейти до вмісту
UK
Отримати ключ API

Робочі процеси / Python

Додати інструменти пошуку Google та YouTube до агента AI

Пошук та розшифровка запитів, як Python інструменти, збереження вихідних посилань і дати ваш агент вибрати, коли для отримання даних.

FlashData · Видання

Засіб, підключений до інструментів веб- пошуку та відеоданих

Визначте межі інструменту

Подаруйте своєму агенту невеликі інструменти з чіткими входами та виходами: пошук веб-сторінок discover відео, а також прочитайте доступ до відео. Ваш агент вибирає, коли ви зателефонуєте їм і як використовувати докази.

Введіть номер мобільного, який Ви вказали при укладаннi договору з банком - для ідентифікації Зареєструвати їх з існуючою структурою агента, вони працюють незалежно від того, яку модель або бібліотеку з оркестром ви обираєте.

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

Впровадження ретриевальних інструментів

Далі Python 3 код використовує стандартну бібліотеку. Заощаджуйте його як tools.py. Запуск його безпосередньо робить запит на пошук Google; імпортувати його дозволяє реєструвати три функції як інструменти.

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

Підключіть інструменти для вашого агента

Опишіть аргументи кожного інструменту та результати у вашій схемі інструментів. Зареєструватися query, video_id і language як явні вводи, так що модель може запитати дані, які вона потребує.

  • search_web(query) повертає Google результати з джерелом URLs та snippets.

  • find_videos(query) повертає відео та IDs, необхідні для запиту на прийом.

  • read_video_transcript(video_id, language) повертає наявні сегменти підписки з таймерами.

Поверніть корисні помилки в роботі інструмента, коли запит не буде або трек підпису не буде доступний. Застосувати кредитні та запрошувати бюджети, і дозволити агенту вирішити, чи можна спробувати інший запит або використовувати інший джерело.

Зберігати джерела та часові запаси

Пошук фрагмента – це попередній перегляд сторінки. Забезпечити URL і уникати лікування хіппе як повної статті. Для трафаретів, тримайте відео ID, мову та час відрізку, щоб агент міг цитувати оригінальний прохід.

Для бази знань відео, зберігайте назву відео та часове посилання на джерело з кожним текстом. Ваша ретривальна система може бути повернено як зміст, так і посилання, що використовується для підтримки відповіді.