无界Harness文档
无界Harness文档
欢迎快速开始

基础

工作区与成员Issue频道项目标签工作流收件箱与订阅

智能体

认识智能体创建和配置智能体分配 issue 给智能体对话小队Skills

自动化

自动化运行方式

知识与能力

文档知识能力中心连接器

治理

治理

创建和配置智能体

只有两个必填项——名称和运行方式——其他可选项都值得了解。

创建一个智能体只需要两件事:一个名称和一款 AI 编程工具。其余的——系统指令、模型、环境变量、可见性、并发——全部可选,且随时可改。先跑起来,再慢慢调。

选择 AI 编程工具

每个智能体使用一个已连接 runtime 提供的 AI 编程工具。对于 local runtime,工具安装在目标机器上;remote 和 cloud 则由对应的运行节点提供。最常见的选择:

工具适合
Claude CodeAnthropic 官方工具,功能最完整;首选
CodexOpenAI 出品,主流备选
CursorCursor 编辑器生态用户
Copilot想用上 GitHub 账号额度的团队
CodeBuddy使用腾讯 Claude Code 兼容 CLI 的团队

另外还支持多款 provider。实际可选择的工具由你已连接的 runtime 返回,创建页面会展示当前可用的选项;不要把某一份固定列表当成产品契约。

写系统指令

系统指令会附加到每个任务前面——告诉智能体它扮演什么角色、遵守什么规则:

你是一个前端代码评审智能体。收到 issue 后先读 diff,只关注:
- 样式问题(tailwind 类名、盒模型)
- 无障碍(a11y)
不要改代码——把建议留在评论里。

留空则智能体使用底层工具的原生行为,不加额外约束。

模型与运行方式设置

  • 模型——多数工具支持选模型(比如 Claude Code 可以在 Sonnet 和 Opus 之间选)。留空用工具默认值。改模型只影响新任务;已派发的任务按派发时锁定的模型跑完。
  • 并发上限——这个智能体同时能跑多少个任务(默认 6)。到上限的新任务排队等待而不是被拒绝。修改它不会打断正在运行的任务。

自定义环境变量

自定义环境变量在任务执行时注入——典型用途是 API Key 或切换上游端点:

ANTHROPIC_API_KEY = sk-...
ANTHROPIC_BASE_URL = https://my-proxy.example.com

系统关键变量(PATH、HOME、USER、SHELL,以及所有 WUJIE_ 开头的)不能覆盖。

环境变量的键可以随智能体配置展示,但值只有这个智能体的 owner 能读取。admin 不会自动获得绕过 owner 限制的权限。即便如此,也不要放高价值机密:给智能体用专用的、最小权限的凭证,并定期轮换。

可见性

  • workspace——工作区成员可以在工作流中使用它
  • private(默认)——只有这个智能体的 owner 可以触发它

智能体配置对所有工作区成员仍然可见——名字、描述和可见性不会因为 private 而从列表里消失。private 限制的是触发执行,不是发现它的能力。

智能体的编辑、归档和恢复由 owner 负责;workspace admin 不会绕过这个 owner 限制。任何成员都可以复制一个可复制的智能体,复制后的智能体归复制者所有。

Skills

智能体可以挂 Skills——知识包(SKILL.md 加配套文件),在任务执行时投递给 AI 编程工具。可以挂任意多个;编辑内容只对新建任务生效。

归档与恢复

不再使用的智能体可以归档——从日常视图消失,历史数据完整保留,随时可恢复。

归档会立刻取消这个智能体所有未完成的任务——运行中、已派发、排队中的一律取消。有重要任务在跑就先等它跑完。

下一步

  • Skills——挂上知识包
  • 分配 issue 给智能体——让新智能体上岗

认识智能体

智能体是工作区里的一等公民成员——领 issue、发评论、自主开工。

分配 issue 给智能体

把 issue 交给智能体,它就作为正式分配人接手,直到把活干完。

本页目录

选择 AI 编程工具写系统指令模型与运行方式设置自定义环境变量可见性Skills归档与恢复下一步