Saltar al contenido principal
La opción Importar cURL de la herramienta de llamada a API en Agent Studio convierte un comando cURL en una solicitud configurada con un solo pegado. Rellena automáticamente el método, la URL, los encabezados y el cuerpo, así no tienes que copiar cada valor a mano desde la documentación de la API o desde tus pruebas.

​
Para qué sirve

  • Configuras APIs más rápido: pegas el comando y los campos se completan solos.
  • Trabajas como un desarrollador: traes solicitudes desde la documentación, la terminal o tu herramienta de pruebas de API.
  • Menos errores de copia: evitas pasar campo por campo el método, la URL, los encabezados y el cuerpo.
  • Revisión sencilla: al volver a abrir la ventana de importación ves la configuración actual reconstruida como cURL.
  • Admite patrones habituales: redirecciones, autenticación básica, cuerpos de varias líneas y saltos de línea con barra invertida.

​
Dónde se usa

Importar cURL está en el panel de configuración de la herramienta Llamada a API, que puedes usar en:
  • Un nodo Agente de IA, donde la llamada a API es una herramienta que el agente usa cuando la necesita.
  • Un nodo Secuencial, donde la llamada a API es un paso fijo del proceso.

​
Qué se completa automáticamente

Ejemplo de comando que puedes pegar:

​
Cómo importar un comando cURL

1

Abre el agente

Ve a IA → Agent Studio y abre el agente (o crea uno nuevo si tu cuenta lo permite).
2

Confirma el disparador

El agente debe tener un disparador de inicio, como Mensaje de chat, Formulario enviado, Etiqueta del contacto o Flujos de trabajo.
3

Agrega la llamada a API

Agrega un nodo Agente de IA o Secuencial y dentro de él la herramienta o el paso Llamada a API. Abre su panel de configuración.
4

Importa el cURL

Haz clic en Importar cURL, pega el comando en el campo Comando cURL y haz clic en Importar.
5

Revisa los campos

Comprueba el método, la URL, los encabezados, el cuerpo, el tipo de cuerpo, el nombre de la variable y, si estás en un nodo Agente de IA, las instrucciones. Haz los cambios necesarios.
6

Guarda y prueba

Haz clic en Guardar y usa Probar para verificar la llamada antes de publicar. El emulador de chat y la línea de tiempo de ejecución te muestran la respuesta paso a paso.
7

Publica

Cuando todo funcione, haz clic en Publicar.

​
Qué revisar después de importar

Los comandos cURL copiados de pruebas suelen incluir tokens o claves reales. Revisa siempre esos valores antes de guardar y no compartas capturas de la configuración.

​
Sincronización en ambos sentidos

Si vuelves a abrir Importar cURL después de configurar la llamada, verás la configuración actual convertida en un comando cURL. Puedes editarlo y volver a importarlo. Es útil para:
  • Verificar el formato de la solicitud.
  • Compararla con la documentación de la API externa.
  • Editar rápido encabezados o el cuerpo.
  • Resolver problemas antes de publicar.

​
Llamada a API frente a la API pública de Agent Studio

  • La herramienta Llamada a API hace que tu agente llame a un sistema externo mientras se ejecuta: consultar datos, enviar información o iniciar un proceso fuera de Chateea.
  • La API pública de Agent Studio hace lo contrario: permite que una aplicación externa liste, consulte y ejecute tus agentes en producción sin entrar a Chateea.

​
Preguntas frecuentes

Sí. Revisa y ajusta los campos antes de guardar o probar.
Sí. Admite cuerpos de varias líneas y la continuación de línea con barra invertida.
Sí. Agrega variables de Agent Studio donde necesites valores dinámicos. Consulta Variables y valores personalizados.
La URL, el método, los encabezados, los valores de autorización, el cuerpo, el tipo de cuerpo y las variables. Luego vuelve a probar el agente.

​
Artículos relacionados

API pública de Agent Studio

Ejecuta tus agentes desde otros sistemas.

Nodo secuencial

Usa llamadas a API como pasos fijos.

Nodo Agente de IA

Usa llamadas a API como herramienta.

Prueba y depura agentes

Revisa la respuesta de la API paso a paso.
Última modificación el 29 de septiembre de 2026