Linear
Conectar
Conecte Linear pelo terminal. Passe --help para ver as flags que Linear aceita.
polylane integration connect --type linearUma chave de API pessoal com acesso de escrita.
Conecte o Linear para que os agentes possam registrar issues a partir de investigações, atualizar status e manter seu rastreador de issues em sincronia com o que eles encontram.
Configuração
- No Linear, abra Settings e navegue até Security & access.
- Em Personal API keys, crie uma chave. Ela precisa de acesso de escrita para que os agentes possam criar e atualizar issues.
- Cole a chave no Polylane. O Polylane a valida contra o seu workspace do Linear e conecta.
Sua chave é criptografada antes de ser armazenada, e o agente nunca a vê.
O que os agentes podem fazer
- Listar times, estados de workflow, membros e projetos
- Listar, pesquisar e ler issues com seus comentários recentes
- Criar issues a partir de descobertas de investigações, com a trilha de evidências na descrição
- Atualizar estado, prioridade, responsável, projeto, labels e data de entrega das issues
- Comentar em issues com descobertas e status
- Executar GraphQL arbitrário contra a API do Linear para qualquer coisa não coberta acima; mutações passam pela mesma barreira de confirmação
Escritas em issues sempre pedem confirmação antes de executar.
Webhooks e triagem
Conectar registra um webhook do Polylane no seu workspace do Linear, cobrindo issues em todos os times públicos. Com o webhook no lugar:
- Issues que se tornam urgentes chegam como alertas e passam por triagem assim que disparam; reduzir a urgência ou concluir a issue resolve o alerta.
Criar o webhook exige que o usuário da chave de API seja admin do workspace no Linear. Uma chave sem admin ainda conecta e todas as ferramentas de agente funcionam; apenas a triagem acionada por webhook é ignorada.
Solução de problemas
Erro "Invalid API key"
- Use uma chave de API pessoal de Security & access; tokens OAuth não são suportados. O Polylane envia a chave como está no cabeçalho Authorization, sem prefixo Bearer, exatamente como o Linear espera para chaves pessoais.
- Confira se a chave não foi revogada no Linear.
Nenhum alerta ou trigger do Linear
- A criação do webhook precisa da chave de um admin do workspace. Reconecte com a chave de um admin para habilitar a triagem e os triggers acionados por webhook.
Desconectar
Desconecte o Linear no Polylane, o que também remove o webhook que ele registrou, depois revogue a chave de API no Linear.
Desconectar
Desconectar interrompe todas as sincronizações e verificações e apaga as credenciais que o Polylane guardava. Tudo o que o Polylane configurou em Linear também é removido; nada fica para trás.
polylane integration disconnect <id>Ferramentas
4Operações que os agentes podem executar em threads.