Skip to content

Docs/agentcube website#405

Open
vanshika2720 wants to merge 3 commits into
volcano-sh:mainfrom
vanshika2720:docs/agentcube-website
Open

Docs/agentcube website#405
vanshika2720 wants to merge 3 commits into
volcano-sh:mainfrom
vanshika2720:docs/agentcube-website

Conversation

@vanshika2720

@vanshika2720 vanshika2720 commented Jun 25, 2026

Copy link
Copy Markdown

What type of PR is this?

/kind documentation

What this PR does / why we need it:

This PR expands the AgentCube documentation to better support developers and contributors who want to understand, extend, and maintain the project.

The changes add comprehensive technical documentation covering:

  • System architecture and core component interactions
  • Design decisions and internal project structure
  • MCP integration architecture and workflow documentation
  • API and SDK usage guides with practical examples
  • Deployment architecture and infrastructure setup instructions
  • Developer guides for implementing new features and integrations
  • Component-level documentation and sequence diagrams
  • Troubleshooting, debugging, and contributor-focused guidance

These additions improve contributor onboarding, reduce the learning curve for understanding the codebase, and provide a centralized reference for project internals and development workflows.

Which issue(s) this PR fixes:

Fixes #404

Special notes for your reviewer:

  • Documentation-only change.
  • No application logic, APIs, or runtime behavior were modified.
  • The documentation is intended to improve contributor experience and project maintainability.

Does this PR introduce a user-facing change?:

Added comprehensive technical documentation for developers and contributors, including architecture overviews, MCP integration workflows, deployment guidance, API/SDK references, extension guides, and troubleshooting documentation.

Copilot AI review requested due to automatic review settings June 25, 2026 09:04
@vanshika2720 vanshika2720 force-pushed the docs/agentcube-website branch from dda1b9c to 894e9bf Compare June 25, 2026 09:08

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request introduces comprehensive documentation for AgentCube and adds Prometheus metrics instrumentation to the PicoD sandbox daemon to track execution and HTTP request statistics. A review of the changes identified a broken link to a non-existent local development guide in the FAQ documentation.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread docs/agentcube/docs/faq.md

Copilot AI 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.

Pull request overview

This PR expands the AgentCube Docusaurus website with substantially more developer/operator-focused documentation (getting started, configuration, API reference, developer guide pages, troubleshooting, FAQ, and feature overview). It also adds Prometheus metrics instrumentation to PicoD (including a new /metrics endpoint) and updates Go module dependencies accordingly.

Changes:

  • Add and reorganize AgentCube website docs: getting started flow, configuration reference, API reference, troubleshooting, features, FAQ, and contributor guidance.
  • Instrument PicoD with Prometheus collectors and a /metrics endpoint; track HTTP request counts/latency and execution outcomes.
  • Update go.mod to include github.com/prometheus/client_golang.

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 12 comments.

Show a summary per file
File Description
pkg/picod/server.go Adds metrics middleware and exposes /metrics; updates gzip exclusions.
pkg/picod/metrics.go Introduces Prometheus registry + Gin middleware/handler for metrics.
pkg/picod/metrics_test.go Adds unit/integration-style tests validating metrics exposition and recording.
pkg/picod/execute.go Tracks active executions and execution outcomes via new metrics; refactors working dir prep.
go.mod Adds Prometheus client dependency as a direct requirement.
docs/agentcube/docs/getting-started.md Expands install/quickstart steps and Helm configuration examples.
docs/agentcube/docs/configuration.md Adds Helm/CRD configuration reference documentation.
docs/agentcube/docs/api-reference.md Adds Router/Workload Manager/PicoD API reference and SDK reference.
docs/agentcube/docs/troubleshooting.md Adds troubleshooting guide and diagnostic commands.
docs/agentcube/docs/features.md Adds feature overview (warm pools, lifecycle, auth, HA, etc.).
docs/agentcube/docs/faq.md Adds FAQ for users/developers.
docs/agentcube/docs/developer-guide/intro.md Adds sidebar metadata and expands developer guide index.
docs/agentcube/docs/developer-guide/contributing.md Adds contributor workflow and standards documentation.
docs/agentcube/docs/developer-guide/code-interpreter-using-langchain.md Adds LangChain/LangGraph integration guide.
docs/agentcube/docs/developer-guide/code-interpreter-python-sdk.md Adds Python SDK usage guide and examples.

