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.

Rolling out

The Zihin piece is being published to the Activepieces marketplace. The steps below describe the connector once it's listed.

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.