你的项目
项目是一个 git 仓库,用于存放智能体的配置和状态。
一个项目就是一个 git 仓库。它存放清单、智能体配置,以及智能体生成的状态。无需同步单独的数据库。
Beeuni 以两种方式管理项目:
- Beeuni 托管的仓库 — Beeuni 创建并托管私有仓库。默认选项。
- 导入 GitHub 仓库 — 连接现有仓库。Beeuni 通过 GitHub API 操作该仓库。
无论哪种方式,项目都有一个 default_branch。每个
会话 都从它分支而出。每个
变更请求 都合并到它。GitHub 仓库的每个分支都可以成为独立项目。这样,main 和 dev 就可以作为独立项目运行,各自拥有自己的会话和变更请求。
项目不是你的代码库
项目存放智能体的指令、它的 连接器、它的触发器, 以及它的记忆。保持项目精简——Beeuni 会将它克隆到每个会话中。
你的代码存放在别处。任务需要用到代码库时,智能体会克隆该仓库、完成工作,然后向该仓库发起变更请求。不要通过向现有代码库添加清单来把它变成项目。请另建一个专用项目,并将其指向智能体要操作的仓库。
清单
每个项目的仓库根目录下都有一个清单,默认文件名为 beeuni.yaml。平台会读取以下顶层键:
| 键 | 配置项 |
|---|---|
default_agent |
默认运行哪个智能体 |
agents |
每个智能体的授权:连接器、密钥、技能、Beeuni 权限 |
sandbox |
沙盒映像和硬件 |
triggers |
计划任务和 webhook 自动化 |
connectors |
项目可以访问哪些外部工具 |
env |
项目需要的环境变量名称(其值来自密钥) |
未知键会被忽略。
较旧的项目可能仍使用 beeuni.toml(beeuni_version: 1)。Beeuni 两种格式都能读取。迁移方式请参阅旧版 TOML。
删除项目
可在项目设置中 Danger zone 下选择 Delete project 删除项目,也可使用 beeuni projects rm。从删除那一刻起,任何操作都不能再代表该项目执行:
| 接入方式 | 删除后的行为 |
|---|---|
LLM 网关密钥(kgw_…) |
请求将被拒绝,并返回 401。 |
| 公开分享链接 | 返回 410。 |
| 应用 | 不再提供服务。 |
| 新会话 | 请求将被拒绝:404、code: "project_archived"。 |
| Slack 和 Teams | 回复“此 Beeuni 工作区已删除……”,且不启动任何操作。 |
| 电子邮件收件箱 | 对邮件线程中的第一封邮件回复一次:“此地址目前不接收邮件。不会有人回复此消息。”该线程在 30 天内的下一封回复不会收到任何回复;发件人身份验证失败的邮件也不会收到回复。 |
| 现有会话 | 不接收任何新消息:无论消息来自聊天线程、触发器,还是删除前排队的提示。 |