diff --git a/examples/chat/angular/src/app/modes/welcome-suggestions.ts b/examples/chat/angular/src/app/modes/welcome-suggestions.ts
index 04088a8ea..cae9db704 100644
--- a/examples/chat/angular/src/app/modes/welcome-suggestions.ts
+++ b/examples/chat/angular/src/app/modes/welcome-suggestions.ts
@@ -32,6 +32,6 @@ export const WELCOME_SUGGESTIONS: readonly WelcomeSuggestion[] = [
   {
     label: 'What are Angular signals? (search + cite sources)',
     value:
-      'Use the search tool to find authoritative information about Angular signals, then explain what they are and when to use them. Cite your sources inline using [1], [2] etc.',
+      'Use the search tool to find authoritative information about Angular signals, then explain what they are and when to use them. Cite each source inline as [^doc-id] using the document `id` field returned by the tool.',
   },
 ];
diff --git a/examples/chat/python/src/graph.py b/examples/chat/python/src/graph.py
index c2efcfae6..fe39a9acc 100644
--- a/examples/chat/python/src/graph.py
+++ b/examples/chat/python/src/graph.py
@@ -41,8 +41,13 @@
     "You are a helpful, concise assistant. "
     "Format responses with markdown when useful (headings, lists, code blocks, tables). "
     "When the user asks about specific Angular topics or technical questions, "
-    "use the `search_documents` tool to find authoritative information before answering, "
-    "and cite the sources inline using [1], [2], etc."
+    "use the `search_documents` tool to find authoritative information before answering. "
+    "Cite sources inline using Pandoc-style citation references with the "
+    "document `id` field as the refId, e.g. `[^ng-signals-overview]` or "
+    "`[^ng-control-flow]`. Each first-use of a document gets an auto-numbered "
+    "marker; subsequent references to the same document share the number. "
+    "Do not write `[1]` or `[1, 2]` — those are plain text and won't link to "
+    "the sources panel."
 )
 
 # Reasoning-capable model prefixes. We only attach the ``reasoning``