Linear
Підключити
Підключіть Linear із термінала. Передайте --help, щоб побачити прапорці, які приймає Linear.
polylane integration connect --type linearПерсональний ключ API з доступом на запис.
Підключіть Linear, щоб агенти могли створювати задачі з розслідувань, оновлювати статуси та тримати ваш трекер задач синхронізованим із тим, що вони знаходять.
Налаштування
- У Linear відкрийте Settings і перейдіть до Security & access.
- У розділі Personal API keys створіть ключ. Йому потрібен доступ на запис, щоб агенти могли створювати та оновлювати задачі.
- Вставте ключ у Polylane. Polylane перевіряє його відносно вашого робочого простору Linear і підключається.
Ваш ключ шифрується перед збереженням, і агент ніколи його не бачить.
Що можуть робити агенти
- Перелічувати команди, стани робочого процесу, учасників і проєкти
- Перелічувати, шукати та читати задачі з їхніми недавніми коментарями
- Створювати задачі з результатів розслідування зі слідом доказів в описі
- Оновлювати стан, пріоритет, виконавця, проєкт, мітки та термін задачі
- Коментувати задачі результатами та статусом
- Виконувати довільний GraphQL до API Linear для всього, що не охоплено вище; мутації проходять той самий етап підтвердження
Записи в задачі завжди запитують підтвердження перед виконанням.
Webhook і тріаж
Підключення реєструє webhook Polylane у вашому робочому просторі Linear, який охоплює задачі в усіх публічних командах. Коли webhook на місці:
- Задачі, які стають терміновими, надходять як алерти та проходять тріаж одразу після спрацювання; зниження терміновості або завершення задачі закриває алерт.
Для створення webhook користувач ключа API має бути адміністратором робочого простору в Linear. Ключ без прав адміністратора все одно підключається, і кожний інструмент агента працює; пропускається лише тріаж на основі webhook.
Усунення несправностей
Помилка "Invalid API key"
- Використовуйте персональний ключ API з розділу Security & access; токени OAuth не підтримуються. Polylane надсилає ключ як є в заголовку Authorization, без префікса Bearer, саме так, як Linear очікує для персональних ключів.
- Перевірте, чи ключ не було відкликано в Linear.
Немає алертів або тригерів від Linear
- Для створення webhook потрібен ключ адміністратора робочого простору. Підключіться повторно з ключем адміністратора, щоб увімкнути тріаж і тригери на основі webhook.
Відключення
Відключіть Linear у Polylane, що також видаляє зареєстрований ним webhook, а потім відкличте ключ API в Linear.
Відключити
Відключення зупиняє кожну синхронізацію та перевірку і видаляє облікові дані, які зберігав Polylane. Усе, що Polylane налаштував у Linear, також видаляється; нічого не залишається.
polylane integration disconnect <id>Інструменти
4Операції, які агенти можуть виконувати в тредах.