Cookbook
Agents & skills · for AI agents

Herramientas integradas (y el MCP del sistema)

Las herramientas que incluye la plataforma — captura de leads, documentos, seguimientos, búsqueda web — además del servidor de tiempo/clima/ubicación instalado automáticamente.

MCP tools:list_toolsupdate_agent

No tienes que construir las herramientas comunes: la plataforma las incluye. Adjunta las que el trabajo de este agente necesite con update_agent(name, add_tools=[…]); mantén el conjunto pequeño (consulta Principios de diseño). Confirma siempre los nombres exactos en tu inquilino con list_tools() — esa es la fuente de la verdad.

tools=[…] reemplaza toda la lista; add_tools / remove_tools modifican un elemento. Pasar tools= solo con las herramientas que estás considerando elimina silenciosamente todas las herramientas que no hayas leído primero — esto ha ocurrido en producción y nadie se dio cuenta hasta que una función dejó de funcionar. Recurre a tools= solo cuando significas deliberadamente "exactamente este conjunto", y lee el agente devuelto para confirmar la lista final en cualquier caso. Los mismos pares existen para habilidades (add_skills/remove_skills) y bases de conocimiento (add_knowledge_bases/remove_knowledge_bases).

Las herramientas integradas

HerramientaQué hace
web_searchBuscar algo en la web abierta.
save_contactCapturar los datos de contacto del usuario final en su perfil — la ruta de captura de leads / registros de la plataforma. Devuelve un código de referencia real (estilo AB2C-D3EF) que el agente comunica al usuario; busca los códigos en la página de detalles del usuario (recent_refs).
export_documentGenerar un documento estructurado (un resumen / informe con marca) para la conversación.
schedule_followupHacer un seguimiento proactivo más tarde ("volver a revisar en 2 días") o agendar una devolución de llamada solicitada por el usuario — el mensaje se envía por ti. Devuelve una referencia de reserva real rastreable hasta la tarea programada. Para horas absolutas ("mañana a las 10am") instruye al modelo para pasar run_at (fecha y hora ISO local + tz opcional) — el servidor resuelve la zona horaria del usuario; delay_seconds calculado manualmente es solo para tiempos relativos, y los modelos cometen errores aritméticos. Ventana: hasta 7 días.
schedule_reminderEstablecer un recordatorio para el usuario final; list_reminders / cancel_reminder los gestionan.
compute_chartCalcular una serie derivada en código — cuota del total, % de crecimiento, total acumulado, una proyección a una tasa fija o una factura medida (tarifa base + asignación + exceso por unidad). Se adjunta automáticamente a cualquier agente que ya tenga herramientas, por lo que rara vez se añade a mano. Consulta Gráficos en las respuestas.

load_skill también está integrada, pero no la adjuntas — el modelo extrae una habilidad por sí mismo cuando la description de la habilidad coincide.

list_tools()                                              # nombres exactos disponibles en tu inquilino
update_agent(name="Support", add_tools=["save_contact", "schedule_followup"])   # incremental — mantiene lo que hay

Capturar un contacto con save_contact completa el registro del usuario; combinado con ask_forms en el agente, la entrada estructurada se guarda como registros que puedes revisar en la consola.

La plataforma respalda estas dos automáticamente. Cuando el mensaje del usuario final contiene una señal clara — un número de teléfono / correo electrónico (cualquier idioma, incluidos dígitos escritos y formatos con espacios), o una solicitud de devolución de llamada estilo "llámame mañana por la mañana" — y save_contact / schedule_followup está habilitado, la plataforma inyecta una pista por turno recordando al modelo llamar a la herramienta antes de responder. Medido en backends de producción, esto elevó el cumplimiento de captura de leads en el modelo más débil de ~85% a 100% con cero guardados falsos (la pista lleva un mecanismo de escape de "ignorar si es incorrecto", por lo que un detector demasiado entusiasta no puede causar datos incorrectos). Obtienes esto gratis — sin configuración; tu habilidad debería seguir indicando el desencadenante en su description (consulta Crear una habilidad), la pista es una red de seguridad, no un reemplazo.

El MCP del sistema — ya instalado

Cada inquilino obtiene un servidor MCP system integrado, habilitado por defecto, con herramientas sin clave para hora local, clima y geolocalización por IP (ciudad / región / zona horaria). No lo registras — está ahí. Sus herramientas aparecen en list_tools() junto con las integradas anteriores, listas para adjuntar.

Así que "¿qué tiempo hace donde está el usuario?" o "¿cuál es su hora local?" funcionan de inmediato — la plataforma inyecta la IP del cliente del usuario final, por lo que las respuestas conscientes de la ubicación no requieren configuración.