自定义技能

更新时间：2026-05-15

概述

秒哒官方技能已覆盖 AI 工具、支付服务、视频技术、语音与图像处理、文本处理、地图服务、信息搜索、登录验证等多类场景，助您高效完成任务或搭建功能丰富的应用。

然而，面对更垂直、更个性化的业务需求，官方技能难以全面满足。为此，秒哒推出了自定义技能——只需上传 .zip 技能包，即可快速完成技能创建，并在执行任务或生成应用时灵活调用。

借助自定义技能，您可以为秒哒注入更丰富、更专业的能力与知识，从而更高效地完成特定任务，或打造真正贴合自身业务需求的应用。

集成外部API说明

目前官方暂时下架了提供API文档链接或API说明创建自定义插件的方式。如果您需要接入外部API，则可以先采用以下方式进行接入。后续，秒哒将会支持对话将API直接创建为自定义插件的能力，创建后即可快速在执行任务或应用生成时使用，敬请期待。

方式	说明	图示
直接在对话中集成	您可以直接将API说明或API文档链接在对话中提供给秒哒，秒哒即可帮您接入API 示例：请将以下API生成一个天气查询应用 https://openweathermap.org/api/current
直接对话或使用"技能创建与编辑"技能生成技能包，并导入创建自定义技能	在对话中@"技能创建与编辑"技能，并贴入API说明或API文档链接，随后秒哒即可帮您将API转换为技能包，您下载后可再在自定义技能中导入创建自定义技能。示例：请使用@技能创建与编辑创建一个.zip格式的天气查询技能包插件名称：天气查询插件描述：根据城市名称获取实时天气信息请求方式：GET 请求方式：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的技能包，可直接通过自定义技能导入，具体操作见后续章节	/

创建自定义技能

请通过以下路径进入【技能 > 创建技能】

上传技能

上传技能格式说明

进入创建技能页面后，您可以通过点击或拖拽的方式上传 .zip 技能包或 SKILL.md 文件。技能包和 SKILL.md 文件中需遵循标准的 SKILL 格式，可参考以下标准：

上传内容	说明	文件/内容结构示例
.zip 技能包	当您上传技能包时，推荐您的技能包包含以下文件，其中SKILL.md是必须的文件： SKILL.md（必需，技能说明文件）附加资源（可选） scripts/（脚本）可执行代码，例如 Python、Shell 等自动化脚本 references/（参考资料）产品文档、业务规则、知识库等内容 assets/（素材文件）模板、图标、字体、图片等资源	financial-analysis.zip └── financial-analysis/ ├── SKILL.md # 必需，技能说明文件 ├── scripts/ # 可选，脚本 │ └── analyze.py ├── references/ # 可选，参考资料 │ └── knowledge.md └── assets/ # 可选，素材文件 └── icon.png
SKILL.md	SKILL.md文件内容结构如下，更多格式要求详见下方注意事项章节： --- name: skill-name description: \| 简要描述该 Skill 的能力和适用场景。 Use when: (1) 场景一, (2) 场景二 --- # Purpose 说明该 Skill 的核心目标。 # Instructions 定义该 Skill 的执行流程和行为规则。 # Examples 输入：xxx 输出：xxx # Guardrails 定义使用边界和限制条件。	--- name: financial-analysis description: \| 分析企业财务数据并生成洞察。 Use when: (1) 财报分析, (2) 公司对比, (3) 风险识别 --- # Purpose 帮助用户分析财务数据，识别业务趋势与潜在风险。 # Instructions 1. 理解用户输入的数据或问题 2. 分析关键财务指标 3. 输出结构化结论 # Examples 输入：某公司近三年财报输出：营收趋势、利润变化、风险提示 # Guardrails - 不编造数据 - 数据不足时主动询问

注意事项

秒哒上传的 .zip 技能包和 SKILL.md 文件需要注意以下格式要求

注意事项	说明	示例
SKILL.md文件名称	技能说明文件必须命名为 SKILL.md（区分大小写）	SKILL.md
Frontmatter	SKILL.md 文件内容必须以 Frontmatter 开头，并使用 --- 包裹	--- name: financial-analysis description: \| 分析企业财务数据并生成经营洞察。 Use when: (1) 财报分析, (2) 公司对比 --- # Instructions 1. 分析用户输入 2. 提取关键指标 ......
name字段	SKILL.md 中的 name 字段，必填，作为 Skill 唯一名称，仅支持小写字母、数字、连字符“-”
description字段	SKILL.md 中的 description 字段，必填，描述 Skill 的能力和适用场景，支持中英文
文件内容	SKILL.md 中的 Frontmatter 后必须有实际内容，不能为空
根目录名称	ZIP 根目录名称必须与 SKILL.md 中 name 字段完全一致，同样仅支持小写字母、数字、连字符“-”	根目录名称（技能包名称）：financial-analysis SKILL.md 中 name 的名称: financial-analysis

上传完成后，秒哒将根据您提供的进行解析并配置技能，预计等待一分钟，解析生成过程中请勿退出

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

修改配置

解析成功后，界面将展示出技能的配置

基本信息

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

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

环境变量

当技能包含环境变量时，将会展示环境变量模块。环境变量是此类技能运行所需的配置信息，例如API Key，配置后技能将在调用时从此处安全读取，不会对外暴露，其中

内容	说明	图例
Name	Name 是调用技能时使用的环境变量名称。该内容由秒哒自动解析生成，您不可修改
Value	Value 为 Name 对应的值，填入后，调用技能时将默认使用此配置；若未配置，则需要您在项目内调用此技能时手动配置

技能定义

技能定义是秒哒在应用中集成此技能的重要依据，该内容根据您提供的技能包自动解析生成，您无法修改。生成后您可检查其中的相关内容是否符合预期，包括技能文件是否齐全，文件内容是否准确。若涉及API，则还需检查所需接口是否齐全、接口说明及示例是否完整等。若不符合预期，可在修改对应技能文件后重新上传文件解析

完成创建

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

调用自定义技能

测试技能

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

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

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

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

测试自定义技能的可用性

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

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