API 参考

内置工具

install
安装 npm 包到 .agent 目录
package: string - 包名（如 zod 或 [email protected]）
loadSkill
加载指定技能
skill: string - 技能名称
shell
执行 Shell 命令
command: string - 要执行的命令
python-execute
执行 Python 代码
code: string - Python 代码
session_*
会话管理相关工具
session_create, session_list, session_load, session_delete 等
schedule_task
创建定时任务
name: 任务名称
scheduleTime: 执行时间
message: 提醒消息
ambient_goals
管理 Ambient Agent 目标
action: list/create/update/delete/activate
goalId: 目标ID

框架 API

// 创建 Agent
const { Framework } = require('foliko')
const framework = new Framework()
framework.loadPlugin('ai')

const agent = framework.createAgent({
  name: 'MyAgent',
  systemPrompt: '你是一个助手'
})

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

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

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

占位符

在 sharedPrompt 中使用：

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