SuperAPI AI 工具集

Linear Agents (AIG, Signals, Interaction)

智能体与模型

查看项目

更新于 10-16 07:20

技能介绍

用途:在 Linear 内构建或注册智能体(Agent)。Linear 智能体是一种具备 agents:create 与 agents:signal 作用域的 OAuth 应用,可被指派到 issue(视为一等指派人)、以用户身份发表评论或变更状态(通过 OAuth 行为者授权),并发出信号。

注册:进入 Settings → API → Agents → New agent;或在获得 agents:create 后通过 API 注册。需记录 agentId、长期有效的 agent_oauth_token 以及用于交互事件的 Webhook URL。

智能体交互:用户指派智能体到 issue 时,Linear 发送类型为 Agent、动作为 interaction 的 webhook 事件,体内含 issue.id、actor(触发用户)与 kind(assigned、mentioned、replied)。建议流程:先用 agentSignalCreate({ kind: "progress", message: "Working on it…" }) 确认,再执行工作,之后以 completion 信号报告结果并用评论发布结果。

智能体信号:渲染为 Linear UI 内联徽章的状态提示,类型包括 progress(黄)、completion(绿)、request_input(蓝,带按钮)、error(红),可携带 metadata。信号是临时的,不属于评论;进行中更新用信号,永久结果用评论。

AIG:Linear 的智能体间通信网关,用于在智能体之间传递上下文、协商多智能体任务归属、汇总子智能体信号。插件 lib/aig.ts 提供 aigPublish(channel, msg) 与 aigSubscribe(channel, handler)。

行为者授权:以用户身份操作时,由后端铸造带 userId、5 分钟有效期的 JWT 行为者令牌,放入 Linear-Actor-Token 头;操作在 UI 中显示为用户执行并带“via Agent:”徽章。

最佳实践与限制:需按事件 ID 去重以应对重试;长任务至少每 30 秒发出一次 progress 信号,否则 Linear 显示“Agent unresponsive”;出错时同时发 error 信号并评论失败详情,不要静默失败;避免请求不必要的 admin 作用域。具体收费、价格与更多平台细节资料暂未提供。