# 创建Target 创建网关时，可以创建并绑定Target。创建Target用于定义和配置一个目标端点或服务，网关将接收到的请求转发到该服务进行处理。 #### 前提条件 - 已完成[创建网关](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_073.html)。 - 创建Target时，选择REST API类型的Target，且从OBS中获取文件时，用户除了需要具备网关的FullAccessPolicy权限外，还需包含以下身份策略权限： 表1授权项 | 授权项 | 功能介绍 | |:---|:---| | obs:bucket:listBucket | 授予获取桶内对象列表的权限。 | | obs:bucket:listBucketVersions | 授予获取桶内多版本对象列表的权限。 | | obs:bucket:listAllMyBuckets | 授予查询创建的桶列表的权限。 | | obs:object:getObject | 授予下载非指定版本对象的权限。 | | obs:object:getObjectVersion | 授予下载指定版本对象的权限。 | 在IAM控制台为用户授权的操作指导可参考：[给IAM用户授权](https://support.huaweicloud.com/usermanual-iam5/iam_01_1145.html)。 #### 约束与限制 一个网关最多可关联10个Target。 #### 创建Target 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏选择"开发中心 \> 组件库 "，单击左上角"网关"页签，进入网关界面。 3. 选择已创建的网关，单击网关名称，在"关联Target"区域，单击"创建Target"。 4. 输入Target的配置信息，参数说明请参考[表2]，然后单击"确定"。 表2参数说明 | 参数 || 说明 | |:---|---|:---| | 基本信息 | 名称 | Target的名称，同一网关下Target名称不可重复。 命名规则： - 以字母或数字开头和结尾。 - 支持大小写字母、数字和连字符。 - 长度为 1-50 个字符。 系统会默认生成Target的名称，可根据需求自定义修改。 | | 基本信息 | 描述 | 用于说明该Target的内容与用途。此描述仅在网关层生效，不会覆盖或影响后端原始工具的描述。 规则：长度不大于200个字符。 | | 配置信息 | 类型 | 选择Target的类型，关于Target类型的介绍请参见[支持的Target类型](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_065.html)。 - REST API：使用OPEN API schema文件调用。 - 使用"OBS"进行OAS文件导入。 使用OpenAPI Specification (OAS) 文件来定义和配置目标端点或服务，并且这些文件存储在对象存储服务（Object Storage Service, OBS）中，并在创建Target时从OBS中导入这些文件。 单击"从OBS中选择"，选择在OBS中创建的桶列表，直至选择到桶中的.json文件后单击"确定"。 - 使用"自定义"进行OAS文件导入。 从本地文件系统中选择并上传OAS文件，用于定义和配置目标端点或服务。 - 单击"从本地导入"，浏览本地文件系统，选择OAS文件并上传。上传后json文件或yaml即可展示在"内联编辑器"中。 - 单击"从OBS中导入"，选择在OBS中创建的桶列表，直至选择到桶中的.json文件后单击"确定"，将OBS中的文件下载下来展示到内联编辑器中。 - MCP：使用已有的MCP服务器调用。 - 传输方式 - SSE：基于HTTP的协议，用于从服务器向客户端推送实时更新，适用于需要实时更新的应用。 - Streamable HTTP：基于HTTP的流式传输方式，允许服务器向客户端发送连续的数据流，适用于需要实时数据流的应用。 - MCP地址：输入MCP地址。 - APIG：使用注册在云服务 API 网关（APIG）上的 API 作为目标服务，通过 APIG 来调用后端服务。 从APIG导出API接口后，需对涉及body体的接口信息进行修改，具体示例请参见[APIG类型的Target请求体配置示例](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_083.html#agentarts_10_083__section18408145812473)。 - 使用"OBS"进行OAS文件导入。 从 OBS 存储桶中导入 OpenAPI 规范文件（OAS 文件），需使用 Swagger 2.0 或 OpenAPI 3.0 格式的 YAML 或 JSON 文件来描述API接口。 单击"从OBS中选择"，选择在OBS中创建的桶列表，直至选择到桶中的.json文件后单击"确定"。 - 使用"自定义"进行OAS文件导入。 从本地文件系统中选择并上传OAS文件，用于定义和配置目标端点或服务。 - 单击"从OBS中导入"，选择在OBS中创建的桶列表，直至选择到桶中的.json文件后单击"确定"，将OBS中的文件下载下来展示到内联编辑器中。 - 单击"从本地导入"，浏览本地文件系统，选择OAS文件并上传。上传后json文件或yaml即可展示在"内联编辑器"中。 - 云服务：使用华为云提供的云服务作为目标服务，通过华为云服务的开放接口来调用后端服务。 说明： 仅支持选择已在APIE上注册的API，如接口未注册则无法选择。 - 云服务：选择具体的华为云服务。 - 接口：选择了云服务后，系统会根据所选云服务自动加载可用的接口列表，从下拉菜单中选择需要调用的具体接口。 | | 出站身份认证 | 出站身份认证 | 配置出站身份认证方式，用于在网关将请求转发到后端服务（Target）时，对请求进行身份验证和授权。不同类型的Target支持的出站认证方式不同，请根据页面展示配置。 支持以下认证方式： - API Key - 选择出站身份，如下拉框无选项请单击"创建出站身份"，创建"API Key"类型的出站身份。 - 选择位置。 - 标头：在HTTP请求的头部字段中传递API Key。 - 查询参数：在HTTP请求的URL中传递API Key。 - 参数名称（可选）：输入参数名称，在请求中传递API的密钥时使用的具体名称。 - 前缀（可选）：在请求头中传递API Key时，API密钥值之前的前缀部分，如在授权标头中使用的"Bearer"。 - OAuth - 选择出站身份，如下拉框无选项请单击"创建出站身份"，创建"OAuth 客户端"类型的出站身份。 - 选择授权类型。 客户端授权：适用于用户授权应用程序（客户端）访问其资源。 - 作用域：用于定义可以访问的资源和操作的范围，确保只能访问其被授权的资源。输入范围名称，最大可添加100个范围。 - 自定义参数：在请求中传递的额外参数，可以用于传递特定的信息或满足特定的认证需求。请输入自定义参数信息的键和值，最大可添加255个参数。 - IAM 选择出站身份，如下拉框无选项请单击"创建出站身份"，创建"IAM 委托"类型的出站身份，如果无IAM信任委托需[创建信任委托](https://support.huaweicloud.com/usermanual-iam5/iam_01_1163.html)。 图1创建信任委托 ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002673124639.png "点击放大") 使用的IAM信任委托需包含如下action： sts::setContext：获取 STS5 委托所需权限，获取临时凭据时携带用户工作负载访问令牌（workload access token）信息。 ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002643219738.png) "云服务"类型的Target，IAM信任委托中需包含所选接口的授权项，具体操作请参考[为信任委托授权](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_081.html#agentarts_10_081__li9235145175812)。 - 无认证：在网关将请求转发到Target时，不对请求进行身份验证和授权。 | 5. 创建完成后，即可在列表展示已创建的Target。 Target的状态说明如下： 网关创建完成后，在网关列表中单击网关名称，进入基本信息页面，在"关联Target"区域即可查看Target状态。 ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002659059361.png "点击放大") - 就绪可用状态：Target创建成功后，状态初始化为"就绪可用"。 - 在线状态：启动沙箱并探测Target连通性成功后，状态更新为"在线"，此时 Target 可正常调用。当关联该Target的沙箱被释放后，状态将回退至"就绪可用"。 - 离线状态：启动沙箱并探测Target连通性失败后，状态更新为"离线"，离线状态下Target无法正常调用。 离线状态的两种情况以及解决方案： - 连接超时：Target的连接请求超时，无法在规定时间内建立连接，请检查网关和Target的网络连接性或检查Target服务是否正常运行。 - 解析不到IP：Target的IP地址无法解析，导致连接失败。 请检查Target配置的域名DNS解析是否正常，使用命令行工具（如nslookup或dig）测试Target的域名解析是否正常。 当启用语义检索并同步MCP类型的Target时，触发同步操作（单击操作列的"同步"，或勾选多个Target后单击"同步Target信息"）后，Target状态将呈现以下两种情况： - 同步中：系统正在同步Target信息。 - 等待同步中：当前Target排队等待同步中，状态提示为"等待同步中"。 #### 更多操作 您还可以对已创建的Target执行如下操作。 表3更多操作 | 操作 | 说明 | |:---|:---| | 同步Target信息 | 手动同步Target信息仅支持MCP类型的Target，REST API、APIG和云服务类型的Target系统会自动同步。 在创建网关时开启语义检索功能后系统会自动同步Target信息，但如果MCP类型的Target外部工具发生变化，需要手动同步MCP信息，以确保语义检索工具能够获取最新的数据。 手动同步Target操作如下： 1. 在网关列表单击网关名称，进入网关详情页面。 2. 在网关详情页面的"关联Target"区域。 3. 同步Target信息。 - 同步单个Target信息：单击Target列表操作列的"同步"，系统提示"同步 Target 任务已创建！"。 - 同步多个Target信息：在Target列表勾选多个Target，单击"同步Target信息"，系统提示"同步 Target 任务已创建！"。 同步后Target状态将呈现以下两种情况： - 同步中：系统正在同步Target信息。 - 等待同步中：当前Target排队等待同步中，状态提示为"等待同步中"。 | | 查看Target | 1. 在网关详情页面的"关联Target"区域。 2. 单击Target名称，查看Target详情。 | | 修改Target | 1. 在网关详情页面的"关联Target"区域。 2. 单击Target列表操作列的"编辑"。 3. 修改Target信息，其中置灰项不可修改。 | | 删除Target | Target删除后不可恢复，请谨慎操作。 1. 在网关详情页面的"关联Target"区域。 2. 单击Target列表操作列的"删除"。 3. 在弹框中单击"确定"。 |