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.
Instructions pour les agents
Utilisez les instructions de l'agent pour fournir des conseils permanents que AWS DevOps l'agent applique à chaque session. Une session est une conversation ou une enquête unique avec un agent. Sur la page de connaissances de votre application Web Agent Space Operator, choisissez l'onglet Instructions pour définir des instructions qui s'appliquent à tous les agents, ou définissez des instructions pour un agent géré spécifique, comme le chat ou le triage des incidents. Ces instructions sont stockées dans un AGENTS.md fichier. Contrairement à DevOps Compétences des agents ce qui se charge à la demande lorsque l'agent associe une description de compétence à la tâche en cours, les instructions de l'agent sont toujours présentes dès le début de chaque session, quel que soit le sujet sur lequel l'agent travaille.
Que sont les instructions pour les agents
Les instructions destinées aux agents fournissent des conseils inconditionnels et permanents à vos agents. Au début de chaque session, le service d'agent récupère les instructions configurées pour votre espace agent et injecte leur contenu directement dans l'invite du système d'agent. L'agent ne décide pas de les charger ; ils sont toujours présents.
Chaque session d'agent reçoit des instructions provenant à la fois des instructions globales et des instructions spécifiques à l'agent pertinentes, par exemple Chat.
Les instructions de l'agent sont stockées sous forme de AGENTS.md fichiers et DevOps Compétences des agents diffèrent de plusieurs manières importantes :
| Aspect | Compétence | Instructions pour les agents (AGENTS.md) |
|---|---|---|
| Nom et description | Obligatoire | Non applicable |
| Format du contenu | Pack Markdown ou ZIP | Markdown uniquement |
| Fichiers de ressources | Pris en charge | Non pris en charge |
| Injection contextuelle | À la demande (l'agent décide en faisant correspondre les descriptions de compétences) | Toujours (inconditionnel, à chaque session) |
| Unicité | Plusieurs par espace d'agent | Un par agent (un pour les instructions globales, un par agent géré) |
Les instructions de l'agent ne comportent pas de nom ni de champ de description. Le AGENTS.md fichier sous-jacent ne contient que des démarques, sans frontmatter, sans support pour les bundles ZIP et aucun fichier de ressources.
Pourquoi utiliser les instructions de l'agent
Les instructions de l'agent vous offrent un moyen fiable de vous assurer que certains conseils sont toujours adaptés à leur contexte, sans dépendre des décisions de l'agent en matière de compétences.
Principaux avantages :
Prévisibilité : les instructions sont toujours présentes, quelle que soit la tâche sur laquelle travaille l'agent. Aucune correspondance de description n'est requise et l'agent ne peut pas ignorer le contenu.
Couverture garantie : contrairement aux compétences, que l'agent peut charger ou non en fonction de la pertinence de la tâche, les instructions de l'agent sont toujours injectées au début de chaque session.
Politiques permanentes : utilisez les instructions des agents pour les politiques opérationnelles permanentes, les directives de sécurité, les normes de codage ou toute autre directive qui doit s'appliquer à chaque session sans exception.
Champ d'application ciblé : vous pouvez appliquer des instructions à tous les types d'agents à la fois à l'aide d'instructions globales, ou limiter les instructions à un type d'agent spécifique lorsque les conseils ne concernent que le travail de cet agent.
Comment fonctionnent les instructions destinées aux agents
Lorsqu'une session démarre, le service d'agent récupère les instructions configurées pour votre espace agent et injecte leur contenu dans l'invite du système d'agent avant le début de la session. Cela se produit automatiquement pour chaque session. L'agent n'évalue pas s'il faut les charger ; il injecte toujours le contenu.
Chaque nouvelle session charge les nouvelles instructions au démarrage. Si vous mettez à jour vos instructions, la modification prend effet immédiatement pour les sessions qui démarrent après l'enregistrement. Les sessions déjà en cours continuent d'utiliser le contenu qui a été chargé au moment de leur démarrage.
La définition de la portée détermine les instructions qu'une session reçoit. Les instructions générales s'appliquent à tous les types d'agents de votre espace agent, de sorte que chaque session les reçoit. Agent-specific les instructions s'appliquent uniquement aux sessions de ce type d'agent particulier. Une session reçoit des instructions provenant à la fois des instructions globales et des instructions spécifiques à l'agent concerné.
Définition du type d'agent
Le scoping contrôle quelles sessions d'agent reçoivent un ensemble d'instructions donné. Il existe deux options de définition de la portée :
Instructions générales : s'applique à tous les types d'agents de votre espace agent. Ce contenu est transmis à chaque session d'agent.
Agent-specific: s'applique uniquement aux sessions du type d'agent sélectionné.
Les agents gérés disponibles pour les instructions spécifiques aux agents sont les suivants :
Chat : Ad-hoc questions et demandes pendant les sessions de chat.
Triage des incidents : filtrage des alarmes, classification de gravité et définition initiale de la portée.
Incident RCA - Analyse des causes profondes avec collecte et validation de preuves.
Atténuation des incidents : Short-term mesures correctives et recommandations de solutions à long terme.
Interface utilisateur de l'incident — Génération des résultats d'une enquête, y compris ceux publiés sur d'autres plateformes.
Évaluation - Notation des performances des agents et contrôles de conformité aux politiques.
Tests de version : tests automatisés de l'interface utilisateur et des API par rapport aux applications Web déployées et aux API REST.
Conseils relatifs à la taille du contenu
Chaque fois que vous entamez une conversation ou une enquête, l'agent lit l'intégralité de vos instructions avant de faire quoi que ce soit d'autre. L'agent dispose d'une quantité fixe de mémoire de travail par session, et vos instructions en utilisent une partie. Plus le dossier est volumineux, moins il reste de place pour vos questions, vos enquêtes, les journaux que l'agent lit et son propre raisonnement. Des instructions plus courtes et ciblées donnent à l'agent une plus grande capacité à résoudre votre problème.
Limite stricte : 25 Ko
Taille recommandée : 120 lignes (recommandée pour la plupart des configurations)
Concentrez vos instructions sur les conseils qui doivent être présents à chaque session. Pour les procédures d'enquête spécialisées qui ne s'appliquent qu'à des tâches spécifiques, pensez à les utiliser à la DevOps Compétences des agents place.
Exemple
L'exemple suivant présente des instructions d'agent bien structurées avec des conseils d'investigation, des normes de formatage des réponses et des exigences de sécurité qui s'appliquent à chaque session d'agent.
# Agent Instructions ## Investigation approach - Always check CloudWatch alarms and recent deployments before proposing a root cause. ## Response format - Lead with a one-sentence summary of findings before listing details. - Include the AWS region and resource identifier for any resource you reference. - Use bullet points for lists of findings or recommendations. ## Security - Never log, display, or suggest storing credentials or secrets in plaintext. - When recommending IAM changes, follow least-privilege principles.
Configuration des instructions de l'agent
Avant de définir les instructions de l'agent, vous devez disposer d'un espace d'agent. Pour de plus amples informations, veuillez consulter Création d'un espace d'agents.
Chaque agent a exactement un ensemble d'instructions. Lorsque vous enregistrez un nouveau contenu, il remplace le contenu existant pour cet agent.
Pour définir des instructions globales (s'appliquent à tous les agents) :
Accédez à la page de connaissances de votre application Web Agent Space Operator.
Choisissez l'onglet Instructions.
Choisissez Afficher à côté de Tous les agents.
Entrez vos instructions de démarquage dans l'éditeur.
Choisissez Enregistrer.
Pour définir des instructions pour un agent spécifique, procédez comme suit :
Accédez à la page de connaissances de votre application Web Agent Space Operator.
Choisissez l'onglet Instructions.
Choisissez Afficher à côté de l'agent que vous souhaitez configurer : chat, triage des incidents, RCA des incidents, atténuation des incidents, interface utilisateur des incidents , évaluation ou tests de version.
Entrez vos instructions de démarquage dans l'éditeur.
Choisissez Enregistrer.
Gestion des instructions pour les agents
AWS DevOps L'agent fournit des fonctionnalités de gestion pour les instructions des agents via l'application Web de l'opérateur.
Affichage des instructions : Accédez à la page de connaissances, choisissez l'onglet Instructions, puis choisissez Afficher à côté de Tous les agents ou de l'agent géré spécifique. L'éditeur affiche le contenu actuel. Utilisez l'onglet Aperçu pour voir le markdown rendu ou l'onglet Code pour voir le markdown brut.
Instructions de modification : ouvrez l'agent comme décrit ci-dessus, modifiez le contenu dans l'éditeur et choisissez Enregistrer.
Chargement des instructions depuis un fichier : ouvrez l'agent, puis cliquez sur le bouton Charger dans l'éditeur pour charger un fichier Markdown depuis votre ordinateur.
Instructions de téléchargement : Ouvrez l'agent, puis cliquez sur le bouton Télécharger dans l'éditeur pour télécharger le contenu actuel sous forme de fichier.
Instructions de suppression : ouvrez l'agent, cliquez sur le bouton Supprimer dans l'éditeur et confirmez la suppression. Cette action ne peut pas être annulée. Envisagez de télécharger le contenu d'abord si vous en avez besoin à nouveau.
