Documentation

n8n-nodes-automata

Custom nodes to integrate with Automata Registry:

  • Automata Provider Webhook: receives Automata execution requests, validates JWT, registers endpoint, forwards to workflow.
  • Automata Respond: sends HTTP responses back to Automata requests (replacement for Respond to Webhook).
  • Automata Consumer: authenticates with Automata Registry, analyzes prompt, searches/validates agents, executes with feedback.
  • Automata Consumer Tool: same params as Consumer, usable as AI Tool (ai_agent → ai_tool).

Icons live in dist/nodes (consumer.svg, provider.svg).

Nodes overview

Automata Provider Webhook

  • Path fixed: automata-provider/execute.
  • Registry environment: Dev/Prod/Custom (URL required for Custom).
  • Respond Immediately: default off. When off, use Automata Respond to reply later.
  • Registers webhook on activation (prod/test selectable).
  • JWT Secret required (32+ chars).

Automata Respond

  • Respond With: JSON, Text, Binary, First Incoming Item, or No Data.
  • Wrap as Automata Success (default on): responds { success: true, data: <body||{}> }.
  • Sets content-type: application/json if none provided.

Automata Consumer

  • LLM config (provider, API key, model, temperature). Uses clientId auto n8n-<instance|workflow>.
  • Registry env: Dev/Prod/Custom.
  • Use Analyze Prompt (default on). Manual intents/categories/tags/location only used if Analyze is off.
  • Validate Relevance (default on): LLM filters agents and selects tasks.
  • Execute Agents (default on): executeMultipleWithFeedback. Task shown only if Validate Relevance is off.
  • Return Interpretation Only (default on). When off, returns analysis, searchResults, relevantAgents, executionResults, interpretation.

Automata Consumer Tool

  • Usable as AI tool (input: ai_agent, output: ai_tool).
  • Same parameters as Consumer; prompt placeholder marked as AI-filled.

Build & install

npm install
npm run build     # copies SVGs to dist/nodes
npm pack          # optional tarball

For n8n custom nodes folder:

npm install --omit=dev /path/to/n8n-nodes-automata-<version>.tgz

Publish

npm run build
npm publish

Discussion