# Assistentes e perfis

Entenda como organizar um assistente por função, localizar suas configurações e separar instruções de acessos.

Fonte: https://guides.adapta.org/guias/maestro/recursos-do-maestro/assistentes/

**TL;DR** · Use um assistente quando precisar repetir uma função com regras estáveis. No menu do perfil, **Gerenciar assistentes** abre a lista. Prepare a função e valide uma amostra antes de confiar na rotina.

![Gravação do Adapta Maestro: o menu do perfil lista os assistentes disponíveis e Gerenciar assistentes abre a página com um cartão por assistente, mostrando o modelo e o estado Rodando.](https://guides.adapta.org/media/screenshots/maestro/assistentes-2026-09-21/maestro-assistentes-tour.gif)

*Dois lugares diferentes: o menu troca qual assistente responde, a página mostra o que cada um é e se está rodando.*

## O que um assistente organiza

A página **Assistentes** apresenta os perfis como assistentes independentes. Cada item mostra nome, identificação de modelo e estado, como **Rodando** ou **Parado**. O detalhe reúne configuração, habilidades e sessões.

Pense no assistente como um posto de trabalho com uma função definida. “Preparar a revisão de propostas” é uma função. “Resolver tudo da empresa” mistura decisões, fontes e permissões demais para conferir bem. Essa analogia ajuda a planejar o uso; não significa isolamento técnico de dados entre perfis.

Para uma tarefa pontual, uma conversa com um pedido completo pode ser suficiente. Um assistente passa a fazer sentido quando você precisa reaplicar o mesmo método, formato e limites em trabalhos diferentes.

## Onde encontrar

Abra o menu com o nome do perfil, na parte inferior da lateral, e escolha **Gerenciar assistentes**. Na lista, **Novo assistente** abre o cadastro. Selecionar um item abre seu detalhe.

Confira o nome do perfil ativo na lateral. Abrir a configuração de outro assistente não significa selecioná-lo para conversar. Não use apenas o título do detalhe para concluir quem responderá ao próximo pedido.

![Lista de Assistentes com cartões de perfil, cada um com nome, identificação de modelo e estado (Parado ou Rodando).](https://guides.adapta.org/media/screenshots/maestro/assistentes-2026-09-10/assistentes-lista.png)

![Detalhe de um assistente parado, com os cartões Configuração, Config do gateway, Canais, Habilidades, Sessões e Operações, além dos controles Iniciar e Excluir assistente.](https://guides.adapta.org/media/screenshots/maestro/assistentes-2026-09-10/assistente-detalhe.png)

*Detalhe de um perfil parado: as seis áreas descritas abaixo, mais Iniciar e Excluir assistente no topo.*

## O que cada área reúne

|  Área |  O que foi localizado |  Como usar esta informação |
| --- | --- | --- |

|  Configuração |  Nome, instruções e persona |  Preparar a função e suas regras. Veja [Defina o papel do assistente](https://guides.adapta.org/guias/maestro/recursos-do-maestro/assistentes/configurar/). |

|  Habilidades |  Skills instaladas e catálogo |  Conferir quais métodos estão disponíveis. Não presumir instalação ou uso pela presença do link. |

|  Sessões |  Conversas do assistente |  Procurar o trabalho que será revisado, sem confundir histórico com instruções permanentes. |

|  Operações |  Status, modelos, cron e arquivos |  Área operacional. A presença dessas opções não comprova que uma rotina está configurada. |

|  Config do gateway, Canais e Logs |  Ajustes técnicos, canais e saída operacional |  Podem envolver acessos e informação sensível. Não copiar configurações ou registros para um pedido público. |

No detalhe de um assistente parado, você encontra **Iniciar** e **Excluir assistente**. Não exclua um perfil para corrigir uma resposta nem inicie um assistente sem entender os efeitos no ambiente.

## Instruções não são permissões

O cadastro oferece **Nome**, **Instruções (system prompt)** e **Persona avançada (opcional)**. A expressão *system prompt* identifica o campo de orientações recorrentes. A persona avançada expõe campos chamados **SOUL.md**, **IDENTITY.md** e **USER.md**.

A ordem de prioridade entre instruções, persona e memória não está validada neste guia. Não é necessário preencher a persona avançada para preparar o primeiro rascunho. Não coloque senhas, tokens, dados de clientes ou condições comerciais passageiras nesses campos.

As [ferramentas](https://guides.adapta.org/guias/maestro/recursos-do-maestro/ferramentas/) indicam ações que podem entrar no trabalho. As instruções dizem como você quer que o trabalho seja conduzido. Escrever “não envie” delimita o pedido, mas não substitui a configuração de acessos.

## Exemplo: revisão de propostas de treinamento

Uma empresa fictícia recebe propostas de fornecedores para capacitar sua equipe. O assistente **Revisor de propostas** deve comparar capacidade, preço total, datas e lacunas. Ele não negocia nem escolhe um fornecedor em nome da empresa.

As regras permanecem: citar a proposta usada, considerar a quantidade necessária, não inventar preço ausente e separar recomendação de aprovação. Os dados mudam a cada trabalho: participantes, orçamento, prazo e propostas. Essa separação evita transformar uma condição de uma compra antiga em regra para todas as próximas.

**Dica prática:** dê ao assistente uma função que você consiga avaliar. “Compare propostas com fonte e pendência” oferece critérios mais claros que “seja meu consultor”.

**Para aprofundar:** Como Criar Assistentes de IA, aula 4, “A Anatomia de um Expert de Alta Performance”. A aula ajuda a organizar propósito, regras, insumos e formato. Aplicamos esses princípios à preparação; os controles do Maestro são próprios desta plataforma.

## Caminho para colocar em uso

Comece por [definir o papel e preparar as instruções](https://guides.adapta.org/guias/maestro/recursos-do-maestro/assistentes/configurar/). Depois use a [amostra de teste e revisão](https://guides.adapta.org/guias/maestro/recursos-do-maestro/assistentes/testar/) para decidir se a configuração atende ao seu trabalho.

Este guia orienta a consulta e a preparação da configuração. Criação, início, gravação de alterações, troca de perfil e efeito das instruções na resposta permanecem sem validação. O exemplo é uma proposta de configuração, não uma execução demonstrada.

Confira os [casos de uso do Maestro](https://guides.adapta.org/guias/casos-de-uso/por-plataforma/maestro/) para encontrar aplicações com entradas e critérios de revisão.
