作者注:以客服質檢請求爲例,拆解 GPT-6.2 Sol 在 Responses API 中的輸出驗收、會話狀態保持和後臺結果回收。
結論先行:把 GPT-6.2 Sol 接進生產系統,需要把同一個業務任務拆成四種行爲,並分別定義驗收標準。這四種行爲是界面即時反饋、機器可入庫結果、跨輪上下文和最終狀態。流式事件只負責顯示,入庫前必須拿到完整響應並通過 Schema 和業務校驗。跨輪信息要先確定由誰持有狀態。後臺任務只認響應 ID 和終態,通知可能重複,寫入必須冪等。
做到這四點的前提有兩個。第一,需要內置或自定義工具時,按 GPT-6.2 遷移說明走 Responses API,本文也只討論 Responses 的運行行爲。第二,如果經由聚合平臺調用,後臺模式、Webhook 等能力是否開放,以平臺當前配置爲準。在 API易 apiyi.com 上,gpt-6.2-sol 已公開掛牌 responses 與 chat 兩個入口。

GPT-6.2 Sol 生產接入知識地圖
整篇文章圍繞一條流程展開:發起請求 → 展示 → 延續 → 回讀 → 驗收。下面的流程圖標註了每一步的產物和對應的正文編號。
發起請求(model=gpt-6.2-sol,Responses API)
│
├─▶ 展示【第 1 節】
│ 增量事件 → 頁面實時顯示質檢意見
│ 終態事件 → 結束加載;完整響應 → Schema + 業務校驗 → 入庫 / 人工複覈
│
├─▶ 延續【第 2 節】
│ 自管歷史 / previous_response_id / Conversation
│ 常駐規則(developer) 與 當輪指令(instructions) 分離
│
├─▶ 回讀【第 3 節】
│ background 提交 → 保存響應 ID → Webhook 驗籤去重 → 按 ID 回讀 → 保存終態
│
└─▶ 驗收【第 4 節】
成功 / 不完整 / 重複通知 / 客戶端掉線 / Schema 變更
GPT-6.2 Sol 接入索引
| 章節 | 回答的問題 | 爲後文提供什麼 | 讀完能做到 |
|---|---|---|---|
| 1. 流式與結構化 | 頁面怎麼看流,機器怎麼收結果 | 定義“完成”和“可入庫”的判定 | 區分顯示路徑與入庫路徑 |
| 2. 多輪狀態 | 下一輪請求如何接上上一輪 | 確定狀態持有方和留存條件 | 只改當輪焦點,不破壞前綴 |
| 3. 後臺任務 | 用戶離開頁面後結果怎麼落庫 | 響應 ID、任務 ID 與終態的對應關係 | 實現驗籤、去重、冪等寫入 |
| 4. 上線驗收 | 哪些行爲必須提前驗證 | 彙總前三節的判定條件 | 產出可追溯的迴歸記錄 |
第 1 到 3 節分別對應一條運行路徑。如果你只做其中一條,可以按需查閱。第 4 節依賴前三節定義的狀態,適合最後閱讀。
GPT-6.2 Sol 相關術語 To Know
| 術語 | 解釋 |
|---|---|
| SSE | 服務端通過一條 HTTP 連接,按順序向客戶端推送事件的協議。 |
| Structured Outputs | 要求成功返回的結構化內容符合受支持 JSON Schema 的 API 功能。 |
| 拒絕響應 | 模型明確拒絕完成任務時返回的內容項,需要走單獨流程。 |
| 會話狀態 | 爲後續請求保留的消息、工具結果等上下文。 |
| 加密推理項 | 用來延續推理狀態的加密響應項,可以隨上下文回傳。 |
| 前綴 | 當前請求開頭部分中,與上一輪完全相同的上下文序列。 |
| 完成窗口 | 服務接受後臺請求後,爲這次響應設定的目標完成時間範圍。 |
| Webhook | 服務端嚮應用指定 URL 主動發送的帶簽名通知。 |
| 終態 | 任務已完成、失敗、不完整或被取消之後的最終狀態。 |
| 冪等 | 同一個回調或任務被重複處理,只產生一次業務效果。 |
1. GPT-6.2 Sol 流式輸出與結構化驗收
1.1 GPT-6.2 Sol 的兩條輸出路徑
先看一個客服質檢場景。值班坐席打開一條工單,頁面需要立刻顯示模型給出的督查意見。同一次分析的結果還要寫進質檢庫,供日終統計使用。這兩個需求對“完成”的定義不同,所以要分成兩條路徑處理。
| 路徑 | 消費者 | 依賴的信號 | 判定“完成”的條件 | 失敗時去向 |
|---|---|---|---|---|
| 展示路徑 | 坐席頁面 | response.output_text.delta 增量事件 |
收到 response.completed 或失敗類終態事件 |
頁面提示,保留已顯示內容 |
| 入庫路徑 | 質檢數據庫 | 完整響應對象 | Schema 校驗和業務校驗都通過 | 拒絕、不完整、格式錯誤分別進入人工複覈 |
流式請求設置 stream=true 後,服務端會通過 HTTP SSE 依次推送事件。頁面只需要把 response.output_text.delta 中的文字追加顯示。加載狀態則要等終態事件來結束,文字停止輸出並不代表任務完成。
1.2 GPT-6.2 Sol 流式顯示示例
下面的示例只負責展示。它把增量文字交給前端,並在終態時結束等待:
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com/v1" # API易 OpenAI 兼容入口
)
stream = client.responses.create(
model="gpt-6.2-sol",
input=[
{"role": "developer", "content": "你是客服質檢督查員,只依據工單原文給出意見。"},
{"role": "user", "content": "工單 #A1024:客戶三次催單未獲回覆……"},
],
stream=True,
)
for event in stream:
if event.type == "response.output_text.delta":
push_to_page(event.delta) # 頁面實時追加
elif event.type == "response.completed":
finish_loading(event.response.id) # 以終態結束加載
elif event.type in ("response.failed", "response.incomplete"):
show_error(event.type) # 失敗與不完整分開提示
push_to_page、finish_loading 等是業務側函數。終態事件的完整列表,以官方流式響應文檔爲準。
1.3 GPT-6.2 Sol 結構化輸出的驗收順序
在 Responses API 中,結構化輸出在 text.format 裏聲明,不放在消息裏。入庫路徑拿到完整響應後,按下面的順序判定:
- 檢查響應狀態。不完整響應(
status爲 incomplete)直接進入人工複覈,不嘗試解析半截 JSON。 - 檢查內容項。如果出現拒絕類型的內容項,走拒絕流程,不當作格式錯誤處理。
- 解析 JSON 並做 Schema 校驗。
- 做業務校驗:原工單存在,缺項要明確可見,不能被靜默補齊。
查看 GPT-6.2 Sol 結構化入庫完整代碼
import json
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com/v1"
)
QA_SCHEMA = {
"type": "object",
"properties": {
"ticket_id": {"type": "string"},
"verdict": {"type": "string", "enum": ["合格", "需整改", "信息不足"]},
"issues": {"type": "array", "items": {"type": "string"}},
"missing_fields": {"type": "array", "items": {"type": "string"}},
},
"required": ["ticket_id", "verdict", "issues", "missing_fields"],
"additionalProperties": False,
}
resp = client.responses.create(
model="gpt-6.2-sol",
input=[{"role": "user", "content": "請質檢工單 #A1024:……"}],
text={"format": {"type": "json_schema", "name": "qa_result",
"schema": QA_SCHEMA, "strict": True}},
)
def route(resp):
if resp.status == "incomplete":
return ("manual_review", "incomplete", resp.incomplete_details)
for item in resp.output:
for part in getattr(item, "content", []) or []:
if part.type == "refusal":
return ("manual_review", "refusal", part.refusal)
try:
data = json.loads(resp.output_text)
except json.JSONDecodeError:
return ("manual_review", "bad_json", None)
if not ticket_exists(data["ticket_id"]):
return ("manual_review", "unknown_ticket", data)
return ("save", "ok", data)
print(route(resp), resp.id)
注意,Schema 校驗通過只說明結構正確,不說明內容正確。工單號是否存在、缺項是否如實標出,這些檢查都要放在業務層完成。
🎯 技術建議:在測試環境中,可以通過 API易 apiyi.com 同時發起流式和非流式兩種請求,比較同一工單在兩條路徑上的終態與入庫結果。這樣能提前確認前端加載邏輯和入庫分支互不干擾。
2. GPT-6.2 Sol 多輪會話狀態延續
2.1 GPT-6.2 Sol 三條狀態路徑對比
坐席在同一條工單上補充了新事實,希望模型接着上一輪繼續分析。這時首先要回答的問題是:上下文由誰保存。
| 路徑 | 狀態持有方 | 留存條件 | 適合場景 | 可用平臺 |
|---|---|---|---|---|
| 自管歷史 | 應用自己 | 由應用決定;需按原順序回傳消息及必要的響應項 | 有合規要求,或需要完全掌控上下文 | 官方 API、API易 apiyi.com |
previous_response_id |
服務端響應鏈 | 響應仍可用時才能續接;響應對象默認保存 30 天 | 短週期的連續追問 | 以當前渠道配置爲準 |
| Conversation 對象 | 服務端會話對象 | 附在 Conversation 上的條目按該對象的留存規則處理 | 需要更持久保存的對話 | 以當前渠道配置爲準 |
如果選擇自管歷史,同時又希望推理能夠連續,就不能只回傳文字。必要的響應項都要保留並按順序回放,其中包括加密推理項。

