Actoviq Agent SDK 中文教程

这是一套面向当前 SDK 的中文上手教程，目标是让你从零开始，逐步掌握 clean SDK、skills、tools、session、memory 和 MCP 的使用方式。

推荐阅读顺序：

1. 01-setup-and-quickstart.md
2. 02-basic-run-stream-session.md
3. 03-tools-permissions-mcp.md
4. 04-agents-swarm-memory-workspace.md
5. 05-testing-troubleshooting-cheatsheet.md
6. 06-build-a-complete-clean-agent.md
7. 07-workflow-orchestration.md

如果你想最快跑起来：

1. 先看 01-setup-and-quickstart.md
2. 运行 npm run example:actoviq-quickstart
3. 或启动 CLI REPL：npx actoviq-react [工作目录]（scrollback 模式，非完整 TUI）

如果你想完整做一个真正可用的 clean SDK 项目，推荐直接阅读：

• 06-build-a-complete-clean-agent.md

整个教程里的主路径是 createAgentSdk()，适合绝大多数业务开发和二次封装。