j9九游会登录/ 应用平台 appstage/ api参考/ / / 创建agent（token认证）

更新时间：2025-08-04 gmt 08:00

创建agent（token认证）-j9九游会登录

功能介绍

创建一个新的智能体。调用此接口创建一个智能体后，此智能体为未发布的草稿状态，创建后可以在versatile智能体列表中查看智能体。

调用发布智能体接口发布智能体后，才能通过查看智能体列表或获取智能体配置接口查看此智能体。

通过api方式创建智能体时，支持为智能体设置所在空间、智能体名称和描述、头像、人设与回复逻辑及开场白。

调用方法

请参见。

uri

post https://aiae.appstage.myhuaweicloud.com/v1/routes/open/user/agent

请求参数

表1 请求header参数
参数	是否必选	参数类型	描述
x-auth-token	是	string	参数解释：鉴权信息。通过调用iam服务获取用户token（响应消息头中x-subject-token的值）。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

表2 请求body参数
参数	是否必选	参数类型	描述
region	是	string	资产所属的地区。
tags	否	array of strings	参数解释：描述资产的标签（键值对列表形式）。标签名称不能包含：< > * / %& : \ ? / 以及任何控制字符。每个资产最多关联15 个标签，每个标签的key不超过 512 个字符，value不超过 256 个字符。对于“label”字段，建议ap不要将其作为单独的属性，而是利用这些标签做分组。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
properties	是	object	参数解释：用户自定义属性，用于配置或描述资产，比如可以有资产名称属性（name）。请求中参数的顺序未指定，建议蛇形命名。包含了资产配置模板的参数以及ap自定义的内容。约束限制： name: 由1~20字符组成，包含中文、字母、数字和下划线。不能以数字或下划线开头。同一租户下名称不能重复。 description：少于200字符。 knowledgesetting：可以为空，但必须少于5000字符。 instructions：少于4000字符。 prologue：少于200字符。 agentworktype：支持agent_llm、agent_single_workflow、agent_operator。 filebox：当“agentworktype”值为“agent_llm”时，才支持文件盒子。其他类型，则为空。取值范围：不涉及。默认取值：不涉及。

响应参数

状态码：200

表3 响应body参数
参数	参数类型	描述
region	string	资产所属的地区。
tags	array of strings	参数解释：描述资产的标签（键值对列表形式）。标签名称不能包含：< > * / %& : \ ? / 以及任何控制字符。每个资产最多关联15 个标签，每个标签的key不超过 512 个字符，value不超过 256 个字符。对于“label”字段，建议ap不要将其作为单独的属性，而是利用这些标签做分组。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
properties	object	参数解释：用户自定义属性，用于配置或描述资产，比如可以有资产名称属性（name）。请求中参数的顺序未指定，建议蛇形命名。包含了资产配置模板的参数以及ap自定义的内容。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

状态码：400

表4 响应body参数
参数	参数类型	描述
error_code	string	参数解释：错误码。取值范围：不涉及。
error_msg	string	参数解释：错误信息。取值范围：不涉及。

状态码：500

表5 响应body参数
参数	参数类型	描述
error_code	string	参数解释：错误码。取值范围：不涉及。
error_msg	string	参数解释：错误信息。取值范围：不涉及。

请求示例

https://xxx.x.x.x:xxxx/v1/routes/open/user/agent
{
  "region" : "cn-north-5",
  "tags" : [ ],
  "properties" : {
    "instructions" : "**角色定义**:
作为java专家，我精通java编程语言及各种设计模式的应用，能够为复杂问题提供优雅的j9九游会登录的解决方案。我的任务是针对特定问题场景，选择合适的设计模式，并运用java语言实现高效、可维护的代码。

**工具能力**:
1. 设计模式理解与应用：我能深入理解并应用诸如单例模式、工厂模式、观察者模式等在内的多种设计模式。
2. java编程：我具备扎实的java编程基础，能够使用java语言实现设计模式，并确保代码的优化和性能。
3. 代码审查与重构：我能够对现有代码进行审查，识别设计上的不足，并进行重构以提升代码质量。

**要求与限制**:
1. 代码规范性：编写的java代码必须遵循标准的编码规范，确保代码的可读性和可维护性。
2. 设计模式适用性：选择的设计模式必须适合问题的实际场景，避免过度设计或设计模式误用。
3. 性能优化：在实现设计模式时，必须考虑代码的性能，避免因设计模式的使用而造成性能瓶颈。",
    "variable_settings" : "{\"content\":[]}",
    "qa_model_id" : "",
    "rag_flows" : [ ],
    "description" : "你是一个java专家，熟悉java各种设计模式",
    "qa_model_setting" : "{\"frequency_penalty\":0.0,\"max_tokens\":2048,\"presence_penalty\":0.0,\"temperature\":0.3,\"top_p\":0.3}",
    "type" : 1,
    "tools" : [ ],
    "isenable" : false,
    "data_sets" : [ ],
    "agent_uri" : null,
    "flows" : [ ],
    "model_setting" : "{\"frequency_penalty\":0.0,\"max_tokens\":2048,\"presence_penalty\":0.0,\"temperature\":0.3,\"top_p\":0.3}",
    "logo" : "",
    "knowledge_setting" : "{\"call_method\":\"auto\",\"knowledge_prompt\":\"\",\"maximum_recalls\":3,\"prompt_conf\":\"custom\",\"retrieval_method\":\"full-text\",\"similarity_min\":0.7}",
    "workflow_settings" : "{\"call_method\":\"summary\"}",
    "prologue" : "",
    "mcp_servers" : null,
    "file_box" : "{\"is_open\":false}",
    "agent_work_type" : "agent_llm",
    "model_id" : "publisher:zhipu:glm-4",
    "asset_status" : "0",
    "suggest_query" : [ "" ],
    "web_uri" : null,
    "audio_settings" : "{\"audio_input\":\"false\",\"audio_output\":\"false\"}",
    "api_key" : null,
    "name" : "大话设计模式",
    "fragment_memory_settings" : "{\"auto_update\":true,\"enable\":false}"
  }
}

