IA Workbench

Visão Geral

O IA Workbench é uma plataforma completa para desenvolvimento e gestão de agentes com IA Generativa. Ele oferece um conjunto integrado de ferramentas para criar, versionar, testar, implantar e gerenciar agentes de IA para diferentes clientes.

Funcionalidades Principais

1. Dashboard

O Dashboard é a página inicial do workbench, fornecendo uma visão geral do sistema e acesso rápido às principais funcionalidades.

Recursos:

  • Visão geral das métricas do sistema
  • Lista dos agentes mais recentes criados
  • Cards de navegação rápida para todas as seções do workbench
  • Acesso direto às principais funcionalidades

Navegação Rápida:

  • Gerenciar Agentes
  • Implantação
  • Gerenciar Clientes
  • Playground
  • Configurações de IA

2. Agentes (Templates)

A seção Agentes permite criar, editar e versionar agentes de IA Generativa.

Funcionalidades:

  • Criar novos agentes: Crie novos agentes de IA com nomes personalizados
  • Gerenciar versões: Cada agente pode ter múltiplas versões, permitindo controle de histórico e rollback
  • Editar instruções: Defina as instruções (prompts) que guiam o comportamento do agente
  • Gerenciar parâmetros: Configure parâmetros dinâmicos que podem ser ajustados por cliente
  • Visualizar histórico: Veja todas as versões de um agente, incluindo data de criação e autor
  • Excluir versões: Remova versões específicas ou agentes completos quando necessário

Fluxo de Trabalho:

  1. Criar um novo agente ou selecionar um existente
  2. Escolher uma versão para editar ou criar uma nova versão
  3. Editar instruções e parâmetros
  4. Salvar como nova versão ou atualizar a versão atual

Criando um Agente

  1. Acesse Agentes no menu
  2. Clique em Novo Agente
  3. Digite um nome único para o agente
  4. Configure as Instruções:
    • Descreva o papel do agente
    • Defina o tom de voz e personalidade
    • Especifique regras de comportamento
    • Inclua exemplos de interações
  5. Adicione Parâmetros (opcional):
    • Chave: Nome do parâmetro (ex: “nome_empresa”)
    • Valor: Valor padrão ou exemplo
  6. Salve como versão 1

Gerenciando Versões

  • Cada vez que você salva alterações, pode criar uma nova versão ou atualizar uma existente
  • Versões anteriores são mantidas para referência
  • Você pode fazer rollback para versões anteriores durante o deploy

3. Implantação (Deploy)

A seção Implantação permite implementar agentes em clientes específicos ou em lote.

Funcionalidades:

  • Seleção de agente: Escolha qual agente e versão deseja implantar
  • Seleção de clientes: Selecione um ou múltiplos clientes (bots) para receber o agente
  • Configuração de IA: Associe uma configuração de IA específica para o deploy
  • Deploy em lote: Implemente o mesmo agente para vários clientes simultaneamente
  • Visualização de instruções: Veja as instruções do agente antes de implantar
  • Feedback de resultado: Receba informações sobre sucessos e falhas do deploy

Processo de Deploy:

  1. Selecionar o agente e versão
  2. Escolher a configuração de IA
  3. Selecionar os clientes de destino
  4. Executar o deploy
  5. Visualizar resultados

Fazendo Deploy

  1. Acesse Deploy no menu
  2. Passo 1: Selecione o Agente que deseja implantar
  3. Passo 2: Selecione a Versão do agente
  4. Passo 3: Selecione a Configuração de IA a ser usada
  5. Passo 4: Selecione um ou múltiplos Clientes
    • Use “Selecionar Todos” para deploy em massa
    • Ou selecione clientes individualmente
  6. Revise as Instruções do agente (opcional)
  7. Clique em Fazer Deploy
  8. Acompanhe o resultado:
    • ✅ Sucesso: Cliente atualizado com sucesso
    • ❌ Falha: Verifique os erros e tente novamente

4. Clientes (Bots)

A seção Clientes permite visualizar e gerenciar os bots/clientes cadastrados no sistema.

Funcionalidades:

  • Listagem de clientes: Visualize todos os clientes cadastrados
  • Filtros e busca: Filtre por agente ou busque por nome
  • Visualização de versões: Veja qual versão de agente cada cliente está usando
  • Atualização de versão: Atualize a versão do agente de um cliente específico
  • Gerenciamento de configurações: Associe ou altere a configuração de IA de um cliente
  • Importação de bots: Importe bots de outros sistemas ou ambientes
  • Informações detalhadas: Visualize informações completas sobre cada cliente, incluindo:
    • ID do bot
    • Nome do cliente
    • Agente associado e versão
    • Configuração de IA ativa
    • Status e histórico

Gerenciando Clientes

  1. Acesse Clientes no menu
  2. Use a busca para encontrar clientes específicos
  3. Use o filtro por agente para ver clientes de um agente específico
  4. Para alterar um cliente:
    • Clique no menu de ações (⋮) do cliente
    • Escolha:
      • Alterar Versão: Atualizar para outra versão do mesmo agente
      • Alterar Agente: Trocar o agente completamente
      • Alterar Configuração de IA: Associar outra configuração de IA

Importar Clientes

Você pode importar clientes de outros sistemas através de arquivo:

  1. Clique em Importar Clientes
  2. Selecione o arquivo (formato suportado)
  3. Revise os dados importados
  4. Confirme a importação

5. Playground

O Playground é um ambiente de teste interativo para experimentar com agentes de IA em tempo real.

