必须区分Space API与原厂模型接口：协议上前者用专属endpoint和space_id路径参数，后者兼容OpenAI规范；权限上前者需X-Api-Key+X-User-ID双认证，后者通常仅需单密钥；数据上前者默认启用保留期感知路由与边缘节点强制执行，后者由客户端自主控制；工具调用上前者固化工具链且结果融合进content，后者支持动态tools声明与tool_calls返回。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让 Agent 能调用 Grok Bot 或其他 xAI 封装的智能体能力，必须区分清楚 Space API（即 Grok Bot 开放 API）和原厂模型接口（如 OpenAI-style /v1/chat/completions）在协议、权限、数据流和工程约束上的实质性差异。
协议层：不是兼容接口，而是独立路由
Space API 使用专属 endpoint（如 https://api.x.ai/v1/spaces/{space_id}/chat），不兼容 OpenAI SDK 的默认请求结构。它要求显式传入 【space_id】 作为路径参数，而非 model 字段；若错误地把 space_id 塞进 JSON body 的 model 字段，服务端会直接返回 404，且不提示具体原因。
原厂模型接口（如 DeepSeek-V3、Qwen2.5）则严格遵循 OpenAI 兼容规范：Base URL + /v1/chat/completions + model 字段指定模型名。这类接口可被任何支持 OpenAI SDK 的客户端（如 LiteLLM、Ollama CLI、Cursor 插件）零配置接入。
权限与身份绑定：Space API 强制绑定用户上下文
调用 Space API 必须携带 【X-Api-Key + X-User-ID 双头认证】，其中 X-User-ID 是调用者在 xAI 平台注册时生成的唯一字符串，不可复用、不可伪造。漏传 X-User-ID 或值格式错误（如含空格、超长、非 Base64 编码）会导致 401 错误，且错误响应体为空，仅靠状态码判断容易误判为密钥失效。
原厂模型接口通常只需单密钥（Authorization: Bearer sk-xxx），部分平台（如 DeepSeek）支持通过请求头 X-DeepSeek-Workspace-ID 切换工作区，但该字段为可选，不影响基础调用通路。
数据生命周期控制：Space API 默认启用保留期感知路由
第一步：发起请求前，Space API 自动对 payload 中所有文本字段执行保留期标记分析——检测是否含身份证号、手机号、邮箱、企业内网域名等敏感模式；
亚马逊外贸B2B多CMS Agent系统，支持Shopify/WooCommerce/Magento三大平台，采用A2A架构协调库存、采购、财务、物流四大Agent，三层安全网保障审批合规，零配置开箱即用。
第二步：若命中预设策略（如含手机号 → 保留期=24h），系统强制将该请求路由至本地化推理节点，禁止缓存、禁止写入向量库、禁止进入工具链复用池；
第三步：响应返回时附带 X-Retention-Policy 头，明示本次调用的数据保留策略与实际执行节点类型（如 “edge-grok-sg” 表示新加坡边缘节点）。原厂模型接口无此机制，数据流向完全由客户端控制，是否缓存、是否记录 trace、是否上传日志，全凭调用方自行实现。
工具调用行为：Space API 的 Tool Use 是硬编码流程
方法一：Space API 不开放 tool_choice 或 tools 字段自由定义。所有工具能力（如搜索、查知识库、发邮件）已在 space 创建时由 xAI 后台固化为 JSON Schema，并随 space 配置下发。调用时只需在 message.content 中自然语言描述需求，系统自动匹配并触发对应工具链。
方法二：原厂模型接口（如 Anthropic、OpenAI）要求显式声明 tools 数组和 tool_choice 策略，工具 Schema 由调用方提供，每次请求均可动态变更。这意味着你可以临时禁用某个工具、增加自定义函数、或切换工具调用深度，灵活性高但出错概率也高——例如 tools 格式不合法会直接导致 400 错误，且错误信息极简。
注意：Space API 的工具执行结果不会以 tool_calls 形式返回，而是直接融合进 final assistant message.content 中。你无法拿到原始 tool response，也无法做中间态校验或重试。
