用途：对真实的 Metadata 实例执行集成测试，测试会发起实际 API 调用，而非模拟。适合在推送影响 API 调用的改动前本地验证。
用法：命令为 /run-integration [sdk]，其中 [sdk] 可选 python、typescript、java、cli、n8n 或 all（默认）。
前置条件：需配置环境变量 AI_SDK_HOST（Metadata 实例的 Base URL，如 https://your-instance.getcollate.io）、AI_SDK_TOKEN（有效 JWT 认证令牌），以及可选的 AI_SDK_TEST_AGENT（用于测试的 agent 名称）。
运行方式：全部测试使用 AI_SDK_HOST=https://... AI_SDK_TOKEN=... make test-integration。单个 SDK 分别为：Python 执行 cd python && AI_SDK_HOST=... AI_SDK_TOKEN=... pytest tests/integration/ -v；TypeScript 执行 cd typescript && AI_SDK_HOST=... AI_SDK_TOKEN=... npm run test:integration；Java 执行 cd java && AI_SDK_HOST=... AI_SDK_TOKEN=... mvn test -Dtest=IntegrationTest；Rust CLI 执行 cd cli && AI_SDK_HOST=... AI_SDK_TOKEN=... cargo test --test integration_test；n8n 执行 cd n8n-nodes-metadata && AI_SDK_HOST=... AI_SDK_TOKEN=... npm run test:integration。
验证内容：令牌有效性、agent 发现、agent 调用与响应、SSE 流式传输（需 AI_SDK_RUN_CHAT_TESTS=true）、无效请求的错误处理。
限制与注意：未配置 secrets 时 CI 中会跳过集成测试；AI_SDK_RUN_CHAT_TESTS=true 时会消耗真实 AI tokens。常见报错包括 401 Unauthorized（令牌无效或过期，需从 Metadata UI 获取新令牌）、404 Not Found（agent 不存在，检查 AI_SDK_TEST_AGENT）、Connection refused（host URL 错误，检查 AI_SDK_HOST）、Timeout（网络或防火墙问题，检查连通性）。