diff --git a/apps/docs/content/docs/de/tools/gmail.mdx b/apps/docs/content/docs/de/tools/gmail.mdx index e6714373f..9557ba20a 100644 --- a/apps/docs/content/docs/de/tools/gmail.mdx +++ b/apps/docs/content/docs/de/tools/gmail.mdx @@ -65,8 +65,9 @@ E-Mails über Gmail versenden | `to` | string | Ja | E-Mail-Adresse des Empfängers | | `subject` | string | Ja | Betreff der E-Mail | | `body` | string | Ja | Inhalt der E-Mail | -| `cc` | string | Nein | CC-Empfänger \(durch Komma getrennt\) | -| `bcc` | string | Nein | BCC-Empfänger \(durch Komma getrennt\) | +| `cc` | string | Nein | CC-Empfänger (durch Komma getrennt) | +| `bcc` | string | Nein | BCC-Empfänger (durch Komma getrennt) | +| `attachments` | file[] | Nein | Dateien, die an die E-Mail angehängt werden sollen | #### Ausgabe @@ -86,8 +87,9 @@ E-Mail-Entwürfe in Gmail erstellen | `to` | string | Ja | E-Mail-Adresse des Empfängers | | `subject` | string | Ja | Betreff der E-Mail | | `body` | string | Ja | Inhalt der E-Mail | -| `cc` | string | Nein | CC-Empfänger \(durch Komma getrennt\) | -| `bcc` | string | Nein | BCC-Empfänger \(durch Komma getrennt\) | +| `cc` | string | Nein | CC-Empfänger (durch Komma getrennt) | +| `bcc` | string | Nein | BCC-Empfänger (durch Komma getrennt) | +| `attachments` | file[] | Nein | Dateien, die an den E-Mail-Entwurf angehängt werden sollen | #### Ausgabe diff --git a/apps/docs/content/docs/de/tools/s3.mdx b/apps/docs/content/docs/de/tools/s3.mdx index 66baf3e18..b6f054d1a 100644 --- a/apps/docs/content/docs/de/tools/s3.mdx +++ b/apps/docs/content/docs/de/tools/s3.mdx @@ -1,6 +1,6 @@ --- title: S3 -description: S3-Dateien anzeigen +description: S3-Dateien hochladen, herunterladen, auflisten und verwalten --- import { BlockInfoCard } from "@/components/ui/block-info-card" @@ -61,10 +61,35 @@ In Sim ermöglicht die S3-Integration Ihren Agenten das Abrufen und Zugreifen au ## Gebrauchsanweisung -S3 in den Workflow integrieren. Kann vorsignierte URLs für S3-Objekte erhalten. Erfordert Zugriffsschlüssel und geheimen Zugriffsschlüssel. +S3 in den Workflow integrieren. Dateien hochladen, Objekte herunterladen, Bucket-Inhalte auflisten, Objekte löschen und Objekte zwischen Buckets kopieren. Erfordert AWS-Zugriffsschlüssel und geheimen Zugriffsschlüssel. ## Tools +### `s3_put_object` + +Eine Datei in einen AWS S3-Bucket hochladen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | Ja | Ihre AWS-Zugriffsschlüssel-ID | +| `secretAccessKey` | string | Ja | Ihr AWS-geheimer Zugriffsschlüssel | +| `region` | string | Ja | AWS-Region (z. B. us-east-1) | +| `bucketName` | string | Ja | S3-Bucket-Name | +| `objectKey` | string | Ja | Objektschlüssel/Pfad in S3 (z. B. ordner/dateiname.ext) | +| `file` | file | Nein | Hochzuladende Datei | +| `content` | string | Nein | Hochzuladender Textinhalt (Alternative zur Datei) | +| `contentType` | string | Nein | Content-Type-Header (wird automatisch aus der Datei erkannt, wenn nicht angegeben) | +| `acl` | string | Nein | Zugriffskontrollliste (z. B. private, public-read) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `url` | string | URL des hochgeladenen S3-Objekts | +| `metadata` | object | Upload-Metadaten einschließlich ETag und Speicherort | + ### `s3_get_object` Ein Objekt aus einem AWS S3-Bucket abrufen @@ -73,8 +98,8 @@ Ein Objekt aus einem AWS S3-Bucket abrufen | Parameter | Typ | Erforderlich | Beschreibung | | --------- | ---- | -------- | ----------- | -| `accessKeyId` | string | Ja | Ihre AWS Access Key ID | -| `secretAccessKey` | string | Ja | Ihr AWS Secret Access Key | +| `accessKeyId` | string | Ja | Ihre AWS-Zugriffsschlüssel-ID | +| `secretAccessKey` | string | Ja | Ihr AWS-geheimer Zugriffsschlüssel | | `s3Uri` | string | Ja | S3-Objekt-URL | #### Ausgabe @@ -84,6 +109,73 @@ Ein Objekt aus einem AWS S3-Bucket abrufen | `url` | string | Vorsignierte URL zum Herunterladen des S3-Objekts | | `metadata` | object | Dateimetadaten einschließlich Typ, Größe, Name und Datum der letzten Änderung | +### `s3_list_objects` + +Objekte in einem AWS S3-Bucket auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | Ja | Ihre AWS Access Key ID | +| `secretAccessKey` | string | Ja | Ihr AWS Secret Access Key | +| `region` | string | Ja | AWS-Region (z.B. us-east-1) | +| `bucketName` | string | Ja | S3-Bucket-Name | +| `prefix` | string | Nein | Präfix zum Filtern von Objekten (z.B. ordner/) | +| `maxKeys` | number | Nein | Maximale Anzahl zurückzugebender Objekte (Standard: 1000) | +| `continuationToken` | string | Nein | Token für Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `objects` | array | Liste der S3-Objekte | + +### `s3_delete_object` + +Ein Objekt aus einem AWS S3-Bucket löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | Ja | Ihre AWS Access Key ID | +| `secretAccessKey` | string | Ja | Ihr AWS Secret Access Key | +| `region` | string | Ja | AWS-Region (z.B. us-east-1) | +| `bucketName` | string | Ja | S3-Bucket-Name | +| `objectKey` | string | Ja | Objekt-Schlüssel/Pfad zum Löschen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `deleted` | boolean | Ob das Objekt erfolgreich gelöscht wurde | +| `metadata` | object | Löschmetadaten | + +### `s3_copy_object` + +Ein Objekt innerhalb von oder zwischen AWS S3-Buckets kopieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | Ja | Ihre AWS Access Key ID | +| `secretAccessKey` | string | Ja | Ihr AWS Secret Access Key | +| `region` | string | Ja | AWS-Region (z.B. us-east-1) | +| `sourceBucket` | string | Ja | Name des Quell-Buckets | +| `sourceKey` | string | Ja | Quell-Objektschlüssel/-pfad | +| `destinationBucket` | string | Ja | Name des Ziel-Buckets | +| `destinationKey` | string | Ja | Ziel-Objektschlüssel/-pfad | +| `acl` | string | Nein | Zugriffskontrollliste für das kopierte Objekt (z.B. private, public-read) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `url` | string | URL des kopierten S3-Objekts | +| `metadata` | object | Metadaten des Kopiervorgangs | + ## Hinweise - Kategorie: `tools` diff --git a/apps/docs/content/docs/es/tools/gmail.mdx b/apps/docs/content/docs/es/tools/gmail.mdx index 622299d0a..4ad45679b 100644 --- a/apps/docs/content/docs/es/tools/gmail.mdx +++ b/apps/docs/content/docs/es/tools/gmail.mdx @@ -65,8 +65,9 @@ Enviar correos electrónicos usando Gmail | `to` | string | Sí | Dirección de correo electrónico del destinatario | | `subject` | string | Sí | Asunto del correo electrónico | | `body` | string | Sí | Contenido del cuerpo del correo electrónico | -| `cc` | string | No | Destinatarios en CC \(separados por comas\) | -| `bcc` | string | No | Destinatarios en CCO \(separados por comas\) | +| `cc` | string | No | Destinatarios en CC (separados por comas) | +| `bcc` | string | No | Destinatarios en CCO (separados por comas) | +| `attachments` | file[] | No | Archivos para adjuntar al correo electrónico | #### Salida @@ -86,8 +87,9 @@ Crear borradores de correos electrónicos usando Gmail | `to` | string | Sí | Dirección de correo electrónico del destinatario | | `subject` | string | Sí | Asunto del correo electrónico | | `body` | string | Sí | Contenido del cuerpo del correo electrónico | -| `cc` | string | No | Destinatarios en CC \(separados por comas\) | -| `bcc` | string | No | Destinatarios en CCO \(separados por comas\) | +| `cc` | string | No | Destinatarios en CC (separados por comas) | +| `bcc` | string | No | Destinatarios en CCO (separados por comas) | +| `attachments` | file[] | No | Archivos para adjuntar al borrador del correo electrónico | #### Salida diff --git a/apps/docs/content/docs/es/tools/s3.mdx b/apps/docs/content/docs/es/tools/s3.mdx index b94fecd35..b27d74c82 100644 --- a/apps/docs/content/docs/es/tools/s3.mdx +++ b/apps/docs/content/docs/es/tools/s3.mdx @@ -1,6 +1,6 @@ --- title: S3 -description: Ver archivos S3 +description: Subir, descargar, listar y gestionar archivos S3 --- import { BlockInfoCard } from "@/components/ui/block-info-card" @@ -61,20 +61,45 @@ En Sim, la integración con S3 permite a tus agentes recuperar y acceder a archi ## Instrucciones de uso -Integrar S3 en el flujo de trabajo. Puede obtener URLs prefirmadas para objetos S3. Requiere clave de acceso y clave de acceso secreta. +Integra S3 en el flujo de trabajo. Sube archivos, descarga objetos, lista contenidos de buckets, elimina objetos y copia objetos entre buckets. Requiere clave de acceso AWS y clave de acceso secreta. ## Herramientas -### `s3_get_object` +### `s3_put_object` -Recuperar un objeto de un bucket de AWS S3 +Subir un archivo a un bucket de AWS S3 #### Entrada | Parámetro | Tipo | Obligatorio | Descripción | -| --------- | ---- | ---------- | ----------- | -| `accessKeyId` | string | Sí | Tu ID de clave de acceso de AWS | -| `secretAccessKey` | string | Sí | Tu clave de acceso secreta de AWS | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | Sí | Tu ID de clave de acceso AWS | +| `secretAccessKey` | string | Sí | Tu clave de acceso secreta AWS | +| `region` | string | Sí | Región AWS (ej., us-east-1) | +| `bucketName` | string | Sí | Nombre del bucket S3 | +| `objectKey` | string | Sí | Clave/ruta del objeto en S3 (ej., carpeta/archivo.ext) | +| `file` | file | No | Archivo para subir | +| `content` | string | No | Contenido de texto para subir (alternativa al archivo) | +| `contentType` | string | No | Cabecera Content-Type (autodetectada del archivo si no se proporciona) | +| `acl` | string | No | Lista de control de acceso (ej., private, public-read) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `url` | string | URL del objeto S3 subido | +| `metadata` | object | Metadatos de subida incluyendo ETag y ubicación | + +### `s3_get_object` + +Recuperar un objeto de un bucket AWS S3 + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | Sí | Tu ID de clave de acceso AWS | +| `secretAccessKey` | string | Sí | Tu clave de acceso secreta AWS | | `s3Uri` | string | Sí | URL del objeto S3 | #### Salida @@ -84,6 +109,73 @@ Recuperar un objeto de un bucket de AWS S3 | `url` | string | URL prefirmada para descargar el objeto S3 | | `metadata` | object | Metadatos del archivo incluyendo tipo, tamaño, nombre y fecha de última modificación | +### `s3_list_objects` + +Listar objetos en un bucket de AWS S3 + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ---------- | ----------- | +| `accessKeyId` | string | Sí | Tu ID de clave de acceso de AWS | +| `secretAccessKey` | string | Sí | Tu clave de acceso secreta de AWS | +| `region` | string | Sí | Región de AWS (p. ej., us-east-1) | +| `bucketName` | string | Sí | Nombre del bucket S3 | +| `prefix` | string | No | Prefijo para filtrar objetos (p. ej., carpeta/) | +| `maxKeys` | number | No | Número máximo de objetos a devolver (predeterminado: 1000) | +| `continuationToken` | string | No | Token para paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `objects` | array | Lista de objetos S3 | + +### `s3_delete_object` + +Eliminar un objeto de un bucket de AWS S3 + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ---------- | ----------- | +| `accessKeyId` | string | Sí | Tu ID de clave de acceso de AWS | +| `secretAccessKey` | string | Sí | Tu clave de acceso secreta de AWS | +| `region` | string | Sí | Región de AWS (p. ej., us-east-1) | +| `bucketName` | string | Sí | Nombre del bucket S3 | +| `objectKey` | string | Sí | Clave/ruta del objeto a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `deleted` | boolean | Indica si el objeto fue eliminado correctamente | +| `metadata` | object | Metadatos de la eliminación | + +### `s3_copy_object` + +Copiar un objeto dentro de o entre buckets de AWS S3 + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ---------- | ----------- | +| `accessKeyId` | string | Sí | Tu ID de clave de acceso de AWS | +| `secretAccessKey` | string | Sí | Tu clave de acceso secreta de AWS | +| `region` | string | Sí | Región de AWS (p. ej., us-east-1) | +| `sourceBucket` | string | Sí | Nombre del bucket de origen | +| `sourceKey` | string | Sí | Clave/ruta del objeto de origen | +| `destinationBucket` | string | Sí | Nombre del bucket de destino | +| `destinationKey` | string | Sí | Clave/ruta del objeto de destino | +| `acl` | string | No | Lista de control de acceso para el objeto copiado (p. ej., private, public-read) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `url` | string | URL del objeto S3 copiado | +| `metadata` | object | Metadatos de la operación de copia | + ## Notas - Categoría: `tools` diff --git a/apps/docs/content/docs/fr/tools/gmail.mdx b/apps/docs/content/docs/fr/tools/gmail.mdx index dd18bb2d2..70d5e4740 100644 --- a/apps/docs/content/docs/fr/tools/gmail.mdx +++ b/apps/docs/content/docs/fr/tools/gmail.mdx @@ -62,12 +62,13 @@ Envoyer des e-mails via Gmail #### Entrée | Paramètre | Type | Obligatoire | Description | -| --------- | ---- | -------- | ----------- | +| --------- | ---- | ---------- | ----------- | | `to` | chaîne | Oui | Adresse e-mail du destinataire | | `subject` | chaîne | Oui | Objet de l'e-mail | | `body` | chaîne | Oui | Contenu du corps de l'e-mail | | `cc` | chaîne | Non | Destinataires en CC \(séparés par des virgules\) | | `bcc` | chaîne | Non | Destinataires en BCC \(séparés par des virgules\) | +| `attachments` | fichier[] | Non | Fichiers à joindre à l'e-mail | #### Sortie @@ -83,12 +84,13 @@ Créer des brouillons d'e-mails avec Gmail #### Entrée | Paramètre | Type | Obligatoire | Description | -| --------- | ---- | -------- | ----------- | +| --------- | ---- | ---------- | ----------- | | `to` | chaîne | Oui | Adresse e-mail du destinataire | | `subject` | chaîne | Oui | Objet de l'e-mail | | `body` | chaîne | Oui | Contenu du corps de l'e-mail | | `cc` | chaîne | Non | Destinataires en CC \(séparés par des virgules\) | | `bcc` | chaîne | Non | Destinataires en BCC \(séparés par des virgules\) | +| `attachments` | fichier[] | Non | Fichiers à joindre au brouillon d'e-mail | #### Sortie diff --git a/apps/docs/content/docs/fr/tools/s3.mdx b/apps/docs/content/docs/fr/tools/s3.mdx index 29de9640a..2aa67373e 100644 --- a/apps/docs/content/docs/fr/tools/s3.mdx +++ b/apps/docs/content/docs/fr/tools/s3.mdx @@ -1,6 +1,6 @@ --- title: S3 -description: Afficher les fichiers S3 +description: Téléverser, télécharger, lister et gérer les fichiers S3 --- import { BlockInfoCard } from "@/components/ui/block-info-card" @@ -61,10 +61,35 @@ Dans Sim, l'intégration S3 permet à vos agents de récupérer et d'accéder au ## Instructions d'utilisation -Intégrer S3 dans le flux de travail. Peut obtenir des URL présignées pour les objets S3. Nécessite une clé d'accès et une clé d'accès secrète. +Intégrez S3 dans le flux de travail. Téléversez des fichiers, téléchargez des objets, listez le contenu des buckets, supprimez des objets et copiez des objets entre buckets. Nécessite une clé d'accès AWS et une clé d'accès secrète AWS. ## Outils +### `s3_put_object` + +Téléverser un fichier vers un bucket AWS S3 + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | Oui | Votre ID de clé d'accès AWS | +| `secretAccessKey` | string | Oui | Votre clé d'accès secrète AWS | +| `region` | string | Oui | Région AWS (ex. : us-east-1) | +| `bucketName` | string | Oui | Nom du bucket S3 | +| `objectKey` | string | Oui | Clé/chemin de l'objet dans S3 (ex. : dossier/nomfichier.ext) | +| `file` | file | Non | Fichier à téléverser | +| `content` | string | Non | Contenu textuel à téléverser (alternative au fichier) | +| `contentType` | string | Non | En-tête Content-Type (détecté automatiquement à partir du fichier si non fourni) | +| `acl` | string | Non | Liste de contrôle d'accès (ex. : private, public-read) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `url` | string | URL de l'objet S3 téléversé | +| `metadata` | object | Métadonnées de téléversement incluant ETag et emplacement | + ### `s3_get_object` Récupérer un objet depuis un bucket AWS S3 @@ -72,10 +97,10 @@ Récupérer un objet depuis un bucket AWS S3 #### Entrée | Paramètre | Type | Obligatoire | Description | -| --------- | ---- | ---------- | ----------- | -| `accessKeyId` | chaîne | Oui | Votre ID de clé d'accès AWS | -| `secretAccessKey` | chaîne | Oui | Votre clé d'accès secrète AWS | -| `s3Uri` | chaîne | Oui | URL de l'objet S3 | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | Oui | Votre ID de clé d'accès AWS | +| `secretAccessKey` | string | Oui | Votre clé d'accès secrète AWS | +| `s3Uri` | string | Oui | URL de l'objet S3 | #### Sortie @@ -84,6 +109,73 @@ Récupérer un objet depuis un bucket AWS S3 | `url` | chaîne | URL présignée pour télécharger l'objet S3 | | `metadata` | objet | Métadonnées du fichier incluant le type, la taille, le nom et la date de dernière modification | +### `s3_list_objects` + +Lister les objets dans un bucket AWS S3 + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `accessKeyId` | chaîne | Oui | Votre ID de clé d'accès AWS | +| `secretAccessKey` | chaîne | Oui | Votre clé d'accès secrète AWS | +| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) | +| `bucketName` | chaîne | Oui | Nom du bucket S3 | +| `prefix` | chaîne | Non | Préfixe pour filtrer les objets (par ex., dossier/) | +| `maxKeys` | nombre | Non | Nombre maximum d'objets à retourner (par défaut : 1000) | +| `continuationToken` | chaîne | Non | Jeton pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `objects` | tableau | Liste des objets S3 | + +### `s3_delete_object` + +Supprimer un objet d'un bucket AWS S3 + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `accessKeyId` | chaîne | Oui | Votre ID de clé d'accès AWS | +| `secretAccessKey` | chaîne | Oui | Votre clé d'accès secrète AWS | +| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) | +| `bucketName` | chaîne | Oui | Nom du bucket S3 | +| `objectKey` | chaîne | Oui | Clé/chemin de l'objet à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `deleted` | booléen | Indique si l'objet a été supprimé avec succès | +| `metadata` | objet | Métadonnées de suppression | + +### `s3_copy_object` + +Copier un objet au sein d'un même bucket AWS S3 ou entre différents buckets + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `accessKeyId` | chaîne | Oui | Votre ID de clé d'accès AWS | +| `secretAccessKey` | chaîne | Oui | Votre clé d'accès secrète AWS | +| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) | +| `sourceBucket` | chaîne | Oui | Nom du bucket source | +| `sourceKey` | chaîne | Oui | Clé/chemin de l'objet source | +| `destinationBucket` | chaîne | Oui | Nom du bucket de destination | +| `destinationKey` | chaîne | Oui | Clé/chemin de l'objet de destination | +| `acl` | chaîne | Non | Liste de contrôle d'accès pour l'objet copié (par ex., private, public-read) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `url` | chaîne | URL de l'objet S3 copié | +| `metadata` | objet | Métadonnées de l'opération de copie | + ## Remarques - Catégorie : `tools` diff --git a/apps/docs/content/docs/ja/tools/gmail.mdx b/apps/docs/content/docs/ja/tools/gmail.mdx index b059e70ea..3c47927c9 100644 --- a/apps/docs/content/docs/ja/tools/gmail.mdx +++ b/apps/docs/content/docs/ja/tools/gmail.mdx @@ -64,9 +64,10 @@ Gmailを使用してメールを送信する | --------- | ---- | -------- | ----------- | | `to` | string | はい | 受信者のメールアドレス | | `subject` | string | はい | メールの件名 | -| `body` | string | はい | メール本文 | +| `body` | string | はい | メール本文の内容 | | `cc` | string | いいえ | CCの受信者（カンマ区切り） | | `bcc` | string | いいえ | BCCの受信者（カンマ区切り） | +| `attachments` | file[] | いいえ | メールに添付するファイル | #### 出力 @@ -85,9 +86,10 @@ Gmailを使用してメールの下書きを作成する | --------- | ---- | -------- | ----------- | | `to` | string | はい | 受信者のメールアドレス | | `subject` | string | はい | メールの件名 | -| `body` | string | はい | メール本文 | +| `body` | string | はい | メール本文の内容 | | `cc` | string | いいえ | CCの受信者（カンマ区切り） | | `bcc` | string | いいえ | BCCの受信者（カンマ区切り） | +| `attachments` | file[] | いいえ | メール下書きに添付するファイル | #### 出力 diff --git a/apps/docs/content/docs/ja/tools/s3.mdx b/apps/docs/content/docs/ja/tools/s3.mdx index 559220e46..b3774d3e1 100644 --- a/apps/docs/content/docs/ja/tools/s3.mdx +++ b/apps/docs/content/docs/ja/tools/s3.mdx @@ -1,6 +1,6 @@ --- title: S3 -description: S3ファイルを表示 +description: S3ファイルのアップロード、ダウンロード、一覧表示、管理 --- import { BlockInfoCard } from "@/components/ui/block-info-card" @@ -61,10 +61,35 @@ Simでは、S3統合によりエージェントがAmazon S3バケットに保存 ## 使用手順 -S3をワークフローに統合します。S3オブジェクトの署名付きURLを取得できます。アクセスキーとシークレットアクセスキーが必要です。 +S3をワークフローに統合します。ファイルのアップロード、オブジェクトのダウンロード、バケットの内容一覧表示、オブジェクトの削除、バケット間でのオブジェクトのコピーが可能です。AWSアクセスキーとシークレットアクセスキーが必要です。 ## ツール +### `s3_put_object` + +AWS S3バケットにファイルをアップロードする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | はい | AWSアクセスキーID | +| `secretAccessKey` | string | はい | AWSシークレットアクセスキー | +| `region` | string | はい | AWSリージョン（例：us-east-1） | +| `bucketName` | string | はい | S3バケット名 | +| `objectKey` | string | はい | S3内のオブジェクトキー/パス（例：folder/filename.ext） | +| `file` | file | いいえ | アップロードするファイル | +| `content` | string | いいえ | アップロードするテキストコンテンツ（ファイルの代わり） | +| `contentType` | string | いいえ | Content-Typeヘッダー（指定がない場合はファイルから自動検出） | +| `acl` | string | いいえ | アクセスコントロールリスト（例：private, public-read） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `url` | string | アップロードされたS3オブジェクトのURL | +| `metadata` | object | ETagと場所を含むアップロードメタデータ | + ### `s3_get_object` AWS S3バケットからオブジェクトを取得する @@ -73,8 +98,8 @@ AWS S3バケットからオブジェクトを取得する | パラメータ | 型 | 必須 | 説明 | | --------- | ---- | -------- | ----------- | -| `accessKeyId` | string | はい | AWS アクセスキーID | -| `secretAccessKey` | string | はい | AWS シークレットアクセスキー | +| `accessKeyId` | string | はい | AWSアクセスキーID | +| `secretAccessKey` | string | はい | AWSシークレットアクセスキー | | `s3Uri` | string | はい | S3オブジェクトURL | #### 出力 @@ -84,7 +109,74 @@ AWS S3バケットからオブジェクトを取得する | `url` | string | S3オブジェクトをダウンロードするための署名付きURL | | `metadata` | object | タイプ、サイズ、名前、最終更新日を含むファイルメタデータ | +### `s3_list_objects` + +AWS S3バケット内のオブジェクトを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | はい | AWS アクセスキーID | +| `secretAccessKey` | string | はい | AWS シークレットアクセスキー | +| `region` | string | はい | AWSリージョン（例：us-east-1） | +| `bucketName` | string | はい | S3バケット名 | +| `prefix` | string | いいえ | オブジェクトをフィルタリングするプレフィックス（例：folder/） | +| `maxKeys` | number | いいえ | 返すオブジェクトの最大数（デフォルト：1000） | +| `continuationToken` | string | いいえ | ページネーション用トークン | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `objects` | array | S3オブジェクトのリスト | + +### `s3_delete_object` + +AWS S3バケットからオブジェクトを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | はい | AWS アクセスキーID | +| `secretAccessKey` | string | はい | AWS シークレットアクセスキー | +| `region` | string | はい | AWSリージョン（例：us-east-1） | +| `bucketName` | string | はい | S3バケット名 | +| `objectKey` | string | はい | 削除するオブジェクトのキー/パス | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `deleted` | boolean | オブジェクトが正常に削除されたかどうか | +| `metadata` | object | 削除メタデータ | + +### `s3_copy_object` + +AWS S3バケット内または異なるバケット間でオブジェクトをコピーする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | はい | AWS アクセスキーID | +| `secretAccessKey` | string | はい | AWS シークレットアクセスキー | +| `region` | string | はい | AWSリージョン（例：us-east-1） | +| `sourceBucket` | string | はい | ソースバケット名 | +| `sourceKey` | string | はい | ソースオブジェクトのキー/パス | +| `destinationBucket` | string | はい | 宛先バケット名 | +| `destinationKey` | string | はい | 宛先オブジェクトのキー/パス | +| `acl` | string | いいえ | コピーされたオブジェクトのアクセス制御リスト（例：private、public-read） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `url` | string | コピーされたS3オブジェクトのURL | +| `metadata` | object | コピー操作のメタデータ | + ## 注意事項 -- カテゴリ: `tools` +- カテゴリー: `tools` - タイプ: `s3` diff --git a/apps/docs/content/docs/zh/tools/gmail.mdx b/apps/docs/content/docs/zh/tools/gmail.mdx index 4e8b11a30..d2733161a 100644 --- a/apps/docs/content/docs/zh/tools/gmail.mdx +++ b/apps/docs/content/docs/zh/tools/gmail.mdx @@ -60,13 +60,14 @@ import { BlockInfoCard } from "@/components/ui/block-info-card" #### 输入 -| 参数 | 类型 | 必需 | 描述 | +| 参数 | 类型 | 是否必需 | 描述 | | --------- | ---- | -------- | ----------- | -| `to` | 字符串 | 是 | 收件人电子邮件地址 | -| `subject` | 字符串 | 是 | 邮件主题 | -| `body` | 字符串 | 是 | 邮件正文内容 | -| `cc` | 字符串 | 否 | 抄送收件人（逗号分隔） | -| `bcc` | 字符串 | 否 | 密送收件人（逗号分隔） | +| `to` | string | 是 | 收件人电子邮件地址 | +| `subject` | string | 是 | 电子邮件主题 | +| `body` | string | 是 | 电子邮件正文内容 | +| `cc` | string | 否 | 抄送收件人（逗号分隔） | +| `bcc` | string | 否 | 密送收件人（逗号分隔） | +| `attachments` | file[] | 否 | 附加到电子邮件的文件 | #### 输出 @@ -81,13 +82,14 @@ import { BlockInfoCard } from "@/components/ui/block-info-card" #### 输入 -| 参数 | 类型 | 必需 | 描述 | +| 参数 | 类型 | 是否必需 | 描述 | | --------- | ---- | -------- | ----------- | -| `to` | 字符串 | 是 | 收件人电子邮件地址 | -| `subject` | 字符串 | 是 | 邮件主题 | -| `body` | 字符串 | 是 | 邮件正文内容 | -| `cc` | 字符串 | 否 | 抄送收件人（逗号分隔） | -| `bcc` | 字符串 | 否 | 密送收件人（逗号分隔） | +| `to` | string | 是 | 收件人电子邮件地址 | +| `subject` | string | 是 | 电子邮件主题 | +| `body` | string | 是 | 电子邮件正文内容 | +| `cc` | string | 否 | 抄送收件人（逗号分隔） | +| `bcc` | string | 否 | 密送收件人（逗号分隔） | +| `attachments` | file[] | 否 | 附加到电子邮件草稿的文件 | #### 输出 diff --git a/apps/docs/content/docs/zh/tools/s3.mdx b/apps/docs/content/docs/zh/tools/s3.mdx index 610d1bab5..209a55b52 100644 --- a/apps/docs/content/docs/zh/tools/s3.mdx +++ b/apps/docs/content/docs/zh/tools/s3.mdx @@ -1,6 +1,6 @@ --- title: S3 -description: 查看 S3 文件 +description: 上传、下载、列出和管理 S3 文件 --- import { BlockInfoCard } from "@/components/ui/block-info-card" @@ -61,10 +61,35 @@ import { BlockInfoCard } from "@/components/ui/block-info-card" ## 使用说明 -将 S3 集成到工作流程中。可以获取 S3 对象的预签名 URL。需要访问密钥和秘密访问密钥。 +将 S3 集成到工作流程中。上传文件、下载对象、列出存储桶内容、删除对象以及在存储桶之间复制对象。需要 AWS 访问密钥和秘密访问密钥。 ## 工具 +### `s3_put_object` + +将文件上传到 AWS S3 存储桶 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | 是 | 您的 AWS 访问密钥 ID | +| `secretAccessKey` | string | 是 | 您的 AWS 秘密访问密钥 | +| `region` | string | 是 | AWS 区域（例如，us-east-1） | +| `bucketName` | string | 是 | S3 存储桶名称 | +| `objectKey` | string | 是 | S3 中的对象键/路径（例如，folder/filename.ext） | +| `file` | file | 否 | 要上传的文件 | +| `content` | string | 否 | 要上传的文本内容（文件的替代选项） | +| `contentType` | string | 否 | Content-Type 头（如果未提供，将从文件中自动检测） | +| `acl` | string | 否 | 访问控制列表（例如，private, public-read） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `url` | string | 已上传 S3 对象的 URL | +| `metadata` | object | 包括 ETag 和位置的上传元数据 | + ### `s3_get_object` 从 AWS S3 存储桶中检索对象 @@ -73,8 +98,8 @@ import { BlockInfoCard } from "@/components/ui/block-info-card" | 参数 | 类型 | 必需 | 描述 | | --------- | ---- | -------- | ----------- | -| `accessKeyId` | string | 是 | 您的 AWS Access Key ID | -| `secretAccessKey` | string | 是 | 您的 AWS Secret Access Key | +| `accessKeyId` | string | 是 | 您的 AWS 访问密钥 ID | +| `secretAccessKey` | string | 是 | 您的 AWS 秘密访问密钥 | | `s3Uri` | string | 是 | S3 对象 URL | #### 输出 @@ -84,6 +109,73 @@ import { BlockInfoCard } from "@/components/ui/block-info-card" | `url` | string | 用于下载 S3 对象的预签名 URL | | `metadata` | object | 文件元数据，包括类型、大小、名称和最后修改日期 | +### `s3_list_objects` + +列出 AWS S3 存储桶中的对象 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | 是 | 您的 AWS Access Key ID | +| `secretAccessKey` | string | 是 | 您的 AWS Secret Access Key | +| `region` | string | 是 | AWS 区域 \(例如，us-east-1\) | +| `bucketName` | string | 是 | S3 存储桶名称 | +| `prefix` | string | 否 | 用于过滤对象的前缀 \(例如，folder/\) | +| `maxKeys` | number | 否 | 返回的最大对象数 \(默认值：1000\) | +| `continuationToken` | string | 否 | 分页令牌 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `objects` | array | S3 对象列表 | + +### `s3_delete_object` + +从 AWS S3 存储桶中删除对象 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | 是 | 您的 AWS Access Key ID | +| `secretAccessKey` | string | 是 | 您的 AWS Secret Access Key | +| `region` | string | 是 | AWS 区域 \(例如，us-east-1\) | +| `bucketName` | string | 是 | S3 存储桶名称 | +| `objectKey` | string | 是 | 要删除的对象键/路径 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `deleted` | boolean | 对象是否已成功删除 | +| `metadata` | object | 删除元数据 | + +### `s3_copy_object` + +在 AWS S3 存储桶内或之间复制对象 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `accessKeyId` | string | 是 | 您的 AWS Access Key ID | +| `secretAccessKey` | string | 是 | 您的 AWS Secret Access Key | +| `region` | string | 是 | AWS 区域 \(例如，us-east-1\) | +| `sourceBucket` | string | 是 | 源存储桶名称 | +| `sourceKey` | string | 是 | 源对象键/路径 | +| `destinationBucket` | string | 是 | 目标存储桶名称 | +| `destinationKey` | string | 是 | 目标对象键/路径 | +| `acl` | string | 否 | 复制对象的访问控制列表 \(例如，private, public-read\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `url` | string | 复制的 S3 对象的 URL | +| `metadata` | object | 复制操作元数据 | + ## 注意事项 - 类别：`tools` diff --git a/apps/docs/i18n.lock b/apps/docs/i18n.lock index a44b24a8c..520d4c98f 100644 --- a/apps/docs/i18n.lock +++ b/apps/docs/i18n.lock @@ -836,7 +836,7 @@ checksums: content/5: 82020248e51ac7b0cd6d1bc1f9d7e26a 3004a6df5b8acb42db5daee1f579ccca: meta/title: cce1ae862f9851c02137f7be070e87bf - meta/description: 69a322da30b907d258b4b59c8accf7f8 + meta/description: 9c24136d13767cf42d598ecd2cd7895b content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 content/1: 4b62ccc8c13a183707ae275bcbbcf8ba content/2: bd6df7d7d47e2f5a3562df04bb4c2be5 @@ -844,16 +844,40 @@ checksums: content/4: b0425d5c200cae7c869529ea3b8f7214 content/5: 9a7e14bec248e76b356e36c0b9581ce6 content/6: 821e6394b0a953e2b0842b04ae8f3105 - content/7: 298994c31aafc0f23d33e5f544e5e2af + content/7: 00fd7c906bcab9c29ec3485d8c8d8a50 content/8: 9c8aa3f09c9b2bd50ea4cdff3598ea4e - content/9: f4ae5fe0f53b73c0ad42841b5579217d - content/10: 7b4b86a3d412ee38ca7ba60eeb4d83e2 + content/9: dff365703d7937281b9f21da81a28791 + content/10: b4be956b7369cac61f96596fc308855d content/11: 371d0e46b4bd2c23f559b8bc112f6955 - content/12: 12247d07382e4b97bc0c6f8923ae9ce6 + content/12: b28a74f7dd9570ab0f09b36fe786af09 content/13: bcadfc362b69078beee0088e5936c98b - content/14: 3abad74a5899ff7c771c60fb8e332a32 - content/15: b3f310d5ef115bea5a8b75bf25d7ea9a - content/16: eaac73b007851a8fea6277e1d39043bb + content/14: 990920d309f98177e31ea100d961f97b + content/15: f4ae5fe0f53b73c0ad42841b5579217d + content/16: 7b4b86a3d412ee38ca7ba60eeb4d83e2 + content/17: 371d0e46b4bd2c23f559b8bc112f6955 + content/18: 12247d07382e4b97bc0c6f8923ae9ce6 + content/19: bcadfc362b69078beee0088e5936c98b + content/20: 3abad74a5899ff7c771c60fb8e332a32 + content/21: e6e8c44f5e9978ce5548fd951bf51687 + content/22: 77d71aa6eaf80a063d913492d65079f8 + content/23: 371d0e46b4bd2c23f559b8bc112f6955 + content/24: 2eb4483d48d7e82e356962d2a0a6e4fb + content/25: bcadfc362b69078beee0088e5936c98b + content/26: 883cf83cf5ee03930f33f149610ec068 + content/27: 0a4ebf7c867859698563f6722cf0cc58 + content/28: 0bae1180d849b549d24f7370f2afaf20 + content/29: 371d0e46b4bd2c23f559b8bc112f6955 + content/30: f564db683184cd74ff72230152b3686c + content/31: bcadfc362b69078beee0088e5936c98b + content/32: 163077bde53253fe710495a213eecc2c + content/33: 3750e65bb05252d470e69738caaa4171 + content/34: 9f7e43baeb6af808da6555f21ec426dc + content/35: 371d0e46b4bd2c23f559b8bc112f6955 + content/36: 9967f95470a7a572bf1df594d324153b + content/37: bcadfc362b69078beee0088e5936c98b + content/38: a20d6c79b79a54bdc241681e5bff0a59 + content/39: b3f310d5ef115bea5a8b75bf25d7ea9a + content/40: eaac73b007851a8fea6277e1d39043bb b38eb56ef28470cf1385063c6f5c4b31: meta/title: 3c84eca48ca70bd0bbd8b7df1be47842 meta/description: 0eef3f2f8a8654bcdf054af7d17e7cb6 @@ -1910,13 +1934,13 @@ checksums: content/9: 59ea24bb2cd80bf7fb0f98b8dc0b251d content/10: 69c9a5b252f10da7e52a2537af16088a content/11: 371d0e46b4bd2c23f559b8bc112f6955 - content/12: 96832958c23fb2c9cefb35ee9a63cded + content/12: 8ec10c007a0066f6b30c0583202ca584 content/13: bcadfc362b69078beee0088e5936c98b content/14: cb72ea72163f2a9cb8aef03eaf3da52f content/15: f99b81c56a6e718223067b5eec641c20 content/16: 0da6a460cff4d07096fa38f6d10d8d0d content/17: 371d0e46b4bd2c23f559b8bc112f6955 - content/18: 96832958c23fb2c9cefb35ee9a63cded + content/18: c886c72190889c7b55a8f38a294ecf38 content/19: bcadfc362b69078beee0088e5936c98b content/20: e9ac34c67e488c57c2d28f5b731bd032 content/21: 66c479adb6d552931bec3302ae9c9680