Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Inbyggda verktyg: webbsökning, X och samlingar

Lektion 14 av 16 Uppdaterad 30 juli 2026 Utvecklare
På denna sida
  1. Voice Agent: inbyggda verktyg
  2. web_search: sök på webben
  3. x_search: sök på X (Twitter)
  4. file_search: sök i RAG-samlingar
  5. Kombinera flera verktyg
  6. Viktiga punkter

Voice Agent: inbyggda verktyg

Förutom anpassade funktionsanrop och MCP-servrar erbjuder Voice Agent API flera inbyggda verktyg som agenten kan använda självständigt under konversationen. Dessa verktyg kräver ingen körningslogik från din sida: xAI:s servrar hanterar dem helt.

web_search: sök på webben

Detta verktyg låter agenten söka efter information på webben i realtid under konversationen:

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

När användaren ställer en faktabaserad fråga (“Vad är vädret i Paris?”, “Vem vann matchen igår kväll?”) utför agenten automatiskt en webbsökning och använder resultaten för att formulera sitt talade svar.

Ingen specifik händelse skickas till klienten för inbyggda verktyg: agenten använder resultaten internt och väver in dem i sitt ljudsvar.

x_search: sök på X (Twitter)

Detta verktyg låter agenten söka efter inlägg på plattformen X:

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

Parametern allowed_x_handles är valfri. När den anges begränsas sökningen till inlägg från dessa specifika konton. Utan den söker agenten igenom hela X.

  • Konkurrensbevakning: “Vad har [konkurrent] publicerat denna vecka?”
  • Kundsupport: “Finns det några senaste klagomål om vår produkt på X?”
  • Nyheter: “Vad är det senaste inom [ämne]?”
  • Trender: “Vad pratar folk om just nu inom [bransch]?“

file_search: sök i RAG-samlingar

Verktyget file_search låter röstagenten fråga samlingar av vektoriserade dokument (RAG). Det är det idealiska verktyget för agenter som behöver tillgång till en intern kunskapsbas:

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

Parametrar

  • vector_store_ids: ID:n för de vektorsamlingar som ska frågas. Du kan lista flera för att kombinera olika kunskapskällor.
  • max_num_results: maximalt antal resultat som ska returneras (standardvärdet är 10).

Användningsscenarier

  • Röstbaserad FAQ: agenten svarar på kundfrågor baserat på din dokumentation.
  • Teknisk support: sökning i manualer och felsökningsguider.
  • Utbildning: agenten har tillgång till kursinnehåll för att svara på lärandes frågor.
  • Juridisk assistans: sökning i avtal och juridiska dokument.

Kombinera flera verktyg

Du kan aktivera flera verktyg samtidigt. Agenten väljer det mest relevanta baserat på konversationens kontext:

{
  "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 detta exempel kan agenten:

  • Söka på webben efter allmänna frågor
  • Kontrollera X efter trender och åsikter
  • Gräva i intern dokumentation för tekniska frågor
  • Skapa ett ärende genom funktionsanrop
  • Komma åt CRM-systemet via MCP

Viktiga punkter

  • Fem typer av verktyg är tillgängliga: web_search, x_search, file_search, function och mcp
  • Inbyggda verktyg (web_search, x_search, file_search) körs på servern utan att du behöver skriva någon kod
  • file_search frågar vektorsamlingar för RAG
  • x_search kan begränsas till specifika konton med allowed_x_handles
  • Du kan kombinera alla typer av verktyg i samma session