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 de l'application Web DevOps Agent ou par le biais d'une conversation guidée dans Chat. Les deux méthodes permettent d'obtenir 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 d'agent avec au moins une intégration connectée. Pour de plus amples informations, veuillez consulter Création d'un espace d'agents.
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 :
Accédez à la page Agents de votre application Web DevOps Agent.
Dans la section Agents personnalisés, choisissez Créer un agent.
Dans la boîte de dialogue, choisissez Formulaire.
Remplissez le formulaire :
Nom : identifiant unique de votre agent. Utilisez uniquement des lettres minuscules, des chiffres et des tirets (64 caractères maximum). Ne doit pas commencer ni se terminer par un tiret. Exemple :
weekly-health-reportInvite 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, voir Rédaction d'une invite système.
Compétences (facultatif) : sélectionnez des compétences dans votre espace agent qui fournissent à l'agent des connaissances ou des fonctionnalités supplémentaires dans le domaine. Utilisez le champ de recherche pour trouver les compétences par nom.
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 propose 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 avez besoin d'aide pour rédiger l'invite du système.
Pour créer un agent personnalisé à l'aide de Chat :
Accédez à la page Agents de votre application Web DevOps Agent.
Dans la section Agents personnalisés, choisissez Créer un agent.
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é.
Le chat vous guide tout au long d'un processus collaboratif :
Clarification de l'intention — Confirme l'objectif et la portée de votre agent.
Contrôle des doublons : vérifie qu'aucun agent similaire n'existe déjà dans votre espace d'agent.
Sélection des outils et des compétences : propose les outils et les compétences MCP dont l'agent a besoin et vous demande de confirmer.
Type de sortie : détermine si l'agent doit produire des réponses textuelles, des artefacts ou des recommandations.
Brouillon d'invite 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 le 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.
Importer un agent personnalisé depuis un référentiel
Vous pouvez importer l'invite système d'un agent personnalisé directement à partir d'un fichier Markdown d'un GitHub référentiel. Le contenu du fichier devient l'invite système de l'agent. Vous pouvez gérer les invites des agents dans le contrôle de version et les importer en une seule action.
Prérequis :
Un GitHub compte associé à votre espace agent. Pour connecter un GitHub compte, consultezConnecter GitHub. Toute connexion à GitHub un compte permet l'importation depuis des référentiels publics. Pour les dépôts privés, le compte associé doit disposer d'un accès en lecture au référentiel. GitHub Enterprise Server et GitHub Enterprise Cloud avec connexions de résidence de données sont également pris en charge.
Un fichier Markdown (
.md) dans un GitHub référentiel contenant l'invite du système.
Pour importer un agent personnalisé depuis un référentiel, procédez comme suit :
Accédez à la page Agents de votre application Web DevOps Agent.
Dans la section Agents personnalisés, choisissez Créer un agent.
Dans la boîte de dialogue, choisissez Importer. La boîte de dialogue passe à la GitHub vue Importer depuis.
Remplissez le formulaire :
Nom : identifiant unique de votre agent. Utilisez uniquement des lettres minuscules, des chiffres et des tirets (64 caractères maximum). Ne doit pas commencer ni se terminer par un tiret.
URL du référentiel : lien vers un seul fichier Markdown (
.md) contenant l'invite système de l'agent. Par exemple :https://github.com/my-org/my-repo/blob/main/my-agent.md. Pour GitHub Enterprise Server ou GitHub Enterprise Cloud avec résidence des données, utilisez plutôt l'URL de votre instance. Par exemple :https://github.example.com/my-org/my-repo/blob/main/my-agent.md. Si l'URL ne se termine pas par.md, un avertissement s'affiche. L'importation échoue si le fichier n'est pas Markdown.Compétences (facultatif) — Sélectionnez des compétences dans votre espace agent pour fournir à l'agent des connaissances ou des fonctionnalités supplémentaires dans le domaine.
Choisissez Agent d'importation.
Le fichier du référentiel fournit uniquement l'invite du système. Le nom et les compétences proviennent du formulaire.
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.
Affichage des agents importés :
Un agent importé affiche un GitHub badge Synchronisé depuis à côté de son nom sur la page détaillée de l'agent, ainsi qu'un horodatage de la dernière synchronisation et un lien vers le fichier source. GitHub Dans la liste des agents personnalisés, les agents importés incluent un lien vers leur fichier source.
Si vous modifiez un agent importé, l'invite du système affiche une Read-only étiquette contenant un indice renvoyant au fichier source. Le nom et les compétences restent modifiables.
Synchronisation des agents importés :
Lorsque vous mettez à jour le fichier Markdown dans votre référentiel, ouvrez la page détaillée de l'agent importé et choisissez Synchroniser pour afficher la dernière invite système.
Contraintes :
Format d'URL : seules GitHub les URL sont acceptées, y compris GitHub Enterprise Server et GitHub Enterprise Cloud avec résidence des données. Le GitHub compte connecté doit correspondre à l'URL de l'hôte. Par exemple, une
github.example.comconnexion ne peut importer que depuis desgithub.example.comURL, et non depuisgithub.comdes URL.Fichier Markdown obligatoire — L'URL doit pointer vers un seul
.mdfichier.Taille de fichier maximale : le fichier ne doit pas dépasser 1 Mo (limite de GitHub l'API).
GitHub compte requis — Votre espace agent doit disposer d'un GitHub compte associé pour importer des agents. Pour les dépôts privés, le compte doit disposer d'un accès en lecture.
Agents douaniers communautaires
Le référentiel AWS DevOps Agent Tools
Pour utiliser un agent personnalisé de communauté, importez-le depuis le référentiel à l'aide du flux Importer depuis le référentiel sur la page Agents. Copiez l'URL du fichier Markdown de l'agent et collez-la en tant qu'URL du référentiel. Pour plus de détails, consultez la section Importation d'un agent personnalisé depuis un référentiel.
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. Une invite bien rédigée produit des résultats cohérents et fiables.
Structurez l'invite de votre 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, un accès en lecture seule, des plages horaires à prendre en compte ou des 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 des instructions système efficaces :
Soyez précis en ce qui concerne les outils : faites référence directement aux noms des outils (par exemple
list_investigationsuse_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é.
Fixez des limites : indiquez clairement ce que l'agent ne doit pas faire pour éviter des actions involontaires.
Utilisez le formatage Markdown : les en-têtes, les listes et les blocs de code permettent à l'agent d'analyser et de suivre plus facilement l'invite.
Configuration des outils
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 d'agent, y compris des outils provenant 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 de Chat. Pour attribuer des outils lors de la création d'un agent, utilisez la méthode de création 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, respectez 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 involontaires et permet à l'agent de rester concentré.
Outils Release Manager
Les agents personnalisés ont accès aux outils du Release Manager. Ces outils permettent à votre agent de créer, de répertorier, d'obtenir et d'annuler des tâches du Release Manager. Votre agent peut également analyser un rapport d'évaluation de l'état de préparation des versions afin de faire ressortir les résultats et les actions recommandées.
Pour utiliser les outils Release Manager, attribuez-les à votre agent personnalisé via Chat. Par exemple :
Add the release manager tools to my release-pipeline-agent.
Pour plus d'informations sur les fonctionnalités de gestion des versions, consultezGestion des versions.
Configuration des compétences
Les compétences fournissent à votre agent personnalisé des connaissances supplémentaires dans le domaine, des procédures d'investigation ou des capacités spécialisées. Lorsqu'un agent personnalisé s'exécute, il charge les compétences qui lui sont attribuées et peut référencer 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, consultezDevOps Compétences des agents.
Les agents personnalisés disposent également de fonctionnalités intégrées pour 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.
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.
