检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
更新知识库 操作场景 本文通过调用一系列知识中心的API介绍知识库的更新流程，适用于当数据源为OBS接入时，在OBS上进行文件增删改后，将改动同步到知识库的场景。API调用方法请参见如何调用API。 前提条件 用户接入的OBS目录下，存在文件的增删改其中一种情况。 需获取待更新数据集的
HttpxClient 实例化 表1 实例化参数 参数名 参数类型 是否必选 参数描述 base_url str False 模型网关开放的ip和端口，有默认值可以不填。功能类似OpenAI的base_url。 custom_hearders dict False 其他自定义请求头信息
快速开始 下载AI原生应用引擎SDK AI原生应用引擎SDK获取地址：wiseagent-dev-sdk-python。您也可以参考下载SDK获取AI原生应用引擎SDK并进行完整性校验。 AI原生应用引擎SDK获取方法请参考。 安装AI原生应用引擎SDK 若已经安装过最新版本SDK
modules模块 HttpxClient ModelRouter PromptTemplate KnowledgeRetriever ApplicationCenter 父主题： AI原生应用引擎SDK API
应用示例 与文本对话模型进行交互 场景描述 提供用户与模型进行对话的能力，用户将文本内容写入到content中，选择填写合适的文本对话模型，与模型进行交互。其中环境变量WISEAGENT_API_KEY填写AI原生应用引擎的平台API KEY，该值用于鉴权，为必填。返回结果存在response
为隔离域关联ACL 网络ACL是一个子网级别的可选安全层，通过与子网关联的出方向/入方向规则控制出入子网的网络流量。ENS支持为已创建的虚拟机类型资源的隔离域关联ACL，本章节介绍如何为隔离域关联ACL。 前提条件 已获取服务运维岗位权限、基础运维岗位权限或运维管理员权限，权限申请操作请参见申请权限
错误处理 在使用AI原生应用引擎SDK时，当服务端或者SDK端出错时，SDK会返回相应的异常信息，请参见下表进行处理。 状态码 错误码 错误信息 描述 处理措施 200 AIAE.22001001 API调用异常 API调用异常 调用接口url、请求方式错误或出现访问其他用户资源的越权问题
版本变更记录 表1 版本变更记录 版本 变更类型 说明 0.0.1 - 第一次发布。 父主题： AI原生应用引擎SDK API
创建知识库并进行检索 操作场景 本文通过调用一系列知识中心的API，介绍从零开始创建知识库并进行检索的基本流程。API调用方法请参见如何调用API。 前提条件 准备一篇名为“问题.txt”的文档，文档内容为： “什么是量子计算？它是一种利用量子力学原理进行信息处理的计算方式。===
日志处理 日志级别配置 日志级别通过环境变量WISEAGENT_LOG配置： import os os.environ["WISEAGENT_LOG"] = "INFO" # 配置日志级别为INFO 日志级别默认为WARNING，支持配置为DEBUG、INFO。 日志格式 日志格式
SDK概述 AI原生应用引擎SDK面向开发者提供了一套搭建原生应用的Python SDK，包含了模型调用，知识获取，工具调用等功能。开发者可以使用SDK调用AI原生应用引擎的各种能力，帮助开发者快速构建大模型应用。 表1 模块说明 序号 模块 功能 1 HttpxClient 负责发送
知识数据集请求参数说明 CreateKnowledgeDataSetReq 创建知识数据集的data_set参数具有特定结构，需要按照以下实体进行构造后转成json。 表1 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 参数解释： 数据集名称。 约束限制
PromptTemplate PromptTemplate提供了提示语编写与组装的能力，目前支持f-string和jinja两种形式的模板。 导入PromptTemplate from wiseagent_dev_sdk_python.modules.prompt import PromptTemplate
KnowledgeRetriever KnowledgeRetriever提供了知识库检索的能力，可以检索开发者的知识库，提取相关的信息。 导入KnowledgeRetriever from wiseagent_dev_sdk_python.modules.knowledge_db
ApplicationCenter ApplicationCenter提供了开发者调用部署在平台的应用的能力。 导入ApplicationCenter from wiseagent_dev_sdk_python.modules.tools import ApplicationCenter
手动安装OpsAgent失败怎么办？ 问题描述 远程登录主机后，手动执行复制的安装命令安装OpsAgent时出现如图1所示报错。 图1 安装OpsAgent失败 根因分析 为主机安装OpsAgent需要通过169.254.169.254获取主机元数据信息，安装失败的原因可能是169.254.169.254
录入其他账号 如果资源管理账号与AppStage的开租账号不同，可以将资源管理账号录入AppStage，在AppStage中对资源进行统一管理。 本章节介绍的华为账号为已开通华为云的华为账号，具体操作请参见注册华为账号并开通华为云。 华为账号分为个人实名认证和企业实名认证，如果录入个人实名认证的华为账号
导入工具 创建工具时，对于复杂的API服务，每个API都需要手动添加和配置，会导致操作量大且容易出错。平台提供了导入OpenAPI文件的功能，以减少手动创建工具的工作量。 前提条件 需要具备AI原生应用引擎管理员或开发者权限，权限申请操作请参见AppStage组织成员申请权限。 已获取
Agent问答的时候报错“很抱歉，我的系统似乎遇到了一些故障问题，暂时无法为您提供服务” 问题现象 图1 Agent报错 解决方法 检查创建Agent时选择的模型是否为模型服务商API，使用模型服务商API时，需要配置模型服务鉴权，新开的租户没有配置模型鉴权，具体操作请参见如何对模型供应商提供的模型服务设置鉴权
平台有没有预置模型？ 平台预置的开源模型 开源模型Qwen系列、deepseek-coder系列等 请参考将已有模型部署为模型服务进行部署，部署后即可进行调测/体验、调用。 开源模型chatglm3-6b 平台提供了对应的模型服务API，但是该模型能力有限，只能作为问答模型，不能作为思考模型
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
