# Zelinqa ## Développeurs ### Commencer - [Zelinqa](https://docs.zelinqa.ai/fr/introduction.md): Collectez davantage d'informations utiles en moins de tours. - [Démarrage rapide](https://docs.zelinqa.ai/fr/quickstart/overview.md): Obtenez une question, envoyez une réponse et suivez vos dimensions avec Python ou TypeScript. - [Connecter le MCP](https://docs.zelinqa.ai/fr/quickstart/mcp.md): Installer Zelinqa MCP et conduire une conversation avec un hôte compatible. ### Guides - [Gérer une conversation](https://docs.zelinqa.ai/fr/concepts/session-lifecycle.md): Enchaîner les tours, conserver la session, reprendre après une coupure et enregistrer le résultat. - [Réponses et contexte](https://docs.zelinqa.ai/fr/guides/answers-context.md): Transmettre une réponse ouverte, des choix, un refus ou des informations déjà connues. - [Une conversation de bout en bout](https://docs.zelinqa.ai/fr/guides/complete-conversation.md): Un chatbot en terminal : poser les questions, traiter les réponses et transmettre les informations à votre application. - [Progression et qualification](https://docs.zelinqa.ai/fr/concepts/qualification.md): Comprendre quand une dimension est couverte et ce qu'ajoutent les niveaux de qualification. - [Lire une décision](https://docs.zelinqa.ai/fr/api-reference/decision-signals.md): Comprendre action, warnings, degraded_reasons et stop_reason après un appel /next. ### Références - [Référence SDK](https://docs.zelinqa.ai/fr/integrations/sdk.md): Installer les clients officiels, conduire une session et gérer une configuration. - [Serveur MCP](https://docs.zelinqa.ai/fr/integrations/mcp.md): Brancher Zelinqa à un hôte MCP avec des outils de conversation métier. - [Utilisation et limites](https://docs.zelinqa.ai/fr/reference/usage-limits.md): Comptage des conversations, contraintes du contrat et bonnes pratiques de débit. ### Ressources - [Sécurité des clés API](https://docs.zelinqa.ai/fr/security/api-key-safety.md): Stockage, séparation, rotation et révocation des clés Zelinqa. - [Glossaire](https://docs.zelinqa.ai/fr/reference/glossary.md): Les termes essentiels de Zelinqa V1. - [Journal des modifications](https://docs.zelinqa.ai/fr/changelog.md): Évolutions publiques de Zelinqa, de l'API et des intégrations. ## Zelinqa Studio ### Configurer - [Découvrir Zelinqa Studio](https://docs.zelinqa.ai/fr/studio/overview.md): Construisez, vérifiez et publiez un parcours de qualification sans modifier votre application. - [Configurer votre premier domaine](https://docs.zelinqa.ai/fr/quickstart/configure-domain.md): Préparez et publiez une base de questions dans Zelinqa Studio. - [Questions](https://docs.zelinqa.ai/fr/studio/questions.md): Créez, importez, modifiez et organisez les questions disponibles dans le parcours. - [Dimensions](https://docs.zelinqa.ai/fr/studio/dimensions.md): Structurez la conversation en étapes métier et précisez leur rôle dans la réussite. - [Informations à collecter](https://docs.zelinqa.ai/fr/studio/success-information.md): Définir les données structurées dont votre application a besoin. - [Réglages de qualification](https://docs.zelinqa.ai/fr/studio/objective.md): Choisissez la profondeur, la longueur et l'ordre du parcours. ### Publier et exploiter - [Vérifier et publier](https://docs.zelinqa.ai/fr/studio/publish.md): Validez un brouillon, suivez sa compilation et activez une nouvelle version. - [De la configuration aux conversations](https://docs.zelinqa.ai/fr/concepts/how-it-works.md): Comprendre le brouillon, la publication et les sessions sans modifier votre application. - [Créer une clé API](https://docs.zelinqa.ai/fr/quickstart/generate-api-key.md): Créez une clé à portée minimale pour appeler Zelinqa depuis votre backend. - [Clés API](https://docs.zelinqa.ai/fr/studio/api-keys.md): Créez, séparez et révoquez les accès techniques à votre domaine. - [Consommation et activité](https://docs.zelinqa.ai/fr/dashboard/overview.md): Suivez l'utilisation réelle de votre domaine sans interpréter une corrélation comme une causalité. ## Référence API ### Guides API - [Référence API V1](https://docs.zelinqa.ai/fr/api-reference/overview.md): Base URL, ressources et règles essentielles du contrat public Zelinqa. - [Authentification, idempotence et concurrence](https://docs.zelinqa.ai/fr/api-reference/auth-concurrency.md): Protégez les clés et rendez chaque mutation sûre à rejouer. - [Intégration REST](https://docs.zelinqa.ai/fr/integrations/rest-api.md): Le modèle d'intégration recommandé pour connecter Zelinqa à un backend existant. - [Appels HTTP avec curl](https://docs.zelinqa.ai/fr/quickstart/first-api-call.md): Créez une session et obtenez la première question avec curl. - [Erreurs](https://docs.zelinqa.ai/fr/api-reference/errors.md): Enveloppe d'erreur V1, principaux codes et stratégie de reprise. ### Sessions - [Créer une session](https://docs.zelinqa.ai/api-reference/sessions/créer-une-session.md): Crée une session attachée à la version publiée active. La première question est obtenue ensuite avec POST /v1/sessions/{session_id}/next. initial_history permet de reprendre une conversation déjà commencée. - [Comprendre le tour précédent et proposer les questions suivantes](https://docs.zelinqa.ai/api-reference/sessions/comprendre-le-tour-précédent-et-proposer-les-questions-suivantes.md): Route principale du runtime. En un seul appel, le moteur résout la question réellement posée et son outcome, applique les mises à jour du client, réduit l'état, recalcule les progressions, puis classe les questions éligibles. - [Appliquer un contexte ou une mise à jour sans sélectionner de question](https://docs.zelinqa.ai/api-reference/sessions/appliquer-un-contexte-ou-une-mise-à-jour-sans-sélectionner-de-question.md): Même réducteur que `/next`, sans la phase de sélection. Sert à rattraper des messages qui n'ont pas transité par Zelinqa, synchroniser une donnée déjà connue du système appelant, corriger une valeur, ou piloter une dimension. - [Lire l'état public d'une session](https://docs.zelinqa.ai/api-reference/sessions/lire-létat-public-dune-session.md): Renvoie l'état de reprise complet : en-tête, résultats des questions, cibles touchées, progressions et contrôles client, décision en attente avec tous ses candidats réhydratés. - [Déclarer le résultat réel de la conversation](https://docs.zelinqa.ai/api-reference/sessions/déclarer-le-résultat-réel-de-la-conversation.md): Enregistre ce que la conversation a produit, sans modifier rétroactivement le scoring ni l'état de la session. ### Configuration - [Lire la configuration éditoriale](https://docs.zelinqa.ai/api-reference/configuration/lire-la-configuration-éditoriale.md): Renvoie les quatre objets configurés dans Zelinqa Studio : objectif, dimensions, informations de réussite et questions. - [Lister les questions](https://docs.zelinqa.ai/api-reference/configuration/lister-les-questions.md): Liste paginée et filtrable du corpus. `format=csv` renvoie le même jeu de données en `text/csv`, colonnes stables et documentées, pour export vers un tableur ou réimport. - [Consulter le journal des changements](https://docs.zelinqa.ai/api-reference/configuration/consulter-le-journal-des-changements.md): Renvoie les actions de configuration du domaine, de la plus récente à la plus ancienne. Cette lecture est réservée au scope `configuration:publish` : le journal contient l'identité des opérateurs et n'est pas une simple lecture du corpus. - [Appliquer des changements au brouillon](https://docs.zelinqa.ai/api-reference/configuration/appliquer-des-changements-au-brouillon.md): Applique **atomiquement** une liste ordonnée d'opérations au brouillon : soit toutes réussissent, soit aucune n'est écrite. Les identifiants fournis par l'appelant sont conservés ; ils restent stables entre les publications. - [Publier le brouillon](https://docs.zelinqa.ai/api-reference/configuration/publier-le-brouillon.md): Valide le brouillon, crée un job de compilation et retourne immédiatement `202 Accepted`. La compilation ne s'exécute **jamais** dans la requête HTTP : un corpus important demande plusieurs lots LLM, bien au-delà de la limite de la passerelle. - [Suivre un job de compilation](https://docs.zelinqa.ai/api-reference/configuration/suivre-un-job-de-compilation.md): Renvoie l'avancement du job : `queued`, `running`, `succeeded` ou `failed`. ### Service - [Sonde de disponibilité](https://docs.zelinqa.ai/api-reference/legacy/sonde-de-disponibilité.md): Route publique sans authentification. Ne renvoie aucune donnée de tenant. ## OpenAPI Specs - [openapi.fr](/openapi.fr.yaml) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [English (42 pages)](https://docs.zelinqa.ai/_llms/en.md): Documentation for English. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.