Claude Platform Docs
Managed AgentsManaged Agents self-hosted

Usa la console sul tuo server

Configura l’accesso alla console sul tuo server Claude Managed Agents self-hosted, quindi crea agenti ed esegui sessioni in un browser.

La console sul tuo server è una pagina web che un server Claude Managed Agents self-hosted serve allo stesso indirizzo della sua API. In essa crei agenti, esegui sessioni e gestisci ambienti, vault delle credenziali, archivi di memoria e skill, senza SDK né CLI.

Non è la Claude Console su platform.claude.com. Mostra solo ciò che si trova sul tuo server.

Configura l’accesso

Un amministratore configura l’accesso una sola volta. Per provare invece la console su una sola macchina, segui Provare la console sul tuo server, che usa il provider di accesso fittizio della release.

  1. Configura il single sign-on e l’accesso da terminale

    Segui Single sign-on, incluso Consentire agli sviluppatori di accedere da un terminale. La console fa accedere le persone tramite l’applicazione che hai registrato per l’accesso da terminale. Verifica ogni token rispetto alla prima voce di audiences nella voce dell’emittente, quindi elenca per prima l’audience di quell’applicazione.

  2. Servi la console tramite HTTPS

    Posiziona un proxy che termini TLS davanti alla porta 8400. Metti TLS davanti al server elenca cosa deve fare il proxy. Con HTTP semplice, l’accesso funziona solo su localhost o 127.0.0.1.

  3. Aggiungi l’indirizzo della console all’applicazione

    Nel tuo provider di identità, aggiungi l’indirizzo HTTPS del tuo server come secondo redirect URI di quell’applicazione, con una barra finale: https://cma.example.com/. Consenti inoltre la sua origine, https://cma.example.com, per le richieste cross-origin (CORS).

Per verificare la configurazione, apri la console ed effettua l’accesso.

Apri la console

Se le tue applicazioni chiamano https://cma.example.com, apri https://cma.example.com/ in un browser e fai clic su Continue with SSO.

Accedi tramite il tuo “identity provider” (provider di identità). La console non accetta la chiave API del server. Se la console indica che l’accesso non è configurato su questo server, un amministratore deve configurare l’accesso.

Esegui un agente dalla console

Gli strumenti integrati di un agente vuoto, come bash, vengono eseguiti su un worker, quindi seleziona un ambiente interrogato da un worker. Cosa viene eseguito dove spiega cos’è un worker. Senza un worker, la prima chiamata a uno strumento attende finché un worker non la esegue. Gli amministratori creano gli ambienti e possono vedere i worker di un ambiente nella sua scheda Workers.

  1. Crea un agente

    Nella barra laterale, seleziona Agents e fai clic su Create agent. Seleziona un punto di partenza, come Blank agent, e inserisci un nome.

    Fai clic su Create agent. Si apre la pagina dell’agente.

  2. Avvia una sessione

    Nella pagina dell’agente, fai clic su Start session. Seleziona un ambiente e fai clic su Create session. Si apre la pagina della sessione.

  3. Invia un messaggio

    Inserisci un messaggio nella casella in fondo alla pagina e invialo. La pagina si aggiorna mentre l’agente lavora. Se una chiamata a uno strumento attende te, la sua scheda mostra Approve e Deny.

Mentre una chiamata a uno strumento attende te, il badge della sessione indica Idle.

Per aprire qualsiasi altra sessione, ad esempio una avviata da un’applicazione tramite l’API, seleziona Sessions nella barra laterale, quindi seleziona la sessione.

Chi vede cosa

Il tuo ruolo determina ciò che la console mostra, come avviene nell’API:

  • Gli amministratori vedono e modificano tutto sul server.
  • Le persone con il ruolo developer o user vedono ogni ambiente. Degli agenti, delle sessioni, dei vault, degli archivi di memoria e delle skill, vedono solo ciò che hanno creato con il proprio accesso.

Un agente o una sessione creati con la chiave API del server, come quelli della guida rapida, sono visibili solo agli amministratori. Per la tabella completa, vedi Cosa può fare ciascun ruolo.

Disattiva la console

Il server serve la console per impostazione predefinita. Per disattivarla, imposta console.serve: false nel file delle impostazioni e riavvia il server. Il server smette quindi di servire la console. Agenti e sessioni continuano a funzionare tramite l’API.

Passaggi successivi

Questa pagina ti è stata utile?