CreateAgentProfile-阿里云帮助中心

You can create an intelligent configuration.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

outboundbot:CreateAgentProfile

create

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	Instance ID	af81a389-91f0-4157-8d82-720edd02b66a
PromptJson	string	No	Agent configuration in Normal mode	{ "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	No	Agent configuration (professional mode)	\n名称：安妮 \n身份：游戏推广员\n背景：通过电话向玩家宣传最新福利活动，确保每一位玩家都能及时掌握信息，享受游戏的乐趣。\n技能：作为游戏客服，向用户推荐限时游戏福利活动，强调福利亮点并告知参与流程。\n约束条件：你需要记住你是安妮，来自于热门游戏客服团队，专注于通过电话向玩家宣传最新福利活动。\n作为主动联系玩家的客服，需要根据玩家是否想了解活动的意图来选择是否介绍。\n保持通话的专业性，同时语言平易近人，确保玩家轻松理解活动内容。\n明确活动的起止时间，确保玩家不会混淆。\n强调活动的重点奖励和参与方式，提升玩家的参与兴趣。
AgentProfileTemplateId	string	Yes	Agent profile template ID (unique value)	default-survey
Model	string	Yes	Model ID (unique value)	model_001
ModelConfig	string	No	Model configuration (deprecated)	""
ScriptId	string	Yes	Scenario ID	aa279896-64a6-4182-864c-4f2b04ec8d17
LabelsJson	string	No	Label description	[{ "name": "是否满意", "description": "对介绍的游戏内容是否感兴趣", "valueList": "[\"有兴趣\",\"没兴趣\"]" }]
VariablesJson	string	No	Variable configuration	[{ "name": "开始时间", "description": "开始时间" }, { "name": "结束时间", "description": "结束时间" }]
Scenario	string	No	Scenario	测试场景
Description	string	No	Description	描述当前智能体的功能
AppIp	string	No	app_ip (system field) — optional	127.0.0.1
InstructionJson	string	No	Instruction configuration	[{ "type": "TransferToAgent", "instructions": [{ "code": "Transfer0", "skillGroupId": "testcode", "skillGroupName": "skillgroup" }], "timeoutEnable": false }, { "type": "CollectNumber", "instructions": [{ "code": "DTMF0", "name": "收号测试", "collectVoice": true, "terminator": "#" }] }]
FaqCategoryIds	string	No	FAQ folder ID	[30000474726]

Response elements

Element	Type	Description	Example
	object	BaseResponse
Success	boolean	Indicates whether the request succeeded	true
Code	string	Status code	Ok
Message	string	Response message	Success
Data	object	Response data
CreateTime	string	Creation time	1739333534000
UpdateTime	string	Last update time	1737077564000
AgentProfileId	string	Agent profile ID	d31794e2a51f47d2901b4094d88311d7
InstanceId	string	Instance ID	1e16c663-0339-4064-9d57-07f772e78f21
ScriptId	string	Scenario ID	d13ad2d3-3fe6-4352-b38b-bd6559047de8
AgentType	string	Agent type	“”
PromptJson	string	Agent configuration	{ "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	Prompt (professional mode)	\n名称：安妮 \n身份：游戏推广员\n背景：通过电话向玩家宣传最新福利活动，确保每一位玩家都能及时掌握信息，享受游戏的乐趣。\n技能：作为游戏客服，向用户推荐限时游戏福利活动，强调福利亮点并告知参与流程。\n约束条件：你需要记住你是安妮，来自于热门游戏客服团队，专注于通过电话向玩家宣传最新福利活动。\n作为主动联系玩家的客服，需要根据玩家是否想了解活动的意图来选择是否介绍。\n保持通话的专业性，同时语言平易近人，确保玩家轻松理解活动内容。\n明确活动的起止时间，确保玩家不会混淆。\n强调活动的重点奖励和参与方式，提升玩家的参与兴趣。
AgentProfileTemplateId	string	Agent profile template ID	default-survey
Model	string	Model ID	model_001
ModelConfig	string	Model configuration	""
System	boolean	Indicates whether this is a system template	True
LabelsJson	string	Label description	[{ "name": "是否满意", "description": "对介绍的游戏内容是否感兴趣", "valueList": "[\"有兴趣\",\"没兴趣\"]" }]
VariablesJson	string	Variable configuration	[{ "name": "开始时间", "description": "开始时间" }, { "name": "结束时间", "description": "结束时间" }]
Scenario	string	Scenario	场景
Description	string	Description	这是一个智能体。
InstructionJson	string	Instruction configuration	[{ "type": "TransferToAgent", "instructions": [{ "code": "Transfer0", "skillGroupId": "testcode", "skillGroupName": "skillgroup" }], "timeoutEnable": false }, { "type": "CollectNumber", "instructions": [{ "code": "DTMF0", "name": "收号测试", "collectVoice": true, "terminator": "#" }] }]
HttpStatusCode	integer	HTTP status code	200
RequestId	string	Request ID	254EB995-DEDF-48A4-9101-9CA5B72FFBCC

Examples

Success response

JSON format

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

Error codes

HTTP status code	Error code	Error message	Description
404	NotExists.InstanceId	The specified instance %s does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.