Griptape Retrieve: Cloud Ruleset

Rulesets are how you stamp a personality and constraints onto a Griptape agent. This node loads one of yours from Griptape Cloud by ID, which matters a lot more than it sounds like it should.

The use case: you've got a carefully tuned ruleset - tone, format, guardrails - and you don't want to rebuild it in every ComfyUI workflow, on every machine, every time a teammate changes it. Store it once in Griptape Cloud, and this node pulls the current version at run time. Change it in the cloud, every workflow that references it picks up the change. It's the "don't copy-paste your system prompt" node, and teams love it.

How it works

The node takes a ruleset_id, constructs a GriptapeCloudRulesetDriver for that ID, and returns the resulting Ruleset as a RULES output (RULESET type). That output wires straight into an agent's rulesets input, or into Griptape Replace: Rulesets on Agent, or into a ruleset combine node.

If the ID field is empty, the node politely does nothing - it prints a warning and returns nothing rather than crashing, which is handy when you're building a graph before you have an ID handy.

The inputs

There's exactly one: ruleset_id, the string ID of your cloud ruleset (something like xxxx-xxxx-xxxx-xxxx). Output is the RULES ruleset.

Installing

Part of the ComfyUI-Griptape pack - ComfyUI Manager → search "Griptape" → Install, or:

cd ComfyUI/custom_nodes
git clone https://github.com/griptape-ai/ComfyUI-Griptape

Restart ComfyUI. Deps are griptape[all] and python-dotenv; first install is heavy.

You'll also need a Griptape Cloud account and a GT_CLOUD_API_KEY (https://cloud.griptape.ai/configuration/api-keys). Set it in the sidebar Settings → Griptape, or in your environment - the pack's python-dotenv support means a .env file works too. The ruleset itself is created in Griptape Cloud, where you'll find its ID.

Common gotchas

The "empty ID" failure mode is a silent no-op, so if nothing shows up, check the ID before anything else - copy-paste errors here give you no error at all. And if you get auth failures, it's the key, not the ruleset: verify GT_CLOUD_API_KEY is set in the right place (settings file beats env if you set both, since the pack reads settings first).

Then the pack-wide usuals: torch version conflicts on Nvidia (reinstall with the cu121 index) and stale-griptape ImportErrors fixed with python -m pip install griptape -U.