Zihin Agent icon

Zihin Agent

Invoke a Zihin agent (runs the full agent loop: tools, memory, governance)

Zihin Agent

AI-generated

Summary

Invokes the selected Zihin agent with a message and returns its completed response, session details, and available execution metrics. Supply a Session ID to continue a conversation, or use Structured Input for context, tool-only bindings, a consumer identity, or a session derived from input fields; structured input requires an admin or owner API key.

Inputs

  • Agent Name or ID (required) — Select the agent to invoke, or provide its ID using an expression.
  • Message (required) — Message sent to the agent.
  • Session ID — Reuse an ID returned by an earlier call to continue that conversation; leave empty to start a new one. Cannot be combined with Session From.
  • Structured Input — Optional inputs requiring an admin or owner API key. Bindings are a flat JSON object for agent tools only; Context is a flat JSON object read by the model and stored with the conversation, with values resembling secrets redacted. Consumer Key identifies the end user for per-person memory and controls. Session From derives a reusable session from 1–5 field names in Context or Bindings; at least one named field must have a value.
  • Options — Base URL can be overridden; custom hosts require Allow Custom Base URL, and HTTP or localhost additionally requires Allow HTTP / Localhost. Include Raw Events adds stream events to the output for debugging. Timeout (Ms) sets the server-side turn limit; the default is 200000 ms. Max Tokens and Temperature are deprecated and have no effect; configure these on the agent in Zihin instead.

Output shape

One n8n item per input item, containing a single result object.

The result includes content and contentSource, sessionId, and available model, usage, sources, blocks, execution timing and ID, outcome, truncation, finish reason, gating, and structured-input acceptance details. The sessionId can be reused to continue the conversation. Raw stream events appear only when Include Raw Events is enabled. With Continue On Fail enabled, an item that fails contains an error and may include error details; otherwise the node raises an operation error. If the stream ends before its final response, content may be assembled from streamed tokens and marked with contentSource "tokens".

Links

Discussion