首页/AI/AI 应用速查/消息角色:system / user / assistant / tool

消息角色:system / user / assistant / tool

messages 数组的角色语义:system(或 developer)定义行为约束,user 是用户输入,assistant 是模型历史输出(含工具调用请求),tool 回填工具执行结果。

AI 应用速查AI更新于 2026-10-12
角色system / user / assistant / tool 四类
顺序system 在前,多轮按 user→assistant 追加
工具链assistant 发起 tool_calls,tool 回填需带 tool_call_id
兼容部分新模型用 developer 替代 system,处理时兼容两者

构造多轮消息(Python)

构造多轮消息(Python)
messages = [
    {"role": "system", "content": "你是严谨的客服助手"},
    {"role": "user", "content": "查一下订单 A123 的状态"},
]
resp = client.chat.completions.create(model="gpt-4o-mini", messages=messages)
工具执行结果必须以 tool 角色回填并携带对应 tool_call_id,模型才能把结果与请求配对继续推理。

易错点

  • 把工具执行结果用 user 角色回填,配对关系丢失
  • system 里塞几千行长文档,挤压后续对话空间

数据来源与参考

  • OpenAI API 参考(Messages 与函数调用)

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