{
  "overview": "AGENA 是一个**智能 AI 代理平台**，能够自主生成代码、创建拉取请求并管理您的软件开发工作流。它专为希望在不牺牲代码质量的前提下加速交付的开发团队而设计。\n\n### AGENA 的功能\n- **获取任务** — 从您的待办列表中获取（Azure DevOps、Jira 或手动创建）\n- **运行 AI 代理流水线**：PM → Developer → Reviewer → Finalizer\n- **生成生产级代码**，创建分支、提交并发起 PR\n- **自审查输出** — 由专门的 Reviewer 代理在提交前进行审查\n- **通知您的团队** — 通过 Slack、Teams 或 Telegram\n- **从您的代码库学习** — 使用向量记忆实现上下文感知的代码生成\n\n### 核心概念\n| 概念 | 描述 |\n|---------|-------------|\n| **任务（Task）** | 从 Jira/Azure DevOps 导入或手动创建的工作项。包含标题、描述、验收标准和上下文信息。 |\n| **代理（Agent）** | 一个 AI 角色（PM、Developer、Reviewer、QA、Finalizer），拥有独立的 LLM 模型、系统提示词和行为配置。可按组织自定义。 |\n| **流程（Flow）** | 可视化自动化流水线（n8n 风格），将代理、条件判断、HTTP 调用和集成连接成自定义工作流。 |\n| **像素代理（Pixel Agent）** | 动画化的可视工作空间，以像素角色形式展示代理实时处理任务的过程。 |\n| **组织（Organization）** | 多租户工作空间。每个组织拥有独立的集成、团队成员、任务和计费。 |\n| **仓库映射（Repo Mapping）** | 将 GitHub/Azure DevOps 仓库关联到您的组织，以便 AGENA 知道在哪里创建分支和 PR。 |\n| **规范手册（Playbook）** | 组织级别的编码规则和约定。代理在生成代码时参考规范手册。 |\n| **迭代（Sprint）** | 来自 Azure DevOps 或 Jira 的活跃迭代。任务可以从迭代中导入并在迭代看板上跟踪。 |\n\n### 端到端工作流程\n1. 您创建一个任务（手动创建、从 Jira/Azure 导入，或通过 ChatOps：\\",
  "signup": "### 创建您的账户\n\n1. 前往 [agena.dev/signup](${SITE}/signup)\n2. 输入您的邮箱和密码\n3. 系统将自动为您分配一个新组织\n4. 完成引导向导以配置您的第一个集成\n\n### 注册后\n- 您是组织的 **所有者**\n- 从 **仪表盘 → 团队** 邀请团队成员\n- 从 **仪表盘 → 集成** 配置集成服务",
  "quickstart-saas": "### 使用 AGENA SaaS (agena.dev)\n\n**第 1 步 — 注册** 前往 [agena.dev/signup](${SITE}/signup)\n\n**第 2 步 — 配置集成**（仪表盘 → 集成）\n- **AI 选项卡**：添加您的 OpenAI API 密钥（必需），可选添加 Gemini\n- **任务选项卡**：连接 GitHub（用于创建 PR），可选连接 Azure DevOps / Jira\n\n**第 3 步 — 映射仓库**（仪表盘 → 映射）\n- 选择您的 GitHub 所有者和仓库\n- 这将告知 AGENA 在哪里创建分支和 PR\n\n**第 4 步 — 设置活跃迭代**（仪表盘 → 个人资料）\n- 选择您的 Azure/Jira 项目、团队和迭代\n- 系统会自动检测活跃迭代\n\n**第 5 步 — 创建您的第一个任务**\n- 前往 **仪表盘 → 任务** → 创建任务\n- 输入标题和描述（请具体说明您的需求）\n- 点击 **分配给 AI** — AGENA 将排队处理、运行流水线并创建 PR\n\n**第 6 步 — 监控进度**\n- 在任务列表或 **办公室** 视图中查看任务状态\n- 完成后，您将看到 PR 链接",
  "quickstart-selfhost": "### 自托管部署\n\n#### 前提条件\n- Docker 和 Docker Compose\n- 至少 4GB 内存的服务器\n- 配有 SSL 的域名（用于 Webhook 回调）\n\n#### 安装\n\n\\",
  "office": "### 办公室 — 像素代理工作空间\n\n**办公室** 是 AGENA 的可视化工作空间，您的 AI 代理以动画像素角色的形式出现。每个代理都有自己的办公桌，可以四处走动，并直观地展示其正在处理的工作。\n\n#### 您将看到\n- **代理角色** — 每个 AI 角色（PM、Developer、Reviewer 等）都是一个坐在办公桌前的像素角色\n- **活动指示器** — 代理在处理任务时会发光或播放动画\n- **任务进度条** — 实时流水线进度：获取 → 分析 → 生成 → 审查 → 完成\n- **队列计数器** — 显示队列中等待处理的任务数量\n- **最近完成** — 快速访问最近完成的任务及其 PR 链接\n\n#### 交互元素\n- **点击代理** 查看其当前任务和状态\n- **悬停在办公桌上** 查看代理快速信息\n- **创建任务** 按钮可在不离开办公室视图的情况下快速创建任务\n- 办公室布局通过 WebSocket 实时更新 — 无需刷新\n\n#### 何时使用办公室\n办公室适用于：\n- 实时监控代理的活跃工作\n- 演示/展示模式，向相关方展示 AGENA\n- 快速概览您的 AI 团队状态\n\n#### 导航\n仪表盘 → 办公室（侧边栏工作空间部分的第一项）",
  "tasks": "### 任务\n\n所有 AI 生成工作项的任务管理中心。\n\n#### 创建任务\n1. **手动创建**：点击「创建任务」→ 输入标题和描述 → 分配给 AI\n2. **从 Azure DevOps 导入**：选择项目/团队/迭代 → 导入\n3. **从 Jira 导入**：选择项目/看板/迭代 → 导入\n4. **ChatOps**：发送 \\",
  "sprints": "### 迭代看板\n\n看板风格的面板，按状态分组显示活跃迭代中的所有任务。\n\n#### 设置\n1. 前往 **仪表盘 → 个人资料**\n2. 选择您的 Azure DevOps 或 Jira 项目、团队和迭代\n3. 迭代看板将自动加载所选迭代中的工作项\n\n#### 功能\n- **拖放** 更改任务状态\n- **一键导入** 所有迭代工作项\n- **从看板直接分配给 AI**\n- **筛选** — 按状态、负责人或工作项类型\n- **实时更新** — 通过 WebSocket",
  "sprint-performance": "### 迭代绩效\n\n用于分析迭代速度和 AI 代理效率的分析仪表盘。\n\n#### 指标\n- **完成率** — 已完成任务占总数的百分比\n- **AI 成功率** — AI 流水线无错误完成的频率\n- **平均周期时间** — 从任务创建到 PR 合并的时间\n- **Token 效率** — 每个成功任务的成本\n- **PR 合并率** — AI 生成的 PR 被合并的比例",
  "refinement": "### 需求细化\n\n基于 AI 的迭代需求细化工具，分析待办事项并建议故事点数。\n\n#### 工作原理\n1. 选择数据源（Azure DevOps 或 Jira）\n2. 选择项目 → 团队/看板 → 迭代\n3. 点击 **加载事项** — 显示所有未估算的事项\n4. 选择要分析的事项 → 点击 **运行细化**\n5. AI 分析每个事项并提供：\n   - **建议的故事点数** 及置信度评分\n   - **摘要** — 该事项涉及的内容\n   - **歧义点** 和需要澄清的 **问题**\n   - **是否准备好进入规划** 的指示\n\n#### 回写\n审查建议后，点击 **回写** 将故事点数直接更新到 Azure DevOps 或 Jira。",
  "agents": "### AI 代理\n\n配置驱动您流水线的 AI 代理。\n\n#### 默认代理角色\n| 角色 | 描述 |\n|------|-------------|\n| **PM** | 分析需求、收集上下文、创建实施计划 |\n| **Developer** | 根据计划生成生产级代码 |\n| **Reviewer** | 审查代码的质量、安全性和最佳实践 |\n| **QA** | 测试和验证生成的代码 |\n| **Finalizer** | 创建分支、提交代码并发起拉取请求 |\n\n#### 每个代理的配置\n- **提供商**：OpenAI 或 Gemini\n- **模型**：gpt-5、gpt-4o、gemini-2.5-pro 等\n- **启用/禁用**：单独开关每个代理\n- **创建 PR**：此代理运行是否应创建 PR\n\n#### 自定义代理模型\n每个代理可以使用不同的模型。例如：\n- PM：gpt-4o-mini（快速、低成本，适合分析）\n- Developer：gpt-5（最佳质量，适合代码生成）\n- Reviewer：gpt-4o（审查的良好平衡）",
  "prompt-studio": "### Prompt Studio\n\n编辑和管理每个 AI 代理使用的系统提示词。所有提示词存储在数据库中，可在运行时修改，无需重新部署。\n\n#### 功能\n- **实时编辑** — 更改立即生效\n- **版本历史** — 查看提示词的最后修改时间\n- **按代理分类的提示词** — 每个代理角色都有独立的提示词模板\n- **变量插值** — 使用 \\",
  "flows": "### 流程构建器\n\n用于创建自定义 AI 工作流的可视化自动化构建器（n8n 风格）。\n\n#### 节点类型\n| 节点 | 描述 |\n|------|-------------|\n| **Trigger** | 流程入口点 |\n| **Agent** | LLM 驱动的分析/生成（选择模型、提供商、提示词） |\n| **Azure DevOps** | 创建分支、创建 PR、完成 PR、放弃 PR |\n| **GitHub** | 创建分支、创建 PR、合并 PR |\n| **HTTP** | 带认证的 REST API 调用（Bearer、API 密钥、基本认证） |\n| **Condition** | 分支逻辑（eq、neq、contains、regex 等） |\n| **Notify** | Webhook、Slack 或邮件通知 |\n| **Azure Update** | 更新工作项状态 + 添加评论 |\n\n#### 节点通信\n节点通过 \\",
  "templates": "### 模板\n\n适用于常见开发模式的可复用任务和流程模板。\n\n#### 用法\n- 浏览常见任务的预构建模板（缺陷修复、功能开发、重构）\n- 从成功的任务配置创建您自己的模板\n- 创建新任务时应用模板，自动填充描述、上下文和设置",
  "dora": "### DORA 指标\n\nDevOps Research and Assessment (DORA) 指标仪表盘。\n\n#### 可用视图\n- **概览** — 高层级 DORA 摘要\n- **项目** — 按项目的交付指标\n- **开发** — 代码速度、提交频率、PR 吞吐量\n- **质量** — 代码审查时间、缺陷密度、测试覆盖率\n- **缺陷** — 缺陷跟踪、解决时间、严重性分布\n- **团队** — 按开发者的绩效和工作负载平衡\n\n#### 跟踪的指标\n- **部署频率** — 代码部署的频率\n- **变更前置时间** — 从提交到上线的时间\n- **变更失败率** — 导致故障的部署百分比\n- **平均恢复时间** — 故障恢复的速度",
  "integrations": "### 集成设置\n\n在 **仪表盘 → 集成** 中配置外部服务。\n\n#### AI 选项卡\n- **OpenAI** — API 密钥 + 基础 URL（代码生成必需）\n- **Gemini** — Google AI API 密钥（可选的备用提供商）\n- **规范手册** — 组织级别的编码规则和约定。AI 代理在生成代码时参考这些规则。\n\n#### 任务选项卡\n- **GitHub** — 所有者 + 个人访问令牌（PAT），需要 \\",
  "repo-mapping": "### 仓库映射\n\n仓库映射告诉 AGENA 每个任务应使用哪个代码库。没有映射，AGENA 将不知道在哪里创建分支和 PR。\n\n#### 设置\n1. 前往 **仪表盘 → 映射**\n2. 点击 **添加映射**\n3. 配置以下字段：\n\n| 字段 | 描述 | 示例 |\n|-------|-------------|---------|\n| **提供商** | GitHub 或 Azure DevOps | GitHub |\n| **所有者** | GitHub 组织/用户或 Azure 项目 | \\",
  "team-management": "### 团队与权限\n\n管理您组织的团队成员及其访问级别。\n\n#### 角色\n| 角色 | 权限 |\n|------|-------------|\n| **所有者** | 完全访问权限、计费、删除组织 |\n| **管理员** | 管理团队、集成、设置 |\n| **成员** | 创建任务、查看结果、使用代理 |\n| **查看者** | 对任务和仪表盘的只读访问 |\n\n#### 邀请成员\n1. 前往 **仪表盘 → 团队**\n2. 点击 **邀请** → 输入邮箱地址\n3. 选择要分配的角色\n4. 受邀者将收到包含注册/加入链接的邮件\n\n#### 权限\n在 **仪表盘 → 权限** 中可用的细粒度权限：\n- \\",
  "profile-settings": "### 个人资料与偏好设置\n\n在 **仪表盘 → 个人资料** 中配置您的个人工作空间偏好。\n\n#### 活跃迭代选择\n- **Azure DevOps**：选择项目 → 团队 → 迭代（自动检测活跃迭代）\n- **Jira**：选择项目 → 看板 → 迭代（自动检测活跃迭代）\n\n#### 工作空间偏好\n- **邮件 / Web 推送 / 应用内通知** — 按渠道切换\n- **每日摘要邮件** — 获取每日任务活动汇总\n- **自动分配新任务** — 自动将导入的任务排入 AI 队列\n- **默认创建 PR** — AI 任务是否默认创建 PR\n- **首选提供商和模型** — 新任务的默认 AI 模型\n\n#### 分支命名规则\n从预设中选择或定义自定义规则：\n- \\",
  "chatops": "### ChatOps — Teams / Slack / Telegram\n\n直接从您的聊天平台控制 AGENA。\n\n#### 可用命令\n| 命令 | 描述 |\n|---------|-------------|\n| \\",
  "pipeline": "### AI 代理流水线\n\nAGENA 使用双层编排系统：\n\n#### CrewAI — 代理角色\n每个代理都有特定的角色、模型和系统提示词：\n- **PM 代理**：分析任务、收集代码库上下文、创建详细的实施计划\n- **Developer 代理**：按照计划和仓库约定生成生产级代码\n- **Reviewer 代理**：审查生成的代码，检查缺陷、安全问题和最佳实践\n- **Finalizer 代理**：创建 Git 分支、提交代码并发起拉取请求\n\n#### LangGraph — 执行流水线\n\\",
  "services": "### 服务架构\n\nAGENA 是一个包含 6 个可通过 pip 安装的 Python 包的 Monorepo：\n\n| 包 | 描述 |\n|---------|-------------|\n| \\",
  "selfhost-deploy": "### 自托管部署\n\n#### Docker Compose 服务\n\\",
  "admin-panel": "### 平台管理面板\n\n管理面板是用于管理所有组织的 AGENA 平台超级管理员界面。可通过 **仪表盘 → 管理** 访问。\n\n#### 谁可以访问\n仅具有 \\",
  "admin-orgs": "### 管理组织\n\n#### 查看组织\n导航至 **管理 → 组织** 选项卡查看所有已注册的组织。\n\n每个组织卡片显示：\n- **组织名称** 和 ID\n- **成员数量** — 该组织有多少用户\n- **任务数量** — 该组织创建的总任务数\n- **创建日期** — 组织注册时间\n- **所有者** — 组织所有者的邮箱\n\n#### 多租户\nAGENA 是完全多租户的。每个组织完全隔离：\n- **独立数据** — 任务、流程、代理、集成均按组织隔离\n- **独立计费** — 每个组织有自己的订阅计划\n- **独立集成** — 每个组织连接自己的 GitHub、Jira、Slack 等\n- **无跨组织可见性** — 组织 A 的用户无法看到组织 B 的任何内容\n\n#### 常见管理任务\n- **问题排查** — 如果用户报告问题，找到其组织并检查任务日志\n- **监控增长** — 跟踪新组织注册和活跃租户数量\n- **识别滥用** — 发现任务数量或 API 使用异常高的组织",
  "admin-users": "### 管理用户\n\n#### 查看用户\n导航至 **管理 → 用户** 选项卡查看整个平台上所有已注册的用户。\n\n每个用户条目显示：\n- **姓名** 和邮箱地址\n- **所属组织**\n- **角色** — 在组织中的角色（所有者、管理员、成员、查看者）\n- **平台管理员标记** — 是否拥有平台管理员权限\n- **最后登录** — 上次认证的时间\n\n#### 用户生命周期\n1. 用户在 \\",
  "auth-api": "### 认证 API\n\n\\",
  "tasks-api": "### 任务 API\n\n\\",
  "flows-api": "### 流程 API\n\n\\",
  "integrations-api": "### 集成 API\n\n\\",
  "sdk-install": "### 安装\n\n通过 npm 安装 AGENA SDK：\n\n\\`\\`\\`bash\nnpm install @agena/sdk\n\\`\\`\\`\n\n或使用 yarn：\n\n\\`\\`\\`bash\nyarn add @agena/sdk\n\\`\\`\\`\n\n#### 要求\n- Node.js 18+ 或任何支持 `fetch` 的环境\n- 拥有 API 令牌的 AGENA 账户\n\n#### 获取您的 API 令牌\n1. 登录您的 AGENA 仪表盘\n2. 前往 **个人资料与偏好设置**\n3. 复制您的 API 令牌\n\n或使用 SDK 以编程方式登录：\n\n\\`\\`\\`typescript\nconst { access_token } = await AgenaClient.auth.login(\n  'https://api.agena.dev',\n  'you@email.com',\n  'your-password'\n);\n\\`\\`\\`",
  "sdk-quickstart": "### 快速入门\n\n\\`\\`\\`typescript\nimport { AgenaClient } from '@agena/sdk';\n\n// 初始化客户端\nconst agena = new AgenaClient({\n  apiKey: 'your-token-here',\n});\n\n// 创建任务 — AI 代理将生成代码并创建 PR\nconst task = await agena.tasks.create({\n  title: 'Add user avatar upload',\n  description: 'Allow users to upload and crop a profile avatar image',\n});\n\nconsole.log('Task created:', task.id, task.status);\n\n// 轮询完成状态\nconst interval = setInterval(async () => {\n  const updated = await agena.tasks.get(task.id);\n  console.log('Status:', updated.status);\n\n  if (updated.status === 'completed') {\n    console.log('PR ready:', updated.pr_url);\n    clearInterval(interval);\n  }\n}, 5000);\n\\`\\`\\`\n\n#### 运行流程\n\n\\`\\`\\`typescript\n// 执行可视化自动化流程\nconst run = await agena.flows.run({ flow_id: 1 });\n\n// 检查结果\nconst result = await agena.flows.getRun(run.id);\nconsole.log('Steps:', result.steps.map(s => s.status));\n\\`\\`\\`\n\n#### 监控代理\n\n\\`\\`\\`typescript\n// 实时观察 AI 代理工作\nconst live = await agena.agents.liveStatus(task.id);\nlive.agents.forEach(agent => {\n  console.log(agent.role, '→', agent.status);\n});\n// PM → completed\n// Developer → running\n// Reviewer → pending\n\\`\\`\\`",
  "multi-repo": "### 多仓库编排\n\nAGENA 支持**多仓库编排** — 单个任务可以同时针对多个仓库。无需为每个仓库创建单独的任务，您只需描述一次变更，AGENA 就会为每个仓库运行独立的 agent pipeline，生成各自的 pull request。\n\n#### 什么是多仓库？\n在实际项目中，单个功能或错误修复通常跨越多个代码库 — 后端 API、前端应用、共享库或基础设施配置。多仓库编排让您可以一次将一个任务分配给所有受影响的仓库。\n\n#### 如何设置\n1. **添加仓库映射** — 前往 **Dashboard → Mappings**，添加您希望 AGENA 使用的每个仓库（GitHub 或 Azure DevOps）。\n2. **创建任务时选择多个仓库** — 创建或分配任务时，选择两个或更多已映射的仓库作为目标。\n3. **AGENA 处理剩下的一切** — 每个选定的仓库都会获得自己独立的 pipeline 执行。\n\n#### 工作原理\n- 每个仓库运行自己的**完整 agent pipeline**（PM → Developer → Reviewer → Finalizer）\n- 每个 pipeline 拥有**独立的上下文** — PM agent 获取特定仓库的代码库、规范和文件结构\n- 每个仓库获得**自己的分支和 pull request**\n- 所有 pipeline **并行**运行以实现最大速度\n- 任务面板显示**每个仓库的状态**，便于独立跟踪每个仓库的进度\n\n#### 示例用例\n**任务**：*\"为登录端点添加速率限制\"*\n\n| 仓库 | AGENA 的操作 |\n|------------|----------------|\n| `backend-api` | 添加速率限制中间件，更新登录路由，添加 Redis 计数器逻辑 |\n| `frontend-app` | 添加指数退避重试逻辑，向用户显示速率限制错误消息 |\n| `shared-types` | 在共享错误类型中添加 `RateLimitError` 类型定义 |\n\n结果：3个独立的 PR，每个仓库一个，全部来自单个任务。\n\n#### 最佳实践\n- **任务描述要具体** — 尽可能说明哪些方面适用于哪些仓库\n- **使用 Playbook** — 组织级别的编码规则帮助 agent 在各仓库间保持一致性\n- **一起审查 PR** — 由于所有 PR 都与同一任务相关，请作为一组进行审查和合并",
  "task-dependencies": "### 任务依赖\n\nAGENA 支持**任务依赖** — 定义任务之间的执行顺序，使其自动按正确的序列运行。当依赖项完成时，链中的下一个任务自动排队并启动，无需手动干预。\n\n#### 什么是任务依赖？\n在复杂项目中，任务通常有自然的排序要求。数据库迁移必须在后端 API 更新之前完成。前端更新依赖于新 API 端点准备就绪。E2E 测试应该只在所有代码变更部署之后运行。任务依赖让您可以明确表达这些关系。\n\n#### 如何设置依赖\n1. **创建时** — 创建新任务时，在\"依赖于\"字段中选择一个或多个现有任务作为依赖。\n2. **从任务详情页** — 打开任何任务，在依赖部分添加依赖。\n3. **从分配弹窗** — 分配任务时，也可以设置其依赖关系。\n\n#### 工作原理\n- **Worker 在执行任何任务之前检查依赖** — 如果阻塞项未完成，任务保持 `waiting` 状态\n- 当阻塞任务完成时，所有依赖任务会被**自动重新评估**\n- 依赖项已满足的任务会被**自动排队**并开始执行\n- 依赖链可以根据需要任意长：任务 A → 任务 B → 任务 C → 任务 D\n- 添加依赖时会运行**循环检测** — 循环链（A → B → C → A）会被拒绝并显示清晰的错误消息\n\n#### 可视化依赖流程\n任务面板显示依赖链的可视化表示：\n- **绿色**（完成）— 任务成功完成\n- **黄色**（运行中）— 任务正在被 AI 代理处理\n- **灰色**（等待中）— 任务正在等待其依赖完成\n- 任务之间的箭头显示执行流程方向\n\n#### 示例\n```\n#31 DB Migration        ✓ 完成\n     ↓\n#32 Backend API Update  ✓ 完成\n     ↓\n#33 Frontend Update     ⟳ 运行中\n     ↓\n#34 E2E Tests           ⏳ 等待中\n```\n在此示例中，#33 在 #32 完成后自动排队。#34 将在 #33 完成后自动排队。\n\n#### 最佳实践\n- **保持链的专注性** — 依赖最适合同一功能内自然顺序的工作\n- **与多仓库结合使用** — 将依赖与多仓库编排结合用于复杂的跨仓库工作流\n- **检查可视化流程** — 在启动链之前使用依赖可视化来验证执行顺序",
  "sdk-reference": "### API 参考\n\n#### AgenaClient\n\n| 方法 | 描述 |\n|--------|-------------|\n| `new AgenaClient({ apiKey, baseUrl?, timeout? })` | 创建客户端实例 |\n| `AgenaClient.auth.login(baseUrl, email, password)` | 静态方法：登录并获取令牌 |\n\n#### Tasks\n\n| 方法 | 描述 |\n|--------|-------------|\n| `agena.tasks.create(params)` | 创建新的 AI 任务 |\n| `agena.tasks.get(id)` | 按 ID 获取任务 |\n| `agena.tasks.list({ status?, page?, per_page? })` | 列出任务 |\n| `agena.tasks.cancel(id)` | 取消运行中的任务 |\n| `agena.tasks.rerun(id)` | 重新运行已完成/失败的任务 |\n\n#### Flows\n\n| 方法 | 描述 |\n|--------|-------------|\n| `agena.flows.run({ flow_id, context? })` | 执行流程 |\n| `agena.flows.getRun(runId)` | 获取流程运行详情 |\n| `agena.flows.listRuns()` | 列出最近的运行 |\n| `agena.flows.listTemplates()` | 列出流程模板 |\n\n#### Agents\n\n| 方法 | 描述 |\n|--------|-------------|\n| `agena.agents.run({ task_id })` | 在任务上运行代理 |\n| `agena.agents.liveStatus(taskId)` | 获取代理实时状态 |\n\n#### Integrations\n\n| 方法 | 描述 |\n|--------|-------------|\n| `agena.integrations.list()` | 列出所有集成 |\n| `agena.integrations.get(provider)` | 获取特定集成 |\n| `agena.integrations.githubRepos()` | 列出 GitHub 仓库 |\n| `agena.integrations.githubBranches(owner, repo)` | 列出分支 |\n\n#### 错误处理\n\n所有方法在失败时抛出 `AgenaApiError`：\n\n\\`\\`\\`typescript\ntry {\n  await agena.tasks.get(999);\n} catch (err) {\n  if (err.name === 'AgenaApiError') {\n    console.error(err.status, err.detail);\n  }\n}\n\\`\\`\\`"
}