knowledge-browse

Group: Curation. List/filter documents + units.

When to trigger

• "What's in space X"
• "List the last 10 indexed docs"
• "Which documents have error status"
• "Show Academy units"

Arguments

Name	Type	Default	Description
scope	str	"documents"	"documents" OR "units"
connection	str	first ready	Target connection
space	str	null	Filter by space slug
unit_id	str	null	Filter by unit
content_type	str	null	lesson/tutorial/faq/reference/...
difficulty	str	null	beginner/intermediate/advanced
topics	list[str]	null	Filter by tags
status	str	null	pending/processing/ready/error
q	str	null	Text search on title
limit	int	20	How many to return

Workflow

Step 1 — Call the right endpoint

from dashboard.backend.sdk_client import evo

if scope == "documents":
    params = {k: v for k, v in {
        "space": space, "unit_id": unit_id, "content_type": content_type,
        "difficulty": difficulty, "topics": ",".join(topics or []),
        "status": status, "q": q, "limit": limit,
    }.items() if v is not None}
    items = evo.get("/api/knowledge/v1/documents", params=params,
                    headers={"X-Knowledge-Connection": connection})
elif scope == "units":
    params = {"space": space, "limit": limit}
    items = evo.get("/api/knowledge/v1/units", params=params,
                    headers={"X-Knowledge-Connection": connection})

Step 2 — Render markdown table

Documents:

| Title | Type | Difficulty | Topics | Chunks | Status | Added |
|---|---|---|---|---|---|---|
| ... | lesson | beginner | [whatsapp, auth] | 14 | ready | 2026-04-20 |

Units:

| Title | Slug | Space | Seq | Docs | Created |
|---|---|---|---|---|---|
| ... | ... | academy | 1 | 5 | 2026-04-15 |

Step 3 — Footer

Showing {len(items)} of {total} {scope} in {connection}{/space if filtered}.
Filters applied: {filters_summary}.

Actionable failures

• 0 results → suggest relaxing filters
• Space not found → list available spaces
• Connection not found → "Run knowledge-admin action=health"