---
title: Costruisci in Console
url: https://platform.claude.com/docs/it/managed-agents/onboarding
description: Crea, testa e itera sugli agenti in modo visivo nella Claude Console, quindi eseguili dal tuo codice con l'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: Non idoneo per ZDR, ad eccezione di Managed Agents self-hosted. Le sessioni sono risorse con stato; le trascrizioni restano finché non le elimini.
  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
---

La [Claude Console](https://platform.claude.com/workspaces/default/agent-quickstart/) fornisce un’interfaccia visiva per creare e configurare agenti. Ti consente di iterare sulla configurazione in modo interattivo prima di scrivere codice.

## Come costruire un agente

L’[interfaccia visiva](https://platform.claude.com/workspaces/default/agent-quickstart/) nella Claude Console ti guida attraverso ogni campo della definizione di un agente:

* **Modello e prompt di sistema:** Scegli un modello e scrivi il “system prompt” (prompt di sistema) in un editor a larghezza intera.
* **Server MCP:** Aggiungi server MCP remoti tramite URL e autentica il tuo agente affinché agisca per tuo conto.
* **Strumenti:** Estendi le capacità del tuo agente utilizzando un set di strumenti per agenti predefinito e strumenti MCP.
* **Skills:** Allega skill di Anthropic o personalizzate dalla libreria della tua organizzazione.

Mentre configuri, Console mostra la richiesta API equivalente, così puoi copiarla nel tuo codice una volta soddisfatto.

## Testare un agente

Console include un esecutore di sessioni integrato. Dopo aver configurato il tuo agente, puoi avviare direttamente una sessione di test, inviare messaggi e osservare il flusso di eventi senza lasciare la pagina. Questo è il modo più rapido per verificare che il tuo prompt di sistema e la selezione degli strumenti producano il comportamento che ti aspetti.

## Dalla Console alla tua codebase

Una volta che il tuo agente funziona come previsto:

1. Copia l’ID dell’agente e l’[ID dell’ambiente](https://platform.claude.com/docs/it/managed-agents/environments) da Console.
2. Fai riferimento a essi nel tuo codice quando [crei le sessioni](https://platform.claude.com/docs/it/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>

## Disponibilità

La funzionalità Generatore di agenti della Console è in beta su tutti i modelli.

### Supporto API

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

* Disponibilità: Disponibile

| Stato | Piattaforme cloud |
| ----- | ----- |
| Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws) |

### Header beta richiesti

[Panoramica degli header beta](https://platform.claude.com/docs/it/api/beta-headers)

Gli header beta consentono di accedere a funzionalità sperimentali e a nuove capacità dei modelli prima che entrino a far parte dell’API standard.

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

### Gestione dei dati

[Panoramica sulla gestione dei dati](https://platform.claude.com/docs/it/manage-claude/api-and-data-retention#feature-eligibility)

| Elemento | Conservazione zero dei dati | HIPAA |
| ----- | ----- | ----- |
| Stato | Non idoneo | Non idoneo |
| Dettagli | Non idoneo per ZDR, ad eccezione di Managed Agents self-hosted. Le sessioni sono risorse con stato; le trascrizioni restano finché non le elimini. [Scopri di più](https://platform.claude.com/docs/it/managed-agents/self-hosted-data-and-access#how-long-data-is-kept) | Non idoneo per HIPAA. Si applica a tutte le sotto-funzionalità di Managed Agents. |

Endpoint applicabili:

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