API para desarrolladores
Construye sobre Cuneiform Chat desde tu propio código
Una API REST pública y autenticada por clave que permite que tu código haga lo que hace el panel: cargar conocimiento, gestionar tus agentes de IA y consultarlos desde cualquier lugar. Una sola clave bearer, JSON predecible y una referencia de la que puedes copiar.
Lo que puedes construir con la API
Carga conocimiento de forma programática
Envía documentos a la base de conocimiento de un agente directamente desde tu código o tu pipeline. Los archivos se analizan, se dividen en fragmentos, se incrustan y se vuelven buscables: el mismo stack RAG que usa el panel, impulsado por una llamada a la API.
Gestiona agentes como código
Crea, lista, actualiza e inspecciona tus agentes de IA a través de la API. Integra la configuración de los agentes en tu propio aprovisionamiento o CI para que un nuevo agente sea un paso del despliegue, no un clic en el panel.
Consulta a un agente desde cualquier lugar
Envía una pregunta a cualquier agente y recibe una respuesta fundamentada, con la misma recuperación y el mismo razonamiento que usan tus canales. Intégralo en una app, un proceso de backend u otro producto.
Claves de API con permisos limitados y revocables
Genera claves solo con los permisos que necesita cada carga de trabajo y revócalas en cuanto se filtren. Las claves llevan el prefijo cuk_live_ y se muestran una sola vez: mínimo privilegio, por diseño.
Errores y límites de uso predecibles
Cada respuesta es JSON con una estructura estable, códigos de error consistentes y encabezados claros de límite de uso, para que tu cliente pueda reintentar, aplicar back-off y mostrar fallos sin tener que adivinar.
Una referencia de la que puedes copiar
Una referencia completa y publicada cubre la autenticación, las convenciones, los errores, los límites de uso y todos los endpoints de los tres dominios, con ejemplos de solicitud y respuesta listos para pegar.
De la clave a la primera respuesta
Cinco pasos desde una terminal vacía hasta una integración en vivo.
Obtén una clave
Abre la consola de desarrolladores en tu panel y emite una clave de API, eligiendo los permisos que necesita la integración. Cópiala una sola vez: empieza con cuk_live_.
Autentícate
Envía la clave como Authorization: Bearer en cada solicitud (el encabezado X-API-Key es un alias documentado). Sin baile de OAuth ni sesión que refrescar.
Llama a un endpoint
Accede a cualquier ruta bajo /api/developer/v1: carga en Conocimiento, gestiona Agentes o ejecuta una Consulta de agente. Misma URL base, misma autenticación, tres dominios.
Procesa la respuesta
Analiza el cuerpo JSON, lee los encabezados de límite de uso y reacciona según el código de error cuando algo sale mal. La estructura es estable en todos los endpoints.
Despliega y escala
Pasa de una prueba con curl a producción: rota claves, asigna permisos por carga de trabajo y deja que los límites de uso documentados guíen los reintentos y la concurrencia de tu cliente.
Casos de uso
Lo que los equipos construyen con la API
Sincroniza conocimiento desde tus sistemas
Programa un trabajo nocturno o un webhook para enviar nuevos documentos, artículos del centro de ayuda o especificaciones de producto a la base de conocimiento de un agente, para que las respuestas se mantengan actualizadas sin que nadie toque el panel.
Integra un agente en tu propio producto
Llama al endpoint de consulta desde tu app o tu backend para añadir un asistente de IA fundamentado a una superficie para la que no ofrecemos un canal: tu app móvil, una herramienta interna o un widget personalizado.
Aprovisiona agentes en CI/CD
Crea y configura agentes como parte de un pipeline de despliegue, de modo que levantar un nuevo entorno o un nuevo tenant de cliente incluya su agente de IA como código, no como un paso de configuración manual.
Automatiza flujos administrativos
Haz que un script pida a un agente que resuma, clasifique o responda sobre tu base de conocimiento de forma programada, y enruta el resultado a donde tu equipo ya trabaja.
Impulsa herramientas y paneles internos
Lleva las respuestas de los agentes a un bot de Slack, un panel de operaciones o una consola de soporte que sean tuyos: una sola clave bearer y una respuesta JSON es todo lo que necesita la integración.