Skip to content

FEATURE : Deployment of Agent using Kagenti#108

Merged
shricharan-ks merged 1 commit into
red-hat-data-services:mainfrom
shricharan-ks:feature/RHAIENG-5034
May 21, 2026
Merged

FEATURE : Deployment of Agent using Kagenti#108
shricharan-ks merged 1 commit into
red-hat-data-services:mainfrom
shricharan-ks:feature/RHAIENG-5034

Conversation

@shricharan-ks
Copy link
Copy Markdown
Contributor

@shricharan-ks shricharan-ks commented May 20, 2026

Description

This feature setups the documentation and the claude skills for the deployment of an agent and using kagenti for agent visibility.

Jira Ticket

RHAIENG-5034

Testing

  • make test passes (run from the affected agent directory)
  • Manual testing performed (describe steps below)
  • No testing required (documentation/config change only)

Checklist

  • I have read CONTRIBUTING.md
  • No .env or secret files are included in this PR
  • All changes are within scope of the linked Jira ticket (if not, explain in Description)

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 20, 2026

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

This PR enables Kagenti-managed deployment of A2A agents by adding required Helm labels, introducing AgentRuntime resources that reference the deployments, tightening the a2a-sdk dependency range, and providing detailed integration documentation with an automated verification script and troubleshooting steps.

Changes

Kagenti Integration for Agent Deployment

Layer / File(s) Summary
Helm Deployment Labeling for Kagenti Discovery
charts/a2a-langgraph-crewai/templates/deployment-crew.yaml, charts/a2a-langgraph-crewai/templates/deployment-langgraph.yaml
Adds protocol.kagenti.io/a2a: "true" label to both LangGraph and Crew agent deployment templates to enable kagenti discovery.
AgentRuntime resources and packaging
agents/a2a/langgraph_crewai_agent/AgentRuntime.yaml, agents/a2a/langgraph_crewai_agent/README.md, agents/a2a/langgraph_crewai_agent/pyproject.toml
Adds two AgentRuntime resources (a2a-langgraph-agent-runtime, a2a-crew-agent-runtime) referencing their Deployments; README documents applying the manifest; tightens a2a-sdk[http-server] to >=0.3.25,<1.0.0.
Integration Documentation and Verification Guide
.claude/skills/kagenti-deploy/SKILL.md
New comprehensive skill doc covering prerequisites, A2A endpoint requirements, step-by-step Helm/Kubernetes deployment, label enforcement, namespace labeling, AgentRuntime creation, health and sync checks, verify-kagenti.sh verification script, troubleshooting, important notes, and a complete a2a-langgraph-crewai example.

