
- Agent Configuration: Define agents using
.agent.ymlfiles that specify their instructions. Agents are provided tools to generate SQL, execute semantic queries, and execute procedures. We recommend using a routing agent as the first layer, which can deterministically execute procedures, with a SQL-generation agent as a fallback. This ensures that vetted procedures run with high determinism against their attached inclusions, while the SQL generation fallback provides broad coverage for ad-hoc questions. - Procedure Development: Create
.procedure.ymlfiles to orchestrate multi-step processes. Useretrieve: includeandexcludeto control how these procedures are retrieved by agents that have access to them. - Testing Framework: Add test cases directly to
.agent.ymlor.procedure.ymlfiles. Execute tests using theoxy testcommand.
oxy start. Oxygen is also CLI-native, so every operation can be run from the terminal, making it easy to integrate with coding tools like Claude Code and CI/CD pipelines.