Knowledge Briefs

Knowledge briefs are compiled summaries of what your agent knows and what it's missing. They drive the discovery process.

What's in a Brief?

A knowledge brief contains:

• Knowledge summary - what the agent currently knows based on its traces
• Gap summary - identified areas where the agent lacks knowledge
• Version - briefs are versioned; each compilation creates a new version
• Compiled at - when the brief was last compiled

Viewing Briefs

In the dashboard, navigate to your agent's detail page and click the "Briefs" tab:

• Current brief - the latest compiled version
• Gap list - identified knowledge gaps ranked by severity
• Version selector - switch between brief versions

Gap Identification

Kate identifies gaps by analyzing your agent's traces for patterns like:

• Generic responses where specific expertise would improve quality
• Escalations or failures in specific domains
• User follow-up questions indicating incomplete answers
• Tool call patterns that suggest missing knowledge

Example gaps:

• "Agent lacks SEO keyword research frameworks - gives topic suggestions without search volume or difficulty data"
• "Agent provides generic tax advice - no jurisdiction-specific guidance or entity structure optimization"

Comparing Versions

Compare two brief versions to see what changed:

1. Select a "from" version and a "to" version
2. View the diff showing additions, modifications, and resolved gaps
3. Understand how knowledge acquisition has affected your agent's knowledge state

Via SDK:

diff = await client.briefs.diff(
    agent_id="your-agent-id",
    from_version="1",
    to_version="3",
)
print(diff.summary)

Manual Recompilation

Briefs are compiled automatically as your agent accumulates traces. You can also trigger a manual recompilation:

1. Click "Recompile" in the briefs tab
2. Wait for compilation (typically 30-60 seconds)

Via SDK:

await client.briefs.compile(agent_id="your-agent-id")

Next Steps

• Briefs Client (SDK) - programmatic brief access
• Discovery Dashboard - discovery uses briefs to find artifacts
• What Are Buyers? - how briefs fit into the buyer workflow