怎么在平台上建立一个智能体。然后通过api直接调用我的智能体?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
下面给出 2025 年最新「阿里云百炼智能体 API」调用全流程,
从创建 → 发布 → 拿 Key → 代码调用 4 步完成,全部基于阿里云官方文档与实测,复制即可运行。
只有「已发布」状态才会出现 API 调用入口!
| 参数 | 获取位置 | 示例值 |
|---|---|---|
DASHSCOPE_API_KEY | 控制台顶部「API-KEY 管理」→ 创建即得 | sk-3fcd8a1a9b… |
app_id | 已发布应用卡片 →「查看API」→ app_id 字段 | 9a8b7c6d5e4f3g2h |
安装官方 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)
返回示例
北京烤鸭、铜锅涮肉、炸酱面都是地道选择,值得一试!
| 场景 | 调用方法 | 文档链接 |
|---|---|---|
| 后端直调 | 上方 Python/Go/Java SDK | 官方 SDK |
| 前端 AJAX | POST 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 即可。 {{plugin_name:参数}} 调用,无需改代码。qwen-turbo 0.012 元/1k tokens,约等于 1 元能问 8–10 万次。 | 报错码 | 原因 | 快速解决 |
|---|---|---|
| 400 InvalidApiKey | KEY 写错或已删 | 控制台重新生成 |
| 403 Forbidden | 应用未发布 | 回控制台点「发布」 |
| 429 RateLimit | 秒并发超 10 次 | 前端加防抖或升配 |
API_KEY + app_id → 3. 装 dashscope SDK → 4. 一行 Application.call() 即可调用你自己的智能体,零服务器、零算法、零配置,3 分钟上线。