OpenAI
此頁面由機器翻譯。查看原文英文文章

由 OpenAI API 的 Completions 遷移至 Chat Completions

如何由舊版 OpenAI Completions API 遷移至 Chat Completions

更新日期:9 days ago

Chat Completions 是用於 OpenAI 最新模型的標準 API。你可以透過我們的文字生成開發人員指南了解如何開始使用。

截至 2025 年 3 月 11 日,我們已發佈全新智能代理平台的構建區塊。詳情請參閱我們的 Responses API API 文件、包括網頁搜尋檔案搜尋電腦使用在內的工具,以及我們配備追蹤功能的智能代理 SDK

由提示詞轉為訊息

如要與我們的模型進行更互動、更動態的對話,你可以使用聊天格式的訊息,而非完成項目所用的舊式提示詞風格。

運作方式如下:

  • 你不是把單一字串作為提示詞傳送,而是把訊息清單作為輸入傳送。

  • 每則訊息都有 rolecontent

  • 常見角色包括 systemuserassistantdevelopertool。工具訊息用於工具/函數結果,並且必須對應至助理的工具呼叫。為向後兼容,函數訊息仍可能會被接受,並在伺服器處理時轉換為工具訊息。開發人員訊息可能會因應模型支援而重新映射。

  • content 包含來自該角色的訊息文字。

  • 系統指示可以為對話提供高層次指示

  • 訊息會按其在清單中出現的順序處理,助理亦會相應回應。

即使是基本的 Completions 請求,也可以透過 Chat Completions 完成,如下所示:

| 之前 | 現在 | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |

現在,只要延伸對話中的訊息清單,就能比以往更輕鬆地與模型來回互動。

'messages': [{'role':'user', 'content':'講個笑話給我聽'}, 
{'role':'assistant', 'content':'點解隻雞要過馬路'},
{'role':'user', 'content':'我唔知,點解隻雞要過馬路'}]

系統指示

你亦可以使用系統層級指示,在整段對話中引導模型的行為。例如,使用系統指示和如下訊息

'messages': [{'role':'system', 'content':'你是一位說話風格像莎士比亞的助理。'}, 
{'role':'user', 'content':'講個笑話給我聽'},

將會產生類似以下的結果

{...
'message': {'role':'assistant',
'content':'點解隻雞要過馬路?為咗去對面,但說真的,對面滿是危險與凶險,所以牠很快就從來處折返,誠然如此!'}
...}

如果你想探索毋須自行管理訊息對話記錄的選項,請查看 Assistants API

這篇文章對你有幫助嗎?