Introducción a la API y los SDK

Qué puedes construir

La API pública conecta un agente publicado con tu backend. Permite consultar sus capacidades, enviar mensajes, recibir respuestas normales o por streaming y gestionar conversaciones.

La API no administra la configuración interna del agente, sus bases de conocimiento ni sus herramientas. Esas tareas continúan realizándose en Studio.

Elige una forma de integración

Utiliza uno de los SDK oficiales cuando trabajes con TypeScript o Node.js, Python o .NET. Proporcionan tipos, conversión de nombres, errores específicos y soporte de streaming y cancelación.

Utiliza la API REST directamente cuando tu lenguaje no tenga un SDK oficial o necesites controlar manualmente la petición HTTP.

Credenciales necesarias

Cada integración utiliza:

• AGENT_ID: identificador público generado al publicar el canal API.
• INCEPTIVA_API_KEY: clave privada con prefijo inc_live_.

La API key concede acceso al agente. Úsala únicamente en servidores y nunca en navegadores, aplicaciones móviles o repositorios.

Recursos técnicos

Consulta la documentación de los SDK para la referencia completa y el contrato OpenAPI para explorar los endpoints disponibles.