Pular para o conteúdo principal
Creating a new Table in Timely.ai is fast and intuitive.
Each Table can be customized with specific columns, types, and semantic capabilities depending on your operational needs.

🪄 Step 1 — Create a New Table

  1. Navigate to Builder → Tables.
  2. Click Create new table + in the top-right corner.
  3. Enter the following details:
    • Name — the Table identifier (e.g. Unanswered Questions, Feedbacks, Contacts).
    • Description (optional) — for internal use, describing the purpose of this Table.
Click Create Table to finish.

📋 Step 2 — Add Columns

Columns define the structure and behavior of your Table.
They determine what type of data each record will hold and how the Agent will interpret it.

➕ To add a column:

  1. Open your Table.
  2. Click Add Column +.
  3. Configure the following fields:
FieldDescription
NameThe column name. Each must be unique within the Table.
DescriptionClearly describe what the column represents — the Agent uses this to interpret and interact with data correctly.
TypeChoose one of the supported field types (string, boolean, or number).
Enable Semantic SearchWhen enabled, allows the Agent to query this column based on meaning and context, not just exact text matches. Recommended for descriptive or free-text fields.
Click Add Column to save.
🧠 Tip: Write clear and specific descriptions — the Agent reads them to infer intent and understand how to use the data.

🔧 Supported Column Types

Timely.ai currently supports three data types for Table columns:
TypeDescriptionExample
stringTextual information, such as names, messages, or identifiers."John Doe", "user_123", "Asked about campaign creation"
booleanLogical values representing true or false. Ideal for flags or conditional logic.true, false
numberNumeric data, such as counters, scores, or ratings.42, 3.14
⚙️ Best practice:
Use string for most descriptive text fields, and enable semantic search for fields where Agents need to interpret meaning — e.g. questions, feedbacks, or messages.

🧱 Step 3 — Add and Edit Rows

Rows represent the actual data stored inside the Table.
You can manually add rows or have them created dynamically by Agents or Workflows.

➕ To add a row:

  • Click Add row + and fill in each column’s value.

✏️ To edit a row:

  • Hover over a record, click the ⋮ (Edit) icon, and modify as needed.
Example — Table Unanswered Questions:
chatIdNameQuestion
5edca67d-dd2d-41e4-b7c0-23e4858f05e6“User asked if it’s possible to create proactive campaigns…”

🧩 Step 4 — Update or Delete Tables

You can modify a Table’s metadata at any time:
  • Click the ✏️ Edit button to update the name or description.
  • Click the ⋮ menu to rearrange or delete a Table.
⚠️ Warning:
Deleting a Table permanently removes all its data — this action cannot be undone.