Skip to main content
实例管理

连接实例

连接到已有实例,返回数据面访问所需的 token 与 domain 信息。兼容 E2B 连接实例协议,对应 SDK 的 connect()。

前提

已完成 Endpoint 与鉴权配置,详见API 总览与认证。

接口

POST /sandboxes/{sandboxID}/connect 连接到已有实例,返回数据面访问所需的 token 与 domain 信息。兼容 E2B 连接实例协议,对应 SDK 的 connect()。

路径参数

参数必填类型说明
sandboxID是string实例唯一 ID

请求体

请求体可选。
字段必填类型说明
timeout否integer连接后实例的超时时间,单位秒,取值范围 [300,604800]

请求示例

curl -X POST "$BASE_URL/sandboxes/sbx-xxx/connect" \
  -H "Authorization: Bearer $BAILIAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"timeout": 3600}'
其中 BASE_URL 为 https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/sandbox,BAILIAN_API_KEY 为阿里云百炼 API Key。

响应示例

{
  "sandboxID": "sbx-xxx",
  "templateID": "your-template-id",
  "envdVersion": "your-envd-version",
  "domain": "your-sandbox-domain",
  "envdAccessToken": "your-envd-access-token",
  "trafficAccessToken": "your-traffic-access-token",
  "envdUrl": "your-envd-url",
  "state": "running"
}

响应字段

字段类型说明
sandboxIDstring实例唯一 ID
templateIDstring模版 ID
envdVersionstringenvd 版本
domainstring数据面访问域名
envdAccessTokenstringenvd 访问 token
trafficAccessTokenstring流量访问 token
envdUrlstringenvd 访问地址
statestring实例状态,例如 running
Managed Agents
Security
RAG
应用调用
长期记忆
ParseX
框架