Integração com Jira
Rastreamento de problemas e gestão de projetos com a integração Jira para CrewAI.
Visão Geral
Permita que seus agentes gerenciem problemas, projetos e fluxos de trabalho pelo Jira. Crie e atualize issues, acompanhe o progresso de projetos, gerencie atribuições e otimize sua gestão de projetos com automação potencializada por IA.
Pré-requisitos
Antes de usar a integração com o Jira, certifique-se de ter:
- Uma conta CrewAI Enterprise com assinatura ativa
- Uma conta Jira com permissões adequadas para o projeto
- Sua conta Jira conectada pela Página de Integrações
Configurando a Integração com o Jira
1. Conectar Sua Conta Jira
- Acesse Integrações CrewAI Enterprise
- Encontre Jira na seção de Integrações de Autenticação
- Clique em Conectar e complete o fluxo do OAuth
- Conceda as permissões necessárias para gestão de issues e projetos
- Copie seu Token Enterprise em Configurações da Conta
2. Instalar o Pacote Necessário
Ações Disponíveis
JIRA_CREATE_ISSUE
JIRA_CREATE_ISSUE
Descrição: Cria uma issue no Jira.
Parâmetros:
summary
(string, obrigatório): Resumo - Um breve resumo da issue. (exemplo: “A impressora parou de funcionar”).project
(string, opcional): Projeto - Projeto ao qual a issue pertence. Padrão para o primeiro projeto do usuário se não informado. Use as Configurações de Workflow do Portal de Conexão para permitir a seleção de Projeto.issueType
(string, opcional): Tipo de issue - Padrão para Task se não informado.jiraIssueStatus
(string, opcional): Status - Padrão para o primeiro status do projeto se não informado.assignee
(string, opcional): Responsável - Padrão para o usuário autenticado se não informado.descriptionType
(string, opcional): Tipo de Descrição - Selecione o Tipo de Descrição.- Opções:
description
,descriptionJSON
- Opções:
description
(string, opcional): Descrição - Uma descrição detalhada da issue. Este campo aparece apenas se ‘descriptionType’ = ‘description’.additionalFields
(string, opcional): Campos Adicionais - Especifique outros campos em formato JSON. Use as Configurações de Workflow do Portal de Conexão para permitir ao usuário selecionar quais campos atualizar.
JIRA_UPDATE_ISSUE
JIRA_UPDATE_ISSUE
Descrição: Atualiza uma issue no Jira.
Parâmetros:
issueKey
(string, obrigatório): Chave da Issue (exemplo: “TEST-1234”).summary
(string, opcional): Resumo - Breve resumo da issue. (exemplo: “A impressora parou de funcionar”).issueType
(string, opcional): Tipo de issue - Use as Configurações de Workflow do Portal de Conexão para permitir a seleção.jiraIssueStatus
(string, opcional): Status - Use as Configurações de Workflow do Portal de Conexão para permitir a seleção.assignee
(string, opcional): Responsável - Use as Configurações de Workflow do Portal de Conexão para permitir a seleção.descriptionType
(string, opcional): Tipo de Descrição - Selecione o Tipo de Descrição.- Opções:
description
,descriptionJSON
- Opções:
description
(string, opcional): Descrição - Descrição detalhada da issue. Este campo aparece apenas se ‘descriptionType’ = ‘description’.additionalFields
(string, opcional): Campos Adicionais - Especifique outros campos em formato JSON.
JIRA_GET_ISSUE_BY_KEY
JIRA_GET_ISSUE_BY_KEY
Descrição: Obtém uma issue pelo identificador no Jira.
Parâmetros:
issueKey
(string, obrigatório): Chave da Issue (exemplo: “TEST-1234”).
JIRA_FILTER_ISSUES
JIRA_FILTER_ISSUES
Descrição: Busca issues no Jira usando filtros.
Parâmetros:
jqlQuery
(object, opcional): Filtro em forma normal disjuntiva - OU de grupos E de condições simples.Operadores disponíveis:$stringExactlyMatches
,$stringDoesNotExactlyMatch
,$stringIsIn
,$stringIsNotIn
,$stringContains
,$stringDoesNotContain
,$stringGreaterThan
,$stringLessThan
limit
(string, opcional): Limitar resultados - Limite máximo de issues retornados. Padrão para 10 se estiver em branco.
JIRA_SEARCH_BY_JQL
JIRA_SEARCH_BY_JQL
Descrição: Busca issues no Jira utilizando JQL.
Parâmetros:
jqlQuery
(string, obrigatório): Query JQL (exemplo: “project = PROJECT”).paginationParameters
(object, opcional): Parâmetros de paginação para resultados paginados.
JIRA_UPDATE_ISSUE_ANY
JIRA_UPDATE_ISSUE_ANY
Descrição: Atualiza qualquer issue no Jira. Use DESCRIBE_ACTION_SCHEMA para obter o schema de propriedades dessa função.
Parâmetros: Nenhum parâmetro específico - use JIRA_DESCRIBE_ACTION_SCHEMA primeiro para obter o schema esperado.
JIRA_DESCRIBE_ACTION_SCHEMA
JIRA_DESCRIBE_ACTION_SCHEMA
Descrição: Obtém o schema esperado para um tipo de issue. Use esta função caso nenhuma outra função atenda ao tipo de issue que deseja operar.
Parâmetros:
issueTypeId
(string, obrigatório): ID do Tipo de Issue.projectKey
(string, obrigatório): Chave do projeto.operation
(string, obrigatório): Tipo de Operação, por exemplo CREATE_ISSUE ou UPDATE_ISSUE.
JIRA_GET_PROJECTS
JIRA_GET_PROJECTS
Descrição: Obtém os projetos no Jira.
Parâmetros:
paginationParameters
(object, opcional): Parâmetros de Paginação.
JIRA_GET_ISSUE_TYPES_BY_PROJECT
JIRA_GET_ISSUE_TYPES_BY_PROJECT
Descrição: Obtém os tipos de issues por projeto no Jira.
Parâmetros:
project
(string, obrigatório): Chave do projeto.
JIRA_GET_ISSUE_TYPES
JIRA_GET_ISSUE_TYPES
Descrição: Obtém todos os tipos de issues no Jira.
Parâmetros: Nenhum obrigatório.
JIRA_GET_ISSUE_STATUS_BY_PROJECT
JIRA_GET_ISSUE_STATUS_BY_PROJECT
Descrição: Obtém os status das issues de um projeto específico.
Parâmetros:
project
(string, obrigatório): Chave do projeto.
JIRA_GET_ALL_ASSIGNEES_BY_PROJECT
JIRA_GET_ALL_ASSIGNEES_BY_PROJECT
Descrição: Obtém os responsáveis por um projeto específico.
Parâmetros:
project
(string, obrigatório): Chave do projeto.
Exemplos de Uso
Configuração Básica de um Agente Jira
Filtrando Ferramentas Jira Específicas
Análise e Relatórios de Projeto
Gestão Automatizada de Issues
Operações Avançadas Baseadas em Schema
Solução de Problemas
Problemas Comuns
Erros de Permissão
- Certifique-se de que sua conta Jira tem as permissões necessárias nos projetos alvo
- Verifique se a conexão OAuth inclui os escopos necessários da API Jira
- Confira se você possui permissões de criar/editar issues nos projetos especificados
Chaves de Projeto ou Issue Inválidas
- Confira o formato das chaves dos projetos e issues (ex: “PROJ-123”)
- Verifique se os projetos existem e são acessíveis pela sua conta
- Certifique-se de que chaves de issues referenciam issues existentes
Problemas de Tipo ou Status de Issue
- Use JIRA_GET_ISSUE_TYPES_BY_PROJECT para obter tipos válidos de issue para um projeto
- Use JIRA_GET_ISSUE_STATUS_BY_PROJECT para obter status válidos
- Certifique-se de que tipos e status de issue estão disponíveis no projeto alvo
Problemas com Queries JQL
- Teste as queries JQL na busca de issues do Jira antes de utilizar em chamadas de API
- Certifique-se de que os nomes dos campos em JQL estejam corretos e existam em sua instância do Jira
- Use a sintaxe correta de JQL para queries complexas
Problemas com Campos Customizados e Schemas
- Use JIRA_DESCRIBE_ACTION_SCHEMA para obter o schema correto para tipos de issues complexas
- Certifique-se de que os IDs dos campos customizados estão corretos (ex: “customfield_10001”)
- Verifique se esses campos estão disponíveis no projeto e tipo de issue alvo
Problemas de Fórmulas de Filtro
- Garanta que as fórmulas de filtro sigam a estrutura JSON correta para forma normal disjuntiva
- Use apenas campos válidos conforme configuração do seu Jira
- Teste filtros simples antes de construir queries complexas com múltiplas condições
Obtenha Ajuda
Precisa de Ajuda?
Entre em contato com nosso time de suporte para obter assistência na configuração ou solução de problemas da integração Jira.