Linear
Подключить
Подключите Linear из терминала. Передайте --help, чтобы увидеть флаги, которые принимает Linear.
polylane integration connect --type linearПерсональный API-ключ с доступом на запись.
Подключите Linear, чтобы агенты могли создавать задачи из расследований, обновлять статусы и синхронизировать ваш трекер задач с тем, что они находят.
Настройка
- В Linear откройте Settings и перейдите в Security & access.
- В разделе Personal API keys создайте ключ. Ему нужен доступ на запись, чтобы агенты могли создавать и обновлять задачи.
- Вставьте ключ в Polylane. Polylane проверяет его на вашем рабочем пространстве Linear и подключается.
Ваш ключ шифруется перед сохранением, и агент никогда его не видит.
Что могут агенты
- Перечислять команды, состояния рабочего процесса, участников и проекты
- Перечислять, искать и читать задачи с их последними комментариями
- Создавать задачи из результатов расследования с цепочкой доказательств в описании
- Обновлять состояние, приоритет, исполнителя, проект, метки и срок задачи
- Комментировать задачи с результатами и статусом
- Выполнять произвольные GraphQL-запросы к API Linear для всего, что не покрыто выше; мутации проходят тот же шлюз подтверждения
Записи в задачи всегда запрашивают подтверждение перед выполнением.
Webhooks и триаж
Подключение регистрирует 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Операции, которые агенты могут выполнять в тредах.