Les briques techniques d'un agent
Comprenez ce qu'est une API, distinguez le rôle du modèle et des outils, et maîtrisez les bases de la sécurité d'une clé API.
Objectifs d'apprentissage
- Comprendre ce qu'est une API et son rôle dans la communication entre logiciels
- Distinguer le rôle du modèle (le cerveau) et des outils (les mains)
- Comprendre la notion de clé API et les bases de sa sécurité
Qu'est-ce qu'une API ?
Une API (Interface de Programmation d'Application) est un intermédiaire qui permet à deux logiciels de se parler. Elle définit comment un programme peut demander des services à un autre, de manière standardisée et sécurisée.
Pensez à un restaurant : vous ne rentrez pas en cuisine préparer votre plat, vous passez par le serveur. L'API, c'est ce serveur : elle transmet votre demande au bon endroit et vous rapporte la réponse.
Le modèle et les outils
Dans un agent IA, il y a deux types de composants essentiels qui travaillent ensemble pour accomplir une tâche.
- Comprend l'objectif donné
- Décide quoi faire à chaque étape
- Analyse les résultats obtenus
- Exemples : Claude, GPT-4, Gemini
- Calculatrice : faire des calculs
- Recherche web : trouver de l'info
- Bloc-notes : sauvegarder des données
- Email : envoyer des messages
Le modèle pense et décide. Les outils agissent. Sans outils, le modèle ne peut que répondre. Avec des outils, il peut accomplir des tâches réelles dans le monde.
Les agents avec base de connaissances (RAG)
Certains agents doivent travailler avec de l'information que le modèle n'a jamais apprise : vos documents internes, des manuels techniques, des fiches signalétiques, un catalogue de produits. Pour ça, on ajoute une troisième brique à la structure de base.
- Base de connaissances : vos documents, stockés dans une base de données consultable
- Modèle de raisonnement : le même modèle qu'avant, qui réfléchit et formule les réponses
- API : l'interface qui permet à l'agent d'aller chercher l'information pertinente dans la base de connaissances avant de répondre
Plutôt que d'essayer de tout retenir par cœur, l'agent va chercher le bon document au bon moment, puis formule sa réponse à partir de ce qu'il y trouve. Cette méthode a un nom : la génération augmentée par recherche (RAG).
Exemple concret : un agent qui répond à des questions sur la compatibilité de produits chimiques ira chercher l'information exacte dans les fiches signalétiques enregistrées dans sa base de connaissances, plutôt que d'inventer une réponse approximative.
Cette troisième brique est optionnelle : un agent simple (comme celui que vous construirez au Module 4) n'en a pas besoin. Elle devient utile quand l'agent doit consulter une grande quantité de documents précis.
La clé API et sa sécurité
Pour utiliser un modèle IA comme Claude via une API, vous avez besoin d'une clé API. C'est un identifiant unique qui prouve que c'est bien vous qui faites la demande.
- Garder votre clé dans un endroit sécurisé
- Utiliser des variables d'environnement
- Créer une clé différente par projet
- Révoquer une clé compromise immédiatement
- Partager votre clé avec quelqu'un
- La mettre dans un fichier public
- La coller dans un email ou message
- La laisser visible dans le code
Comme votre NIP bancaire, si quelqu'un obtient votre clé API, il peut l'utiliser à vos frais. Chaque appel API est facturé : une clé volée peut coûter très cher.
Schéma collaboratif
Pensez à un outil que vous utilisez déjà au travail (calendrier, courriel, tableur) et imaginez comment un agent IA pourrait l'utiliser pour accomplir une tâche à votre place.
Vérifiez votre compréhension
1. Dans un agent IA, quel est le rôle du modèle ?
2. Que risque-t-il de se passer si votre clé API est visible publiquement ?
3. Quelle est la meilleure analogie pour expliquer une API ?