使用API调用运行时接口（IAM认证）

理解托管运行时与调用接口

步骤一：前置准备

步骤二：构造调用脚本

1. 以下Python脚本实现了与托管运行时的完整交互，打开准备签名SDK步骤中的main.py脚本，删除原有内容，并将下方代码添加进去。

   代码中智能体的调用路径（API_URL）按实际进行填写，获取方法参考步骤一：部署智能体并选择IAM认证。

   # -*- coding: utf-8 -*-
   """
   AgentArts 托管运行时 API 调用示例（IAM 认证，V11-HMAC-SHA256）
   适用于任意自定义智能体代码。
   """
   
   import os
   import json
   import uuid
   import requests
   from urllib.parse import urlparse, urlunparse
   from apig_sdk import signer
   
   # ========== 配置区域 ==========
   # 从控制台复制的完整调用路径
   API_URL = "完整调用路径"
   REGION_ID = "cn-southwest-2"   # 默认为贵阳一
   # ===============================
   
   def normalize_api_url(url: str) -> str:
       """移除 URL 中可能携带的查询参数（如 ?endpoint=Latest）"""
       parsed = urlparse(url.strip())
       clean = urlunparse(parsed._replace(query="", fragment=""))
       if parsed.query:
           print(f"[提示] 已剥离查询参数「?{parsed.query}」，实际使用: {clean}\n")
       return clean
   
   def build_signed_request(sig, api_url: str, payload: dict, session_id: str):
       """
       构造请求并执行 V11 签名
       :param payload: 请求体字典，其字段结构必须与您的服务代码中定义的接口一致
       """
       method = "POST"
       body = json.dumps(payload, ensure_ascii=False)
   
       headers = {
           "Content-Type": "application/json",
           "X-Sdk-Content-Sha256": "UNSIGNED-PAYLOAD",   # Body 免签名
           "x-hw-agentarts-session-id": session_id
       }
   
       req = signer.HttpRequest(method, api_url, headers, body)
       sig.Sign(req)   # 自动填充 X-Sdk-Date 和 Authorization
       return req
   
   def main():
       api_url = normalize_api_url(API_URL)
   
       # 读取 IAM 凭证
       ak = os.getenv('HUAWEICLOUD_SDK_AK', '').strip()
       sk = os.getenv('HUAWEICLOUD_SDK_SK', '').strip()
       if not ak or not sk:
           print("错误：环境变量 HUAWEICLOUD_SDK_AK/SK 未设置！")
           return
   
       # 初始化 V11 签名器
       sig = signer.Signer(algorithm="V11-HMAC-SHA256", region_id=REGION_ID)
       sig.Key = ak
       sig.Secret = sk
   
       # 生成会话 ID（同一用户的多轮对话应复用同一个 session_id）
       session_id = str(uuid.uuid4())
   
       # 打印鉴权头示例（用于调试）
       demo_payload = {"message": "ping"}   # 字段名需与您的服务定义一致
       demo_req = build_signed_request(sig, api_url, demo_payload, session_id)
       print(f"X-Sdk-Date    : {demo_req.headers.get('X-Sdk-Date')}")
       print(f"Authorization : {demo_req.headers.get('Authorization')[:80]}...\n")
   
       print("=== AgentArts 运行时交互式调用 ===")
       print("输入 'exit' 或 'quit' 退出\n")
   
       while True:
           try:
               user_input = input("【您】: ").strip()
               if not user_input:
                   continue
               if user_input.lower() in ["exit", "quit"]:
                   break
   
               # 【关键】构造请求体：字段名必须与您的 handler 中 request.get() 的键名一致
               # 示例中使用 "message" 作为用户输入字段
               payload = {"message": user_input}
   
               # 每次请求自动重新签名（使用最新时间）
               req = build_signed_request(sig, api_url, payload, session_id)
   
               resp = requests.request(
                   method=req.method,
                   url=f"{req.scheme}://{req.host}{req.uri}",
                   headers=req.headers,
                   data=req.body,
                   timeout=(5, 60)   # 连接超时 5 秒，读取超时 60 秒
               )
   
               print(f"\n[HTTP {resp.status_code}]")
               try:
                   resp_json = resp.json()
                   print("【Agent响应】:", json.dumps(resp_json, ensure_ascii=False, indent=2))
               except:
                   print("【原始响应】:", resp.text)
               print("-" * 50)
   
           except KeyboardInterrupt:
               break
           except Exception as e:
               print(f"发生异常: {e}")
   
   if __name__ == '__main__':
       main()

2. 脚本编辑完成后，保存并关闭该脚本。

步骤三：运行脚本获取接口响应

1. 在Python SDK的文件夹上方显示路径的地址栏里，清空地址，直接输入cmd后按回车。

   

2. 在打开的命令提示符窗口中会显示出当前的文件夹路径，输入以下命令执行脚本。

   python main.py

   运行该脚本会返回接口的鉴权信息值，以及接口的响应结果。

   图6 运行示例
   

   调用AgentArts运行时API时，HTTP响应返回401状态码，响应体为 {"code": 401, "message": "Authentication failed!"}。控制台检查确认运行时“入站身份认证”已正确选择为“IAM 认证”，签名算法和区域配置是否均无误。

   在终端中执行以下命令检查AK/SK环境变量是否生效，如果未生效，请参考配置华为云AK/SK重新配置：

   echo $HUAWEICLOUD_SDK_AK
   echo $HUAWEICLOUD_SDK_SK