@camunda/connectors-element-templates 1.0.15 → 1.0.17

package/src/element-templates/agenticai-aiagent-job-worker.json

@@ -7,8 +7,8 @@
     "metadata": {
       "keywords": ["AI", "AI Agent", "agentic orchestration"]
     },
-    "documentationRef": "https://docs.camunda.io/docs/8.8/components/connectors/out-of-the-box-connectors/agentic-ai-aiagent/",
-    "version": 4,
+    "documentationRef": "https://docs.camunda.io/docs/8.9/components/connectors/out-of-the-box-connectors/agentic-ai-aiagent-subprocess/",
+    "version": 6,
     "category": {
       "id": "connectors",
       "name": "Connectors"
@@ -18,7 +18,7 @@
       "value": "bpmn:AdHocSubProcess"
     },
     "engines": {
-      "camunda": "^8.8"
+      "camunda": "^8.9"
     },
     "groups": [
       {
@@ -63,12 +63,13 @@
       {
         "id": "events",
         "label": "Event handling",
+        "tooltip": "Configure how event sub-process results are handled. Results are added as user messages to the running agent.",
         "openByDefault": false
       },
       {
         "id": "response",
         "label": "Response",
-        "tooltip": "Configuration of the model response format and how to map the model response to the connector result.<br><br>Depending on the selection, the model response will be available as <code>response.responseText</code> or <code>response.responseJson</code>.<br><br>See <a href=\"https://docs.camunda.io/docs/8.8/components/connectors/out-of-the-box-connectors/agentic-ai-aiagent-process/#response\">documentation</a> for details.",
+        "tooltip": "Configuration of the model response format and how to map the model response to the connector result.<br><br>Depending on the selection, the model response will be available as <code>response.responseText</code> or <code>response.responseJson</code>.<br><br>See <a href=\"https://docs.camunda.io/docs/8.9/components/connectors/out-of-the-box-connectors/agentic-ai-aiagent-subprocess/#response\">documentation</a> for details.",
         "openByDefault": false
       },
       {
@@ -191,6 +192,24 @@
         },
         "type": "String"
       },
+      {
+        "id": "provider.anthropic.timeouts.timeout",
+        "label": "Timeout",
+        "description": "Timeout specification for API calls to the model provider defined as ISO-8601 duration (example: <code>PT60S</code>).",
+        "optional": true,
+        "feel": "optional",
+        "group": "provider",
+        "binding": {
+          "name": "provider.anthropic.timeouts.timeout",
+          "type": "zeebe:input"
+        },
+        "condition": {
+          "property": "provider.type",
+          "equals": "anthropic",
+          "type": "simple"
+        },
+        "type": "String"
+      },
       {
         "id": "provider.bedrock.region",
         "label": "Region",
@@ -251,6 +270,10 @@
             "name": "Credentials",
             "value": "credentials"
           },
+          {
+            "name": "API Key",
+            "value": "apiKey"
+          },
           {
             "name": "Default Credentials Chain (Hybrid/Self-Managed only)",
             "value": "defaultCredentialsChain"
@@ -317,6 +340,54 @@
         },
         "type": "String"
       },
+      {
+        "id": "provider.bedrock.authentication.apiKey",
+        "label": "API Key",
+        "description": "Provide an API Key with permissions to interact with your AWS Bedrock Instance",
+        "optional": false,
+        "constraints": {
+          "notEmpty": true
+        },
+        "feel": "optional",
+        "group": "provider",
+        "binding": {
+          "name": "provider.bedrock.authentication.apiKey",
+          "type": "zeebe:input"
+        },
+        "condition": {
+          "allMatch": [
+            {
+              "property": "provider.bedrock.authentication.type",
+              "equals": "apiKey",
+              "type": "simple"
+            },
+            {
+              "property": "provider.type",
+              "equals": "bedrock",
+              "type": "simple"
+            }
+          ]
+        },
+        "type": "String"
+      },
+      {
+        "id": "provider.bedrock.timeouts.timeout",
+        "label": "Timeout",
+        "description": "Timeout specification for API calls to the model provider defined as ISO-8601 duration (example: <code>PT60S</code>).",
+        "optional": true,
+        "feel": "optional",
+        "group": "provider",
+        "binding": {
+          "name": "provider.bedrock.timeouts.timeout",
+          "type": "zeebe:input"
+        },
+        "condition": {
+          "property": "provider.type",
+          "equals": "bedrock",
+          "type": "simple"
+        },
+        "type": "String"
+      },
       {
         "id": "provider.azureOpenAi.endpoint",
         "label": "Endpoint",
@@ -511,6 +582,24 @@
         },
         "type": "String"
       },
