「Mac畅玩AIGC与多模态08」开发篇04 - 基于 OpenAPI Schema 开发专用 Agent 插件

一、概述

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