1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados e demais requisitos funcionais para o Fluxo de Agentes "Gestão de Incidentes em Integrações de API", uma solução de automação projetada para identificar, classificar, priorizar e propor soluções para incidentes relacionados a integrações de API. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.
O objetivo principal é minimizar o impacto dos incidentes no serviço, proporcionando soluções rápidas e eficazes.
2. Contexto e Problema
Cenário Atual
Atualmente, as integrações de API enfrentam problemas frequentes que não são geridos de forma eficiente, resultando em interrupções prolongadas no serviço. Estes problemas incluem:
- Incidentes frequentes nas integrações de API que não são geridos eficientemente.
- Falta de priorização adequada de incidentes para resolução rápida.
- Impacto prolongado no serviço devido à demora na resolução de incidentes.
A gestão manual desses incidentes é demorada e sujeita a erros, o que afeta negativamente a experiência do usuário e a eficiência operacional.
Problemas Identificados
- Consumo excessivo de tempo: A identificação e resolução manual de incidentes consome muito tempo dos técnicos.
- Falta de priorização: Incidentes críticos não são tratados com a urgência necessária, resultando em impactos maiores.
- Falta de soluções automatizadas: Muitas vezes, incidentes comuns e conhecidos não têm soluções automáticas, levando a repetidas intervenções manuais.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Reduzir o tempo de resposta a incidentes em pelo menos 70%.
- Melhorar a priorização de incidentes críticos, assegurando que sejam tratados imediatamente.
- Aumentar a eficiência operacional através de soluções automatizadas para incidentes comuns.
- Fornecer relatórios detalhados para análise e melhoria contínua dos processos.
4. Visão Geral da Solução
O agente de IA para gestão de incidentes em integrações de API identifica, classifica e prioriza incidentes automaticamente, propondo soluções rápidas para minimizar impactos no serviço. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente útil e autônomo na gestão de incidentes de API.
A solução consiste em um fluxo de automação composto por 4 agentes de IA. O processo inicia com a identificação e classificação dos incidentes e termina com a geração de relatórios para análise.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Identificação e Classificação de Incidentes (RF 1)
| Identificar e classificar automaticamente os incidentes relacionados a integrações de API conforme sua severidade. |
Agente de Priorização de Incidentes (RF 2)
| Priorizar incidentes críticos para resolução imediata. |
Agente de Proposição de Soluções (RF 3)
| Propor soluções automatizadas para incidentes comuns e conhecidos. |
Agente de Relatórios de Incidentes (RF 4)
| Fornecer relatórios de incidentes para análise e melhoria contínua dos processos. |
5. Protótipos
Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o cliente receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Identificação e Classificação de Incidentes
1.1 Tarefa do Agente
Identificar e classificar automaticamente os incidentes relacionados a integrações de API conforme sua severidade.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo logs e notificações de erros de integrações de API. Este texto é o registro bruto dos incidentes ocorridos, que precisam ser identificados e classificados.
# 2. Objetivo
Identificar e classificar automaticamente os incidentes conforme sua severidade, utilizando algoritmos de análise de logs.
# 3. Regras que você deve seguir para gerar sua resposta
- Identifique automaticamente incidentes a partir de logs de erro.
- Classifique a severidade do incidente com base em critérios predefinidos, como impacto no serviço e frequência do erro.
- Atualize a classificação de severidade se novas informações sobre o impacto do incidente forem recebidas.
# 4. Exemplo de Output que você deve produzir
{"incidente_id": "12345", "severidade": "alta", "descricao": "Erro de autenticação na API X"} 1.3 Configurações do Agente
1.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio de logs e notificações de erros de integrações de API via API. Na fase de testes, os dados serão enviados manualmente por upload de arquivos de log na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um arquivo de log, que contém notificações de erros e incidentes de API.
-
Formatos Suportados: Esse agente deve ser capaz de receber logs nos formatos:
.log,.txt,.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um objeto JSON contendo o ID do incidente, a severidade e uma descrição breve do erro identificado.
-
Exemplo de Estrutura de Output:
{"incidente_id": "12345", "severidade": "alta", "descricao": "Erro de autenticação na API X"} - Número de caracteres esperado: O JSON gerado deve ser conciso, com um tamanho estimado em torno de 500 caracteres por incidente.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
1.3.4 Ferramentas do Agente
- Documentos: Não consulta documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não se conecta a sistemas externos.
1.3.5 Memória
- Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Priorização de Incidentes (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Priorização de Incidentes (RF 2).
RF 2. Agente de Priorização de Incidentes
2.1 Tarefa do Agente
Priorizar incidentes críticos para resolução imediata.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo objetos JSON contendo incidentes classificados com suas severidades.
# 2. Objetivo
Atribuir prioridade alta a incidentes classificados como críticos, considerando a potencial interrupção do serviço.
# 3. Regras que você deve seguir para gerar sua resposta
- Atribua prioridade alta a incidentes classificados como críticos.
- Revise a prioridade se o impacto do incidente mudar ou se forem recebidas novas informações.
# 4. Exemplo de Output que você deve produzir
{"incidente_id": "12345", "prioridade": "alta"} 2.3 Configurações do Agente
2.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 1).
- Tipo do input: Este agente deve ser apto a receber como input objetos JSON contendo incidentes classificados e suas severidades.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um objeto JSON contendo o ID do incidente e a prioridade atribuída.
-
Exemplo de Estrutura de Output:
{"incidente_id": "12345", "prioridade": "alta"} - Número de caracteres esperado: O JSON gerado deve ser conciso, com um tamanho estimado em torno de 200 caracteres por incidente.
2.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
2.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
2.3.5 Memória
- Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Proposição de Soluções (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Proposição de Soluções (RF 3).
RF 3. Agente de Proposição de Soluções
3.1 Tarefa do Agente
Propor soluções automatizadas para incidentes comuns e conhecidos.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo objetos JSON contendo incidentes priorizados com suas descrições.
# 2. Objetivo
Propor soluções automáticas para incidentes que correspondem a padrões conhecidos, utilizando uma base de dados de soluções pré-aprovadas.
# 3. Regras que você deve seguir para gerar sua resposta
- Proponha soluções automáticas para incidentes que correspondem a padrões conhecidos.
- Se não houver solução automática disponível, escale para análise manual.
# 4. Exemplo de Output que você deve produzir
{"incidente_id": "12345", "solucao_sugerida": "Verificar credenciais de autenticação e tentar novamente."} 3.3 Configurações do Agente
3.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 2).
- Tipo do input: Este agente deve ser apto a receber como input objetos JSON contendo incidentes priorizados e suas descrições.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um objeto JSON contendo o ID do incidente e a solução sugerida.
-
Exemplo de Estrutura de Output:
{"incidente_id": "12345", "solucao_sugerida": "Verificar credenciais de autenticação e tentar novamente."} - Número de caracteres esperado: O JSON gerado deve ser conciso, com um tamanho estimado em torno de 300 caracteres por incidente.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
3.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
3.3.5 Memória
- Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Relatórios de Incidentes (RF 4).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Relatórios de Incidentes (RF 4).
RF 4. Agente de Relatórios de Incidentes
4.1 Tarefa do Agente
Fornecer relatórios de incidentes para análise e melhoria contínua dos processos.
4.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados de incidentes classificados, priorizados e solucionados. # 2. Objetivo Compilar dados de incidentes em um relatório claro e conciso, destacando padrões recorrentes e sugerindo melhorias. # 3. Regras que você deve seguir para gerar sua resposta - Compile dados de incidentes em um relatório claro e conciso. - Utilize gráficos e tabelas para melhor visualização dos dados. - Destaque padrões recorrentes e sugira melhorias nos processos de integração de API. # 4. Exemplo de Output que você deve produzir Relatório em formato markdown com análise de incidentes e sugestões de melhorias.
4.3 Configurações do Agente
4.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 3).
- Tipo do input: Este agente deve ser apto a receber dados de incidentes classificados, priorizados e solucionados.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 15.000 caracteres.
4.3.2 Especificação do Output
- Formato de output: O output deve ser um relatório em formato markdown que inclui análise de incidentes e sugestões de melhorias.
-
Exemplo de Estrutura de Output:
Relatório em formato markdown com análise de incidentes e sugestões de melhorias.
- Número de caracteres esperado: O relatório gerado deve ser detalhado, com um tamanho estimado em torno de 5.000 caracteres.
4.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
4.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
4.3.5 Memória
- Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
- Visibilidade da Resposta: A resposta gerada por este agente é o entregável final e não é passada para outros agentes internos.
4.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. O relatório gerado é o resultado que deve ser disponibilizado ao usuário.