KnowledgeGaps

Code

import { KnowledgeGaps, type KnowledgeGap } from "@fadymondy/nasaq/web";export function Gaps({ gaps }: { gaps: KnowledgeGap[] }) {  return (    <KnowledgeGaps      gaps={gaps}      onResolve={async (gap, status) => {        const res = await api.setGapStatus(gap.id, status);        if (!res.ok) return { error: res.message };      }}    />  );}

AI Agents · beta

Live examples and controls: KnowledgeGaps in the lab.

InstallCopy Anchor Link

npx shadcn@latest add https://docs.nasaqui.com/r/knowledge-gaps.json

A triage list of questions people asked that the brain had no answer for. Each gap shows how often it came up and when, and can be marked indexed (you added the missing knowledge), dismissed, or reopened.

When to useCopy Anchor Link

• A brain admin page that reviews unanswered questions.
• Any list where items move between open, done and dismissed with a server round trip.

When not to useCopy Anchor Link

• Searching memories: use SemanticSearch.
• General status workflows: use EntityList with status filters.

ImportCopy Anchor Link

import { KnowledgeGaps } from "@fadymondy/nasaq/web";

Quick startCopy Anchor Link

import { KnowledgeGaps, type KnowledgeGap } from "@fadymondy/nasaq/web";

export function Gaps({ gaps }: { gaps: KnowledgeGap[] }) {
  return (
    <KnowledgeGaps
      gaps={gaps}
      onResolve={async (gap, status) => {
        const res = await api.setGapStatus(gap.id, status);
        if (!res.ok) return { error: res.message };
      }}
    />
  );
}

AnatomyCopy Anchor Link

A status filter (ToggleGroup) with counts, then a list per status. Each row: the query, a hits bar, first and last asked (DateTime), an optional resolution note, and Mark indexed, Dismiss or Reopen buttons. The same actions are in a context menu (ContextMenuActions).

APICopy Anchor Link

ExamplesCopy Anchor Link

Uncontrolled filter, open first

<KnowledgeGaps gaps={gaps} defaultStatus="open" onResolve={save} />

AccessibilityCopy Anchor Link

Status is text plus an icon, never colour alone. Action buttons carry the query in their accessible name. A busy button shows a spinner and is disabled while the request runs. Errors are announced.

RTL & i18nCopy Anchor Link

• English and Arabic strings ship and follow the Nasaq locale. Pass labels to override any string.
• Layout uses logical properties, so it mirrors in right-to-left. Numbers and dates follow the locale.

Styling & tokensCopy Anchor Link

• Status tones come from Status (neutral, success, warning). The hits bar uses bg-nq-accent on bg-secondary.

Do / Don'tCopy Anchor Link

• Do return { error } from onResolve instead of throwing.
• Don't hide the dismissed list; people reopen gaps.

RelatedCopy Anchor Link

• SemanticSearch
• BrainList

LabCopy Anchor Link

https://docs.nasaqui.com/?path=/docs/components-ai-agents-knowledge-gaps--docs