---
title: Construir no Console
url: https://platform.claude.com/docs/pt-BR/managed-agents/onboarding
description: Crie, teste e itere em agentes visualmente no Claude 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
  zdr:
    eligibility: not-eligible
    note: Não é elegível para ZDR, exceto o Managed Agents auto-hospedado. Sessões são recursos com estado; as transcrições persistem até que você as exclua.
  supportedModels:
    - claude-fable-5-2
    - claude-mythos-5-2
    - claude-fable-5-1
    - claude-mythos-5-1
    - claude-fable-5
    - claude-mythos-5
    - claude-mythos-preview
    - claude-opus-5-5
    - claude-opus-5
    - claude-sonnet-5-5
    - claude-sonnet-5
    - claude-haiku-5-5
    - claude-haiku-4-5-20251001
    - claude-opus-4-8
    - claude-opus-4-7
    - claude-opus-4-6
    - claude-sonnet-4-6
    - claude-opus-4-5-20251101
    - claude-sonnet-4-5-20250929
  supportedPlatforms:
    Claude API: beta
    Claude Platform on AWS: beta
---

O [Claude Console](https://platform.claude.com/workspaces/default/agent-quickstart/) oferece 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/) no Claude Console 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: 2026-10-21" \
    -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>

## Disponibilidade

Construtor de agentes do Console está em beta em todos os modelos.

### Suporte da API

#### [Managed Agents](https://platform.claude.com/docs/pt-BR/managed-agents/overview)

* Disponibilidade: Disponível

| Status | Plataformas de nuvem |
| ----- | ----- |
| Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-platform-on-aws) |

### Cabeçalhos beta obrigatórios

[Visão geral dos cabeçalhos beta](https://platform.claude.com/docs/pt-BR/api/beta-headers)

Os cabeçalhos beta permitem que você acesse recursos experimentais e novas capacidades de modelos antes que eles se tornem parte da API padrão.

* `managed-agents-2026-04-01`

### Tratamento de dados

[Visão geral do tratamento de dados](https://platform.claude.com/docs/pt-BR/manage-claude/api-and-data-retention#feature-eligibility)

| Item | Retenção zero de dados | HIPAA |
| ----- | ----- | ----- |
| Status | Não elegível | Não elegível |
| Detalhes | Não é elegível para ZDR, exceto o Managed Agents auto-hospedado. Sessões são recursos com estado; as transcrições persistem até que você as exclua. [Saiba mais](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-data-and-access#how-long-data-is-kept) | Não é elegível para HIPAA. Aplica-se a todos os sub-recursos do Managed Agents. |

Endpoints aplicáveis:

* `/v1/agents`
* `/v1/sessions`
* `/v1/environments`
