Nodes/ComfyUI Griptape Nodes/Griptape Run: Cloud Assistant
ComfyUI Node

Griptape Run: Cloud Assistant

Run an assistant you built in Griptape Cloud

By griptape-ai·Created 2 years ago·Updated about a year ago· 238
Griptape Run: Cloud Assistant
  • assistant
  • key_value_replacement
  • OUTPUT
  • ASSISTANT
assistant_id
split_input_into_argstrue
input_string
STRING

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 ASSISTANT from a previous run. If you use this, assistant_id is 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 STRING into 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.

CategoryGriptape/Agent

Inputs (6)

NameTypeDefaultDescription
assistantoptASSISTANTAn existing assistant to use. If not provided, an assistant_id must be specified.
assistant_idoptSTRINGThe id of your assistant to run. If an assistant is connect, this will be ignored.
split_input_into_argsoptBOOLEANtrueIf enabled, the input string will be split into separate arguments by newline.
input_stringoptSTRINGAdditional text be appended to the STRING with a newline character.
key_value_replacementoptDICTThe will replace the {{ key }} with a value.
STRINGoptSTRINGSpecify input arguments that will be passed to the structure during execution.

Outputs (2)

NameTypeDescription
OUTPUTSTRINGText response from the Agent
ASSISTANTASSISTANTThe Assistant. Can be connected to other nodes.