Activepieces

Invoke Zihin agents from Activepieces with the Zihin piece. The Invoke Agent action calls a hosted agent (over @zihin/agent-client) and returns the result.

info

@zihin/piece-zihin is published on npm; the Activepieces marketplace listing is in progress. Self-hosted instances can install the piece from npm today (Settings → Pieces → Install).

Connect your account

Add the Zihin piece and create a connection:

Field	Description
API Key	zhn_live_* / zhn_test_* from Settings → API Keys (the tenant is embedded).
Base URL	Defaults to https://llm.zihin.ai. Override only for a private deployment.
Allow custom base URL	Off by default. Enable only to target a base URL outside the Zihin domain whitelist — your key is sent there.
Allow HTTP / localhost	Development only.

The connection is validated by listing your agents.

Action: Invoke Agent

Field	Description
Agent	The agent to invoke — loaded from your tenant (dropdown).
Message	The input sent to the agent.
Session ID	Reuse to continue a conversation; the output returns the session ID.
Temperature / Max Tokens / Timeout	Optional generation and call controls.
Include Raw Events	Include the raw SSE events in the output (debugging).

Output: { content, sessionId, model, usage, sources }.

Example

[Trigger] → [Zihin · Invoke Agent] → [Next step]

1. Create a Zihin connection (above).
2. Add Zihin → Invoke Agent, pick the Agent, and map the Message from the trigger.
3. Use content downstream; pass sessionId back on the next run for continuity.

tip

Activepieces pieces declare their dependencies, so the Zihin piece consumes @zihin/agent-client directly — the same governed invocation as every other connector.