> ## 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.

# Short and Long Text

We know that User Inputs are the key to creating flexible agents, as well as being easy to use. In this tutorial, we’ll take a practical step and build an agent from scratch, exploring the two types of text input.

### **Understanding the Types of Text Input**

In AI Studio, when configuring a User Input of type "Text", you’ll have two main options:

<Columns cols={2}>
  <Card title="Short Text Field">
    Ideal for when you need the user to provide short and objective information, such as a name, a number, a keyword, a URL, or a title.
  </Card>

  <Card title="Long Text Field">
    Perfect for situations where the user needs to provide a larger volume of information, such as a paragraph of instructions, a block of text to be analyzed, or a detailed description.
  </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>

### **Our Example Project: The Scriptwriter Agent**

Let’s create an example agent capable of developing a script for voiceover on a central theme, with a specific duration.

Remember that creating an agent goes through the stages of idea design, development, testing and refining the prompt, up to its effective creation.

<Card icon="1" title="Initial Setup">
  In AI Studio, create a new agent. For this example, a Chat or Text Agent is ideal. Keeping the default selection of "All LLM" will also work perfectly, and I’ll allow the end user to choose:

  <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="Developing the Prompt (simpler version)">
  We’ll use a more concise prompt that will work for now and will fill the prompt field:

  > *Assume the persona of a senior scriptwriter and storyteller, specializing in creating engaging narratives for documentary and institutional videos. Your mission is to develop an original and impactful script for a professional voiceover, addressing the following theme: \[The variable will go here]*
  >
  > *The script must be structured with an introduction that sparks curiosity, a development that explains the topic clearly and smoothly, and a memorable conclusion. Use language that is both elegant and accessible, focusing on creating strong mental images for the listener.*
  >
  > *The final result must be only the text to be narrated, pure and clean, without any kind of special formatting, character names (such as 'Narrator:'), titles, or scene directions. Deliver a text that is ready to be recorded.*

  <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="Configuring the User Input">
  Now we’ll create the field that the end user will fill with the theme. Since we’ll use only one variable, we’ll need just one field.

  * Click "Add User Input" and select short text
  * In the "Variable Name" field, type exactly tema.
  * In the "Label" field (what the user will see), type something friendly, such as "What is the script theme?".

  <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>

  Remember the Essential Connection: The agent’s success depends on the exact match between the Variable Name (tema) and where it will appear in the prompt. That’s how the AI knows where to insert the user’s information.

  <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="Saving and Testing">
  With the prompt and the single input configured, name your agent, click "Save", and then "Preview".

  <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="Screenshot 2026 02 13 At 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="Screenshot 2026 02 13 At 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>

This simplified agent demonstrates the essence of User Inputs: creating a reusable and easy-to-use tool.

<Check>
  The beauty of AI Studio is that you can start with an agent like this—simple and functional—and then, if necessary, add more complexity. You could, for example, create a new version of this agent and add a second User Input for "Tone of Voice" (e.g., "Serious", "Relaxed", "Inspiring"), making your tool even more powerful.
</Check>

Mastering the basics is the first step to building increasingly amazing agents. When you’re satisfied, you can change your agent’s visibility in AI Studio to publish it and make it available to other users in your workspace.

Keep exploring and combining different types of input to create increasingly sophisticated and useful AI tools.
