文档首页/ 智果（AgentArts）智能体平台/ 高代码开发/ 组件库/ 网关/ 在智能体中使用网关
更新时间：2026-07-07 GMT+08:00
查看PDF
分享

在智能体中使用网关

创建网关后，您需要将已经创建的网关集成到智能体的代码中或添加到已有的MCP智能体客户端，以便后续调用网关能力，可以参考以下示例代码，并根据需求自定义修改其中的信息，生成实际使用的代码。

前提条件

已完成创建网关。

在智能体中使用网关

  1. 登录AgentArts智能体平台。
  1. 在左侧导航栏选择“开发中心 > 组件库 ”，单击“网关”页签，进入网关界面。
  1. 在网关列表单击操作列的“调用代码”，查看并复制代码示例，并根据需求自定义修改其中的信息，生成实际使用的代码。

    您可以在请求体中指定tools/list作为请求方法获取网关提供的所有可用工具。

    您可以在请求体中指定tools/call作为请求方法用于调用特定的工具。

API Key认证的tools/list调用示例

import requests
import json
import re


def list_tools(gateway_url, access_token):
    headers = {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "mcp-session-id": "<MCP_SESSION_ID>",  # MCP会话ID，相同的sessionid会使用同一网关资源，调用时请配置此参数，例如：4ada96ff-1e16-4e5b-8fb4-b3f0f207a4f3
        "Mcp-Protocol-Version": "<MCP_PROTOCOL_VERSION>",   # MCP协议版本，2025-06-18版本新增请求头          
        "Authorization": f"Bearer {access_token}"      
    }
    payload = {"jsonrpc": "2.0","id": "list-tools-request","method": "tools/list"}
    response = requests.post(gateway_url, headers=headers, json=payload) # 若需要忽略ssl校验，可补充参数verify=False
    raw = response.content.decode('utf-8', errors='replace')
    ct = response.headers.get('content-type', '')
    if 'text/event-stream' in ct:
        for line in raw.strip().split('\n'):
            if line.startswith('data:'):
                try:
                    return json.loads(line[5:].strip())
                except json.JSONDecodeError:
                    continue
        m = re.search(r'\{.*\}', raw, re.DOTALL)
        if m:
            return json.loads(m.group())
    try:
        return json.loads(raw)
    except json.JSONDecodeError:
        print(f"[Fail]: {raw[:200]}")
        return None

gateway_url = "<GATEWAY_URL>"   # 网关接口地址（业务API调用入口）
access_token = "<API_KEY>"      # 认证凭证：APIKey认证直接填写密钥；无认证则留空/删除
result = list_tools(gateway_url, access_token)
if result:
    print(json.dumps(result, indent=2, ensure_ascii=False))

API Key认证的tools/call调用示例

import requests
import json
import re


def call_tool(gateway_url, access_token, tool_name, arguments):
    headers = {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "mcp-session-id": "<MCP_SESSION_ID>",  # MCP会话ID，相同的sessionid会使用同一网关资源，调用时请配置此参数，例如：4ada96ff-1e16-4e5b-8fb4-b3f0f207a4f3
        "Mcp-Protocol-Version": "<MCP_PROTOCOL_VERSION>",   # MCP协议版本，2025-06-18版本新增请求头 
        "Authorization": f"Bearer {access_token}"
    }
    payload = {"jsonrpc": "2.0","id": "call-tool-request","method": "tools/call","params": {"name": tool_name,"arguments": arguments}}
    response = requests.post(gateway_url, headers=headers, json=payload) # 若需要忽略ssl校验，可补充参数verify=False
    raw = response.content.decode('utf-8', errors='replace')
    ct = response.headers.get('content-type', '')
    if 'text/event-stream' in ct:
        for line in raw.strip().split('\n'):
            if line.startswith('data:'):
                try:
                    return json.loads(line[5:].strip())
                except json.JSONDecodeError:
                    continue
        m = re.search(r'\{.*\}', raw, re.DOTALL)
        if m:
            return json.loads(m.group())
    try:
        return json.loads(raw)
    except json.JSONDecodeError:
        print(f"[Fail]: {raw[:200]}")
        return None

gateway_url = "<GATEWAY_URL>"   # 网关接口地址（业务API调用入口）
access_token = "<API_KEY>"      # 认证凭证：APIKey认证直接填写密钥；无认证则留空/删除
tool_name = "<TOOL_NAME>"        # 待调用的工具名称，通过 tools/list 接口查询获取
arguments = {"param1": "value1", "param2": "value2"}                 # 工具调用入参，严格按照工具定义的参数结构填写
result = call_tool(gateway_url, access_token, tool_name, arguments)
if result:
    print(json.dumps(result, indent=2, ensure_ascii=False))

IAM认证的tools/list调用示例

API签名详情请参见API签名指南： 
import requests
import json
import re


