Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Ingebouwde tools: webzoekopdrachten, X en collecties

Les 14 van 16 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. De native tools van de Voice Agent
  2. web_search: zoeken op het web
  3. x_search: zoeken op X (Twitter)
  4. file_search: RAG-collecties doorzoeken
  5. Meerdere tools combineren
  6. Belangrijkste punten

De native tools van de Voice Agent

Naast het aanroepen van aangepaste functies en MCP-servers, biedt de Voice Agent API verschillende ingebouwde tools die de agent tijdens het gesprek zelfstandig kan gebruiken. Voor deze tools hoeft u geen uitvoeringslogica te implementeren: de servers van xAI regelen dit volledig.

web_search: zoeken op het web

Met deze tool kan de agent tijdens het gesprek in realtime informatie op het web opzoeken:

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

Wanneer de gebruiker een feitelijke vraag stelt (“Hoe is het weer in Parijs?”, “Wie heeft gisteravond de wedstrijd gewonnen?”), voert de agent automatisch een webzoekopdracht uit en gebruikt hij de resultaten om zijn gesproken antwoord samen te stellen.

Er wordt geen specifieke gebeurtenis naar de client verzonden voor ingebouwde tools: de agent gebruikt de resultaten intern en verwerkt ze in zijn audio-antwoord.

x_search: zoeken op X (Twitter)

Met deze tool kan de agent berichten op het X-platform doorzoeken:

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

De parameter allowed_x_handles is optioneel. Als u deze instelt, wordt de zoekopdracht beperkt tot berichten van die specifieke accounts. Zonder deze parameter doorzoekt de agent heel X.

  • Concurrentiemonitoring: “Wat heeft [concurrent] deze week gepost?”
  • Klantenservice: “Zijn er recente klachten over ons product op X?”
  • Nieuws: “Wat is het laatste nieuws over [onderwerp]?”
  • Trends: “Waar praten mensen op dit moment over in [branche]?“

file_search: RAG-collecties doorzoeken

Met de tool file_search kan de voice-agent collecties van gevectoriseerde documenten (RAG) bevragen. Dit is de ideale tool voor agents die toegang nodig hebben tot een interne kennisbank:

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

Parameters

  • vector_store_ids: de ID’s van de vectorcollecties die u wilt bevragen. U kunt er meerdere opgeven om verschillende kennisbronnen te combineren.
  • max_num_results: het maximum aantal terug te geven resultaten (standaard 10).

Gebruiksscenario’s

  • Voice-FAQ: de agent beantwoordt klantvragen op basis van uw documentatie.
  • Technische ondersteuning: het doorzoeken van handleidingen en probleemoplossingsgidsen.
  • Training: de agent heeft toegang tot cursusinhoud om vragen van leerlingen te beantwoorden.
  • Juridische bijstand: het doorzoeken van contracten en juridische documenten.

Meerdere tools combineren

U kunt meerdere tools tegelijk activeren. De agent kiest op basis van de context van het gesprek de meest relevante tool:

{
  "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 dit voorbeeld kan de agent:

  • Zoeken op het web voor algemene vragen
  • X controleren op trends en meningen
  • Interne documentatie doorzoeken voor technische vragen
  • Een ticket aanmaken via functiereferentie (function calling)
  • Via MCP toegang krijgen tot het CRM

Belangrijkste punten

  • Er zijn vijf soorten tools beschikbaar: web_search, x_search, file_search, function en mcp.
  • Ingebouwde tools (web_search, x_search, file_search) draaien op de server zonder dat u code hoeft te schrijven.
  • file_search bevraagt vectorcollecties voor RAG.
  • x_search kan met allowed_x_handles worden beperkt tot specifieke accounts.
  • U kunt elk type tool combineren binnen dezelfde sessie.