As "Entradas de Usuário" são um recurso essencial no Agent Studio para criar agentes de IA mais interativos e customizáveis. Em vez de depender de uma única instrução em texto, você pode construir formulários e campos estruturados para coletar exatamente as informações que seu agente precisa para executar uma tarefa.
Neste guia, vamos explorar os cinco tipos de entrada de usuário disponíveis na plataforma Tess AI, mostrando como e quando utilizar cada um deles para potencializar suas criações.
Como Configurar uma Entrada de Usuário
Antes de explorarmos os tipos de entrada, o processo para adicioná-las é sempre o mesmo e acontece no painel de configuração do seu agente:
No Agent Studio, há a opção "Entrada do Usuário".
Clique nela para criar um novo campo de entrada.
Para cada variável, você irá configurar (pelo menos) três campos principais:
TIPO: O formato da entrada que o usuário irá preencher (texto, lista, arquivo, etc.).
NOME: O nome interno da variável, que será usado na instrução (prompt). Use nomes curtos, sem acentos e caracteres especiais.
DESCRIÇÃO: O texto que será exibido ao usuário final, orientando o preenchimento.
Explorando os Tipos de Entrada
Agora, vamos detalhar cada um dos tipos de entradas que você pode configurar.
1. Campo de Texto Curto
Ideal para coletar informações breves e diretas. Use este campo quando o usuário precisar preencher uma palavra, uma frase ou um dado específico.
Para que serve: Coletar nomes, e-mails, números de pedido, termos de busca, títulos de documentos, etc.
Exemplo de uso: Você pode criar um agente que gera saudações personalizadas. A variável Nome do Cliente (Texto Curto) pediria o nome do cliente:
E a instrução seria: "Crie uma saudação amigável para **nome-do-cliente**"
2. Campo de Texto Longo
Perfeito para situações em que o usuário precisa fornecer um grande volume de informações, como um texto completo, um parágrafo detalhado ou um bloco de código.
Para que serve: Permitir que o usuário cole um e-mail para ser resumido, um artigo para ser analisado, uma descrição de problema para ser diagnosticada, ou um código para ser depurado.
Exemplo de uso: Um agente revisor de textos. A variável Texto Completo (Texto Longo) solicitaria ao usuário que colasse o texto.
E a instrução seria: "Revise o seguinte texto e corrija os erros gramaticais: **texto-completo**"
3. Dropdown (Seleção Única)
Utilize o dropdown para garantir que a resposta do usuário seja padronizada. Ele apresenta uma lista de opções predefinidas, da qual o usuário pode escolher apenas uma.
Para que serve: Limitar a escolha a um conjunto de opções, como selecionar um idioma (Português, Inglês), um departamento (Vendas, Suporte), um tom de voz (Formal, Informal) ou uma ação específica (Traduzir, Resumir).
Exemplo de uso: Um agente tradutor. A variável idioma_alvo ropdown) ofereceria opções como "Inglês", "Espanhol" e "Francês". A instrução seria: "Traduza o texto a seguir para o idioma **idioma_alvo**."
4. Múltipla Escolha
Similar ao dropdown, mas com a flexibilidade de permitir que o usuário selecione várias opções de uma lista predefinida.
Para que serve: Quando o usuário pode escolher mais de uma alternativa válida, como selecionar os tópicos de interesse para um relatório, as redes sociais para publicar um post ou os recursos de um produto a serem incluídos em uma descrição.
Exemplo de uso: Um agente de criação de campanhas. A variável redes_sociais (Múltipla Escolha) listaria "Facebook", "Instagram" e "LinkedIn". A instrução seria: "Crie um post sobre IA para as seguintes redes: **redes_sociais**."
5. Upload de Arquivo
Este tipo de entrada transforma seu agente em um poderoso analista de documentos, permitindo que o usuário anexe arquivos para processamento.
Para que serve: Analisar contratos em PDF, extrair dados de planilhas em XLSX ou CSV, resumir relatórios em DOCX, ou interpretar o conteúdo de qualquer arquivo de texto.
Exemplo de uso: Um agente que analisa planilhas. A variável planilha_vendas (Arquivo) pediria o upload do arquivo, e a instrução seria: "Com base na planilha **planilha_vendas**, calcule o total de vendas do último trimestre."