def list_tools(gateway_url, access_token):
    headers = {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "mcp-session-id": "<MCP_SESSION_ID>",     # MCP会话ID，相同的sessionid会使用同一网关资源，调用时请配置此参数，例如：4ada96ff-1e16-4e5b-8fb4-b3f0f207a4f3
        "Mcp-Protocol-Version": "<MCP_PROTOCOL_VERSION>",   # MCP协议版本，2025-06-18版本新增请求头 
        "X-Sdk-Date": "<X_SDK_DATE>",             # 网关鉴权时间戳
        "X-Sdk-Content-Sha256": "UNSIGNED-PAYLOAD",
        "Authorization": access_token                       
    }
    payload = {"jsonrpc": "2.0", "id": "list-tools-request", "method": "tools/list"}
    response = requests.post(gateway_url, headers=headers, json=payload) # 若需要忽略ssl校验，可补充参数verify=False
    raw = response.content.decode('utf-8', errors='replace')
    ct = response.headers.get('content-type', '')
    if 'text/event-stream' in ct:
        for line in raw.strip().split('\n'):
            if line.startswith('data:'):
                try:
                    return json.loads(line[5:].strip())
                except json.JSONDecodeError:
                    continue
        m = re.search(r'\{.*\}', raw, re.DOTALL)
        if m:
            return json.loads(m.group())
    try:
        return json.loads(raw)
    except json.JSONDecodeError:
        print(f"[Fail]: {raw[:200]}")
        return None

gateway_url = "<GATEWAY_URL>"       # 网关接口地址（业务API调用入口）
access_token = "<AUTHORIZATION>"    # 鉴权Authorization
result = list_tools(gateway_url, access_token)
if result:
    print(json.dumps(result, indent=2, ensure_ascii=False))

API Key认证的ping的调用示例

import requests
import json
import re
def ping(gateway_url, access_token):
    headers = {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "mcp-session-id": "<MCP_SESSION_ID>",  # MCP会话ID，相同的sessionid会使用同一网关资源，调用时请配置此参数，例如：4ada96ff-1e16-4e5b-8fb4-b3f0f207a4f3
        "Mcp-Protocol-Version": "<MCP_PROTOCOL_VERSION>",   # MCP协议版本，2025-06-18版本新增请求头 
        "Authorization": f"Bearer {access_token}"
    }
    payload = {"jsonrpc": "2.0", "id": "ping-request", "method": "ping"}
    response = requests.post(gateway_url, headers=headers, json=payload)  # 若需要忽略ssl校验，可补充参数verify=False
    raw = response.content.decode('utf-8', errors='replace')
    ct = response.headers.get('content-type', '')
    if 'text/event-stream' in ct:
        for line in raw.strip().split('\n'):
            if line.startswith('data:'):
                try:
                    return json.loads(line[5:].strip())
                except json.JSONDecodeError:
                    continue
        m = re.search(r'\{.*\}', raw, re.DOTALL)
        if m:
            return json.loads(m.group())
    try:
        return json.loads(raw)
    except json.JSONDecodeError:
        print(f"[Fail]: {raw[:200]}")
        return None
gateway_url = "<GATEWAY_URL>"   # 网关接口地址（业务API调用入口）
access_token = "<API_KEY>"      # 认证凭证：APIKey认证直接填写密钥；无认证则留空/删除
result = ping(gateway_url, access_token)
if result:
    print(json.dumps(result, indent=2, ensure_ascii=False))

语义检索的tools/call调用示例

import requests
import json
import re


def call_tool(gateway_url, access_token, tool_name, arguments):
    headers = {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "mcp-session-id": "<MCP_SESSION_ID>",  # MCP会话ID，相同的sessionid会使用同一网关资源，调用时请配置此参数，例如：4ada96ff-1e16-4e5b-8fb4-b3f0f207a4f3
        "Mcp-Protocol-Version": "<MCP_PROTOCOL_VERSION>",   # MCP协议版本，2025-06-18版本新增请求头 
        "Authorization": f"Bearer {access_token}"
    }
    payload = {"jsonrpc": "2.0","id": "call-tool-request","method": "tools/call","params": {"name": tool_name,"arguments": arguments}}
    response = requests.post(gateway_url, headers=headers, json=payload) # 若需要忽略ssl校验，可补充参数verify=False
    raw = response.content.decode('utf-8', errors='replace')
    ct = response.headers.get('content-type', '')
    if 'text/event-stream' in ct:
        for line in raw.strip().split('\n'):
            if line.startswith('data:'):
                try:
                    return json.loads(line[5:].strip())
                except json.JSONDecodeError:
                    continue
        m = re.search(r'\{.*\}', raw, re.DOTALL)
        if m:
            return json.loads(m.group())
    try:
        return json.loads(raw)
    except json.JSONDecodeError:
        print(f"[Fail]: {raw[:200]}")
        return None

gateway_url = "<GATEWAY_URL>"   # 网关接口地址（业务API调用入口）
access_token = "<API_KEY>"      # 认证凭证：APIKey认证直接填写密钥；无认证则留空/删除
tool_name = "x_agentarts_gateway_tool_semantic_search"    # 语义检索调用的工具名称，固定为 "x_agentarts_gateway_tool_semantic_search"
arguments = {"query": "value"}        # 语义检索调用入参，value表示检索提示词
result = call_tool(gateway_url, access_token, tool_name, arguments)
if result:
    print(json.dumps(result, indent=2, ensure_ascii=False))
父主题： 网关

相关文档