SuperAPI AI 工具集

creating-extensions

智能体与模型

查看项目

更新于 10-16 06:23

技能介绍

用途:在 ~/.letta/extensions/ 下创建或更新受信任的全局 Letta Code 扩展。扩展是本地受信任应用,通过扩展 API 添加小型可组合能力,不导入应用内部模块。

主要能力:按需求选择形态——模型自主调用的本地能力用扩展工具;用户输入 /foo 触发提示或本地 UI 逻辑用扩展命令;可复用智能体工作流用技能加轻量命令;主智能体忙碌时可用 runWhenBusy: true 的命令,配合 handled、面板/状态,通常用 ctx.conversation.fork();临时输出用面板;持久小状态用状态值;响应生命周期或改写出站回合用事件。修改底部状态栏外观应使用 customizing-statusline,而非本技能。

使用方式:先检查 ~/.letta/extensions/ 中相关文件,保留无关代码,优先新建聚焦文件。简单工具/命令/事件按对应参考文档编写;多能力或有状态扩展还需阅读架构文档。默认写单文件扩展。为注册的命令、工具、事件、定时器、订阅和面板返回清理函数。核心形态为导出 activate(letta),用 letta.capabilities 守卫可选能力,返回清理函数。命令与事件中用 ctx.conversation 获取历史或 fork;工具中需要近期上下文时用 ctx.conversation.getHistory()。仅服务端专属 Letta API 调用才用 letta.client。完成后告知用户改动的绝对路径并运行 /reload;若扩展导致启动或命令处理异常,可用 letta --no-extensions 或 LETTA_DISABLE_EXTENSIONS=1 letta 恢复。

限制:目前仅支持全局受信任代码,不创建项目扩展;不假设有额外 npm 包;启动时不做意外副作用;输出简短;优先 Node/Bun 标准 API,shell 执行优先 execFile/spawn;加载状态不用 emoji;runWhenBusy 命令不返回 prompt;turn_start 变换需窄且可预期;不要导入 @/backend、@/cli 等内部模块。