Ir al contenido principal
Español— Elegir un idioma
Menú

Herramientas integradas: búsqueda web, X y colecciones

Lección 14 de 16 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Herramientas nativas del Voice Agent
  2. web_search: búsqueda en la web
  3. x_search: búsqueda en X (Twitter)
  4. file_search: búsqueda en colecciones RAG
  5. Combinar varias herramientas
  6. Puntos clave

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.

  • 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, function y mcp.
  • Las herramientas integradas (web_search, x_search, file_search) se ejecutan en el servidor sin que tengas que escribir código.
  • file_search consulta colecciones vectoriales para RAG.
  • x_search puede limitarse a cuentas específicas con allowed_x_handles.
  • Puedes combinar todos los tipos de herramientas en la misma sesión.