Skip to content

Autograph Naming updates - #1075

Open
nicos-arango wants to merge 2 commits into
web-interfacefrom
naming-updates
Open

Autograph Naming updates#1075
nicos-arango wants to merge 2 commits into
web-interfacefrom
naming-updates

Conversation

@nicos-arango

@nicos-arango nicos-arango commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Description

New PR with naming updates across the docs.

Upstream PRs

  • 3.10:
  • 3.11:
  • 3.12:
  • 4.x:

Summary by CodeRabbit

  • Documentation
    • Reorganized guides to establish AutoGraph Studio as the primary web interface for Context Graph creation and management.
    • Updated navigation paths and standardized terminology (Context Graph, Corpus Graph, Knowledge Graph) across all documentation.
    • Deprecated standalone GraphRAG web interface; users now directed to Importer and Retriever APIs or AutoGraph Studio.
    • Added automatic redirect for legacy GraphRAG documentation links.

@arangodb-docs-automation

Copy link
Copy Markdown
Contributor

Deploy Preview Available Via
https://deploy-preview-1075--docs-hugo.netlify.app

@cla-bot cla-bot Bot added the cla-signed label Jul 31, 2026
@coderabbitai

coderabbitai Bot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

The documentation defines AutoGraph as creating a Context Graph and AutoRAG as deploying retrievers over it. AutoGraph Studio now documents the complete build and retrieval workflow. GraphRAG web-interface content is replaced or redirected to AutoGraph Studio and API-based workflows.

Changes

AutoGraph terminology and architecture

Layer / File(s) Summary
Context Graph terminology and architecture
site/content/_index.md, site/content/agentic-ai-suite/_index.md, site/content/agentic-ai-suite/autograph/*, site/content/agentic-ai-suite/importer/architecture.md, site/content/contextual-data-platform/architecture.md
The documentation defines the Context Graph as the combined Corpus Graph and Knowledge Graph. It standardizes graph names and relationship field descriptions.
AutoGraph Studio build and retrieval workflow
site/content/agentic-ai-suite/autograph/setup.md, site/content/agentic-ai-suite/autograph/web-interface.md, site/content/agentic-ai-suite/autograph/quick-start.md, site/content/agentic-ai-suite/autograph/reference/*, site/content/agentic-ai-suite/importer/setup.md
The guide documents categorized uploads, provider configuration, graph building, graph management, Knowledge Graph strategy generation, and AutoRAG retriever deployment.
GraphRAG workflow and link migration
site/content/agentic-ai-suite/graphrag/*, site/content/agentic-ai-suite/importer/*, site/content/agentic-ai-suite/retriever/*, site/content/contextual-data-platform/release-notes.md
Standalone GraphRAG workflows now use Importer and Retriever APIs. No-code workflows use AutoGraph Studio. Related links now target AutoGraph documentation.
Suite navigation and legacy redirect
site/content/agentic-ai-suite/graphml/*, site/static/_redirects
GraphML navigation uses the updated Agentic AI Suite paths. The former GraphRAG web-interface path redirects to AutoGraph Studio.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant AutoGraph Studio
  participant AutoGraph
  participant AutoRAG
  User->>AutoGraph Studio: Upload documents and configure providers
  AutoGraph Studio->>AutoGraph: Build Corpus Graph
  AutoGraph-->>AutoGraph Studio: Provide Context Graph
  AutoGraph Studio->>AutoRAG: Deploy retriever
  AutoRAG-->>User: Provide search and chat options
Loading

Possibly related PRs

Suggested reviewers: simran-b, nerpaula

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly describes the documentation changes, which update AutoGraph and related naming across the project.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch naming-updates

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 7

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@site/content/_index.md`:
- Around line 138-141: Update the Context Graph description to refer to the
simpler option as “lighter processing” or its actual strategy name, such as
“vector_rag,” instead of “a lighter partition,” while preserving the contrast
with full entity extraction.

In `@site/content/agentic-ai-suite/autograph/architecture.md`:
- Around line 16-20: Update the AutoGraph architecture description to identify
the cross-graph join as the shared-property match between rags.rag_partition_id
and Documents.partition_id. Explicitly state that this is not a stored edge or
AQL traversal relationship, replacing the ambiguous “partition_id link” wording
in the Context Graph explanation.

In `@site/content/agentic-ai-suite/autograph/web-interface.md`:
- Line 152: Update the sentence near the Context Graph description to state that
the Context Graph consists only of the Corpus Graph and Knowledge Graph,
excluding credentials and retriever services listed above.
- Around line 116-119: Update the “Start build” workflow description so it
documents a single consistent sequence: starting the build deploys the AutoGraph
service, then the user waits for deployment and clicks “Build Corpus Graph” to
create the Corpus Graph. Remove or revise the claim that Start build itself
builds the Corpus Graph.
- Around line 188-200: Revise the “Generate strategies and build the Knowledge
Graph” section to separate strategy generation from Knowledge Graph
orchestration: describe Generate strategies as creating strategy profiles via
the RAG Strategizer, then add instructions to initiate orchestration through the
orchestration action so Importer workers build the graph. Document the resulting
Knowledge Graph completion state and keep the guidance about unbuilt Corpus
Graph changes aligned with the strategy-generation step.

In `@site/content/agentic-ai-suite/importer/setup.md`:
- Line 15: Standardize the UI label to “AutoGraph Studio” in the links at
site/content/agentic-ai-suite/importer/setup.md:15-15,
site/content/agentic-ai-suite/importer/_index.md:25-25, and
site/content/agentic-ai-suite/importer/autograph-integration.md:18-18, replacing
“AutoGraph web interface” in each location.

In `@site/content/agentic-ai-suite/retriever/_index.md`:
- Line 26: Update the AutoGraph web interface link in the Importer-based
standalone graph section so it points only to a standalone-compatible workflow;
otherwise separate the standalone and AutoGraph project workflows, keeping the
project-specific Studio guidance out of the standalone user path.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: e2c38b6f-598b-4de8-afcc-3f2fe8e4c7ad

📥 Commits

Reviewing files that changed from the base of the PR and between 1a777af and 5f2079b.

⛔ Files ignored due to path filters (1)
  • site/content/images/Agentic-AI-Suite-Overview.svg is excluded by !**/*.svg
