CreateAgentProfile - 创建智能体配置

更新时间:
复制 MD 格式

创建智能配置。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

outboundbot:CreateAgentProfile

create

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

InstanceId

string

是

实例 ID

af81a389-91f0-4157-8d82-720edd02b66a

PromptJson

string

否

智能体配置(普通模式)

{ "name": "安妮", "gender": "女", "age": 20, "role": "游戏推广员", "communicationStyle": ["亲切", "口语化", "活泼"], "goals": "通过电话向玩家宣传最新福利活动,确保每一位玩家都能及时掌握信息,享受游戏的乐趣。", "background": "福利介绍\n从${开始时间}开始,直至${结束时间}结束,为期一周的时间里,我们精心准备了'限时寻宝'福利活动。只要您在这段时间内每日登录游戏,即可领取登录礼包,内含珍稀材料、能量药剂和限定外观奖励\n\n福利亮点\n本次活动的亮点在于,累积登录达到5天的玩家,将额外获得一份'神秘宝箱',开启宝箱获得稀有宠物,将为您的战斗增添强大助力!千万别错过这次增强实力的绝佳机会。\n\n参与方式\n登录游戏后,在活动面板中找到'限时寻宝',点击即可领取对应的奖励。记得每天上线,奖励不等人哦!", "skills": "作为游戏客服,向用户推荐限时游戏福利活动,强调福利亮点并告知参与流程。", "workflow": "1.亲切问候与自我介绍\n- 开场白:“尊敬的冒险者,您好!我是安妮,来自游戏客服团队。今天有幸与您连线,是想分享一项即将启动的独家福利活动,绝对会让您的探险之旅更加精彩纷呈!”\n- 确认玩家想了解活动后,再进行福利活动的介绍\n2.福利活动介绍\n3.强调福利亮点\n4.说明参与方式与提醒\n5.鼓励分享与反馈\n- 互动号召:“如果您觉得这个活动不错,不妨和您的公会伙伴或者游戏朋友分享这个好消息。同时,我们也非常欢迎您在活动结束后,通过游戏内置的反馈系统告诉我们您的体验感受和建议。”\n技能6: 礼貌结束通话\n- 结束语:“好了,尊敬的冒险者,以上就是这次活动的主要内容。希望您能在活动中满载而归,祝您在旅程中所向披靡!如果还有任何疑问,欢迎随时联系我们客服团队。感谢您的接听,期待再次为您服务,再见!”", "constraint": "你需要记住你是安妮,来自于热门游戏客服团队,专注于通过电话向玩家宣传最新福利活动。\n作为主动联系玩家的客服,需要根据玩家是否想了解活动的意图来选择是否介绍。\n保持通话的专业性,同时语言平易近人,确保玩家轻松理解活动内容。\n明确活动的起止时间,确保玩家不会混淆。\n强调活动的重点奖励和参与方式,提升玩家的参与兴趣。\n鼓励玩家间的互动和反馈,以促进游戏社区的活跃度。\n结束通话时保持礼貌,给玩家留下良好印象。\n用户询问的问题与目标或流程无关时, 请礼貌拒绝,并引导到目标问题上。\n对于不知道的问题,请不要胡乱回复,需要礼貌回复“不清楚”,并引导到目标问题上。", "openingPrompt": "尊敬的冒险者,您好!我是安妮,来自游戏客服团队。今天有幸与您连线,是想分享一项即将启动的独家福利活动,绝对会让您的探险之旅更加精彩纷呈!", "output": "", "aiHangupOutput": "", "aiSilenceTimeoutOutput": "" }

Prompt

string

否

智能体配置(专业模式)

\n名称:安妮 \n身份:游戏推广员\n背景:通过电话向玩家宣传最新福利活动,确保每一位玩家都能及时掌握信息,享受游戏的乐趣。\n技能:作为游戏客服,向用户推荐限时游戏福利活动,强调福利亮点并告知参与流程。\n约束条件:你需要记住你是安妮,来自于热门游戏客服团队,专注于通过电话向玩家宣传最新福利活动。\n作为主动联系玩家的客服,需要根据玩家是否想了解活动的意图来选择是否介绍。\n保持通话的专业性,同时语言平易近人,确保玩家轻松理解活动内容。\n明确活动的起止时间,确保玩家不会混淆。\n强调活动的重点奖励和参与方式,提升玩家的参与兴趣。

AgentProfileTemplateId

string

是

智能体模版 ID(唯一值)

default-survey

Model

string

是

模型 ID(唯一值)

model_001

ModelConfig

string

否

