验证Agent Space API需先确认域名、API密钥及网络连通性；执行健康检查curl -I返回200、/v1/health返回{"status":"ok"}、/v1/me返回用户信息、创建Agent得201状态码即成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在终端里验证 Agent Space API 是否可用，必须先确保你已获得有效的 API 密钥、目标环境地址，且网络能直连该服务端点。直接调用失败往往不是因为命令写错，而是密钥未生效或域名解析失败。
确认 API 基础配置
打开终端，执行以下命令检查基础连通性：
curl -I https://api.agentspace.example.com/health
将 【agentspace.example.com】 替换为你实际使用的 Agent Space 域名（如 sandbox.agentspace.dev 或你的私有部署地址）。若返回 404 或 Connection refused，说明域名错误或服务未就绪，不要继续下一步。
检查环境变量是否已正确设置：
echo $AGENT_SPACE_API_KEY
如果无输出，说明密钥未导出。此时需运行 export AGENT_SPACE_API_KEY="sk-xxx"（Linux/macOS）或 $env:AGENT_SPACE_API_KEY="sk-xxx"（PowerShell），【密钥必须以 sk- 开头，且不能含空格或换行】。
用 curl 发起带认证的 API 验证请求
方法一：最简健康检查（无需密钥）
curl -s https://api.your-agentspace-domain.com/v1/health | jq .status
该接口不鉴权，仅确认服务进程存活。返回 {"status":"ok"} 即表示后端 HTTP 层正常。
方法二：带密钥的用户身份验证（推荐）
curl -H "Authorization: Bearer $AGENT_SPACE_API_KEY" \
-H "Content-Type: application/json" \
-X GET "https://api.your-agentspace-domain.com/v1/me"
成功时返回包含 user_id、org_id 的 JSON；若报 401，说明密钥无效或过期；若报 403，说明该密钥无访问 /v1/me 权限，需联系管理员分配 scope。
验证 Agent 创建能力（关键业务路径）
第一步：准备最小化 Agent 定义 JSON
创建临时文件 agent-test.json，内容为：
{
"name": "test-cli-agent",
"model": "qwen-plus",
"description": "for CLI validation only"
}
第二步：提交创建请求并捕获响应状态码
HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
-H "Authorization: Bearer $AGENT_SPACE_API_KEY" \
-H "Content-Type: application/json" \
-X POST "https://api.your-agentspace-domain.com/v1/agents" \
-d @agent-test.json)
echo $HTTP_CODE
预期输出应为 201。若为 422，说明 JSON 结构有误（如 model 字段值不被支持）；若为 429，说明当前密钥已达速率限制。
第三步：清理测试 Agent（避免污染列表）
AGENT_ID=$(curl -s -H "Authorization: Bearer $AGENT_SPACE_API_KEY" \
"https://api.your-agentspace-domain.com/v1/agents?limit=1" | jq -r '.data[0].id')
curl -X DELETE \
-H "Authorization: Bearer $AGENT_SPACE_API_KEY" \
"https://api.your-agentspace-domain.com/v1/agents/$AGENT_ID"
