> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Texto Curto e Longo

Sabemos que as Entradas de Usuário são a chave para criar agentes flexíveis, além de serem fáceis de usar. Neste tutorial, vamos dar um passo prático e construir um agente do zero, explorando os dois tipos de entrada de texto.

### **Entendendo os Tipos de Entrada de Texto**

No AI Studio, ao configurar uma Entrada de Usuário do tipo "Texto", você terá duas opções principais:

<Columns cols={2}>
  <Card title="Campo de Texto Curto">
    Ideal para quando você precisa que o usuário forneça informações curtas e objetivas, como um nome, um número, uma palavra-chave, uma URL ou um título.
  </Card>

  <Card title="Campo de Texto Longo">
    Perfeito para situações onde o usuário precisa fornecer um volume maior de informações, como um parágrafo de instruções, um bloco de texto para ser analisado ou uma descrição detalhada.
  </Card>
</Columns>

<Frame>
  <img src="https://mintcdn.com/tess-dfe1edf0/v6vmDCRPW-TIyYqs/images/image-90.png?fit=max&auto=format&n=v6vmDCRPW-TIyYqs&q=85&s=139f040730664708a7e399cd113a021f" alt="Image" width="382" height="265" data-path="images/image-90.png" />
</Frame>

### **Nosso Projeto Exemplo: O Agente Roteirista**

Vamos criar um agente exemplo capaz de desenvolver um roteiro para narração sobre um tema central, com uma duração específica.

Lembre-se que a criação de um agente passa pela elaboração da ideia, o desenvolvimento, teste e refinamento do prompt até a sua efetiva criação.

<Card icon="1" title="Configuração Inicial">
  No AI Studio, crie um novo agente. Para este exemplo, um Agente de Chat ou Texto é o ideal. Manter a seleção padrão de "All LLM" também funcionará perfeitamente e, vou permitir que o usuário final possa escolher:

  <Frame>
    <img src="https://mintcdn.com/tess-dfe1edf0/v6vmDCRPW-TIyYqs/images/image-91.png?fit=max&auto=format&n=v6vmDCRPW-TIyYqs&q=85&s=e29bd388f5ea585e78e0d01f15c72ab5" alt="Image" width="745" height="143" data-path="images/image-91.png" />
  </Frame>
</Card>

<Card icon="2" title="Desenvolvendo o Prompt (versão mais simples)">
  Vamos usar um prompt mais enxuto, mas que nos atenderá agora e ele preencherá o campo de prompt:

  > *Assuma a persona de um roteirista e storyteller sênior, especialista em criar narrativas envolventes para vídeos documentais e institucionais. Sua missão é desenvolver um roteiro original e impactante para uma locução (voiceover) profissional, abordando o seguinte tema: \[Aqui vai entrar a variável]*
  >
  > *O roteiro deve ser estruturado com uma introdução que desperte a curiosidade, um desenvolvimento que explique o tema de forma clara e fluida, e uma conclusão memorável. Utilize uma linguagem que seja ao mesmo tempo elegante e acessível, focando em criar imagens mentais fortes para o ouvinte.*
  >
  > *O resultado final deve ser apenas o texto a ser narrado, puro e limpo, sem qualquer tipo de formatação especial, nome de personagem (como 'Narrador:'), títulos ou instruções de cena. Entregue um texto pronto para ser gravado.*

  <Frame>
    <img src="https://mintcdn.com/tess-dfe1edf0/v6vmDCRPW-TIyYqs/images/image-92.png?fit=max&auto=format&n=v6vmDCRPW-TIyYqs&q=85&s=19f2612264b92abd1ee44574850997c2" alt="Image" width="768" height="353" data-path="images/image-92.png" />
  </Frame>
</Card>

