Claude Platform Docs
Managed AgentsManaged Agents auto-hospedado

Use o console no seu servidor

Configure o login para o console no seu servidor auto-hospedado do Claude Managed Agents e, em seguida, crie agentes e execute sessões em um navegador.

O console no seu servidor é uma página da web que um servidor “self-hosted” (auto-hospedado) do Claude Managed Agents disponibiliza no mesmo endereço da sua API. Nele, você cria agentes, executa sessões e gerencia ambientes, cofres de credenciais, armazenamentos de memória e skills, sem SDK nem CLI.

Ele não é o Claude Console em platform.claude.com. Ele mostra apenas o que está no seu servidor.

Configurar o login

Um administrador configura o login uma única vez. Para, em vez disso, experimentar o console em uma única máquina, siga Experimente o console no seu servidor, que usa o provedor de login simulado da versão.

  1. Configure o single sign-on e o login pelo terminal

    Siga Single sign-on, incluindo Permita que desenvolvedores façam login a partir de um terminal. O console faz o login das pessoas por meio da aplicação que você registrou para o login pelo terminal. Ele verifica cada token em relação à primeira entrada de audiences na entrada do emissor, então liste primeiro a audiência dessa aplicação.

  2. Disponibilize o console via HTTPS

    Coloque um proxy que encerre o TLS na frente da porta 8400. Coloque TLS na frente do servidor lista o que o proxy deve fazer. Em HTTP simples, o login funciona apenas em localhost ou 127.0.0.1.

  3. Adicione o endereço do console à aplicação

    No seu provedor de identidade, adicione o endereço HTTPS do seu servidor como um segundo “redirect URI” (URI de redirecionamento) dessa aplicação, com uma barra no final: https://cma.example.com/. Permita também sua origem, https://cma.example.com, para requisições entre origens (CORS).

Para verificar a configuração, abra o console e faça login.

Abrir o console

Se suas aplicações chamam https://cma.example.com, abra https://cma.example.com/ em um navegador e clique em Continue with SSO.

Você faz login por meio do seu “identity provider” (provedor de identidade). O console não aceita a chave de API do servidor. Se o console informar que o login não está configurado neste servidor, um administrador precisa configurar o login.

Executar um agente a partir do console

As ferramentas integradas de um agente em branco, como bash, são executadas em um worker, então selecione um ambiente que um worker esteja consultando. O que é executado onde explica o que é um worker. Sem worker, a primeira chamada de ferramenta aguarda até que um a execute. Administradores criam ambientes e podem ver os workers de um ambiente na aba Workers dele.

  1. Crie um agente

    Na barra lateral, selecione Agents e clique em Create agent. Selecione um ponto de partida, como Blank agent, e insira um nome.

    Clique em Create agent. A página do agente é aberta.

  2. Inicie uma sessão

    Na página do agente, clique em Start session. Selecione um ambiente e clique em Create session. A página da sessão é aberta.

  3. Envie uma mensagem

    Insira uma mensagem na caixa na parte inferior da página e envie-a. A página é atualizada conforme o agente trabalha. Se uma chamada de ferramenta aguardar por você, seu cartão mostra Approve e Deny.

Enquanto uma chamada de ferramenta aguarda por você, o selo da sessão exibe Idle.

Para abrir qualquer outra sessão, como uma que uma aplicação iniciou por meio da API, selecione Sessions na barra lateral e, em seguida, selecione a sessão.

Quem vê o quê

Sua função determina o que o console mostra, assim como acontece na API:

  • Administradores veem e alteram tudo no servidor.
  • Pessoas com a função developer ou user veem todos os ambientes. Dos agentes, sessões, cofres, armazenamentos de memória e skills, veem apenas o que criaram com o próprio login.

Um agente ou sessão criado com a chave de API do servidor, como os do início rápido, aparece apenas para administradores. Para a tabela completa, consulte O que cada função pode fazer.

Desativar o console

O servidor disponibiliza o console por padrão. Para desativá-lo, defina console.serve: false no arquivo de configurações e reinicie o servidor. O servidor então deixa de disponibilizar o console. Agentes e sessões continuam funcionando por meio da API.

Próximos passos

Esta página foi útil?