Linear
Collega
Collega Linear dal terminale. Passa --help per vedere i flag che Linear accetta.
polylane integration connect --type linearUna chiave API personale con accesso in scrittura.
Collega Linear così gli agenti possono aprire issue a partire dalle indagini, aggiornare gli stati e tenere il tuo issue tracker allineato con ciò che trovano.
Configurazione
- In Linear, apri Settings e vai su Security & access.
- Sotto Personal API keys, crea una chiave. Serve l'accesso in scrittura perché gli agenti possano creare e aggiornare le issue.
- Incolla la chiave in Polylane. Polylane la convalida sul tuo workspace Linear e si collega.
La chiave viene cifrata prima di essere archiviata e l'agente non la vede mai.
Cosa possono fare gli agenti
- Elencare team, stati del workflow, membri e progetti
- Elencare, cercare e leggere le issue con i loro commenti recenti
- Creare issue dai risultati delle indagini, con la traccia delle evidenze nella descrizione
- Aggiornare stato, priorità, assegnatario, progetto, etichette e scadenza delle issue
- Commentare le issue con risultati e stato
- Eseguire GraphQL arbitrario sull'API di Linear per tutto ciò che non è coperto sopra; le mutation passano per lo stesso passaggio di conferma
Le scritture sulle issue chiedono sempre conferma prima di essere eseguite.
Webhook e triage
Il collegamento registra un webhook Polylane nel tuo workspace Linear, che copre le issue di tutti i team pubblici. Con il webhook attivo:
- Le issue che diventano urgenti arrivano come alert e vengono sottoposte a triage man mano che scattano; ridurre l'urgenza o completare la issue risolve l'alert.
Creare il webhook richiede che l'utente della chiave API sia amministratore del workspace in Linear. Una chiave non amministrativa si collega comunque e ogni strumento degli agenti funziona; viene saltato solo il triage guidato dal webhook.
Risoluzione dei problemi
Errore "Invalid API key"
- Usa una chiave API personale da Security & access; i token OAuth non sono supportati. Polylane invia la chiave così com'è nell'header Authorization, senza prefisso Bearer, esattamente come Linear si aspetta per le chiavi personali.
- Verifica che la chiave non sia stata revocata in Linear.
Nessun alert o trigger da Linear
- La creazione del webhook richiede la chiave di un amministratore del workspace. Ricollega con la chiave di un amministratore per abilitare triage e trigger guidati dal webhook.
Scollegamento
Scollega Linear in Polylane, il che rimuove anche il webhook che aveva registrato, poi revoca la chiave API in Linear.
Scollega
Scollegare interrompe ogni sincronizzazione e ogni controllo ed elimina le credenziali che Polylane conservava. Anche tutto ciò che Polylane aveva configurato in Linear viene rimosso; non resta nulla.
polylane integration disconnect <id>Strumenti
4Operazioni che gli agenti possono eseguire nei thread.