智能体项目有两个重要配置文件：
配置文件 | 用途 |
|---|---|
agent-cloudbase-functions.json | 定义函数入口和代码结构 |
project.config.json | 定义项目元信息 |
配置文件应放在智能体项目的根目录下：
your-agent-project/ ├── agent-cloudbase-functions.json ← 函数入口配置 ├── project.config.json ← 项目元信息配置 ├── src/ │ └── index.js ← 函数入口文件 └── package.json
重要提示：智能体只能配置一个 function。
functions数组必须且只能包含一个 function 配置。
{
"agentId": "xhs1234567890",
"version": "0.0.1",
"functionsRoot": "./src",
"functions": [
{
"name": "main",
"directory": "./",
"source": "index.js",
"triggerPath": "/"
}
]
}
字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| functionsRoot | string | ✅ 是 | 函数代码的根目录，相对于配置文件所在目录。通常为 "./src" |
| functions | array | ✅ 是 | 函数配置数组。智能体只能配置一个 function |
| agentId | string | ❌ 否 | 智能体 ID，从开放平台获取。可在配置文件中指定，也可在部署时通过其他方式传入 |
| version | string | ❌ 否 | 智能体版本号，用于版本管理。格式建议： "0.0.1" |
字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | ✅ 是 | 函数名称。智能体通常使用 "main" |
| directory | string | ✅ 是 | 函数代码目录，相对于 functionsRoot 。通常为 "./" |
| source | string | ✅ 是 | 函数入口文件。通常为 "index.js" |
| triggerPath | string | ✅ 是 | HTTP 触发路径。智能体通常使用 "/" |
{
"agentId": "xhs1234567890",
"name": "文档问答助手",
"version": "0.0.1",
"desc": "基于 RAG 的文档问答智能体"
}
字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| agentId | string | ✅ 是 | 智能体 ID，从开放平台创建智能体后获取 |
| name | string | ✅ 是 | 智能体名称 |
| version | string | ✅ 是 | 版本号 |
| desc | string | ✅ 是 | 部署描述信息 |