// Report knowledge issues (outdated, incorrect, or missing content) in the RAG knowledge base. Use when search results seem outdated or wrong, when a topic should be covered but isn't found, or when a chunk contains incorrect information. This helps maintain knowledge base quality.
Contribute new verified knowledge to the RAG knowledge base. Use after you've solved a concrete problem, debugged a non-obvious issue, or discovered undocumented behavior that would help future agents — but only after calling zeabur-rag-search first to confirm the knowledge isn't already covered. Only contribute verified facts, not guesses or workarounds. The new chunk is marked unverified until an admin reviews it.
Interactive knowledge base curation loop — reviews pending items (reports, unverified chunks, failed queries, negative feedback) and walks through fixes one by one. Use when asked to "maintain the knowledge base", "review pending items", "run a curation round", "process reports", "clean up the KB", or any request to improve KB quality. This is the main entry point for the expand → organize → reflect cycle, and requires admin scope.
Send feedback on RAG search results — thumbs-up (+1) or thumbs-down (-1) to indicate whether the answer was helpful. Use after calling zeabur-rag-search when you can evaluate the quality of the results. Positive feedback reinforces good results; negative feedback flags poor matches for review. Requires write:feedback scope.
View a single chunk's full content plus related reports, search signals, and edit history. Use when you need to understand a chunk's context before editing, when investigating why a search result appeared, or when reviewing a reported issue. Triggers on "inspect chunk SUP-1234", "show chunk DOC-xxx", "chunk history", "why did this result appear", "look at this chunk". Requires admin scope.
Search the RAG knowledge base via hybrid search (semantic + BM25). Use whenever answering technical questions that may be covered in your knowledge base — even if the user doesn't explicitly ask you to search. Also use when you need to verify claims or find up-to-date information.
List pending knowledge base maintenance items — open reports, unverified learned chunks, low-score queries, and negative feedback. Use when checking KB health, reviewing the maintenance queue, or starting a curation session. Triggers on "review queue", "what needs attention in the KB", "pending reports", "unverified chunks", "failed queries", "KB health check". Requires admin scope.
| name | zeabur-rag-report |
| description | Report knowledge issues (outdated, incorrect, or missing content) in the RAG knowledge base. Use when search results seem outdated or wrong, when a topic should be covered but isn't found, or when a chunk contains incorrect information. This helps maintain knowledge base quality. |
Report issues with knowledge base content so they can be reviewed and fixed.
Base URL: $ZEABUR_RAG_URL
Auth: Authorization: Bearer $RAG_API_KEY
curl -s -X POST "$ZEABUR_RAG_URL/api/report" \
-H "Authorization: Bearer $RAG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "outdated",
"chunk_id": "DOC-1234",
"query": "the query you searched",
"detail": "what is wrong or missing"
}'
| Field | Required | Description |
|---|---|---|
type | Yes | "outdated" / "incorrect" / "missing" |
chunk_id | No | ID of the problematic chunk |
query | No | The query that surfaced the issue |
detail | No | Description of what is wrong or missing |
| Situation | Type |
|---|---|
| Info was once correct but is now stale | outdated |
| Chunk contains factually wrong info | incorrect |
| Topic should exist but no chunks found | missing |