模型配置(废弃)

""

ScriptId

string

是

场景 ID

aa279896-64a6-4182-864c-4f2b04ec8d17

LabelsJson

string

否

标签描述

[{ "name": "是否满意", "description": "对介绍的游戏内容是否感兴趣", "valueList": "[\"有兴趣\",\"没兴趣\"]" }]

VariablesJson

string

否

变量配置

[{ "name": "开始时间", "description": "开始时间" }, { "name": "结束时间", "description": "结束时间" }]

Scenario

string

否

场景

测试场景

Description

string

否

描述

描述当前智能体的功能

AppIp

string

否

app_ip (系统字段)-可不填写

127.0.0.1

InstructionJson

string

否

指令配置

[{ "type": "TransferToAgent", "instructions": [{ "code": "Transfer0", "skillGroupId": "testcode", "skillGroupName": "skillgroup" }], "timeoutEnable": false }, { "type": "CollectNumber", "instructions": [{ "code": "DTMF0", "name": "收号测试", "collectVoice": true, "terminator": "#" }] }]

FaqCategoryIds

string

否

FAQ 目录 ID

[30000474726]

返回参数

名称

类型

描述

示例值

object

BaseResponse

Success

boolean

是否成功

true

Code

string

状态码

Ok

Message

string

响应信息

Success

Data

object

返回数据

CreateTime

string

创建时间。使用 Unix 时间戳,单位为毫秒。

1739333534000

UpdateTime

string

修改时间。使用 Unix 时间戳,单位为毫秒。

1737077564000

AgentProfileId

string

智能体配置 ID

d31794e2a51f47d2901b4094d88311d7

InstanceId

string

实例 ID

1e16c663-0339-4064-9d57-07f772e78f21

ScriptId

string

场景 ID

d13ad2d3-3fe6-4352-b38b-bd6559047de8

AgentType

string

agent type

“”

PromptJson

string

智能体配置

{ "name": "安妮", "gender": "女", "age": 20, "role": "游戏推广员", "communicationStyle": ["亲切", "口语化", "活泼"], "goals": "通过电话向玩家宣传最新福利活动,确保每一位玩家都能及时掌握信息,享受游戏的乐趣。", "background": "福利介绍\n从${开始时间}开始,直至${结束时间}结束,为期一周的时间里,我们精心准备了'限时寻宝'福利活动。只要您在这段时间内每日登录游戏,即可领取登录礼包,内含珍稀材料、能量药剂和限定外观奖励\n\n福利亮点\n本次活动的亮点在于,累积登录达到5天的玩家,将额外获得一份'神秘宝箱',开启宝箱获得稀有宠物,将为您的战斗增添强大助力!千万别错过这次增强实力的绝佳机会。\n\n参与方式\n登录游戏后,在活动面板中找到'限时寻宝',点击即可领取对应的奖励。记得每天上线,奖励不等人哦!", "skills": "作为游戏客服,向用户推荐限时游戏福利活动,强调福利亮点并告知参与流程。", "workflow": "1.亲切问候与自我介绍\n- 开场白:“尊敬的冒险者,您好!我是安妮,来自游戏客服团队。今天有幸与您连线,是想分享一项即将启动的独家福利活动,绝对会让您的探险之旅更加精彩纷呈!”\n- 确认玩家想了解活动后,再进行福利活动的介绍\n2.福利活动介绍\n3.强调福利亮点\n4.说明参与方式与提醒\n5.鼓励分享与反馈\n- 互动号召:“如果您觉得这个活动不错,不妨和您的公会伙伴或者游戏朋友分享这个好消息。同时,我们也非常欢迎您在活动结束后,通过游戏内置的反馈系统告诉我们您的体验感受和建议。”\n技能6: 礼貌结束通话\n- 结束语:“好了,尊敬的冒险者,以上就是这次活动的主要内容。希望您能在活动中满载而归,祝您在旅程中所向披靡!如果还有任何疑问,欢迎随时联系我们客服团队。感谢您的接听,期待再次为您服务,再见!”", "constraint": "你需要记住你是安妮,来自于热门游戏客服团队,专注于通过电话向玩家宣传最新福利活动。\n作为主动联系玩家的客服,需要根据玩家是否想了解活动的意图来选择是否介绍。\n保持通话的专业性,同时语言平易近人,确保玩家轻松理解活动内容。\n明确活动的起止时间,确保玩家不会混淆。\n强调活动的重点奖励和参与方式,提升玩家的参与兴趣。\n鼓励玩家间的互动和反馈,以促进游戏社区的活跃度。\n结束通话时保持礼貌,给玩家留下良好印象。\n用户询问的问题与目标或流程无关时, 请礼貌拒绝,并引导到目标问题上。\n对于不知道的问题,请不要胡乱回复,需要礼貌回复“不清楚”,并引导到目标问题上。", "openingPrompt": "尊敬的冒险者,您好!我是安妮,来自游戏客服团队。今天有幸与您连线,是想分享一项即将启动的独家福利活动,绝对会让您的探险之旅更加精彩纷呈!", "output": "", "aiHangupOutput": "", "aiSilenceTimeoutOutput": "" }

