Eingebaute Werkzeuge: Websuche, X und Sammlungen
Auf dieser Seite
Die nativen Werkzeuge des Voice Agents
Neben dem Aufruf benutzerdefinierter Funktionen und MCP-Servern stellt die Voice Agent API mehrere eingebaute Werkzeuge bereit, die der Agent während des Gesprächs eigenständig nutzen kann. Diese Werkzeuge benötigen keine Ausführungslogik auf Ihrer Seite: xAI-Server übernehmen sie vollständig.
web_search: Suche im Web
Dieses Werkzeug ermöglicht es dem Agenten, Informationen in Echtzeit während des Gesprächs im Web nachzuschlagen:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Wenn der Nutzer eine faktische Frage stellt (z. B. „Wie ist das Wetter in Paris?” oder „Wer hat das Spiel gestern gewonnen?”), führt der Agent automatisch eine Websuche durch und nutzt die Ergebnisse, um seine gesprochene Antwort zu formulieren.
Für eingebaute Werkzeuge wird dem Client kein spezifisches Ereignis gesendet: Der Agent verarbeitet die Ergebnisse intern und integriert sie in seine Audioantwort.
x_search: Suche auf X (Twitter)
Dieses Werkzeug ermöglicht es dem Agenten, Beiträge auf der X-Plattform zu durchsuchen:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Der Parameter allowed_x_handles ist optional. Wenn er gesetzt ist, wird die Suche auf Beiträge dieser spezifischen Konten beschränkt. Ohne diesen Parameter durchsucht der Agent ganz X.
Anwendungsfälle für x_search
- Wettbewerbsmonitoring: „Was hat [Konkurrent] diese Woche gepostet?”
- Kundensupport: „Gibt es近期 Beschwerden über unser Produkt auf X?”
- Nachrichten: „Was ist das Neueste zu [Thema]?”
- Trends: „Worum sprechen die Leute gerade in [Branche]?“
file_search: Suche in RAG-Sammlungen
Das file_search-Werkzeug ermöglicht es dem Voice Agent, Sammlungen vektorisierter Dokumente (RAG) abzufragen. Es ist das ideale Werkzeug für Agenten, die Zugriff auf eine interne Wissensdatenbank benötigen:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Parameter
vector_store_ids: Die IDs der Vektorsammlungen, die abgefragt werden sollen. Sie können mehrere auflisten, um verschiedene Wissensquellen zu kombinieren.max_num_results: Die maximale Anzahl der zurückgegebenen Ergebnisse (Standardwert: 10).
Anwendungsszenarien
- Voice FAQ: Der Agent beantwortet Kundenfragen basierend auf Ihrer Dokumentation.
- Technischer Support: Durchsuchen von Handbüchern und Fehlerbehebungsanleitungen.
- Schulung: Der Agent hat Zugriff auf Kursinhalte, um Fragen der Lernenden zu beantworten.
- Rechtliche Unterstützung: Durchsuchen von Verträgen und rechtlichen Dokumenten.
Mehrere Werkzeuge kombinieren
Sie können mehrere Werkzeuge gleichzeitig aktivieren. Der Agent wählt dasjenige aus, das am besten zum Gesprächskontext passt:
{
"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"
}
]
}
}
In diesem Beispiel kann der Agent:
- Das Web für allgemeine Fragen durchsuchen.
- X nach Trends und Meinungen durchsuchen.
- In interne Dokumentation für technische Fragen eingehen.
- Einen Ticket über den Aufruf benutzerdefinierter Funktionen erstellen.
- Auf den CRM über MCP zugreifen.
Kernaussagen
- Es stehen fünf Werkzeugtypen zur Verfügung:
web_search,x_search,file_search,functionundmcp. - Eingebaute Werkzeuge (
web_search,x_search,file_search) laufen auf dem Server ohne Code auf Ihrer Seite. file_searchfragt Vektorsammlungen für RAG ab.x_searchkann mitallowed_x_handlesauf bestimmte Konten beschränkt werden.- Sie können jeden Werkzeugtyp in derselben Sitzung kombinieren.