创建智能体
AgentCreate 创建Agent
请求URL
POST /api/v1/agent/create
请求参数
| 参数 |
取值 |
说明 |
| Content-Type |
application/json |
指定请求正文的数据格式。当值为 application/json 时,表明请求体(Body)内容以 JSON 格式组织,服务端将按 JSON 规范解析请求参数。 |
| X-TraceId |
string |
traceId |
| Authorization |
Bearer $AccessToken |
用于验证客户端身份的访问令牌 |
Body
| 参数 |
类型 |
是否必填 |
参数说明 |
备注 |
| name |
string |
是 |
agent名称 |
"TestAgent" |
| intro |
string |
是 |
agent说明 |
"Test agent" |
| memory |
map[string]json struct |
是 |
记忆列表 |
{"mem1": {"name": "Memory1", "description": "Description for Memory1", "default": "Default Value1"}} |
| learn |
map[string]json struct |
是 |
知识库列表 |
{"learn1": {}} |
| config.prologue |
string |
否 |
开场白 |
"Hello, I am your agent." |
| config.recommendation_question |
[]string |
否 |
推荐问题列表 |
["What is your name?", "How can I assist you?"] |
| config.voice |
string |
否 |
声音ID |
"voice_id_001" |
| config.figure |
string |
否 |
形象ID |
"figure_id_001" |
| config.tools |
map[string]json struct |
否 |
工具列表 |
{"tool1": {"version": "1.1", "running_config": {"k1": "v1"}}} |
| config.workflow_id |
string |
否 |
绑定的工作流ID |
"workflow_001" |
| config.character_profile |
string |
否 |
人设 |
"friendly" |
| config.type |
string |
否 |
智能体类型 |
"workflow"--工作流智能体 "independent_planning" -- 自主规划 "device_workflow" -- 设备工作流 |
| config.model |
string |
否 |
模型名称 |
"example_model" |
可选的形象和音色:
| 形象id |
渲染引擎 |
| avatar_2d_real_boy_1 |
LiveTalking |
| avatar_2d_real_boy_2 |
LiveTalking |
| avatar_2d_real_boy_3 |
LiveTalking |
| avatar_2d_real_boy_4 |
LiveTalking |
| avatar_2d_real_boy_5 |
LiveTalking |
| avatar_2d_real_girl_1 |
LiveTalking |
| avatar_2d_real_girl_2 |
LiveTalking |
| avatar_2d_real_girl_3 |
LiveTalking |
| avatar_2d_real_girl_4 |
LiveTalking |
| avatar_2d_real_girl_5 |
LiveTalking |
| avatar_2d_real_man_1 |
LiveTalking |
| avatar_2d_real_man_2 |
LiveTalking |
| avatar_2d_real_man_3 |
LiveTalking |
| avatar_2d_real_man_4 |
LiveTalking |
| avatar_2d_real_man_5 |
LiveTalking |
| avatar_2d_real_man_6 |
LiveTalking |
| avatar_2d_real_man_7 |
LiveTalking |
| avatar_2d_real_man_8 |
LiveTalking |
| avatar_2d_real_man_9 |
LiveTalking |
| avatar_2d_real_man_10 |
LiveTalking |
| avatar_2d_real_woman_1 |
LiveTalking |
| avatar_2d_real_woman_2 |
LiveTalking |
| avatar_2d_real_woman_3 |
LiveTalking |
| avatar_2d_real_woman_4 |
LiveTalking |
| avatar_2d_real_woman_5 |
LiveTalking |
| avatar_2d_real_woman_6 |
LiveTalking |
| avatar_2d_real_woman_7 |
LiveTalking |
| avatar_2d_real_woman_8 |
LiveTalking |
| avatar_2d_real_woman_9 |
LiveTalking |
| avatar_2d_real_woman_10 |
LiveTalking |
| avatar_3d_virtual_tongtong |
UE |
| avatar_3d_virtual_father |
UE |
| avatar_3d_virtual_mother |
UE |
| avatar_3d_virtual_grandpa |
UE |
| avatar_3d_virtual_grandma |
UE |
| 音色id |
性别 |
| 通通 |
女 |
| 董老师 |
女 |
| lady_1 |
女 |
| lady_2 |
女 |
| lady_3 |
女 |
| lady_4 |
女 |
| lady_5 |
女 |
| lady_6 |
女 |
| lady_7 |
女 |
| man_1 |
男 |
| man_2 |
男 |
| man_3 |
男 |
| man_4 |
男 |
| boy_1 |
男 |
| boy_2 |
男 |
| girl_1 |
女 |
| girl_2 |
女 |
请求示例
{
"name": "TestAgent",
"intro": "Test agent",
"memory": {
"mem1": {
"name": "Memory1",
"description": "Description for Memory1",
"default": "Default Value1"
}
},
"learn": {
"learn1": {}
},
"config": {
"prologue": "Hello, I am your agent.",
"recommendation_question": [
"What is your name?",
"How can I assist you?"
],
"voice": "voice_id_001",
"figure": "figure_id_001",
"tools": {
"tool1": {
"version": "1.1",
"running_config": {
"k1": "v1"
}
}
},
"workflow_id": "workflow_001",
"character_profile": "friendly",
"type": "workflow",
"model": "example_model"
}
}
响应参数
| 参数 |
类型 |
描述 |
备注 |
| code |
int |
状态码 |
|
| message |
string |
agent ID或者错误信息 |
|
响应示例
{
"code": 0,
"message": "agent_id"
}