---
title: Construir no Console
url: https://platform.claude.com/docs/pt-BR/managed-agents/onboarding
description: Crie, teste e itere em agentes visualmente no Console e, em seguida, execute-os a partir do seu código com a API.
featureMetadata:
  topic:
    title: Managed Agents
    url: https://platform.claude.com/docs/en/managed-agents/overview
  status: beta
  betaHeader: managed-agents-2026-04-01
---

O [Console](https://platform.claude.com/workspaces/default/agent-quickstart/) fornece uma interface visual para criar e configurar agentes. Ele permite que você itere na configuração de forma interativa antes de escrever código.

## Como construir um agente

A [interface visual](https://platform.claude.com/workspaces/default/agent-quickstart/) orienta você por cada campo de uma definição de agente:

* **Modelo e prompt do sistema:** Escolha um modelo e escreva o "system prompt" (prompt do sistema) em um editor de largura total.
* **Servidores MCP:** Adicione servidores MCP remotos por URL e autentique seu agente para agir em seu nome.
* **Ferramentas:** Amplie as capacidades do seu agente usando um conjunto de ferramentas de agente pré-construído e ferramentas MCP.
* **Skills:** Anexe skills da Anthropic ou skills personalizadas da biblioteca da sua organização.

À medida que você configura, o Console mostra a requisição de API equivalente para que você possa copiá-la para o seu código quando estiver satisfeito.

## Testando um agente

O Console inclui um executor de sessões integrado. Após configurar seu agente, você pode iniciar uma sessão de teste diretamente, enviar mensagens e acompanhar o fluxo de eventos sem sair da página. Esta é a maneira mais rápida de verificar se o seu prompt do sistema e a seleção de ferramentas produzem o comportamento que você espera.

## Do Console para a sua base de código

Quando seu agente funcionar como esperado:

1. Copie o ID do agente e o [ID do ambiente](https://platform.claude.com/docs/pt-BR/managed-agents/environments) do Console.
2. Referencie-os no seu código ao [criar sessões](https://platform.claude.com/docs/pt-BR/managed-agents/sessions):

<CodeGroup>
  ```bash cURL
  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
  ant beta:sessions create \
    --agent agent_01J8XkN5uT3vHpLqRfWdY2 \
    --environment-id env_01K2mPsT7hNwR4jXuLvCqD8 \
    --title "My first session"
  ```

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

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

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

  ```go Go
  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
  var session = client.beta().sessions().create(
      SessionCreateParams.builder()
          .agent("agent_01J8XkN5uT3vHpLqRfWdY2")
          .environmentId("env_01K2mPsT7hNwR4jXuLvCqD8")
          .title("My first session")
          .build()
  );
  ```

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

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