一、概述
本篇介紹如何在 macOS 環境下,通過編寫 OpenAPI Schema,開發自定義的專用插件,讓智能體可以調用外部 API,擴展功能至任意在線服務。實踐內容基于 Dify 平臺,適配 macOS 開發環境。
二、環境準備
1. 確認本地開發環境
- macOS 系統
- Dify 平臺已完成部署并可訪問
- 本地可以訪問公開測試 API
- 瀏覽器可以打開 Dify 后臺管理頁面
2. 準備測試 API
選擇一個簡單且無需鑒權的公共 API,例如:
curl https://api.chucknorris.io/jokes/random
該接口會返回一條隨機的 Chuck Norris 笑話,作為插件開發測試對象。
三、在 Dify 中添加自定義插件
1. 新建插件
- 登錄 Dify 后臺
- 依次進入「工具」→「自定義」→「創建自定義工具」
- 填寫基本信息:
- 插件名稱:Chuck Norris Joke Plugin
2. 輸入插件 Schema
在彈出的編輯框中粘貼以下 OpenAPI 規范內容:
{"openapi": "3.0.0","info": {"title": "Chuck Norris Joke API"