跳转至

创建智能体

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"
}