Linear

Linearを接続すると、エージェントが調査からIssueを登録し、状態を更新し、見つけたことに合わせてイシュートラッカーを同期し続けられるようになります。

セットアップ

1. LinearでSettingsを開き、Security & accessに移動します。
2. Personal API keysの下でキーを作成します。エージェントがIssueを作成し更新できるように、書き込みアクセスが必要です。
3. キーをPolylaneに貼り付けます。PolylaneがLinearワークスペースに対してそれを検証し、接続します。

キーは保存前に暗号化され、エージェントが目にすることはありません。

エージェントができること

• チーム、ワークフローの状態、メンバー、プロジェクトを一覧する
• Issueを一覧、検索し、最近のコメントとともに読む
• 調査の発見からIssueを作成し、説明に証拠の経緯を含める
• Issueの状態、優先度、担当者、プロジェクト、ラベル、期日を更新する
• 発見と状況をIssueにコメントする
• 上記で網羅されていないことのために、Linear APIに対して任意のGraphQLを実行する。ミューテーションは同じ確認のゲートを通る

Issueへの書き込みは、実行前に必ず確認を求めます。

Webhookとトリアージ

接続すると、Linearワークスペースに、すべての公開チームのIssueを対象とするPolylaneのWebhookが登録されます。Webhookがあると、次のようになります。

• 緊急になったIssueはアラートとして届き、発火と同時にトリアージされます。Issueの緊急度を下げるか完了すると、アラートは解決します。

Webhookの作成には、APIキーのユーザーがLinearのワークスペース管理者である必要があります。管理者でないキーでも接続はでき、すべてのエージェントツールは動作します。Webhookによるトリアージだけがスキップされます。

トラブルシューティング

「Invalid API key」エラー

• Security & accessのパーソナルAPIキーを使ってください。OAuthトークンには対応していません。Polylaneはキーを、Linearがパーソナルキーに対して期待するとおり、BearerプレフィックスなしでそのままAuthorizationヘッダーに送ります。
• Linearでキーが取り消されていないことを確認してください。

Linearからアラートやトリガーが届かない

• Webhookの作成にはワークスペース管理者のキーが必要です。Webhookによるトリアージとトリガーを有効にするには、管理者のキーで再接続してください。

接続解除

PolylaneでLinearを接続解除すると、登録したWebhookも取り除かれます。次にLinearでAPIキーを取り消します。