#AWS S3 との統合Botpress
Botpress チャットボットからAWS S3 のパワーを直接利用できます。この統合により、S3バケットとオブジェクトを管理し、バケットの作成と削除、ファイルのアップロードと取得などの操作を実行できます。
目次
- はじめに](#introduction) -AWS S3 セットアップと設定](#aws-s3-setup--configuration)
- 前提条件](#prerequisites)
- 統合を有効にする](#enable-integration)
- アクション](#actions)
- バケットの作成](#create-bucket)
- バケットの削除](#delete-bucket)
- オブジェクトのコピー](#copy-object)
- バケットポリシーの削除](#delete-bucket-policy)
- バケツウェブサイトの削除](#delete-bucket-website)
- オブジェクトの削除](#delete-object)
- 複数オブジェクトの削除](#delete-multiple-objects)
- オブジェクトの取得](#get-object)
- オブジェクトリストV2](#list-objects-v2)
- オブジェクトのアップロード](#upload-object)
- リストバケット](#list-buckets)
- ユースケース](#use-cases)
- サポートされるイベント](#supported-events)
はじめに
Botpress 用のAWS S3 インテグレーションは、チャットボットがcloud ストレージを管理できるようにします。S3バケットを作成、リストアップ、削除し、チャットボットで直接ファイルを処理できます。このインテグレーションはcloud ワークフローの自動化に最適です。
AWS S3 セットアップと設定
前提条件
Botpress AWS S3 インテグレーションを有効にする前に、以下を確認してください:
-Botpress サーバーインスタンスがローカルまたはcloud にセットアップされていること。
- S3 サービスにアクセスする権限を持つ AWS 認証情報。
統合の有効化
Botpress でAWS S3 の統合を有効にするには、以下の手順に従う:
1.Botpress 管理パネルにアクセスします。
2.統合」セクションに移動します。
3.AWS S3 の統合を探し、"有効化 "または "設定 "をクリックします。
4.必要な accessKeyId
、secretAccessKey
、region
を入力する。
5.設定を保存する。
アクション
以下はAWS S3 の統合でサポートされるアクションである:
バケットの作成
新しいS3バケットを作成する。
バケットの削除
既存のS3バケットを削除します。
オブジェクトのコピー
ある S3 バケットから別の S3 バケットにオブジェクトをコピーします。
バケットポリシーの削除
S3 バケットに関連付けられたポリシーを削除します。
バケットウェブサイトの削除
S3バケットのウェブサイト設定を削除します。
オブジェクトの削除
S3バケットから特定のオブジェクトを削除します。
複数オブジェクトの削除
S3バケットから複数のオブジェクトを一括削除します。
オブジェクトの取得
S3バケットから特定のオブジェクトを取得する。
List Objects V2
S3バケット内のオブジェクトをリストアップする(リスト操作のバージョン2)。
オブジェクトのアップロード
ファイル/オブジェクトをS3バケットにアップロードする。注:現在、この機能は開発中です。ユーザがファイルをAWS S3 に送信するために curl コマンドで使用できる、事前に署名された URL を返すことができます。Botpress がファイルアップロードを許可するようになるのを待っています。実装されれば、この機能は完全に使用できるようになります。
バケット一覧
利用可能なS3バケットをすべてリストアップします。
使用例
以下はAWS S3 の統合に関する一般的な使用例です:
1.データ検索
- ユーザーがS3バケットに保存されている特定のファイルを取得できるようにする。
- ユーザー入力に基づいてファイルを取得するには、Get Objectsアクションを使用します。
- List Objects V2アクションを使用して、ユーザーが選択できるように利用可能なファイルを表示する。
2.バケット管理
- チャットボットのインターフェイスを通じて、ユーザーがバケットを作成・削除できるようにします。
- 新しい保存場所を作成するには、「Create Bucket」アクションを使用します。
- Delete Bucketアクションを使用して、未使用または空のバケットを削除します。
- 管理可能なバケットをすべて表示するには、「List Buckets」アクションを使用します。
3.オブジェクトの削除
- S3バケットから特定または複数のオブジェクトを管理・削除します。
- Delete Objectアクションを使用し、ユーザー入力に基づいて個々のファイルを削除する。
- クリーンアップのために一括削除を行うには、Delete Multiple Objectsアクションを使用します。
4.データ移行
- データ移行を目的として、ある Bucket から別の Bucket へオブジェクトをコピーします。
- Copy Object アクションを使って、コピー元の Bucket からコピー先の Bucket にファイルをコピーします。
- List Buckets と List Objects V2 アクションを使って、移行を確認します。
5.クリーンアップ操作
- 特定のオブジェクトやバケット全体を定期的にクリーンアップします。
- List Objects V2 アクションを使用して、削除するオブジェクトを特定します。
- 不要なファイルを削除するには、Delete Objects アクションまたは Delete Multiple Objects アクションを使用します。
- 空のバケツを削除するには、Delete Bucket アクションを使用します。
サポートされるイベント
この統合には現在、AWS S3 のアクティビティに基づいてトリガーされるイベントは含まれていません。しかし、AWS SNS (Simple Notification Service) やBotpress のワークフローをトリガーする他の AWS サービスを介して、特定の S3 イベント通知をリッスンするように統合をカスタマイズすることができます。