# 在 Console 中原型设计

在 Console 中可视化创建和测试 Agent，无需编写 API 调用。

---

[Console](https://platform.claude.com/workspaces/default/agent-quickstart/) 提供了一个可视化界面，用于创建和配置 Agent。它允许你在编写代码之前以交互方式迭代配置。

<Note>
所有 Managed Agents API 请求都需要 `managed-agents-2026-04-01` beta header。SDK 会自动设置该 beta header。
</Note>

## 如何构建 Agent

[可视化界面](https://platform.claude.com/workspaces/default/agent-quickstart/)会引导你完成 Agent 定义的每个字段：

- **模型和系统提示词：** 选择模型并在全宽编辑器中编写系统提示词。
- **MCP 服务器：** 通过 URL 添加远程 MCP 服务器，并对你的 Agent 进行身份验证以代表你执行操作。
- **工具：** 使用预构建的 Agent 工具集和 MCP 工具扩展你的 Agent 能力。
- **技能：** 从你的组织库中附加 Anthropic 或自定义技能。

在配置过程中，Console 会显示等效的 API 请求，以便你在满意后将其复制到代码中。

## 测试 Agent

Console 包含一个内联会话运行器。配置完 Agent 后，你可以直接启动测试会话、发送消息，并在不离开页面的情况下观察事件流。这是检查你的系统提示词和工具选择是否产生预期行为的最快方式。

## 从原型到代码

一旦你的 Agent 按预期工作：

1. 从 Console 复制 Agent ID 和[环境 ID](/docs/en/managed-agents/environments)。
2. 在[创建会话](/docs/en/managed-agents/sessions)时在代码中引用它们：

<CodeGroup defaultLanguage="CLI">

```bash curl nocheck
session=$(curl -fsSL https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "agent": "agent_01J8XkN5uT3vHpLqRfWdY2",
    "environment_id": "env_01K2mPsT7hNwR4jXuLvCqD8",
    "title": "My first session"
  }')
```

```bash CLI nocheck
ant beta:sessions create \
  --agent agent_01J8XkN5uT3vHpLqRfWdY2 \
  --environment-id env_01K2mPsT7hNwR4jXuLvCqD8 \
  --title "My first session"
```

```python Python nocheck
session = client.beta.sessions.create(
    agent="agent_01J8XkN5uT3vHpLqRfWdY2",
    environment_id="env_01K2mPsT7hNwR4jXuLvCqD8",
    title="My first session",
)
```

```typescript TypeScript nocheck
const session = await client.beta.sessions.create({
  agent: "agent_01J8XkN5uT3vHpLqRfWdY2",
  environment_id: "env_01K2mPsT7hNwR4jXuLvCqD8",
  title: "My first session"
});
```

```csharp C# nocheck
var session = await client.Beta.Sessions.Create(new()
{
    Agent = "agent_01J8XkN5uT3vHpLqRfWdY2",
    EnvironmentID = "env_01K2mPsT7hNwR4jXuLvCqD8",
    Title = "My first session",
});
```

```go Go nocheck hidelines={-1}
session, err := client.Beta.Sessions.New(ctx, anthropic.BetaSessionNewParams{
	Agent: anthropic.BetaSessionNewParamsAgentUnion{
		OfString: anthropic.String("agent_01J8XkN5uT3vHpLqRfWdY2"),
	},
	EnvironmentID: "env_01K2mPsT7hNwR4jXuLvCqD8",
	Title:         anthropic.String("My first session"),
})
if err != nil {
	panic(err)
}
_ = session
```

```java Java nocheck
var session = client.beta().sessions().create(
    SessionCreateParams.builder()
        .agent("agent_01J8XkN5uT3vHpLqRfWdY2")
        .environmentId("env_01K2mPsT7hNwR4jXuLvCqD8")
        .title("My first session")
        .build()
);
```

```php PHP nocheck
$session = $client->beta->sessions->create(
    agent: 'agent_01J8XkN5uT3vHpLqRfWdY2',
    environmentID: 'env_01K2mPsT7hNwR4jXuLvCqD8',
    title: 'My first session',
);
```

```ruby Ruby nocheck
session = client.beta.sessions.create(
  agent: "agent_01J8XkN5uT3vHpLqRfWdY2",
  environment_id: "env_01K2mPsT7hNwR4jXuLvCqD8",
  title: "My first session"
)
```
</CodeGroup>