node-red-contrib-ai-agent 0.4.0 → 0.5.0

package/README.md

@@ -19,6 +19,7 @@ Your feedback and contributions are highly appreciated!
 ## Features
 
 - **AI Agent Node**: Process messages with AI, maintaining conversation context
+- **AI Agent Orchestrator Node**: Participates in orchestrated flows via Chain Discovery
 - **Memory Nodes**: 
   - **In-Memory**: Store conversation context in memory (volatile)
   - **File-based**: Persist conversation context to disk
@@ -61,6 +62,14 @@ Processes messages using the configured AI model and maintains conversation cont
 - **System Prompt**: Initial instructions for the AI
 - **Response Type**: Format of the response (text or JSON object)
 
+### AI Agent Orchestrator
+A specialized version of the AI Agent designed for multi-agent workflows. It "tags" messages in a pipeline so the **AI Orchestrator** can discover it.
+
+**Properties:**
+- **Name**: Display name for the node
+- **Capabilities**: Comma-separated list of skills (e.g., `coding, research`)
+- **System Prompt**: Instructions for this specific expert
+
 ### Memory (In-Memory)
 A configuration node that initializes the conversation context in memory. The agent node uses this configuration to manage the conversation context.
 
@@ -91,13 +100,13 @@ Configures the AI model and API settings.
 - **Name**: Display name for the node
 
 ### AI Orchestrator
-Coordinates multiple AI agents by creating and executing plans. It uses an autonomy loop (observe-think-act-reflect) to achieve complex goals.
+Coordinates multiple AI agents by creating and executing plans. It uses **Chain Discovery** to identify available agents from its input message.
 
 **Key Features:**
+- **Chain Discovery**: Implicitly discovers agents wired in a pipeline before it.
+- **Zero-Wire Execution**: Calls discovered agents directly via code (no messy routing wires).
 - **Non-linear Planning**: Supports task dependencies (tasks wait for their predecessors).
-- **Task Prioritization**: Executes higher priority tasks first within dependency constraints.
-- **Dynamic Plan Revision**: Refines the plan based on task outcomes and agent feedback.
-- **Error Recovery**: Automatically handles task failures with recovery strategies (retry, pivot, or fail).
+- **Error Recovery**: Automatically handles task failures with recovery strategies.
 
 **Properties:**
 - **Max Iterations**: Maximum cycles for the autonomy loop
@@ -186,17 +195,16 @@ For more complex scenarios, you can chain multiple agents to process messages in
 
 Each agent will maintain its own conversation context based on its memory configuration.
 
-## Example: Autonomous Orchestration
+## Example: Autonomous Orchestration (Chain Discovery)
 
-The AI Orchestrator can manage complex, multi-step tasks:
+The AI Orchestrator can manage complex, multi-step tasks by utilizing specialized agents in a pipeline:
 
-1. Add an **AI Orchestrator** node
-2. Connect its first output to an **AI Agent**
-3. Connect the agent's output back to the **AI Orchestrator** input
-4. Connect the orchestrator's second output to a **Debug** node
-5. Configure the orchestrator with a goal (e.g., "Write a blog post and then translate it to Spanish")
+1. Add an **AI Orchestrator** node.
+2. Add one or more **AI Agent Orchestrator** nodes (e.g., "Coder", "Researcher").
+3. Connect them in a line: `[Inject Goal] --> [Coder] --> [Researcher] --> [Orchestrator] --> [Debug]`.
+4. The Orchestrator will automatically discover the "Coder" and "Researcher" via the message pipeline and call them as needed to achieve the goal.
 
-The orchestrator will create a plan (optionally with dependencies and priorities), dispatch the first available task to the agent, reflect on the result, and then dispatch the next task until completion. If a task fails, it can revise the plan to recover.
+This linear architecture keeps your flows clean while allowing for powerful, multi-agent collaboration.
 
 ## Best Practices
 

package/agent/ai-agent.html

