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

Las dos categorías de herramientas de Grok

Lección 1 de 16 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Comprende el ecosistema de herramientas de la API de Grok
  2. Herramientas integradas — Lado del servidor
  3. Llamada a funciones — Lado del cliente
  4. Cuándo usar cada categoría
  5. Puntos clave

Comprende el ecosistema de herramientas de la API de Grok

Visión general de las herramientas en la documentación La API de Grok hace algo más que generar texto. Ofrece un conjunto de herramientas que permiten al modelo interactuar con el mundo exterior: buscar información en tiempo real, analizar datos en redes sociales o ejecutar código Python. Para aprovechar estas capacidades, debes entender cómo se organizan.

La API de Grok distingue dos categorías fundamentales de herramientas. Esta distinción determina quién ejecuta la herramienta, dónde tiene lugar el procesamiento y qué debes gestionar tú como desarrollador.

Herramientas integradas — Lado del servidor

Las herramientas integradas se ejecutan directamente en los servidores de xAI. Cuando el modelo decide usar una de estas herramientas, la ejecución es automática y transparente. No necesitas gestionar ninguna infraestructura ni procesar resultados intermedios.

🔍
Búsqueda web
Búsqueda web en tiempo real
𝕏
Búsqueda en X
Búsqueda en X/Twitter
🐍
Ejecución de código
Entorno aislado (sandbox) de Python
📁
Búsqueda en colecciones
Búsqueda dentro de tus documentos
🔌
MCP remoto
Servidores MCP externos

Estas son las cinco herramientas integradas disponibles:

  • Búsqueda web (web_search): Búsqueda web en tiempo real, con filtrado por dominio y citas automáticas
  • Búsqueda en X (x_search): Búsqueda en X/Twitter, con filtrado por cuenta y fecha
  • Ejecución de código (code_interpreter / code_execution): Ejecución de código Python en un entorno aislado y seguro
  • Búsqueda en colecciones (collections_search / file_search): Búsqueda dentro de documentos que hayas subido previamente
  • MCP remoto (mcp): Conexión a servidores MCP externos (Model Context Protocol)

Para activar una herramienta integrada, solo tienes que añadirla al array tools de tu solicitud:

{
  "tools": [{"type": "web_search"}]
}

Llamada a funciones — Lado del cliente

La llamada a funciones (Function Calling) funciona de manera diferente. Tú defines funciones personalizadas que el modelo puede invocar. Pero, a diferencia de las herramientas integradas, es el código de tu lado del cliente el que ejecuta la función y devuelve el resultado al modelo.

El flujo es el siguiente:

  1. Describes tus funciones (nombre, parámetros, descripción) en la solicitud
  2. El modelo analiza la petición del usuario
  3. Si determina que se necesita una función, devuelve una llamada a función con los argumentos correspondientes
  4. Tu código ejecuta la función (llamada a API, consulta a base de datos, cálculo…)
  5. Envías el resultado de vuelta al modelo
  6. El modelo formula su respuesta final

Este enfoque te otorga control total: tú decides qué hacen tus funciones, qué datos manejan y cómo se conectan a tu infraestructura.

Cuándo usar cada categoría

Las herramientas integradas son ideales cuando necesitas acceder a información en tiempo real (web, redes sociales) o ejecutar cálculos sin tener que gestionar infraestructura. La llamada a funciones es preferible cuando necesitas interactuar con tus propios sistemas: bases de datos internas, APIs empresariales o cualquier servicio específico de tu aplicación.

Puedes combinar ambas categorías en una única solicitud. Por ejemplo, puedes activar la Búsqueda web mientras defines una función personalizada que guarde los resultados en tu base de datos.

Puntos clave

  • La API de Grok ofrece dos categorías de herramientas: herramientas integradas (ejecutadas por xAI) y llamada a funciones (ejecutada por tu código)
  • Las herramientas integradas no requieren infraestructura en el lado del cliente
  • La llamada a funciones ofrece control total, pero requiere más desarrollo
  • Ambas categorías pueden combinarse en una única solicitud
  • Este curso se centra en las tres herramientas integradas principales: Búsqueda web, Búsqueda en X y Ejecución de código