怎么在平台上建立一个智能体。然后通过api直接调用我的智能体?
下面给出 2025 年最新「阿里云百炼智能体 API」调用全流程,从创建 → 发布 → 拿 Key → 代码调用 4 步完成,全部基于阿里云官方文档与实测,复制即可运行。
① 创建并发布你的智能体(一次操作,终身生效)
登录 阿里云百炼控制台 左侧「智能体应用」→ 新建应用 → 选择模型(如 qwen-turbo)→ 填写系统提示词 / 上传知识库 → 保存 右上角点击「发布」→ 确认发布成功(状态变为“已发布”)
只有「已发布」状态才会出现 API 调用入口!
② 获取 2 个必传参数
参数获取位置示例值DASHSCOPE_API_KEY控制台顶部「API-KEY 管理」→ 创建即得sk-3fcd8a1a9b…app_id已发布应用卡片 →「查看API」→ app_id 字段9a8b7c6d5e4f3g2h
③ 最小可运行代码(Python 3.8+)
安装官方 SDK
pip install dashscope>=1.14.0
调用示例(单轮文本对话)
import os
from http import HTTPStatus
from dashscope import Application
# 1. 把 KEY 写环境变量或改下行
os.environ['DASHSCOPE_API_KEY'] = 'sk-3fcd8a1a9b……'
# 2. 你的应用 ID
app_id = '9a8b7c6d5e4f3g2h'
# 3. 可选:自定义变量(在提示词里用 {{city}} 引用)
biz_params = {'user_prompt_params': {'city': '北京'}}
response = Application.call(app_id=app_id,
prompt='美食推荐',
biz_params=biz_params)
if response.status_code == HTTPStatus.OK:
print(response.output.text) # 智能体回答
# print(response.usage) # Token 消耗
else:
print('错误:', response.status_code, response.message)
返回示例
北京烤鸭、铜锅涮肉、炸酱面都是地道选择,值得一试!
④ 常用 3 种接入方式
场景调用方法文档链接后端直调上方 Python/Go/Java SDK官方 SDK前端 AJAXPOST https://dashscope.aliyuncs.com/api/v1/apps/{app_id}Header: Authorization: Bearer SKBody: {'prompt':'问题'}HTTP 接口文档微信/钉钉机器人控制台「发布渠道」→ 一键生成 webhook URL,事件自动转发钉钉机器人
⑤ 进阶:传文件、多轮对话、自定义插件
文件上传:在控制台打开「文件能力」,前端用 multipart/form-data 同帧发送文件与 prompt,后端自动解析。 多轮会话:自行维护 session_id(后端 redis/数据库存历史消息),每次把上下文拼进 prompt 即可。 插件:在「插件中心」勾选「天气查询」「HTTP 请求」等,然后在提示词里用 {{plugin_name:参数}} 调用,无需改代码。
⑥ 免费额度 & 计费(2025-07)
每个新账号 默认送 100 万次 Token 或 30 天(先到者失效)。 超出后按模型计费,例如 qwen-turbo 0.012 元/1k tokens,约等于 1 元能问 8–10 万次。 应用本身 无额外平台费用,只算模型 Token。
⑦ 常见报错速查
报错码原因快速解决400 InvalidApiKeyKEY 写错或已删控制台重新生成403 Forbidden应用未发布回控制台点「发布」429 RateLimit秒并发超 10 次前端加防抖或升配
一句话总结
百炼控制台「创建+发布」→ 2. 拿 API_KEY + app_id → 3. 装 dashscope SDK → 4. 一行 Application.call() 即可调用你自己的智能体,零服务器、零算法、零配置,3 分钟上线。
赞0
踩0