@@ -1,96 +1,96 @@
-<script type="text/javascript">
-  RED.nodes.registerType('ai-agent', {
-    category: 'AI Agent',
-    color: '#a6bbcf',
-    defaults: {
-      name: { value: '' },
-      systemPrompt: { 
-        value: 'You are a helpful AI assistant.',
-        required: true
-      },
-      responseType: { 
-        value: 'text', 
-        required: true,
-        validate: function(val) {
-          return ['text', 'object'].includes(val);
-        }
-      }
-    },
-    inputs: 1,
-    outputs: 1,
-    icon: 'agent/ai-agent-icon.svg',
-    label: function() {
-      return this.name || 'AI Agent';
-    },
-    paletteLabel: 'AI Agent',
-    oneditprepare: function() {
-      // Always show OpenRouter help since we only support OpenRouter now
-      $('#openrouter-help').show();
-    }
-  });
-</script>
-
-<!-- START: Template -->
-<script type="text/x-red" data-template-name="ai-agent">
-  <div class="form-row">
-    <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
-    <input type="text" id="node-input-name" placeholder="AI Agent">
-  </div>
-  
-  <div class="form-row">
-    <label for="node-input-systemPrompt"><i class="fa fa-comment"></i> System Prompt</label>
-    <textarea type="text" id="node-input-systemPrompt" placeholder="You are a helpful AI assistant." style="width: 100%; height: 80px; resize: vertical; font-family: monospace;"></textarea>
-  </div>
-  
-  <div class="form-row">
-    <label><i class="fa fa-robot"></i> AI Agent</label>
-    <div class="form-tips" style="width: 70%;">
-      <p>This node uses OpenRouter for AI responses. Connect an <b>AI Model</b> node to configure the model and API key.</p>
-    </div>
-  </div>
-  
-  <div class="form-row">
-    <label for="node-input-responseType"><i class="fa fa-reply"></i> Response Format</label>
-    <select id="node-input-responseType" style="width: 100%;">
-      <option value="text">Text Only</option>
-      <option value="object">Structured Object</option>
-    </select>
-  </div>
-  
-  <div id="openrouter-help" class="form-tips" style="display: none; margin-top: 15px; padding: 10px; background: #f8f9fa; border-radius: 4px; border-left: 3px solid #3b78e7;">
-    <p><i class="fa fa-info-circle"></i> <strong>Note:</strong> When using OpenRouter, connect an AI Model node to provide the model and API key configuration.</p>
-    <p>The AI Model node will add an <code>aiagent</code> property to the message with the required configuration.</p>
-  </div>
-</script>
-<!-- END: Template -->
-
-<!-- START: Help -->
-<script type="text/x-red" data-help-name="ai-agent">
-  <h3>AI Agent Node</h3>
-  <p>An intelligent agent that processes and responds to messages with configurable behavior.</p>
-  
-  <h4>Features</h4>
-  <ul>
-    <li>Multiple agent types (Assistant, Chatbot)</li>
-    <li>Configurable response formats</li>
-    <li>Conversation context tracking</li>
-    <li>Error handling and status reporting</li>
-  </ul>
-  
-  <h4>Usage</h4>
-  <ol>
-    <li>Connect the node to a message source (e.g., HTTP input, inject node)</li>
-    <li>Configure the agent type and response format</li>
-    <li>Process the response in your flow</li>
-  </ol>
-  
-  <h4>Output Formats</h4>
-  <p><b>Text Only:</b> Simple string response</p>
-  <p><b>Structured Object:</b> Detailed response including metadata and context</p>
-  
-  <h4>Examples</h4>
-  <p><b>Input:</b> "Hello"</p>
-  <p><b>Assistant Output:</b> "Hello! How can I assist you today?"</p>
-  <p><b>Chatbot Output:</b> "Hi there! What would you like to chat about?"</p>
-</script>
+<script type="text/javascript">
+  RED.nodes.registerType('ai-agent', {
+    category: 'AI Agent',
+    color: '#a6bbcf',
+    defaults: {
+      name: { value: '' },
+      systemPrompt: { 
+        value: 'You are a helpful AI assistant.',
+        required: true
+      },
+      responseType: { 
+        value: 'text', 
+        required: true,
+        validate: function(val) {
+          return ['text', 'object'].includes(val);
+        }
+      }
+    },
+    inputs: 1,
+    outputs: 1,
+    icon: 'agent/ai-agent-icon.svg',
+    label: function() {
+      return this.name || 'AI Agent';
+    },
+    paletteLabel: 'AI Agent',
+    oneditprepare: function() {
+      // Always show OpenRouter help since we only support OpenRouter now
+      $('#openrouter-help').show();
+    }
+  });
+</script>
+
+<!-- START: Template -->
+<script type="text/x-red" data-template-name="ai-agent">
+  <div class="form-row">
+    <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+    <input type="text" id="node-input-name" placeholder="AI Agent">
+  </div>
+  
+  <div class="form-row">
+    <label for="node-input-systemPrompt"><i class="fa fa-comment"></i> System Prompt</label>
+    <textarea type="text" id="node-input-systemPrompt" placeholder="You are a helpful AI assistant." style="width: 100%; height: 80px; resize: vertical; font-family: monospace;"></textarea>
+  </div>
+  
+  <div class="form-row">
+    <label><i class="fa fa-robot"></i> AI Agent</label>
+    <div class="form-tips" style="width: 70%;">
+      <p>This node uses OpenRouter for AI responses. Connect an <b>AI Model</b> node to configure the model and API key.</p>
+    </div>
+  </div>
+  
+  <div class="form-row">
+    <label for="node-input-responseType"><i class="fa fa-reply"></i> Response Format</label>
+    <select id="node-input-responseType" style="width: 100%;">
+      <option value="text">Text Only</option>
+      <option value="object">Structured Object</option>
+    </select>
+  </div>
+  
+  <div id="openrouter-help" class="form-tips" style="display: none; margin-top: 15px; padding: 10px; background: #f8f9fa; border-radius: 4px; border-left: 3px solid #3b78e7;">
+    <p><i class="fa fa-info-circle"></i> <strong>Note:</strong> When using OpenRouter, connect an AI Model node to provide the model and API key configuration.</p>
+    <p>The AI Model node will add an <code>aiagent</code> property to the message with the required configuration.</p>
+  </div>
+</script>
+<!-- END: Template -->
+
+<!-- START: Help -->
+<script type="text/x-red" data-help-name="ai-agent">
+  <h3>AI Agent Node</h3>
+  <p>An intelligent agent that processes and responds to messages with configurable behavior.</p>
+  
+  <h4>Features</h4>
+  <ul>
+    <li>Multiple agent types (Assistant, Chatbot)</li>
+    <li>Configurable response formats</li>
+    <li>Conversation context tracking</li>
+    <li>Error handling and status reporting</li>
+  </ul>
+  
+  <h4>Usage</h4>
+  <ol>
+    <li>Connect the node to a message source (e.g., HTTP input, inject node)</li>
+    <li>Configure the agent type and response format</li>
+    <li>Process the response in your flow</li>
+  </ol>
+  
+  <h4>Output Formats</h4>
+  <p><b>Text Only:</b> Simple string response</p>
+  <p><b>Structured Object:</b> Detailed response including metadata and context</p>
+  
+  <h4>Examples</h4>
+  <p><b>Input:</b> "Hello"</p>
+  <p><b>Assistant Output:</b> "Hello! How can I assist you today?"</p>
+  <p><b>Chatbot Output:</b> "Hi there! What would you like to chat about?"</p>
+</script>
 <!-- END: Help -->