Griptape Run: Cloud Assistant
Run an assistant you built in Griptape Cloud
- assistant
- key_value_replacement
- OUTPUT
- ASSISTANT
If your team already builds assistants in Griptape Cloud, this is the bridge: Griptape Run: Cloud Assistant takes one of those hosted assistants - with all its tools, memory, and rules configured in the cloud - and runs it from inside ComfyUI, passing in arguments and getting text back.
This is the "production" cousin of Griptape Run: Agent. Instead of assembling the whole agent in the node graph, the heavy lifting lives in Griptape Cloud, and ComfyUI is just the caller. That's the right architecture when you want the assistant's behavior managed by non-ComfyUI people, or versioned and shared across many workflows. It's also the one node in this pack that's effectively useless without a Griptape Cloud account, so know what you're signing up for.
How it works
The node uses Griptape Cloud's assistant driver plus a cloud-backed conversation memory, so each run gets a thread - the assistant remembers prior turns on the same thread. You point it at an assistant by ID or connect an ASSISTANT object from a previous run. Your STRING input becomes the arguments passed to the structure, and split_input_into_args (default on) splits that input on newlines into separate arguments.
key_value_replacement fills {{ key }} placeholders as elsewhere in the pack. Outputs are OUTPUT (the reply) and ASSISTANT, which you can chain into another Cloud Assistant node to continue the conversation.
The inputs
- assistant - an
ASSISTANTfrom a previous run. If you use this,assistant_idis ignored. - assistant_id - the ID of the assistant to run, when nothing is connected.
- STRING - input arguments for the structure.
- split_input_into_args - whether to split
STRINGinto separate args per newline. - input_string / key_value_replacement - appendix and template fill.
Outputs: OUTPUT (STRING) and ASSISTANT.
Installing
ComfyUI Manager → search "Griptape" → Install, or:
cd ComfyUI/custom_nodes
git clone https://github.com/griptape-ai/ComfyUI-Griptape
Restart ComfyUI. You'll need a GT_CLOUD_API_KEY from https://cloud.griptape.ai/configuration/api-keys, set in sidebar Settings → Griptape or your environment.
Common gotchas
The most common failure is wiring nothing into assistant or assistant_id - the node needs one of the two. If you get auth errors, it's the GT_CLOUD_API_KEY. And if your assistant doesn't behave like it does in the cloud console, check split_input_into_args; newline-splitting can mangle a single-line prompt into multiple args.
Plus 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.
Inputs (6)
| Name | Type | Default | Description |
|---|---|---|---|
| assistantopt | ASSISTANT | An existing assistant to use. If not provided, an assistant_id must be specified. | |
| assistant_idopt | STRING | The id of your assistant to run. If an assistant is connect, this will be ignored. | |
| split_input_into_argsopt | BOOLEAN | true | If enabled, the input string will be split into separate arguments by newline. |
| input_stringopt | STRING | Additional text be appended to the STRING with a newline character. | |
| key_value_replacementopt | DICT | The will replace the {{ key }} with a value. | |
| STRINGopt | STRING | Specify input arguments that will be passed to the structure during execution. |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| OUTPUT | STRING | Text response from the Agent |
| ASSISTANT | ASSISTANT | The Assistant. Can be connected to other nodes. |