Skip to content

[Feature]: Inline Source Chips: Replace Inline Text Citations with Clickable Chunk-Linked Chips #148

Description

@kaiyu96

Problem statement

The Knowhere Notebook Assistant currently appends source links at the end of each response. Within the response body, referenced chunks are represented only as plain text placeholders (e.g., [Source 1], [Source 2]), which carry no navigational value — users cannot click them to jump to the relevant chunk, and they provide no visual indication of what document is being cited.

This creates a friction-heavy reading experience:

  • Users must cross-reference between the response body and the source list at the bottom to understand what evidence supports each claim
  • The plain-text citation markers are visually noisy but functionally useless — they occupy space without enabling any action
  • For long responses with multiple sources, the disconnect between inline mentions and the appended link list makes it difficult to trace specific statements back to their source chunks
  • The current pattern discourages source verification, which undermines trust in the assistant's answers
Image

Affected area

Other

Proposed solution

Replace the plain-text inline source markers in the response body with clickable source chips, and remove the redundant source link list at the bottom of each answer.

Chip behavior and design spec:

  • Each chip uses the existing Figma Chip component (no icon variant) as the visual primitive

  • Chip label displays the document filename (e.g., spacex_s1_p1-136.pdf)

  • Chip max-width is 250px; labels exceeding this width are truncated with an ellipsis (…)

  • On hover: chip background highlights, cursor changes to pointer (cursor: pointer), and a Figma Tooltip component appears showing the full, untruncated source label

  • On click: navigates directly to the corresponding parsed chunk in the Playground viewer

Image

Alternatives considered

No response

Compatibility and migration notes

No response

Additional context

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions