Plugins 导读

插件开发别直接import内部模块,用api.runtime就行

注册插件时注入的api.runtime对象封装了agent身份、子代理、任务流等核心能力,比直接引用宿主内部模块更安全。最常用的是api.runtime.agent.runEmbeddedAgent()启动普通agent回合,以及api.runtime.subagent.run()管理后台子代理。注意子代理的模型覆盖需要用户在配置中显式允许,否则会被拒绝。

先讲这一页到底在解决什么

插件开发别直接import内部模块,用api.runtime就行

注册插件时注入的api.runtime对象封装了agent身份、子代理、任务流等核心能力,比直接引用宿主内部模块更安全。最常用的是api.runtime.agent.runEmbeddedAgent()启动普通agent回合,以及api.runtime.subagent.run()管理后台子代理。注意子代理的模型覆盖需要用户在配置中显式允许,否则会被拒绝。

原文共 7 节,先看 Start Here 路径:/plugins/sdk-runtime 查看官方原文

第一站

🧰 Runtime 不负责“定义身份”,它负责“上班时怎么用工具”

SDK runtime 更像班主任给你发的工具包,不是你的名片。

📁

路径工具

像找自己的抽屉和工作目录。

🔐

配置工具

像把门口的设置卡拿出来翻一翻。

🌦

环境工具

像看今天外面是晴天还是下雨。

🎈

一句话

Runtime 是插件上班时顺手可拿的工具盒。

第二站

🛠 代码像在做什么

这些 helper 不是装饰,它们是在帮你少写很多重复的“去哪找、怎么读”的代码。

`resolvePath(...)`

像拿着地图确认“这个文件到底在房间哪一角”。

`readConfig(...)`

像翻总账本里的某一页。

`getEnv(...)`

像问门口的小风扇“今天设置了什么风向”。

最后记住

🎈 Runtime 的任务,就是让插件别把时间浪费在找东西上

该查的它帮你查,该拿的它帮你拿,插件就能把注意力放在真正的工作上。