Przejdź do głównej treści
Polski— Wybierz język
Menu

Narzędzia wbudowane: wyszukiwanie w sieci, X i kolekcje

Lekcja 14 z 16 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Narzędzia natywne Voice Agenta
  2. web_search: wyszukiwanie w sieci
  3. x_search: wyszukiwanie w serwisie X (Twitter)
  4. file_search: wyszukiwanie w kolekcjach RAG
  5. Łączenie kilku narzędzi
  6. Kluczowe wnioski

Narzędzia natywne Voice Agenta

Oprócz wywoływania niestandardowych funkcji i serwerów MCP, interfejs API Voice Agent udostępnia kilka narzędzi wbudowanych, z których agent może korzystać samodzielnie podczas rozmowy. Narzędzia te nie wymagają po Twojej stronie żadnej logiki wykonawczej: serwery xAI obsługują je w całości.

web_search: wyszukiwanie w sieci

To narzędzie pozwala agentowi wyszukiwać informacje w sieci w czasie rzeczywistym podczas rozmowy:

{
  "type": "session.update",
  "session": {
    "tools": [
      {"type": "web_search"}
    ]
  }
}

Gdy użytkownik zadaje pytanie faktograficzne („Jaka jest pogoda w Paryżu?“, „Kto wygrał wczorajszy mecz?“), agent automatycznie przeprowadza wyszukiwanie w sieci i wykorzystuje wyniki do sformułowania swojej odpowiedzi głosowej.

W przypadku narzędzi wbudowanych do klienta nie jest wysyłane żadne specyficzne zdarzenie: agent wykorzystuje wyniki wewnętrznie i wplata je w swoją odpowiedź audio.

x_search: wyszukiwanie w serwisie X (Twitter)

To narzędzie pozwala agentowi przeszukiwać posty na platformie X:

{
  "type": "session.update",
  "session": {
    "tools": [
      {
        "type": "x_search",
        "allowed_x_handles": ["xai", "gaborcselle"]
      }
    ]
  }
}

Parametr allowed_x_handles jest opcjonalny. Gdy zostanie ustawiony, wyszukiwanie ogranicza się do postów pochodzących z tych konkretnych kont. Bez niego agent przeszukuje cały serwis X.

  • Monitorowanie konkurencji: „Co [konkurent] opublikował w tym tygodniu?“
  • Obsługa klienta: „Czy są jakieś recentes skargi na nasz produkt w serwisie X?“
  • Wiadomości: „Co nowego słychać w temacie [temat]?“
  • Trendy: „O czym ludzie rozmawiają teraz w branży [branża]?“

file_search: wyszukiwanie w kolekcjach RAG

Narzędzie file_search pozwala agentowi głosowemu odpytywać kolekcje zwektoryzowanych dokumentów (RAG). Jest to idealne rozwiązanie dla agentów potrzebujących dostępu do wewnętrznej bazy wiedzy:

{
  "type": "session.update",
  "session": {
    "tools": [
      {
        "type": "file_search",
        "vector_store_ids": ["vs_abc123", "vs_def456"],
        "max_num_results": 10
      }
    ]
  }
}

Parametry

  • vector_store_ids: identyfikatory kolekcji wektorowych do odpytania. Możesz wymienić kilka, aby połączyć różne źródła wiedzy
  • max_num_results: maksymalna liczba zwracanych wyników (domyślnie 10)

Scenariusze użycia

  • FAQ głosowe: agent odpowiada na pytania klientów na podstawie Twojej dokumentacji
  • Wsparcie techniczne: przeszukiwanie podręczników i przewodników rozwiązywania problemów
  • Szkolenia: agent ma dostęp do treści kursowych, aby odpowiadać na pytania uczniów
  • Pomoc prawna: przeszukiwanie umów i dokumentów prawnych

Łączenie kilku narzędzi

Możesz włączyć jednocześnie kilka narzędzi. Agent wybiera najbardziej odpowiednie z nich w zależności od kontekstu rozmowy:

{
  "type": "session.update",
  "session": {
    "tools": [
      {"type": "web_search"},
      {"type": "x_search"},
      {
        "type": "file_search",
        "vector_store_ids": ["vs_documentation"]
      },
      {
        "type": "function",
        "name": "create_ticket",
        "description": "Creates a support ticket",
        "parameters": {
          "type": "object",
          "properties": {
            "subject": {"type": "string"},
            "priority": {"type": "string", "enum": ["low", "medium", "high"]}
          },
          "required": ["subject"]
        }
      },
      {
        "type": "mcp",
        "server_url": "https://mcp.exemple.com/sse",
        "server_label": "CRM"
      }
    ]
  }
}

W tym przykładzie agent może:

  • Przeszukiwać sieć w sprawach ogólnych
  • Sprawdzać serwis X pod kątem trendów i opinii
  • Przeszukiwać wewnętrzną dokumentację w sprawach technicznych
  • Tworzyć zgłoszenia poprzez wywołanie funkcji
  • Uzyskiwać dostęp do systemu CRM przez MCP

Kluczowe wnioski

  • Dostępnych jest pięć typów narzędzi: web_search, x_search, file_search, function oraz mcp
  • Narzędzia wbudowane (web_search, x_search, file_search) działają po stronie serwera bez konieczności pisania kodu z Twojej strony
  • file_search odpytuje kolekcje wektorowe w ramach RAG
  • x_search można ograniczyć do konkretnych kont za pomocą parametru allowed_x_handles
  • W ramach jednej sesji możesz łączyć wszystkie typy narzędzi