展开本页目录
开始前准备什么
- 本地练习资料可免费编辑与检查；执行Stitch需要可访问账号和已配置的官方MCP或SDK，云端额度/计划以账户页面为准。
- 在隔离练习项目操作，保留projectId、screenId和版本；本稿未调用目标云端，不能据此声称生成完成。
- 准备只读调用样例
- 构造客户端
- 观察自动连接
- 区分两种失败
- 用finally清理
- 限制重试范围
- 交付生命周期日志
1. 准备只读调用样例
脚本只做listTools与一次读取，写清目标项目来自练习台账。
密钥从环境变量读，不放在可下载的练习JSON里。
2. 构造客户端
按官方SDK创建StitchToolClient，记录本地阶段。
构造对象不等于已经完成网络认证。
3. 观察自动连接
首次listTools或callTool触发自动连接，按实际返回记录阶段。
无需为了演示无条件重复connect造成混乱。
官方界面与功能位置
以下为官方文档配图，具体版本与账号入口以当前产品为准。本课练习输入与验收对照见相邻步骤。
4. 区分两种失败
分别保留鉴权失败和工具参数失败的错误记录。
前者没有成功进入工具执行，后者不能简单叫连接断开。
5. 用finally清理
把await client.close()放在finally中，让成功与失败路径都执行。
不要仅在正常结尾close，异常抛出会绕开它。
6. 限制重试范围
读取失败可根据错误重试，写操作失败先核对是否已生效。
本课不把未知写入结果当可无限重放的连接问题。
7. 交付生命周期日志
只记录阶段、工具名和脱敏错误，检查没有密钥。
本地假客户端测试只证明控制流，不能称目标网络连接通过。
下载本课材料并开始操作
练习包包含本课的具体输入、可编辑数据、正反样例与七步说明。index.html 可离线查看原件和验收参考，actual-results.csv 用于记录你实际操作后的结果。
怎样确认已经完成
- 成功与异常路径都调用close。
- 连接/鉴权/工具参数错误分层记录。
- 日志与练习包不含密钥。
常见问题
SDK会自动连接，是不是不用close了？
为只读样例构造客户端，首次 listTools/callTool 时记录连接与工具阶段，分别测试成功和工具失败路径。用 finally 保证关闭客户端；连接成功不能等同请求成功，包内本地示例不冒充云端执行。
工具失败直接重跑十次可以吗？
先分辨错误发生在哪一层。读取和写入的重试风险不同，写入结果未知时应先读回状态，避免重复生成资源。