🎯 3 (Moderate) | ⏱️ ~20 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly refers to a core change: enabling agent deployment with Kagenti integration for visibility. It directly relates to the primary focus of the PR (documentation, skill files, and configuration for Kagenti-based agent deployment).
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 The pull request description is related to the changeset, explaining the addition of documentation and Claude skills for agent deployment with Kagenti integration.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 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 `@agents/a2a/langgraph_crewai_agent/AgentRuntime.yaml`:
- Line 5: The AgentRuntime.yaml hardcodes namespace: default which can break
deployments when users deploy to a different namespace; update AgentRuntime.yaml
so the namespace is not hardcoded by either adding a clear comment above the
namespace field (# Update namespace to match your deployment namespace),
parameterizing it (e.g., support a template or Kustomize var for namespace), or
remove the field to rely on the current kubectl context; also add a short note
in README.md near the Kagenti/AgentRuntime section instructing users to set the
namespace to match their `make deploy` target (reference AgentRuntime.yaml, the
namespace field, and Kagenti/AgentCards in the docs).
🪄 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: Organization UI

Review profile: CHILL

Plan: Enterprise

Run ID: 3b10a16c-25b4-405b-b71c-a7ebee867760

📥 Commits

Reviewing files that changed from the base of the PR and between 7fb3ca4 and 1e66bd4.

📒 Files selected for processing (6)
  • .claude/skills/kagenti-deploy/SKILL.md
  • agents/a2a/langgraph_crewai_agent/AgentRuntime.yaml
  • agents/a2a/langgraph_crewai_agent/README.md
  • agents/a2a/langgraph_crewai_agent/pyproject.toml
  • charts/a2a-langgraph-crewai/templates/deployment-crew.yaml
  • charts/a2a-langgraph-crewai/templates/deployment-langgraph.yaml

Comment thread agents/a2a/langgraph_crewai_agent/AgentRuntime.yaml Outdated
Copy link
Copy Markdown
Contributor

@andrewdonheiser andrewdonheiser left a comment

Choose a reason for hiding this comment

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

PR Review Summary

Thanks for adding kagenti deployment support! The SKILL.md is comprehensive and the overall approach is solid. There are a few issues to address before this can merge — most notably a missing label that will prevent kagenti discovery from working.

Findings: 1 Critical, 5 Important, 6 Suggestions

See inline comments for details.

Strengths

  • Comprehensive end-to-end workflow with logical step progression
  • Good enforcement gate pattern (Claude stops and asks if labels are missing)
  • Correct multi-deployment AgentRuntime handling for langgraph + crew
  • Accurate AgentRuntime/AgentCard relationship documentation
  • Defensive a2a-sdk version pin aligns with repo patterns
  • Properly scoped — kagenti is optional, existing behavior unchanged

Comment thread charts/a2a-langgraph-crewai/templates/deployment-crew.yaml
Comment thread agents/a2a/langgraph_crewai_agent/AgentRuntime.yaml Outdated
Comment thread .claude/skills/kagenti-deploy/SKILL.md Outdated
Comment thread agents/a2a/langgraph_crewai_agent/AgentRuntime.yaml Outdated
Comment thread .claude/skills/kagenti-deploy/SKILL.md Outdated
Comment thread agents/a2a/langgraph_crewai_agent/README.md Outdated
Comment thread agents/a2a/langgraph_crewai_agent/README.md Outdated
Comment thread agents/a2a/langgraph_crewai_agent/pyproject.toml Outdated
Comment thread .claude/skills/kagenti-deploy/SKILL.md
Comment thread .claude/skills/kagenti-deploy/SKILL.md Outdated
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 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 `@agents/a2a/langgraph_crewai_agent/README.md`:
- Around line 210-225: The Kagenti README section has Markdown lint errors
(MD032/MD031) due to missing blank lines around lists and fenced code blocks;
fix it by adding a blank line before and after each fenced block and before the
bulleted lists under the "Prerequisites:", "Apply AgentRuntime:" and "Verify:"
headings so the code fences containing `oc apply -f AgentRuntime.yaml` and `oc
get agentcard -n <your-namespace>` are each separated by an empty line from
surrounding paragraphs/lists and the "Apply AgentRuntime:" ordered steps; ensure
the three headers ("Prerequisites:", "Apply AgentRuntime:", "Verify:") are
followed by proper blank lines so markdownlint passes.
🪄 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: Organization UI

Review profile: CHILL

Plan: Enterprise

Run ID: e44e0392-c471-4349-b5d2-5ba3a249e677

📥 Commits

Reviewing files that changed from the base of the PR and between 1e66bd4 and 1f4528e.

📒 Files selected for processing (4)
  • .claude/skills/kagenti-deploy/SKILL.md
  • agents/a2a/langgraph_crewai_agent/AgentRuntime.yaml
  • agents/a2a/langgraph_crewai_agent/README.md
  • agents/a2a/langgraph_crewai_agent/pyproject.toml
✅ Files skipped from review due to trivial changes (1)
  • .claude/skills/kagenti-deploy/SKILL.md

Comment thread agents/a2a/langgraph_crewai_agent/README.md
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
agents/a2a/langgraph_crewai_agent/README.md (1)

231-233: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Remove the extra blank line to unblock lint.

Line 232 has two consecutive blank lines, which triggers MD012 and keeps CI red.

Suggested patch
 AgentCards for both LangGraph and CrewAI will appear in Kagenti UI.
 
-
 #### Verify deployment

As per coding guidelines, "Focus on major issues impacting performance, readability, maintainability and security. Avoid nitpicks and avoid verbosity."

🤖 Prompt for 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.

In `@agents/a2a/langgraph_crewai_agent/README.md` around lines 231 - 233, Remove
the extra consecutive blank line after the "#### Verify deployment" heading to
satisfy MD012 linting; open the README section containing the "#### Verify
deployment" header and delete the redundant blank line so there is only a single
blank line (or none, as your style requires) directly following that heading.
🤖 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.

Outside diff comments:
In `@agents/a2a/langgraph_crewai_agent/README.md`:
- Around line 231-233: Remove the extra consecutive blank line after the "####
Verify deployment" heading to satisfy MD012 linting; open the README section
containing the "#### Verify deployment" header and delete the redundant blank
line so there is only a single blank line (or none, as your style requires)
directly following that heading.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Enterprise

Run ID: 0af5958a-9c61-4a02-b052-1980474c7bf9

📥 Commits

Reviewing files that changed from the base of the PR and between 1f4528e and 8f2ab55.

📒 Files selected for processing (1)
  • agents/a2a/langgraph_crewai_agent/README.md

Copy link
Copy Markdown
Contributor

@andrewdonheiser andrewdonheiser left a comment

Choose a reason for hiding this comment

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

Re-review: 7 of 12 items from the first review have been addressed — resolved those threads. One new issue found in the fix-up commit (see inline).

Comment thread agents/a2a/langgraph_crewai_agent/pyproject.toml Outdated
Copy link
Copy Markdown
Contributor

@andrewdonheiser andrewdonheiser left a comment

Choose a reason for hiding this comment

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

Re-review after fix-up commits

8 of 13 original findings have been addressed — nice work on the turnaround. 5 items remain (1 critical, 2 important, 2 suggestions). See inline comments.

Resolved

  • sed -i macOS portability — SKILL.md now uses inline cat <<EOF
  • Emojis in verification script — now uses [PASS]/[FAIL]/[WARN]
  • Heading level inconsistency — changed to ####
  • README lacking prerequisites/verification — added
  • template.env clarification — added to Step 2
  • make deploy NAMESPACE= — now uses oc project
  • Version specifier ordering — now >=0.3.25,<1.0.0
  • Trailing comma in version specifier — fixed

Comment thread charts/a2a-langgraph-crewai/templates/deployment-crew.yaml
Comment thread agents/a2a/langgraph_crewai_agent/AgentRuntime.yaml Outdated
Comment thread agents/a2a/langgraph_crewai_agent/AgentRuntime.yaml Outdated
Comment thread charts/a2a-langgraph-crewai/templates/deployment-langgraph.yaml
Comment thread .claude/skills/kagenti-deploy/SKILL.md
@shricharan-ks shricharan-ks force-pushed the feature/RHAIENG-5034 branch from f274c78 to 94dedde Compare May 21, 2026 07:55
Address PR comments

Fix markdown MD032/MD031 linting issues

Fix markdown MD032/MD031 linting issues

Fix version in pyproject.toml

Fix version in pyproject.toml

Fix PR Comments

removed trailing whitespace
@shricharan-ks shricharan-ks force-pushed the feature/RHAIENG-5034 branch from 94dedde to 92442bf Compare May 21, 2026 08:00
Copy link
Copy Markdown
Contributor

@andrewdonheiser andrewdonheiser left a comment

Choose a reason for hiding this comment

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

All findings from both review rounds have been addressed. Nice work on the turnaround.

Verified resolved:

  • Version specifier fixed (trailing comma removed)
  • namespace field removed from AgentRuntime.yaml (uses oc context)
  • SKILL.md correctly documents controller-managed vs chart-managed labels
  • Verification script extracted, complete flow removed
  • All other items (sed portability, emojis, heading levels, README prerequisites, etc.)

CI is green. LGTM.

@shricharan-ks
Copy link
Copy Markdown
Contributor Author

All findings from both review rounds have been addressed. Nice work on the turnaround.

Verified resolved:

  • Version specifier fixed (trailing comma removed)
  • namespace field removed from AgentRuntime.yaml (uses oc context)
  • SKILL.md correctly documents controller-managed vs chart-managed labels
  • Verification script extracted, complete flow removed
  • All other items (sed portability, emojis, heading levels, README prerequisites, etc.)

CI is green. LGTM.

Thanks @andrewdonheiser your comments helped in maintaining the quality standards. Much appreciated 🎉

@shricharan-ks shricharan-ks merged commit 2c9d80c into red-hat-data-services:main May 21, 2026
4 checks passed
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