Each Table can be customized with specific columns, types, and semantic capabilities depending on your operational needs.
🪄 Step 1 — Create a New Table
- Navigate to Builder → Tables.
- Click Create new table + in the top-right corner.
- 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.
📋 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:
- Open your Table.
- Click Add Column +.
- Configure the following fields:
| Field | Description |
|---|---|
| Name | The column name. Each must be unique within the Table. |
| Description | Clearly describe what the column represents — the Agent uses this to interpret and interact with data correctly. |
| Type | Choose one of the supported field types (string, boolean, or number). |
| Enable Semantic Search | When 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. |
🧠 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:| Type | Description | Example |
|---|---|---|
| string | Textual information, such as names, messages, or identifiers. | "John Doe", "user_123", "Asked about campaign creation" |
| boolean | Logical values representing true or false. Ideal for flags or conditional logic. | true, false |
| number | Numeric data, such as counters, scores, or ratings. | 42, 3.14 |
⚙️ Best practice:
Usestringfor 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.
| chatId | Name | Question |
|---|---|---|
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.