agent-apprenticeship

环境要求

• Node.js 与 npm 环境（README 全部命令基于 npx / npm）
• 至少一个导师模型提供商的 API Key（OpenAI / Anthropic / Gemini / OpenRouter）
• 可写入 ~/.agent-apprenticeship/.env.local 的本地文件权限
• 可联网的终端环境（用于拉取 npx 包并调用模型）

安装与启动步骤

1. 1初始化工作区

   在终端运行初始化向导，按提示完成首次配置；若想全部采用默认值可加 --defaults 参数跳过交互。

   npx agent-apprenticeship init

   复制

2. 2全局安装命令

   可选步骤：全局安装后即可直接使用 apprentice 命令，随后执行一次 init 完成初始化。

   npm install -g agent-apprenticeship
   apprentice init

   复制

3. 3检查环境状态

   用 settings 查看当前配置，用 doctor 做环境自检，确认依赖与密钥是否就绪。

   apprentice settings
   apprentice doctor

   复制

4. 4配置模型提供商

   运行 configure 配置学徒智能体与导师模型；密钥写入 ~/.agent-apprenticeship/.env.local 文件中。

   apprentice configure
   apprentice configure model

   复制

5. 5填写 API Key

   把导师模型密钥写进 ~/.agent-apprenticeship/.env.local；也可用 export 仅对当前终端会话生效。

   export OPENAI_API_KEY="sk-xxxxxxxx"
   apprentice doctor

   复制

6. 6运行第一个任务

   用 run 加任务描述启动工作流循环，完成后会打印本地运行目录与经验汇编路径。

   apprentice run "Create a short market map for AI procurement tools."

   复制

7. 7查看运行进度

   用 watch 加运行 ID 跟踪任务执行进度，run_id 由上一步输出中获得。

   apprentice watch 

   复制

8. 8检查并复用经验

   检查导出的经验汇编文件，安装为运行时训练，让后续任务复用积累的经验。

   apprentice ecosystem inspect 
   apprentice bundle check 
   apprentice learn install 

   复制

关键配置

如何确认成功

执行 apprentice doctor 无报错，且 apprentice settings 能显示已配置的智能体、模型与学徒模式。

常见问题

注意事项

• 密钥文件固定放在 ~/.agent-apprenticeship/.env.local，用 export 设置的环境变量只在当前终端会话有效。
• run 完成后终端会打印本地运行目录与 Experience Compilation 路径，后续 inspect / export / learn 命令都依赖该路径。
• README 仅给出 npx/npm 安装方式，未提供 pip 等 Python 安装命令，请以 README 的命令为准。
• 首次运行会拉取 npx 包并调用模型，请保证网络可访问 npm 源与所用模型服务。