issue tracking
Linear
Linear
Connect Linear to let agents create issues, update statuses, and track project progress. Agents can automatically file bugs from investigations and keep your product development workflow in sync with your infrastructure.
连接
从终端连接Linear。传入--help查看Linear接受的标志。
Terminal
polylane integration connect --type linear具有写入访问权限的个人API密钥。
连接Linear，让智能体可以从调查中登记议题、更新状态，并让你的问题跟踪器与它们的发现保持同步。
设置
- 在Linear中，打开Settings并导航到Security & access。
- 在Personal API keys下创建一个密钥。它需要写入访问权限，这样智能体才能创建和更新议题。
- 把密钥粘贴到Polylane中。Polylane针对你的Linear工作区验证它并连接。
你的密钥在存储前加密，智能体永远看不到它。
智能体能做什么
- 列出团队、工作流状态、成员和项目
- 列出、搜索和读取议题及其近期评论
- 从调查发现创建议题，描述中附带证据链
- 更新议题的状态、优先级、负责人、项目、标签和截止日期
- 在议题上评论发现和状态
- 对Linear API运行任意GraphQL以处理上述未涵盖的事情；mutation经过同样的确认关卡
议题写入在执行前始终要求确认。
Webhook与分诊
连接会在你的Linear工作区中注册一个Polylane Webhook，覆盖所有公开团队中的议题。Webhook就位后：
- 变为紧急的议题作为告警落地，并在触发时得到分诊；降级或完成该议题会解除告警。
创建Webhook要求该API密钥的用户是Linear中的工作区管理员。非管理员密钥仍然可以连接，每个智能体工具都可用；只是跳过由Webhook驱动的分诊。
故障排除
“Invalid API key”错误
- 使用来自Security & access的个人API密钥；不支持OAuth令牌。Polylane在Authorization请求头中原样发送密钥，不带Bearer前缀，正如Linear对个人密钥的要求。
- 检查该密钥没有在Linear中被撤销。
没有来自Linear的告警或触发器
- 创建Webhook需要工作区管理员的密钥。用管理员的密钥重新连接，以启用由Webhook驱动的分诊和触发器。
断开连接
在Polylane中断开Linear，这也会移除它注册的Webhook，然后在Linear中撤销该API密钥。
断开连接
断开连接会停止所有同步和检查，并删除Polylane持有的凭据。 Polylane在Linear中设置的一切也会被移除；不会留下任何东西。
Terminal
polylane integration disconnect <id>工具
4智能体可以在线程中执行的操作。
Api
Run any Linear GraphQL query or mutation that lacks a dedicated tool
Teams
List Linear teams, workflow states, and members
Projects
List Linear projects and their delivery state
Issues
Read, search, create, update, and comment on Linear issues