开发者社区 问答 正文

怎么在平台上建立一个智能体。然后通过api直接调用我的智能体?

怎么在平台上建立一个智能体。然后通过api直接调用我的智能体?

展开
收起
我是三好学生 2024-08-09 13:50:13 140 分享 版权
1 条回答
写回答
取消 提交回答
  • 下面给出 2025 年最新「阿里云百炼智能体 API」调用全流程,
    创建 → 发布 → 拿 Key → 代码调用 4 步完成,全部基于阿里云官方文档与实测,复制即可运行。


    ① 创建并发布你的智能体(一次操作,终身生效)

    1. 登录 阿里云百炼控制台
    2. 左侧「智能体应用」→ 新建应用 → 选择模型(如 qwen-turbo)→ 填写系统提示词 / 上传知识库 → 保存
    3. 右上角点击「发布」→ 确认发布成功(状态变为“已发布”)

    只有「已发布」状态才会出现 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 SK
    Body: {"prompt":"问题"}
    HTTP 接口文档
    微信/钉钉机器人控制台「发布渠道」→ 一键生成 webhook URL,事件自动转发钉钉机器人

    ⑤ 进阶:传文件、多轮对话、自定义插件

    • 文件上传:在控制台打开「文件能力」,前端用 multipart/form-data 同帧发送文件与 prompt,后端自动解析。
    • 多轮会话:自行维护 session_id(后端 redis/数据库存历史消息),每次把上下文拼进 prompt 即可。
    • 插件:在「插件中心」勾选「天气查询」「HTTP 请求」等,然后在提示词里用 {{plugin_name:参数}} 调用,无需改代码。

    ⑥ 免费额度 & 计费(2025-07)

    • 每个新账号 默认送 100 万次 Token30 天(先到者失效)。
    • 超出后按模型计费,例如 qwen-turbo 0.012 元/1k tokens,约等于 1 元能问 8–10 万次。
    • 应用本身 无额外平台费用,只算模型 Token。

    ⑦ 常见报错速查

    报错码原因快速解决
    400 InvalidApiKeyKEY 写错或已删控制台重新生成
    403 Forbidden应用未发布回控制台点「发布」
    429 RateLimit秒并发超 10 次前端加防抖或升配

    一句话总结

    1. 百炼控制台「创建+发布」→ 2. 拿 API_KEY + app_id → 3. 装 dashscope SDK → 4. 一行 Application.call() 即可调用你自己的智能体,零服务器、零算法、零配置,3 分钟上线。
    2025-10-12 15:15:22
    赞同 展开评论
问答分类:
API
问答标签:
问答地址: