Course overview/Governance as agent context1 of 5
Descriptions and tags
Descriptions and tags
Write context that records a data caveat an agent cannot infer from a column name.
A description is agent input
customer_id: the customer id restates the name. A useful description records a unit, population, caveat, canonical alternative, or source-system constraint. In this project, net_price is the line-revenue input while unit_price is the list price; order_total is an order-header figure that does not reconcile to line revenue.
Tags select work and mark layers. domains and owner set accountability. Column metadata carries structured facts. bruin ai enhance can draft descriptions, but each claim needs a query-based check before it becomes context another agent trusts.
Your task
For every column in weekly_category_revenue.sql, run a query that supports the description you plan to write. Add a non-redundant description for each column and preserve layer:mart in the asset tags. Validate the asset.
Check your understanding
- What makes
customer_id: the customer ida useless description, precisely? - Why is
orders.order_totala case where the description has to carry a warning rather than a definition? - A description says
order_statusneedsUPPER(TRIM(...))before filtering. Why is that description still wrong? - Why verify
bruin ai enhanceoutput against the data instead of publishing it directly?
Do it with your agent
Say next lesson, write only descriptions you can support, then say review my work. The review should reject restated names and unverified claims.