SuperAPI AI 工具集

omi-plugin-development

编程与开发

查看项目

更新于 10-15 20:05

技能介绍

用途:该技能用于指导开发 Omi 插件与应用,覆盖 webhook 模式、聊天工具和 OAuth 集成等场景。适用时机包括创建新插件、实现 webhook 处理器、为 LangGraph 添加聊天工具、设置 OAuth 集成以及构建基于提示词的应用。

主要能力:插件分为两类。基于提示词的应用无需服务器,只需定义提示词,可自定义 AI 人格的聊天提示词与记忆提取的记忆提示词。集成应用需要服务器端点,基于 webhook,支持记忆创建触发、实时转录、聊天工具(LangGraph 自定义工具)和音频流处理。

使用方式:webhook 可用 FastAPI 实现,如记忆创建 webhook 接收 id、content、category、user_id 字段;实时转录 webhook 接收实时转录片段并可触发动作。聊天工具使用 langchain 的 @tool 装饰器定义,注册到应用配置后,在应用启用时于智能体聊天路径中可用。OAuth 使用 authlib 的 OAuth2 配置 client_id、client_secret 与 server_metadata_url,并实现授权重定向。插件通过应用清单配置,包含 id、name、description、capabilities(如 memory_trigger、real_time_transcript、chat_tools)和 webhook_url。

最佳实践:优雅处理 webhook 错误、保证幂等性、实现速率限制、验证 webhook 签名、编写插件 API 文档,并先用 webhook.site 测试。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;相关文档位于 docs/ 文件夹并部署于 docs.omi.me,另有 .cursor 规则与子代理资源。