<span id="查看沙箱状态"></span>

# Inspect Sandboxes

List sandbox instances in the current workspace, check each sandbox's lifecycle phase, and fetch detailed properties such as network mode by sandbox ID.

(sdk-ai-studio-sandbox-flow)=
<span id="任务流程"></span>

## Task flow

```text
Initialize the workspace sandboxes client
                   │
                   ▼
List sandbox IDs, names, and lifecycle phases
                   │
                   ▼
Fetch phase and network_mode details by ID
```

(sdk-ai-studio-sandbox-prepare)=
<span id="准备"></span>

## Prerequisites

1. Complete the endpoint, personal access token, and workspace setup in [Use the SDK](../../../quickstart/ai-studio/sdk.md).

(sdk-ai-studio-sandbox-s1)=
(sdk-ai-studio-sandbox-action-2)=
<span id="列出沙箱并读取详情"></span>

## List sandboxes and inspect details

Use `client.sandboxes(workspace_id)` (`client.Sandboxes(workspaceID)` in Go) to call `list` for all sandboxes in the workspace, then pass a sandbox `id` to `get` to read its name, current `phase`, and `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)=
<span id="下一步"></span>

## Next steps

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