Data sources allow you to bring your own data to Griptape Cloud. They extract, ingest, and prepare your data so that it can be retrieved and used by LLMs.

Once you create a data source, the information it contains will automatically be extracted, transformed, and loaded into Griptape Cloud.

You can then add your data to knowledge bases that LLM-powered assistants and structures can access. Learn more

Knowledge bases are collections of data sources that applications can query to retrieve information.

To get started, first create a knowledge base and select the data source(s) that you want to include.

You can then configure an assistant to chat about your data, or deploy a structure to retrieve it. Learn more

Data lakes are repositories for storing data that needs to be processed or accessed.

For example, when you create a data source, Griptape Cloud stores your information in a data lake bucket. Every account starts with a default bucket.

You can also upload files directly to a data lake and add them to a knowledge base. In addition, you can download assets to examine their contents, or access them directly from your structure code.

To get started, simply upload a file to your bucket, then create a data source and select the corresponding file asset.

Buckets are the resource that represents an individual data lake. Data lakes are repositories for storing data that needs to be processed or accessed.

For example, when you create a data source, Griptape Cloud stores your information in a data lake bucket.

Every account starts with a default bucket. You can rename it, create additional buckets, and add subdirectories as needed to organize your data.

To get started, create a folder or upload a file. You can then create a data source and a knowledge base from your file.

Griptape structures are your code. They are Python agents, pipelines, and workflows that execute your application logic and use LLMs to perform tasks.

To create a structure, you can deploy your own code from a GitHub repository or get started quickly by deploying a structure from our sample repo.

You can run structures directly from the Griptape Cloud web console, via API, or through third party software applications. Learn more

Structure runs are individual executions of a structure.

Once you have created and deployed a structure, you can then run it by providing the necessary input arguments and environment variables.

After your run has completed, you can then view its output, logs, and other details.

Assistants are a special type of Griptape agent structure.

Use assistants to create a chatbot in less than a minute, without writing any code. They offer much of the same functionality provided by agent structures.

To get started, simply create an assistant and optionally add a knowledge base, ruleset, and tools. You can then begin chatting with your assistant by sending a message.

You can also query assistants directly via API, or integrate them into other software applications. Learn more

Assistant runs are individual executions of an assistant.

Once you have created an assistant, you can run it by sending messages. You can then view details for your runs, including sent and received messages and run configurations.

Threads contain the conversation history of messages sent to and from assistants or structures.

To get started, first create a thread and then select it when chatting with an assistant or running a structure. To start a fresh conversation, simply create and select a new thread.

You can return here any time to view the history of messages.

Messages are the inputs that you send to assistants, and the outputs that they send back to you.

Messages can be grouped together into conversation threads.

Rulesets guide the behavior of assistants and structures. Think of them as instructions or guidelines written in natural, conversational language. Rulesets are Griptape resources that contain one or more rules.

To get started, first create a ruleset and then add rules to it. Then, when you create an assistant or structure, you can add your ruleset to it.

Assistants and structures will apply these rules when generating responses to your messages.

Tools extend the capabilities of an LLM, for example to query external APIs, search the web, or perform calculations.

To get started, create a tool by selecting one of our sample tools or deploying your own structure to use it as a tool.

Once your tool has been deployed, you can then configure an assistant or structure to have access to use it.

Tool runs are individual executions of a tool.

Once you have created and deployed a tool, you can then provide it to a structure or assistant to use.

After your tool has been used, you can return here to view its inputs, outputs, logs, and other details.

Integrations enable you to run Griptape structures and assistants from within other software applications, without needing to write custom integration code.

For example, you can integrate a Griptape assistant into a Slack app to create a Griptape-powered Slackbot.

Secrets are encrypted key-value pairs that you can use to store API keys, authentication tokens, encryption keys, cloud provider access credentials, and database connection details.

To get started, create a secret and then enter a key and value for it.

You can then securely add secrets to structures as environment variables, so that you can use them without exposing sensitive information in your code.

Griptape API keys are used to authenticate requests to Griptape Cloud APIs.

For example, you can use them to search a knowledge base or to run a structure. Create and delete API keys to ensure your interactions are secure.

Note: You don’t need an API key to use the Griptape Cloud web console; simply log in with your Griptape Cloud account.