Comment thread pkg/picod/server.go Outdated
Comment thread docs/agentcube/docs/getting-started.md
Comment thread docs/agentcube/docs/api-reference.md Outdated
Comment thread docs/agentcube/docs/api-reference.md
Comment thread docs/agentcube/docs/api-reference.md Outdated
Comment thread docs/agentcube/docs/developer-guide/code-interpreter-using-langchain.md Outdated
Comment thread docs/agentcube/docs/troubleshooting.md Outdated
Comment thread docs/agentcube/docs/api-reference.md Outdated
Comment thread docs/agentcube/docs/api-reference.md Outdated
Comment thread pkg/picod/server.go
@codecov-commenter

codecov-commenter commented Jun 25, 2026

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 58.57%. Comparing base (524e55e) to head (258bc79).
⚠️ Report is 146 commits behind head on main.
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files
@@             Coverage Diff             @@
##             main     #405       +/-   ##
===========================================
+ Coverage   47.57%   58.57%   +11.00%     
===========================================
  Files          30       37        +7     
  Lines        2819     3491      +672     
===========================================
+ Hits         1341     2045      +704     
+ Misses       1338     1237      -101     
- Partials      140      209       +69     
Flag Coverage Δ
unittests 58.57% <ø> (+11.00%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Signed-off-by: Vanshika <pahalvanshikaa@gmail.com>
Copilot AI review requested due to automatic review settings June 25, 2026 09:23
@vanshika2720 vanshika2720 force-pushed the docs/agentcube-website branch from 894e9bf to c5a941c Compare June 25, 2026 09:23
@volcano-sh-bot

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign kevin-wangzefeng for approval. For more information see the Kubernetes Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

- update SDK and LangChain guides to Python 3.10+ (actual SDK requirement)
- remove invalid --set redis.password flag from Helm install example
- clarify Redis auth: omit flag for passwordless dev, use secretName for prod
- verify local-development.md link is valid (file exists)

Signed-off-by: Vanshika <pahalvanshikaa@gmail.com>

Copilot AI 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.

Pull request overview

Copilot reviewed 10 out of 10 changed files in this pull request and generated 20 comments.

Comment thread docs/agentcube/docs/getting-started.md
Comment thread docs/agentcube/docs/troubleshooting.md
Comment thread docs/agentcube/docs/features.md Outdated
Comment thread docs/agentcube/docs/features.md Outdated
Comment thread docs/agentcube/docs/faq.md Outdated
Comment thread docs/agentcube/docs/api-reference.md Outdated
Comment thread docs/agentcube/docs/api-reference.md Outdated
Comment thread docs/agentcube/docs/troubleshooting.md
Comment thread docs/agentcube/docs/troubleshooting.md
Comment thread docs/agentcube/docs/developer-guide/code-interpreter-python-sdk.md Outdated
- fix sessionTimeout in features.md to use 15m default, not hardcoded 5m
- align lifecycle diagram labels to use CRD field names
- remove AI-sounding boilerplate from page intros
- run prettier on all modified doc files

Signed-off-by: Vanshika <pahalvanshikaa@gmail.com>
Copilot AI review requested due to automatic review settings June 25, 2026 09:42

Copilot AI 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.

Pull request overview

Copilot reviewed 10 out of 10 changed files in this pull request and generated 17 comments.

Comment thread docs/agentcube/docs/features.md
Comment thread docs/agentcube/docs/api-reference.md
Comment thread docs/agentcube/docs/troubleshooting.md
Comment thread docs/agentcube/docs/troubleshooting.md
Comment thread docs/agentcube/docs/faq.md
Comment thread docs/agentcube/docs/troubleshooting.md
Comment thread docs/agentcube/docs/api-reference.md
Comment thread docs/agentcube/docs/api-reference.md
Comment thread docs/agentcube/docs/api-reference.md

---

## Full Example: Math Agent Service (FastAPI)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

can this example really work? We already got an example for langchain

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add More Technical Documentation for Developers and Contributors

5 participants