
FastAPI是什么?快速上手指南
随着人工智能浪潮席卷全球,各大科技公司纷纷推出对话式 AI 产品。百度文心一言(Ernie‑Bot) 作为国内领先的中文大规模对话模型,凭借深度中文预训练与百度成熟的知识图谱、搜索能力,迅速在智能客服、企业知识库、内容生成等场景脱颖而出。本文将围绕 文心一言 API 的技术原理、调用流程、核心能力与实践场景展开深度解析,并提供示例代码与最佳实践,帮助开发者快速上手并在业务中落地。
获取 Access Token
curl -X POST "https://aip.baidubce.com/oauth/2.0/token" \
-d "grant_type=client_credentials&client_id=API_KEY&client_secret=SECRET_KEY"
成功返回 access_token
用于后续请求鉴权。
调用对话接口
Endpoint:
https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions_pro?access_token=YOUR_TOKEN
请求参数(JSON):
{
"messages": [
{"role":"system","content":"你是一个智能助手,精通中文对话。"},
{"role":"user","content":"帮我查下北京明天天气。"}
],
"temperature":0.5,
"top_p":0.9,
"functions": [
{
"name":"get_weather",
"description":"获取天气信息",
"parameters":{
"type":"object",
"properties":{
"location":{"type":"string"},
"date":{"type":"string"}
},
"required":["location","date"]
}
}
]
}
响应解析
result
:模型生成的文字回复function_call
:若模型触发函数,则返回函数名与参数usage
:Token 使用详情,用于成本监控与限流system
、assistant
、user
三种角色字段,精准控制系统指令、模型回复与用户输入。function_call
。function_call.name
和 arguments
调用相应后端接口。role:"function"
的消息插入 messages
,再次调用对话接口,完成业务闭环。# 示例:Python 调用流程
import requests, json
# 1. 获取 token(略)
token = "YOUR_ACCESS_TOKEN"
# 2. 构造对话
messages = [
{"role":"system","content":"你是智能助手。"},
{"role":"user","content":"告诉我深圳明天下雨概率。"}
]
functions = [{
"name":"get_weather",
"description":"查询天气",
"parameters":{
"type":"object",
"properties":{
"location":{"type":"string"},
"date":{"type":"string"}
},
"required":["location","date"]
}
}]
# 3. 首次请求
resp = requests.post(
f"https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions_pro?access_token={token}",
json={"messages":messages, "functions":functions}
).json()
# 4. 若触发 function_call
if "function_call" in resp:
args = json.loads(resp["function_call"]["arguments"])
# 调用真实天气 API
weather_info = get_weather_api(args["location"], args["date"])
# 插入函数返回
messages.append(resp)
messages.append({"role":"function","name":"get_weather","content":json.dumps(weather_info)})
# 再次调用,获得最终用户回复
final = requests.post(...).json()
print(final["result"])
生成参数调优:
temperature
: 0.2–0.5 提升稳定性top_p
: 0.8–1.0 控制多样性penalty_score
: > 1 避免重复usage
字段监控 Token 消耗,合理配置熔断与重试策略。need_clear_history
进行敏感内容监测,确保数据治理合规。API Key
与 Secret Key
,实现调用隔离与审计。百度“千帆”开放平台为 文心一言 API 提供多语言 SDK(Python、Java、Node.js 等)、插件市场、示例工程,并与钉钉、飞书、微信等多端深度集成,形成完整生态。支持第三方开发者在电商、教育、医疗、制造业等领域快速创新与交付。
文心一言 API 凭借中文原生优势、知识增强能力和函数调用机制,为对话式 AI 带来全新可能。随着多模态融合与行业定制化进程加速,未来可在更多垂直场景实现智能助手全流程落地。开发者只需几行代码,即可接入百度 AI 对话服务,快速搭建高效、可靠、合规的智能体验。
👉 快速上手推荐
希望本篇文章能帮助你全面掌握文心一言 API 的技术要点与最佳实践,助力 AI 对话项目快速落地。祝你开发顺利!
原文引自YouTube视频:https://www.youtube.com/watch?v=toZsVQyH4PA