+      {
+        "id": "provider.azureOpenAi.timeouts.timeout",
+        "label": "Timeout",
+        "description": "Timeout specification for API calls to the model provider defined as ISO-8601 duration (example: <code>PT60S</code>).",
+        "optional": true,
+        "feel": "optional",
+        "group": "provider",
+        "binding": {
+          "name": "provider.azureOpenAi.timeouts.timeout",
+          "type": "zeebe:input"
+        },
+        "condition": {
+          "property": "provider.type",
+          "equals": "azureOpenAi",
+          "type": "simple"
+        },
+        "type": "String"
+      },
       {
         "id": "provider.googleVertexAi.projectId",
         "label": "Project ID",
@@ -666,6 +755,24 @@
         },
         "type": "String"
       },
+      {
+        "id": "provider.openai.timeouts.timeout",
+        "label": "Timeout",
+        "description": "Timeout specification for API calls to the model provider defined as ISO-8601 duration (example: <code>PT60S</code>).",
+        "optional": true,
+        "feel": "optional",
+        "group": "provider",
+        "binding": {
+          "name": "provider.openai.timeouts.timeout",
+          "type": "zeebe:input"
+        },
+        "condition": {
+          "property": "provider.type",
+          "equals": "openai",
+          "type": "simple"
+        },
+        "type": "String"
+      },
       {
         "id": "provider.openaiCompatible.endpoint",
         "label": "API endpoint",
@@ -723,6 +830,42 @@
         },
         "type": "String"
       },
+      {
+        "id": "provider.openaiCompatible.queryParameters",
+        "label": "Query Parameters",
+        "description": "Map of query parameters to add to the request URL.",
+        "optional": true,
+        "feel": "required",
+        "group": "provider",
+        "binding": {
+          "name": "provider.openaiCompatible.queryParameters",
+          "type": "zeebe:input"
+        },
+        "condition": {
+          "property": "provider.type",
+          "equals": "openaiCompatible",
+          "type": "simple"
+        },
+        "type": "String"
+      },
+      {
+        "id": "provider.openaiCompatible.timeouts.timeout",
+        "label": "Timeout",
+        "description": "Timeout specification for API calls to the model provider defined as ISO-8601 duration (example: <code>PT60S</code>).",
+        "optional": true,
+        "feel": "optional",
+        "group": "provider",
+        "binding": {
+          "name": "provider.openaiCompatible.timeouts.timeout",
+          "type": "zeebe:input"
+        },
+        "condition": {
+          "property": "provider.type",
+          "equals": "openaiCompatible",
+          "type": "simple"
+        },
+        "type": "String"
+      },
       {
         "id": "provider.anthropic.model.model",
         "label": "Model",
@@ -1235,7 +1378,7 @@
         "id": "data.systemPrompt.prompt",
         "label": "System prompt",
         "optional": false,
-        "value": "\"You are **TaskAgent**, a helpful, generic chat agent that can handle a wide variety of customer requests using your own domain knowledge **and** any tools explicitly provided to you at runtime.\n\nIf tools are provided, you should prefer them instead of guessing an answer. You can call the same tool multiple times by providing different input values. Don't guess any tools which were not explicitly configured. If no tool matches the request, try to generate an answer. If you're not able to find a good answer, return with a message stating why you're not able to.\n\nWrap minimal, inspectable reasoning in *exactly* this XML template:\n\n<thinking>\n<context>…briefly state the customer’s need and current state…</context>\n<reflection>…list candidate tools, justify which you will call next and why…</reflection>\n</thinking>\n\nReveal **no** additional private reasoning outside these tags.\"",
+        "value": "=\"You are **TaskAgent**, a helpful, generic chat agent that can handle a wide variety of customer requests using your own domain knowledge **and** any tools explicitly provided to you at runtime.\n\nIf tools are provided, you should prefer them instead of guessing an answer. You can call the same tool multiple times by providing different input values. Don't guess any tools which were not explicitly configured. If no tool matches the request, try to generate an answer. If you're not able to find a good answer, return with a message stating why you're not able to.\n\nWrap minimal, inspectable reasoning in *exactly* this XML template:\n\n<thinking>\n<context>…briefly state the customer’s need and current state…</context>\n<reflection>…list candidate tools, justify which you will call next and why…</reflection>\n</thinking>\n\nReveal **no** additional private reasoning outside these tags.\"",
         "constraints": {
           "notEmpty": true
         },
@@ -1273,7 +1416,7 @@
           "name": "data.userPrompt.documents",
           "type": "zeebe:input"
         },
