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 Agents de votre application Web Agent Space Operator, vous pouvez définir des instructions globales qui s'appliquent à tous les agents ou définir des instructions pour un agent géré spécifique, comme le chat ou le triage des incidents. Ces instructions sont enregistrées sous forme de AGENTS.md fichier. Contrairement à DevOps Compétences des agents la charge à la demande lorsque l'agent fait correspondre 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.

Quelles sont les instructions pour les agents

Les instructions de l'agent fournissent des conseils inconditionnels et permanents à vos agents. Au début de chaque session, le service de l'agent récupère les instructions configurées pour votre espace agent et injecte leur contenu directement dans l'invite du système de l'agent. L'agent ne décide pas s'il faut 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	Bundle Markdown ou ZIP	Markdown uniquement
Fichiers de ressources	Pris en charge	Non pris en charge
Injection de contexte	À la demande (l'agent décide en faisant correspondre les descriptions des 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 aucun champ de nom ou de description. Le AGENTS.md fichier sous-jacent contient uniquement du markdown, sans frontmatter, sans support pour les bundles ZIP et sans fichiers 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 contextualisés, 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 de l'agent 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 pour les agents

Lorsqu'une session démarre, le service de l'agent récupère les instructions configurées pour votre espace agent et injecte leur contenu dans l'invite du système de l'agent avant le début de la session. Cela se produit automatiquement à 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 à utiliser le contenu chargé lors de leur démarrage.

Le scoping 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 en 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 cadrage :

• Instructions générales : s'applique à tous les types d'agents de votre espace agent. Chaque session d'agent reçoit ce contenu.

• 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 cadrage initial.

• 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.

• Évaluation - Notation des performances des agents et contrôles de conformité aux politiques.

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 fichier 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 plus de capacité à résoudre votre problème.

• Limite rigide : 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 séance. Pour les procédures d'investigation spécialisées qui s'appliquent uniquement à des tâches spécifiques, envisagez DevOps Compétences des agents plutôt d'utiliser.

Exemple

L'exemple suivant montre des instructions d'agent bien conçues 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.

Instructions de configuration de l'agent

Avant de définir les instructions de l'agent, vous devez disposer d'un espace agent. Pour de plus amples informations, veuillez consulter Création d'un espace d'agents.

Chaque agent dispose d'un seul ensemble d'instructions. Lorsque vous enregistrez un nouveau contenu, il remplace le contenu existant pour cet agent.

Pour définir des instructions globales (applicables à tous les agents) :

1. Accédez à la page Agents dans votre application Web Agent Space Operator.

2. Choisissez Afficher à côté des instructions générales.

3. Entrez vos instructions de marquage dans l'éditeur.

4. Choisissez Enregistrer.

Pour définir des instructions pour un agent spécifique, procédez comme suit :

1. Accédez à la page Agents dans votre application Web Agent Space Operator.

2. Sous Agents gérés, choisissez Afficher à côté de l'agent que vous souhaitez configurer : Chat, Triage des incidents, Incident RCA, Atténuation des incidents ou Evaluation.

3. Entrez vos instructions de marquage dans l'éditeur.

4. Choisissez Enregistrer.

Instructions de gestion des agents

AWS DevOps L'agent fournit des fonctionnalités de gestion pour les instructions des agents via l'application Web Operator.

Instructions d'affichage : Accédez à la page Agents et choisissez Afficher à côté des instructions globales 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, puis choisissez Enregistrer.

Instructions de téléchargement depuis un fichier : ouvrez l'agent, puis cliquez sur le bouton Télécharger dans l'éditeur pour télé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 d'abord de télécharger le contenu si vous en avez besoin à nouveau.