Todos os templates Pela equipe NappAI Classificador de tipos de incidência do Jira
Agente do Jira que classifica o tipo de problema correspondente para cada problema em um projeto determinado.
graph TD
%%{init: {'theme': 'mc','layout': 'elk'}}%%
ParseData-aice2[<div><img alt="logo" src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>Parse Data]
style ParseData-aice2 stroke:#a170ff
Prompt-8pfns[<div><img alt="logo" src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Prompt]
style Prompt-8pfns stroke:#a170ff
ChatOutput-zqoh9[<div><img alt="logo" src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output]
style ChatOutput-zqoh9 stroke:#a170ff
OpenAIModel-zu1vo[<div><img alt="logo" src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI]
style OpenAIModel-zu1vo stroke:#a170ff
JiraReader-i2erv[List Issue Types]
style JiraReader-i2erv stroke:#a170ff
JiraIssueHandler-8ctxx[Update Subtask]
style JiraIssueHandler-8ctxx stroke:#a170ff
JiraIssueHandler-phklc[Update Issue]
style JiraIssueHandler-phklc stroke:#a170ff
JiraReader-3f3ut[Jira Reader]
style JiraReader-3f3ut stroke:#a170ff
AdvancedAgent-4g9ht[Agent2]
style AdvancedAgent-4g9ht stroke:#a170ff
ParseData-aice2 -.- Prompt-8pfns
linkStyle 0 stroke:#a170ff
JiraReader-3f3ut -.- ParseData-aice2
linkStyle 1 stroke:#a170ff
Prompt-8pfns -.- AdvancedAgent-4g9ht
linkStyle 2 stroke:#a170ff
AdvancedAgent-4g9ht -.- ChatOutput-zqoh9
linkStyle 3 stroke:#a170ff
OpenAIModel-zu1vo -.- AdvancedAgent-4g9ht
linkStyle 4 stroke:#a170ff
JiraIssueHandler-phklc -.- AdvancedAgent-4g9ht
linkStyle 5 stroke:#a170ff
JiraIssueHandler-8ctxx -.- AdvancedAgent-4g9ht
linkStyle 6 stroke:#a170ff
JiraReader-i2erv -.- AdvancedAgent-4g9ht
linkStyle 7 stroke:#a170ff
🧩 Descrição Geral
O fluxo automatiza a classificação de tipos de incidências em um projeto Jira. Ele extrai os issues, prepara a informação em texto, gera um prompt que instruirá um modelo de linguagem a determinar o tipo de issue mais adequado e, por fim, atualiza os issues no Jira usando os comandos apropriados. O resultado é apresentado em formato de chat para facilitar a interação com o usuário.
⚙️ Funcionalidades Principais
- Leitura de Issues: Recupera todos os issues de um projeto Jira.
- Conversão de Dados: Transforma a resposta de dados em texto estruturado.
- Geração de Prompt: Monta uma instrução detalhada para o modelo de IA.
- Decisão Automatizada: O agente avalia o prompt e escolhe o tipo de issue correto.
- Execução de Ações Jira: Atualiza ou cria issues e subtasks com o tipo determinado.
- Apresentação de Resultados: Exibe a resposta final em um chat interativo.
🔄 Passos do Fluxo de Trabalho
| Nome do Componente | Papel no Fluxo | Entradas Principais | Saídas Principais |
|---|---|---|---|
| Jira Reader | Leitura inicial dos issues | Projeto selecionado (project_key) | Dados brutos de issues (jira_response) |
| Parse Data | Formatação dos dados em texto | Dados brutos de issues (jira_response) | Texto formatado (text) |
| Prompt | Criação do texto de instrução para o modelo | Texto formatado (text) | Prompt pronto para o agente (prompt) |
| Advanced Agent | Agente de decisão e execução | Prompt (arg_input), Model (llm), Ferramentas | Mensagem final (response) |
| OpenAI Model | Geração de texto com IA | Prompt (arg_input) | Modelo de linguagem (model_output) |
| Jira Issue Handler (Update Issue) | Atualiza issue existente | Dados de issue (issue_key, etc.) | Resposta de Jira (jira_response) |
| Jira Issue Handler (Update Subtask) | Atualiza subtask existente | Dados de subtask (issue_key, issue_parent_key, etc.) | Resposta de Jira (jira_response) |
| Jira Reader (como ferramenta) | Recupera dados adicionais se necessário | N/A | Ferramenta para o agente (component_as_tool) |
| Chat Output | Exibição da resposta final | Mensagem final (response) | Mensagem exibida no chat |
Observação: As entradas e saídas são descritas em termos de dados relevantes, evitando a notação de variáveis técnicas.
🧠 Notas
- O agente utiliza um modelo de linguagem (OpenAI Model) configurado com parâmetros de temperatura, max_tokens e stream opcionais.
- As ferramentas Jira (leitura e manipulação de issues) são expostas ao agente como ferramentas de ação, permitindo chamadas de API externas.
- O fluxo suporta modo de lote e memória opcional, embora não estejam explicitamente ativados no fluxo atual.
- Se o prompt resultar em erro de formatação JSON, o agente retornará uma mensagem de falha; o fluxo não inclui tratamento de exceções.
- Os componentes LabelComponent não fazem parte da execução atual, portanto, não afetam o fluxo.