Skip to content

本文将为您介绍如何以自定义服务接入的方式来创建智能体。

定义智能体基础信息

通过 JSON 格式对智能体基础信息进行定义,包括以下信息:

  • 智能体的基本信息。

  • 智能体的服务访问地址

  • 智能体的模型配置。

  • 智能体的命令列表。

说明:

在创建自定义服务接入的智能体前需要定义智能体的域名,例如:"endpoint": "http://localhost:18080"。

定义智能体基础信息的示例如下:

javascript
{
    "name": "happy",    // Agent 的名称,可使用[a-zA-Z-_中文],客户端看到的 @happy
    "version": "1.0.0",    // 版本
    "type": "proxy",    // 类型,当前固定为 proxy
    "description": "happy",    // 描述信息
    "publisherType": "enterprise",    // 发布者类型,企业用户固定为 enterprise,个人 agent 为 user
    "publisher": "",    // 发布者名称
    "service": { 
      "endpoint": "http://localhost:18080"  // 服务地址
    },
    "modelConfiguration": { 
        "modelName": "hunyuan",    // 模型名称,当前仅作为配置使用,如 Agent 访问私有模型,则忽略此配置
    },
    "commands": [    // 命令列表
        {
            "name": "default",    // 指令名称。default 为必须的默认指令,当客户端不指定指令时,默认发送此指令
            "description": "happy",    // 指令描述
            "modelConfiguration": { "modelName": "hunyuan" },    // 指令模型配置
            "messageTemplates"?: [    // 指令消息模板列表,用于在服务内部处理生成 prompt 时,作为预置模板使用
                  {
                  role : "system",
                  template : '你是一个世界级程序员'
                }
            ],
            "contextVariableCollectionStrategy": { // 指令所需上下文变量
                "type": "specify",    // 收集策略,当前固定为 specify
                "contextVariables": [    // 上下文列表
                    {
                        "name": "userInfo",        // 上下文变量名称
                        "resolveOptions": {}    //上下文采集策略
                    },
                    {
                        "name": "vcs"
                    },
                    {
                        "name": "activeEditdor"
                    },
                    {
                        "name": "knowledgeBase"
                    }
                ]
            }
        },
        {
            "name": "version",
            "description": "获取版本信息",
            "contextVariableCollectionStrategy": {
                "type": "specify",
                "contextVariables": [
                    {
                        "name": "userInfo"
                    }
                ]
            }
        }
    ]
}

创建智能体

1.登录 企业后台管理 端,选择智能体,然后单击新建智能体

  1. 填写智能体信息,类型选择自定义服务接入

    填写智能体相关信息如下:

  • 智能体名称:智能体的名称。

注意:智能体的名称不能重复,包括不能与代码助手内自带的智能体名称重复,以及不能与企业内的智能体名称重名。

  • 智能体描述:智能体的描述,可展示在本地 IDE 中。

  • 服务地址:填入定义好的服务访问地址。

  • 上下文:可选择添加知识库,功能启用后,调用指令即可关联知识库。

  • 触发区:默认仅在聊天区触发。

  • 可见范围:可以设定成员的使用权限,包括企业内所有成员部分成员。当选择部分成员可见时,可直接单击添加成员按钮去进行添加,支持全选和根据 ID、姓名、账号进行输入搜索选择,如下图所示。

3.填写信息完成后,单击保存,例如:

4.智能体创建完成后,默认已经启用智能体。

5.启用智能体后,打开本地 IDE 即可查看。

说明:

建议重启一下 IDE。

后续步骤

接下来,您还需要配置智能体,比如需要配置上下文变量及交互动作等,配置完成后才算真正地完成,详情请参见 配置智能体