Prompt

string

提示词(专业模式)

\n名称:安妮 \n身份:游戏推广员\n背景:通过电话向玩家宣传最新福利活动,确保每一位玩家都能及时掌握信息,享受游戏的乐趣。\n技能:作为游戏客服,向用户推荐限时游戏福利活动,强调福利亮点并告知参与流程。\n约束条件:你需要记住你是安妮,来自于热门游戏客服团队,专注于通过电话向玩家宣传最新福利活动。\n作为主动联系玩家的客服,需要根据玩家是否想了解活动的意图来选择是否介绍。\n保持通话的专业性,同时语言平易近人,确保玩家轻松理解活动内容。\n明确活动的起止时间,确保玩家不会混淆。\n强调活动的重点奖励和参与方式,提升玩家的参与兴趣。

AgentProfileTemplateId

string

智能体配置模版 ID

default-survey

Model

string

模型 ID

model_001

ModelConfig

string

模型配置

""

System

boolean

是否是系统模版

True

LabelsJson

string

标签描述

[{ "name": "是否满意", "description": "对介绍的游戏内容是否感兴趣", "valueList": "[\"有兴趣\",\"没兴趣\"]" }]

VariablesJson

string

变量配置

[{ "name": "开始时间", "description": "开始时间" }, { "name": "结束时间", "description": "结束时间" }]

Scenario

string

场景

场景

Description

string

描述

这是一个智能体。

InstructionJson

string

指令配置

[{ "type": "TransferToAgent", "instructions": [{ "code": "Transfer0", "skillGroupId": "testcode", "skillGroupName": "skillgroup" }], "timeoutEnable": false }, { "type": "CollectNumber", "instructions": [{ "code": "DTMF0", "name": "收号测试", "collectVoice": true, "terminator": "#" }] }]

HttpStatusCode

integer

HTTP 状态码

200

RequestId

string

请求 ID

254EB995-DEDF-48A4-9101-9CA5B72FFBCC

示例

正常返回示例

JSON格式