响应示例

状态码：200

请求响应成功。

{
  "region" : "cn-north-5",
  "tags" : [ ],
  "properties" : {
    "instructions" : "**角色定义**:
作为java专家，我精通java编程语言及各种设计模式的应用，能够为复杂问题提供优雅的j9九游会登录的解决方案。我的任务是针对特定问题场景，选择合适的设计模式，并运用java语言实现高效、可维护的代码。

**工具能力**:
1. 设计模式理解与应用：我能深入理解并应用诸如单例模式、工厂模式、观察者模式等在内的多种设计模式。
2. java编程：我具备扎实的java编程基础，能够使用java语言实现设计模式，并确保代码的优化和性能。
3. 代码审查与重构：我能够对现有代码进行审查，识别设计上的不足，并进行重构以提升代码质量。

**要求与限制**:
1. 代码规范性：编写的java代码必须遵循标准的编码规范，确保代码的可读性和可维护性。
2. 设计模式适用性：选择的设计模式必须适合问题的实际场景，避免过度设计或设计模式误用。
3. 性能优化：在实现设计模式时，必须考虑代码的性能，避免因设计模式的使用而造成性能瓶颈。",
    "variable_settings" : "{\"content\":[]}",
    "qa_model_id" : "",
    "rag_flows" : [ ],
    "description" : "你是一个java专家，熟悉java各种设计模式",
    "qa_model_setting" : "{\"frequency_penalty\":0.0,\"max_tokens\":2048,\"presence_penalty\":0.0,\"temperature\":0.3,\"top_p\":0.3}",
    "type" : 1,
    "tools" : [ ],
    "isenable" : false,
    "data_sets" : [ ],
    "agent_uri" : null,
    "flows" : [ ],
    "model_setting" : "{\"frequency_penalty\":0.0,\"max_tokens\":2048,\"presence_penalty\":0.0,\"temperature\":0.3,\"top_p\":0.3}",
    "logo" : "",
    "knowledge_setting" : "{\"call_method\":\"auto\",\"knowledge_prompt\":\"\",\"maximum_recalls\":3,\"prompt_conf\":\"custom\",\"retrieval_method\":\"full-text\",\"similarity_min\":0.7}",
    "workflow_settings" : "{\"call_method\":\"summary\"}",
    "id" : "1945302373868744706",
    "prologue" : "",
    "mcp_servers" : null,
    "file_box" : "{\"is_open\":false}",
    "agent_work_type" : "agent_llm",
    "model_id" : "publisher:zhipu:glm-4",
    "asset_status" : "0",
    "suggest_query" : [ "" ],
    "web_uri" : null,
    "audio_settings" : "{\"audio_input\":\"false\",\"audio_output\":\"false\"}",
    "api_key" : null,
    "name" : "大话设计模式",
    "fragment_memory_settings" : "{\"auto_update\":true,\"enable\":false}"
  }
}

状态码：400

缺少请求体。

{
  "error_code" : "aiae.00001400",
  "error_msg" : "request body is missing"
}

状态码：500

服务器内部错误或三方服务器内部错误。

{
  "error_code" : "aiae.00001500",
  "error_msg" : "internal server error."
}

状态码

状态码	描述
200	请求响应成功。
400	缺少请求体。
500	服务器内部错误或三方服务器内部错误。

错误码

请参见错误码。

父主题：

上一篇：分页查询agent调用情况

下一篇：更新agent（token认证）

意见反馈

文档内容是否对您有帮助？

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