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

# O que é um agente?

> In Timely.ai, an **Agent** is more than a chatbot. <br /> It is a **configurable AI entity** capable of reasoning, using tools, interacting with data, and collaborating with humans — all inside a single platform. <br /> <br /> Agents are designed to start **simple** (just a Role and a Prompt) and evolve progressively with Memory, Knowledge, Tools, Workflows, and external integrations.

***

## Core Identity

<p style={{ marginBottom: 0 }}>Every Agent starts with two essential elements:</p>

<h3 style={{ marginTop: '1rem' }}>Role</h3>

A short description that defines the Agent’s purpose.

**Example**:
<br /> "Assistant specialized in customer onboarding."

<h3 style={{ marginTop: '1rem' }}>Prompt</h3>

A detailed instruction set (up to **5000 characters**) that defines:

* Behavior and tone
* Objectives and boundaries
* How the Agent should respond in different situations

<Tip>
  **Tip**: Whenever possible, keep essential knowledge directly in the Prompt to avoid unnecessary complexity.
</Tip>

***

## Settings That Shape Behavior

Agents are dynamic and configurable. These settings define *how* an Agent thinks and responds:

<h3 style={{ marginTop: '1rem' }}>Temperature</h3>

Controls creativity:

* `0%` → Fully methodical (finance, legal, compliance).
* `100%` → Highly creative (brainstorming, marketing).

<h3 style={{ marginTop: '1rem' }}>Effort</h3>

Defines how many reasoning steps the Agent can take. <br />
Range: **10-100**.

* Low (10-20): FAQs and simple flows
* High (80-100): Complex logic, tool orchestration, workflows

<h3 style={{ marginTop: '1rem' }}>Planning</h3>

When enabled, the Agent creates a **structured execution plan** before acting, considering available Tools and resources.

Recommended for Agents that operate in multi-step or decision-heavy environments.

<h3 style={{ marginTop: '1rem' }}>Reasoning</h3>

Controls the **depth of reasoning** applied when generating responses.

Available modes:

* **Low** - Faster responses for simple interactions
* **Medium** - Balanced reasoning for most business use cases
* **High** - Deeper analysis and structured thinking for complex problems

<Info>
  Higher reasoning levels may increase response time and credit usage.
</Info>

***

## Extending Agent Capabilities

Agents can be extended using native Timely.ai resources:

<h3 style={{ marginTop: '1rem' }}>Memory</h3>

Works like persistent variables. <br />
You decide what information should be stored and reused later.

**Examples**: name, email, budget, deadline.

<h3 style={{ marginTop: '1rem' }}>Knowledge Bases</h3>

Structured repositories for large or frequently updated content such as:

* FAQs
* Product manuals
* Internal policies

Agents access them via **Knowledge Search Tools**.

<h3 style={{ marginTop: '1rem' }}>Tables</h3>

Native Timely.ai databases used for structured data like:

* Leads
* Customers
* Orders
* Tickets

Tables can be queried and modified through dedicated **Tools**.

<h3 style={{ marginTop: '1rem' }}>Workflows</h3>

Predefined multi-step processes that automate business logic.

**Example**: <br /> “Validate input → call external API → update table → respond to user.”

<h3 style={{ marginTop: '1rem' }}>MCPs (Managed Connector Providers)</h3>

Native integrations with external platforms. <br />
Once connected, MCPs unlock new Tools for the Agent.

**Examples**: Google Calendar, Notion, Airtable, Supabase.

## Acting Through Tools

Agents are **passive by design** — they only act when triggered by user interaction or internal logic.

Tools allow Agents to perform actions such as:

* Execute code **(Code Execution)**
* Store and retrieve memory **(Contextual Memory)**
* Send follow-up messages after inactivity **(Follow Up)**
* Search Knowledge Bases **(Knowledge Search)**
* Read and extract data from PDFs **(PDF Reader)**
* Insert, update, or search table rows **(Table Row Insertion / Update / Search)**
* Perform semantic or similarity searches on tables
* Execute workflows **(Workflow Executor)**
* Send messages programmatically **(Message Sending)**
* Create tickets for human assistance **(Ticket Creation)**
* Make external API calls **(HTTP Request)**
* Perform web searches **(Web Search)**

<Info>
  **Best practice**: Only enable Tools your Agent is expected to use. Fewer tools lead to more predictable behavior.
</Info>

## Conditional Prompts

Conditional Prompts replace the previous concept of Tasks.

They allow you to define **instructions that execute only when specific conditions are met**, enabling dynamic and context-aware behavior.

**Examples**:

* If the user asks for a human → trigger **Ticket Creation**
* If the conversation reaches a certain context → adjust tone or flow
* If the user confirms an action → execute a Workflow

**Best practices**:

* Keep conditions explicit and non-overlapping
* Use Conditional Prompts for logic, not for core identity
* Avoid excessive chaining to preserve clarity and performance

## Where Agents Operate

After testing internally, Agents can be deployed to Channels:

* **Website Widget**
* **WhatsApp**
* **Instagram**
* **API**

The **API channel** allows Agents to be consumed programmatically by external systems, applications, or custom frontends.

Each channel requires a valid **Connection** when applicable.

## Why Timely Agents Are Different

1. **Simplicity first** — Launch with just a Role and Prompt
2. **Native data handling** — Knowledge Bases and Tables live inside Timely
3. **Structured orchestration** — Tools and Workflows enable complex automation
4. **Seamless human handoff** — Built-in CRM with Tickets and Teams
5. **Multi-LLM flexibility** — Optimize cost, speed, and accuracy

***

👉 In Timely.ai, an Agent is not just answering questions — it’s a **scalable digital teammate** that evolves with your business.