Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Indbyggede værktøjer: websøgning, X og samlinger

Lektion 14 af 16 Opdateret 30. juli 2026 Udvikler
På denne side
  1. Voice Agentens indbyggede værktøjer
  2. web_search: søg på nettet
  3. x_search: søg på X (Twitter)
  4. file_search: søg i RAG-samlinger
  5. Kombinér flere værktøjer
  6. Vigtige pointer

Voice Agentens indbyggede værktøjer

Ud over tilpassede funktionskald og MCP-servere tilbyder Voice Agent API flere indbyggede værktøjer, som agenten kan bruge selvstændigt under samtalen. Disse værktøjer kræver ingen eksekveringslogik på din side: xAI’s servere håndterer dem fuldstændigt.

web_search: søg på nettet

Dette værktøj lader agenten slå oplysninger op på nettet i realtid under samtalen:

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

Når brugeren stiller et faktuelt spørgsmål („Hvordan er vejret i Paris?”, „Hvem vandt kampen i går?”), udfører agenten automatisk en websøgning og bruger resultaterne til at sammensætte sit talte svar.

Der sendes ingen specifik begivenhed til klienten for indbyggede værktøjer: agenten bruger resultaterne internt og fletter dem ind i sit lydsvar.

x_search: søg på X (Twitter)

Dette værktøj lader agenten søge i indlæg på X-platformen:

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

Parameteren allowed_x_handles er valgfri. Når den er angivet, begrænses søgningen til indlæg fra disse specifikke konti. Uden den søger agenten på hele X.

  • Konkurrentovervågning: „Hvad har [konkurrent] postet i denne uge?”
  • Kundesupport: „Er der nogen nyere klager over vores produkt på X?”
  • Nyheder: „Hvad er det seneste om [emne]?”
  • Trends: „Hvad taler folk om lige nu inden for [branche]?“

file_search: søg i RAG-samlinger

Værktøjet file_search lader voice-agenten forespørge samlinger af vektoriserede dokumenter (RAG). Det er det ideelle værktøj til agenter, der har brug for adgang til en intern vidensbase:

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

Parametre

  • vector_store_ids: ID’erne på de vektorsamlinger, der skal forespørges. Du kan liste flere for at kombinere forskellige videnskilder.
  • max_num_results: Det maksimale antal resultater, der skal returneres (10 som standard).

Brugsscenarier

  • Voice-FAQ: Agenten besvarer kundespørgsmål baseret på din dokumentation.
  • Teknisk support: Søgning i manualer og fejlfindingsguider.
  • Træning: Agenten har adgang til kursusindhold for at besvare lærernes spørgsmål.
  • Juridisk bistand: Søgning i kontrakter og juridiske dokumenter.

Kombinér flere værktøjer

Du kan aktivere flere værktøjer på én gang. Agenten vælger det mest relevante baseret på samtalekonteksten:

{
  "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"
      }
    ]
  }
}

I dette eksempel kan agenten:

  • Søge på nettet for generelle spørgsmål
  • Tjekke X for trends og meninger
  • Dykke ned i intern dokumentation for tekniske spørgsmål
  • Oprette en sag gennem funktionskald
  • Få adgang til CRM’en via MCP

Vigtige pointer

  • Der er fem typer værktøjer tilgængelige: web_search, x_search, file_search, function og mcp
  • Indbyggede værktøjer (web_search, x_search, file_search) kører på serveren uden kode fra din side
  • file_search forespørger vektorsamlinger til RAG
  • x_search kan begrænses til specifikke konti med allowed_x_handles
  • Du kan kombinere alle typer værktøjer i den samme session