Probar una herramienta personalizada
Probar una herramienta personalizada es como tocar el timbre antes de enviar la invitación: quieres saber que hay alguien en casa antes de comprometerte. Una prueba rápida confirma que la conexión funciona, que tus datos de inicio de sesión son aceptados y que el servicio responde como esperas.
Image: Una prueba exitosa con el código de estado y los datos de respuesta
Antes de empezar
- Una herramienta personalizada ya completada (creada manualmente, a partir de una plantilla o con el Creador con IA).
- Una credencial guardada (datos de inicio de sesión) seleccionada en la herramienta.
- Unos cuantos valores de ejemplo que puedas usar como entradas; lo mejor son valores reales de tu cuenta (un ID de contacto real, un nombre de canal real, etc.).
Qué hace realmente una prueba
Una prueba realiza una llamada real al servicio usando la dirección web, el método de la solicitud y los valores de los parámetros que indiques. Es la misma llamada que haría tu agente más adelante: nada se simula.
| Dónde pruebas | Cómo aparece |
|---|---|
| Creador con IA | La IA prueba automáticamente mientras construye la herramienta y te muestra el resultado. |
| Creación manual | La segunda página del asistente tiene un botón Test. |
| Plantillas | Igual que en manual: rellena tus valores en la página de prueba y ejecútala. |
| Una herramienta ya guardada | Ábrela desde la página de Herramientas Personalizadas y ejecuta una prueba desde ahí. |
Paso a paso
- Abre la página de prueba de tu herramienta.
- Rellena un valor de ejemplo para cada parámetro. Estos sustituyen a lo que el agente elegiría en tiempo real: elige valores que sepas que existen en tu cuenta.
- Haz clic en Test.
- Espera un momento a que el servicio responda. El resultado aparece debajo.
- Lee el resultado (consulta "Leer el resultado" más abajo).
- Si falló, corrige la causa y vuelve a ejecutar la prueba. Sigue hasta que pase.
- Cuando la prueba pase, guarda la herramienta.
Para tu primera prueba, elige una combinación de parámetros que solo lea datos (como una llamada de "obtener un registro por ID"). Es más seguro que una prueba que crea o elimina algo, y aun así demuestra que la conexión funciona.
Una prueba que crea, cambia o elimina datos lo hace de verdad en el servicio conectado. Usa valores de ejemplo o de un entorno de pruebas cuando puedas.
Leer el resultado
El resultado aparece como aprobado o fallido, junto con una vista previa de lo que devolvió el servicio.
Aprobado
Aprobado significa: se llegó al servicio, tu credencial fue aceptada, tus parámetros eran válidos y volvió una respuesta real. La vista previa muestra los datos reales: recórrela para comprobar que los campos que esperabas están ahí.
Fallido
Un fallo significa que una de tres cosas está mal. Revísalas en este orden:
- Los tipos de los parámetros. Enviar números como texto (o al revés) es la causa más común de un fallo. Abre la lista de parámetros y confirma que cada uno tenga el tipo correcto (texto, número, sí-o-no).
- La dirección web. Busca erratas, barras que falten o un trozo de ruta como
/contacts/{contact_id}que no se haya rellenado. - La credencial. Si la respuesta habla de autorización, puede que tus datos de inicio de sesión hayan caducado o que sea la cuenta equivocada. Vuelve a autorizar la credencial en Credenciales.
Después de corregir la causa, ejecuta la prueba de nuevo.
Image: Una prueba fallida con un mensaje de error
Adjuntar una salida de ejemplo (opcional)
Cuando una prueba pasa, puedes adjuntar una muestra de la respuesta a la herramienta para que quienes la revisen (y tú mismo, más adelante) vean de un vistazo qué tipo de respuesta devuelve. Los formatos de muestra admitidos son:
| Formato | Para qué sirve |
|---|---|
| image | Una captura o una imagen que el servicio devuelve |
| Un documento que el servicio devuelve | |
| markdown | Una respuesta en texto con formato |
| json | Una respuesta estructurada: campos y valores |
| file | Cualquier otro tipo de archivo que el servicio devuelva |
La muestra se ve junto a la herramienta cuando tú (o un compañero) la abren para revisarla después. No cambia cómo se ejecuta la herramienta: es solo una vista previa.
Solución de problemas
| Problema | Solución |
|---|---|
| El botón Test está en gris | Falta algún parámetro obligatorio o no hay credencial seleccionada. Rellena todos los campos obligatorios y elige una credencial. |
| La prueba pasó pero los datos parecen incorrectos | Verifica que elegiste la credencial correcta (a veces hay dos cuentas) y que los parámetros apuntan al registro que esperabas. |
| La prueba solo falla con una combinación de parámetros | Puede que ese registro concreto no exista en tu cuenta. Prueba otro valor de ejemplo que sepas que existe. |
| El servicio responde "demasiadas solicitudes" o pide esperar | Has alcanzado cuántas solicitudes permite el servicio en un período corto. Espera un minuto e inténtalo de nuevo. |
| Todo parece estar bien pero la prueba sigue fallando | Vuelve a abrir la credencial en Credenciales y reautorízala: puede haber caducado. |
Qué sigue
Cuando tu herramienta pase la prueba sin problemas, entrégasela a un agente.