📒 Files selected for processing (27)
  • site/content/_index.md
  • site/content/agentic-ai-suite/_index.md
  • site/content/agentic-ai-suite/autograph/architecture.md
  • site/content/agentic-ai-suite/autograph/design-guide.md
  • site/content/agentic-ai-suite/autograph/quick-start.md
  • site/content/agentic-ai-suite/autograph/reference/error-handling.md
  • site/content/agentic-ai-suite/autograph/reference/importing-files.md
  • site/content/agentic-ai-suite/autograph/setup.md
  • site/content/agentic-ai-suite/autograph/web-interface.md
  • site/content/agentic-ai-suite/graphml/quick-start.md
  • site/content/agentic-ai-suite/graphml/ui.md
  • site/content/agentic-ai-suite/graphrag/_index.md
  • site/content/agentic-ai-suite/graphrag/quick-start.md
  • site/content/agentic-ai-suite/graphrag/technical-overview.md
  • site/content/agentic-ai-suite/graphrag/web-interface.md
  • site/content/agentic-ai-suite/importer/_index.md
  • site/content/agentic-ai-suite/importer/architecture.md
  • site/content/agentic-ai-suite/importer/autograph-integration.md
  • site/content/agentic-ai-suite/importer/llm-configuration.md
  • site/content/agentic-ai-suite/importer/setup.md
  • site/content/agentic-ai-suite/retriever/_index.md
  • site/content/agentic-ai-suite/retriever/llm-configuration.md
  • site/content/agentic-ai-suite/retriever/search-methods/deep-search.md
  • site/content/agentic-ai-suite/retriever/search-methods/unified-search.md
  • site/content/contextual-data-platform/architecture.md
  • site/content/contextual-data-platform/release-notes.md
  • site/static/_redirects
💤 Files with no reviewable changes (1)
  • site/content/agentic-ai-suite/graphrag/web-interface.md

Comment thread site/content/_index.md
Comment thread site/content/agentic-ai-suite/autograph/architecture.md Outdated
Comment thread site/content/agentic-ai-suite/autograph/web-interface.md Outdated
Comment thread site/content/agentic-ai-suite/autograph/web-interface.md Outdated
Comment thread site/content/agentic-ai-suite/autograph/web-interface.md
Comment thread site/content/agentic-ai-suite/importer/setup.md Outdated
Comment thread site/content/agentic-ai-suite/retriever/_index.md Outdated
@nerpaula nerpaula changed the title Naming updates Autograph Naming updates Aug 3, 2026
@nerpaula nerpaula added this to the platform 4.1.0 milestone Aug 4, 2026
@nerpaula
nerpaula changed the base branch from main to web-interface August 4, 2026 12:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants