@zihin/piece-zihin
v0.6.2
Published
Activepieces piece for Zihin — invoke hosted agents over @zihin/agent-client.
Maintainers
Readme
@zihin/piece-zihin
Activepieces integration for invoking hosted Zihin.ai agents.
Setup
Install this package in an Activepieces deployment that supports custom pieces, then add
a Zihin connection using an API key from your account. Keep the key in the connection's
secret field. The default API URL is https://llm.zihin.ai.
Invoke Agent
Select an agent, provide a message and run the action. Reuse the returned sessionId to
continue a conversation. Optional fields include consumer identity, structured context,
tool bindings, session derivation, timeout and a UUID client message ID for retries.
Context is visible to the model and stored with the conversation. Bindings are intended for tool inputs. Never put credentials in either. Structured context, bindings and consumer identity require an admin or owner key. Unsupported requested fields fail explicitly.
Inspect contentSource, outcome, gated, acceptedFields and ignoredFields before
forwarding a result. contentSource: 'tokens' indicates incomplete intermediate output.
Human approval and gated results do not indicate completed work. Raw events are optional
debugging data and may contain intermediate content.
Use a new client message ID for each logical message. Retry with the same ID only for that message; completed-turn replay does not guarantee that interrupted work ran only once. Temperature and maximum-token fields are retained for saved workflows and have no effect.
Custom origins and HTTP require explicit opt-in. Use them only with a trusted deployment. See Zihin documentation for account and agent configuration.
License
MIT. See LICENSE.
