Configurar playground

Este guia detalha o funcionamento do Playground de IA. O objetivo é orientar a equipe de administração a criar pacotes de mídia e realizar testes controlados para validar e refinar os prompts da Wisa AI antes de aplicá-los em fluxos de monitoria.

Visão geral do Playground

O Playground de IA é um ambiente seguro e controlado destinado à experimentação. Ele permite que você armazene exemplos reais de atendimentos (áudios ou transcrições) e os utilize para testar como a Inteligência Artificial interpreta suas instruções (prompts).

Ao utilizar o Playground, você consegue ajustar a precisão das avaliações da Wisa AI de forma ágil, sem a necessidade de configurar automações complexas ou processar grandes lotes de dados a cada pequena alteração.

Etapa 1: Criando e gerenciando pacotes de mídia

Para realizar testes, primeiro é necessário criar um pacote. O pacote funciona como uma pasta que organiza seus arquivos de mídia e define quais operações têm acesso a eles.

Criando um pacote

1. Acesse o menu Monitorias > Configurar playground.

2. Clique no botão Novo pacote.

3. Defina um nome para o pacote (ex: "Vendas - Cartões") e clique em Salvar.

4. Na coluna Ações do pacote desejado, clique em Associar operações e selecione as que poderão utilizar este pacote. Isso garante que apenas as pessoas com permissão de acesso a essas operações consigam visualizar e usar as mídias contidas nele.

Adicionando mídias ao pacote

Com o pacote criado, você deve adicionar os arquivos que servirão de base para os testes.

1. Na coluna Ações do pacote desejado, clique em Lista de mídias.

2. Na nova página, clique em Nova mídia.

3. Escolha o tipo de arquivo que deseja enviar:

   • Áudio ou vídeo: Envie arquivos de gravação (ex: .mp3, .wav, .mp4, .mov). O sistema realizará a transcrição automática do conteúdo.

   • JSON: Envie um arquivo estruturado contendo a transcrição já processada, caso possua. Esse arquivo precisa ser validado com a Weduka antes.

4. Para a opção Áudio ou vídeo, você deve adicionar um nome para a mídia ou selecionar Utilize o nome do arquivo físico. Além de selecionar o tipo de transcrição desejado. Para o JSON, é necessário apenas decidir o nome da mídia.

5. Clique em Salvar.

6. Aguarde o processamento. O status da mídia mudará para Pronto para uso assim que a transcrição for concluída.

Nota: Você pode visualizar o conteúdo da mídia e da transcrição além de realizar o download dos dois, clicando no ícone de Ações na lista de mídias.

Etapa 2: Testando prompts na prática

Com as mídias cadastradas no Playground, você pode testar seus prompts diretamente na tela de configuração da checklist ou do dashboard analítico da Wisa AI.

Acessando a área de teste

1. Acesse Monitorias > Gerenciar checklists (para prompts de itens) ou Gerenciar Wisa AI (para prompts do dashboard analítico).

2. Entre na edição do prompt que deseja validar.

3. Na janela de edição do prompt, localize e clique na aba Teste do prompt.

Executando um teste

1. No formulário de teste, selecione o Pacote que você criou.

2. Selecione a Mídia específica que deseja usar para este teste.

3. Clique no botão Testar prompt.

Analisando os resultados

O sistema processará a instrução do seu prompt na mídia selecionada e exibirá o resultado imediatamente na tela.

• Resultado: A resposta que a IA gerou (ex: "Conforme", "Não conforme", um número, ou um texto explicativo).

• Áudio ou vídeo: Se for uma mídia desse tipo, vocês poderá ouvir ou assistir ela.

• Transcrição: Você poderá ler a transcrição utilizada pra Wisa para gerar o resultado.

Se o resultado não for o esperado, você pode voltar à aba Configuração do prompt, ajustar o texto da instrução e voltar para Teste do prompt novamente. Esse ciclo rápido de ajuste e teste garante maior assertividade na configuração final.

Perguntas frequentes (FAQ)

Quem pode ver os pacotes de mídia que eu criei?
A visibilidade dos pacotes respeita as regras de sigilo de operação. Ao criar um pacote, você define a quais operações ele pertence. Apenas pessoas com permissão de acesso a essas mesmas operações e à página de Configurar playground poderão visualizar e utilizar o pacote. Se nenhum filtro de operação for selecionado, o pacote ficará visível para todas as pessoas com acesso à essa página.

Posso excluir uma mídia de um pacote?
Sim. Você pode excluir mídias individualmente. No entanto, para excluir um pacote inteiro, é necessário que ele esteja vazio. Ou seja, sem nenhuma mídia associada.

O teste salva automaticamente as alterações no meu prompt?
Não. A aba de teste serve apenas para validação. Se você fizer alterações no texto do prompt para testar novas abordagens, lembre-se de clicar no botão Salvar na janela de configuração para que as mudanças sejam aplicadas definitivamente.

Quais tipos de arquivo de áudio são aceitos?
O sistema aceita os formatos de áudio e vídeo padrão suportados pela plataforma. Mp3, ogg, wav, mp4, mpga, mov e webm. Ao fazer o upload, o arquivo é processado pelo motor de transcrição para gerar o texto que será analisado pela IA.