-        "tooltip": "Referenced documents will be automatically added to the user prompt. <a href=\"https://docs.camunda.io/docs/8.8/components/connectors/out-of-the-box-connectors/agentic-ai-aiagent-process/\" target=\"_blank\">See documentation</a> for details and supported file types.",
+        "tooltip": "Referenced documents will be automatically added to the user prompt. <a href=\"https://docs.camunda.io/docs/8.9/components/connectors/out-of-the-box-connectors/agentic-ai-aiagent-subprocess/\" target=\"_blank\">See documentation</a> for details and supported file types.",
         "type": "String"
       },
       {
@@ -1287,7 +1430,7 @@
           "name": "agentContext",
           "type": "zeebe:input"
         },
-        "tooltip": "The agent context variable containing all relevant data for the agent to support the feedback loop between user requests, tool calls and LLM responses. Make sure this variable points to the <code>context</code> variable which is returned from the agent response. <a href=\"https://docs.camunda.io/docs/8.8/components/connectors/out-of-the-box-connectors/agentic-ai-aiagent-process/\" target=\"_blank\">See documentation</a> for details.",
+        "tooltip": "The agent context variable containing all relevant data for the agent to support the feedback loop between user requests, tool calls and LLM responses. Make sure this variable points to the <code>context</code> variable which is returned from the agent response. <a href=\"https://docs.camunda.io/docs/8.9/components/connectors/out-of-the-box-connectors/agentic-ai-aiagent-subprocess/\" target=\"_blank\">See documentation</a> for details.",
         "type": "Text"
       },
       {
@@ -1403,7 +1546,7 @@
           "name": "data.memory.contextWindowSize",
           "type": "zeebe:input"
         },
