このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。
概要
ほとんどのプラグインツールとエンドポイントは、ステートレスな単一ラウンドのインタラクションモデルで動作します:- リクエストを受信
- データを処理
- レスポンスを返却
- インタラクションを終了
永続ストレージを使用すると、プラグインは同じワークスペース内でインタラクションをまたいでデータを保存でき、ステートフルなアプリケーションやメモリ機能を実現できます。
ストレージへのアクセス
すべてのストレージ操作は、プラグインのセッションで利用可能なstorage オブジェクトを通じて実行されます:
ストレージ操作
データの保存
set メソッドでデータを保存します:
例:さまざまなデータ型の保存
データの取得
get メソッドで保存されたデータを取得します:
例:データの取得と変換
データの削除
delete メソッドで保存されたデータを削除します:
ベストプラクティス
説明的なキーを使用する
競合を避け、コードをより保守しやすくするために、キーに一貫した命名規則を作成してください。
欠損キーを処理する
キーが見つからない可能性があるため、処理前にデータが存在するかどうかを常に確認してください。
複雑なデータをシリアライズする
保存前に複雑なオブジェクトをJSONまたは他のシリアライズ形式に変換してください。
エラーハンドリングを実装する
潜在的なエラーを適切に処理するために、ストレージ操作をtry/exceptブロックでラップしてください。
一般的なユースケース
- ユーザー設定:セッション間でユーザーの設定やプリファレンスを保存します。
- 会話履歴:以前の会話からのコンテキストを維持します。
- API トークン:認証トークンを安全に保存します。
- キャッシュデータ:API 呼び出しを減らすために頻繁にアクセスされるデータを保存します。
- ファイルストレージ:ユーザーがアップロードしたファイルや生成されたコンテンツを保存します。