必须先创建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异常——这不是网络错误,而是强制校验,防止误用默认环境造成数据混流。
从经过验证的商家搜索、比较并购买产品。返回包含决策包(优缺点、适用场景、过敏原、验证价格)的结构化产品数据,而非原始网页抓取结果。无需验证码或身份验证。覆盖约980种产品和10家商家。适用于用户想要查找、比较或购买产品的场景。
如果你用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。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










