As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Instruções do agente Use as instruções do agente para fornecer orientações sempre ativas que o AWS DevOps Agente aplica a todas as sessões. Uma sessão é uma única conversa ou investigação com um agente. Na página **Agentes** do seu Agent Space Operator Web App, você pode definir **instruções globais** que se aplicam a todos os agentes ou definir instruções para um agente gerenciado específico, como Chat ou triagem de incidentes. Essas instruções são armazenadas como um AGENTS.md arquivo. [DevOps Habilidades do agente](about-aws-devops-agent-devops-agent-skills.md)Diferentemente das que são carregadas sob demanda quando o agente combina uma descrição de habilidade com a tarefa atual, as instruções do agente estão sempre presentes desde o início de cada sessão, independentemente do que o agente esteja trabalhando. ## Quais são as instruções do agente As instruções do agente fornecem orientação incondicional e sempre ativa para seus agentes. No início de cada sessão, o serviço do agente recupera as instruções configuradas para o seu Espaço do Agente e injeta o conteúdo diretamente no prompt do sistema do agente. O agente não decide se quer carregá-los; eles estão sempre presentes. Cada sessão do agente recebe instruções das instruções globais e das instruções relevantes específicas do agente, por exemplo, o Chat. As instruções do agente são armazenadas como AGENTS.md arquivos e [DevOps Habilidades do agente](about-aws-devops-agent-devops-agent-skills.md) diferem de várias maneiras importantes: | Aspecto | Habilidade | Instruções do agente (AGENTS.md) | | --- | --- | --- | | Nome e descrição | Obrigatório | Não aplicável | | Formato de conteúdo | Pacote Markdown ou ZIP | Somente Markdown | | Arquivos de recursos | Compatível | Não compatível | | Injeção de contexto | Sob demanda (o agente decide por meio da correspondência da descrição da habilidade) | Sempre (incondicional, em todas as sessões) | | Exclusividade | Vários por espaço de agente | Um por agente (um para instruções globais, um por agente gerenciado) | As instruções do agente não têm nome nem campo de descrição. O AGENTS.md arquivo subjacente contém apenas markdown sem frontmatter, sem suporte a pacotes ZIP e sem arquivos de recursos. ## Por que usar as instruções do agente As instruções do agente oferecem uma maneira confiável de garantir que determinadas orientações estejam sempre contextualizadas, sem depender das decisões de carga de habilidades do agente. **Principais benefícios:** + **Previsibilidade:** as instruções estão sempre presentes, independentemente da tarefa em que o agente está trabalhando. Nenhuma correspondência de descrição é necessária e o agente não pode ignorar o conteúdo. + **Cobertura garantida:** ao contrário do Skills, que o agente pode ou não carregar dependendo da relevância da tarefa, as instruções do agente são sempre injetadas no início de cada sessão. + **Políticas permanentes:** use as instruções do agente para políticas operacionais permanentes, diretrizes de segurança, padrões de codificação ou qualquer orientação que deva ser aplicada a todas as sessões, sem exceção. + **Escopo direcionado:** você pode aplicar instruções a todos os tipos de agentes ao mesmo tempo usando instruções globais ou restringir as instruções a um tipo específico de agente quando a orientação for relevante somente para o trabalho desse agente. ## Como as instruções do agente funcionam Quando uma sessão é iniciada, o serviço do agente recupera as instruções configuradas para o seu Espaço do Agente e injeta seu conteúdo no prompt do sistema do agente antes do início da sessão. Isso acontece automaticamente em cada sessão. O agente não avalia se deve carregá-los; ele sempre injeta o conteúdo. Cada nova sessão carrega as instruções atualizadas na inicialização. Se você atualizar suas instruções, a alteração entrará em vigor imediatamente para as sessões iniciadas após o salvamento. As sessões que já estão em andamento continuam usando o conteúdo que foi carregado quando foram iniciadas. O escopo determina quais instruções uma sessão recebe. As instruções globais se aplicam a todos os tipos de agentes em seu Espaço do Agente, portanto, todas as sessões as recebem. Agent-specific as instruções se aplicam somente às sessões desse tipo específico de agente. Uma sessão recebe instruções das instruções globais e das instruções relevantes específicas do agente. ## Escopo do tipo de agente O escopo controla quais sessões do agente recebem um determinado conjunto de instruções. Há duas opções de escopo: + **Instruções globais:** se aplicam a todos os tipos de agentes em seu Espaço do Agente. Cada sessão do agente recebe esse conteúdo. + **Agent-specific:** aplica-se somente às sessões do tipo de agente selecionado. Os agentes gerenciados disponíveis para instruções específicas do agente são: + **Chat** - Ad-hoc perguntas e solicitações durante as sessões de bate-papo. + **Triagem de incidentes** — filtragem de alarmes, classificação de gravidade e escopo inicial. + **Incidente RCA** - Análise da causa raiz com coleta e validação de evidências. + **Mitigação de incidentes — recomendações de** Short-term remediação e correção de longo prazo. + **Avaliação** - Pontuação de desempenho do agente e verificações de conformidade com as políticas. ## Orientação sobre o tamanho do conteúdo Toda vez que você inicia uma conversa ou investigação, o agente lê todas as instruções antes de fazer qualquer outra coisa. O agente tem uma quantidade fixa de memória de trabalho por sessão, e suas instruções usam parte dela. Quanto maior o arquivo, menos espaço resta para suas perguntas, investigações, os registros que o agente lê e seu próprio raciocínio. Instruções mais curtas e focadas dão ao agente mais capacidade de resolver seu problema. + **Limite rígido:** 25 KB + **Tamanho recomendado:** 120 linhas (recomendado para a maioria das configurações) Concentre suas instruções nas orientações que devem estar presentes em todas as sessões. Para procedimentos de investigação especializados que se aplicam somente a tarefas específicas, considere usar [DevOps Habilidades do agente](about-aws-devops-agent-devops-agent-skills.md) em vez disso. ## Exemplo O exemplo a seguir mostra instruções bem elaboradas do agente com orientações de investigação, padrões de formatação de respostas e requisitos de segurança que se aplicam a todas as sessões do agente. ``` # 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. ``` ## Definindo as instruções do agente Antes de definir as instruções do agente, você deve ter um Espaço do Agente. Para obter mais informações, consulte [Criação de um espaço de agente](getting-started-with-aws-devops-agent-creating-an-agent-space.md). Cada agente tem exatamente um conjunto de instruções. Quando você salva um novo conteúdo, ele sobrescreve o conteúdo existente para esse agente. **Para definir instruções globais (aplica-se a todos os agentes):** 1. Navegue até a página **Agentes** em seu aplicativo Web Agent Space Operator. 1. Escolha **Exibir** ao lado de **Instruções globais**. 1. Insira suas instruções de marcação no editor. 1. Escolha **Salvar**. **Para definir instruções para um agente específico:** 1. Navegue até a página **Agentes** em seu aplicativo Web Agent Space Operator. 1. **Em **Agentes gerenciados**, escolha **Exibir** ao lado do agente que você deseja configurar: **Chat**, **Triagem de incidentes**, **RCA de incidentes**, **Mitigação de incidentes** ou Avaliação.** 1. Insira suas instruções de marcação no editor. 1. Escolha **Salvar**. ## Gerenciando as instruções do agente AWS DevOps O agente fornece recursos de gerenciamento para as instruções do agente por meio do Operator Web App. **Instruções de visualização:** navegue até a página **Agentes** e escolha **Exibir** ao lado de **Instruções globais** ou do agente gerenciado específico. O editor mostra o conteúdo atual. Use a guia **Visualizar** para ver a redução renderizada ou a guia **Código** para ver a redução bruta. **Instruções de edição:** abra o agente conforme descrito acima, modifique o conteúdo no editor e escolha **Salvar**. **Carregar instruções de um arquivo:** abra o agente e escolha o botão **Carregar** no editor para carregar um arquivo markdown do seu computador. **Instruções de download:** abra o agente e escolha o botão **Download** no editor para baixar o conteúdo atual como um arquivo. **Instruções de exclusão:** abra o agente, escolha o botão **Excluir** no editor e confirme a exclusão. Esta ação não pode ser desfeita. Considere baixar o conteúdo primeiro se precisar dele novamente.