knowledge-browse

name	knowledge-browse
description	List and filter documents and units in the Knowledge base. Use when the user wants to see what is indexed ('what's in space X', 'list the last 10 indexed docs', 'which documents have error status', 'show Academy units').

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"