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.
list_toolsupdate_agentNo 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_toolsmodifican un elemento. Pasartools=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 atools=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
| Herramienta | Qué hace |
|---|---|
web_search | Buscar algo en la web abierta. |
save_contact | Capturar 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_document | Generar un documento estructurado (un resumen / informe con marca) para la conversación. |
schedule_followup | Hacer 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_reminder | Establecer un recordatorio para el usuario final; list_reminders / cancel_reminder los gestionan. |
compute_chart | Calcular 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 hayCapturar 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.