Formação Agent BuilderAccessFormação Agent Builder · da AI Coders Academy

aula prática · autenticação e papéis

O agente pergunta quem é. O Access responde com papéis.

Um console para ver por dentro como um agente eve verifica identidade. O agente envia o token de sessão, recebe slugs verificados e toma a própria decisão.

rastro · consultaformato da resposta
  1. 01 agente
    GET /api/v1/identity?organizationId=<org>
    Authorization: Bearer <token de sessão>
  2. 02 access
    { "authenticated": true,
      "organizationId": "<org>",
      "userId": "<id>",
      "roles": ["<slug local>"] }
  3. 03 agente

    Compara os slugs com a própria regra e decide se executa a ferramenta.

Estrutura da chamada, sem dados de contas.

O token define o sujeito

Só a sessão Better Auth validada determina quem é o usuário. IDs e e-mails enviados pelo chamador são ignorados.

Slugs, não permissões

A API devolve apenas slugs de papel. Cada agente mantém a própria regra do que cada papel pode fazer.

Negar por padrão

401 para token inválido, 403 para conta suspensa. Erro ou papel ausente significa negar.

Toda mudança registrada

Atribuições, suspensões e alterações de papéis ficam na trilha de auditoria.

fluxo da aula

Do cadastro à decisão do agente.

  1. 01

    Cadastro

    Cada aluno cria uma conta com e-mail e senha no próprio Access, via Better Auth.

  2. 02

    Sincronização

    O administrador traz as contas reais para o console de usuários.

  3. 03

    Atribuição

    Papéis personalizados, com slug imutável, são atribuídos a cada conta.

  4. 04

    Consulta

    O agente eve encaminha o token de sessão, recebe os slugs e decide.

privilégio e papel

Duas coisas diferentes, sempre separadas.

Administrador do Access
Cada organização tem administradores locais. Quem cria a organização a administra e adiciona membros pelo e-mail exato da conta ou cria contas com senha inicial. Apenas contas autorizadas pelo servidor podem criar organizações.
Papéis de negócio
Slugs que você cria e atribui. Não dão acesso ao console; servem só para o agente eve decidir.