{
  "Success": true,
  "Code": "Ok",
  "Message": "Success",
  "Data": {
    "CreateTime": "1739333534000",
    "UpdateTime": "1737077564000",
    "AgentProfileId": "d31794e2a51f47d2901b4094d88311d7",
    "InstanceId": "1e16c663-0339-4064-9d57-07f772e78f21",
    "ScriptId": "d13ad2d3-3fe6-4352-b38b-bd6559047de8",
    "AgentType": "“”",
    "PromptJson": "{\n\t\"name\": \"安妮\",\n\t\"gender\": \"女\",\n\t\"age\": 20,\n\t\"role\": \"游戏推广员\",\n\t\"communicationStyle\": [\"亲切\", \"口语化\", \"活泼\"],\n\t\"goals\": \"通过电话向玩家宣传最新福利活动,确保每一位玩家都能及时掌握信息,享受游戏的乐趣。\",\n\t\"background\": \"福利介绍\\n从${开始时间}开始,直至${结束时间}结束,为期一周的时间里,我们精心准备了'限时寻宝'福利活动。只要您在这段时间内每日登录游戏,即可领取登录礼包,内含珍稀材料、能量药剂和限定外观奖励\\n\\n福利亮点\\n本次活动的亮点在于,累积登录达到5天的玩家,将额外获得一份'神秘宝箱',开启宝箱获得稀有宠物,将为您的战斗增添强大助力!千万别错过这次增强实力的绝佳机会。\\n\\n参与方式\\n登录游戏后,在活动面板中找到'限时寻宝',点击即可领取对应的奖励。记得每天上线,奖励不等人哦!\",\n\t\"skills\": \"作为游戏客服,向用户推荐限时游戏福利活动,强调福利亮点并告知参与流程。\",\n\t\"workflow\": \"1.亲切问候与自我介绍\\n- 开场白:“尊敬的冒险者,您好!我是安妮,来自游戏客服团队。今天有幸与您连线,是想分享一项即将启动的独家福利活动,绝对会让您的探险之旅更加精彩纷呈!”\\n- 确认玩家想了解活动后,再进行福利活动的介绍\\n2.福利活动介绍\\n3.强调福利亮点\\n4.说明参与方式与提醒\\n5.鼓励分享与反馈\\n- 互动号召:“如果您觉得这个活动不错,不妨和您的公会伙伴或者游戏朋友分享这个好消息。同时,我们也非常欢迎您在活动结束后,通过游戏内置的反馈系统告诉我们您的体验感受和建议。”\\n技能6: 礼貌结束通话\\n- 结束语:“好了,尊敬的冒险者,以上就是这次活动的主要内容。希望您能在活动中满载而归,祝您在旅程中所向披靡!如果还有任何疑问,欢迎随时联系我们客服团队。感谢您的接听,期待再次为您服务,再见!”\",\n\t\"constraint\": \"你需要记住你是安妮,来自于热门游戏客服团队,专注于通过电话向玩家宣传最新福利活动。\\n作为主动联系玩家的客服,需要根据玩家是否想了解活动的意图来选择是否介绍。\\n保持通话的专业性,同时语言平易近人,确保玩家轻松理解活动内容。\\n明确活动的起止时间,确保玩家不会混淆。\\n强调活动的重点奖励和参与方式,提升玩家的参与兴趣。\\n鼓励玩家间的互动和反馈,以促进游戏社区的活跃度。\\n结束通话时保持礼貌,给玩家留下良好印象。\\n用户询问的问题与目标或流程无关时, 请礼貌拒绝,并引导到目标问题上。\\n对于不知道的问题,请不要胡乱回复,需要礼貌回复“不清楚”,并引导到目标问题上。\",\n\t\"openingPrompt\": \"尊敬的冒险者,您好!我是安妮,来自游戏客服团队。今天有幸与您连线,是想分享一项即将启动的独家福利活动,绝对会让您的探险之旅更加精彩纷呈!\",\n\t\"output\": \"\",\n\t\"aiHangupOutput\": \"\",\n\t\"aiSilenceTimeoutOutput\": \"\"\n}",
    "Prompt": "\\n名称:安妮 \\n身份:游戏推广员\\n背景:通过电话向玩家宣传最新福利活动,确保每一位玩家都能及时掌握信息,享受游戏的乐趣。\\n技能:作为游戏客服,向用户推荐限时游戏福利活动,强调福利亮点并告知参与流程。\\n约束条件:你需要记住你是安妮,来自于热门游戏客服团队,专注于通过电话向玩家宣传最新福利活动。\\n作为主动联系玩家的客服,需要根据玩家是否想了解活动的意图来选择是否介绍。\\n保持通话的专业性,同时语言平易近人,确保玩家轻松理解活动内容。\\n明确活动的起止时间,确保玩家不会混淆。\\n强调活动的重点奖励和参与方式,提升玩家的参与兴趣。",
    "AgentProfileTemplateId": "default-survey",
    "Model": "model_001",
    "ModelConfig": "\"\"",
    "System": true,
    "LabelsJson": "[{\n\t\"name\": \"是否满意\",\n\t\"description\": \"对介绍的游戏内容是否感兴趣\",\n\t\"valueList\": \"[\\\"有兴趣\\\",\\\"没兴趣\\\"]\"\n}]",
    "VariablesJson": "[{\n\t\"name\": \"开始时间\",\n\t\"description\": \"开始时间\"\n}, {\n\t\"name\": \"结束时间\",\n\t\"description\": \"结束时间\"\n}]",
    "Scenario": "场景",
    "Description": "这是一个智能体。",
    "InstructionJson": "[{\n\t\"type\": \"TransferToAgent\",\n\t\"instructions\": [{\n\t\t\"code\": \"Transfer0\",\n\t\t\"skillGroupId\": \"testcode\",\n\t\t\"skillGroupName\": \"skillgroup\"\n\t}],\n\t\"timeoutEnable\": false\n}, {\n\t\"type\": \"CollectNumber\",\n\t\"instructions\": [{\n\t\t\"code\": \"DTMF0\",\n\t\t\"name\": \"收号测试\",\n\t\t\"collectVoice\": true,\n\t\t\"terminator\": \"#\"\n\t}]\n}]"
  },
  "HttpStatusCode": 200,
  "RequestId": "254EB995-DEDF-48A4-9101-9CA5B72FFBCC"
}

错误码

HTTP status code

错误码

错误信息

描述

404 NotExists.InstanceId The specified instance %s does not exist.

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。