<Card icon="3" title="Configurando a Entrada de Usuário">
  Agora, vamos criar o campo que o usuário final irá preencher com o tema. Como só vamos usar uma variável, precisaremos de apenas de um campo.

  * Clique em "Adicionar Entrada de Usuário" e vamos em texto curto
  * No campo "Nome da Variável", digitaremos exatamente tema.
  * No campo "Rótulo" (o que o usuário verá), digite algo amigável, como "Qual é o tema do roteiro?".

  <Frame>
    <img src="https://mintcdn.com/tess-dfe1edf0/v6vmDCRPW-TIyYqs/images/image-93.png?fit=max&auto=format&n=v6vmDCRPW-TIyYqs&q=85&s=7c3a67da6ccf36b7d5ea6a716302f9ab" alt="Image" width="459" height="313" data-path="images/image-93.png" />
  </Frame>

  Lembre-se da Conexão Essencial: O sucesso do agente depende da correspondência exata entre o Nome da Variável (tema) e onde ela ficará no prompt. É assim que a IA sabe onde encaixar a informação do usuário.

  <Frame>
    <img src="https://mintcdn.com/tess-dfe1edf0/v6vmDCRPW-TIyYqs/images/image-94.png?fit=max&auto=format&n=v6vmDCRPW-TIyYqs&q=85&s=152d4b7c3bdf4fc327edba2a8be73ae6" alt="Image" width="742" height="379" data-path="images/image-94.png" />
  </Frame>
</Card>

<Card icon="4" title="Salvando e Testando">
  Com o prompt e a única entrada configurados, nomeie o seu agente, clique em "Salvar" e, em seguida, em "Visualizar".

  <Frame>
    <img src="https://mintcdn.com/tess-dfe1edf0/v6vmDCRPW-TIyYqs/images/image-95.png?fit=max&auto=format&n=v6vmDCRPW-TIyYqs&q=85&s=c5c1526372c27e304f74539c4b4394b3" alt="Image" width="1083" height="495" data-path="images/image-95.png" />
  </Frame>

  Você verá uma interface extremamente limpa: apenas um campo para "Qual é o tema do roteiro?". Preencha-o, clique em executar e veja a mágica acontecer:

  <Frame>
    <img src="https://mintcdn.com/tess-dfe1edf0/GeLaBPApJmiQdE0B/images/CapturadeTela2026-02-13a%CC%80s18.57.14.png?fit=max&auto=format&n=GeLaBPApJmiQdE0B&q=85&s=e832b6292da607102305151520297708" alt="Captura De Tela 2026 02 13 Às 18 57 14" width="756" height="371" data-path="images/CapturadeTela2026-02-13às18.57.14.png" />
  </Frame>

  <Frame>
    <img src="https://mintcdn.com/tess-dfe1edf0/GeLaBPApJmiQdE0B/images/CapturadeTela2026-02-13a%CC%80s18.57.37.png?fit=max&auto=format&n=GeLaBPApJmiQdE0B&q=85&s=6ff687b2a2a3d9729d7a57906b2a8f1a" alt="Captura De Tela 2026 02 13 Às 18 57 37" width="763" height="388" data-path="images/CapturadeTela2026-02-13às18.57.37.png" />
  </Frame>

  <Frame>
    <img src="https://mintcdn.com/tess-dfe1edf0/v6vmDCRPW-TIyYqs/images/image-98.png?fit=max&auto=format&n=v6vmDCRPW-TIyYqs&q=85&s=0a04dce11a3855d0752bdc2535e5dd71" alt="Image" width="683" height="509" data-path="images/image-98.png" />
  </Frame>
</Card>

Este agente simplificado demonstra a essência das Entradas de Usuário: criar uma ferramenta reutilizável e fácil de usar.

<Check>
  A beleza do AI Studio é que você pode começar com um agente assim, simples e funcional, e depois, se necessário, adicionar mais complexidade. Você poderia, por exemplo, criar uma nova versão deste agente e adicionar uma segunda Entrada de Usuário para o "Tom de Voz" (ex: "Sério", "Descontraído", "Inspirador"), tornando sua ferramenta ainda mais poderosa.
</Check>

Dominar o básico é o primeiro passo para construir agentes cada vez mais incríveis. Quando estiver satisfeito, você pode alterar a visibilidade do seu agente no AI Studio para publicá-lo e disponibilizá-lo para outros usuários do seu workspace.

Continue explorando e combinando diferentes tipos de entrada para criar ferramentas de IA cada vez mais sofisticadas e úteis
