Pular para o conteúdo principal

Criar Toolkit do JIRA

Você pode conectar o JIRA ao StackSpot AI utilizando Toolkits. Siga estas instruções passo a passo para realizar a integração:

Passo 1. Acesse o Portal da StackSpot AI;

Passo 2. Navegue até a seção ‘Toolkits’;

Passo 3. Clique no botão ‘Criar Toolkit’ e preencha as seguintes informações:

  • Nome: Toolkit JIRA
  • Descrição: Toolkit para integração com as APIs do JIRA

Passo 4. Clique no botão ‘Adicionar Tool’ e, em seguida, selecione a opção ‘Enviar Arquivo’.

  • Você precisa de um arquivo OpenAPI/Swagger. Faça o download a seguir:
- Faça o download do arquivo YAML.
  • Os endpoints do JIRA serão automaticamente preenchidos.

Passo 5. Acesse sua conta do JIRA. É necessário ter a autenticação em duas etapas (2FA) configurada em sua conta.

  1. Faça login no JIRA.
  2. No menu, acesse ‘Settings > Security > Create and manage API tokens’.
  3. Clique em ‘Create an API Token’.
  4. Adicione um nome e defina uma data de expiração para o token.
  5. Copie o token gerado e salve-o; você irá utilizá-lo nos próximos passos.

Passo 6. Salve o token de API e seu usuário em BASE64. Você deve acessar um terminal (Mac ou Linux) ou um Prompt de Comando (Windows).

  1. Faça a codificação como uma string BASE64.
  2. Substitua os seguintes valores:
    • user@example.com = seu e-mail utilizado para acessar o Jira;
    • api_token_string = o token de API gerado no passo anterior
  • Linux/Unix/MacOS:
echo -n "user@example.com:api_token_string" | base64
  • Windows 7 ou superior (usando Microsoft PowerShell)::
$Text = "user@example.com:api_token_string"
$Bytes = [System.Text.Encoding]::UTF8.GetBytes($Text)
$EncodedText = [Convert]::ToBase64String($Bytes)
$EncodedText
  1. Copie a credencial criada em base64. Registre-a no StackSpot AI.

Passo 7. Registre o token para que o Agente possa acessar seu projeto Jira privado. Siga as instruções a seguir:

  1. Acesse o toolkit e vá até ‘Configurações’;
  2. Em Autenticação, clique no ícone de cadeado e depois em ‘Registrar Secret’;
  3. Preencha os campos:
    • Local de Armazenamento do Secret: Pessoal
    • Tipo de Credencial: API Key
    • Nome: Jira BASE64 API token
    • Headers:
      • Nome: Authorization
      • Valor: Adicione: Basic <seu_token_criado_em_base64>
  4. Clique no botão ‘Registrar Secret’. Em seguida, salve seu Toolkit.

Passo 8. Crie um Agente. Acesse a seção ‘Agentes’ e clique no botão ‘Criar Agente’. Preencha os seguintes dados:

  • Nome do Agente: Gerenciador de board Jira StackSpot
  • System Prompt:
Você é um agente capaz de interagir com XXXX (adicione aqui o identificador do seu JIRA – normalmente um código com 4 letras)
  • LLM: selecione Azure GPT-4.1
  • Tools: adicione as duas ferramentas que você criou anteriormente:
    • POST > Criar uma tarefa (issue)
    • GET > Listar tarefas em um board (via JQL)

Clique no botão ‘Criar’.

Passo 9. Teste seu Agente.

Pronto, você criou um Agente com um Toolkit do JIRA.