Reference

You never call these directly — you talk in plain language and Talk2Graph chooses the right action. This page documents what those actions are, the query language underneath, and the settings that govern them, so you understand what's happening and can phrase requests precisely.

 

Capabilities

Talk2Graph exposes the following capabilities to the assistant. Every one operates on the graph session you have open.

Describe the session

Returns the graph's schema and metadata — node and edge counts, column names, active encodings and filters, title. Optionally includes a few sample rows.

Triggered by: What's in this graph?, What columns are available?

Query the graph

Runs a GFQL or Cypher query to filter, traverse, count, or list nodes and edges. Can return nodes, edges, both, or just counts. Tabular results appear inline in the chat as a scrollable table (up to 100 rows).

Triggered by: Show me all Author nodes, How many nodes have degree > 10?, Top 10 by pagerank

Create a collection (color a subset)

Colors the nodes (or edges) matching a filter. Takes a color as either an exact hex code or a named palette, plus a name and one-line description. See Collections for the full picture and the palette list.

Triggered by: Color the fraud accounts red, Highlight the most influential nodes

Manage collections

List all collections (with their names, colors, and stacking order); reorder them (which renders on top); rename or recolor one; or delete one. The built-in global background layer can't be deleted.

Triggered by: What collections are on the graph?, Bring the red set to the front, Rename that to Key Accounts and make it blue, Delete the pagerank collection

Reset collections

Clears all collections at once, returning to the default view.

Triggered by: Reset the colors, Clear everything

Summarize communities

Runs community detection (Louvain) and returns a read-only text report of the largest clusters — each cluster's size and its distinguishing traits (attribute values that are over-represented, shown as value: X% in cluster vs Y% overall), plus a headline. It does not color the graph; to visualize a cluster, follow up and ask to color it. You can optionally name which columns to break the communities down by.

Triggered by: Summarize the top communities, What distinguishes the clusters?, Break the communities down by region

List sessions

Lists your own open visualization sessions.

Triggered by: What sessions do I have open?

 

GFQL: the query language underneath

When you ask for something, Louie translates it into GFQL (Graph Frame Query Language) — Graphistry's declarative graph query language — or an equivalent read-only Cypher query. You never have to write it, and when the assistant references the query, it's highlighted as inline code so you can see what ran and refine it. See the full GFQL documentation for the language itself.

A GFQL query is a chain of operations applied left to right:

  • Node steps — match nodes by attribute (e.g. status = "active", amount > 1000). An empty match means "all nodes."
  • Edge steps — traverse connections, in a direction (forward / reverse / undirected) for one or many hops.
  • Call steps — run graph algorithms (PageRank, betweenness, authority score, community detection) or table pipelines (group-by, order-by, limit).

Filters support the usual predicates: comparisons (> < = ≠), ranges (between), set membership (is in), string tests (contains, starts with, ends with, regex match), and null checks. A read-only subset of Cypher (MATCH / WHERE / RETURN / WITH / ORDER BY / LIMIT / CALL) is also accepted — but never write operations (CREATE / MERGE / DELETE / SET).

For example, "color the top influencers" becomes a chain that runs PageRank and colors the top slice:

[
  { "type": "Node" },
  { "type": "Call", "function": "compute_igraph",
    "params": { "alg": "pagerank" } }
]

… and the assistant colors the top ~20% by score.

 

Limits

The current boundaries, so you know what to expect.

LimitValue
Collections per session10 (oldest dropped past the cap)
Query row limit50 rows (20 unprojected)
Inline result table100 rows
Uploaded skill size20,000 characters
Tool timeout60 seconds