必须先创建Workspace才能调用Agent Space的API，因为API依赖Workspace ID（如abc123）绑定，所有请求需携带X-Workspace-ID头，且密钥仅在对应Workspace内有效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想调用Agent Space的模型能力却分不清API和Workspace该用哪个，结果在控制台里反复切换页面、配置密钥、测试接口，最后发现根本没建Workspace——所有API调用都返回404或权限拒绝，因为Agent Space的API不是裸露服务，它必须绑定到一个真实存在的Workspace才能生效。
Workspace是运行容器，不是可选配置
登录Agent Space后进入「Workspaces」页，点击【+ New Workspace】创建一个新空间；输入名称（如“销售线索处理”）并填写【不少于20字的描述，否则表单无法提交】；选择“Blank Workspace”模板——预设模板自带权限锁和外部数据源绑定，新手无法解绑，强行使用会导致后续API调用始终被拦截。
创建成功后，页面URL会变成类似/workspaces/abc123的路径，这个abc123就是Workspace ID，后续所有API请求头中必须携带X-Workspace-ID: abc123，缺一则403。
API是操作入口，但不独立存在
Agent Space没有全局API端点。所有HTTP请求必须指向带Workspace上下文的路径，例如：POST /v1/workspaces/abc123/agents，而不是/v1/agents。
调用agent.run()时若未传入workspace_id参数，SDK会抛出WorkspaceNotSpecifiedError异常——这不是网络错误，而是强制校验，防止误用默认环境造成数据混流。
如果你用curl测试，必须手动加Header：-H "X-Workspace-ID: abc123"，漏掉这行，哪怕token正确、URL拼对，也会立刻返回401 Unauthorized，因为系统连该Workspace是否存在都还没查。
权限与隔离完全由Workspace决定
第一步：进入已创建的Workspace → 点击左侧「Settings」→ 「API Access」；
第二步：开启「Enable API Calls」开关 → 系统自动生成一对API Key + Secret，且【该密钥仅在此Workspace内有效，跨Workspace不可复用】；
第三步：复制Key，在代码中初始化client时显式传入：Client(api_key="sk-xxx", workspace_id="abc123")；
注意：如果删掉这个Workspace，所有基于它的API Key立即失效，不会进入回收站或保留宽限期，调用直接500 Internal Error。
