如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
總覽 智慧體存取權 ChatGPT 與 Codex 使用者文件 使用案例

外掛程式擴充功能

打造能自然融入 ChatGPT、使用體驗如同原生功能的外掛程式。

透過 OpenAI MCP 擴充功能,開發人員可以將外掛程式整合到 ChatGPT 的主要介面,包括側邊欄、撰寫工具和檔案檢視器。

ChatGPT 免費版和 ChatGPT Go 使用者即將可以在網頁版使用外掛程式擴充功能。外掛程式的現有功能不受影響。只有 ChatGPT 桌面應用程式支援在撰寫工具中使用提及功能。

示意圖顯示外掛程式擴充功能在 ChatGPT 側邊欄、設定、撰寫工具、對話和側面板中的呈現方式。

動手試用

試用我們的範例外掛程式 Bits & Bolts,體驗各種擴充功能。每當推出新的擴充功能,我們也會更新這個外掛程式。

開始開發

請到 GitHub 程式碼庫查看安裝說明、SDK 範例和完整規格。

伺服器就緒後,先連線並測試外掛程式,再將外掛程式打包以供發布。

擴充功能參考

擴充功能讓使用者能在 ChatGPT 的不同介面中,以新的方式與外掛程式互動。只需幾行 SDK 程式碼,就能宣告外掛程式支援哪些擴充功能。

擴充功能 使用者可以做什麼
側邊欄應用程式 從側邊欄開啟應用程式,並以全螢幕操作。
對話面板 在對話旁開啟應用程式,一邊操作一邊交談。
外掛程式設定 直接在 ChatGPT 中調整外掛程式專屬的設定。
檔案檢視器與編輯器 在外掛程式提供的介面中開啟支援的檔案,並在同一處讀取內容、查看即時更新及儲存變更。
顯示模式 選擇應用程式在 ChatGPT 對話中的顯示位置和方式。
深層連結 直接前往側邊欄應用程式中的特定頁面或項目。
擴充模型上下文 控制註解,以及附加的上下文在撰寫工具中的顯示方式。
擴充訊息傳送功能 將訊息傳送到目前的對話。桌面版也能將訊息傳送到新對話。網頁版則須使用「工作」模式才能傳送到新對話。
撰寫工具的提及功能 在 ChatGPT 桌面版的撰寫工具中尋找並選取外掛程式提供的內容。
擴充表單 讓使用者輸入結構化資料或從多張圖片中選取,再將回覆傳回工具。
外掛程式初始設定引導 在新對話或現有對話中,依照引導完成設定。

側邊欄應用程式

在全域側邊欄加入入口,讓使用者能以全螢幕開啟你的 MCP App。

註冊 MCP App 工具時,請將下列中繼資料作為 _meta 傳入。請將 ui://parts/library 替換為你註冊的 UI 資源 URI:

import type { OpenAIUiToolMetadata } from "@openai/mcp-extensions/server";

const toolMetadata = {
  ui: { resourceUri: "ui://parts/library" },
  "openai/ui": {
    entrypoints: [{ type: "global" }],
  } satisfies OpenAIUiToolMetadata,
};

使用 { type: "thread" } 即可在對話的側面板中加入入口。完整的註冊範例請參閱入口設定指南。

檔案檢視器與編輯器

當使用者開啟的檔案具有檢視器支援的副檔名時,即可在對話的側面板中開啟你的 MCP App。

在工具的 _meta 中設定檔案入口,並列出檢視器支援的副檔名:

import type { OpenAIUiToolMetadata } from "@openai/mcp-extensions/server";

const toolMetadata = {
  ui: { resourceUri: "ui://parts/viewer" },
  "openai/ui": {
    entrypoints: [{ type: "file", extensions: ["stl"] }],
  } satisfies OpenAIUiToolMetadata,
};

請將 ui://parts/viewer 替換為你註冊的 UI 資源。應用程式會收到使用者所開啟檔案的資源 URI。請依照檔案處理常式指南接收該 URI,並使用應用程式 SDK 讀取資源。

擴充表單

使用 ChatGPT 的原生元件,為標準 MCP 表單提供更豐富的互動方式。

import type {
  OpenAIForm,
  OpenAIFormOption,
} from "@openai/mcp-extensions/server";

function partSelectionSchema(parts: OpenAIFormOption[]): OpenAIForm {
  return {
    type: "object",
    properties: {
      part: {
        type: "string",
        title: "Part",
        oneOf: parts,
      },
    },
    required: ["part"],
  };
}

在表單請求中,將這份結構描述作為 requestedSchema 傳入。每個選項都使用 const 和 title,也可以透過 x-openai-thumbnail 指定圖示。向 OpenAI 註冊的 MCP 伺服器必須使用多輪往返請求(MRTR)。

擴充功能的實際應用

看看你熟悉的外掛程式如何運用擴充功能。

Canva

側邊欄分頁讓 Canva 使用者能直接在 ChatGPT 側邊欄建立及預覽設計作品,操作體驗如同原生功能。

查看外掛程式

Figma

撰寫工具的提及功能讓 Figma 使用者能直接在 ChatGPT 桌面應用程式中搜尋及提及檔案。

查看外掛程式

Adobe

副檔名處理常式讓 Adobe 使用者能直接在 ChatGPT 中使用 Acrobat 和 Photoshop 編輯檔案。

查看外掛程式