テキスト保存 (SaveText)
概要 (What is it?)
SaveText は、テキストコンテンツをローカルシステム上のファイルに保存するためのユーティリティノードです。カスタマイズ可能な出力パスを指定して、ディスクにテキストデータを書き出すシンプルなインターフェースを提供します。
使用する場面 (When would I use it?)
以下のような場面でこのノードを使用します：
- 生成されたテキストコンテンツをファイルに保存したい場合
- ワークフローの実行結果をテキストファイルとしてエクスポートしたい場合
- 会話ログや出力を後で参照できるように保存したい場合
- 自動化ワークフローの一部としてテキストファイルを生成したい場合
- ワークフローの実行間でデータを永続化したい場合
使い方 (How to use it)
基本セットアップ
- ワークフローに SaveText ノードを追加します
- "text" 入力にテキストソースを接続するか、直接テキストを入力します
- 出力パスを指定するか、デフォルト値を使用します
- ワークフローを実行して、指定したファイルにテキストを保存します
パラメータ一覧 (Parameters)
- text: ファイルに保存したいテキストコンテンツ（複数行テキスト対応）
- output_path: テキストが保存されるファイルパス（デフォルト: "griptape_output.txt"）
出力 (Outputs)
- output_path: 保存されたファイルのパス（保存処理が正常に完了したことを確認可能）
使用例 (Example)
AI エージェントの出力をテキストファイルに保存したい場合の例：
- ワークフローに Agent ノードを追加します
- テキストを生成するプロンプトをエージェントに設定します
- SaveText ノードを追加します
- Agent の "output" を SaveText の "text" 入力に接続します
- "output_path" を "my_agent_response.txt" に設定します
- ワークフローを実行します
- エージェントの応答がローカルシステムの "my_agent_response.txt" に保存されます
重要な注意点 (Important Notes)
- ファイルが存在しない場合は新規作成され、既に存在する場合は上書きされます
- output_path パラメータには、ファイル選択を容易にするための保存ボタンが UI 上に用意されています
- 出力ファイルには相対パスまたは絶対パスのどちらも使用できます
- 必要な親ディレクトリが存在しない場合、自動的に作成されます
- テキストは UTF-8 エンコーディングで保存されます
よくある問題 (Common Issues)
- アクセス権限エラー: 指定したディレクトリに対する書き込み権限があることを確認してください
- 無効なパス: お使いの OS に適した有効なファイルパスであることを確認してください
- ファイルの上書き: 既存のファイルは確認ダイアログなしで上書きされるためご注意ください