Configuration d’agent

Configurez et personnalisez vos agents IA pour répondre à vos besoins spécifiques. Cette section couvre tout, de la rédaction d’invites efficaces à l’activation des outils avancés.

Aperçu

La configuration de l’agent détermine comment votre agent IA se comporte, ce qu’il peut faire et comment il interagit avec les utilisateurs. Les composants clés sont :

  • Invites système - Définissent le rôle, la personnalité et le comportement de l’agent
  • Outils et capacités - Activez des fonctionnalités spécifiques comme l’exécution de code, la navigation web ou les opérations de fichiers
  • Sélection du modèle - Choisissez le bon modèle IA pour votre cas d’usage
  • Permissions et visibilité - Contrôlez qui peut accéder et utiliser vos agents

Sujets de configuration

Invites et instructions

Apprenez à rédiger des invites système efficaces qui guident le comportement de votre agent.

Vous apprendrez :

  • Comment structurer les invites système
  • Meilleures pratiques en ingénierie d’invite
  • Modèles d’invite courants
  • Exemples pour différents cas d’usage

Lire le guide Invites et instructions


Outils

Activez et configurez les outils qui étendent les capacités de votre agent.

Outils disponibles :

  • Bash - Exécuter des commandes shell
  • Système de fichiers - Lire et écrire des fichiers
  • Recherche web - Rechercher sur Internet
  • Exécution de code - Exécuter du code dans des environnements isolés
  • Serveurs MCP - Se connecter à des services externes

Explorer la documentation des outils


Démarrage rapide

Configuration d’agent de base

{
  "name": "Agent de support client",
  "role": "Spécialiste du support",
  "systemPrompt": "Vous êtes un agent de support client amical...",
  "model": "claude-sonnet-4-6",
  "advanced_tools": ["read_webpage", "exa"],
  "visibility": "organization"
}

Configuration avancée

Pour les agents de production, considérez :

  1. Invites système détaillées - Incluez des exemples, des contraintes et des cas limites
  2. Sélection des outils - Activez uniquement les outils que l’agent a réellement besoin
  3. Directives de sécurité - Ajoutez des garde-fous pour les opérations sensibles
  4. Tests - Testez complètement les configurations avant le déploiement

Meilleures pratiques

Rédaction d’invites système

Faire :

  • Être spécifique sur le rôle et les responsabilités de l’agent
  • Inclure des exemples du comportement souhaité
  • Définir des limites et des limitations claires
  • Utiliser un ton et un style cohérents

Ne pas faire :

  • Rendre les invites trop vagues ou génériques
  • Supposer que l’agent connaît votre contexte métier
  • Ignorer les tests avec de vraies requêtes utilisateur
  • Oublier de mettre à jour les invites à mesure que les exigences changent

Configuration des outils

Faire :

  • Activer uniquement les outils nécessaires (principe du moindre privilège)
  • Tester les outils individuellement avant de les combiner
  • Documenter pourquoi chaque outil est nécessaire
  • Surveiller l’utilisation des outils en production

Ne pas faire :

  • Activer tous les outils “juste au cas où”
  • Ignorer l’examen de sécurité pour les outils bash/système de fichiers
  • Oublier de définir les autorisations appropriées
  • Ignorer les modèles d’utilisation des outils

Modèles courants

Agent de support client

{
  systemPrompt: `Vous êtes un agent de support client utile pour [Entreprise].

Vos responsabilités :
- Répondre avec précision aux questions produit
- Résoudre les problèmes courants
- Escalader les problèmes complexes au support humain
- Maintenir un ton professionnel et amical

Base de connaissances :
- Documentation du produit dans /docs
- FAQ dans /knowledge/faq.md

Contraintes :
- Ne jamais partager d'informations internes
- Ne faites pas de promesses sur les fonctionnalités
- Confirmez toujours avant de prendre des mesures`,

  advanced_tools: ["read_webpage", "filesystem"]
}

Agent d’examen de code

{
  systemPrompt: `Vous êtes un développeur senior examinant le code pour la qualité et les meilleures pratiques.

Domaines d'intérêt :
- Qualité et lisibilité du code
- Vulnérabilités de sécurité
- Problèmes de performance
- Couverture des tests
- Documentation

Liste de vérification d'examen :
1. Vérifiez les bugs évidents
2. Vérifiez la gestion des erreurs
3. Recherchez les problèmes de sécurité
4. Évaluez l'organisation du code
5. Suggérez des améliorations`,

  advanced_tools: ["bash", "filesystem"]
}

Agent de recherche

{
  systemPrompt: `Vous êtes un assistant de recherche qui trouve et synthétise les informations.

Processus de recherche :
1. Comprendre la question de recherche
2. Rechercher les sources pertinentes
3. Vérifier l'exactitude des informations
4. Synthétiser les conclusions
5. Citer les sources

Directives :
- Prioriser les sources faisant autorité
- Croiser les informations
- Noter les contradictions
- Fournir des liens source`,

  advanced_tools: ["exa", "read_webpage"]
}

Prochaines étapes

Prêt à configurer votre agent ? Commencez par ces guides :

  1. Invites et instructions - Rédiger des invites système efficaces
  2. Outils - Activer les capacités avancées
  3. Dépannage - Corriger les problèmes de configuration courants

Besoin d’aide ?