# 查看沙箱状态

列出当前工作区中的沙箱实例，查看各沙箱的生命周期阶段，并按沙箱 ID 读取网络模式等详情。

(sdk-ai-studio-sandbox-flow)=
## 任务流程

```text
初始化工作区沙箱服务客户端
            │
            ▼
列出沙箱 ID、名称与生命周期阶段
            │
            ▼
按沙箱 ID 查询阶段与网络模式详情
```

(sdk-ai-studio-sandbox-prepare)=
## 准备

1. 已完成 [使用 SDK](../../../quickstart/ai-studio/sdk.md) 中的服务地址、个人访问令牌与工作区配置。

(sdk-ai-studio-sandbox-s1)=
(sdk-ai-studio-sandbox-action-2)=
## 列出沙箱并读取详情

通过 `client.sandboxes(workspace_id)`（Go 为 `client.Sandboxes(workspaceID)`）调用 `list` 获取工作区内的沙箱列表，再传入目标沙箱 `id` 调用 `get` 读取该沙箱的名称、当前阶段（`phase`）与网络模式（`network_mode`）。

:::::{tab-set}
:sync-group: sdk-language

::::{tab-item} Python
:sync: python

```python
import os

import moi_product_sdk as sdk

client = sdk.new_with_personal_access_token(
    os.environ["PRODUCT_API_BASE_URL"],
    os.environ["PRODUCT_API_KEY"],
)
service = client.sandboxes(os.environ["WORKSPACE_ID"])

sandboxes = service.list()
for item in sandboxes:
    print(item.id, item.name, item.phase)
if not sandboxes:
    raise SystemExit("No sandboxes found in the current workspace")

sandbox = service.get(sandboxes[0].id)
print("Detail:", sandbox.id, sandbox.name, sandbox.phase, sandbox.network_mode)
```

::::

::::{tab-item} Go
:sync: go

```go
package main

import (
	"context"
	"fmt"
	"log"
	"os"

	sdk "github.com/matrixorigin/matrixflow/sdk/go-sdk"
)

func main() {
	ctx := context.Background()
	client, err := sdk.NewWithPersonalAccessToken(
		os.Getenv("PRODUCT_API_BASE_URL"),
		os.Getenv("PRODUCT_API_KEY"),
	)
	if err != nil {
		log.Fatal(err)
	}
	defer client.Close()

	service := client.Sandboxes(os.Getenv("WORKSPACE_ID"))
	sandboxes, err := service.List(ctx)
	if err != nil {
		log.Fatal(err)
	}
	for _, item := range sandboxes {
		fmt.Println(item.GetId(), item.GetName(), item.GetPhase())
	}
	if len(sandboxes) == 0 {
		fmt.Println("No sandboxes found in the current workspace")
		return
	}

	sandbox, err := service.Get(ctx, sandboxes[0].GetId())
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println("Detail:", sandbox.GetId(), sandbox.GetName(), sandbox.GetPhase(), sandbox.GetNetworkMode())
}
```

::::

:::::

(sdk-ai-studio-sandbox-limit)=
(sdk-ai-studio-sandbox-next)=
## 下一步

- [发现与选择智能体](发现与选择智能体.md#sdk-ai-studio-agents-s1)
- [调用智能体与跟踪任务](调用智能体并跟踪任务.md#sdk-ai-studio-agent-task-send)
