在 OMA 控制台中构建

OMA 控制台提供了一个用于创建和配置智能体的可视化界面。它让您可以在编写代码之前以交互方式迭代配置。

托管智能体 API 请求需要 managed-agents-2026-04-01 Beta 请求头，但记忆存储端点除外，它们使用 agent-memory-2026-07-22。SDK 会自动设置正确的 Beta 请求头。请参阅Beta 请求头。

如何构建智能体

可视化界面会引导您完成智能体定义的每个字段：

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

在您进行配置时，OMA 控制台会显示等效的 API 请求，以便您在满意后将其复制到代码中。

测试智能体

OMA 控制台包含一个内联会话运行器。配置好智能体后，您可以直接启动测试会话、发送消息并观察事件流，而无需离开页面。这是检查您的系统提示和工具选择是否产生预期行为的最快方式。

从 OMA 控制台到您的代码库

一旦您的智能体按预期工作：

从 OMA 控制台复制智能体 ID 和环境 ID。
在创建会话时在代码中引用它们：

session=$(curl -fsSL http://localhost:38080/v1/sessions \
  -H "x-api-key: $OMA_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)
}

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

第一步

定义智能体

配置智能体环境

将工作委派给智能体

管理智能体上下文

高级编排

参考

如何构建智能体

测试智能体

从 OMA 控制台到您的代码库

​如何构建智能体

​测试智能体

​从 OMA 控制台 到您的代码库

如何构建智能体

测试智能体

从 OMA 控制台到您的代码库