2.2 GPT-6.2 Sol 只改審覈焦點的寫法
假設第二輪只想把審覈焦點從“響應時效”改爲“話術合規”。正確做法是:通用質檢規則放在鏈上第一條 developer 消息裏,本輪專用的焦點寫在頂層 instructions 中。instructions 只對提供它的那次請求生效,不會污染後續輪次。
first = client.responses.create(
model="gpt-6.2-sol",
input=[
{"role": "developer", "content": "通用質檢規則:依據工單原文;缺項必須列出……"},
{"role": "user", "content": "質檢工單 #A1024,關注響應時效。"},
],
)
second = client.responses.create(
model="gpt-6.2-sol",
previous_response_id=first.id,
instructions="本輪只審查話術合規,不重複時效結論。", # 僅作用於本次請求
input=[{"role": "user", "content": "補充:坐席第二次回覆使用了模板話術。"}],
)
這樣寫還有一個好處:首條規則保持不變,前綴也保持穩定。
2.3 GPT-6.2 Sol 的前綴變更風險
GPT-6.2 在幾種情況下可能清除相關推理項:改寫舊歷史、做部分模型切換(例如降級),以及切換用戶或組織。對於需要延續的 Standard 單代理會話,如果要調整推理檔或輸出 Schema,應追加一條適用的 configuration_update 項,而不是回頭修改舊配置。該項的具體字段,以 GPT-6.2 遷移指南爲準。
長期規則需要更新時,在上下文末尾追加一條新的 developer 消息,不去編輯舊規則,也不改動先前的工具和 Schema 配置。即使前綴保持穩定,緩存能否命中仍取決於具體請求和處理條件,不能把它當作必然結果。
3. GPT-6.2 Sol 後臺任務落庫
3.1 GPT-6.2 Sol 後臺提交與完成窗口
日終待審的工單摘要可能耗時較長,坐席也不會一直守在頁面上。這類任務用 background: true 提交。提交後立即持久保存返回的響應 ID,並把它和業務任務 ID 一一對應起來。
完成窗口按可接受的等待時間來選,默認值是 soonest。2h 和 8h 是 Standard 下的折扣窗口,目前屬於公開測試功能,而且提交時不能啓用流式。完成窗口的參數名和存儲要求,以後臺模式文檔爲準。
| 完成窗口 | 定位 | 流式 | 適合的質檢任務 |
|---|---|---|---|
soonest(默認) |
儘快完成 | 按後臺模式文檔 | 當班需要回看的複覈 |
2h |
Standard 折扣窗口,公開測試 | 不啓用 | 班後彙總 |
8h |
Standard 折扣窗口,公開測試 | 不啓用 | 日終批量摘要 |
3.2 GPT-6.2 Sol Webhook 驗籤、去重與回讀
任務處於排隊或進行中時,持續查詢同一個 ID 即可。如果收到完成事件,按下面的順序處理:
- 驗證簽名。驗籤失敗直接丟棄。
- 用
webhook-id去重。同一通知可能會被重投。 - 按
event.data.id回讀完整響應。通知本身不作爲結果使用。 - 按任務 ID 冪等寫入終態和結果。
查看 GPT-6.2 Sol 後臺任務回收代碼
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com/v1"
)
# 提交
job = client.responses.create(
model="gpt-6.2-sol",
background=True,
input=[{"role": "user", "content": "彙總今日待審工單摘要:……"}],
)
db.save_task(task_id="QA-20261120-01", response_id=job.id, status=job.status)
# Webhook 處理
def on_webhook(headers, raw_body):
event = verify_and_parse(headers, raw_body) # 驗籤,失敗則拋出
if db.seen_webhook(headers["webhook-id"]): # 去重
return 200
db.mark_webhook(headers["webhook-id"])
resp = client.responses.retrieve(event.data.id) # 回讀完整響應
task_id = db.task_by_response(resp.id)
db.upsert_result(task_id, status=resp.status, # 按任務 ID 冪等寫入
body=resp.output_text if resp.status == "completed" else None)
return 200
用戶關閉頁面後再回來時,前端只需要拿業務任務 ID 查詢本地庫。如果狀態還沒到終態,就由服務端用已保存的響應 ID 繼續查詢。
需要特別注意數據留存。後臺模式爲了支持回讀,會暫存響應數據。即使設置了 store: false,或者組織啓用了 ZDR,這一點也不變,所以要對照數據控制文檔確認是否可以接受。
💡 接入建議:Webhook 回調地址和後臺模式需要渠道端支持。通過 API易 apiyi.com 接入前,建議先確認當前賬戶分組是否開放後臺模式和回調能力。如果暫未開放,可以先用響應 ID 輪詢的方式跑通狀態機。
4. GPT-6.2 Sol 上線驗收清單
4.1 GPT-6.2 Sol 合成驗收表
下面的驗收表沿用客服質檢這一合成案例,把前三節的判定條件逐條落實爲可執行用例。
| 用例 | 輸入條件 | 預期狀態或結果 |
|---|---|---|
| 一次成功 | 真實存在的工單,字段齊全 | 終態 completed;Schema 和業務校驗通過;按任務 ID 寫入一條結果 |
| 一次不完整響應 | 人爲壓低輸出上限,或使用超長工單 | 狀態 incomplete;不解析 JSON;進入人工複覈並記錄原因 |
| 一次重複通知 | 同一 webhook-id 投遞兩次 |
第二次被去重;結果表只有一條記錄 |
| 一次客戶端掉線 | 流式過程中斷開瀏覽器連接 | 通過已存的響應 ID 恢復狀態;入庫結果不受頁面影響 |
| 一次更改 Schema | 會話中途新增一個必填字段 | 通過追加配置更新完成調整,不改寫舊配置;新結果按新 Schema 校驗 |
每條用例都要保存四項信息:調用的模型 ID(gpt-6.2-sol)、運行參數、響應 ID,以及應用側配置版本。出現問題時,可以憑這四項定位到具體的哪一次請求。

