LoomCycle Sub-Agent Tool icon

LoomCycle Sub-Agent Tool

Delegates to a configured loomcycle agent — the parent AI Agent calls this tool with a prompt

LoomCycle Sub-Agent Tool

AI-generated

Summary

Exposes a LoomCycle agent as an AI tool for a parent n8n AI Agent. When the tool is called with a prompt, it spawns the configured agent, streams the run to completion, and returns the agent's final text.

Inputs

  • toolName (required) — Tool name shown to the parent AI Agent. Default: loomcycle_sub_agent.
  • toolDescription — Description the parent AI Agent reads when deciding whether to call the tool.
  • agent (required) — Name of the loomcycle agent to run. It must be declared in operator yaml or registered dynamically.
  • userId — Overrides user_id for the run. If empty, the credential's default userId is used.
  • userTier — Overrides user_tier for the run. If empty, the credential's default userTier is used.
  • treatPromptAsUntrusted — Default true. Sends the prompt as an untrusted-block segment. When false, it is sent as trusted-text.
  • Tool call arguments: prompt, sessionId (required) — The parent AI Agent supplies these, not the node UI. prompt (string) is required. sessionId is optional and continues an existing loomcycle session.

Output shape

A plain text string with the sub-agent's concatenated final text output. In tool mode this is returned to the parent AI Agent. If the node is run directly, each input item produces one item with json {result: text}.

Only text events are collected. Usage, stop reason, and session ID are captured internally but not returned, so the session ID can't be read back to continue a session. Errors don't throw. They are returned as JSON {error: message} with bearer tokens redacted. If the node is run directly, each input item must match the prompt/sessionId schema. The node requires the loomCycleApi credential.

Examples

Example 1: Let a supervisor AI Agent delegate research to a specialised loomcycle agent.

Tool Name: research_agent; Agent: researcher; Treat Prompt as Untrusted: true; connect the node to the AI Agent's Tool input.

Example 2: Run the sub-agent on behalf of a specific user at a premium tier.

Agent: support_bot; User ID: customer-42; User Tier: premium.

Links

Discussion