Funcionalidades:

  • Conversação em tempo real: Converse com os agentes como se fosse um usuário final
  • Seleção de cliente: Escolha qual cliente (bot) deseja testar
  • Simulação de conversas: Teste diferentes cenários e interações
  • Histórico de mensagens: Visualize todo o histórico da conversa
  • Nova conversa: Inicie uma nova conversa a qualquer momento
  • Teste seguro: As alterações no playground não afetam os clientes reais

Casos de Uso:

  • Testar novas versões de agentes antes de fazer deploy
  • Validar comportamento do agente em diferentes cenários
  • Experimentar com diferentes configurações
  • Debugging e desenvolvimento

Usando o Playground

  1. Acesse Playground no menu
  2. Selecione um Cliente (bot) que tenha uma configuração de IA associada
  3. Preencha:
    • Nome do Cliente: Nome para simulação
    • Telefone do Cliente: Telefone para simulação
  4. Clique em Nova Conversa
  5. Envie mensagens e teste o comportamento do agente
  6. Ajuste instruções ou configurações conforme necessário

Fluxo de Trabalho Típico

Criar e Implantar um Novo Agente

  1. Criar o Agente (Agentes)

    • Acesse a seção “Agentes”
    • Clique em “Novo Agente”
    • Defina o nome e crie a primeira versão
    • Configure instruções e parâmetros

  2. Testar no Playground (Playground)

    • Selecione o cliente que deseja testar
    • Inicie uma conversa e teste o comportamento do agente
    • Ajuste instruções se necessário

  3. Configurar IA (Configurações)

    • Crie ou selecione uma configuração de IA apropriada
    • Ajuste parâmetros conforme necessário

  4. Fazer Deploy (Implantação)

    • Selecione o agente e versão
    • Escolha a configuração de IA
    • Selecione os clientes de destino
    • Execute o deploy

  5. Monitorar Clientes (Clientes)

    • Verifique quais clientes estão usando o agente
    • Atualize versões quando necessário

Acesso e Segurança

  • O sistema utiliza Auth0 para autenticação
  • Apenas usuários autenticados podem acessar o workbench
  • Controle de acesso por email nas configurações de IA
  • Tokens de autenticação são gerenciados automaticamente

Credenciais: As credenciais são fornecidas exclusivamente pelo time Lifty. Entre em contato conosco para obtê-las.

💡 Dicas e Boas Práticas

Escrevendo Instruções Eficazes

  • Seja Específico: Defina claramente o papel e comportamento do agente
  • Use Exemplos: Inclua exemplos de interações esperadas
  • Defina Limites: Especifique o que o agente NÃO deve fazer
  • Mantenha Organizado: Use formatação clara e estrutura lógica
  • Teste Sempre: Use o Playground antes de fazer deploy

Estratégias de Deploy

  • Teste Primeiro: Sempre teste no Playground antes de fazer deploy
  • Deploy Gradual: Comece com poucos clientes e expanda
  • Monitore Resultados: Acompanhe o desempenho após o deploy
  • Mantenha Versões: Não exclua versões antigas imediatamente
  • Documente Mudanças: Mantenha registro das alterações

🆘 Dúvidas Frequentes

Sobre Agentes

Quantos agentes posso criar?

Não há um limite específico documentado, mas é recomendado manter um número gerenciável para facilitar organização e manutenção.

Posso ter o mesmo agente para múltiplos clientes?

Sim! Um agente pode ser associado a múltiplos clientes através do processo de deploy. Cada cliente pode ter sua própria versão e configuração de IA.

Posso duplicar um agente existente?

Sim, você pode criar um novo agente baseado em um existente copiando as instruções e parâmetros.

Qual a diferença entre modelos Lifty e customizados?

Modelos Lifty são pré-configurados e gerenciados pela Lifty, mais fáceis de usar. Modelos customizados permitem usar suas próprias API keys e ter controle total.

Sobre Deploy

Quanto tempo leva para fazer deploy?

O processo geralmente leva alguns segundos a minutos, dependendo do número de clientes selecionados.

Posso desfazer um deploy?

Sim, você pode fazer rollback alterando a versão do agente ou a configuração de IA através da página de Clientes.

O que acontece se eu fizer deploy sem testar?

É altamente recomendado testar no Playground antes do deploy. Fazer deploy sem testar pode resultar em respostas inadequadas ou comportamento inesperado.

Sobre Playground

As conversas no Playground são salvas?

As conversas são mantidas durante a sessão atual, mas são limpas quando você inicia uma nova conversa.

Quantas vezes devo testar antes do deploy?

Recomenda-se testar pelo menos 10-15 cenários diferentes antes de fazer deploy em produção.

Problemas Técnicos

O agente não está respondendo corretamente

  1. Verifique as instruções do agente
  2. Revise a configuração de IA
  3. Teste no Playground para identificar o problema
  4. Ajuste parâmetros conforme necessário

Não consigo fazer deploy

  1. Verifique se todas as seleções estão preenchidas
  2. Confirme que o cliente tem configuração de IA associada
  3. Revise mensagens de erro específicas

📞 Suporte

Se você não encontrar a informação que precisa ou tiver dúvidas sobre qualquer funcionalidade do IA Workbench, entre em contato com o suporte técnico:

Última atualização: Dezembro 2025
Versão da documentação: 1.0

Este guia será atualizado conforme novas funcionalidades forem disponibilizadas no IA Workbench.

Suporte

Se você encontrar algum problema ou tiver dúvidas sobre este conteúdo, entre em contato com nosso time de suporte:

suporte@lifty.com.br
(11) 93535-1343
Segunda a Sexta, 9h às 18h

Concentre-se no que realmente importa

Seja um parceiro

Nós cuidamos da tecnologia para otimizar sua comunicação no WhatsApp. Simplifique seus processos e alcance melhores resultados!