Criação de um agente personalizado

Você pode criar um agente personalizado de duas maneiras: usando o formulário no aplicativo web do DevOps Agente ou por meio de uma conversa guiada no Chat. Ambos os métodos resultam na mesma configuração personalizada do agente armazenada no seu Espaço do Agente.

Antes de criar um agente personalizado, você deve ter um Espaço do Agente 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, solicitação do sistema e habilidades opcionais. Para atribuir ferramentas MCP ao agente, use o Chat depois de criar o agente.

Para criar um agente personalizado usando o formulário:

1. Navegue até a página Agentes em seu aplicativo web DevOps Agent.

2. Na seção Agentes personalizados, escolha Criar agente.

3. Na caixa de diálogo, escolha Formulário.

4. 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-report

   • Solicitação 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 redigir 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 de domínio ao agente. Use o campo de pesquisa para encontrar habilidades por nome.

5. Escolha Criar agente.

Após a criação, você será redirecionado para a página de detalhes do agente, onde 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 de conversação guiada para a criação de agentes personalizados. Esse método é recomendado quando você deseja atribuir ferramentas MCP ao agente ou quando deseja ajuda para escrever o prompt do sistema.

Para criar um agente personalizado usando o Chat:

1. Navegue até a página Agentes em seu aplicativo web DevOps Agent.

2. Na seção Agentes personalizados, escolha Criar agente.

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

4. 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 que nenhum agente similar já existe no 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.

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:

• Objetivo — 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 qual 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 exemplolist_investigations,use_aws,,query_cloudwatch_logs) para que o agente saiba quais ferramentas chamar.

• Defina critérios de sucesso — Descreva a aparência de uma boa saída para que o agente saiba quando ela foi concluída.

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

Configurando ferramentas

As ferramentas MCP determinam quais ações seu agente personalizado pode realizar durante a invocação. Você seleciona ferramentas do conjunto completo disponível em seu Espaço do Agente, 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.

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