Camunda AI Agent

Build agentic AI processes in Camunda 8.8+: an LLM driver (the AI Agent connector, Sub-process variant) applied to an ad-hoc subprocess with tools modeled as BPMN activities. Covers shape, prompts, tool modeling with fromAi(), sub-flow tools, and multi-turn agent context.

The older Task variant (AI Agent connector on a service task paired with an external multi-instance ad-hoc subprocess and explicit feedback loop) is documented in references/ai-agent-task.md for the niche cases where you need to audit or intercept every tool call. The Sub-process variant is the recommended choice for everything else, and is what the rest of this skill teaches.

Prerequisites

• Camunda 8.8+ cluster (the AI Agent connector ships in 8.8+)
• c8ctl CLI installed and a profile configured — see camunda-c8ctl
• An API key for the model provider you'll use (Anthropic, Amazon Bedrock, Azure OpenAI, Google Vertex AI, OpenAI, or any OpenAI-compatible provider). Store it as a Camunda cluster secret, never in the BPMN file. For local c8run, see camunda-c8ctl for the secrets bootstrap flow.

Cross-References

• camunda-bpmn: BPMN basics, ad-hoc subprocess element, namespaces, the mandatory lint loop.
• camunda-connectors: The underlying c8ctl element-template workflow used to apply the AI Agent template (and the REST connector commonly used as a tool).
• camunda-feel: FEEL syntax for prompts, fromAi() calls, result expressions, type coercion.
• camunda-process-mgmt: Deploying the process, starting an instance, inspecting incidents from agent invocations.