Ferramentas integradas: pesquisa na web, X e coleções
Nesta página
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.
Casos de utilização do x_search
- 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,functionemcp - As ferramentas integradas (
web_search,x_search,file_search) são executadas no servidor sem necessidade de código da sua parte - A
file_searchconsulta coleções de vetores para RAG - A
x_searchpode ser limitada a contas específicas através do parâmetroallowed_x_handles - Pode combinar todos os tipos de ferramentas na mesma sessão