-        "tooltip": "Use this to limit the number of messages which are sent to the model. The agent will only send the most recent messages up to the configured limit to the LLM. Older messages will be kept in the conversation store, but not sent to the model. <a href=\"https://docs.camunda.io/docs/8.8/components/connectors/out-of-the-box-connectors/agentic-ai-aiagent-process/\" target=\"_blank\">See documentation</a> for details.",
+        "tooltip": "Use this to limit the number of messages which are sent to the model. The agent will only send the most recent messages up to the configured limit to the LLM. Older messages will be kept in the conversation store, but not sent to the model. <a href=\"https://docs.camunda.io/docs/8.9/components/connectors/out-of-the-box-connectors/agentic-ai-aiagent-subprocess/\" target=\"_blank\">See documentation</a> for details.",
         "type": "Number"
       },
       {
@@ -1423,7 +1566,7 @@
       {
         "id": "data.events.behavior",
         "label": "Event handling behavior",
-        "description": "Behavior in combination with an event sub-process.",
+        "description": "Behavior on completing an event sub-process.",
         "optional": false,
         "value": "WAIT_FOR_TOOL_CALL_RESULTS",
         "constraints": {
@@ -1441,7 +1584,7 @@
             "value": "WAIT_FOR_TOOL_CALL_RESULTS"
           },
           {
-            "name": "Interrupt tool calls",
+            "name": "Cancel tool calls",
             "value": "INTERRUPT_TOOL_CALLS"
           }
         ]
@@ -1557,7 +1700,7 @@
         "id": "version",
         "label": "Version",
         "description": "Version of the element template",
-        "value": "4",
+        "value": "6",
         "group": "connector",
         "binding": {
           "key": "elementTemplateVersion",
@@ -1633,14 +1776,14 @@
   },
   {
     "$schema": "https://unpkg.com/@camunda/zeebe-element-templates-json-schema/resources/schema.json",
-    "name": "AI Agent Subprocess",
+    "name": "AI Agent Sub-process",
     "id": "io.camunda.connectors.agenticai.aiagent.jobworker.v1",
-    "description": "Processes user requests with an integrated, customizable toolbox and services for dynamic workflows.",
+    "description": "Run a multi-step AI reasoning loop with dynamic tool selection",
     "metadata": {
       "keywords": ["AI", "AI Agent", "agentic orchestration"]
     },
     "documentationRef": "https://docs.camunda.io/docs/8.8/components/connectors/out-of-the-box-connectors/agentic-ai-aiagent/",
-    "version": 3,
+    "version": 4,
     "category": {
       "id": "connectors",
       "name": "Connectors"
@@ -1695,6 +1838,7 @@
       {
         "id": "events",
         "label": "Event handling",
+        "tooltip": "Configure how event sub-process results are handled. Results are added as user messages to the running agent.",
         "openByDefault": false
       },
       {
@@ -2912,7 +3056,7 @@
         "id": "agentContext",
         "label": "Agent context",
         "description": "Initial agent context from previous interactions. Avoid reusing context variables across agents to prevent issues with stale data or tool access.",
-        "optional": true,
+        "optional": false,
         "feel": "required",
         "group": "memory",
         "binding": {
@@ -3055,7 +3199,7 @@
       {
         "id": "data.events.behavior",
         "label": "Event handling behavior",
-        "description": "Behavior in combination with an event sub-process.",
+        "description": "Behavior on completing an event sub-process.",
         "optional": false,
         "value": "WAIT_FOR_TOOL_CALL_RESULTS",
         "constraints": {
@@ -3073,7 +3217,7 @@
             "value": "WAIT_FOR_TOOL_CALL_RESULTS"
           },
           {
-            "name": "Interrupt tool calls",
+            "name": "Cancel tool calls",
             "value": "INTERRUPT_TOOL_CALLS"
           }
         ]
@@ -3189,7 +3333,7 @@
         "id": "version",
         "label": "Version",
         "description": "Version of the element template",
-        "value": "3",
+        "value": "4",
         "group": "connector",
         "binding": {
           "key": "elementTemplateVersion",
@@ -3327,6 +3471,7 @@
       {
         "id": "events",
         "label": "Event handling",
+        "tooltip": "Configure how event sub-process results are handled. Results are added as user messages to the running agent.",
         "openByDefault": false
       },
       {
@@ -4687,7 +4832,7 @@
       {
         "id": "data.events.behavior",
         "label": "Event handling behavior",
-        "description": "Behavior in combination with an event sub-process.",
+        "description": "Behavior on completing an event sub-process.",
         "optional": false,
         "value": "WAIT_FOR_TOOL_CALL_RESULTS",
         "constraints": {
@@ -4705,7 +4850,7 @@
             "value": "WAIT_FOR_TOOL_CALL_RESULTS"
           },
           {
-            "name": "Interrupt tool calls",
+            "name": "Cancel tool calls",
             "value": "INTERRUPT_TOOL_CALLS"
           }
         ]
@@ -4897,14 +5042,14 @@
   },
   {
     "$schema": "https://unpkg.com/@camunda/zeebe-element-templates-json-schema/resources/schema.json",
-    "name": "AI Agent Sub-process",
+    "name": "AI Agent Subprocess",
     "id": "io.camunda.connectors.agenticai.aiagent.jobworker.v1",
-    "description": "Run a multi-step AI reasoning loop with dynamic tool selection",
+    "description": "Processes user requests with an integrated, customizable toolbox and services for dynamic workflows.",
     "metadata": {
       "keywords": ["AI", "AI Agent", "agentic orchestration"]
     },
     "documentationRef": "https://docs.camunda.io/docs/8.8/components/connectors/out-of-the-box-connectors/agentic-ai-aiagent/",
-    "version": 6,
+    "version": 3,
     "category": {
       "id": "connectors",
       "name": "Connectors"
@@ -4914,7 +5059,7 @@
       "value": "bpmn:AdHocSubProcess"
     },
     "engines": {
-      "camunda": "^8.9"
+      "camunda": "^8.8"
     },
     "groups": [
       {
@@ -4959,6 +5104,7 @@
       {
         "id": "events",
         "label": "Event handling",
+        "tooltip": "Configure how event sub-process results are handled. Results are added as user messages to the running agent.",
         "openByDefault": false
       },
       {
@@ -5087,24 +5233,6 @@
         },
         "type": "String"
       },
-      {
-        "id": "provider.anthropic.timeouts.timeout",
-        "label": "Timeout",
-        "description": "Timeout specification for API calls to the model provider defined as ISO-8601 duration (example: <code>PT60S</code>).",
-        "optional": true,
-        "feel": "optional",
-        "group": "provider",
-        "binding": {
-          "name": "provider.anthropic.timeouts.timeout",
-          "type": "zeebe:input"
-        },
-        "condition": {
-          "property": "provider.type",
-          "equals": "anthropic",
-          "type": "simple"
-        },
-        "type": "String"
-      },
       {
         "id": "provider.bedrock.region",
         "label": "Region",
@@ -5165,10 +5293,6 @@
             "name": "Credentials",
             "value": "credentials"
           },
-          {
-            "name": "API Key",
-            "value": "apiKey"
-          },
           {
             "name": "Default Credentials Chain (Hybrid/Self-Managed only)",
             "value": "defaultCredentialsChain"
@@ -5235,54 +5359,6 @@
         },
         "type": "String"
       },
-      {
-        "id": "provider.bedrock.authentication.apiKey",
-        "label": "API Key",
-        "description": "Provide an API Key with permissions to interact with your AWS Bedrock Instance",
-        "optional": false,
-        "constraints": {
-          "notEmpty": true
-        },
-        "feel": "optional",
-        "group": "provider",
-        "binding": {
-          "name": "provider.bedrock.authentication.apiKey",
-          "type": "zeebe:input"
-        },
-        "condition": {
-          "allMatch": [
-            {
-              "property": "provider.bedrock.authentication.type",
-              "equals": "apiKey",
-              "type": "simple"
-            },
-            {
-              "property": "provider.type",
-              "equals": "bedrock",
-              "type": "simple"
-            }
-          ]
-        },
-        "type": "String"
-      },
-      {
-        "id": "provider.bedrock.timeouts.timeout",
-        "label": "Timeout",
-        "description": "Timeout specification for API calls to the model provider defined as ISO-8601 duration (example: <code>PT60S</code>).",
-        "optional": true,
-        "feel": "optional",
-        "group": "provider",
-        "binding": {
-          "name": "provider.bedrock.timeouts.timeout",
-          "type": "zeebe:input"
-        },
-        "condition": {
-          "property": "provider.type",
-          "equals": "bedrock",
-          "type": "simple"
-        },
-        "type": "String"
-      },
       {
         "id": "provider.azureOpenAi.endpoint",
         "label": "Endpoint",
@@ -5477,24 +5553,6 @@
         },
         "type": "String"
       },
-      {
-        "id": "provider.azureOpenAi.timeouts.timeout",
-        "label": "Timeout",
-        "description": "Timeout specification for API calls to the model provider defined as ISO-8601 duration (example: <code>PT60S</code>).",
-        "optional": true,
-        "feel": "optional",
-        "group": "provider",
-        "binding": {
-          "name": "provider.azureOpenAi.timeouts.timeout",
-          "type": "zeebe:input"
-        },
-        "condition": {
-          "property": "provider.type",
-          "equals": "azureOpenAi",
-          "type": "simple"
-        },
-        "type": "String"
-      },
       {
         "id": "provider.googleVertexAi.projectId",
         "label": "Project ID",
@@ -5650,24 +5708,6 @@
         },
         "type": "String"
       },
-      {
-        "id": "provider.openai.timeouts.timeout",
-        "label": "Timeout",
-        "description": "Timeout specification for API calls to the model provider defined as ISO-8601 duration (example: <code>PT60S</code>).",
-        "optional": true,
-        "feel": "optional",
-        "group": "provider",
-        "binding": {
-          "name": "provider.openai.timeouts.timeout",
-          "type": "zeebe:input"
-        },
-        "condition": {
-          "property": "provider.type",
-          "equals": "openai",
-          "type": "simple"
-        },
-        "type": "String"
-      },
       {
         "id": "provider.openaiCompatible.endpoint",
         "label": "API endpoint",
@@ -5725,42 +5765,6 @@
         },
         "type": "String"
       },
-      {
-        "id": "provider.openaiCompatible.queryParameters",
-        "label": "Query Parameters",
-        "description": "Map of query parameters to add to the request URL.",
-        "optional": true,
-        "feel": "required",
-        "group": "provider",
-        "binding": {
-          "name": "provider.openaiCompatible.queryParameters",
-          "type": "zeebe:input"
-        },
-        "condition": {
-          "property": "provider.type",
-          "equals": "openaiCompatible",
-          "type": "simple"
-        },
-        "type": "String"
-      },
-      {
-        "id": "provider.openaiCompatible.timeouts.timeout",
-        "label": "Timeout",
-        "description": "Timeout specification for API calls to the model provider defined as ISO-8601 duration (example: <code>PT60S</code>).",
-        "optional": true,
-        "feel": "optional",
-        "group": "provider",
-        "binding": {
-          "name": "provider.openaiCompatible.timeouts.timeout",
-          "type": "zeebe:input"
-        },
-        "condition": {
-          "property": "provider.type",
-          "equals": "openaiCompatible",
-          "type": "simple"
-        },
-        "type": "String"
-      },
       {
         "id": "provider.anthropic.model.model",
         "label": "Model",
@@ -6273,7 +6277,7 @@
         "id": "data.systemPrompt.prompt",
         "label": "System prompt",
         "optional": false,
-        "value": "=\"You are **TaskAgent**, a helpful, generic chat agent that can handle a wide variety of customer requests using your own domain knowledge **and** any tools explicitly provided to you at runtime.\n\nIf tools are provided, you should prefer them instead of guessing an answer. You can call the same tool multiple times by providing different input values. Don't guess any tools which were not explicitly configured. If no tool matches the request, try to generate an answer. If you're not able to find a good answer, return with a message stating why you're not able to.\n\nWrap minimal, inspectable reasoning in *exactly* this XML template:\n\n<thinking>\n<context>…briefly state the customer’s need and current state…</context>\n<reflection>…list candidate tools, justify which you will call next and why…</reflection>\n</thinking>\n\nReveal **no** additional private reasoning outside these tags.\"",
+        "value": "\"You are **TaskAgent**, a helpful, generic chat agent that can handle a wide variety of customer requests using your own domain knowledge **and** any tools explicitly provided to you at runtime.\n\nIf tools are provided, you should prefer them instead of guessing an answer. You can call the same tool multiple times by providing different input values. Don't guess any tools which were not explicitly configured. If no tool matches the request, try to generate an answer. If you're not able to find a good answer, return with a message stating why you're not able to.\n\nWrap minimal, inspectable reasoning in *exactly* this XML template:\n\n<thinking>\n<context>…briefly state the customer’s need and current state…</context>\n<reflection>…list candidate tools, justify which you will call next and why…</reflection>\n</thinking>\n\nReveal **no** additional private reasoning outside these tags.\"",
         "constraints": {
           "notEmpty": true
         },
@@ -6318,7 +6322,7 @@
         "id": "agentContext",
         "label": "Agent context",
         "description": "Initial agent context from previous interactions. Avoid reusing context variables across agents to prevent issues with stale data or tool access.",
-        "optional": false,
+        "optional": true,
         "feel": "required",
         "group": "memory",
         "binding": {
@@ -6461,7 +6465,7 @@
       {
         "id": "data.events.behavior",
         "label": "Event handling behavior",
-        "description": "Behavior in combination with an event sub-process.",
+        "description": "Behavior on completing an event sub-process.",
         "optional": false,
         "value": "WAIT_FOR_TOOL_CALL_RESULTS",
         "constraints": {
@@ -6479,7 +6483,7 @@
             "value": "WAIT_FOR_TOOL_CALL_RESULTS"
           },
           {
-            "name": "Interrupt tool calls",
+            "name": "Cancel tool calls",
             "value": "INTERRUPT_TOOL_CALLS"
           }
         ]
@@ -6595,7 +6599,7 @@
         "id": "version",
         "label": "Version",
         "description": "Version of the element template",
-        "value": "6",
+        "value": "3",
         "group": "connector",
         "binding": {
           "key": "elementTemplateVersion",