千帆对话技能

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

初始化配置

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

bash
export QIANFANAPIKEY=your-api-key-here

API Key 可从 千帆平台 获取。

默认配置

接口详情

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

基本用法

发起对话

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

bash
python3 scripts/chat.py --query 你好，请介绍一下自己

参数说明

多轮对话

会话状态自动管理：

• - 首次调用不传 conversationid，API返回后会自动保存
• 后续调用自动使用已保存的 conversationid
• 使用 --new-session 开始新会话

bash

首次对话（自动保存 conversation_id）

输出: [conversation_id: xxx-xxx-xxx]

后续对话（自动使用已保存的 conversation_id）

输出: [使用已保存的会话: xxx-xxx-xxx]

开始新会话

手动指定会话ID：

bash
python3 scripts/chat.py --query 继续 --conversation-id xxx-xxx-xxx

非流式响应

bash
python3 scripts/chat.py --query 你好 --stream false

高级功能

Function Call

定义工具并上报结果：

bash
python3 scripts/chat.py --query 今天北京天气 --tools-file tools/weather.json

注意事项

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