# Teste e revise o assistente

Crie um assistente próprio, confirme qual deles responde e avalie a saída com uma amostra que tem gabarito.

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

**TL;DR** · Teste o assistente com uma amostra cujo resultado você calculou antes. Confirme o perfil ativo, compare os cálculos e o formato e depois altere um dado. No exemplo, os números estavam corretos, mas o formato precisou de ajuste: confira os dois antes de adotar a rotina.

![Gravação do Adapta Maestro: a partir da página do assistente Revisor de propostas, o menu do perfil troca o assistente ativo, uma conversa nova é aberta e a amostra de três propostas é enviada.](https://guides.adapta.org/media/screenshots/maestro/assistentes-testar-2026-09-21/maestro-assistente-teste-fluxo.lossless.webp)

*O teste começa antes do pedido: trocar o perfil ativo e conferir o rodapé é o que garante que a resposta veio do assistente que você quer avaliar.*

## O que este roteiro verifica

Um nome bem escolhido e instruções completas não bastam para aprovar uma rotina. Você precisa verificar três coisas separadas: o assistente foi criado, é ele quem está respondendo e a resposta respeita os dados.

O exercício abaixo usa um **Revisor de propostas**, com fornecedores e valores fictícios. O resultado esperado é uma análise para revisão humana; não há envio, contratação ou agendamento. Você pode trocar o tema sem mudar o método: o que faz o teste funcionar é existir um gabarito calculado por você antes de olhar a resposta.

Um assistente novo não nasce isolado. No teste, ele carregou uma habilidade já instalada na conta e registrou informação na memória sem que o pedido pedisse isso. Antes de avaliar o comportamento, confira **Habilidades** e **Memória**: o que estiver ativo na conta entra junto.

## Prepare e execute o teste

1. **Crie o assistente e coloque para rodar**

    No menu do perfil, no canto inferior esquerdo, abra **Gerenciar assistentes** e depois **Novo assistente**. Preencha **Nome** e **Instruções (system prompt)** e confirme em **Criar assistente**. Use as instruções preparadas em [Defina o papel do assistente](https://guides.adapta.org/guias/maestro/recursos-do-maestro/assistentes/configurar/).

    O assistente nasce **Parado**. Clique em **Iniciar** e espere o estado virar **Rodando**; enquanto ele não estiver rodando, não há o que testar.

![Página do assistente Revisor de propostas no Maestro, com o estado Rodando, os controles Reiniciar e Parar e os cartões Configuração, Config do gateway, Canais, Habilidades, Sessões, Operações e Logs.](https://guides.adapta.org/media/screenshots/maestro/assistentes-testar-2026-09-21/assistente-detalhe-2026-09-21.png)

    *Na página do assistente: **1** o estado e os controles de execução, **2** Configuração, que guarda nome, instruções e persona, **3** Habilidades, onde se vê o que ele herdou da conta, e **4** Sessões, que é onde as conversas dele ficam registradas.*

2. **Confirme quem vai responder**

    Abra o menu do perfil de novo. A lista **Profiles** mostra todos os assistentes; escolha o que você acabou de criar. Confira o rodapé da barra lateral: ele passa a exibir o nome do assistente ativo e o estado **rodando**.

    Essa conferência não é formalidade. Sem ela, você pode atribuir ao assistente novo uma resposta que veio de outro perfil, com outras instruções e outras habilidades.

![Menu do perfil do Maestro aberto com a lista Profiles mostrando Revisor de propostas e Technical Writer Adapta, e o rodapé da barra lateral exibindo o assistente ativo.](https://guides.adapta.org/media/screenshots/maestro/assistentes-testar-2026-09-21/perfil-ativo-2026-09-21.png)

    *Dois lugares, duas informações: **1** a lista Profiles é onde você troca e **2** o rodapé é onde você confirma. Só o rodapé responde “quem vai responder agora”.*

3. **Envie uma amostra com resposta conferível**

    Abra **Novo chat** e envie o pedido abaixo. Calcule o resultado antes de ler a resposta.

````
Exercício fictício. Compare as propostas para 24 pessoas.
Orçamento total: R$ 9.000. Treinamento até 30/09/2026.
Não envie mensagens, não compre e não agende.
Use somente os dados abaixo. Datas são informadas,
não garantias de disponibilidade futura.

P1, versão 09/09: Horizonte Aprendizagem.
R$ 7.600 por turma de até 20 pessoas; excedentes R$ 150
por pessoa. Deslocamento R$ 600. Data 28/09.

P2, versão 09/09: Oficina Norte.
R$ 8.900 por turma de até 30 pessoas; todos os custos
incluídos. Data 02/10. Nenhuma alternativa informada.

P3, versão 09/09: Saber Prático.
R$ 7.200 por turma de até 24 pessoas. Data 29/09.
Deslocamento e materiais cobrados à parte, sem valor.

Entregue comparação por requisito, cálculos com fonte,
o que atende aos dados atuais e perguntas indispensáveis
antes de uma decisão. Não invente preço, qualidade,
reputação, desconto ou disponibilidade.

````

![Compositor do Maestro com o pedido da amostra colado e o rodapé da barra lateral mostrando o assistente Revisor de propostas ativo e rodando.](https://guides.adapta.org/media/screenshots/maestro/assistentes-testar-2026-09-21/amostra-enviada-2026-09-21.png)

    *Antes de enviar: **1** o pedido inteiro no compositor e **2** o rodapé, que continua mostrando qual assistente vai receber. Confira os dois na mesma tela.*

4. **Compare com o gabarito, não com a aparência**

    - **P1:** 24−20 = 4 excedentes; 4×150 = R$ 600. Total 7.600+600+600 = **R$ 8.800**; saldo de R$ 200. Data informada dentro do prazo.

    - **P2:** total **R$ 8.900** e capacidade suficiente. Data 02/10 fica depois de 30/09: não atende ao prazo informado.

    - **P3:** capacidade e data informadas atendem. Total desconhecido; os custos adicionais precisam ser **no máximo R$ 1.800** para caber no orçamento. Isso não é cotação nem garantia.

    Na execução de 21/09/2026, os três números vieram certos e nenhuma lacuna virou zero. P1 apareceu como a única que atende, com ressalvas; P3 ficou condicionada ao teto de R$ 1.800; P2 foi barrada pelo prazo.

![Resposta do assistente Revisor de propostas resumindo que P1 é a única que atende, com total R$ 8.800 e data 28/09, que P3 só fecha até R$ 1.800 e que P2 fura o prazo, com o rodapé mostrando o assistente ativo.](https://guides.adapta.org/media/screenshots/maestro/assistentes-testar-2026-09-21/resposta-conferida-2026-09-21.png)

    *Na resposta: **1** a conclusão com o total de P1 e a data, **2** a condição de P3 e o prazo que barra P2, e **3** o rodapé, que confirma qual assistente respondeu. Confira o **3** antes do **1**.*

    Aqui apareceu a primeira divergência útil: as instruções pediam **tabela por proposta com cálculo e fonte**, e a entrega veio como um parágrafo de resumo. Os números estavam certos; o formato, não. Marque esse tipo de diferença como erro concreto: “entregou resumo onde a instrução pedia tabela” corrige uma regra; “resposta ruim” não.

5. **Altere um dado e confira a atualização**

    Na mesma conversa, forneça a mudança explicitamente:

````
Atualização do exercício: P1 informa que a data passou
para 02/10/2026. Essa atualização substitui a data antiga.
Os demais dados permanecem iguais.
Refaça somente a conclusão por requisito e as pendências.
Não mantenha uma indicação baseada em 28/09.

````

    O gabarito muda: P1 e P2 deixam de atender ao prazo; P3 continua com custo final a confirmar. **Nenhuma proposta está integralmente confirmada pelos dados disponíveis.** Uma resposta que mantém P1 como adequada não incorporou a atualização.

![Resposta atualizada do assistente: a indicação anterior é descartada, nenhuma proposta atende aos dados atuais, o prazo até 30/09 é o requisito que impede o aceite e as pendências ficam listadas.](https://guides.adapta.org/media/screenshots/maestro/assistentes-testar-2026-09-21/atualizacao-conferida-2026-09-21.png)

    *Na atualização: **1** a indicação anterior é descartada de forma explícita, **2** nenhuma proposta atende e o prazo é apontado como o requisito que bloqueia, **3** P3 continua sem custo total em vez de virar a vencedora por eliminação e **4** as pendências ficam separadas da conclusão.*

    Repita a amostra original em uma conversa nova, com a mesma versão das instruções.

6. **Revise uma regra por vez e mantenha o registro**

    Guarde a versão anterior das instruções antes de qualquer alteração. Registre data, problema observado, regra ajustada, amostra repetida e resultado. No caso acima o registro seria: “v1.1: reforçar que a entrega é tabela por proposta, não resumo; repetir a amostra e conferir o formato”.

    Para alterar, use **Configuração** na página do assistente; é lá que ficam nome, instruções e persona. Depois de salvar, reabra os campos, confira o texto persistido e teste de novo antes de considerar a versão em uso. As conversas anteriores ficam em **Sessões**, o que dá para comparar antes e depois sem depender de memória.

![Tela de Configuração do assistente Revisor de propostas, com o campo Nome preenchido e o campo Instruções mostrando o texto persistido a partir de Função e Entradas.](https://guides.adapta.org/media/screenshots/maestro/assistentes-testar-2026-09-21/configuracao-persistida-2026-09-21.png)

    *Ao reabrir: **1** o nome e **2** as instruções que ficaram salvas de fato. Ler o texto persistido é o que confirma a versão em uso; a mensagem de salvo não confirma.*

    Não altere instruções, modelo, ferramentas e fontes ao mesmo tempo: você perderia a referência para entender o que mudou. Não exclua o assistente ou sessões para tentar obter uma resposta melhor.

## Critério para manter ou interromper a rotina

A amostra só passa quando cálculos, prazo, fonte e informação ausente estão corretos e nenhuma ação externa foi tomada. Se houver erro numérico, informação inventada ou execução fora do escopo, não use a saída para decidir.

O teste registrado aqui passou nos números e falhou no formato. Isso é motivo para ajustar uma regra e repetir, não para descartar o assistente nem para aprová-lo como está.

**Dica prática:** transforme uma falha em regra verificável. A aula 4 de Como Criar Assistentes de IA organiza regras, fluxo de interação e formato. Aqui isso significa pedir fonte por proposta e prever o estado “falta confirmar”, não acrescentar apenas “seja mais preciso”.

Reavalie quando mudar a função, a fonte de dados, o modelo, os acessos ou o formato exigido. A [referência de ferramentas](https://guides.adapta.org/guias/maestro/recursos-do-maestro/ferramentas/) ajuda a separar instrução de autorização.

Veja outros contextos de aplicação nos [casos de uso do Maestro](https://guides.adapta.org/guias/casos-de-uso/por-plataforma/maestro/).