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á.
Criação de um agente personalizado
Você pode criar um agente personalizado de duas maneiras: usando o formulário no aplicativo web DevOps Agent ou por meio de uma conversa guiada no Chat. Ambos os métodos resultam na mesma configuração de agente personalizada armazenada no seu Espaço do Agente.
Antes de criar um agente personalizado, você deve ter um Agent Space com pelo menos uma integração conectada. Para obter mais informações, consulte Criação de um espaço de agente.
Criação de um agente personalizado usando o formulário
O formulário permite criar rapidamente um agente personalizado especificando um nome, uma solicitação do sistema e habilidades opcionais. Para atribuir ferramentas de MCP ao agente, use o Chat depois de criar o agente.
Para criar um agente personalizado usando o formulário:
Navegue até a página Agentes em seu aplicativo web DevOps Agent.
Na seção Agentes personalizados, escolha Criar agente.
Na caixa de diálogo, escolha Formulário.
Preencha o formulário:
Nome — Um identificador exclusivo para seu agente. Use somente letras minúsculas, números e hífens (máximo de 64 caracteres). Não deve começar nem terminar com um hífen. Exemplo:
weekly-health-reportPrompt do sistema — Instruções que definem o que o agente faz e como ele opera, escritas em Markdown (mínimo de 10 caracteres, máximo de 50.000 caracteres). Para obter orientação sobre como escrever solicitações eficazes, consulte Escrevendo uma solicitação do sistema.
Habilidades (opcional) — Selecione habilidades do seu Espaço do Agente que forneçam conhecimentos ou capacidades adicionais do domínio ao agente. Use o campo de pesquisa para encontrar habilidades pelo nome.
Escolha Criar agente.
Após a criação, você será redirecionado para a página de detalhes do agente, na qual poderá visualizar a configuração, executar o agente ou configurar gatilhos.
Criação de um agente personalizado usando o Chat
O Chat oferece uma experiência guiada e conversacional para criar agentes personalizados. Esse método é recomendado quando você deseja atribuir ferramentas MCP ao agente ou quando deseja assistência para escrever o prompt do sistema.
Para criar um agente personalizado usando o Chat:
Navegue até a página Agentes em seu aplicativo web DevOps Agent.
Na seção Agentes personalizados, escolha Criar agente.
Na caixa de diálogo, escolha Chat. A caixa de diálogo é fechada e uma nova conversa é aberta no painel Chat com uma mensagem pré-composta.
O chat orienta você em um processo colaborativo:
Esclarecimento da intenção — confirma o propósito e o escopo do seu agente.
Verificação duplicada — Verifica se nenhum agente similar já existe em seu Espaço do Agente.
Seleção de ferramentas e habilidades — propõe quais ferramentas e habilidades de MCP o agente precisa e solicita que você confirme.
Tipo de saída — Determina se o agente deve produzir respostas de texto, artefatos ou recomendações.
Rascunho do prompt do sistema — Escreve um prompt do sistema e o apresenta para sua análise. Você pode iterar até ficar satisfeito.
Confirmação — sugere um nome e confirma todas as configurações antes de criar o agente.
Você também pode criar um agente personalizado perguntando diretamente ao Chat a qualquer momento. Por exemplo:
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.
Importando um agente personalizado de um repositório
Você pode importar o prompt do sistema de um agente personalizado diretamente de um arquivo Markdown em um GitHub repositório. O conteúdo do arquivo se torna o prompt do sistema do agente. Você pode gerenciar solicitações de agentes no controle de versão e importá-las com uma única ação.
Pré-requisitos:
Uma GitHub conta associada ao seu Agent Space. Para conectar uma GitHub conta, consulteConectando GitHub. Qualquer conexão de GitHub conta permite a importação de repositórios públicos. Para repositórios privados, a conta associada deve ter acesso de leitura ao repositório. GitHub O Enterprise Server e o GitHub Enterprise Cloud com conexões de residência de dados também são suportados.
Um arquivo Markdown (
.md) em um GitHub repositório contendo o prompt do sistema.
Para importar um agente personalizado de um repositório:
Navegue até a página Agentes em seu aplicativo web DevOps Agent.
Na seção Agentes personalizados, escolha Criar agente.
Na caixa de diálogo, escolha Importar. A caixa de diálogo muda para Importar da GitHub visualização.
Preencha o formulário:
Nome — Um identificador exclusivo para seu agente. Use somente letras minúsculas, números e hífens (máximo de 64 caracteres). Não deve começar nem terminar com um hífen.
URL do repositório — Um link para um único arquivo Markdown (
.md) contendo o prompt do sistema do agente. Por exemplo:https://github.com/my-org/my-repo/blob/main/my-agent.md. Para GitHub Enterprise Server ou GitHub Enterprise Cloud com residência de dados, use o URL da sua instância. Por exemplo:https://github.example.com/my-org/my-repo/blob/main/my-agent.md. Se o URL não terminar em.md, um aviso será exibido. A importação falhará se o arquivo não for Markdown.Habilidades (opcional) — Selecione habilidades do seu Espaço do Agente para fornecer conhecimentos ou capacidades adicionais do domínio ao agente.
Escolha Agente de importação.
O arquivo do repositório fornece somente o prompt do sistema. O nome e as habilidades vêm do formulário.
Após a criação, você será redirecionado para a página de detalhes do agente, na qual poderá visualizar a configuração, executar o agente ou configurar gatilhos.
Visualizando agentes importados:
Um agente importado exibe um GitHub selo Synced from ao lado de seu nome na página de detalhes do agente, junto com um carimbo de data/hora da última sincronização e um link para o arquivo de origem ativado. GitHub Na lista de agentes personalizados, os agentes importados incluem um link para o arquivo de origem.
Se você editar um agente importado, o prompt do sistema exibirá um Read-only rótulo com uma dica vinculada ao arquivo de origem. O nome e as habilidades permanecem editáveis.
Sincronizando agentes importados:
Ao atualizar o arquivo Markdown em seu repositório, abra a página de detalhes do agente importado e escolha Sincronizar para obter o prompt mais recente do sistema.
Restrições:
Formato de URL — Somente GitHub URLs são aceitos, incluindo GitHub Enterprise Server e GitHub Enterprise Cloud com residência de dados. A GitHub conta conectada deve corresponder ao host do URL. Por exemplo, uma
github.example.comconexão só pode importar degithub.example.comURLs, não degithub.comURLs.Arquivo Markdown obrigatório — O URL deve apontar para um único
.mdarquivo.Tamanho máximo do arquivo — O arquivo não deve exceder 1 MB (limite GitHub da API).
GitHub conta necessária — Seu Espaço do Agente deve ter uma GitHub conta associada para importar agentes. Para repositórios privados, a conta deve ter acesso de leitura.
Agentes personalizados comunitários
O repositório AWS DevOps Agent Tools
Para usar um agente personalizado da comunidade, importe-o do repositório usando o fluxo Importar do repositório na página Agentes. Copie a URL do arquivo Markdown do agente e cole-a como URL do repositório. Para obter detalhes, consulte Importar um agente personalizado de um repositório.
Escrevendo um prompt do sistema
O prompt do sistema é a parte mais importante do seu agente personalizado. Ele define o propósito, a abordagem, as restrições e a saída esperada do agente. Um aviso bem escrito produz resultados consistentes e confiáveis.
Estruture o prompt do sistema com estas seções:
Meta — O que o agente deve realizar em uma única frase ou parágrafo curto.
Abordagem — Step-by-step procedimentos que o agente deve seguir, referenciando nomes específicos de ferramentas que ele deve chamar e em que ordem.
Restrições — Limites sobre o que o agente deve ou não fazer. Por exemplo, acesso somente para leitura, intervalos de tempo a serem considerados ou serviços a serem excluídos.
Saída — O que o agente deve produzir e em que formato. Especifique se ele deve gerar texto, criar um artefato ou criar uma recomendação.
Exemplo de prompt do sistema:
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.
Dicas para obter instruções eficazes do sistema:
Seja específico sobre as ferramentas — consulte os nomes das ferramentas diretamente (por exemplo
list_investigations,use_aws,,query_cloudwatch_logs) para que o agente saiba quais ferramentas chamar.Defina critérios de sucesso — Descreva como é uma boa saída para que o agente saiba quando ela está pronta.
Estabeleça limites — Indique explicitamente o que o agente não deve fazer para evitar ações não intencionais.
Use a formatação Markdown — cabeçalhos, listas e blocos de código facilitam a análise e o acompanhamento da solicitação pelo agente.
Ferramentas de configuração
As ferramentas MCP determinam quais ações seu agente personalizado pode realizar durante a invocação. Você seleciona ferramentas do conjunto completo disponível no seu Agent Space, incluindo ferramentas de AWS contas conectadas, plataformas de observabilidade, CI/CD pipelines, sistemas de emissão de tíquetes e servidores MCP personalizados.
As ferramentas só podem ser configuradas por meio do Chat. Para atribuir ferramentas ao criar um agente, use o método de criação do Chat. Para adicionar ou alterar ferramentas em um agente existente, peça ao Chat que atualize o agente. Por exemplo:
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.
Ao selecionar ferramentas, siga o princípio do menor privilégio: atribua somente as ferramentas de que o agente precisa para realizar sua tarefa. Isso reduz o risco de ações não intencionais e mantém o agente focado.
Ferramentas do Release Manager
Os agentes personalizados têm acesso às ferramentas do Release Manager. Essas ferramentas permitem que seu agente crie, liste, receba e cancele tarefas do Release Manager. Seu agente também pode analisar um relatório de revisão de prontidão para o lançamento para revelar as descobertas e as ações recomendadas.
Para usar as ferramentas do Release Manager, atribua-as ao seu agente personalizado por meio do Chat. Por exemplo:
Add the release manager tools to my release-pipeline-agent.
Para obter mais informações sobre os recursos de gerenciamento de versões, consulteGerenciamento de lançamentos.
Configurando habilidades
As habilidades fornecem ao seu agente personalizado conhecimento adicional de domínio, procedimentos de investigação ou recursos especializados. Quando um agente personalizado é executado, ele carrega suas habilidades atribuídas e pode consultar suas instruções durante a invocação.
Você pode atribuir habilidades durante a criação (usando o formulário ou o Chat) ou adicioná-las posteriormente editando o agente. As habilidades atribuídas a um agente personalizado já devem existir no seu Espaço do Agente. Para obter mais informações sobre a criação de habilidades, consulteDevOps Habilidades do agente.
Os agentes personalizados também têm recursos integrados para criar artefatos e recomendações que não exigem atribuição de habilidades. Para obter mais informações, consulte Saídas personalizadas do agente.
Você pode atribuir até 200 habilidades por agente personalizado. Escolha habilidades que sejam relevantes para o propósito do agente de reduzir o consumo de contexto e melhorar o foco do agente.
