【Agent智能体项目实战一】阿里云通义千问兼容 OpenAI 接口实现 AI 对话

0 阅读2分钟

一、环境准备

首先安装依赖:

pip install openai

二、完整代码

from openai import OpenAI

# 1. 创建客户端(对接阿里云通义千问兼容接口)
client = OpenAI(
    api_key="你的API-KEY",
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

# 2. 发起对话请求
response = client.chat.completions.create(
    model="qwen3.5-flash",
    messages=[
        {"role": "system", "content": "你是一个Python编程的专家,可以帮助我解决Python编程中的问题,并且不说废话以及是个非常有趣的人"},
        {"role": "assistant", "content": "我是一个Python编程的专家,你要问什么?"},
        {"role": "user", "content": "你是谁"}
    ],
)

# 3. 输出结果
print(response.choices[0].message.content)

三、代码逐行解释

1. 导入库

from openai import OpenAI

我们使用官方 openai 库,不需要额外装阿里云 SDK。

2. 初始化客户端

client = OpenAI(
    api_key="你的API-KEY",
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)
  • api_key:在阿里云百炼平台获取
  • base_url:通义千问兼容模式固定地址

3. 构造对话

messages=[
    {"role": "system", "content": "设定AI角色"},
    {"role": "assistant", "content": "AI历史回复"},
    {"role": "user", "content": "用户问题"}
]
  • system:设定 AI 人设
  • assistant:历史对话(可选)
  • user:当前用户提问

4. 获取并打印结果

print(response.choices[0].message.content)

直接取第一条回答的文本内容。


四、运行效果示例

执行代码后输出类似:

我是一名专业的Python编程专家,专注帮你解决Python相关问题,风趣又高效!

五、重要注意事项

  1. API Key 不要明文写在代码里上传到公网,非常危险! 建议改用环境变量:
    import os
    client = OpenAI(
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        base_url="https://dashscope.aliyuncs.com/compatible-mode/v1"
    )
    
  2. 模型 qwen3.5-flash免费/低成本版本,适合学习使用。
  3. 接口格式完全兼容 OpenAI,原有项目可无缝迁移。

六、最终效果

控制台输出


七、总结

  • 通义千问兼容 OpenAI 接口,一行配置就能切换
  • 代码极简、易上手,适合快速开发 AI 小工具
  • 适合做:Python 答疑、聊天机器人、智能客服等