4.2 GPT-6.2 Sol 迴歸時的口徑
| 項目 | 記錄內容 | 說明 |
|---|---|---|
| 模型 | gpt-6.2-sol |
引用模型卡公開 ID |
| 端點 | Responses | 函數調用與內置工具走此路徑 |
| 推理檔 | 實際使用的檔位 | Responses 與 Chat Completions 都不接受 none |
| 用量 | usage.output_tokens 和其中的推理 token 子項 |
輸出計費已包含推理 token |
| 計費切檔 | 單次請求輸入是否超過 272K | API易公開定價接口以 272,000 輸入 token 切檔,實際出賬以賬單爲準 |
遷移舊系統時,端點、請求參數、多輪輸入、推理上下文和緩存這幾項要分別覈對。覈對完成後,用同一批用例同時迴歸示例請求和生產請求。
🚀 驗收建議:五類用例可以寫進 CI,每次修改 Schema 或切換渠道時自動跑一遍。藉助 API易 apiyi.com 的統一 Key,可以在同一套用例上對比不同分組的行爲差異。
驗收表中的五條用例全部通過、每條都能憑響應 ID 回溯,就說明這條質檢鏈路已經具備上線條件。
參考資料
- GPT-6.2 Sol 模型卡:模型 ID、上下文與計費規則
- 鏈接:
developers.openai.com/api/docs/models/gpt-6.2-sol
- 鏈接:
- GPT-6.2 遷移指南:端點選擇、前綴變更與配置更新
- 鏈接:
developers.openai.com/api/docs/guides/latest-model
- 鏈接:
- 流式響應與結構化輸出:SSE 事件與
text.format- 鏈接:
developers.openai.com/api/docs/guides/streaming-responses
- 鏈接:
- 會話狀態:
previous_response_id與 Conversations- 鏈接:
developers.openai.com/api/docs/guides/conversation-state
- 鏈接:
- 後臺模式與 Webhook:完成窗口、驗籤與去重
- 鏈接:
developers.openai.com/api/docs/guides/background
- 鏈接:
作者:API易 技術團隊
技術交流:歡迎在 API易 網站首頁聯繫我們,更多接入資料可訪問 docs.apiyi.com 文檔中心
