# API 参考

## 内置工具

install
安装 npm 包到 .agent 目录
`package`: string - 包名（如 zod 或 lodash@4.17.21）
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()