API 参考

内置工具

install

安装 npm 包到 .agent 目录

package: string - 包名（如 zod 或 [email protected]）

loadSkill

加载指定技能

skill: string - 技能名称

shell_execute

执行 Shell 命令

command: string - 要执行的命令

python_execute

执行 Python 代码

code: string - Python 代码

mcp_execute

执行 MCP 工具

server: string - 服务器名称
tool: string - 工具名称
arguments: object - 工具参数

mcp_reload

重载 MCP 服务器

session_*

会话管理相关工具

session_create, session_list, session_load, session_delete 等

audit_query

查询审计日志

query: string - 查询条件

占位符

在 sharedPrompt 中使用：

{{WORK_DIR}}   # 工作目录
{{HOME_DIR}}  # 主目录
{{HOST_NAME}} # 主机名
{{PLATFORM}}  # 平台
{{TIME}}      # 当前时间
{{DATE}}      # 当前日期

框架 API

// 创建 Agent
const agent = framework.createAgent({
  name: 'MyAgent',
  systemPrompt: '你是一个助手',
  sharedPrompt: '工作目录: {{WORK_DIR}}',
  metadata: {
    key: 'value'
  }
})

// 发送消息
const response = await agent.chat('你好')

// 流式发送
for await (const chunk of agent.chatStream('你好')) {
  console.log(chunk)
}

// 注册工具
framework.registerTool({
  name: 'my_tool',
  description: '...',
  inputSchema: z.object({...}),
  execute: async (args) => {...}
})

// 重载插件
await framework.reloadPlugin('plugin-name')
await framework.reloadAllPlugins()