Herramientas integradas: búsqueda web, X y colecciones
En esta página
Herramientas nativas del Voice Agent
Además de la llamada a funciones personalizadas y los servidores MCP, la API de Voice Agent ofrece varias herramientas integradas que el agente puede utilizar por sí mismo durante la conversación. Estas herramientas no requieren lógica de ejecución por tu parte: los servidores de xAI se encargan de todo el proceso.
web_search: búsqueda en la web
Esta herramienta permite al agente buscar información en la web en tiempo real durante la conversación:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Cuando el usuario plantea una pregunta factual («¿Qué tiempo hace en París?», «¿Quién ganó el partido anoche?»), el agente ejecuta automáticamente una búsqueda web y utiliza los resultados para construir su respuesta hablada.
No se envía ningún evento específico al cliente para las herramientas integradas: el agente usa los resultados internamente y los integra en su respuesta de audio.
x_search: búsqueda en X (Twitter)
Esta herramienta permite al agente buscar publicaciones en la plataforma X:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
El parámetro allowed_x_handles es opcional. Cuando se establece, la búsqueda se limita a las publicaciones de esas cuentas específicas. Sin este parámetro, el agente busca en todo X.
Casos de uso de x_search
- Monitorización de la competencia: «¿Qué ha publicado [competidor] esta semana?»
- Atención al cliente: «¿Hay alguna queja reciente sobre nuestro producto en X?»
- Noticias: «¿Cuál es la última novedad sobre [tema]?»
- Tendencias: «¿De qué está hablando la gente ahora mismo en el sector [industria]?»
file_search: búsqueda en colecciones RAG
La herramienta file_search permite al agente de voz consultar colecciones de documentos vectorizados (RAG). Es la herramienta ideal para agentes que necesitan acceder a una base de conocimientos 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: los identificadores de las colecciones vectoriales que se van a consultar. Puedes listar varios para combinar diferentes fuentes de conocimiento.max_num_results: el número máximo de resultados que se deben devolver (10 por defecto).
Escenarios de uso
- FAQ por voz: el agente responde a las preguntas de los clientes basándose en tu documentación.
- Soporte técnico: búsqueda en manuales y guías de resolución de problemas.
- Formación: el agente tiene acceso al contenido del curso para responder a las preguntas de los alumnos.
- Asistencia legal: búsqueda en contratos y documentos jurídicos.
Combinar varias herramientas
Puedes habilitar varias herramientas a la vez. El agente selecciona la más relevante según el contexto de la conversación:
{
"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"
}
]
}
}
En este ejemplo, el agente puede:
- Buscar en la web para preguntas generales.
- Consultar X para tendencias y opiniones.
- Profundizar en la documentación interna para preguntas técnicas.
- Crear un ticket mediante llamada a funciones.
- Acceder al CRM a través de MCP.
Puntos clave
- Hay cinco tipos de herramientas disponibles:
web_search,x_search,file_search,functionymcp. - Las herramientas integradas (
web_search,x_search,file_search) se ejecutan en el servidor sin que tengas que escribir código. file_searchconsulta colecciones vectoriales para RAG.x_searchpuede limitarse a cuentas específicas conallowed_x_handles.- Puedes combinar todos los tipos de herramientas en la misma sesión.