Linear

Forbind Linear, så agenter kan oprette issues fra undersøgelser, opdatere statusser og holde din issue-tracker synkroniseret med det, de finder.

Opsætning

1. I Linear åbner du Settings og navigerer til Security & access.
2. Under Personal API keys opretter du en nøgle. Den skal have skriveadgang, så agenter kan oprette og opdatere issues.
3. Indsæt nøglen i Polylane. Polylane validerer den mod dit Linear-workspace og forbinder.

Din nøgle krypteres, før den gemmes, og agenten ser den aldrig.

Hvad agenter kan gøre

• Liste teams, workflow-tilstande, medlemmer og projekter
• Liste, søge i og læse issues med deres seneste kommentarer
• Oprette issues ud fra undersøgelsesfund, med bevissporet i beskrivelsen
• Opdatere et issues tilstand, prioritet, ansvarlig, projekt, mærkater og forfaldsdato
• Kommentere på issues med fund og status
• Køre vilkårlig GraphQL mod Linear API'et for alt, der ikke er dækket ovenfor; mutationer passerer den samme bekræftelsesport

Skrivninger til issues beder altid om bekræftelse, før de udføres.

Webhooks og triage

Forbindelsen registrerer en Polylane-webhook i dit Linear-workspace, der dækker issues i alle offentlige teams. Med webhooken på plads:

• Issues, der bliver urgent, lander som alarmer og triageres, efterhånden som de udløses; nedgradering eller færdiggørelse af issuet løser alarmen.

Oprettelse af webhooken kræver, at API-nøglens bruger er workspace-administrator i Linear. En nøgle uden administratorrettigheder forbinder stadig, og hvert agentværktøj virker; kun den webhook-drevne triage springes over.

Fejlfinding

Fejlen "Invalid API key"

• Brug en personlig API-nøgle fra Security & access; OAuth-tokens understøttes ikke. Polylane sender nøglen, som den er, i Authorization-headeren, uden Bearer-præfiks, præcis som Linear forventer for personlige nøgler.
• Kontrollér, at nøglen ikke er blevet tilbagekaldt i Linear.

Ingen alarmer eller triggers fra Linear

• Oprettelse af webhooks kræver en workspace-administrators nøgle. Forbind igen med en administrators nøgle for at slå webhook-drevet triage og triggers til.

Afbrydelse

Afbryd Linear i Polylane, hvilket også fjerner den webhook, den registrerede, og tilbagekald derefter API-nøglen i Linear.