Narzędzia wbudowane: wyszukiwanie w sieci, X i kolekcje
Na tej stronie
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.
Przypadki użycia x_search
- 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 wiedzymax_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,functionorazmcp - Narzędzia wbudowane (
web_search,x_search,file_search) działają po stronie serwera bez konieczności pisania kodu z Twojej strony file_searchodpytuje kolekcje wektorowe w ramach RAGx_searchmożna ograniczyć do konkretnych kont za pomocą parametruallowed_x_handles- W ramach jednej sesji możesz łączyć wszystkie typy narzędzi