在 Console 中原型设计

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

Console 提供了一个可视化界面，用于创建和配置 Agent。它允许你在编写代码之前以交互方式迭代配置。

Note

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

如何构建 Agent

可视化界面会引导你完成 Agent 定义的每个字段：

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

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

测试 Agent

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

从原型到代码

一旦你的 Agent 按预期工作：

从 Console 复制 Agent ID 和环境 ID。
在创建会话时在代码中引用它们：

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"
  }')

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

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

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

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

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

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

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

session = client.beta.sessions.create(
  agent: "agent_01J8XkN5uT3vHpLqRfWdY2",
  environment_id: "env_01K2mPsT7hNwR4jXuLvCqD8",
  title: "My first session"
)