Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Création d'un agent personnalisé
Vous pouvez créer un agent personnalisé de deux manières : à l'aide du formulaire dans l'application Web DevOps Agent ou par le biais d'une conversation guidée dans Chat. Les deux méthodes aboutissent à la même configuration d'agent personnalisée stockée dans votre espace agent.
Avant de créer un agent personnalisé, vous devez disposer d'un espace agent avec au moins une intégration connectée. Pour de plus amples informations, veuillez consulter [Création d'un espace d'agents](getting-started-with-aws-devops-agent-creating-an-agent-space.md).
## Création d'un agent personnalisé à l'aide du formulaire
Le formulaire vous permet de créer rapidement un agent personnalisé en spécifiant un nom, une invite système et des compétences facultatives. Pour attribuer des outils MCP à l'agent, utilisez Chat après avoir créé l'agent.
**Pour créer un agent personnalisé à l'aide du formulaire :**
1. Accédez à la page **Agents** dans votre application Web DevOps Agent.
1. Dans la section **Agents personnalisés**, choisissez **Créer un agent**.
1. Dans la boîte de dialogue, sélectionnez **Formulaire**.
1. Remplissez le formulaire :
+ **Nom** : identifiant unique de votre agent. Utilisez uniquement des lettres minuscules, des chiffres et des traits d'union (64 caractères maximum). Ne doit pas commencer ou se terminer par un trait d'union. Exemple : `weekly-health-report`
+ **Invite système** — Instructions qui définissent ce que fait l'agent et comment il fonctionne, écrites en Markdown (minimum 10 caractères, maximum 50 000 caractères). Pour obtenir des conseils sur la rédaction d'instructions efficaces, consultez la section [Rédaction d'une invite système](#writing-a-system-prompt).
+ **Compétences** (facultatif) : sélectionnez les compétences de votre espace d'agent qui fournissent à l'agent des connaissances ou des capacités supplémentaires dans le domaine. Utilisez le champ de recherche pour trouver les compétences par nom.
1. Choisissez **Create agent (Créer un agent)**.
Après la création, vous êtes redirigé vers la page détaillée de l'agent où vous pouvez consulter la configuration, exécuter l'agent ou configurer des déclencheurs.
## Création d'un agent personnalisé à l'aide de Chat
Le chat fournit une expérience conversationnelle guidée pour créer des agents personnalisés. Cette méthode est recommandée lorsque vous souhaitez attribuer des outils MCP à l'agent ou lorsque vous souhaitez obtenir de l'aide pour écrire l'invite système.
**Pour créer un agent personnalisé à l'aide de Chat :**
1. Accédez à la page **Agents** dans votre application Web DevOps Agent.
1. Dans la section **Agents personnalisés**, choisissez **Créer un agent**.
1. Dans la boîte de dialogue, choisissez **Chat**. La boîte de dialogue se ferme et une nouvelle conversation s'ouvre dans le panneau de discussion avec un message précomposé.
1. Le chat vous guide tout au long d'un processus collaboratif :
+ **Clarification de l'intention** — Confirme le but et la portée de votre agent.
+ **Vérification dupliquée** : vérifie qu'aucun agent similaire n'existe déjà dans votre espace agent.
+ **Sélection des outils et des compétences** : propose les outils et compétences MCP dont l'agent a besoin et vous demande de les confirmer.
+ **Type de sortie** : détermine si l'agent doit produire des réponses textuelles, des artefacts ou des recommandations.
+ **Brouillon d'invite** du système : écrit une invite système et la présente pour examen. Vous pouvez répéter jusqu'à ce que vous soyez satisfait.
+ **Confirmation** : suggère un nom et confirme tous les paramètres avant de créer l'agent.
Vous pouvez également créer un agent personnalisé en demandant directement à Chat à tout moment. Par exemple :
```
Create an agent that generates a weekly report of all investigations from the past week.
```
```
Create a custom agent for checking certificate expiration across all accounts.
```
```
Make me an agent that audits DynamoDB table configurations daily.
```
## Rédaction d'une invite système
L'invite du système est la partie la plus importante de votre agent personnalisé. Il définit l'objectif, l'approche, les contraintes et les résultats attendus de l'agent. Un message bien rédigé produit des résultats cohérents et fiables.
**Structurez votre invite système à l'aide des sections suivantes :**
+ **Objectif** — Ce que l'agent doit accomplir en une seule phrase ou un court paragraphe.
+ **Approche** : Step-by-step procédures que l'agent doit suivre, en faisant référence aux noms d'outils spécifiques qu'il doit appeler et dans quel ordre.
+ **Contraintes** — Limites de ce que l'agent doit et ne doit pas faire. Par exemple, accès en lecture seule, plages de temps à prendre en compte ou services à exclure.
+ **Résultat** : ce que l'agent doit produire et dans quel format. Spécifiez s'il doit générer du texte, créer un artefact ou créer une recommandation.
**Exemple d'invite système :**
```
You are a DevOps reporting agent specializing in summarizing investigation activity.
## Goal
Generate a concise weekly report of all investigations from the past 7 days.
## Approach
1. Call `list_investigations` to fetch investigations from the last 7 days.
2. For each investigation, retrieve its title, status, root cause, and resolution time.
3. Group investigations by status and root cause category.
4. Identify trends: services most affected, average resolution time, recurring root causes.
## Constraints
- Only include investigations from the past 7 days.
- Read-only access — do not modify, close, or reassign investigations.
## Output
Produce a single artifact titled "Weekly Investigation Report" containing:
- A table listing each investigation with title, status, and resolution time.
- A chart showing investigation counts by root cause category.
- A summary paragraph with key trends and recommendations.
```
**Conseils pour que les instructions du système soient efficaces :**
+ **Soyez précis en ce qui concerne les outils** : référencez directement les noms des outils (par exemple `list_investigations``use_aws`,,`query_cloudwatch_logs`) afin que l'agent sache quels outils appeler.
+ **Définissez les critères de réussite** : décrivez à quoi ressemble un bon résultat afin que l'agent sache quand il est terminé.
+ **Définissez des limites** : indiquez explicitement ce que l'agent ne doit pas faire pour empêcher des actions involontaires.
+ **Utilisez le formatage Markdown** : les en-têtes, les listes et les blocs de code facilitent l'analyse et le suivi de l'invite par l'agent.
## Outils de configuration
Les outils MCP déterminent les actions que votre agent personnalisé peut effectuer lors de l'invocation. Vous sélectionnez des outils parmi l'ensemble complet disponible dans votre espace agent, notamment les outils issus de AWS comptes connectés, de plateformes d'observabilité, de CI/CD pipelines, de systèmes de billetterie et de serveurs MCP personnalisés.
Les outils ne peuvent être configurés que par le biais du chat. Pour attribuer des outils lors de la création d'un agent, utilisez la méthode de création de chat. Pour ajouter ou modifier des outils sur un agent existant, demandez à Chat de mettre à jour l'agent. Par exemple :
```
Add the query_cloudwatch_logs and use_aws tools to my weekly-health-report agent.
```
```
Update certificate-checker to also use the list_resources tool.
```
```
Remove the use_kubectl tool from cluster-audit-agent.
```
Lorsque vous sélectionnez des outils, suivez le principe du moindre privilège : attribuez uniquement les outils dont l'agent a besoin pour accomplir sa tâche. Cela réduit le risque d'actions imprévues et permet à l'agent de rester concentré.
## Configuration des compétences
Les compétences fournissent à votre agent personnalisé des connaissances supplémentaires dans le domaine, des procédures d'enquête ou des capacités spécialisées. Lorsqu'un agent personnalisé s'exécute, il charge les compétences qui lui sont assignées et peut faire référence à leurs instructions lors de l'invocation.
Vous pouvez attribuer des compétences lors de la création (à l'aide du formulaire ou du chat) ou les ajouter ultérieurement en modifiant l'agent. Les compétences attribuées à un agent personnalisé doivent déjà exister dans votre espace agent. Pour plus d'informations sur la création de compétences, consultez[DevOps Compétences des agents](about-aws-devops-agent-devops-agent-skills.md).
Les agents personnalisés disposent également de fonctionnalités intégrées permettant de créer des artefacts et des recommandations qui ne nécessitent pas d'attribution de compétences. Pour de plus amples informations, veuillez consulter [Sorties personnalisées de l'agent](custom-agents-custom-agent-outputs.md).
Vous pouvez attribuer jusqu'à 200 compétences par agent personnalisé. Choisissez des compétences adaptées à l'objectif de l'agent afin de réduire la consommation de contexte et d'améliorer la concentration de l'agent.