一、概述
本篇介绍如何在 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"