In Wexa Studio, Tables serve as databases that power your AI agents with the data they need to perform intelligent tasks. They are the foundation for dynamic, data-driven workflows, enabling agents to retrieve, manipulate, and act on information in real time.

Using Tables with the SDK:

Tables are essential for storing structured data that AI agents can access and modify. The SDK provides comprehensive APIs to create, manage, and interact with tables programmatically.

Creating Tables

1. Creating a Table

In Wexa Studio, click on + New Table. Using the SDK, you can create tables programmatically:

Using SDK to Create a Table:

2. Name Your Table

Choose a clear and meaningful name (e.g., Candidates, Jobs, Interview Schedule). The table name should reflect its purpose and make it easy to identify in your workflows.

Example Table Names:

Candidates - For storing candidate information

Jobs - For job listings

Interview Schedule - For scheduled interviews

Customer Records - For customer data

Inventory - For product inventory

Adding Records to Tables

1. Add & Customize Columns

When building or customizing a table in Wexa, each column defines a distinct field of data — like a form input for your records. Columns are essential to shaping how your table behaves and how agents interact with it.

1.1 Add a New Column

In Wexa Studio, you can add a new column using the + Add Column button in any table. With the SDK, you can create tables with custom columns:

Column Configuration:

Column Configuration Details:

Column Name: A user-friendly label for the column shown in the table UI. Example: Candidate Name

Column Key (column_id): A unique identifier used internally by Wexa and agents. Must be lowercase and use underscores. Example: candidate_name

Data Type: The format/type of data this column will accept. Wexa supports:

String: Text data

Number: Numeric values

Boolean: True/false values

Array: Lists of values (specify array_type)

Object: Structured data with nested fields

Default Value: An optional fallback value if no data is provided for this column

Supported Column Types:

2. View, Edit & Manage Records

In the table view, you can perform various operations on records:

Using SDK to Manage Records:

Available Operations:

Search records: Use the search bar with query parameters

Edit individual entries: Update records inline or via the View option

Import/export data: Use CSV or Excel for easy migration (handled in Wexa Studio UI)

3. Creating a New Row

Rows in Wexa tables represent individual records — for example, a candidate, a job listing, or a scheduled interview. Adding rows lets you populate your tables with data either manually or through automation.

3.1 Add a Single Row

Click the + Add Row button in Wexa Studio, or use the SDK to create a new row:

Using SDK to Create a Row:

3.2 Adding Multiple Rows

To streamline bulk data entry, you can add multiple rows at once. In Wexa Studio, click + Add More Rows in the top-right of the dialog. With the SDK, you can batch-create several rows:

Using SDK to Create Multiple Rows:

Bulk Import Example:

Table Triggers

Table Triggers in Wexa let you automatically launch Process Flows when a new row is added to a table based on specific conditions you define. This helps streamline workflows and eliminates the need for manual actions after data entry.

Using SDK to Configure Table Triggers:

1. Go to the Desired Table

First, identify the table where you want to add a trigger:

2. Click "Add Trigger"

In Wexa Studio, click "Add Trigger". With the SDK, you configure triggers when creating or updating tables:

3. Configure the Trigger

3.1 Trigger Name

Define your Trigger Name to distinguish it within your automation setup:

3.2 Use Filter

Toggle this on to define conditional logic (e.g., only trigger when Experience > 3):

3.3 Process Flow

Choose from available flows like Resume Ranker, Candidate Scorer, etc. This is the automation that will run when the trigger conditions are met:

Complete Trigger Example:

Multiple Triggers:

You can search or scroll to select the relevant process flow. Multiple triggers can be defined per table, each with its own logic and assigned process.

How Triggers Work:

Event Occurs: A new row is added to the table

Condition Check: If filters are defined, the trigger checks if conditions are met

Process Flow Execution: If conditions are satisfied, the specified Process Flow (AgentFlow) is automatically executed

Automation: The workflow runs without manual intervention

Example Workflow:

Intro to Tables

Creating Tables#

1. Creating a Table#

2. Name Your Table#

Adding Records to Tables#

1. Add & Customize Columns#

1.1 Add a New Column#

2. View, Edit & Manage Records#

3. Creating a New Row#

Table Triggers#

1. Go to the Desired Table#

2. Click "Add Trigger"#

3. Configure the Trigger#

3.1 Trigger Name#

3.2 Use Filter#

3.3 Process Flow#