检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 AppStage接口的分类与说明如表1所示。 表1 API概览 类型 说明 文本对话 文本对话类模型服务调用。 文本向量化 文本向量化类模型服务调用。 调用知识检索流 调用用户配置的知识检索流。 调用流 调用用户配置的工作流。 调用Agent 调用用户发布的Agent。
API 模型调用 应用中心 知识中心
如何调用API 构造请求 认证鉴权 返回结果
新增平台API Key API Key是每个用户单独的身份认证，是个人调用应用接口的依据，必须妥善保管。租户开发的Agent在调用平台接口时需要进行平台鉴权认证，可以使用“平台API Key”进行平台的鉴权认证。 背景信息 对于华为或者第三方运营的商业化模型服务，支持通过API接入到
是否必选 参数类型 描述 Authorization 是 String 鉴权信息，填写WiseAgent注册的api key，本接口只需要此鉴权信息，不需要使用公共请求头中的鉴权方式。 h-user-id 是 String 用户ID。 h-dept-code 是 String 部门code。
状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于文本对话接口，如果调用后返回状态码为“200”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消
息头之外的内容。如果请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于文本对话接口，您可以从
{ } } API Key认证 API Key全称为应用程序接口密钥，是一种用于验证和授权API请求的代码。它通常是一串字符，用于识别调用API的应用程序和开发者。 获取API Key 以管理员身份登录AI原生应用引擎工作台，参考创建API Key获取。 使用API Key鉴权
为workflow，代表调用workflow的返回，返回内容在response下的data下的responseBody中。后续非message的返回同理，先返回hint提示调用类型，再返回真正的响应。最后的message类型是大模型的响应。 { "hint_data" : {
AI原生应用引擎鉴权API Key。 1.以管理员身份登录AI原生应用引擎工作台，在左侧导航栏选择“系统管理 > 平台租户鉴权”。 2.在“平台租户鉴权”页面，选择“平台API Key”页签，单击“新增平台API Key”。 3.在“新增平台API Key”对话框中的输入框设置API Key名称，用以区分API
鉴权信息，填写WiseAgent注册的api key，本接口只需要此鉴权信息，不需要使用公共请求头中的鉴权方式。 表3 请求Body参数 参数 是否必选 参数类型 描述 body 否 Object 调用技能请求体，与技能配置相关。结构与技能的请求体配置相同，并且所有请求头中的入参与请求参数均添加
按照用户配置的工作流请求参数配置，如果用户配置的工作流输入存在查询参数，则应该配置对应的参数并在调用时输入特定的值。 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 authorization 是 String 鉴权信息，填写WiseAgent注册的api key
AI原生应用引擎鉴权API Key。 1.以管理员身份登录AI原生应用引擎工作台，在左侧导航栏选择“系统管理 > 平台租户鉴权”。 2.在“平台租户鉴权”页面，选择“平台API Key”页签，单击“新增平台API Key”。 3.在“新增平台API Key”对话框中的输入框设置API Key名称，用以区分API
key，本接口只需要此鉴权信息，不需要使用公共请求头中的鉴权方式。 header_example 否 String 按照用户配置的知识检索流请求头参数配置，如果用户配置的知识检索流输入存在请求头输入，则应该配置对应的参数并在调用时输入特定的值。 表4 请求Body参数 参数 是否必选
应用中心 调用知识检索流 调用流 调用技能 文件盒子 调用Agent 父主题： API
模型调用 文本对话 文本向量化 父主题： API
知识中心 检索知识库数据 父主题： API
检索知识库数据 功能介绍 检索知识库数据，根据用户提供的检索信息，返回命中的信息数据。 URI POST https://aiae.appstage.myhuaweicloud.com/v1/knowledge-bases/{knowledge_base_id}/embed-datas
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 200 AIAE.22001001 API调用异常 API调用异常 调用接口url、请求方式错误或出现访问其他用户资源的越权问题，请检查后重试
工作流 任务流程的细化分解是一种有效策略，能够简化系统架构，并降低对大语言模型能力的过度依赖。通过将繁复的工作拆解为一系列独立节点，不仅增强了复杂任务处理的效率，还在很大程度上提升了整个系统的透明度、鲁棒性和错误容忍度。这种方法使得LLM的应用范围得以扩大，即便面对高度复杂的任务也能表现出色。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
