> ## Documentation Index
> Fetch the complete documentation index at: https://oma-codex-339-workspace-permissions.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 OMA 控制台 中构建

> 在 OMA 控制台 中以可视化方式创建、测试和迭代智能体，然后通过 API 从您的代码中运行它们。

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

<Note>
  托管智能体 API 请求需要 `managed-agents-2026-04-01` Beta 请求头，但记忆存储端点除外，它们使用 `agent-memory-2026-07-22`。SDK 会自动设置正确的 Beta 请求头。请参阅[Beta 请求头](/docs/zh/api/versioning-beta)。
</Note>

## 如何构建智能体

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

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

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

## 测试智能体

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

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

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

1. 从 OMA 控制台 复制智能体 ID 和[环境 ID](/docs/zh/environments)。
2. 在[创建会话](/docs/zh/sessions)时在代码中引用它们：

<CodeGroup defaultLanguage="CLI">
  ```bash cURL theme={null}
  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"
    }')
  ```

  ```bash CLI theme={null}
  ant beta:sessions create \
    --agent agent_01J8XkN5uT3vHpLqRfWdY2 \
    --environment-id env_01K2mPsT7hNwR4jXuLvCqD8 \
    --title "My first session"
  ```

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

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

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

  ```go Go theme={null}
  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)
  }
  ```

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

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

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