更新时间:2026-04-15 GMT+08:00
分享

在网关中创建Target

创建网关时,需要创建并绑定Target。创建Target用于定义和配置一个目标端点或服务,网关将接收到的请求转发到该服务进行处理。

前提条件

  • 创建网关
  • 创建Target时,若选择OPEN API类型的目标服务类型,且需要从OBS获取规范文档用户需要确保网关的FullAccessPolicy外,还包含如下身份策略权限:
    表1 授权项

    授权项

    功能介绍

    obs:bucket:listBucket

    授予获取桶内对象列表的权限

    obs:bucket:listBucketVersions

    授予获取桶内多版本对象列表的权限

    obs:bucket:listAllMyBuckets

    授予查询创建的桶列表的权限

    obs:object:getObject

    授予下载非指定版本对象的权限

    obs:object:getObjectVersion

    授予下载指定版本对象的权限

    在IAM控制台为用户授权的操作指导可参考:给IAM用户授权

约束与限制

一个网关最多可关联10个Target。

创建Target

  1. 登录AgentArts智能体开发平台
  1. 在左侧导航栏选择“开发中心 > 组件库 ”,单击左上角“网关”页签,进入网关界面。
  2. 选择已创建的网关,单击网关名称,在“关联Target”区域,单击“创建Target”。
  3. 输入Target的配置信息,参数说明请参考表2,然后单击“确定”。

    表2 参数说明

    参数

    说明

    基本信息

    名称

    必选参数。

    Target的名称,同一网关下Target名称不可重复。

    命名规则:

    • 以字母或数字开头和结尾。
    • 支持大小写字母、数字和连字符。
    • 最大长度为50个字符。

    描述

    可选参数。

    用于对Target内容和用途的简要说明。

    命名规则:长度不大于200个字符。

    配置信息

    类型

    选择Target的类型。

    • 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的协议,用于从服务器向客户端推送实时更新,适用于需要实时更新的应用。
        • HTTP Streamable:基于HTTP的流式传输方式,允许服务器向客户端发送连续的数据流,适用于需要实时数据流的应用。
      • MCP地址:输入MCP地址,如:https://mcp.example.com/sse。

    出站身份认证

    出站身份认证

    配置出站身份认证方式,用于在网关将请求转发到后端服务(Target)时,对请求进行身份验证和授权。

    支持以下认证方式:

    • API Key
      • 选择出站身份,如下拉框无选项请单击“创建出站身份”。
      • 选择位置。
        • 标头:在HTTP请求的头部字段中传递API Key。
        • 查询参数:在HTTP请求的URL中传递API Key。
      • 参数名称(可选):输入参数名称,在请求中传递API的密钥时使用的具体名称。
      • 前缀(可选):在请求头中传递API Key时,API密钥值之前的前缀部分,如在授权标头中使用的“Bearer”。
    • OAuth
      • 选择出站身份,如下拉框无选项请单击“创建出站身份”。
      • 选择授权类型。

        客户端授权:适用于用户授权应用程序(客户端)访问其资源。

      • 作用域:用于定义可以访问的资源和操作的范围,确保只能访问其被授权的资源。输入范围名称,最大可添加100个范围。
      • 自定义参数:在请求中传递的额外参数,可以用于传递特定的信息或满足特定的认证需求。请输入自定义参数信息的键和值,最大可添加255个参数。
    • 无认证:在网关将请求转发到Target时,不对请求进行身份验证和授权。

更多操作

您还可以对已创建的Target执行如下操作。

表3 更多操作

操作

说明

查看Target

  1. 在网关详情页面的“关联Target”区域。
  2. 单击Target名称,查看Target详情。

修改Target

  1. 在网关详情页面的“关联Target”区域。
  2. 单击Target列表操作列的“编辑”。
  3. 修改Target信息,其中置灰项不可修改。

删除Target

Target删除后不可恢复,请谨慎操作。

  1. 在网关详情页面的“关联Target”区域。
  2. 单击Target列表操作列的“删除”。
  3. 在弹框中单击“确定”。

相关文档