Pular para o conteúdo principal

Perfis

Um perfil é o elo entre pessoas e skills. Ele agrupa um conjunto de skills e um par de permissões de execução, e é atribuído a usuários. O conjunto de skills que uma pessoa enxerga no chat é a união dos skills dos perfis atribuídos a ela.

Sem perfil, o chat abre vazio

Um usuário sem perfil atribuído — inclusive um administrador — não vê nenhuma skill na sessão. Esse é o efeito mais comum de confusão: depois de criar um usuário, lembre-se de atribuí-lo a um perfil. Veja o aviso no Dashboard.

A lista de perfis​

A página Perfis (/org/profiles) lista os perfis da organização. Cada linha mostra o nome, a descrição e leva ao detalhe. A partir da lista você cria novos perfis e abre os existentes para editar.

Criar um perfil​

Use Criar perfil e informe:

  1. Nome — identifica o perfil (por exemplo, Time Comercial, Engenharia, Financeiro).
  2. Descrição — uma frase sobre o propósito do perfil.

O perfil nasce vazio: você adiciona skills e usuários no detalhe.

Detalhe do perfil​

O detalhe reúne a edição e os dois cartões de associação.

Editar​

CampoO que faz
NomeNome de exibição do perfil.
DescriçãoTexto explicativo.
Allow local skill executionSe as skills deste perfil podem executar código localmente na máquina do usuário.
Allow writes outside workspaceSe o agente pode escrever fora do workspace para quem tem este perfil.
Como as permissões do perfil se combinam

Allow local skill execution e Allow writes outside workspace são uma das camadas da política, que segue deny-wins. Um perfil só pode restringir a base — nunca ampliar além do que a plataforma e a organização permitem. Lembre que os overrides por usuário (em Usuários & papéis) também participam dessa combinação.

Usuários​

O cartão Users mostra quem está atribuído ao perfil:

  • Add — atribui um usuário existente da organização ao perfil.
  • Remove — remove a atribuição (a pessoa perde, no próximo cálculo de política, as skills exclusivas deste perfil).

Como a visão de skills é a união dos perfis, uma pessoa pode estar em mais de um perfil e somar capacidades.

Skills​

O cartão Skills define o conjunto de capacidades do perfil:

  • Add — inclui uma skill do catálogo da organização.
  • Remove — retira a skill do perfil.
Skills só aparecem se publicadas

Uma skill só pode entrar em um perfil depois de existir no catálogo da organização (criada ou importada e publicada). Veja Skills (governança) e a autoria de skills.

Quando as mudanças valem​

Alterações em perfis (adicionar/remover skills ou usuários, mudar permissões) recalculam a política efetiva da organização. Os clientes recebem a nova política no próximo request e sincronizam as skills no início da sessão — instalando o que ganhou acesso e removendo o que perdeu. Em uma sessão já aberta, peça ao usuário para iniciar uma nova sessão se a mudança não refletir de imediato.

Veja também​