Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Eingebaute Werkzeuge: Websuche, X und Sammlungen

Lektion 14 von 16 Aktualisiert am 30. Juli 2026 Entwickler
Auf dieser Seite
  1. Die nativen Werkzeuge des Voice Agents
  2. web_search: Suche im Web
  3. x_search: Suche auf X (Twitter)
  4. file_search: Suche in RAG-Sammlungen
  5. Mehrere Werkzeuge kombinieren
  6. Kernaussagen

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.

  • 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, function und mcp.
  • Eingebaute Werkzeuge (web_search, x_search, file_search) laufen auf dem Server ohne Code auf Ihrer Seite.
  • file_search fragt Vektorsammlungen für RAG ab.
  • x_search kann mit allowed_x_handles auf bestimmte Konten beschränkt werden.
  • Sie können jeden Werkzeugtyp in derselben Sitzung kombinieren.