自定义插件

更新时间：2025-11-20

概述

秒哒提供的官方插件涵盖 AI 工具、支付服务、视频技术、语音与图像处理、文本处理、地图服务、信息搜索、登录验证等多类场景，可帮助您快速生成丰富的应用功能。但在实际搭建中，仍有许多更垂直、更个性化的业务需求无法完全由官方插件覆盖。为此，秒哒推出了自定义插件功能，允许您将所需的第三方 API 快速接入。通过提供 API 说明，即可自动生成插件，并在应用中进行调用。借助这一能力，您可以让应用具备更强的扩展性，将各类外部能力灵活融入，更高效地搭建符合自身需求的应用。

创建自定义插件

请通过以下路径进入【插件中心 > 创建插件】

提供API文档说明或URL

请将准确且详细的API说明粘贴至输入框内，如有API Key，请一并贴入并说明。可参考以下格式：

输入示例	图例
我要创建一个天气查询插件插件名称：天气查询插件描述：根据城市名称获取实时天气信息，包括温度、湿度和天气状况。请求方式：GET 完整请求 URL：https://api.example.com/v1/weather?city=Beijing&unit=C 请求头：Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.FAKE_PAYLOAD.SIGNATURE_FAKE 请求参数： city：必填，城市名称，例如 Beijing unit：可选，温度单位，C 或 F，默认 C 请求示例（curl）：curl -X GET "https://api.example.com/v1/weather?city=Beijing&unit=C" -H "Authorization: Bearer YOUR_API_KEY" 成功响应示例： {"city": "Beijing","temperature": 18,"unit": "C","condition": "Cloudy","humidity": 62} 错误响应示例： {"error": "invalid_city","message": "City not found"} 错误码列表： invalid_city：城市不存在（HTTP 404） missing_city：缺少城市参数（HTTP 400） invalid_unit：温度单位不合法（HTTP 400） unauthorized：鉴权失败（HTTP 401） rate_limited：请求过于频繁（HTTP 429） server_error：服务器异常（HTTP 500）

输入示例

图例

我要创建一个天气查询插件
插件名称：天气查询
插件描述：根据城市名称获取实时天气信息，包括温度、湿度和天气状况。
请求方式：GET
完整请求 URL：https://api.example.com/v1/weather?city=Beijing&unit=C
请求头：Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.FAKE_PAYLOAD.SIGNATURE_FAKE
请求参数：
city：必填，城市名称，例如 Beijing
unit：可选，温度单位，C 或 F，默认 C
请求示例（curl）：curl -X GET "https://api.example.com/v1/weather?city=Beijing&unit=C" -H "Authorization: Bearer YOUR_API_KEY"
成功响应示例：
{"city": "Beijing","temperature": 18,"unit": "C","condition": "Cloudy","humidity": 62}
错误响应示例：
{"error": "invalid_city","message": "City not found"}
错误码列表：
invalid_city：城市不存在（HTTP 404）
missing_city：缺少城市参数（HTTP 400）
invalid_unit：温度单位不合法（HTTP 400）
unauthorized：鉴权失败（HTTP 401）
rate_limited：请求过于频繁（HTTP 429）
server_error：服务器异常（HTTP 500）

使用技巧

生成的插件是否可用取决于您提供的信息是否足够准确与完备。您提供的API信息越详尽、准确，秒哒越容易为您生成可用的插件，具体可参考以下模板格式：

请帮我创建一个插件，插件内容如下：

插件名称
插件描述
请求地址
认证方式
请求说明
请求参数
请求示例
响应参数
响应示例
错误码

输入完成后，点击AI解析，秒哒将根据您提供的API说明进行解析并配置插件，预计等待一分钟，解析生成过程中请勿退出

若解析成功，界面将显示插件配置，详见2.2.部分；若解析失败，秒哒会停止解析并向您说明原因

修改配置

解析成功后，界面将展示出插件的配置

基本信息

秒哒会根据您提供的API自动配置插件图标、插件名称和插件描述，其中

配置内容	说明	图例
名称	插件的名称，配置后在插件中心-我的、插件选择列表、应用内插件已使用列表中将展示此名称
描述	插件的描述，配置后在插件中心-我的、插件选择列表、应用内插件已使用列表中将展示此描述
图标	插件的图标，配置后在插件中心-我的、插件选择列表、应用内插件已使用列表中将展示此图标

API Key

API Key是调用您API的凭证，秒哒会根据您提供的API自动识别并添加所需API Key，其中

内容	说明	图例
Secret Name	Secret Name 是插件认证时使用的环境变量名称，将在插件定义中使用。该内容由秒哒自动解析生成，您不可修改
Secret Value	Secret Value 为 Secret Name 对应的密钥。若进行了配置，将在应用中默认使用此密钥；若未配置，则需要您在应用内调用此插件时手动配置

插件定义

插件定义是秒哒在应用中集成此插件的重要依据，该内容根据您提供的API自动解析生成，您无法修改。生成后您可检查其中的API相关内容是否符合预期，包括所需接口是否齐全、接口说明及示例是否完整等。若不符合预期，可在顶部输入框内对原内容进行完善并重新解析生成

完成创建

当所有信息配置完成后，点击创建，该插件就创建完成了

调用自定义插件

测试插件

创建完成后，您可以在应用中调用此插件进行测试，您可以通过@的方式查看您创建的自定义插件，并调用它进行测试

测试自定义插件能否被正确调用

调用插件生成应用/功能后，您可以在点击左侧侧边栏的插件已使用列表中，检查此插件是否被使用

情形	说明	图例
已使用	若已使用，则会展示在插件已使用列表中，您可进行下一步的可用性测试
未使用	若未使用，请重新调用此插件尝试生成功能或应用。如果一直无法成功调用，请重新进入插件配置页。检查插件定义中各个接口的名称、描述是否符合该插件所涉及的场景。若不符合，请在顶部输入框中基于原内容完善使用场景等描述，然后重新解析生成插件定义

测试自定义插件的可用性

如果自定义插件可以被正确调用，接下来请您对基于此插件生成的功能可用性进行测试。例如您调用了自定义的全国油价查询插件，则需要测试其相关功能能否真正的查询油价

情形	说明	图例
功能可正常使用	此种情形表明您已经成功创建了一个可用的自定义插件，现在可以在您的所有应用中来使用它	/
功能不可正常使用	此种情况可能是您提供的密钥不正确或生成效果问题。您需要先确定提供的密钥是否正确，确定后如果还不能正常使用，请尝试通过对话进行修复。如果通过对话能够修复，说明您的自定义插件是可用的。若多轮对话都无法修复，则可能是自定义插件本身的问题，请回到该插件的自定义配置，检查插件定义中的API说明是否完备。例如接口定义、接口路径与请求方法、请求参数、请求示例、响应示例、错误码与说明等内容齐全且准确。如有缺漏，请修改顶部输入框描述后重新解析生成。