Accès API et intégration pour les développeurs

L'intégration d'API nécessite une authentification et un contrat clair. Adaptez les exemples de transport à la documentation de la version installée.

Ces étapes font référence aux fonctionnalités identifiées dans le code de l'application. Ce matériel n'a pas été validé sur une instance réelle ; vérifiez la documentation et les options de votre version.

Comment ça marche, étape par étape

Données contractuelles et exemples

Cible de la demande de document, identifiant de conversation, délai d'expiration et consommation de flux. Consulter Documentation API pour les points de terminaison et les schémas. Ne réutilisez pas un corps générique à travers Playground, chat et RAG : leurs contrats peuvent différer. L'exemple minimal ci-dessous illustre l'intention, et non une charge utile HTTP garantie.

Le schéma explicatif

Suivez les flèches pleines pour le flux principal. Les flèches bleues en pointillés fournissent des données ou un contexte ; les flèches roses en pointillés affichent des commentaires ou des résultats renvoyés. Les couleurs et les formes distinguent les modèles, les magasins, les décisions et les sorties. Sur un petit écran, faites défiler horizontalement pour suivre le schéma complet.

Un exemple complet

Votre backend appelle discuter avec la cible et le contexte de l'organisation/du projet, lit le flux et gère les erreurs. Les secrets restent dans le backend, pas dans le navigateur.

{"intent":"ask_policy","target":"fictional-agent","question":"What is the return deadline?"}

Essayez-le vous-même

1. Ouvrez la documentation de l'API et vérifiez les en-têtes, le corps et le schéma de réponse avant d'appeler.
2. Enregistrez l’entrée, la source et le résultat attendu avant d’exécuter l’expérience. Utilisez uniquement les données fictives de l'exemple.
3. Suivez les étapes du diagramme. À chaque étape, enregistrez les informations reçues et produites ; ne confondez pas le résultat intermédiaire avec le résultat final.
4. Répétez après avoir supprimé les informations nécessaires ou rendu la saisie ambiguë. Vérifiez si le système clarifie, arrête ou invente une réponse.
5. Comparez avec la solution expliquée. Conservez la configuration, la date, le résultat et une explication des différences. Changez une chose et retestez.

Une solution expliquée

Le client distingue la réponse finale, le délai d'attente et le refus d'accès sans divulguer la clé. Un exercice réussi vous permet de montrer le lien entre les contributions, les étapes et les résultats. Lorsqu’une information manque, une réponse prudente est plus utile que des détails inventés. Comparez bien plus que le style : vérifiez également les conditions, les sources et les opérations.

Quand cette approche est utile et quelles sont ses limites

Une clé MCP de déploiement n'est pas automatiquement une clé API d'organisation. Choisissez cette approche lorsqu’elle améliore un besoin mesuré. Gardez une base de référence simple et comparez les résultats en utilisant des entrées identiques. Un exemple réussi n’établit pas la fiabilité dans toutes les situations.

Vérifiez vos connaissances

Pourquoi supprime-t-on une source privée après avoir répondu trop tard ?

Les données sont déjà entrées dans le contexte du modèle et peuvent être divulguées.

Qui exécute un appel proposé par le modèle ?

L'application ou le service hôte après validation. Le modèle n'obtient pas automatiquement un accès illimité.

Quel résultat cet exercice devrait-il produire ?

Le client distingue la réponse finale, le délai d'attente et le refus d'accès sans divulguer la clé.

Les mots à retenir

• Autoriser / Autorisation: Vérification du droit d'accès à une opération ou une ressource.
• Appel d'outil: Une demande structurée pour utiliser une capacité externe.
• Idempotence: Répétition contrôlée sans dupliquer un effet.

Sources et votre prochaine étape

• Nymrio — Documentation API

Pour préparer : U05 — Un widget IA sur votre site Web