Knowledge Graph chat tools

Knowledge Graph chat tools help you investigate what the graph currently shows and ask higher-level questions about how your application works. Use this page for the chat, search, and debugging tools that live inside Knowledge Graph. For the full workspace, graph exploration, concept browsing, and discovery controls, see /docs/reference/knowledge-graph.

01When to use Knowledge Graph chat tools

Use the right rail tools when you want faster answers than manual graph inspection alone. They are most useful when you need help interpreting graph context, finding the right feature or workflow, identifying gaps, or understanding what the application is doing at a broader level.

Common use cases include:

• Search for a feature, field, page, or workflow before you inspect it on the canvas
• Investigate why a node, edge, or workflow state looks unexpected in the graph
• Ask for help interpreting relationships, state changes, or unusual graph structure
• Understand how a part of your application behaves without manually tracing every related item
• Get quicker direction before refining your search or continuing deeper analysis in Knowledge Graph

02Available tools

This workspace layout is available behind the application-knowledge-graph feature flag.

Use the main Knowledge Graph workspace for graph exploration, concept browsing, and discovery controls. Use the dedicated right rail for Chat and Search when you want help finding or interpreting what you see there. For the broader workspace and navigation, see /docs/reference/knowledge-graph.

Knowledge Graph includes dedicated tools for search, setup guidance, explanation, and graph investigation. Each tool is designed for a different stage of your work.

Tool	Best for	What you can do
Search	Finding graph items quickly	Search for features, fields, pages, and workflows, then jump to the matching area in the graph
Guided setup chat	Anchoring the graph before exploration	Answer setup questions so Canary can build the initial app map and scope the workspace before deeper investigation
Graph Debugger	Investigating graph state	Ask why the graph shows a specific relationship, state, missing connection, or unexpected result
Application Expert	Understanding application behavior	Ask how a feature works, how product areas connect, what users can do there, and what related workflows or pages to review next

The right rail includes a dedicated Search tab alongside Chat tools.

Use these tools together:

• Start in Guided setup chat when you first open a new Knowledge Graph and need to anchor the workspace with a few setup answers
• Use Search to find a feature, field, or workflow without leaving the workspace
• Switch to Graph Debugger when you need to understand why the current graph state looks wrong or incomplete
• Use Application Expert when you need a broader explanation of how part of the application works after setup is complete

Graph Debugger

Use Graph Debugger when you want to inspect what the Knowledge Graph currently reflects. This tool helps you reason about graph state, spot inconsistencies, and ask follow-up questions tied to what you are seeing.

Start in the main Knowledge Graph workspace to explore the canvas, review discovered concepts, and inspect the graph area you care about. If you are still answering setup questions, finish that guided anchoring flow first so the graph has the context you need. Use Search if you need to find the relevant feature, field, or workflow. Then use Graph Debugger to understand why the graph looks the way it does before you continue investigating. For workspace details, see /docs/reference/knowledge-graph.

Ask Graph Debugger questions such as:

• Why does this node connect to this workflow?
• What changed around this part of the graph?
• Why is this relationship missing or unexpected?
• What nearby context should I inspect next?
• Which unanswered questions or open areas should I investigate from this graph state?

Start with a specific question and reference the graph area you are reviewing. Narrow, graph-focused prompts usually return the most actionable answers.

Application Expert

Use Application Expert when you want a broader, product-focused explanation of how your application works. This tool is useful when you need help discovering features, understanding how user-facing areas relate, or getting a clear summary of what a workflow or page is for without digging through raw graph details.

Start in the main Knowledge Graph workspace to review the relevant graph area or discovered concepts. Use Search first if you need to locate the right feature area, field, or workflow. Then ask Application Expert to explain how a feature works, what users can do there, how related pages and workflows connect, or what to validate next. For workspace details, see /docs/reference/knowledge-graph.

03Asking expert questions

Use Application Expert after guided setup finishes and the workspace hands you off into expert-question mode. In setup or anchoring mode, focus on answering the questions Canary asks so it can build the app map. In expert-question mode, ask broader product and behavior questions based on the graph context that setup created.

Use Application Expert for questions such as:

• What does this feature area help users do?
• How do these pages, actions, or workflows fit together in the product?
• Which related features should I review next from this part of the graph?
• What user flow is most likely connected to these graph elements?
• How should I explain this area of the application to a teammate?

Expect answers that summarize features and relationships in product terms. Application Expert uses the graph context you have open, including the richer application understanding available from expanded graph analysis, to make feature discovery and explanations more useful.

Use Application Expert when your goal is understanding, not just debugging graph state. After you get an answer, return to Knowledge Graph to inspect the related nodes and relationships in more detail, run a search from the right rail, or continue your investigation.

04How chat tools use graph context

Both tools use the context available in the Knowledge Graph experience. Your current graph view helps shape the answers you receive, so the quality of the result depends on how clearly scoped your graph investigation is.

To get better answers:

1. Open the relevant area in Knowledge Graph before asking a question.
2. Use Search if you need to narrow the canvas to the right feature, field, page, or workflow.
3. Focus your prompt on the node, relationship, feature area, or behavior you want to understand.
4. Ask one question at a time when you are troubleshooting a specific issue.
5. Refine your question after each answer to go deeper into the same part of the graph.

If the graph view is too broad, first narrow your investigation with Search and then ask the tool again. Specific graph context usually produces more useful responses than a general prompt.

05Troubleshooting and limitations

If a tool response is too general or does not match what you expect, tighten the scope of your question and verify that you are looking at the right graph area.

Keep these limitations in mind:

• Answers depend on the graph context currently available in the Knowledge Graph experience
• Broad or ambiguous prompts can lead to less useful responses
• Chat tools help interpret and explore the graph, but they do not replace direct inspection of nodes, edges, and related workflows
• Some questions may require you to continue investigating manually in Knowledge Graph before you can confirm the answer

For best results:

• Use Search to find features, fields, and workflows quickly
• Use Graph Debugger for state and relationship questions
• Use Application Expert for product-focused feature discovery, workflow explanations, and connected area summaries
• Ask about what users can do, how features relate, and what to review next when you want a more presentation-friendly answer
• Follow up with narrower prompts instead of repeating the same broad question
• Confirm important findings by reviewing the relevant graph elements directly

06Related

• /docs/reference/knowledge-graph
• /docs/reference/application-context
• /docs/reference/workflows
• /docs/reference/runs

Use the Search tab in the right rail to find features, fields, and workflows at any point in the workspace. Use Chat for guided setup first, then switch into expert questions or Graph Debugger once the graph is anchored and ready for deeper exploration.