必须用 curl 绕过 SDK 直接测试 Agent Space API，验证响应、参数、超时与鉴权；先检查状态码（200/201/202）、output 字段及 X-RateLimit-Remaining 响应头；再通过 --connect-timeout 和 --max-time 模拟超时场景定位网络或后端问题；最后用 bash 循环批量验证多个 Agent ID。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要验证 Agent Space API 是否正常响应、参数是否生效、超时与鉴权逻辑是否符合预期，必须绕过 SDK 直接构造原始 HTTP 请求进行测试。
用 curl 手动发送测试请求
这一步是排查问题的起点，能快速区分是 SDK 封装导致的异常，还是服务端真实故障。
执行以下命令，替换 your-agentspace-domain 和 Bearer xxx 为实际值：
curl -v -X POST https://your-agentspace-domain/v1/agents/xxx/run -H "Authorization: Bearer xxx" -H "Content-Type: application/json" -d '{"input": "test"}'
注意：-v 参数会显示完整请求头、响应头和耗时明细，务必保留它；若省略，将无法判断 time_connect 或 time_starttransfer 等关键阶段是否异常。
检查响应中的关键字段
收到响应后，先看三处内容：
HTTP 状态码必须是 200、201 或 202；4xx 表示客户端错误（如 token 过期、路径不存在），5xx 表示服务端异常（如模型未加载、DB 连接失败）。
响应体中必须包含 "output" 字段且非空；若返回 {"status":"running","task_id":"abc123"}，说明启用了异步模式，需另行轮询 /v1/tasks/abc123 获取结果。
检查响应头中是否有 X-RateLimit-Remaining，有则表示限流已启用；若连续返回 429，说明当前 token 已达配额上限，不能归因为超时。
模拟不同超时场景验证配置
方法一：强制触发 connect timeout
在 curl 中加 --connect-timeout 0.1，让连接在 100ms 内失败。若返回 "Failed to connect" 或 "Connection refused"，说明 DNS、端口或防火墙存在问题，而非 AgentSpace 后端慢。
方法二：强制触发 read timeout
加 --max-time 0.5，限制整个请求不超过 500ms。若返回 "Operation timed out" 且 time_connect 很小（如 0.02s），但 time_starttransfer 接近 0.5s，说明后端处理卡顿，应查 runtime.log 中的 slow query 或 model call stuck 日志。
不要同时调大 connect 和 read 超时值再测试——这会掩盖真实的网络层故障点。
批量验证多个 Agent ID
第一步：准备 agent_ids.txt，每行一个合法 agent_id（如 agent_abc123、agent_def456）
第二步：运行以下 bash 循环：
while IFS= read -r id; do echo "Testing $id..."; curl -s -o /dev/null -w "%{http_code}\n" -X POST "https://your-agentspace-domain/v1/agents/$id/run" -H "Authorization: Bearer xxx" -d '{"input":"ping"}'; done
第三步：观察输出是否全为 200；出现 404 表示 agent_id 不存在或未发布，401 表示 token 无效，000 表示网络不可达。
这一步能一次性确认所有已注册 Agent 的可访问性，避免逐个点开 Web UI 测试。
