Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Ferramentas integradas: pesquisa na web, X e coleções

Aula 14 de 16 Atualizada a 30 de julho de 2026 Programador
Nesta página
  1. As ferramentas nativas do Voice Agent
  2. web_search: pesquisar na web
  3. x_search: pesquisar no X (Twitter)
  4. file_search: pesquisar em coleções RAG
  5. Combinar várias ferramentas
  6. Pontos-chave

As ferramentas nativas do Voice Agent

Além da chamada de funções personalizadas e dos servidores MCP, a API do Voice Agent fornece várias ferramentas integradas que o agente pode utilizar autonomamente durante a conversa. Estas ferramentas não requerem qualquer lógica de execução da sua parte: os servidores da xAI tratam-nas integralmente.

web_search: pesquisar na web

Esta ferramenta permite ao agente procurar informações na web em tempo real durante a conversa:

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

Quando o utilizador faz uma pergunta factual («Qual é a temperatura em Paris?», «Quem ganhou o jogo ontem à noite?»), o agente executa automaticamente uma pesquisa na web e utiliza os resultados para construir a sua resposta oral.

Nenhum evento específico é enviado para o cliente no caso das ferramentas integradas: o agente utiliza os resultados internamente e integra-os na sua resposta de áudio.

x_search: pesquisar no X (Twitter)

Esta ferramenta permite ao agente pesquisar publicações na plataforma X:

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

O parâmetro allowed_x_handles é opcional. Quando definido, a pesquisa limita-se às publicações dessas contas específicas. Na sua ausência, o agente pesquisa em todo o X.

  • Monitorização da concorrência: «O que é que a [concorrência] publicou esta semana?»
  • Apoio ao cliente: «Existem reclamações recentes sobre o nosso produto no X?»
  • Notícias: «Qual é a última novidade sobre [tópico]?»
  • Tendências: «Sobre o que é que as pessoas estão a falar agora no setor [indústria]?»

file_search: pesquisar em coleções RAG

A ferramenta file_search permite ao agente de voz consultar coleções de documentos vetorizados (RAG). É a ferramenta ideal para agentes que necessitam de aceder a uma base de conhecimento interna:

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

Parâmetros

  • vector_store_ids: os identificadores das coleções de vetores a consultar. Pode listar vários para combinar diferentes fontes de conhecimento.
  • max_num_results: o número máximo de resultados a devolver (10 por predefinição).

Cenários de utilização

  • FAQ por voz: o agente responde a perguntas dos clientes com base na sua documentação.
  • Apoio técnico: pesquisa em manuais e guias de resolução de problemas.
  • Formação: o agente tem acesso ao conteúdo dos cursos para responder às perguntas dos formandos.
  • Assistência jurídica: pesquisa em contratos e documentos legais.

Combinar várias ferramentas

Pode ativar várias ferramentas simultaneamente. O agente seleciona a mais relevante com base no contexto da conversa:

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

Neste exemplo, o agente pode:

  • Pesquisar na web para questões gerais
  • Consultar o X para tendências e opiniões
  • Explorar a documentação interna para questões técnicas
  • Criar um ticket através da chamada de funções
  • Aceder ao CRM através do MCP

Pontos-chave

  • Estão disponíveis cinco tipos de ferramentas: web_search, x_search, file_search, function e mcp
  • As ferramentas integradas (web_search, x_search, file_search) são executadas no servidor sem necessidade de código da sua parte
  • A file_search consulta coleções de vetores para RAG
  • A x_search pode ser limitada a contas específicas através do parâmetro allowed_x_handles
  • Pode combinar todos os tipos de ferramentas na mesma sessão