超级麦吉AI怎么写清技能需要哪些输入_超级麦吉AI技能输入要求设计方法

冬浩同学_9984

冬浩同学_9984

2026-11-22

838人浏览

原创

必须明确定义技能输入边界,按文档/API/逻辑类划分类型,用YAML声明inputs.yaml字段及约束,且在skill.py中通过Pydantic或手动校验确保输入合法。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

超级麦吉ai怎么写清技能需要哪些输入_超级麦吉ai技能输入要求设计方法

在超级麦吉中为AI Agent编写一个可运行、可复用的技能(Skill),必须明确其输入边界——不是随便丢一段文字就能触发,而是要让系统精准识别何时该调用这个技能、传入什么结构化数据才能执行成功。

确认技能类型与输入本质

先判断你要写的技能属于哪一类:是处理文档的(如“从PDF提取合同关键条款”),还是调用外部API的(如“查实时汇率并填入表格”),或是纯逻辑编排的(如“按优先级自动排序待办事项”)。不同类别的技能,输入字段的语义和约束完全不同。

文档类技能必须接收【file_id 或 file_url】,不能只写“上传文件”——超级麦吉不支持运行时弹窗选文件,所有文件必须已存在于工作区并被赋予唯一ID。

API类技能必须声明【required_headers 和 required_params】,漏掉 Authorization 或必填 query 参数会导致401/400错误且无友好提示。

定义输入Schema:用YAML写清楚字段名、类型、是否必填

在技能根目录下新建 inputs.yaml,内容格式严格如下:

```yaml
title: 合同风险点扫描
description: 输入合同文本,返回高亮风险条款及法律依据
inputs:
- name: contract_text
type: string
required: true
description: 原始合同全文,UTF-8编码,长度≤50000字符
- name: jurisdiction
type: string
required: false
default: "中华人民共和国"
enum: ["中华人民共和国", "香港特别行政区", "新加坡"]
```

注意:enum值必须全量列出,不能写“等常见法域”——超级麦吉解析器会直接报错退出。

type只接受 string / number / boolean / array / object 五种,不支持 date 或 file ——文件要用 file_id 字符串代替。

验证输入合法性:在skill.py入口处做硬校验

方法一:用Pydantic v2定义InputModel类

超级麦吉
超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

下载

```python
from pydantic import BaseModel, Field

class ContractScanInput(BaseModel):
contract_text: str = Field(..., min_length=10, max_length=50000)
jurisdiction: str = Field(default="中华人民共和国", pattern=r"^(中华人民共和国|香港特别行政区|新加坡)$")
```

方法二:手动if校验(适合轻量技能)

```python
def validate_inputs(inputs):
if not isinstance(inputs.get("contract_text"), str) or len(inputs["contract_text"]) raise ValueError("contract_text must be a non-empty string of at least 10 chars")
if inputs.get("jurisdiction") not in ["中华人民共和国", "香港特别行政区", "新加坡"]:
raise ValueError("jurisdiction must be one of the allowed values")
```

这一步不能省——超级麦吉不会自动拦截非法输入,错误会穿透到大模型层,生成不可控结果。

绑定输入与执行上下文:三步完成数据注入

第一步:在 skill.py 的 main() 函数开头,调用 get_input() 获取原始输入字典;

第二步:用上一步定义的 Pydantic 模型或校验函数清洗转换,得到结构化 input_obj;

第三步:将 input_obj 属性逐个注入到后续调用链中——比如把 input_obj.contract_text 传给 NLP 分析模块,把 input_obj.jurisdiction 作为检索向量库的 metadata 过滤条件。

不要在中间步骤里再临时拼接字符串读取输入字段,容易因 key 名 typo 导致 NoneType 错误且难以调试。

相关专题

更多
Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

2026.11.20

20

7

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

2026.11.20

20

17

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

2026.11.20

0

10

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

2026.11.20

60

8

PHP8.6升级迁移教程
PHP8.6升级迁移教程

本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。

2026.11.20

0

10

PHP8.6安装配置与FPM运维教程
PHP8.6安装配置与FPM运维教程

本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。

2026.11.20

40

10

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

2026.11.20

40

8

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

80

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

100

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
扣子入门级教程
扣子入门级教程

共0课时 | 312人学习

学习Agent,从Dify开始
学习Agent,从Dify开始

共0课时 | 168人学习