用途：面向 Trigger.dev 的 chat.agent 高级与运维场景，按需加载；完整且与版本绑定的参考随已安装的 @trigger.dev/sdk 提供，先阅读再编码，避免与项目 SDK 版本漂移。
主要内容：技能文档位于 node_modules/@trigger.dev/sdk/skills/trigger-chat-agent-advanced/SKILL.md，涵盖 Sessions 原语、自定义传输与线协议、子智能体、HITL、引导（steering）、动作、后台注入、快速启动、韧性（压缩/恢复/OOM/大负载）、chat.local、测试与升级。完整文档随包内置在 node_modules/@trigger.dev/sdk/docs/ai-chat/，含 patterns/ 目录；可用 grep 搜索 API，如 grep -rl "mockChatAgent" node_modules/@trigger.dev/sdk/docs/。若路径不存在说明未安装 SDK，需先安装；非提升布局可用 node -p "require.resolve('@trigger.dev/sdk/package.json')" 定位包，再读其旁 skills/ 与 docs/。
必要用法与要点：后续消息不能重复 POST /api/v1/sessions，而应追加到会话输入通道，如 POST /realtime/v1/sessions/${id}/in/append，body 为 { kind: "message", payload }。.in/.out 应使用创建响应中的 publicAccessToken（会话级），x-trigger-jwt 为运行级无法订阅。chat.local 需在 onBoot 初始化，不能在 onChatStart（续跑会跳过）。消息历史写入要内联 await，勿用 chat.defer，否则中途刷新会读到空数组。HITL 工具不要给 execute，由前端通过 addToolOutput 与 sendAutomaticallyWhen 提供答案。子智能体/重工具需同时在 chat.agent({ tools }) 声明（自定义 agent 则传给 convertToModelMessages(uiMessages, { tools })）。重量级 execute 工具不要导入 Head Start 路由模块，schema 应放仅依赖 ai 与 zod 的模块。单条 tool 输出超过约 1 MiB 会抛 ChatChunkTooLargeError，先落库再只发 id。活动发送路径不要设 X-Peek-Settled: 1，仅用于重载重连路径。文档词汇注意：部分示例仍用旧 trigger:turn-complete，自定义读取器应按 trigger-control 头过滤。MCP 驱动的 agent 聊天工具（list_agents、start_agent_chat、send_agent_message、close_agent_chat）是 MCP 服务器工具，供 Claude Code / Cursor 使用，不可作为 SDK 函数导入。
适用场景与限制：适用于使用 Trigger.dev 构建高级 chat.agent 的开发者，尤其是 Sessions、HITL、子智能体、传输与韧性相关需求。限制：资料未提供收费、价格与平台支持细节，均暂未提供；部分要点以英文原文表述。