diff --git a/CHANGELOG.md b/CHANGELOG.md index 81300839ef..3f765700d5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -22,6 +22,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - `BaseRulesetDriver` for loading a `Ruleset` from an external source. - `LocalRulesetDriver` for loading a `Ruleset` from a local `.json` file. - `GriptapeCloudRulesetDriver` for loading a `Ruleset` resource from Griptape Cloud. +- Parameter `alias` on `GriptapeCloudConversationMemoryDriver` for fetching a Thread by alias. ### Changed - **BREAKING**: Renamed parameters on several classes to `client`: diff --git a/docs/griptape-cloud/index.md b/docs/griptape-cloud/index.md index 74a78eaf1f..74556ab621 100644 --- a/docs/griptape-cloud/index.md +++ b/docs/griptape-cloud/index.md @@ -8,5 +8,8 @@ Connect to your data with our [Data Sources](data-sources/create-data-source.md) ## Host and Run Your Code Have Griptape code? Have existing code with another LLM framework? You can host your Python code using [Structures](structures/create-structure.md) whether it uses the Griptape Framework or not. +## Store Configuration for LLM Agents +[Rules and Rulesets](rules/rulesets.md) enable rapid and collabortive iteration for managing LLM behavior. [Threads and Messages](threads/threads.md) allow for persisted and editable conversation memory across any LLM invocation. + ## APIs All of our features can be called via API with a [Griptape Cloud API Key](https://cloud.griptape.ai/configuration/api-keys). See the [API Reference](api/api-reference.md) for detailed information. diff --git a/docs/griptape-cloud/threads/threads.md b/docs/griptape-cloud/threads/threads.md new file mode 100644 index 0000000000..46f80a5868 --- /dev/null +++ b/docs/griptape-cloud/threads/threads.md @@ -0,0 +1,11 @@ +# Threads + +A [Thread can be created](https://cloud.griptape.ai/threads/create) to store conversation history across any LLM invocation. A Thread contains a list of [Messages](https://cloud.griptape.ai/messages/create). Messages can be updated and deleted, in order to control how the LLM recalls past conversations. + +A Thread can be given an `alias` so it can be referenced by a user-provided unique identifier: + +```bash +export GT_CLOUD_API_KEY= +export ALIAS= +curl -H "Authorization: Bearer ${GT_CLOUD_API_KEY}" https://cloud.griptape.ai/threads?alias=${ALIAS} +```