Skillget

joule-a2a-agent-toolkit

agent
Security Audit
Fail
Health Pass
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 10 GitHub stars
Code Fail
  • eval() — Dynamic code execution via eval() in skills/joule-a2a-agent/scripts/create-destination.sh
  • process.env — Environment variable access in skills/joule-a2a-agent/scripts/scaffold-ts.sh
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Build, deploy, and connect AI agents to SAP Joule via the A2A protocol on BTP Cloud Foundry — directly from Claude Code. Supports TypeScript (Express or CAP) and Python agents with LangGraph and SAP GenAI Hub.

README.md

REUSE status

SAP A2A Agent Toolkit Plugin

Build, deploy, and connect AI agents to SAP Joule via the A2A (Agent-to-Agent) protocol on BTP Cloud Foundry — all from Claude Code.

What's Included

Skills (auto-triggered by context)

Skill Triggers On What It Does
joule-a2a-agent "build an agent for Joule", "create A2A agent", "deploy agent to BTP", "CAP agent" Scaffolds a complete LangGraph agent with A2A support (Express or CAP), CF manifest/MTA, and Joule capability YAML
btp-cli "btp", "BTP CLI", subaccount management, entitlements Generates correct btp commands for managing BTP global accounts, subaccounts, services, and security
cf-cli "cf push", "Cloud Foundry", app deployment, service binding Generates correct cf commands for deploying apps, managing services, routes, and spaces
joule-cli "joule deploy", "joule compile", capability deployment Generates correct Joule CLI commands for compiling and deploying digital assistant capabilities

Commands (user-invoked)

Command Usage What It Does
/sap-a2a-agent-toolkit:create-agent /sap-a2a-agent-toolkit:create-agent po-assistant --lang typescript --framework cap --landscape eu10 Scaffolds a new agent project in your working directory
/sap-a2a-agent-toolkit:create-destination /sap-a2a-agent-toolkit:create-destination po-assistant POAssistant_A2A eu10 Creates a BTP HTTP destination connecting Joule to your CF agent
/sap-a2a-agent-toolkit:deploy-agent /sap-a2a-agent-toolkit:deploy-agent ./po-assistant Full deployment: CF push/MTA deploy + destination + Joule capability in one command

Prerequisites

  • cf CLI v8 installed and logged in (cf login )
  • Joule CLI installed (npm install -g @sap/joule-studio-cli) and logged in (joule login)
    • Joule App2App IAS flow must be configured for Joule Studio CLI (assign roles)
  • BTP subaccount with Cloud Foundry runtime, AI Core service, and Destination service
  • Node.js v24.x (for TypeScript agents and Joule CLI)
  • Python 3.12+ (for Python agents only)
  • mbt (MTA Build Tool, for CAP agents only): npm install -g mbt
  • MTA CF CLI Plugin (for CAP agents only): cf install-plugin multiapps — required for cf deploy to work with .mtar files

Getting Started

Start Claude Code with the toolkit plugin, then log in to CF and Joule:

# 1. Start Claude Code with the plugin
claude --plugin-dir <path-to-sap-a2a-agent-toolkit>

# 2. Log in to Cloud Foundry
cf login -a https://api.cf.<landscape>.hana.ondemand.com 

# 3. Log in to Joule
joule login

Quick Start

# 1. Scaffold an agent (TypeScript + Express, default)
/sap-a2a-agent-toolkit:create-agent po-assistant

# 1b. TypeScript + CAP (enterprise, MTA deploy)
/sap-a2a-agent-toolkit:create-agent po-assistant --framework cap

# 1c. Python agent
/sap-a2a-agent-toolkit:create-agent po-assistant --lang python

# 2. Customize tools, then deploy everything
/sap-a2a-agent-toolkit:deploy-agent ./po-assistant

create-agent Arguments

Argument Values Default Description
<agent-name> any kebab-case name (required) Name of the agent project folder
--lang typescript, python typescript Programming language
--framework express, cap express Server framework (CAP is TypeScript-only)
--landscape eu10, us10, ap10, … eu10 SAP BTP CF landscape
--namespace any string joule.ext Capability namespace — must be joule.ext for Joule deployment

Or just describe what you want:

"Build me a Joule A2A agent in TypeScript using CAP that checks purchase order status from S/4HANA, deploy it to eu10"

Claude will use the skills automatically.

Architecture

User prompt in Joule
        |
        v
+----------------+     A2A (JSON-RPC 2.0)     +----------------------+
|  SAP Joule     | --------------------------> |  Your Agent          |
|  (BTP)         | <-------------------------- |  (Cloud Foundry)     |
+-------+--------+     Protocol v0.3.0         +---------+------------+
        |                                                |
  capability.sapdas.yaml                     LangGraph + Tools
  functions/call_agent.yaml                  SAP GenAI Hub (AI Core)
  BTP Destination                            OrchestrationClient

Framework Options

Express TS (default) CAP TS Python + Express
Server Express + A2AExpressApp CAP + cds.on("bootstrap") Starlette + A2AStarletteApplication
Deploy cf push (manifest.yml) mbt build + cf deploy (mta.yaml) cf push (manifest.yml)
Auth Manual XSUAA setup Built-in CAP auth Manual XSUAA setup
Services Manual bindings CDS service definitions Manual bindings
Best for Lightweight agents, quick prototyping Enterprise agents, complex service bindings Teams preferring Python

Supported Stack

  • Framework: LangGraph (Python) / LangGraph.js (TypeScript) on Express or CAP
  • LLM: SAP GenAI Hub via @sap-ai-sdk/langchain OrchestrationClient
  • Protocol: A2A v0.3.0 — JSON-RPC 2.0 over HTTPS (@a2a-js/sdk 0.3.10)
  • Deployment: SAP BTP Cloud Foundry (manifest.yml or MTA)
  • Languages: TypeScript (default), Python
  • Node.js: 24.x

Known Issues

How to obtain support

Create an issue in this repository if you find a bug or have questions about the content.

For additional support, ask a question in SAP Community.

Contributing

If you wish to contribute code, offer fixes or improvements, please send a pull request. Due to legal reasons, contributors will be asked to accept a DCO when they create the first pull request to this project. This happens in an automated fashion during the submission process. SAP uses the standard DCO text of the Linux Foundation.

License

Copyright (c) 2026 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, version 2.0 except as noted otherwise in the LICENSE file.

Reviews (0)

No results found