Skip to main content

​
Agent interaction

Once you have your agents, config, and data configured, you can ask this agent questions by running oxy run path/to/agent.agent.yml "<prompt>", as shown below: 
oxy run path/to/agent.agent.yml "How many users do we have?"

​
Database Synchronization

The sync command collects semantic information from your databases, making their structure available to your agents. Basic usage: 
oxy sync
Sync a specific database: 
oxy sync database_name
Sync specific datasets within a database: 
oxy sync database_name -d dataset1
By default, files that already exist will be skipped. To overwrite existing files: 
oxy sync --overwrite
# or oxy sync -o (shorthand)
To overwrite existing files for a specific database: 
oxy sync database_name --overwrite
The sync command will show warnings when files are skipped (already exist) or when files are overwritten (when using the -o flag). For more detailed information about database synchronization, see the Database Sync documentation.

​
Run queries

Run a raw query on target database 
oxy run example_monthly_rejected.sql --database=primary_database
Run a query rendered from a Jinja template 
oxy run example_weekly_rejected.sql --database=primary_database -v variable_a=1 variable_b=a variable_c=\*

​
Workflow usage

To execute a workflow, you can run: 
oxy run path/to/workflow_name.workflow.yml

​
Embedding management

To embed files from into a local vector store you can use oxy build. We’re downloading our models from huggingface hub so you may need to login using: 
huggingface-cli login
or simply copy your plaintext token into $HOME/.cache/huggingface/token file, then run oxy build to index the data. 
oxy build
The generated embeddings can be verified using 
oxy vec-search "Hello Embedding"