SuperAPI AI 工具集

action-creator

办公与效率

查看项目

更新于 10-15 20:21

技能介绍

用途:Action Creator 用于创建用户专属的一键操作模板,这些模板定义可复用的邮件操作,用户在聊天界面点击按钮即可执行。与监听器不同,操作由用户触发(点击),而监听器由事件自动触发。

主要能力:模板为 agent/custom_scripts/actions/ 下的 TypeScript 文件,需导出 config 对象(定义模板元数据与参数 schema)和 handler 函数(执行操作)。通过 ActionContext 可调用邮件 API(获取收件箱、搜索邮件、按 ID 获取)、直接邮件操作(归档、加星、标记已读、添加/移除标签)、发送邮件、调用 AI(context.callAgent)、注入会话消息、发送通知、访问外部 API 及日志记录。handler 需返回 ActionResult,包含 success、message,可选 data、suggestedActions、refreshInbox。

使用方式:先明确用户的具体供应商、客户、团队与工作流,确定每次执行变化的参数,然后在 agent/custom_scripts/actions/ 下创建文件。文件命名使用 kebab-case 并体现具体操作,如 send-payment-reminder-to-acme.ts。参数 schema 使用 JSON Schema,支持 string、number、boolean 及 enum。创建后,代理在对话中发现模板、填入具体参数生成实例,用户看到可点击按钮并执行。

适用场景:为特定供应商发送付款提醒、将 bug 转发给工程团队、归档特定来源的新闻邮件、总结来自 CEO 的每周更新等个性化邮件管理流程。

限制:模板应针对用户实际工作流,避免通用命名;需处理错误并返回可读消息;建议设计为可安全重复运行;完整规范见项目根目录 ACTIONS_SPEC.md。