Skip to content

docs(codelab): add BigQuery Studio graph visualization to the query step#276

Merged
haiyuan-eng-google merged 1 commit into
GoogleCloudPlatform:mainfrom
caohy1988:codelab/graph-visualization
Jun 2, 2026
Merged

docs(codelab): add BigQuery Studio graph visualization to the query step#276
haiyuan-eng-google merged 1 commit into
GoogleCloudPlatform:mainfrom
caohy1988:codelab/graph-visualization

Conversation

@caohy1988
Copy link
Copy Markdown
Collaborator

Summary

Adds a graph-visualization screenshot to the periodic-materialization codelab's Query the decision trace step. The codelab previously had no graph-viz image — only the Conversational Analytics card — even though the companion blog shows this same screenshot in its access step.

A new #### Visualize the graph in BigQuery Studio subsection explains how to open agent_decisions_graph in BigQuery Studio, run a GQL path query, and switch the results pane to the Graph tab, followed by the screenshot.

Context: this is the graph-visualization addition that was intended for #274 but landed after that PR had already merged, so it's split out here as a clean follow-up off current main.

Details

  • New image: docs/codelabs/images/graph-visualization.png.
  • The example query is dataset-qualified (GRAPH ${DATASET}.agent_decisions_graph …) to match the codelab's other GQL, rather than an unqualified copy/paste.
  • The caption/alt text does not hard-code node/edge counts, so it can't drift from the captured screenshot.

Verification

  • generate_colab_from_codelab.py --check passes (notebook regenerated, no drift).
  • Notebook now embeds 3 base64 images, 0 relative image refs, 0 curl, 0 leaked Duration: / aside markers.
  • claat export builds clean (exit 0); 3 images copied into img/.
  • pytest tests/test_generate_colab_asides.py tests/test_generate_colab_images.py tests/test_codelab_embedded_artifacts.py → 12 passed.
  • git diff --check clean.

Adds a 'Visualize the graph in BigQuery Studio' subsection to *Query the
decision trace*, showing the materialized agent_decisions_graph rendered in
BigQuery Studio's Graph view from a GQL path query. The codelab previously
had no graph-viz image (the same screenshot the blog uses in its access step).

The example query is dataset-qualified (GRAPH ${DATASET}.agent_decisions_graph)
to match the codelab's other GQL, and the caption avoids hard-coding node/edge
counts so it does not drift from the screenshot.

Notebook regenerated (now embeds 3 base64 images); --check passes; claat
export builds clean with 3 images copied; focused tests pass (12).
@haiyuan-eng-google haiyuan-eng-google merged commit 2da0748 into GoogleCloudPlatform:main Jun 2, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants