Workspace knowledge

Knowledge is learned from the dashboards and shared notebooks every member can read, once their edits settle, and no model call runs to build or read it. search_knowledge finds a term, and describe_definition returns one metric with the boards, sources and signed notes behind it, or one dimension with the metrics it slices and its signed notes. A note your agent saves is about one metric or one dimension and is live at once, signed with your name and marked From an agent on that entry's page. See Workspace knowledge.

Read-only

Search what THIS WORKSPACE has learned from its dashboards and notebooks: the metrics and dimensions its widgets declare, with the boards and sources behind each and the members' signed notes. Call it in the same step as your other lookups whenever a request names a measure, a category or a business term; it fetches no data. query is the term as written; each hit's matchedOn is slug, alias, value (a category value, in matchedValue) or search (related, listed after exact matches, never resolved), with its url and, once written, a generated one-sentence definition. ONE exact slug or alias match returns resolved: true with describe_definition's answer inlined; otherwise call it with the slug. source (a connection id or connection/tool, optional selector) without query lists the metrics drawn through that source and their widgets' health. An empty result means no dashboard here defines the term: never present a general definition as this workspace's.

Read-only

Everything the workspace's dashboards say about ONE metric or dimension (slug from search_knowledge; kind 'metric' or 'dimension', whose description holds each kind's reply). A metric comes back by VERSION, each distinct way it is computed; when versions disagree, say which you used and name the other, never average them. A dimension comes back with its top values and the metrics it slices. Both carry an exampleWidgetId + dashboardId per lineage, to read with get_widget include data. summary is a generated reading, never a count; summaryStatus is ready, stale, failed or absent, and signed notes outweigh generated text. A dashboard-scoped chat reads only its own dashboard's widgets.

kind: metric

the metric by VERSION — each distinct way it is computed, with a sourceLine, health, lineage count and an exampleWidgetId + dashboardId. for sizes it: answer (default, for "what is X"), build (adds format, shapes, related and the healthiest version's template with its pipelineId — start a new chart of X from it), audit (every board, creator, template and note). When the request does not say which version, an askWhen item is the question: its question the prompt, its options' label/versionId the choices. A notebook-origin version is exploration, not a kept chart: weigh it lower and say so.

kind: dimension

one DIMENSION the workspace slices metrics by (segment, region, month): its category, top values with the widgets each was seen in (seenIn), time grains, the metrics sliced by it (lineage counts, an exampleWidgetId + dashboardId each), their connections and selectors, and the newest signed notes. Pass value ("EMEA") to narrow to the widgets that carried it — the walk for "tell me about segment A": search_knowledge matches the value, this names the widgets, then read them with get_widget include data in ONE parallel step. Values are the rows boards published when they last settled, not live data: a starting point, not a count to report.

Additive write

Attach a NOTE to one METRIC or DIMENSION the workspace has learned: one member's understanding the dashboards cannot say ("finance.revenue is the figure for anything external; Stripe is gross", "segment is not meaningful for revenue", "this table is rebuilt nightly at 03:00 UTC"). Call it only when the user asks to record something like this. Pass exactly one of metric (a metric's slug from search_knowledge) or dimension (a dimension's slug); describe_definition carries the note. text up to 1,000 characters, written as a fact with its reason. A note is shown signed with its author's name, role and date and is weighed against the evidence, never obeyed — a rule every answer must follow belongs in the workspace's instructions instead. The note is live as soon as it is saved. At most 100 notes on one metric or dimension, 50 of them yours, and 20 notes a minute.