baidu qianfan agent chat — 百度千帆代理聊天

千帆对话技能

调用百度千帆平台的对话API，与千帆AI应用进行对话交互。

初始化配置

⚠️ 必须设置环境变量 QIANFAN_API_KEY：

导出 QIANFAN_API_KEY="your-API-key-here"

API Key 可从 千帆平台 获取。

默认配置 配置项 默认值 说明 应用_id e52a2419-4327-48e8-b9dc-9bf037199fc2 应用ID，可在调用时通过 --应用-id 覆盖 流 false 流式返回 接口详情

详细的请求/响应参数、错误码、curl 示例等，请参阅 API 参考文档。

基本用法 发起对话

使用 scripts/chat.py 脚本调用：

python3 scripts/chat.py --查询 "你好，请介绍一下自己"

参数说明 参数 说明 默认值 --查询 用户提问内容（必选） - --应用-id 应用ID e52a2419-4327-48e8-b9dc-9bf037199fc2 --流 是否流式返回 true --conversation-id 会话ID（多轮对话时传入） - --file-ids 文件ID列表，逗号分隔 - 多轮对话

会话状态自动管理：

首次调用不传 conversation_id，API返回后会自动保存 后续调用自动使用已保存的 conversation_id 使用 --new-会话 开始新会话 # 首次对话（自动保存 conversation_id） python3 scripts/chat.py --查询 "你好" # 输出: [conversation_id: xxx-xxx-xxx]

# 后续对话（自动使用已保存的 conversation_id） python3 scripts/chat.py --查询 "刚才我们聊了什么" # 输出: [使用已保存的会话: xxx-xxx-xxx]

# 开始新会话 python3 scripts/chat.py --查询 "新话题" --new-会话

手动指定会话ID：

python3 scripts/chat.py --查询 "继续" --conversation-id "xxx-xxx-xxx"

非流式响应 python3 scripts/chat.py --查询 "你好" --流 false

高级功能 Function Call

定义工具并上报结果：

python3 scripts/chat.py --查询 "今天北京天气" --工具s-file 工具s/weather.json

注意事项 确保 QIANFAN_API_KEY 环境变量已设置 首次对话不需要 conversation_id，后续多轮对话需传入 流式模式下，响应以 data: 开头，以 data: [DONE] 结束