使用 AI 网关调用 Flow Agent

步骤三：配置路由（定义调用路径）

完成 后，进入 Agent API 详情页，继续完成路由配置。

1. 在 Agent API 详情页，选择 路由列表 > 创建路由。

2. 在创建路由页面完成以下配置：

   1. 路由名称：自定义路由名称（创建后不可修改）。

   2. 路径（Path）：按需配置，如 /example_path。后续 API 调用时路径需与此处一致。

   3. Agent 服务：服务类型选择 单服务，服务名称选择在 中创建的 。

   4. 展开更多匹配规则，方法（Method）选择 POST。

3. 选择，完成路由创建。

4. 在路由详情页，选择 发布路由，然后选择。

5. 路由列表显示 已发布 时，表示发布成功。

基础调用示例

以下是最简调用示例。请将 URL 中的尖括号占位符替换为实际值：

• <YOUR_AI_GW_ENDPOINT>：替换为 AI 网关实例的访问域名或自定义域名

• <base_path>：替换为 Agent API 中配置的 Base Path

• <route_path>：替换为路由中配置的路径

curl \
  -H "Content-Type: application/json" \
  http://<YOUR_AI_GW_ENDPOINT>/<base_path>/<route_path> \
  -d '{
    "sys.query": "Hello, who are you?"
  }'

请求参数说明：

{
    "sys.query": "Hello, who are you?",
    "context": "your_context",
    "doc_md": "doc_md",
    "number": 123,
    "type": "a"
  }

会话亲和调用模式

AI 网关支持会话亲和（Session Affinity）调用模式，通过 x-agentrun-session-id 请求头维持多轮对话的上下文关联。同一 x-agentrun-session-id 的请求会被路由到相同的后端实例，确保对话状态连续。

调用时在请求头中添加 x-agentrun-session-id，值为自定义的会话标识符：

curl \
  -H "Content-Type: application/json" \
  -H "x-agentrun-session-id: session-abc-12345" \
  http://<YOUR_AI_GW_ENDPOINT>/<base_path>/<route_path> \
  -d '{
    "sys.query": "还记得我刚才说的是什么吗？"
  }'

响应示例

调用成功后，返回 JSON 格式响应体：

{
  "FlowName": "agent-flow-KRbWd",
  "Name": "0758c9e9-808c-****-a3b2-18c86d3453e2",
  "SessionId": "",
  "Output": "{\"answer\":\"Hello! I'm Qwen, a large language model developed by Alibaba Group. How can I assist you?\"}",
  "ErrorCode": "",
  "ErrorMessage": "",
  "Status": "Succeeded",
  "RequestId": "becb807b-****-49cc-3604-20a823a8f599",
  "StartedTime": "2026-02-03T09:31:56.092Z",
  "StoppedTime": "2026-02-03T09:32:00.531Z",
  "Environment": {
    "Variables": []
  }
}

响应参数说明：

常见错误排查