Pular para o conteúdo principal
Quando você conecta a integração Linear, o Devin passa a ter acesso automaticamente às ferramentas nativas do Linear usando a autenticação dessa integração. Você não precisa configurar o MCP do Linear separadamente do MCP Marketplace.

Configurando a integração

  1. Na sua conta Devin em app.devin.ai, acesse Settings > Connections > Linear e clique em “Connect”.
  2. Você será redirecionado para o Linear para revisar as permissões e conceder acesso ao Devin. Você pode selecionar a quais equipes no Linear o Devin terá acesso. Você sempre poderá alterar o acesso do Devin diretamente nas configurações de Linear Apps depois.
  3. Depois de conectado, configure seus rótulos de skill sincronizados e, opcionalmente, configure gatilhos de automação na página de configurações.

Como acionar o Devin no Linear

Há três maneiras de iniciar uma sessão do Devin a partir de um ticket do Linear:

Atribuir um ticket ao Devin

Atribua o ticket ao Devin diretamente no Linear. Devin usará a skill padrão configurada nas suas configurações da integração Linear para começar a trabalhar nesse ticket.

Adicionar um rótulo de skill

Adicione um rótulo de skill ao ticket. O Devin iniciará uma sessão usando a skill correspondente ao rótulo. Esses rótulos são sincronizados a partir dos rótulos de skills sincronizados definidos nas configurações de integração e ficam no grupo de rótulos “Devin Skills”. Os rótulos de skill começam com @skills:. A forma mais curta é @skills:<skill name>, por exemplo, @skills:implement, que executa essa skill desde que ela seja a única com esse nome na sua lista sincronizada; a forma completa, @skills:<plugin>:<skill name> (por exemplo, @skills:account-devin_system_skills:implement), é a que a integração cria no Linear quando você sincroniza uma skill e sempre aponta para uma única skill. Crie o rótulo curto nas configurações de rótulos do seu workspace ou da sua equipe no Linear (Settings > Labels), onde o nome é salvo exatamente como digitado; o seletor de rótulos de um problema o dividiria nos dois-pontos. Os rótulos ! antigos, criados antes de existirem os rótulos de skill (p. ex., !plan, !implement), continuam funcionando. Para iniciar o Devin quando qualquer outro rótulo for adicionado a um ticket (por exemplo, bug), configure um gatilho de automação com esse rótulo ou crie uma automação com o gatilho Rótulo adicionado do Linear.

Mencione (@mention) o Devin em um comentário

Mencione o Devin em um comentário do ticket com instruções específicas. O Devin iniciará uma sessão e usará seu comentário como instrução da tarefa, sem aplicar nenhuma skill. Para ver um exemplo em vídeo de como repassar trabalho do backlog para o Devin, consulte Enviar tickets do Linear para o Devin.

Configurando a integração

Rótulos de skills sincronizadas

A lista sincronizada é o conjunto de habilidades do Devin que você pode iniciar a partir do Linear com um rótulo. Ao adicionar uma skill a essa lista, o rótulo correspondente é criado no Linear (@skills:<plugin>:<skill name>) no grupo de rótulos “Devin Skills” (um workspace que já tenha um grupo “Devin Playbooks” continua usando esse grupo). Cada linha da lista mostra o nome da skill e tem um botão para copiar o rótulo dela. Você também pode criar manualmente o rótulo curto @skills:<skill name> nas configurações de rótulos do Linear; ele executa essa skill, desde que nenhuma outra skill sincronizada tenha o mesmo nome.
  • Skill padrão: uma skill pode ser definida como padrão. Quando um ticket é atribuído ao Devin sem um rótulo de skill específico, o Devin usa essa skill padrão.
  • Adicionar skills: clique em “Add skill” e escolha uma skill de qualquer plugin disponível para sua organização, incluindo as System Skills. O rótulo é criado no Linear quando você salva.
  • Remover skills: remova uma skill para excluir o rótulo correspondente do Linear.
Se os rótulos não estiverem aparecendo no Linear, verifique o aviso Label sync permissions required na página de configurações: o Devin precisa de permissão para gerenciar rótulos no seu workspace do Linear, e uma conexão expirada com o Linear precisa ser reconectada.

Gatilhos de automação

Os gatilhos de automação permitem que o Devin comece a trabalhar automaticamente em tickets quando eles atendem a certas condições, sem atribuição ou rotulagem manual. Você pode configurar gatilhos com base em:
  • Equipes: Acionar apenas para tickets em equipes específicas do Linear.
  • Rótulos: Acionar apenas quando um ticket tiver rótulos específicos.
  • Status: Acionar apenas quando um ticket atingir um status específico (por exemplo, “Todo”, “In Progress”).
  • Skill: Opcionalmente, especifique qual skill o Devin deve usar para a sessão disparada.
Os gatilhos usam edge detection, o que significa que eles só disparam quando um ticket passa de não atender para atender às condições do gatilho (por exemplo, quando um rótulo é adicionado ou um status é alterado), e não para tickets que já as atendem.

Enterprise: mapeamento de equipes do Linear

Para implantações Enterprise com várias organizações do Devin, os administradores podem mapear equipes do Linear para organizações específicas do Devin. Isso garante que os tickets de cada equipe do Linear sejam encaminhados para a organização correta do Devin. É necessário configurar um mapeamento para que a integração com o Linear funcione em ambientes Enterprise.

Interagindo com o Devin no Linear

Assim que o Devin começa a trabalhar em um ticket, ele usa a interface de sessão do agente do Linear para se comunicar:
  • Feed de atividades: o Devin publica atualizações em tempo real enquanto trabalha, incluindo comandos executados, arquivos editados e resumos de progresso.
  • Acompanhamento do plano: a lista de tarefas do Devin é sincronizada com a interface de plano do Linear para que você possa ver o progresso rapidamente.
  • Mensagens de acompanhamento: envie mensagens na thread da sessão do agente para dar instruções adicionais ao Devin ou fazer perguntas.
  • Parar o Devin: use o sinal de parada no Linear para colocar o Devin em modo de espera na tarefa atual.
  • Links de PR: quando o Devin cria uma pull request (PR), a URL da PR é adicionada automaticamente à sessão do agente para acesso rápido.
  • Link da sessão: um link direto para a sessão do Devin no aplicativo web é adicionado à sessão do agente, junto com um link para a skill usada (quando aplicável).

Conectando sua conta de usuário do Linear

Além da integração em nível de organização, membros individuais da equipe podem vincular sua conta Linear à sua conta Devin. Isso permite que o Devin reconheça quem criou um ticket e atribua as sessões ao usuário correto. Para conectar sua conta de usuário, acesse Settings > Connections > Linear e vincule sua conta na seção Conexão de usuário.