Lex Privacy AIManual do Sistema
Ajuda

Configuração de inteligência

Gestão de Agentes

Administre agentes de inteligência, suas instruções, perfis autorizados e skills disponíveis no Lex Privacy AI.

Visão geral

1. Para que serve

O módulo Admin Agentes possui duas áreas: Agentes e Skills. Na primeira, você cadastra e administra os agentes que podem ser utilizados no Chat. Na segunda, mantém as capacidades que podem ser vinculadas a cada agente.

A listagem de agentes apresenta nome, função, quantidade de skills vinculadas, status e ações administrativas.

Tela de Gestão de Agentes com abas Agentes e Skills, tabela e ações
Figura 1 — Lista de agentes cadastrados.

Agentes

2. Cadastrar um agente

  1. Abra a aba Agentes.
  2. Clique em Novo Agente.
  3. Informe o Nome e a Função.
  4. Descreva as orientações no campo Instrução Inicial / System Prompt.
  5. Selecione os perfis que poderão acessar o agente.
  6. Clique em Salvar.

O nome precisa ser informado para que o cadastro seja salvo. Os perfis selecionados são vinculados junto com a criação do agente.

Formulário de Novo Agente com nome, função, instrução inicial e vínculo por perfil
Figura 2 — Cadastro de um novo agente.

Cadastro

3. Campos do agente

Campo Descrição Obrigatório
Nome Identificação do agente nas telas e no Chat. Sim, conforme a validação do formulário.
Função Descrição resumida do papel do agente. Sim, conforme a validação do formulário.
Instrução Inicial / System Prompt Orientações que definem o comportamento inicial do agente. Sim, conforme a validação do formulário.
Perfis Perfis cujos usuários receberão acesso ao agente. Sim, conforme a validação do formulário.
Conteúdo das instruções

Não inclua senhas, chaves, tokens ou dados pessoais nas instruções do agente. Use somente orientações aprovadas para o uso do sistema.

Atualização

4. Editar e controlar um agente

Na listagem, use Editar para atualizar o nome, a função e as instruções iniciais. Clique em Salvar para aplicar as alterações ou em Cancelar para sair sem salvar.

A área Vincular por Perfil permite revisar os perfis associados. Em uma edição, selecione ou desmarque os perfis e clique em Salvar perfis.

As ações Desativar e Ativar pedem confirmação. Um agente desativado deixa de aparecer no Chat, enquanto seu histórico e suas configurações são preservados.

Formulário de Editar Agente com instruções e perfis vinculados
Figura 3 — Edição de agente e seus perfis de acesso.

Vínculos

5. Gerenciar skills de um agente

  1. Localize o agente na aba Agentes.
  2. Clique em Skills.
  3. Marque as skills que o agente poderá utilizar ou desmarque as que devem ser retiradas.
  4. Clique em Salvar Vinculações.
  5. Use Cancelar para fechar sem aplicar as alterações.

A tela apresenta o nome da skill, sua categoria e uma caixa de seleção. Se não houver skills disponíveis, a interface informa essa situação.

Painel Gerenciar Skills de um agente com lista de capacidades selecionáveis
Figura 4 — Associação de skills a um agente.

Skills

6. Cadastrar e consultar skills

Na aba Skills, a tabela apresenta nome, categoria, descrição, quantidade de agentes vinculados e ações. As categorias disponíveis são Busca, Análise, Documentos, Integração e Geral.

Para cadastrar, clique em Nova Skill, informe o nome, selecione a categoria e preencha a descrição. O campo Config (JSON — opcional) pode receber uma configuração adicional no formato indicado pela tela. Finalize em Salvar.

Aba Skills com tabela de capacidades, categorias, descrições e ações
Figura 5 — Gestão de skills cadastradas.
Formulário Nova Skill com nome, categoria, descrição e configuração opcional
Figura 6 — Cadastro de uma nova skill.

Manutenção

7. Editar ou remover uma skill

Na aba Skills, clique em Editar para alterar nome, categoria, descrição ou configuração. Clique em Salvar ou Cancelar.

Para remover, selecione Remover e confirme o diálogo. A tela informa que a skill será removida e que os agentes que a utilizam perderão o vínculo.

Formulário Editar Skill com nome, categoria, descrição e configuração opcional
Figura 7 — Edição de uma skill.

Manutenção

8. Excluir um agente

  1. Na aba Agentes, clique em Excluir.
  2. Leia a confirmação apresentada.
  3. Confirme somente após revisar o agente selecionado.

A confirmação informa que o agente será removido permanentemente e que a ação não poderá ser desfeita.

Acesso

9. Perfis disponíveis para vínculo

O formulário apresenta opções de vínculo por perfil. No código atual, estão definidos:

  • Gestor: acesso total.
  • DPO: sem dados operacionais.
  • TI: leitura do catálogo.
  • Usuário comum: leitura.

O vínculo concede acesso ao agente para os usuários que possuem os perfis selecionados. As permissões efetivas podem depender da configuração do ambiente.

Resumo

10. Principais fluxos

  • Criar agente: Agentes → Novo Agente → preencher dados → selecionar perfis → Salvar.
  • Editar agente: localizar → Editar → atualizar dados → Salvar.
  • Vincular skills: localizar agente → Skills → selecionar capacidades → Salvar Vinculações.
  • Criar skill: Skills → Nova Skill → preencher dados → Salvar.
  • Controlar acesso: selecionar Desativar ou Ativar → revisar confirmação → confirmar.
  • Excluir: selecionar Excluir → revisar confirmação → confirmar.