API pour développeurs
Développez sur Cuneiform Chat depuis votre propre code
Une API REST publique authentifiée par clé qui permet à votre code de faire ce que fait le tableau de bord : alimenter la base de connaissances, gérer vos agents IA et les interroger depuis n'importe où. Une seule clé bearer, du JSON prévisible et une référence dont vous pouvez copier le contenu.
Ce que vous pouvez construire avec l'API
Ingérez des connaissances par programmation
Poussez des documents dans la base de connaissances d'un agent directement depuis votre code ou votre pipeline. Les fichiers sont analysés, découpés, vectorisés et rendus interrogeables : la même pile RAG que celle du tableau de bord, déclenchée par un appel d'API.
Gérez les agents comme du code
Créez, listez, mettez à jour et inspectez vos agents IA via l'API. Intégrez la configuration des agents à votre propre provisionnement ou à votre CI pour qu'un nouvel agent soit une étape de déploiement, et non un clic dans le tableau de bord.
Interrogez un agent depuis n'importe où
Envoyez une question à n'importe quel agent et recevez une réponse fondée, avec la même récupération et le même raisonnement que vos canaux. Intégrez-la dans une appli, une tâche de backend ou un autre produit.
Des clés d'API à portée limitée et révocables
Générez des clés avec uniquement les portées dont une charge de travail a besoin et révoquez-les dès qu'elles fuient. Les clés portent le préfixe cuk_live_ et ne s'affichent qu'une fois : moindre privilège, par conception.
Des erreurs et des limites de débit prévisibles
Chaque réponse est du JSON à la structure stable, avec des codes d'erreur cohérents et des en-têtes de limite de débit clairs, pour que votre client puisse réessayer, temporiser et signaler les échecs sans deviner.
Une référence dont vous pouvez copier le contenu
Une référence complète et publiée couvre l'authentification, les conventions, les erreurs, les limites de débit et tous les endpoints des trois domaines, avec des exemples de requête et de réponse prêts à coller.
De la clé à la première réponse
Cinq étapes, d'un terminal vide à une intégration en production.
Obtenez une clé
Ouvrez la console développeur de votre tableau de bord et émettez une clé d'API en choisissant les portées dont l'intégration a besoin. Copiez-la une seule fois : elle commence par cuk_live_.
Authentifiez-vous
Envoyez la clé sous forme d'Authorization: Bearer à chaque requête (l'en-tête X-API-Key est un alias documenté). Pas de danse OAuth, aucune session à rafraîchir.
Appelez un endpoint
Atteignez n'importe quel chemin sous /api/developer/v1 : ingérez dans Connaissances, gérez les Agents ou lancez une Requête d'agent. Même URL de base, même authentification, trois domaines.
Traitez la réponse
Analysez le corps JSON, lisez les en-têtes de limite de débit et branchez selon le code d'erreur en cas de problème. La structure est stable sur tous les endpoints.
Mettez en production et passez à l'échelle
Passez d'un test curl à la production : faites tourner les clés, limitez la portée par charge de travail et laissez les limites de débit documentées guider les réessais et la concurrence de votre client.
Cas d'usage
Ce que les équipes construisent sur l'API
Synchronisez les connaissances depuis vos systèmes
Planifiez une tâche nocturne ou un webhook pour pousser de nouveaux documents, des articles du centre d'aide ou des spécifications produit dans la base de connaissances d'un agent, afin que les réponses restent à jour sans que personne ne touche au tableau de bord.
Intégrez un agent dans votre propre produit
Appelez l'endpoint de requête depuis votre appli ou votre backend pour ajouter un assistant IA fondé à une surface pour laquelle nous ne fournissons pas de canal : votre appli mobile, un outil interne ou un widget sur mesure.
Provisionnez des agents en CI/CD
Créez et configurez des agents au sein d'un pipeline de déploiement, de sorte que lancer un nouvel environnement ou un nouveau tenant client inclue son agent IA en tant que code, et non comme une étape de configuration manuelle.
Automatisez les flux administratifs
Faites en sorte qu'un script demande à un agent de résumer, classer ou répondre sur votre base de connaissances selon un planning, et routez le résultat là où votre équipe travaille déjà.
Alimentez vos outils et tableaux de bord internes
Faites remonter les réponses d'un agent dans un bot Slack, un tableau de bord d'exploitation ou une console de support qui vous appartiennent : une seule clé bearer et une réponse JSON suffisent à l'intégration.