Integração com o Linear
Acompanhamento de projetos de software e rastreamento de bugs com a integração Linear para CrewAI.
Visão Geral
Permita que seus agentes gerenciem issues, projetos e fluxos de trabalho de desenvolvimento através do Linear. Crie e atualize issues, gerencie cronogramas de projetos, organize equipes e otimize seu processo de desenvolvimento de software com automação impulsionada por IA.
Pré-requisitos
Antes de utilizar a integração com o Linear, certifique-se de que você possui:
- Uma conta CrewAI Enterprise com uma assinatura ativa
- Uma conta Linear com permissões apropriadas no workspace
- Conectou sua conta Linear através da página de Integrações
Configurando a Integração com o Linear
1. Conecte sua Conta Linear
- Navegue até Integrações CrewAI Enterprise
- Encontre Linear na seção Integrações de Autenticação
- Clique em Conectar e complete o fluxo OAuth
- Conceda as permissões necessárias para gerenciamento de issues e projetos
- Copie seu Token Empresarial em Configurações da Conta
2. Instale o Pacote Necessário
Ações Disponíveis
LINEAR_CREATE_ISSUE
LINEAR_CREATE_ISSUE
Descrição: Crie uma nova issue no Linear.
Parâmetros:
teamId
(string, obrigatório): ID da Equipe - Especifique o ID da equipe responsável para esta nova issue. Use as Configurações de Fluxo do Connect Portal para permitir que usuários escolham um ID de Equipe. (exemplo: “a70bdf0f-530a-4887-857d-46151b52b47c”).title
(string, obrigatório): Título - Especifique um título para esta issue.description
(string, opcional): Descrição - Especifique uma descrição para esta issue.statusId
(string, opcional): Status - Especifique o status desta issue.priority
(string, opcional): Prioridade - Especifique a prioridade desta issue como um inteiro.dueDate
(string, opcional): Data de Vencimento - Especifique a data de vencimento desta issue no formato ISO 8601.cycleId
(string, opcional): ID do Ciclo - Especifique o ciclo associado a esta issue.additionalFields
(object, opcional): Campos Adicionais.
LINEAR_UPDATE_ISSUE
LINEAR_UPDATE_ISSUE
Descrição: Atualize uma issue no Linear.
Parâmetros:
issueId
(string, obrigatório): ID da Issue - Especifique o ID da issue a ser atualizada. (exemplo: “90fbc706-18cd-42c9-ae66-6bd344cc8977”).title
(string, opcional): Título - Especifique um título para esta issue.description
(string, opcional): Descrição - Especifique uma descrição para esta issue.statusId
(string, opcional): Status - Especifique o status desta issue.priority
(string, opcional): Prioridade - Especifique a prioridade desta issue como um inteiro.dueDate
(string, opcional): Data de Vencimento - Especifique a data de vencimento desta issue no formato ISO 8601.cycleId
(string, opcional): ID do Ciclo - Especifique o ciclo associado a esta issue.additionalFields
(object, opcional): Campos Adicionais.
LINEAR_GET_ISSUE_BY_ID
LINEAR_GET_ISSUE_BY_ID
Descrição: Obtenha uma issue pelo ID no Linear.
Parâmetros:
issueId
(string, obrigatório): ID da Issue - Especifique o ID do registro da issue a ser buscada. (exemplo: “90fbc706-18cd-42c9-ae66-6bd344cc8977”).
LINEAR_GET_ISSUE_BY_ISSUE_IDENTIFIER
LINEAR_GET_ISSUE_BY_ISSUE_IDENTIFIER
Descrição: Obtenha uma issue através do identificador da issue no Linear.
Parâmetros:
externalId
(string, obrigatório): ID Externo - Especifique o identificador legível da issue a ser buscada. (exemplo: “ABC-1”).
LINEAR_SEARCH_ISSUE
LINEAR_SEARCH_ISSUE
Descrição: Pesquise issues no Linear.
Parâmetros:
queryTerm
(string, obrigatório): Termo de Pesquisa - O termo a ser localizado na busca.issueFilterFormula
(object, opcional): Um filtro na forma normal disjuntiva – OU de grupos E de condições únicas.Campos disponíveis:title
,number
,project
,createdAt
Operadores disponíveis:$stringExactlyMatches
,$stringDoesNotExactlyMatch
,$stringIsIn
,$stringIsNotIn
,$stringStartsWith
,$stringDoesNotStartWith
,$stringEndsWith
,$stringDoesNotEndWith
,$stringContains
,$stringDoesNotContain
,$stringGreaterThan
,$stringLessThan
,$numberGreaterThanOrEqualTo
,$numberLessThanOrEqualTo
,$numberGreaterThan
,$numberLessThan
,$dateTimeAfter
,$dateTimeBefore
LINEAR_DELETE_ISSUE
LINEAR_DELETE_ISSUE
Descrição: Exclua uma issue no Linear.
Parâmetros:
issueId
(string, obrigatório): ID da Issue - Especifique o ID do registro da issue a ser excluída. (exemplo: “90fbc706-18cd-42c9-ae66-6bd344cc8977”).
LINEAR_ARCHIVE_ISSUE
LINEAR_ARCHIVE_ISSUE
Descrição: Arquive uma issue no Linear.
Parâmetros:
issueId
(string, obrigatório): ID da Issue - Especifique o ID do registro da issue a ser arquivada. (exemplo: “90fbc706-18cd-42c9-ae66-6bd344cc8977”).
LINEAR_CREATE_SUB_ISSUE
LINEAR_CREATE_SUB_ISSUE
Descrição: Crie uma sub-issue no Linear.
Parâmetros:
parentId
(string, obrigatório): ID do Pai - Especifique o ID da issue pai desta nova issue.teamId
(string, obrigatório): ID da Equipe - Especifique o ID da equipe responsável pela nova sub-issue. Use as Configurações de Fluxo do Connect Portal para permitir que usuários escolham um ID de Equipe. (exemplo: “a70bdf0f-530a-4887-857d-46151b52b47c”).title
(string, obrigatório): Título - Especifique um título para esta issue.description
(string, opcional): Descrição - Especifique uma descrição para esta issue.additionalFields
(object, opcional): Campos Adicionais.
LINEAR_CREATE_PROJECT
LINEAR_CREATE_PROJECT
Descrição: Crie um novo projeto no Linear.
Parâmetros:
teamIds
(object, obrigatório): ID da Equipe - Especifique o(s) ID(s) da equipe associada a este projeto como string ou array JSON. Use as Configurações de Usuário do Connect Portal para que seu usuário selecione um ID de Equipe.projectName
(string, obrigatório): Nome do Projeto - Especifique o nome do projeto. (exemplo: “Meu Projeto Linear”).description
(string, opcional): Descrição do Projeto - Especifique uma descrição para este projeto.additionalFields
(object, opcional): Campos Adicionais.
LINEAR_UPDATE_PROJECT
LINEAR_UPDATE_PROJECT
Descrição: Atualize um projeto no Linear.
Parâmetros:
projectId
(string, obrigatório): ID do Projeto - Especifique o ID do projeto a ser atualizado. (exemplo: “a6634484-6061-4ac7-9739-7dc5e52c796b”).projectName
(string, opcional): Nome do Projeto - Especifique o nome do projeto a ser atualizado. (exemplo: “Meu Projeto Linear”).description
(string, opcional): Descrição do Projeto - Especifique uma descrição para este projeto.additionalFields
(object, opcional): Campos Adicionais.
LINEAR_GET_PROJECT_BY_ID
LINEAR_GET_PROJECT_BY_ID
Descrição: Obtenha um projeto pelo ID no Linear.
Parâmetros:
projectId
(string, obrigatório): ID do Projeto - Especifique o ID do projeto a ser buscado. (exemplo: “a6634484-6061-4ac7-9739-7dc5e52c796b”).
LINEAR_DELETE_PROJECT
LINEAR_DELETE_PROJECT
Descrição: Exclua um projeto no Linear.
Parâmetros:
projectId
(string, obrigatório): ID do Projeto - Especifique o ID do projeto a ser excluído. (exemplo: “a6634484-6061-4ac7-9739-7dc5e52c796b”).
LINEAR_SEARCH_TEAMS
LINEAR_SEARCH_TEAMS
Descrição: Pesquise equipes no Linear.
Parâmetros:
teamFilterFormula
(object, opcional): Um filtro na forma normal disjuntiva – OU de grupos E de condições únicas.Campos disponíveis:id
,name
Exemplos de Uso
Configuração Básica do Agente Linear
Filtrando Ferramentas Lineares Específicas
Gerenciamento de Projetos e Equipes
Hierarquia de Issues e Gerenciamento de Sub-tarefas
Fluxo de Trabalho de Desenvolvimento Automatizado
Solução de Problemas
Problemas Comuns
Erros de Permissão
- Certifique-se de que sua conta Linear possui as permissões necessárias no workspace de destino
- Verifique se a conexão OAuth inclui os escopos requeridos pela API do Linear
- Confirme se você tem permissões para criar/editar issues e projetos no workspace
IDs e Referências Inválidas
- Verifique os IDs de equipes, IDs de issues e IDs de projetos para garantir o formato UUID correto
- Assegure que as entidades referenciadas (equipes, projetos, ciclos) existem e estão acessíveis
- Verifique se os identificadores de issues seguem o formato correto (ex: “ABC-1”)
Problemas de Associação entre Equipe e Projeto
- Use LINEAR_SEARCH_TEAMS para obter IDs de equipe válidos antes de criar issues ou projetos
- Certifique-se de que as equipes existem e estão ativas no seu workspace
- Verifique se os IDs das equipes estão devidamente formatados como UUIDs
Problemas com Status e Prioridade das Issues
- Verifique se os IDs de status referenciam estados de workflow válidos para a equipe
- Certifique-se de que os valores de prioridade estão dentro do intervalo válido para sua configuração do Linear
- Confirme que campos personalizados e labels existem antes de referenciá-los
Problemas com Formato de Data e Hora
- Use o formato ISO 8601 para datas de vencimento e timestamps
- Certifique-se de que os fusos horários estão corretos para cálculos de datas de vencimento
- Verifique se os valores de data são válidos e posteriores à data atual para datas de vencimento
Problemas de Pesquisa e Filtros
- Garanta que as consultas de busca estejam formatadas corretamente e não estejam vazias
- Utilize nomes de campos válidos nas fórmulas de filtro:
title
,number
,project
,createdAt
- Teste filtros simples antes de montar consultas complexas com múltiplas condições
- Verifique se os tipos de operadores correspondem aos tipos de dados dos campos filtrados
Problemas na Criação de Sub-issues
- Certifique-se de que os IDs das issues pai são válidos e acessíveis
- Verifique se o ID da equipe para as sub-issues corresponde ou é compatível com o da issue pai
- Assegure-se de que as issues pai não estejam arquivadas ou excluídas
Obtendo Ajuda
Precisa de Ajuda?
Entre em contato com nossa equipe de suporte para assistência na configuração ou solução de problemas da integração com o Linear.