全部文档
当前文档
最近更新时间：2026-05-20 16:38:13
Agent Engine运行时创建完成后，您可通过OpenAI SDK的标准格式进行调用，具体操作如下。
本地环境已配置Python >=3.8的环境。
执行如下命令，本地安装OpenAI SDK。当终端返回Successfully installed ...时，表示 SDK 已安装成功。您也可以通过执行 pip show openai 命令来验证安装。
pip3 install -U openai登录星流平台，在顶部导航栏选择模型应用服务 > Agent Engine运行时。
在运行时列表内，点击目标运行时的名称/ID，进入其详情页面。
在目标运行时的详情页面，复制并获取公网域名和API Key。
本地新建 agent_test.py 文件，参考以下说明和格式，编辑 Python 代码文件。
api_key：为上一步在详情页面，复制获取的API Key。
base_url：为上一步在详情页面，复制获取的公网域名+API版本路径 /v1/，故该参数的值为：公网域名/v1/，形如：https://ar-xxxxxxx-6d5c341f.agent.kspmas.ksyun.com/v1/。
model：Agent默认使用 glm-5 模型，您也可根据实际情况，选择已配置好的其他模型。
import os
from openai import OpenAI
# 初始化客户端
client = OpenAI(
api_key="ak-f2287af52bxxxxxd6a92cccb02bf3",
base_url="https://ar-xxxxxxx-6d5c341f.agent.kspmas.ksyun.com/v1/",
)
# 调用 Chat Completions API
response = client.chat.completions.create(
model="glm-5",
messages=[
{"role": "system", "content": "你是人工智能助手"},
{"role": "user", "content": "常见的十字花科植物有哪些？"},
],
temperature=0.7, # 随机性 0-2
max_tokens=100, # 最大输出长度
top_p=1.0, # 核采样
frequency_penalty=0, # 频率惩罚
presence_penalty=0 # 存在惩罚
)
# 获取回复
print(response.choices[0].message.content)完成上述操作，在本地终端，进入示例文件所在目录，执行 python3 agent_test.py 命令，即可调用该服务。
纯净模式