Overview
Agent sessions are the core of TensorStax’s Agentic Data OS. Before you can start asking questions or running analysis, you need to configure the context that defines which data sources and tables your agent will work with.Getting Started with Context
The first and most important step in any agent session is selecting your context. Context tells the agent which materialized tables it should focus on for your analysis.dbt Model Integration - TensorStax automatically maps your materialized tables to their source dbt models and pulls the complete lineage including source models, YAML configurations, tests, and macros. This allows TensorStax to create new models following your existing patterns and edit existing files when needed.
Context Configuration
Selecting Materialized Tables
Selecting Materialized Tables
The primary component of your context is selecting which materialized tables you want to work with. You can:
- Search for tables: Use the search functionality to quickly find specific tables
- Browse available tables: Use the dropdown to explore all available materialized tables
- View table schema: Once selected, you’ll see all columns available in each table
Table Schema Display
Table Schema Display
When you select materialized tables, TensorStax automatically:
- Shows all column names and data types
- Displays table relationships and dependencies
- Pulls the complete DDL (Data Definition Language) for the table in the background
Data Privacy & Security
Data Privacy & Security
Important: TensorStax by default never sees your raw data. The system only accesses table schemas and metadata to understand your data structure.
- Pull the first row from your database
- Provide the agent with actual data examples
- Enable more sophisticated analysis tasks like flattening nested JSON fields
- Help with data type inference and validation
Only enable “Include Sample Row” when you’re comfortable sharing a sample of your data with the analysis engine.
Applying Context
Applying Context
Once you’ve configured your context:
- Review your selections: Confirm the tables and settings are correct
- Apply context: Click apply to activate your configuration
- Background processing: TensorStax builds lineage mapping your materialized tables to their source dbt models, tests, and macros
- Ready for analysis: Your agent session is now ready for questions and tasks
Use Cases for Sample Rows
Use Cases for Sample Rows
Enabling sample rows is useful for JSON field analysis, data type validation, and complex transformations that require actual data examples.
Privacy First: TensorStax only accesses your table schemas and DDLs by default - your raw data remains private and secure unless you explicitly enable sample rows.
JIRA Integration
JIRA Tickets
JIRA Tickets
Pull JIRA tickets and have TensorStax work on them autonomously in the background, creating models and updating ticket status.