Las herramientas son la forma en que el agente consulta los sistemas del cliente en el momento: stock, precios, pedidos, turnos, envíos. Todo dato que cambia va por una herramienta, nunca escrito en el prompt.

​
HTTP o código

Empieza siempre por HTTP. Pasa a código solo si de verdad hace falta. Mira Herramientas propias, Entradas, SDK y Revisión del código.

​
1. Las credenciales van en Ajustes › Credenciales

Las claves, tokens y contraseñas de los sistemas del cliente se guardan cifradas en Ajustes › Credenciales de la cuenta del cliente. La herramienta las usa como una entrada de tipo credencial (credencial.<clave>): ni el modelo ni el código ven el valor. Mira Credenciales.
Nunca pegues una clave en el chat con Claude o ChatGPT, ni en el prompt del agente, ni en el código de una herramienta. Si el asistente te pide una clave, respóndele con el nombre de la credencial ya cargada. En la certificación hay un chequeo automático que busca claves pegadas en el código.
Cómo hacerlo con el cliente:
  1. Pídele al cliente que cargue la credencial él mismo en Ajustes › Credenciales, o cárgala tú en una videollamada con él.
  2. Ponle un nombre claro (api_stock, token_turnos).
  3. Dile a tu asistente: “La clave está cargada como api_stock; úsala como header Authorization”. El asistente la elige con list_credentials.

​
2. Diseña la herramienta

Una buena herramienta:
  • Hace una sola cosa y su nombre lo dice: consultar_stock, turnos_libres, estado_pedido.
  • Pide pocas entradas, y las que completa la IA están bien descritas (“El modelo o SKU que nombró el cliente”).
  • Devuelve solo lo necesario. Usa Cómo leer la respuesta para quedarte con los campos que importan.
  • Tiene un plan si falla. En Si falla define qué hace el agente cuando el sistema no responde (avisar y derivar, por ejemplo).
  • Pide confirmación si cambia algo en el sistema del cliente (reservar un turno, crear un pedido).
  • Tiene un máximo por conversación para que no la llame en loop.

​
3. Pruébala contra el sistema real

Antes de sumarla al agente:
  1. Pídele al asistente que la pruebe (test_agent_tool) con datos reales: un producto con stock, uno sin stock, uno que no existe.
  2. Mira la respuesta completa. ¿El agente tiene lo que necesita para contestar?
  3. Prueba los errores: credencial vencida, sistema caído, un dato mal escrito.
  4. Si es de código, mándala a revisión (submit_agent_tool). Mientras no esté aprobada, el agente no la usa.
La tarea Crear herramientas custom para el agente se completa sola cuando el agente tiene herramientas propias aprobadas. Probar las integraciones con datos reales la cierras tú.
En los casos de prueba puedes simular lo que devuelve una herramienta (Herramientas simuladas) para probar qué hace el agente con un cliente con deuda o un sistema caído, sin depender de datos reales. Mira Casos de prueba.

​
Si el cliente no tiene API

  • Planilla: si el stock o los turnos están en una planilla, se puede publicar como CSV o JSON y consultarla con una herramienta HTTP.
  • Catálogo: si lo que cambia es el catálogo, un feed de productos como conocimiento puede alcanzar.
  • Nada: el agente informa y deriva. Escríbelo en el canvas para que el cliente lo apruebe así.

​
Checklist de herramientas

  • Cada dato que cambia (stock, precio, turnos, pedidos) se consulta con una herramienta.
  • Las claves están en Ajustes › Credenciales, no en el chat, el prompt ni el código.
  • Cada herramienta hace una sola cosa y tiene un nombre claro.
  • Probé cada una con datos reales y con errores.
  • Las que cambian datos piden confirmación.
  • Las de código están enviadas a revisión y aprobadas.
  • El prompt nombra cada herramienta y dice cuándo usarla.