AWS S3

  # AWS S3 Integracja dla Botpress

Wykorzystaj moc AWS S3 bezpośrednio z chatbota Botpress . Ta integracja umożliwia zarządzanie zasobnikami i obiektami S3, wykonywanie operacji, takich jak tworzenie i usuwanie zasobników, przesyłanie i pobieranie plików i nie tylko.

## Spis treści
- Wprowadzenie](#introduction)
- [AWS S3 Konfiguracja i konfiguracja](#aws-s3-setup--configuration)
  - Wymagania wstępne](#prerequisites)
  - Włącz integrację](#enable-integration)
- Akcje](#actions)
  - Tworzenie zasobnika](#create-bucket)
  - Usuń wiadro](#delete-bucket)
  - Kopiowanie obiektu](#copy-object)
  - Usuń politykę wiadra](#delete-bucket-policy)
  - Usuń witrynę wiadra](#delete-bucket-website)
  - Usuń obiekt](#delete-object)
  - Usuń wiele obiektów](#delete-multiple-objects)
  - Pobierz obiekt](#get-object)
  - Lista obiektów V2](#list-objects-v2)
  - Prześlij obiekt](#upload-object)
  - Lista wiader](#list-buckets)
- Przypadki użycia](#use-cases)
- Obsługiwane zdarzenia](#supported-events)

## Wprowadzenie
Integracja AWS S3 dla Botpress umożliwia chatbotowi zarządzanie pamięcią masową cloud . Twórz, wyświetlaj i usuwaj zasobniki S3 oraz obsługuj pliki bezpośrednio przez chatbota. Ta integracja jest idealna do automatyzacji przepływów pracy cloud .

## AWS S3 Konfiguracja
### Wymagania wstępne
Przed włączeniem integracji Botpress AWS S3  należy upewnić się, że posiadasz następujące elementy:

- Wystąpienie serwera Botpress skonfigurowane lokalnie lub w witrynie cloud.
- Poświadczenia AWS z uprawnieniami dostępu do usług S3.

### Włącz integrację
Aby włączyć integrację AWS S3 w Botpress, wykonaj następujące kroki:

1. Uzyskaj dostęp do panelu administracyjnego Botpress .
2. Przejdź do sekcji "Integracje".
3. Znajdź integrację AWS S3 i kliknij "Włącz" lub "Konfiguruj".
4. Podaj wymagane `accessKeyId`, `secretAccessKey` i `region`.
5. Zapisz konfigurację.

## Akcje
Oto działania obsługiwane przez integrację AWS S3 :

### Create Bucket
Utworzenie nowego zasobnika S3.

### Delete Bucket
Usunięcie istniejącego zasobnika S3.

### Copy Object
Kopiowanie obiektu z jednego zasobnika S3 do innego.

### Usuń politykę zasobnika
Usuwanie zasad powiązanych z zasobnikiem S3.

### Usuń witrynę zasobnika
Usuwa konfigurację witryny dla zasobnika S3.

### Usuń obiekt
Usuwa określony obiekt z zasobnika S3.

### Usuń wiele obiektów
Zbiorcze usuwanie wielu obiektów z zasobnika S3.

### Get Object
Pobieranie określonego obiektu z zasobnika S3.

### List Objects V2
Lista obiektów w zasobniku S3 (wersja 2 operacji listy).

### Prześlij obiekt
Przesyłanie pliku/obiektu do zasobnika S3. *Uwaga: Obecnie ta funkcja jest w fazie rozwoju. Możemy zwrócić wstępnie podpisany adres URL, którego użytkownik może użyć za pomocą polecenia curl, aby wysłać plik do AWS S3. Czekamy na Botpress , aby umożliwić przesyłanie plików, a po wdrożeniu ta funkcja będzie w pełni użyteczna *.

### Lista wiader
Lista wszystkich dostępnych wiader S3.

## Przypadki użycia
Oto kilka typowych przypadków użycia integracji AWS S3 :

1. Pobieranie danych
   - Umożliwienie użytkownikom pobierania określonych plików przechowywanych w zasobniku S3.
   - Użyj akcji Get Object, aby pobrać pliki na podstawie danych wprowadzonych przez użytkownika.
   - Użyj akcji List Objects V2, aby wyświetlić dostępne pliki do wyboru przez użytkowników.

2. Zarządzanie zasobnikami
   - Umożliwienie użytkownikom tworzenia i usuwania zasobników za pośrednictwem interfejsu chatbota.
   - Użyj akcji Create Bucket, aby utworzyć nowe lokalizacje przechowywania.
   - Użyj akcji Delete Bucket, aby usunąć nieużywane lub puste zasobniki.
   - Użyj akcji List Buckets, aby wyświetlić wszystkie dostępne zasobniki do zarządzania.

3. Usuwanie obiektów
   - Zarządzanie i usuwanie określonych lub wielu obiektów z zasobnika S3.
   - Akcja Delete Object służy do usuwania pojedynczych plików na podstawie danych wprowadzonych przez użytkownika.
   - Użyj akcji Delete Multiple Objects, aby wykonać zbiorcze usuwanie dla operacji czyszczenia.

4. Migracja danych
   - Kopiowanie obiektów z jednego zasobnika do drugiego w celu migracji danych.
   - Użyj akcji Kopiuj obiekt, aby skopiować pliki z zasobnika źródłowego do zasobnika docelowego.
   - Użyj akcji List Buckets i List Objects V2, aby zweryfikować migrację.

5. Operacje czyszczenia
   - Regularne czyszczenie określonych obiektów lub całych zasobników.
   - Użyj akcji List Objects V2, aby zidentyfikować obiekty do usunięcia.
   - Użyj akcji Usuń obiekt lub Usuń wiele obiektów, aby usunąć niechciane pliki.
   - Użyj akcji Usuń zasobnik, aby usunąć puste zasobniki.

## Obsługiwane zdarzenia
Ta integracja nie obejmuje obecnie zdarzeń wyzwalanych na podstawie działań AWS S3 . Można jednak dostosować integrację do nasłuchiwania określonych powiadomień o zdarzeniach S3 za pośrednictwem AWS SNS (Simple Notification Service) lub innych usług AWS, które wyzwalają przepływy pracy w Botpress.