Griptape Tool: Griptape Cloud KnowledgeBase

The Griptape Cloud KnowledgeBase tool is the "I don't want to run my own vector database" answer to RAG. If you've been through the ComfyUI rite of passage of wiring up a local vector store - installing one more database, picking an embedding model, watching it all break when a dependency bumps - this node is the relief valve. You upload your documents to a knowledge base on Griptape's cloud (https://cloud.griptape.ai), paste in the knowledge base ID, and the tool gives your agent retrieval over that content without you hosting anything.

There's a real trade to name here, because the pack gives you both paths. This tool is fully managed: you pay Griptape Cloud for hosting and retrieval, and your documents live on their servers. The alternative - the VectorStore tool plus a self-hosted vector store driver - keeps everything local but puts the ops burden on you. If you're building for yourself and your data is sensitive, that trade matters. If you just want a working RAG pipeline in an afternoon, this is the one.

How it works

The node does more than pass a config around - it actually calls Griptape's API at graph time. It hits GET {base_url}/api/knowledge-bases/{knowledge_base_id} with your API key to fetch the knowledge base's name and description, then builds a RagTool wired to a GriptapeCloudVectorStoreDriver. When the agent asks it something, retrieval happens server-side against your uploaded documents, and the agent gets a grounded answer. All you need to have done is uploaded content to the knowledge base in the cloud console first.

The inputs that matter

• knowledge_base_id - the ID of your cloud knowledge base. The default value (12345-abcde-1434) is a placeholder; paste in the real one or every request will 404.
• api_key_environment_variable - default GT_CLOUD_API_KEY. The name of the env var holding your key, never the key itself. Get the key from https://cloud.griptape.ai/configuration/api-keys.
• base_url - default https://cloud.griptape.ai. Leave it unless you're pointed at a different deployment.
• off_prompt - default False. Same privacy/cost toggle as the rest of the pack; off-prompt True keeps retrieved chunks out of the main context.

One output, TOOL (TOOL_LIST), feeds an agent.

Install

Standard pack install:

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

or ComfyUI Manager → search "Griptape" → install → restart. Then set GT_CLOUD_API_KEY in Settings → Griptape (or your environment).

Where people get burned

Three things. First, the placeholder ID - forget to replace it and you'll see the API call fail with a 404. Second, the knowledge base has to actually exist and be populated in the cloud console before the node runs; the tool can only retrieve what you've uploaded. Third, remember this is a paid cloud service and your data leaves your machine - the trade is real. If none of that appeals, the local VectorStore tool is your alternative, and you won't have to fight a remote dependency. But if you're prototyping RAG or just want it to work, this is hard to beat for setup effort.