mirror of
https://github.com/simstudioai/sim.git
synced 2026-01-09 23:17:59 -05:00
Compare commits
23 Commits
v0.5.12
...
feat/workf
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
198a9ca69a | ||
|
|
0ae7eb197a | ||
|
|
304b5d9c7e | ||
|
|
ee3e1e8cf9 | ||
|
|
ede41af674 | ||
|
|
cb0c55c6f6 | ||
|
|
d22b21c8d1 | ||
|
|
1e080e98e8 | ||
|
|
b069034d9c | ||
|
|
3a4f130f69 | ||
|
|
e80feee51f | ||
|
|
7f62467f84 | ||
|
|
7b2792122d | ||
|
|
4e9cab39c3 | ||
|
|
e3a57d30e8 | ||
|
|
f25db707d7 | ||
|
|
08d57b4f8b | ||
|
|
f56d85bda6 | ||
|
|
d7a650a355 | ||
|
|
a8f87f7e3a | ||
|
|
9330940658 | ||
|
|
fc5f815c7a | ||
|
|
7bf9251db1 |
File diff suppressed because one or more lines are too long
@@ -24,7 +24,7 @@ export function BlockInfoCard({
|
||||
<div className='flex items-center justify-center p-6'>
|
||||
<div
|
||||
className='flex h-20 w-20 items-center justify-center rounded-lg'
|
||||
style={{ backgroundColor: color }}
|
||||
style={{ background: color }}
|
||||
>
|
||||
{ResolvedIcon ? (
|
||||
<ResolvedIcon className='h-10 w-10 text-white' />
|
||||
|
||||
@@ -5,6 +5,7 @@
|
||||
import type { ComponentType, SVGProps } from 'react'
|
||||
import {
|
||||
AirtableIcon,
|
||||
ApifyIcon,
|
||||
ApolloIcon,
|
||||
ArxivIcon,
|
||||
AsanaIcon,
|
||||
@@ -15,6 +16,7 @@ import {
|
||||
ConfluenceIcon,
|
||||
DiscordIcon,
|
||||
DocumentIcon,
|
||||
DynamoDBIcon,
|
||||
ElevenLabsIcon,
|
||||
ExaAIIcon,
|
||||
EyeIcon,
|
||||
@@ -37,8 +39,10 @@ import {
|
||||
JinaAIIcon,
|
||||
JiraIcon,
|
||||
LinearIcon,
|
||||
LinkedInIcon,
|
||||
LinkupIcon,
|
||||
MailchimpIcon,
|
||||
MailgunIcon,
|
||||
Mem0Icon,
|
||||
MicrosoftExcelIcon,
|
||||
MicrosoftOneDriveIcon,
|
||||
@@ -61,13 +65,17 @@ import {
|
||||
PosthogIcon,
|
||||
PylonIcon,
|
||||
QdrantIcon,
|
||||
RDSIcon,
|
||||
RedditIcon,
|
||||
ResendIcon,
|
||||
S3Icon,
|
||||
SalesforceIcon,
|
||||
SearchIcon,
|
||||
SendgridIcon,
|
||||
SentryIcon,
|
||||
SerperIcon,
|
||||
SlackIcon,
|
||||
SmtpIcon,
|
||||
STTIcon,
|
||||
StagehandIcon,
|
||||
StripeIcon,
|
||||
@@ -117,14 +125,18 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
|
||||
stripe: StripeIcon,
|
||||
stagehand_agent: StagehandIcon,
|
||||
stagehand: StagehandIcon,
|
||||
smtp: SmtpIcon,
|
||||
slack: SlackIcon,
|
||||
sharepoint: MicrosoftSharepointIcon,
|
||||
serper: SerperIcon,
|
||||
sentry: SentryIcon,
|
||||
sendgrid: SendgridIcon,
|
||||
search: SearchIcon,
|
||||
salesforce: SalesforceIcon,
|
||||
s3: S3Icon,
|
||||
resend: ResendIcon,
|
||||
reddit: RedditIcon,
|
||||
rds: RDSIcon,
|
||||
qdrant: QdrantIcon,
|
||||
pylon: PylonIcon,
|
||||
posthog: PosthogIcon,
|
||||
@@ -146,8 +158,10 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
|
||||
microsoft_excel: MicrosoftExcelIcon,
|
||||
memory: BrainIcon,
|
||||
mem0: Mem0Icon,
|
||||
mailgun: MailgunIcon,
|
||||
mailchimp: MailchimpIcon,
|
||||
linkup: LinkupIcon,
|
||||
linkedin: LinkedInIcon,
|
||||
linear: LinearIcon,
|
||||
knowledge: PackageSearchIcon,
|
||||
jira: JiraIcon,
|
||||
@@ -171,6 +185,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
|
||||
file: DocumentIcon,
|
||||
exa: ExaAIIcon,
|
||||
elevenlabs: ElevenLabsIcon,
|
||||
dynamodb: DynamoDBIcon,
|
||||
discord: DiscordIcon,
|
||||
confluence: ConfluenceIcon,
|
||||
clay: ClayIcon,
|
||||
@@ -179,5 +194,6 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
|
||||
asana: AsanaIcon,
|
||||
arxiv: ArxivIcon,
|
||||
apollo: ApolloIcon,
|
||||
apify: ApifyIcon,
|
||||
airtable: AirtableIcon,
|
||||
}
|
||||
|
||||
89
apps/docs/content/docs/de/tools/apify.mdx
Normal file
89
apps/docs/content/docs/de/tools/apify.mdx
Normal file
@@ -0,0 +1,89 @@
|
||||
---
|
||||
title: Apify
|
||||
description: Führe Apify-Akteure aus und rufe Ergebnisse ab
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="apify"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Apify](https://apify.com/) ist eine leistungsstarke Plattform zum Erstellen, Bereitstellen und Ausführen von Web-Automatisierung und Web-Scraping-Akteuren im großen Maßstab. Apify ermöglicht es dir, nützliche Daten von jeder Website zu extrahieren, Arbeitsabläufe zu automatisieren und deine Datenpipelines nahtlos zu verbinden.
|
||||
|
||||
Mit Apify kannst du:
|
||||
|
||||
- **Vorgefertigte oder benutzerdefinierte Akteure ausführen**: Integriere öffentliche Akteure oder entwickle deine eigenen, um eine breite Palette von Webdatenextraktions- und Browser-Aufgaben zu automatisieren.
|
||||
- **Datensätze abrufen**: Greife auf strukturierte Datensätze zu, die von Akteuren in Echtzeit gesammelt wurden, und verwalte sie.
|
||||
- **Web-Automatisierung skalieren**: Nutze Cloud-Infrastruktur, um Aufgaben zuverlässig, asynchron oder synchron mit robuster Fehlerbehandlung auszuführen.
|
||||
|
||||
In Sim ermöglicht die Apify-Integration deinen Agenten, grundlegende Apify-Operationen programmatisch durchzuführen:
|
||||
|
||||
- **Akteur ausführen (Synchron)**: Verwende `apify_run_actor_sync`, um einen Apify-Akteur zu starten und auf dessen Abschluss zu warten, wobei die Ergebnisse sofort nach Beendigung des Laufs abgerufen werden.
|
||||
- **Akteur ausführen (Asynchron)**: Verwende `apify_run_actor_async`, um einen Akteur im Hintergrund zu starten und regelmäßig nach Ergebnissen zu fragen, was für längere oder komplexe Aufgaben geeignet ist.
|
||||
|
||||
Diese Operationen statten deine Agenten aus, um Datenerfassungs- oder Browser-Automatisierungsaufgaben direkt in Workflows zu automatisieren, zu scrapen und zu orchestrieren – alles mit flexibler Konfiguration und Ergebnisverarbeitung, ohne dass manuelle Ausführungen oder externe Tools erforderlich sind. Integriere Apify als dynamische Automatisierungs- und Datenextraktions-Engine, die programmatisch die webbasierten Workflows deiner Agenten antreibt.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Gebrauchsanweisung
|
||||
|
||||
Integriere Apify in deinen Workflow. Führe jeden Apify-Akteur mit benutzerdefinierter Eingabe aus und rufe Ergebnisse ab. Unterstützt sowohl synchrone als auch asynchrone Ausführung mit automatischem Datensatz-Abruf.
|
||||
|
||||
## Tools
|
||||
|
||||
### `apify_run_actor_sync`
|
||||
|
||||
Führe einen APIFY-Aktor synchron aus und erhalte Ergebnisse (maximal 5 Minuten)
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | APIFY API-Token von console.apify.com/account#/integrations |
|
||||
| `actorId` | string | Ja | Aktor-ID oder Benutzername/Aktor-Name \(z.B. "janedoe/my-actor" oder Aktor-ID\) |
|
||||
| `input` | string | Nein | Aktor-Eingabe als JSON-String. Siehe Aktor-Dokumentation für erforderliche Felder. |
|
||||
| `timeout` | number | Nein | Timeout in Sekunden \(Standard: Aktor-Standard\) |
|
||||
| `build` | string | Nein | Aktor-Build zum Ausführen \(z.B. "latest", "beta" oder Build-Tag/Nummer\) |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob die Aktor-Ausführung erfolgreich war |
|
||||
| `runId` | string | APIFY-Ausführungs-ID |
|
||||
| `status` | string | Ausführungsstatus \(SUCCEEDED, FAILED, usw.\) |
|
||||
| `datasetId` | string | Dataset-ID mit Ergebnissen |
|
||||
| `items` | array | Dataset-Elemente \(falls abgeschlossen\) |
|
||||
|
||||
### `apify_run_actor_async`
|
||||
|
||||
Führe einen APIFY-Aktor asynchron mit Polling für lang laufende Aufgaben aus
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | APIFY API-Token von console.apify.com/account#/integrations |
|
||||
| `actorId` | string | Ja | Aktor-ID oder Benutzername/Aktor-Name \(z.B. "janedoe/my-actor" oder Aktor-ID\) |
|
||||
| `input` | string | Nein | Aktor-Eingabe als JSON-String |
|
||||
| `waitForFinish` | number | Nein | Anfängliche Wartezeit in Sekunden \(0-60\) bevor Polling beginnt |
|
||||
| `itemLimit` | number | Nein | Maximale Anzahl an Dataset-Elementen zum Abrufen \(1-250000, Standard 100\) |
|
||||
| `timeout` | number | Nein | Timeout in Sekunden \(Standard: Aktor-Standard\) |
|
||||
| `build` | string | Nein | Aktor-Build zum Ausführen \(z.B. "latest", "beta" oder Build-Tag/Nummer\) |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob der Actor-Lauf erfolgreich war |
|
||||
| `runId` | string | APIFY-Lauf-ID |
|
||||
| `status` | string | Laufstatus \(SUCCEEDED, FAILED, usw.\) |
|
||||
| `datasetId` | string | Dataset-ID mit Ergebnissen |
|
||||
| `items` | array | Dataset-Elemente \(falls abgeschlossen\) |
|
||||
|
||||
## Hinweise
|
||||
|
||||
- Kategorie: `tools`
|
||||
- Typ: `apify`
|
||||
188
apps/docs/content/docs/de/tools/dynamodb.mdx
Normal file
188
apps/docs/content/docs/de/tools/dynamodb.mdx
Normal file
@@ -0,0 +1,188 @@
|
||||
---
|
||||
title: Amazon DynamoDB
|
||||
description: Verbindung zu Amazon DynamoDB
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="dynamodb"
|
||||
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Amazon DynamoDB](https://aws.amazon.com/dynamodb/) ist ein vollständig verwalteter NoSQL-Datenbankdienst von AWS, der schnelle und vorhersehbare Leistung mit nahtloser Skalierbarkeit bietet. Mit DynamoDB können Sie beliebige Datenmengen speichern und abrufen und jede Art von Anforderungsverkehr bedienen, ohne dass Sie Hardware oder Infrastruktur verwalten müssen.
|
||||
|
||||
Mit DynamoDB können Sie:
|
||||
|
||||
- **Elemente abrufen**: Elemente in Ihren Tabellen mithilfe von Primärschlüsseln nachschlagen
|
||||
- **Elemente einfügen**: Elemente in Ihren Tabellen hinzufügen oder ersetzen
|
||||
- **Elemente abfragen**: Mehrere Elemente mithilfe von Abfragen über Indizes abrufen
|
||||
- **Tabellen scannen**: Alle oder einen Teil der Daten in einer Tabelle lesen
|
||||
- **Elemente aktualisieren**: Bestimmte Attribute vorhandener Elemente ändern
|
||||
- **Elemente löschen**: Datensätze aus Ihren Tabellen entfernen
|
||||
|
||||
In Sim ermöglicht die DynamoDB-Integration Ihren Agenten den sicheren Zugriff auf DynamoDB-Tabellen und deren Manipulation mithilfe von AWS-Anmeldeinformationen. Zu den unterstützten Operationen gehören:
|
||||
|
||||
- **Get**: Ein Element anhand seines Schlüssels abrufen
|
||||
- **Put**: Elemente einfügen oder überschreiben
|
||||
- **Query**: Abfragen mit Schlüsselbedingungen und Filtern ausführen
|
||||
- **Scan**: Mehrere Elemente durch Scannen der Tabelle oder des Index lesen
|
||||
- **Update**: Bestimmte Attribute eines oder mehrerer Elemente ändern
|
||||
- **Delete**: Ein Element aus einer Tabelle entfernen
|
||||
|
||||
Diese Integration ermöglicht es Sim-Agenten, Datenverwaltungsaufgaben innerhalb Ihrer DynamoDB-Tabellen programmatisch zu automatisieren, sodass Sie Workflows erstellen können, die skalierbare NoSQL-Daten ohne manuellen Aufwand oder Serververwaltung verwalten, ändern und abrufen.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Nutzungsanweisungen
|
||||
|
||||
Integrieren Sie Amazon DynamoDB in Workflows. Unterstützt Get-, Put-, Query-, Scan-, Update- und Delete-Operationen auf DynamoDB-Tabellen.
|
||||
|
||||
## Tools
|
||||
|
||||
### `dynamodb_get`
|
||||
|
||||
Ein Element aus einer DynamoDB-Tabelle anhand des Primärschlüssels abrufen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
|
||||
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
|
||||
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
|
||||
| `tableName` | string | Ja | DynamoDB-Tabellenname |
|
||||
| `key` | object | Ja | Primärschlüssel des abzurufenden Elements |
|
||||
| `consistentRead` | boolean | Nein | Stark konsistentes Lesen verwenden |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `item` | object | Abgerufenes Element |
|
||||
|
||||
### `dynamodb_put`
|
||||
|
||||
Ein Element in eine DynamoDB-Tabelle einfügen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
|
||||
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
|
||||
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
|
||||
| `tableName` | string | Ja | DynamoDB-Tabellenname |
|
||||
| `item` | object | Ja | Element, das in die Tabelle eingefügt werden soll |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `item` | object | Erstelltes Element |
|
||||
|
||||
### `dynamodb_query`
|
||||
|
||||
Abfrage von Elementen aus einer DynamoDB-Tabelle mit Schlüsselbedingungen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
|
||||
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
|
||||
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
|
||||
| `tableName` | string | Ja | DynamoDB-Tabellenname |
|
||||
| `keyConditionExpression` | string | Ja | Schlüsselbedingungsausdruck (z.B. "pk = :pk") |
|
||||
| `filterExpression` | string | Nein | Filterausdruck für Ergebnisse |
|
||||
| `expressionAttributeNames` | object | Nein | Attributnamenzuordnungen für reservierte Wörter |
|
||||
| `expressionAttributeValues` | object | Nein | Ausdrucksattributwerte |
|
||||
| `indexName` | string | Nein | Name des sekundären Index für die Abfrage |
|
||||
| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Elemente |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `items` | array | Array der zurückgegebenen Elemente |
|
||||
| `count` | number | Anzahl der zurückgegebenen Elemente |
|
||||
|
||||
### `dynamodb_scan`
|
||||
|
||||
Alle Elemente in einer DynamoDB-Tabelle scannen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
|
||||
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
|
||||
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
|
||||
| `tableName` | string | Ja | DynamoDB-Tabellenname |
|
||||
| `filterExpression` | string | Nein | Filterausdruck für Ergebnisse |
|
||||
| `projectionExpression` | string | Nein | Abzurufende Attribute |
|
||||
| `expressionAttributeNames` | object | Nein | Attributnamenzuordnungen für reservierte Wörter |
|
||||
| `expressionAttributeValues` | object | Nein | Ausdrucksattributwerte |
|
||||
| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Elemente |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `items` | array | Array der zurückgegebenen Elemente |
|
||||
| `count` | number | Anzahl der zurückgegebenen Elemente |
|
||||
|
||||
### `dynamodb_update`
|
||||
|
||||
Ein Element in einer DynamoDB-Tabelle aktualisieren
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
|
||||
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
|
||||
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
|
||||
| `tableName` | string | Ja | Name der DynamoDB-Tabelle |
|
||||
| `key` | object | Ja | Primärschlüssel des zu aktualisierenden Elements |
|
||||
| `updateExpression` | string | Ja | Aktualisierungsausdruck (z.B. "SET #name = :name") |
|
||||
| `expressionAttributeNames` | object | Nein | Attributnamenzuordnungen für reservierte Wörter |
|
||||
| `expressionAttributeValues` | object | Nein | Ausdrucksattributwerte |
|
||||
| `conditionExpression` | string | Nein | Bedingung, die erfüllt sein muss, damit die Aktualisierung erfolgreich ist |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `item` | object | Aktualisiertes Element |
|
||||
|
||||
### `dynamodb_delete`
|
||||
|
||||
Ein Element aus einer DynamoDB-Tabelle löschen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
|
||||
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
|
||||
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
|
||||
| `tableName` | string | Ja | Name der DynamoDB-Tabelle |
|
||||
| `key` | object | Ja | Primärschlüssel des zu löschenden Elements |
|
||||
| `conditionExpression` | string | Nein | Bedingung, die erfüllt sein muss, damit das Löschen erfolgreich ist |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
|
||||
## Hinweise
|
||||
|
||||
- Kategorie: `tools`
|
||||
- Typ: `dynamodb`
|
||||
83
apps/docs/content/docs/de/tools/linkedin.mdx
Normal file
83
apps/docs/content/docs/de/tools/linkedin.mdx
Normal file
@@ -0,0 +1,83 @@
|
||||
---
|
||||
title: LinkedIn
|
||||
description: Teilen Sie Beiträge und verwalten Sie Ihre LinkedIn-Präsenz
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="linkedin"
|
||||
color="#0072B1"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[LinkedIn](https://www.linkedin.com) ist die weltweit größte professionelle Netzwerkplattform, die Nutzern ermöglicht, ihre Karriere aufzubauen, sich mit ihrem Netzwerk zu verbinden und berufliche Inhalte zu teilen. LinkedIn wird von Fachleuten aus verschiedenen Branchen für persönliches Branding, Recruiting, Jobsuche und Geschäftsentwicklung genutzt.
|
||||
|
||||
Mit LinkedIn können Sie ganz einfach Beiträge in Ihrem persönlichen Feed teilen, um mit Ihrem Netzwerk in Kontakt zu treten, und auf Informationen über Ihr Profil zugreifen, um Ihre beruflichen Erfolge hervorzuheben. Die automatisierte Integration mit Sim ermöglicht es Ihnen, LinkedIn-Funktionen programmatisch zu nutzen – so können Agenten und Workflows Updates posten, über Ihre berufliche Präsenz berichten und Ihren Feed aktiv halten, ohne dass manuelle Arbeit erforderlich ist.
|
||||
|
||||
Zu den wichtigsten LinkedIn-Funktionen, die über diese Integration verfügbar sind, gehören:
|
||||
|
||||
- **Beiträge teilen:** Veröffentlichen Sie automatisch berufliche Updates, Artikel oder Ankündigungen in Ihrem persönlichen LinkedIn-Feed.
|
||||
- **Profilinformationen:** Rufen Sie detaillierte Informationen über Ihr LinkedIn-Profil ab, um diese zu überwachen oder in nachgelagerten Aufgaben innerhalb Ihrer Workflows zu verwenden.
|
||||
|
||||
Diese Funktionen machen es einfach, Ihr LinkedIn-Netzwerk zu pflegen und Ihre berufliche Reichweite effizient zu erweitern – als Teil Ihrer KI- oder Workflow-Automatisierungsstrategie.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Nutzungsanleitung
|
||||
|
||||
Integrieren Sie LinkedIn in Workflows. Teilen Sie Beiträge in Ihrem persönlichen Feed und greifen Sie auf Ihre LinkedIn-Profilinformationen zu.
|
||||
|
||||
## Tools
|
||||
|
||||
### `linkedin_share_post`
|
||||
|
||||
Einen Beitrag in Ihrem persönlichen LinkedIn-Feed teilen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `text` | string | Ja | Der Textinhalt Ihres LinkedIn-Beitrags |
|
||||
| `visibility` | string | Nein | Wer diesen Beitrag sehen kann: "PUBLIC" oder "CONNECTIONS" \(Standard: "PUBLIC"\) |
|
||||
| `request` | string | Nein | Keine Beschreibung |
|
||||
| `output` | string | Nein | Keine Beschreibung |
|
||||
| `output` | string | Nein | Keine Beschreibung |
|
||||
| `specificContent` | string | Nein | Keine Beschreibung |
|
||||
| `shareCommentary` | string | Nein | Keine Beschreibung |
|
||||
| `visibility` | string | Nein | Keine Beschreibung |
|
||||
| `headers` | string | Nein | Keine Beschreibung |
|
||||
| `output` | string | Nein | Keine Beschreibung |
|
||||
| `output` | string | Nein | Keine Beschreibung |
|
||||
| `output` | string | Nein | Keine Beschreibung |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Erfolgsstatus der Operation |
|
||||
| `postId` | string | Erstellte Beitrags-ID |
|
||||
| `profile` | json | LinkedIn-Profilinformationen |
|
||||
| `error` | string | Fehlermeldung bei fehlgeschlagener Operation |
|
||||
|
||||
### `linkedin_get_profile`
|
||||
|
||||
Rufen Sie Ihre LinkedIn-Profilinformationen ab
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Erfolgsstatus der Operation |
|
||||
| `postId` | string | Erstellte Beitrags-ID |
|
||||
| `profile` | json | LinkedIn-Profilinformationen |
|
||||
| `error` | string | Fehlermeldung bei fehlgeschlagener Operation |
|
||||
|
||||
## Hinweise
|
||||
|
||||
- Kategorie: `tools`
|
||||
- Typ: `linkedin`
|
||||
216
apps/docs/content/docs/de/tools/mailgun.mdx
Normal file
216
apps/docs/content/docs/de/tools/mailgun.mdx
Normal file
@@ -0,0 +1,216 @@
|
||||
---
|
||||
title: Mailgun
|
||||
description: E-Mails versenden und Mailinglisten mit Mailgun verwalten
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="mailgun"
|
||||
color="#F06248"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Mailgun](https://www.mailgun.com) ist ein leistungsstarker E-Mail-Zustelldienst, der für Entwickler und Unternehmen konzipiert wurde, um E-Mails mühelos zu versenden, zu empfangen und zu verfolgen. Mailgun ermöglicht es Ihnen, robuste APIs für zuverlässige Transaktions- und Marketing-E-Mails, flexible Mailinglisten-Verwaltung und fortschrittliches Event-Tracking zu nutzen.
|
||||
|
||||
Mit Mailguns umfassendem Funktionsumfang können Sie wichtige E-Mail-Operationen automatisieren und die Zustellbarkeit sowie das Engagement der Empfänger genau überwachen. Dies macht es zu einer idealen Lösung für Workflow-Automatisierung, bei der Kommunikation, Benachrichtigungen und Kampagnen-Mails zentrale Bestandteile Ihrer Prozesse sind.
|
||||
|
||||
Zu den wichtigsten Funktionen von Mailgun gehören:
|
||||
|
||||
- **Versand von Transaktions-E-Mails:** Zustellung von E-Mails mit hohem Volumen wie Kontobenachrichtigungen, Quittungen, Warnmeldungen und Passwort-Zurücksetzungen.
|
||||
- **Reichhaltige E-Mail-Inhalte:** Versenden Sie sowohl Nur-Text- als auch HTML-E-Mails und verwenden Sie Tags zur Kategorisierung und Verfolgung Ihrer Nachrichten.
|
||||
- **Mailinglisten-Verwaltung:** Erstellen, aktualisieren und verwalten Sie Mailinglisten und Mitglieder, um Gruppenkommunikation effizient zu versenden.
|
||||
- **Domain-Informationen:** Rufen Sie Details zu Ihren Sende-Domains ab, um Konfiguration und Zustand zu überwachen.
|
||||
- **Event-Tracking:** Analysieren Sie die Zustellbarkeit von E-Mails und das Engagement mit detaillierten Ereignisdaten zu gesendeten Nachrichten.
|
||||
- **Nachrichtenabruf:** Greifen Sie auf gespeicherte Nachrichten für Compliance-, Analyse- oder Fehlerbehebungszwecke zu.
|
||||
|
||||
Durch die Integration von Mailgun in Sim können Ihre Agenten programmatisch E-Mails versenden, E-Mail-Listen verwalten, auf Domain-Informationen zugreifen und Ereignisse in Echtzeit überwachen – als Teil automatisierter Workflows. Dies ermöglicht eine intelligente, datengesteuerte Interaktion mit Ihren Nutzern direkt aus Ihren KI-gestützten Prozessen heraus.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Nutzungsanleitung
|
||||
|
||||
Integrieren Sie Mailgun in Ihren Workflow. Senden Sie Transaktions-E-Mails, verwalten Sie Mailinglisten und Mitglieder, sehen Sie Domain-Informationen ein und verfolgen Sie E-Mail-Ereignisse. Unterstützt Text- und HTML-E-Mails, Tags für Tracking und umfassende Listenverwaltung.
|
||||
|
||||
## Tools
|
||||
|
||||
### `mailgun_send_message`
|
||||
|
||||
E-Mail über die Mailgun API versenden
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | Mailgun API-Schlüssel |
|
||||
| `domain` | string | Ja | Mailgun-Domain \(z.B. mg.example.com\) |
|
||||
| `from` | string | Ja | E-Mail-Adresse des Absenders |
|
||||
| `to` | string | Ja | E-Mail-Adresse des Empfängers \(durch Komma getrennt für mehrere\) |
|
||||
| `subject` | string | Ja | Betreff der E-Mail |
|
||||
| `text` | string | Nein | Nur-Text-Inhalt der E-Mail |
|
||||
| `html` | string | Nein | HTML-Inhalt der E-Mail |
|
||||
| `cc` | string | Nein | CC-E-Mail-Adresse \(durch Komma getrennt für mehrere\) |
|
||||
| `bcc` | string | Nein | BCC-E-Mail-Adresse \(durch Komma getrennt für mehrere\) |
|
||||
| `tags` | string | Nein | Tags für die E-Mail \(durch Komma getrennt\) |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob die Nachricht erfolgreich gesendet wurde |
|
||||
| `id` | string | Nachrichten-ID |
|
||||
| `message` | string | Antwortnachricht von Mailgun |
|
||||
|
||||
### `mailgun_get_message`
|
||||
|
||||
Eine gespeicherte Nachricht anhand ihres Schlüssels abrufen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | Mailgun API-Schlüssel |
|
||||
| `domain` | string | Ja | Mailgun-Domain |
|
||||
| `messageKey` | string | Ja | Speicherschlüssel der Nachricht |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob die Anfrage erfolgreich war |
|
||||
| `recipients` | string | Nachrichtenempfänger |
|
||||
| `from` | string | Absender-E-Mail |
|
||||
| `subject` | string | Nachrichtenbetreff |
|
||||
| `bodyPlain` | string | Nur-Text-Inhalt |
|
||||
| `strippedText` | string | Bereinigter Text |
|
||||
| `strippedSignature` | string | Bereinigte Signatur |
|
||||
| `bodyHtml` | string | HTML-Inhalt |
|
||||
| `strippedHtml` | string | Bereinigtes HTML |
|
||||
| `attachmentCount` | number | Anzahl der Anhänge |
|
||||
| `timestamp` | number | Nachrichtenzeitstempel |
|
||||
| `messageHeaders` | json | Nachrichtenheader |
|
||||
| `contentIdMap` | json | Content-ID-Zuordnung |
|
||||
|
||||
### `mailgun_list_messages`
|
||||
|
||||
Ereignisse (Logs) für über Mailgun gesendete Nachrichten auflisten
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | Mailgun API-Schlüssel |
|
||||
| `domain` | string | Ja | Mailgun-Domain |
|
||||
| `event` | string | Nein | Nach Ereignistyp filtern \(accepted, delivered, failed, opened, clicked, usw.\) |
|
||||
| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Ereignisse \(Standard: 100\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob die Anfrage erfolgreich war |
|
||||
| `items` | json | Array von Ereigniselementen |
|
||||
| `paging` | json | Paginierungsinformationen |
|
||||
|
||||
### `mailgun_create_mailing_list`
|
||||
|
||||
Eine neue Mailingliste erstellen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | Mailgun API-Schlüssel |
|
||||
| `address` | string | Ja | Mailinglisten-Adresse \(z.B. liste@beispiel.com\) |
|
||||
| `name` | string | Nein | Name der Mailingliste |
|
||||
| `description` | string | Nein | Beschreibung der Mailingliste |
|
||||
| `accessLevel` | string | Nein | Zugriffsebene: readonly, members oder everyone |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob die Liste erfolgreich erstellt wurde |
|
||||
| `message` | string | Antwortnachricht |
|
||||
| `list` | json | Details der erstellten Mailingliste |
|
||||
|
||||
### `mailgun_get_mailing_list`
|
||||
|
||||
Details einer Mailingliste abrufen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | Mailgun API-Schlüssel |
|
||||
| `address` | string | Ja | Mailinglisten-Adresse |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob die Anfrage erfolgreich war |
|
||||
| `list` | json | Details der Mailingliste |
|
||||
|
||||
### `mailgun_add_list_member`
|
||||
|
||||
Ein Mitglied zu einer Mailingliste hinzufügen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | Mailgun API-Schlüssel |
|
||||
| `listAddress` | string | Ja | Mailinglisten-Adresse |
|
||||
| `address` | string | Ja | E-Mail-Adresse des Mitglieds |
|
||||
| `name` | string | Nein | Name des Mitglieds |
|
||||
| `vars` | string | Nein | JSON-String mit benutzerdefinierten Variablen |
|
||||
| `subscribed` | boolean | Nein | Ob das Mitglied abonniert ist |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob das Mitglied erfolgreich hinzugefügt wurde |
|
||||
| `message` | string | Antwortnachricht |
|
||||
| `member` | json | Details des hinzugefügten Mitglieds |
|
||||
|
||||
### `mailgun_list_domains`
|
||||
|
||||
Alle Domains für Ihr Mailgun-Konto auflisten
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | Mailgun API-Schlüssel |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob die Anfrage erfolgreich war |
|
||||
| `totalCount` | number | Gesamtanzahl der Domains |
|
||||
| `items` | json | Array von Domain-Objekten |
|
||||
|
||||
### `mailgun_get_domain`
|
||||
|
||||
Details einer bestimmten Domain abrufen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | Mailgun API-Schlüssel |
|
||||
| `domain` | string | Ja | Domainname |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob die Anfrage erfolgreich war |
|
||||
| `domain` | json | Domain-Details |
|
||||
|
||||
## Hinweise
|
||||
|
||||
- Kategorie: `tools`
|
||||
- Typ: `mailgun`
|
||||
168
apps/docs/content/docs/de/tools/rds.mdx
Normal file
168
apps/docs/content/docs/de/tools/rds.mdx
Normal file
@@ -0,0 +1,168 @@
|
||||
---
|
||||
title: Amazon RDS
|
||||
description: Verbindung zu Amazon RDS über Data API
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="rds"
|
||||
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Amazon RDS Aurora Serverless](https://aws.amazon.com/rds/aurora/serverless/) ist eine vollständig verwaltete relationale Datenbank, die automatisch startet, herunterfährt und ihre Kapazität basierend auf den Anforderungen Ihrer Anwendung skaliert. Sie ermöglicht es Ihnen, SQL-Datenbanken in der Cloud zu betreiben, ohne Datenbankserver verwalten zu müssen.
|
||||
|
||||
Mit RDS Aurora Serverless können Sie:
|
||||
|
||||
- **Daten abfragen**: Flexible SQL-Abfragen über Ihre Tabellen ausführen
|
||||
- **Neue Datensätze einfügen**: Automatisch Daten zu Ihrer Datenbank hinzufügen
|
||||
- **Bestehende Datensätze aktualisieren**: Daten in Ihren Tabellen mit benutzerdefinierten Filtern ändern
|
||||
- **Datensätze löschen**: Unerwünschte Daten mit präzisen Kriterien entfernen
|
||||
- **Raw-SQL ausführen**: Jeden gültigen SQL-Befehl ausführen, der von Aurora unterstützt wird
|
||||
|
||||
In Sim ermöglicht die RDS-Integration Ihren Agenten, sicher und programmatisch mit Amazon Aurora Serverless-Datenbanken zu arbeiten. Zu den unterstützten Operationen gehören:
|
||||
|
||||
- **Abfrage**: SELECT und andere SQL-Abfragen ausführen, um Zeilen aus Ihrer Datenbank abzurufen
|
||||
- **Einfügen**: Neue Datensätze mit strukturierten Daten in Tabellen einfügen
|
||||
- **Aktualisieren**: Daten in Zeilen ändern, die Ihren angegebenen Bedingungen entsprechen
|
||||
- **Löschen**: Datensätze aus einer Tabelle nach benutzerdefinierten Filtern oder Kriterien entfernen
|
||||
- **Ausführen**: Raw-SQL für fortgeschrittene Szenarien ausführen
|
||||
|
||||
Diese Integration ermöglicht es Ihren Agenten, eine breite Palette von Datenbankoperationen ohne manuelle Eingriffe zu automatisieren. Durch die Verbindung von Sim mit Amazon RDS können Sie Agenten erstellen, die relationale Daten innerhalb Ihrer Workflows verwalten, aktualisieren und abrufen – alles ohne Datenbankinfrastruktur oder -verbindungen zu verwalten.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Nutzungsanweisungen
|
||||
|
||||
Integrieren Sie Amazon RDS Aurora Serverless in den Workflow mit der Data API. Kann Daten abfragen, einfügen, aktualisieren, löschen und Raw-SQL ausführen, ohne Datenbankverbindungen verwalten zu müssen.
|
||||
|
||||
## Tools
|
||||
|
||||
### `rds_query`
|
||||
|
||||
Führen Sie eine SELECT-Abfrage auf Amazon RDS mit der Data API aus
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
|
||||
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
|
||||
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
|
||||
| `resourceArn` | string | Ja | ARN des Aurora-DB-Clusters |
|
||||
| `secretArn` | string | Ja | ARN des Secrets Manager-Geheimnisses mit DB-Anmeldedaten |
|
||||
| `database` | string | Nein | Datenbankname (optional) |
|
||||
| `query` | string | Ja | SQL-SELECT-Abfrage zur Ausführung |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `rows` | array | Array der zurückgegebenen Zeilen aus der Abfrage |
|
||||
| `rowCount` | number | Anzahl der zurückgegebenen Zeilen |
|
||||
|
||||
### `rds_insert`
|
||||
|
||||
Daten in eine Amazon RDS-Tabelle mit der Data API einfügen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
|
||||
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
|
||||
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
|
||||
| `resourceArn` | string | Ja | ARN des Aurora-DB-Clusters |
|
||||
| `secretArn` | string | Ja | ARN des Secrets Manager-Geheimnisses mit DB-Anmeldedaten |
|
||||
| `database` | string | Nein | Datenbankname (optional) |
|
||||
| `table` | string | Ja | Tabellenname zum Einfügen |
|
||||
| `data` | object | Ja | Einzufügende Daten als Schlüssel-Wert-Paare |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `rows` | array | Array der eingefügten Zeilen |
|
||||
| `rowCount` | number | Anzahl der eingefügten Zeilen |
|
||||
|
||||
### `rds_update`
|
||||
|
||||
Daten in einer Amazon RDS-Tabelle über die Data API aktualisieren
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
|
||||
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
|
||||
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
|
||||
| `resourceArn` | string | Ja | ARN des Aurora-DB-Clusters |
|
||||
| `secretArn` | string | Ja | ARN des Secrets Manager-Geheimnisses mit DB-Anmeldedaten |
|
||||
| `database` | string | Nein | Datenbankname (optional) |
|
||||
| `table` | string | Ja | Name der zu aktualisierenden Tabelle |
|
||||
| `data` | object | Ja | Zu aktualisierende Daten als Schlüssel-Wert-Paare |
|
||||
| `conditions` | object | Ja | Bedingungen für die Aktualisierung (z.B. `{"id": 1}`) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `rows` | array | Array der aktualisierten Zeilen |
|
||||
| `rowCount` | number | Anzahl der aktualisierten Zeilen |
|
||||
|
||||
### `rds_delete`
|
||||
|
||||
Daten aus einer Amazon RDS-Tabelle über die Data API löschen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
|
||||
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
|
||||
| `secretAccessKey` | string | Ja | AWS geheimer Zugriffsschlüssel |
|
||||
| `resourceArn` | string | Ja | ARN des Aurora-DB-Clusters |
|
||||
| `secretArn` | string | Ja | ARN des Secrets Manager-Geheimnisses mit DB-Anmeldedaten |
|
||||
| `database` | string | Nein | Datenbankname (optional) |
|
||||
| `table` | string | Ja | Tabellenname, aus dem gelöscht werden soll |
|
||||
| `conditions` | object | Ja | Bedingungen für das Löschen (z.B. `{"id": 1}`) |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `rows` | array | Array der gelöschten Zeilen |
|
||||
| `rowCount` | number | Anzahl der gelöschten Zeilen |
|
||||
|
||||
### `rds_execute`
|
||||
|
||||
Rohes SQL auf Amazon RDS über die Data API ausführen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
|
||||
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
|
||||
| `secretAccessKey` | string | Ja | AWS geheimer Zugriffsschlüssel |
|
||||
| `resourceArn` | string | Ja | ARN des Aurora-DB-Clusters |
|
||||
| `secretArn` | string | Ja | ARN des Secrets Manager-Geheimnisses mit DB-Anmeldedaten |
|
||||
| `database` | string | Nein | Datenbankname (optional) |
|
||||
| `query` | string | Ja | Rohe SQL-Abfrage zur Ausführung |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `rows` | array | Array der zurückgegebenen oder betroffenen Zeilen |
|
||||
| `rowCount` | number | Anzahl der betroffenen Zeilen |
|
||||
|
||||
## Hinweise
|
||||
|
||||
- Kategorie: `tools`
|
||||
- Typ: `rds`
|
||||
@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="s3"
|
||||
color="#E0E0E0"
|
||||
color="linear-gradient(45deg, #1B660F 0%, #6CAE3E 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
|
||||
54
apps/docs/content/docs/de/tools/search.mdx
Normal file
54
apps/docs/content/docs/de/tools/search.mdx
Normal file
@@ -0,0 +1,54 @@
|
||||
---
|
||||
title: Suche
|
||||
description: Durchsuche das Web (0,01 $ pro Suche)
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="search"
|
||||
color="#3B82F6"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
Das **Suche**-Tool ermöglicht es dir, das Web innerhalb deiner Sim-Workflows mit hochmodernen Suchmaschinen zu durchsuchen. Nutze es, um die neuesten Informationen, Nachrichten, Fakten und Webinhalte direkt in deine Agenten, Automatisierungen oder Gespräche einzubinden.
|
||||
|
||||
- **Allgemeine Websuche**: Finde aktuelle Informationen aus dem Internet, um deine Workflows zu ergänzen.
|
||||
- **Automatisierte Abfragen**: Lass Agenten oder Programmlogik Suchanfragen stellen und die Ergebnisse automatisch verarbeiten.
|
||||
- **Strukturierte Ergebnisse**: Liefert die relevantesten Webergebnisse, einschließlich Titel, Link, Textauszug und Datum für jedes Ergebnis.
|
||||
|
||||
> **Hinweis:** Jede Suche kostet **0,01 $** pro Anfrage.
|
||||
|
||||
Dieses Tool ist ideal für jeden Workflow, bei dem deine Agenten Zugriff auf aktuelle Webdaten benötigen oder auf aktuelle Ereignisse verweisen, Recherchen durchführen oder ergänzende Inhalte abrufen müssen.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Nutzungsanleitung
|
||||
|
||||
Durchsuche das Web mit dem Suche-Tool. Jede Suche kostet 0,01 $ pro Anfrage.
|
||||
|
||||
## Tools
|
||||
|
||||
### `search_tool`
|
||||
|
||||
Durchsuche das Web. Liefert die relevantesten Webergebnisse, einschließlich Titel, Link, Textauszug und Datum für jedes Ergebnis.
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `query` | string | Ja | Die Suchanfrage |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `results` | json | Suchergebnisse |
|
||||
| `query` | string | Die Suchanfrage |
|
||||
| `totalResults` | number | Gesamtzahl der Ergebnisse |
|
||||
| `source` | string | Suchquelle \(exa\) |
|
||||
| `cost` | json | Kosteninformationen \(0,01 $\) |
|
||||
|
||||
## Notizen
|
||||
|
||||
- Kategorie: `tools`
|
||||
- Typ: `search`
|
||||
391
apps/docs/content/docs/de/tools/sendgrid.mdx
Normal file
391
apps/docs/content/docs/de/tools/sendgrid.mdx
Normal file
@@ -0,0 +1,391 @@
|
||||
---
|
||||
title: SendGrid
|
||||
description: Senden Sie E-Mails und verwalten Sie Kontakte, Listen und Vorlagen mit SendGrid
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="sendgrid"
|
||||
color="#1A82E2"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[SendGrid](https://sendgrid.com) ist eine führende cloudbasierte E-Mail-Zustellplattform, der Entwickler und Unternehmen vertrauen, um zuverlässige Transaktions- und Marketing-E-Mails in großem Umfang zu versenden. Mit seinen robusten APIs und leistungsstarken Tools ermöglicht SendGrid die Verwaltung aller Aspekte Ihrer E-Mail-Kommunikation, vom Versenden von Benachrichtigungen und Quittungen bis hin zur Verwaltung komplexer Marketingkampagnen.
|
||||
|
||||
SendGrid bietet Benutzern eine vollständige Suite von E-Mail-Funktionen, mit denen Sie kritische E-Mail-Workflows automatisieren und Kontaktlisten, Vorlagen und Empfängerengagement genau verwalten können. Die nahtlose Integration mit Sim ermöglicht es Agenten und Workflows, gezielte Nachrichten zu versenden, dynamische Kontakt- und Empfängerlisten zu pflegen, personalisierte E-Mails über Vorlagen auszulösen und die Ergebnisse in Echtzeit zu verfolgen.
|
||||
|
||||
Zu den wichtigsten Funktionen von SendGrid gehören:
|
||||
|
||||
- **Transaktions-E-Mails:** Versenden Sie automatisierte und umfangreiche Transaktions-E-Mails (wie Benachrichtigungen, Quittungen und Passwort-Zurücksetzungen).
|
||||
- **Dynamische Vorlagen:** Verwenden Sie umfangreiche HTML- oder Textvorlagen mit dynamischen Daten für hochpersonalisierte Kommunikation im großen Maßstab.
|
||||
- **Kontaktverwaltung:** Fügen Sie Marketing-Kontakte hinzu und aktualisieren Sie diese, verwalten Sie Empfängerlisten und Zielsegmente für Kampagnen.
|
||||
- **Unterstützung für Anhänge:** Fügen Sie Ihren E-Mails einen oder mehrere Dateianhänge hinzu.
|
||||
- **Umfassende API-Abdeckung:** Verwalten Sie E-Mails, Kontakte, Listen, Vorlagen, Unterdrückungsgruppen und mehr programmatisch.
|
||||
|
||||
Durch die Verbindung von SendGrid mit Sim können Ihre Agenten:
|
||||
|
||||
- Sowohl einfache als auch fortgeschrittene (vorlagenbasierte oder an mehrere Empfänger gerichtete) E-Mails als Teil eines beliebigen Workflows versenden.
|
||||
- Kontakte und Listen automatisch verwalten und segmentieren.
|
||||
- Vorlagen für Konsistenz und dynamische Personalisierung nutzen.
|
||||
- E-Mail-Engagement innerhalb Ihrer automatisierten Prozesse verfolgen und darauf reagieren.
|
||||
|
||||
Diese Integration ermöglicht es Ihnen, alle kritischen Kommunikationsabläufe zu automatisieren, sicherzustellen, dass Nachrichten die richtige Zielgruppe erreichen, und die Kontrolle über die E-Mail-Strategie Ihrer Organisation direkt aus Sim-Workflows zu behalten.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Nutzungsanleitung
|
||||
|
||||
Integrieren Sie SendGrid in Ihren Workflow. Senden Sie transaktionale E-Mails, verwalten Sie Marketing-Kontakte und -Listen und arbeiten Sie mit E-Mail-Vorlagen. Unterstützt dynamische Vorlagen, Anhänge und umfassendes Kontaktmanagement.
|
||||
|
||||
## Tools
|
||||
|
||||
### `sendgrid_send_mail`
|
||||
|
||||
Eine E-Mail über die SendGrid API senden
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `from` | string | Ja | E-Mail-Adresse des Absenders \(muss in SendGrid verifiziert sein\) |
|
||||
| `fromName` | string | Nein | Name des Absenders |
|
||||
| `to` | string | Ja | E-Mail-Adresse des Empfängers |
|
||||
| `toName` | string | Nein | Name des Empfängers |
|
||||
| `subject` | string | Nein | E-Mail-Betreff \(erforderlich, es sei denn, es wird eine Vorlage mit vordefiniertem Betreff verwendet\) |
|
||||
| `content` | string | Nein | E-Mail-Inhalt \(erforderlich, es sei denn, es wird eine Vorlage mit vordefiniertem Inhalt verwendet\) |
|
||||
| `contentType` | string | Nein | Inhaltstyp \(text/plain oder text/html\) |
|
||||
| `cc` | string | Nein | CC E-Mail-Adresse |
|
||||
| `bcc` | string | Nein | BCC E-Mail-Adresse |
|
||||
| `replyTo` | string | Nein | Antwort-an E-Mail-Adresse |
|
||||
| `replyToName` | string | Nein | Antwort-an Name |
|
||||
| `attachments` | file[] | Nein | Dateien, die der E-Mail angehängt werden sollen |
|
||||
| `templateId` | string | Nein | Zu verwendende SendGrid-Vorlagen-ID |
|
||||
| `dynamicTemplateData` | json | Nein | JSON-Objekt mit dynamischen Vorlagendaten |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob die E-Mail erfolgreich gesendet wurde |
|
||||
| `messageId` | string | SendGrid-Nachrichten-ID |
|
||||
| `to` | string | E-Mail-Adresse des Empfängers |
|
||||
| `subject` | string | E-Mail-Betreff |
|
||||
|
||||
### `sendgrid_add_contact`
|
||||
|
||||
Einen neuen Kontakt zu SendGrid hinzufügen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `email` | string | Ja | E-Mail-Adresse des Kontakts |
|
||||
| `firstName` | string | Nein | Vorname des Kontakts |
|
||||
| `lastName` | string | Nein | Nachname des Kontakts |
|
||||
| `customFields` | json | Nein | JSON-Objekt mit benutzerdefinierten Feld-Schlüssel-Wert-Paaren \(verwende Feld-IDs wie e1_T, e2_N, e3_D, nicht Feldnamen\) |
|
||||
| `listIds` | string | Nein | Kommagetrennte Listen-IDs, zu denen der Kontakt hinzugefügt werden soll |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | Job-ID zur Verfolgung der asynchronen Kontakterstellung |
|
||||
| `email` | string | E-Mail-Adresse des Kontakts |
|
||||
| `firstName` | string | Vorname des Kontakts |
|
||||
| `lastName` | string | Nachname des Kontakts |
|
||||
| `message` | string | Statusmeldung |
|
||||
|
||||
### `sendgrid_get_contact`
|
||||
|
||||
Einen bestimmten Kontakt anhand der ID von SendGrid abrufen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `contactId` | string | Ja | Kontakt-ID |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | Kontakt-ID |
|
||||
| `email` | string | E-Mail-Adresse des Kontakts |
|
||||
| `firstName` | string | Vorname des Kontakts |
|
||||
| `lastName` | string | Nachname des Kontakts |
|
||||
| `createdAt` | string | Erstellungszeitstempel |
|
||||
| `updatedAt` | string | Zeitstempel der letzten Aktualisierung |
|
||||
| `listIds` | json | Array von Listen-IDs, zu denen der Kontakt gehört |
|
||||
| `customFields` | json | Benutzerdefinierte Feldwerte |
|
||||
|
||||
### `sendgrid_search_contacts`
|
||||
|
||||
Suche nach Kontakten in SendGrid mit einer Abfrage
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `query` | string | Ja | Suchabfrage (z.B. "email LIKE '%example.com%' AND CONTAINS(list_ids, 'list-id')") |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `contacts` | json | Array übereinstimmender Kontakte |
|
||||
| `contactCount` | number | Gesamtzahl der gefundenen Kontakte |
|
||||
|
||||
### `sendgrid_delete_contacts`
|
||||
|
||||
Einen oder mehrere Kontakte aus SendGrid löschen
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `contactIds` | string | Ja | Kommagetrennte Kontakt-IDs zum Löschen |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | Job-ID für die Löschanfrage |
|
||||
|
||||
### `sendgrid_create_list`
|
||||
|
||||
Erstellen einer neuen Kontaktliste in SendGrid
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `name` | string | Ja | Listenname |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | Listen-ID |
|
||||
| `name` | string | Listenname |
|
||||
| `contactCount` | number | Anzahl der Kontakte in der Liste |
|
||||
|
||||
### `sendgrid_get_list`
|
||||
|
||||
Eine bestimmte Liste anhand der ID von SendGrid abrufen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `listId` | string | Ja | Listen-ID |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | Listen-ID |
|
||||
| `name` | string | Listenname |
|
||||
| `contactCount` | number | Anzahl der Kontakte in der Liste |
|
||||
|
||||
### `sendgrid_list_all_lists`
|
||||
|
||||
Alle Kontaktlisten von SendGrid abrufen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `pageSize` | number | Nein | Anzahl der Listen, die pro Seite zurückgegeben werden sollen (Standard: 100) |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `lists` | json | Array von Listen |
|
||||
|
||||
### `sendgrid_delete_list`
|
||||
|
||||
Eine Kontaktliste von SendGrid löschen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `listId` | string | Ja | Listen-ID zum Löschen |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Erfolgsmeldung |
|
||||
|
||||
### `sendgrid_add_contacts_to_list`
|
||||
|
||||
Kontakte hinzufügen oder aktualisieren und einer Liste in SendGrid zuweisen (verwendet PUT /v3/marketing/contacts)
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `listId` | string | Ja | Listen-ID, zu der Kontakte hinzugefügt werden sollen |
|
||||
| `contacts` | json | Ja | JSON-Array von Kontaktobjekten. Jeder Kontakt muss mindestens Folgendes enthalten: E-Mail \(oder phone_number_id/external_id/anonymous_id\). Beispiel: \[\{"email": "user@example.com", "first_name": "John"\}\] |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | Job-ID zur Verfolgung des asynchronen Vorgangs |
|
||||
| `message` | string | Statusmeldung |
|
||||
|
||||
### `sendgrid_remove_contacts_from_list`
|
||||
|
||||
Kontakte aus einer bestimmten Liste in SendGrid entfernen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `listId` | string | Ja | Listen-ID |
|
||||
| `contactIds` | string | Ja | Kommagetrennte Kontakt-IDs, die aus der Liste entfernt werden sollen |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | Job-ID für die Anfrage |
|
||||
|
||||
### `sendgrid_create_template`
|
||||
|
||||
Eine neue E-Mail-Vorlage in SendGrid erstellen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `name` | string | Ja | Vorlagenname |
|
||||
| `generation` | string | Nein | Vorlagenerstellungstyp \(legacy oder dynamic, standard: dynamic\) |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | Vorlagen-ID |
|
||||
| `name` | string | Vorlagenname |
|
||||
| `generation` | string | Vorlagenerstellung |
|
||||
| `updatedAt` | string | Zeitstempel der letzten Aktualisierung |
|
||||
| `versions` | json | Array von Vorlagenversionen |
|
||||
|
||||
### `sendgrid_get_template`
|
||||
|
||||
Eine bestimmte Vorlage anhand der ID von SendGrid abrufen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `templateId` | string | Ja | Vorlagen-ID |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | Vorlagen-ID |
|
||||
| `name` | string | Vorlagenname |
|
||||
| `generation` | string | Vorlagenerstellung |
|
||||
| `updatedAt` | string | Zeitstempel der letzten Aktualisierung |
|
||||
| `versions` | json | Array von Vorlagenversionen |
|
||||
|
||||
### `sendgrid_list_templates`
|
||||
|
||||
Alle E-Mail-Vorlagen von SendGrid abrufen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `generations` | string | Nein | Nach Generation filtern (legacy, dynamic oder beides) |
|
||||
| `pageSize` | number | Nein | Anzahl der Vorlagen pro Seite (Standard: 20) |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `templates` | json | Array von Vorlagen |
|
||||
|
||||
### `sendgrid_delete_template`
|
||||
|
||||
Eine E-Mail-Vorlage von SendGrid löschen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `templateId` | string | Ja | Zu löschende Vorlagen-ID |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Erfolgsstatus der Operation |
|
||||
| `messageId` | string | E-Mail-Nachrichten-ID (send_mail) |
|
||||
| `id` | string | Ressourcen-ID |
|
||||
| `jobId` | string | Job-ID für asynchrone Operationen |
|
||||
| `email` | string | E-Mail-Adresse |
|
||||
| `firstName` | string | Vorname |
|
||||
| `lastName` | string | Nachname |
|
||||
| `contacts` | json | Array von Kontakten |
|
||||
| `contactCount` | number | Anzahl der Kontakte |
|
||||
| `lists` | json | Array von Listen |
|
||||
| `templates` | json | Array von Vorlagen |
|
||||
| `message` | string | Status- oder Erfolgsmeldung |
|
||||
| `name` | string | Ressourcenname |
|
||||
| `generation` | string | Vorlagengeneration |
|
||||
|
||||
### `sendgrid_create_template_version`
|
||||
|
||||
Eine neue Version einer E-Mail-Vorlage in SendGrid erstellen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Ja | SendGrid API-Schlüssel |
|
||||
| `templateId` | string | Ja | Vorlagen-ID |
|
||||
| `name` | string | Ja | Versionsname |
|
||||
| `subject` | string | Ja | E-Mail-Betreffzeile |
|
||||
| `htmlContent` | string | Nein | HTML-Inhalt der Vorlage |
|
||||
| `plainContent` | string | Nein | Nur-Text-Inhalt der Vorlage |
|
||||
| `active` | boolean | Nein | Ob diese Version aktiv ist \(Standard: true\) |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | Versions-ID |
|
||||
| `templateId` | string | Vorlagen-ID |
|
||||
| `name` | string | Versionsname |
|
||||
| `subject` | string | E-Mail-Betreff |
|
||||
| `active` | boolean | Ob diese Version aktiv ist |
|
||||
| `htmlContent` | string | HTML-Inhalt |
|
||||
| `plainContent` | string | Nur-Text-Inhalt |
|
||||
| `updatedAt` | string | Zeitstempel der letzten Aktualisierung |
|
||||
|
||||
## Hinweise
|
||||
|
||||
- Kategorie: `tools`
|
||||
- Typ: `sendgrid`
|
||||
73
apps/docs/content/docs/de/tools/smtp.mdx
Normal file
73
apps/docs/content/docs/de/tools/smtp.mdx
Normal file
@@ -0,0 +1,73 @@
|
||||
---
|
||||
title: SMTP
|
||||
description: E-Mails über jeden SMTP-Mailserver versenden
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="smtp"
|
||||
color="#4A5568"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[SMTP (Simple Mail Transfer Protocol)](https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol) ist der grundlegende Standard für die E-Mail-Übertragung im Internet. Durch die Verbindung mit einem SMTP-kompatiblen Server – wie Gmail, Outlook oder der eigenen Mail-Infrastruktur Ihrer Organisation – können Sie E-Mails programmatisch versenden und Ihre ausgehende Kommunikation automatisieren.
|
||||
|
||||
Die SMTP-Integration ermöglicht es Ihnen, den E-Mail-Versand durch direkte Serververbindung vollständig anzupassen und unterstützt sowohl einfache als auch fortgeschrittene E-Mail-Anwendungsfälle. Mit SMTP können Sie jeden Aspekt der Nachrichtenzustellung, des Empfängermanagements und der Inhaltsformatierung kontrollieren, was es ideal für transaktionale Benachrichtigungen, Massenmailings und jeden automatisierten Workflow macht, der eine robuste ausgehende E-Mail-Zustellung erfordert.
|
||||
|
||||
**Zu den wichtigsten Funktionen der SMTP-Integration gehören:**
|
||||
|
||||
- **Universeller E-Mail-Versand:** Senden Sie E-Mails über jeden SMTP-Server durch Konfiguration standardmäßiger Serververbindungsparameter.
|
||||
- **Anpassbare Absender und Empfänger:** Legen Sie Absenderadresse, Anzeigename, Hauptempfänger sowie CC- und BCC-Felder fest.
|
||||
- **Unterstützung für umfangreiche Inhalte:** Senden Sie Nur-Text- oder reich formatierte HTML-E-Mails entsprechend Ihren Anforderungen.
|
||||
- **Anhänge:** Fügen Sie ausgehenden E-Mails mehrere Dateien als Anhänge hinzu.
|
||||
- **Flexible Sicherheit:** Verbinden Sie sich über TLS, SSL oder Standardprotokolle (unverschlüsselt), je nach Unterstützung Ihres SMTP-Anbieters.
|
||||
- **Erweiterte Header:** Setzen Sie Antwort-an-Header und andere erweiterte E-Mail-Optionen, um komplexe Mailflows und Benutzerinteraktionen zu ermöglichen.
|
||||
|
||||
Durch die Integration von SMTP mit Sim können Agenten und Workflows programmatisch E-Mails als Teil jedes automatisierten Prozesses versenden – von Benachrichtigungen und Bestätigungen bis hin zur Automatisierung externer Kommunikation, Berichterstattung und Dokumentenzustellung. Dies bietet einen hochflexiblen, anbieterunabhängigen Ansatz zur Verwaltung von E-Mails direkt innerhalb Ihrer KI-gesteuerten Prozesse.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Gebrauchsanweisung
|
||||
|
||||
Senden Sie E-Mails über jeden SMTP-Server (Gmail, Outlook, benutzerdefinierte Server usw.). Konfigurieren Sie SMTP-Verbindungseinstellungen und senden Sie E-Mails mit voller Kontrolle über Inhalt, Empfänger und Anhänge.
|
||||
|
||||
## Tools
|
||||
|
||||
### `smtp_send_mail`
|
||||
|
||||
E-Mails über SMTP-Server senden
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `smtpHost` | string | Ja | SMTP-Server-Hostname \(z.B. smtp.gmail.com\) |
|
||||
| `smtpPort` | number | Ja | SMTP-Server-Port \(587 für TLS, 465 für SSL\) |
|
||||
| `smtpUsername` | string | Ja | SMTP-Authentifizierungsbenutzername |
|
||||
| `smtpPassword` | string | Ja | SMTP-Authentifizierungspasswort |
|
||||
| `smtpSecure` | string | Ja | Sicherheitsprotokoll \(TLS, SSL oder None\) |
|
||||
| `from` | string | Ja | Absender-E-Mail-Adresse |
|
||||
| `to` | string | Ja | Empfänger-E-Mail-Adresse |
|
||||
| `subject` | string | Ja | E-Mail-Betreff |
|
||||
| `body` | string | Ja | E-Mail-Inhalt |
|
||||
| `contentType` | string | Nein | Inhaltstyp \(text oder html\) |
|
||||
| `fromName` | string | Nein | Anzeigename für Absender |
|
||||
| `cc` | string | Nein | CC-Empfänger \(durch Komma getrennt\) |
|
||||
| `bcc` | string | Nein | BCC-Empfänger \(durch Komma getrennt\) |
|
||||
| `replyTo` | string | Nein | Antwort-an E-Mail-Adresse |
|
||||
| `attachments` | file[] | Nein | Dateien, die der E-Mail angehängt werden sollen |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob die E-Mail erfolgreich gesendet wurde |
|
||||
| `messageId` | string | Nachrichten-ID vom SMTP-Server |
|
||||
| `to` | string | Empfänger-E-Mail-Adresse |
|
||||
| `subject` | string | E-Mail-Betreff |
|
||||
| `error` | string | Fehlermeldung, wenn das Senden fehlgeschlagen ist |
|
||||
|
||||
## Notizen
|
||||
|
||||
- Kategorie: `tools`
|
||||
- Typ: `smtp`
|
||||
94
apps/docs/content/docs/en/tools/apify.mdx
Normal file
94
apps/docs/content/docs/en/tools/apify.mdx
Normal file
@@ -0,0 +1,94 @@
|
||||
---
|
||||
title: Apify
|
||||
description: Run Apify actors and retrieve results
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="apify"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Apify](https://apify.com/) is a powerful platform for building, deploying, and running web automation and web scraping actors at scale. Apify enables you to extract useful data from any website, automate workflows, and connect your data pipelines seamlessly.
|
||||
|
||||
With Apify, you can:
|
||||
|
||||
- **Run ready-made or custom actors**: Integrate public actors or develop your own, automating a wide range of web data extraction and browser tasks.
|
||||
- **Retrieve datasets**: Access and manage structured datasets collected by actors in real time.
|
||||
- **Scale web automation**: Leverage cloud infrastructure to run tasks reliably, asynchronously or synchronously, with robust error handling.
|
||||
|
||||
In Sim, the Apify integration allows your agents to perform core Apify operations programmatically:
|
||||
|
||||
- **Run Actor (Sync)**: Use `apify_run_actor_sync` to launch an Apify actor and wait for its completion, retrieving the results as soon as the run finishes.
|
||||
- **Run Actor (Async)**: Use `apify_run_actor_async` to start an actor in the background and periodically poll for results, suitable for longer or complex jobs.
|
||||
|
||||
These operations equip your agents to automate, scrape, and orchestrate data collection or browser automation tasks directly inside workflows — all with flexible configuration and result handling, without the need for manual runs or external tools. Integrate Apify as a dynamic automation and data-extraction engine that programmatically powers your agents' web-scale workflows.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
|
||||
## Usage Instructions
|
||||
|
||||
Integrate Apify into your workflow. Run any Apify actor with custom input and retrieve results. Supports both synchronous and asynchronous execution with automatic dataset fetching.
|
||||
|
||||
|
||||
|
||||
## Tools
|
||||
|
||||
### `apify_run_actor_sync`
|
||||
|
||||
Run an APIFY actor synchronously and get results (max 5 minutes)
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | APIFY API token from console.apify.com/account#/integrations |
|
||||
| `actorId` | string | Yes | Actor ID or username/actor-name \(e.g., "janedoe/my-actor" or actor ID\) |
|
||||
| `input` | string | No | Actor input as JSON string. See actor documentation for required fields. |
|
||||
| `timeout` | number | No | Timeout in seconds \(default: actor default\) |
|
||||
| `build` | string | No | Actor build to run \(e.g., "latest", "beta", or build tag/number\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Whether the actor run succeeded |
|
||||
| `runId` | string | APIFY run ID |
|
||||
| `status` | string | Run status \(SUCCEEDED, FAILED, etc.\) |
|
||||
| `datasetId` | string | Dataset ID containing results |
|
||||
| `items` | array | Dataset items \(if completed\) |
|
||||
|
||||
### `apify_run_actor_async`
|
||||
|
||||
Run an APIFY actor asynchronously with polling for long-running tasks
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | APIFY API token from console.apify.com/account#/integrations |
|
||||
| `actorId` | string | Yes | Actor ID or username/actor-name \(e.g., "janedoe/my-actor" or actor ID\) |
|
||||
| `input` | string | No | Actor input as JSON string |
|
||||
| `waitForFinish` | number | No | Initial wait time in seconds \(0-60\) before polling starts |
|
||||
| `itemLimit` | number | No | Max dataset items to fetch \(1-250000, default 100\) |
|
||||
| `timeout` | number | No | Timeout in seconds \(default: actor default\) |
|
||||
| `build` | string | No | Actor build to run \(e.g., "latest", "beta", or build tag/number\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Whether the actor run succeeded |
|
||||
| `runId` | string | APIFY run ID |
|
||||
| `status` | string | Run status \(SUCCEEDED, FAILED, etc.\) |
|
||||
| `datasetId` | string | Dataset ID containing results |
|
||||
| `items` | array | Dataset items \(if completed\) |
|
||||
|
||||
|
||||
|
||||
## Notes
|
||||
|
||||
- Category: `tools`
|
||||
- Type: `apify`
|
||||
193
apps/docs/content/docs/en/tools/dynamodb.mdx
Normal file
193
apps/docs/content/docs/en/tools/dynamodb.mdx
Normal file
@@ -0,0 +1,193 @@
|
||||
---
|
||||
title: Amazon DynamoDB
|
||||
description: Connect to Amazon DynamoDB
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="dynamodb"
|
||||
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Amazon DynamoDB](https://aws.amazon.com/dynamodb/) is a fully managed NoSQL database service offered by AWS that provides fast and predictable performance with seamless scalability. DynamoDB lets you store and retrieve any amount of data and serves any level of request traffic, without the need for you to manage hardware or infrastructure.
|
||||
|
||||
With DynamoDB, you can:
|
||||
|
||||
- **Get items**: Look up items in your tables using primary keys
|
||||
- **Put items**: Add or replace items in your tables
|
||||
- **Query items**: Retrieve multiple items using queries across indexes
|
||||
- **Scan tables**: Read all or part of the data in a table
|
||||
- **Update items**: Modify specific attributes of existing items
|
||||
- **Delete items**: Remove records from your tables
|
||||
|
||||
In Sim, the DynamoDB integration enables your agents to securely access and manipulate DynamoDB tables using AWS credentials. Supported operations include:
|
||||
|
||||
- **Get**: Retrieve an item by its key
|
||||
- **Put**: Insert or overwrite items
|
||||
- **Query**: Run queries using key conditions and filters
|
||||
- **Scan**: Read multiple items by scanning the table or index
|
||||
- **Update**: Change specific attributes of one or more items
|
||||
- **Delete**: Remove an item from a table
|
||||
|
||||
This integration empowers Sim agents to automate data management tasks within your DynamoDB tables programmatically, so you can build workflows that manage, modify, and retrieve scalable NoSQL data without manual effort or server management.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
|
||||
## Usage Instructions
|
||||
|
||||
Integrate Amazon DynamoDB into workflows. Supports Get, Put, Query, Scan, Update, and Delete operations on DynamoDB tables.
|
||||
|
||||
|
||||
|
||||
## Tools
|
||||
|
||||
### `dynamodb_get`
|
||||
|
||||
Get an item from a DynamoDB table by primary key
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
|
||||
| `accessKeyId` | string | Yes | AWS access key ID |
|
||||
| `secretAccessKey` | string | Yes | AWS secret access key |
|
||||
| `tableName` | string | Yes | DynamoDB table name |
|
||||
| `key` | object | Yes | Primary key of the item to retrieve |
|
||||
| `consistentRead` | boolean | No | Use strongly consistent read |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Operation status message |
|
||||
| `item` | object | Retrieved item |
|
||||
|
||||
### `dynamodb_put`
|
||||
|
||||
Put an item into a DynamoDB table
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
|
||||
| `accessKeyId` | string | Yes | AWS access key ID |
|
||||
| `secretAccessKey` | string | Yes | AWS secret access key |
|
||||
| `tableName` | string | Yes | DynamoDB table name |
|
||||
| `item` | object | Yes | Item to put into the table |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Operation status message |
|
||||
| `item` | object | Created item |
|
||||
|
||||
### `dynamodb_query`
|
||||
|
||||
Query items from a DynamoDB table using key conditions
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
|
||||
| `accessKeyId` | string | Yes | AWS access key ID |
|
||||
| `secretAccessKey` | string | Yes | AWS secret access key |
|
||||
| `tableName` | string | Yes | DynamoDB table name |
|
||||
| `keyConditionExpression` | string | Yes | Key condition expression \(e.g., "pk = :pk"\) |
|
||||
| `filterExpression` | string | No | Filter expression for results |
|
||||
| `expressionAttributeNames` | object | No | Attribute name mappings for reserved words |
|
||||
| `expressionAttributeValues` | object | No | Expression attribute values |
|
||||
| `indexName` | string | No | Secondary index name to query |
|
||||
| `limit` | number | No | Maximum number of items to return |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Operation status message |
|
||||
| `items` | array | Array of items returned |
|
||||
| `count` | number | Number of items returned |
|
||||
|
||||
### `dynamodb_scan`
|
||||
|
||||
Scan all items in a DynamoDB table
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
|
||||
| `accessKeyId` | string | Yes | AWS access key ID |
|
||||
| `secretAccessKey` | string | Yes | AWS secret access key |
|
||||
| `tableName` | string | Yes | DynamoDB table name |
|
||||
| `filterExpression` | string | No | Filter expression for results |
|
||||
| `projectionExpression` | string | No | Attributes to retrieve |
|
||||
| `expressionAttributeNames` | object | No | Attribute name mappings for reserved words |
|
||||
| `expressionAttributeValues` | object | No | Expression attribute values |
|
||||
| `limit` | number | No | Maximum number of items to return |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Operation status message |
|
||||
| `items` | array | Array of items returned |
|
||||
| `count` | number | Number of items returned |
|
||||
|
||||
### `dynamodb_update`
|
||||
|
||||
Update an item in a DynamoDB table
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
|
||||
| `accessKeyId` | string | Yes | AWS access key ID |
|
||||
| `secretAccessKey` | string | Yes | AWS secret access key |
|
||||
| `tableName` | string | Yes | DynamoDB table name |
|
||||
| `key` | object | Yes | Primary key of the item to update |
|
||||
| `updateExpression` | string | Yes | Update expression \(e.g., "SET #name = :name"\) |
|
||||
| `expressionAttributeNames` | object | No | Attribute name mappings for reserved words |
|
||||
| `expressionAttributeValues` | object | No | Expression attribute values |
|
||||
| `conditionExpression` | string | No | Condition that must be met for the update to succeed |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Operation status message |
|
||||
| `item` | object | Updated item |
|
||||
|
||||
### `dynamodb_delete`
|
||||
|
||||
Delete an item from a DynamoDB table
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
|
||||
| `accessKeyId` | string | Yes | AWS access key ID |
|
||||
| `secretAccessKey` | string | Yes | AWS secret access key |
|
||||
| `tableName` | string | Yes | DynamoDB table name |
|
||||
| `key` | object | Yes | Primary key of the item to delete |
|
||||
| `conditionExpression` | string | No | Condition that must be met for the delete to succeed |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Operation status message |
|
||||
|
||||
|
||||
|
||||
## Notes
|
||||
|
||||
- Category: `tools`
|
||||
- Type: `dynamodb`
|
||||
88
apps/docs/content/docs/en/tools/linkedin.mdx
Normal file
88
apps/docs/content/docs/en/tools/linkedin.mdx
Normal file
@@ -0,0 +1,88 @@
|
||||
---
|
||||
title: LinkedIn
|
||||
description: Share posts and manage your LinkedIn presence
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="linkedin"
|
||||
color="#0072B1"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[LinkedIn](https://www.linkedin.com) is the world’s largest professional networking platform, empowering users to build their careers, connect with their network, and share professional content. LinkedIn is widely used by professionals across industries for personal branding, recruiting, job search, and business development.
|
||||
|
||||
With LinkedIn, you can easily share posts to your personal feed to engage with your network, and access information about your profile to highlight your professional achievements. Automated integration with Sim allows you to leverage LinkedIn functionality programmatically—enabling agents and workflows to post updates, report on your professional presence, and keep your feed active without manual effort.
|
||||
|
||||
Key LinkedIn features available through this integration include:
|
||||
|
||||
- **Share Posts:** Automatically publish professional updates, articles, or announcements to your LinkedIn personal feed.
|
||||
- **Profile Information:** Retrieve detailed information about your LinkedIn profile to monitor or use in downstream tasks within your workflows.
|
||||
|
||||
These capabilities make it easy to keep your LinkedIn network engaged and to extend your professional reach efficiently as part of your AI or workflow automation strategy.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
|
||||
## Usage Instructions
|
||||
|
||||
Integrate LinkedIn into workflows. Share posts to your personal feed and access your LinkedIn profile information.
|
||||
|
||||
|
||||
|
||||
## Tools
|
||||
|
||||
### `linkedin_share_post`
|
||||
|
||||
Share a post to your personal LinkedIn feed
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `text` | string | Yes | The text content of your LinkedIn post |
|
||||
| `visibility` | string | No | Who can see this post: "PUBLIC" or "CONNECTIONS" \(default: "PUBLIC"\) |
|
||||
| `request` | string | No | No description |
|
||||
| `output` | string | No | No description |
|
||||
| `output` | string | No | No description |
|
||||
| `specificContent` | string | No | No description |
|
||||
| `shareCommentary` | string | No | No description |
|
||||
| `visibility` | string | No | No description |
|
||||
| `headers` | string | No | No description |
|
||||
| `output` | string | No | No description |
|
||||
| `output` | string | No | No description |
|
||||
| `output` | string | No | No description |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Operation success status |
|
||||
| `postId` | string | Created post ID |
|
||||
| `profile` | json | LinkedIn profile information |
|
||||
| `error` | string | Error message if operation failed |
|
||||
|
||||
### `linkedin_get_profile`
|
||||
|
||||
Retrieve your LinkedIn profile information
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Operation success status |
|
||||
| `postId` | string | Created post ID |
|
||||
| `profile` | json | LinkedIn profile information |
|
||||
| `error` | string | Error message if operation failed |
|
||||
|
||||
|
||||
|
||||
## Notes
|
||||
|
||||
- Category: `tools`
|
||||
- Type: `linkedin`
|
||||
221
apps/docs/content/docs/en/tools/mailgun.mdx
Normal file
221
apps/docs/content/docs/en/tools/mailgun.mdx
Normal file
@@ -0,0 +1,221 @@
|
||||
---
|
||||
title: Mailgun
|
||||
description: Send emails and manage mailing lists with Mailgun
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="mailgun"
|
||||
color="#F06248"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Mailgun](https://www.mailgun.com) is a powerful email delivery service designed for developers and businesses to send, receive, and track emails effortlessly. Mailgun enables you to leverage robust APIs for reliable transactional and marketing email, flexible mailing list management, and advanced event tracking.
|
||||
|
||||
With Mailgun's comprehensive feature set, you can automate key email operations and closely monitor deliverability and recipient engagement. This makes it an ideal solution for workflow automation where communications, notifications, and campaign mails are core parts of your processes.
|
||||
|
||||
Key features of Mailgun include:
|
||||
|
||||
- **Transactional Email Sending:** Deliver high-volume emails such as account notifications, receipts, alerts, and password resets.
|
||||
- **Rich Email Content:** Send both plain text and HTML emails, and use tags for categorizing and tracking your messages.
|
||||
- **Mailing List Management:** Create, update, and manage mailing lists and members to send grouped communications efficiently.
|
||||
- **Domain Information:** Retrieve details about your sending domains to monitor configuration and health.
|
||||
- **Event Tracking:** Analyze email deliverability and engagement with detailed event data on sent messages.
|
||||
- **Message Retrieval:** Access stored messages for compliance, analysis, or troubleshooting needs.
|
||||
|
||||
By integrating Mailgun into Sim, your agents are empowered to programmatically send emails, manage email lists, access domain information, and monitor real-time events as part of automated workflows. This allows for intelligent, data-driven engagement with your users directly from your AI-powered processes.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
|
||||
## Usage Instructions
|
||||
|
||||
Integrate Mailgun into your workflow. Send transactional emails, manage mailing lists and members, view domain information, and track email events. Supports text and HTML emails, tags for tracking, and comprehensive list management.
|
||||
|
||||
|
||||
|
||||
## Tools
|
||||
|
||||
### `mailgun_send_message`
|
||||
|
||||
Send an email using Mailgun API
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Mailgun API key |
|
||||
| `domain` | string | Yes | Mailgun domain \(e.g., mg.example.com\) |
|
||||
| `from` | string | Yes | Sender email address |
|
||||
| `to` | string | Yes | Recipient email address \(comma-separated for multiple\) |
|
||||
| `subject` | string | Yes | Email subject |
|
||||
| `text` | string | No | Plain text body of the email |
|
||||
| `html` | string | No | HTML body of the email |
|
||||
| `cc` | string | No | CC email address \(comma-separated for multiple\) |
|
||||
| `bcc` | string | No | BCC email address \(comma-separated for multiple\) |
|
||||
| `tags` | string | No | Tags for the email \(comma-separated\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Whether the message was sent successfully |
|
||||
| `id` | string | Message ID |
|
||||
| `message` | string | Response message from Mailgun |
|
||||
|
||||
### `mailgun_get_message`
|
||||
|
||||
Retrieve a stored message by its key
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Mailgun API key |
|
||||
| `domain` | string | Yes | Mailgun domain |
|
||||
| `messageKey` | string | Yes | Message storage key |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Whether the request was successful |
|
||||
| `recipients` | string | Message recipients |
|
||||
| `from` | string | Sender email |
|
||||
| `subject` | string | Message subject |
|
||||
| `bodyPlain` | string | Plain text body |
|
||||
| `strippedText` | string | Stripped text |
|
||||
| `strippedSignature` | string | Stripped signature |
|
||||
| `bodyHtml` | string | HTML body |
|
||||
| `strippedHtml` | string | Stripped HTML |
|
||||
| `attachmentCount` | number | Number of attachments |
|
||||
| `timestamp` | number | Message timestamp |
|
||||
| `messageHeaders` | json | Message headers |
|
||||
| `contentIdMap` | json | Content ID map |
|
||||
|
||||
### `mailgun_list_messages`
|
||||
|
||||
List events (logs) for messages sent through Mailgun
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Mailgun API key |
|
||||
| `domain` | string | Yes | Mailgun domain |
|
||||
| `event` | string | No | Filter by event type \(accepted, delivered, failed, opened, clicked, etc.\) |
|
||||
| `limit` | number | No | Maximum number of events to return \(default: 100\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Whether the request was successful |
|
||||
| `items` | json | Array of event items |
|
||||
| `paging` | json | Paging information |
|
||||
|
||||
### `mailgun_create_mailing_list`
|
||||
|
||||
Create a new mailing list
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Mailgun API key |
|
||||
| `address` | string | Yes | Mailing list address \(e.g., list@example.com\) |
|
||||
| `name` | string | No | Mailing list name |
|
||||
| `description` | string | No | Mailing list description |
|
||||
| `accessLevel` | string | No | Access level: readonly, members, or everyone |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Whether the list was created successfully |
|
||||
| `message` | string | Response message |
|
||||
| `list` | json | Created mailing list details |
|
||||
|
||||
### `mailgun_get_mailing_list`
|
||||
|
||||
Get details of a mailing list
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Mailgun API key |
|
||||
| `address` | string | Yes | Mailing list address |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Whether the request was successful |
|
||||
| `list` | json | Mailing list details |
|
||||
|
||||
### `mailgun_add_list_member`
|
||||
|
||||
Add a member to a mailing list
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Mailgun API key |
|
||||
| `listAddress` | string | Yes | Mailing list address |
|
||||
| `address` | string | Yes | Member email address |
|
||||
| `name` | string | No | Member name |
|
||||
| `vars` | string | No | JSON string of custom variables |
|
||||
| `subscribed` | boolean | No | Whether the member is subscribed |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Whether the member was added successfully |
|
||||
| `message` | string | Response message |
|
||||
| `member` | json | Added member details |
|
||||
|
||||
### `mailgun_list_domains`
|
||||
|
||||
List all domains for your Mailgun account
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Mailgun API key |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Whether the request was successful |
|
||||
| `totalCount` | number | Total number of domains |
|
||||
| `items` | json | Array of domain objects |
|
||||
|
||||
### `mailgun_get_domain`
|
||||
|
||||
Get details of a specific domain
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Mailgun API key |
|
||||
| `domain` | string | Yes | Domain name |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Whether the request was successful |
|
||||
| `domain` | json | Domain details |
|
||||
|
||||
|
||||
|
||||
## Notes
|
||||
|
||||
- Category: `tools`
|
||||
- Type: `mailgun`
|
||||
@@ -2,6 +2,7 @@
|
||||
"pages": [
|
||||
"index",
|
||||
"airtable",
|
||||
"apify",
|
||||
"apollo",
|
||||
"arxiv",
|
||||
"asana",
|
||||
@@ -10,6 +11,7 @@
|
||||
"clay",
|
||||
"confluence",
|
||||
"discord",
|
||||
"dynamodb",
|
||||
"elevenlabs",
|
||||
"exa",
|
||||
"file",
|
||||
@@ -33,8 +35,10 @@
|
||||
"jira",
|
||||
"knowledge",
|
||||
"linear",
|
||||
"linkedin",
|
||||
"linkup",
|
||||
"mailchimp",
|
||||
"mailgun",
|
||||
"mem0",
|
||||
"memory",
|
||||
"microsoft_excel",
|
||||
@@ -56,14 +60,18 @@
|
||||
"posthog",
|
||||
"pylon",
|
||||
"qdrant",
|
||||
"rds",
|
||||
"reddit",
|
||||
"resend",
|
||||
"s3",
|
||||
"salesforce",
|
||||
"search",
|
||||
"sendgrid",
|
||||
"sentry",
|
||||
"serper",
|
||||
"sharepoint",
|
||||
"slack",
|
||||
"smtp",
|
||||
"stagehand",
|
||||
"stagehand_agent",
|
||||
"stripe",
|
||||
|
||||
173
apps/docs/content/docs/en/tools/rds.mdx
Normal file
173
apps/docs/content/docs/en/tools/rds.mdx
Normal file
@@ -0,0 +1,173 @@
|
||||
---
|
||||
title: Amazon RDS
|
||||
description: Connect to Amazon RDS via Data API
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="rds"
|
||||
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Amazon RDS Aurora Serverless](https://aws.amazon.com/rds/aurora/serverless/) is a fully managed relational database that automatically starts up, shuts down, and scales capacity based on your application's needs. It allows you to run SQL databases in the cloud without managing database servers.
|
||||
|
||||
With RDS Aurora Serverless, you can:
|
||||
|
||||
- **Query data**: Run flexible SQL queries across your tables
|
||||
- **Insert new records**: Add data to your database automatically
|
||||
- **Update existing records**: Modify data in your tables using custom filters
|
||||
- **Delete records**: Remove unwanted data using precise criteria
|
||||
- **Execute raw SQL**: Run any valid SQL command supported by Aurora
|
||||
|
||||
In Sim, the RDS integration enables your agents to work with Amazon Aurora Serverless databases securely and programmatically. Supported operations include:
|
||||
|
||||
- **Query**: Run SELECT and other SQL queries to fetch rows from your database
|
||||
- **Insert**: Insert new records into tables with structured data
|
||||
- **Update**: Change data in rows that match your specified conditions
|
||||
- **Delete**: Remove records from a table by custom filters or criteria
|
||||
- **Execute**: Run raw SQL for advanced scenarios
|
||||
|
||||
This integration allows your agents to automate a wide range of database operations without manual intervention. By connecting Sim with Amazon RDS, you can build agents that manage, update, and retrieve relational data within your workflows—all without handling database infrastructure or connections.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
|
||||
## Usage Instructions
|
||||
|
||||
Integrate Amazon RDS Aurora Serverless into the workflow using the Data API. Can query, insert, update, delete, and execute raw SQL without managing database connections.
|
||||
|
||||
|
||||
|
||||
## Tools
|
||||
|
||||
### `rds_query`
|
||||
|
||||
Execute a SELECT query on Amazon RDS using the Data API
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
|
||||
| `accessKeyId` | string | Yes | AWS access key ID |
|
||||
| `secretAccessKey` | string | Yes | AWS secret access key |
|
||||
| `resourceArn` | string | Yes | ARN of the Aurora DB cluster |
|
||||
| `secretArn` | string | Yes | ARN of the Secrets Manager secret containing DB credentials |
|
||||
| `database` | string | No | Database name \(optional\) |
|
||||
| `query` | string | Yes | SQL SELECT query to execute |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Operation status message |
|
||||
| `rows` | array | Array of rows returned from the query |
|
||||
| `rowCount` | number | Number of rows returned |
|
||||
|
||||
### `rds_insert`
|
||||
|
||||
Insert data into an Amazon RDS table using the Data API
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
|
||||
| `accessKeyId` | string | Yes | AWS access key ID |
|
||||
| `secretAccessKey` | string | Yes | AWS secret access key |
|
||||
| `resourceArn` | string | Yes | ARN of the Aurora DB cluster |
|
||||
| `secretArn` | string | Yes | ARN of the Secrets Manager secret containing DB credentials |
|
||||
| `database` | string | No | Database name \(optional\) |
|
||||
| `table` | string | Yes | Table name to insert into |
|
||||
| `data` | object | Yes | Data to insert as key-value pairs |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Operation status message |
|
||||
| `rows` | array | Array of inserted rows |
|
||||
| `rowCount` | number | Number of rows inserted |
|
||||
|
||||
### `rds_update`
|
||||
|
||||
Update data in an Amazon RDS table using the Data API
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
|
||||
| `accessKeyId` | string | Yes | AWS access key ID |
|
||||
| `secretAccessKey` | string | Yes | AWS secret access key |
|
||||
| `resourceArn` | string | Yes | ARN of the Aurora DB cluster |
|
||||
| `secretArn` | string | Yes | ARN of the Secrets Manager secret containing DB credentials |
|
||||
| `database` | string | No | Database name \(optional\) |
|
||||
| `table` | string | Yes | Table name to update |
|
||||
| `data` | object | Yes | Data to update as key-value pairs |
|
||||
| `conditions` | object | Yes | Conditions for the update \(e.g., \{"id": 1\}\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Operation status message |
|
||||
| `rows` | array | Array of updated rows |
|
||||
| `rowCount` | number | Number of rows updated |
|
||||
|
||||
### `rds_delete`
|
||||
|
||||
Delete data from an Amazon RDS table using the Data API
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
|
||||
| `accessKeyId` | string | Yes | AWS access key ID |
|
||||
| `secretAccessKey` | string | Yes | AWS secret access key |
|
||||
| `resourceArn` | string | Yes | ARN of the Aurora DB cluster |
|
||||
| `secretArn` | string | Yes | ARN of the Secrets Manager secret containing DB credentials |
|
||||
| `database` | string | No | Database name \(optional\) |
|
||||
| `table` | string | Yes | Table name to delete from |
|
||||
| `conditions` | object | Yes | Conditions for the delete \(e.g., \{"id": 1\}\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Operation status message |
|
||||
| `rows` | array | Array of deleted rows |
|
||||
| `rowCount` | number | Number of rows deleted |
|
||||
|
||||
### `rds_execute`
|
||||
|
||||
Execute raw SQL on Amazon RDS using the Data API
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
|
||||
| `accessKeyId` | string | Yes | AWS access key ID |
|
||||
| `secretAccessKey` | string | Yes | AWS secret access key |
|
||||
| `resourceArn` | string | Yes | ARN of the Aurora DB cluster |
|
||||
| `secretArn` | string | Yes | ARN of the Secrets Manager secret containing DB credentials |
|
||||
| `database` | string | No | Database name \(optional\) |
|
||||
| `query` | string | Yes | Raw SQL query to execute |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Operation status message |
|
||||
| `rows` | array | Array of rows returned or affected |
|
||||
| `rowCount` | number | Number of rows affected |
|
||||
|
||||
|
||||
|
||||
## Notes
|
||||
|
||||
- Category: `tools`
|
||||
- Type: `rds`
|
||||
@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="s3"
|
||||
color="#E0E0E0"
|
||||
color="linear-gradient(45deg, #1B660F 0%, #6CAE3E 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
|
||||
59
apps/docs/content/docs/en/tools/search.mdx
Normal file
59
apps/docs/content/docs/en/tools/search.mdx
Normal file
@@ -0,0 +1,59 @@
|
||||
---
|
||||
title: Search
|
||||
description: Search the web ($0.01 per search)
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="search"
|
||||
color="#3B82F6"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
The **Search** tool lets you search the web from within your Sim workflows using state-of-the-art search engines. Use it to pull in the latest information, news, facts, and web content directly into your agents, automations, or conversations.
|
||||
|
||||
- **General web search**: Find up-to-date information from the internet to supplement your workflows.
|
||||
- **Automated queries**: Let agents or program logic submit search queries and handle the results automatically.
|
||||
- **Structured results**: Returns the most relevant web results, including title, link, snippet, and date for each result.
|
||||
|
||||
> **Note:** Each search costs **$0.01** per query.
|
||||
|
||||
This tool is ideal for any workflow where your agents need access to live web data or must reference current events, perform research, or fetch supplemental content.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
|
||||
## Usage Instructions
|
||||
|
||||
Search the web using the Search tool. Each search costs $0.01 per query.
|
||||
|
||||
|
||||
|
||||
## Tools
|
||||
|
||||
### `search_tool`
|
||||
|
||||
Search the web. Returns the most relevant web results, including title, link, snippet, and date for each result.
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `query` | string | Yes | The search query |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `results` | json | Search results |
|
||||
| `query` | string | The search query |
|
||||
| `totalResults` | number | Total number of results |
|
||||
| `source` | string | Search source \(exa\) |
|
||||
| `cost` | json | Cost information \($0.01\) |
|
||||
|
||||
|
||||
|
||||
## Notes
|
||||
|
||||
- Category: `tools`
|
||||
- Type: `search`
|
||||
396
apps/docs/content/docs/en/tools/sendgrid.mdx
Normal file
396
apps/docs/content/docs/en/tools/sendgrid.mdx
Normal file
@@ -0,0 +1,396 @@
|
||||
---
|
||||
title: SendGrid
|
||||
description: Send emails and manage contacts, lists, and templates with SendGrid
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="sendgrid"
|
||||
color="#1A82E2"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[SendGrid](https://sendgrid.com) is a leading cloud-based email delivery platform trusted by developers and businesses to send reliable transactional and marketing emails at scale. With its robust APIs and powerful tools, SendGrid enables you to manage all aspects of your email communication, from sending notifications and receipts to managing complex marketing campaigns.
|
||||
|
||||
SendGrid empowers users with a full suite of email operations, allowing you to automate critical email workflows and closely manage contact lists, templates, and recipient engagement. Its seamless integration with Sim enables agents and workflows to deliver targeted messages, maintain dynamic contact and recipient lists, trigger personalized emails through templates, and track the results in real time.
|
||||
|
||||
Key features of SendGrid include:
|
||||
|
||||
- **Transactional Email:** Send automated and high-volume transactional emails (like notifications, receipts, and password resets).
|
||||
- **Dynamic Templates:** Use rich HTML or text templates with dynamic data for highly personalized communication at scale.
|
||||
- **Contact Management:** Add and update marketing contacts, manage recipient lists, and target segments for campaigns.
|
||||
- **Attachments Support:** Include one or more file attachments in your emails.
|
||||
- **Comprehensive API Coverage:** Programmatically manage emails, contacts, lists, templates, suppression groups, and more.
|
||||
|
||||
By connecting SendGrid with Sim, your agents can:
|
||||
|
||||
- Send both simple and advanced (templated or multi-recipient) emails as part of any workflow.
|
||||
- Manage and segment contacts and lists automatically.
|
||||
- Leverage templates for consistency and dynamic personalization.
|
||||
- Track and respond to email engagement within your automated processes.
|
||||
|
||||
This integration allows you to automate all critical communication flows, ensure messages reach the right audience, and maintain control over your organization’s email strategy, directly from Sim workflows.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
|
||||
## Usage Instructions
|
||||
|
||||
Integrate SendGrid into your workflow. Send transactional emails, manage marketing contacts and lists, and work with email templates. Supports dynamic templates, attachments, and comprehensive contact management.
|
||||
|
||||
|
||||
|
||||
## Tools
|
||||
|
||||
### `sendgrid_send_mail`
|
||||
|
||||
Send an email using SendGrid API
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `from` | string | Yes | Sender email address \(must be verified in SendGrid\) |
|
||||
| `fromName` | string | No | Sender name |
|
||||
| `to` | string | Yes | Recipient email address |
|
||||
| `toName` | string | No | Recipient name |
|
||||
| `subject` | string | No | Email subject \(required unless using a template with pre-defined subject\) |
|
||||
| `content` | string | No | Email body content \(required unless using a template with pre-defined content\) |
|
||||
| `contentType` | string | No | Content type \(text/plain or text/html\) |
|
||||
| `cc` | string | No | CC email address |
|
||||
| `bcc` | string | No | BCC email address |
|
||||
| `replyTo` | string | No | Reply-to email address |
|
||||
| `replyToName` | string | No | Reply-to name |
|
||||
| `attachments` | file[] | No | Files to attach to the email |
|
||||
| `templateId` | string | No | SendGrid template ID to use |
|
||||
| `dynamicTemplateData` | json | No | JSON object of dynamic template data |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Whether the email was sent successfully |
|
||||
| `messageId` | string | SendGrid message ID |
|
||||
| `to` | string | Recipient email address |
|
||||
| `subject` | string | Email subject |
|
||||
|
||||
### `sendgrid_add_contact`
|
||||
|
||||
Add a new contact to SendGrid
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `email` | string | Yes | Contact email address |
|
||||
| `firstName` | string | No | Contact first name |
|
||||
| `lastName` | string | No | Contact last name |
|
||||
| `customFields` | json | No | JSON object of custom field key-value pairs \(use field IDs like e1_T, e2_N, e3_D, not field names\) |
|
||||
| `listIds` | string | No | Comma-separated list IDs to add the contact to |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | Job ID for tracking the async contact creation |
|
||||
| `email` | string | Contact email address |
|
||||
| `firstName` | string | Contact first name |
|
||||
| `lastName` | string | Contact last name |
|
||||
| `message` | string | Status message |
|
||||
|
||||
### `sendgrid_get_contact`
|
||||
|
||||
Get a specific contact by ID from SendGrid
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `contactId` | string | Yes | Contact ID |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | Contact ID |
|
||||
| `email` | string | Contact email address |
|
||||
| `firstName` | string | Contact first name |
|
||||
| `lastName` | string | Contact last name |
|
||||
| `createdAt` | string | Creation timestamp |
|
||||
| `updatedAt` | string | Last update timestamp |
|
||||
| `listIds` | json | Array of list IDs the contact belongs to |
|
||||
| `customFields` | json | Custom field values |
|
||||
|
||||
### `sendgrid_search_contacts`
|
||||
|
||||
Search for contacts in SendGrid using a query
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `query` | string | Yes | Search query \(e.g., \"email LIKE '%example.com%' AND CONTAINS\(list_ids, 'list-id'\)\"\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `contacts` | json | Array of matching contacts |
|
||||
| `contactCount` | number | Total number of contacts found |
|
||||
|
||||
### `sendgrid_delete_contacts`
|
||||
|
||||
Delete one or more contacts from SendGrid
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `contactIds` | string | Yes | Comma-separated contact IDs to delete |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | Job ID for the deletion request |
|
||||
|
||||
### `sendgrid_create_list`
|
||||
|
||||
Create a new contact list in SendGrid
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `name` | string | Yes | List name |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | List ID |
|
||||
| `name` | string | List name |
|
||||
| `contactCount` | number | Number of contacts in the list |
|
||||
|
||||
### `sendgrid_get_list`
|
||||
|
||||
Get a specific list by ID from SendGrid
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `listId` | string | Yes | List ID |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | List ID |
|
||||
| `name` | string | List name |
|
||||
| `contactCount` | number | Number of contacts in the list |
|
||||
|
||||
### `sendgrid_list_all_lists`
|
||||
|
||||
Get all contact lists from SendGrid
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `pageSize` | number | No | Number of lists to return per page \(default: 100\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `lists` | json | Array of lists |
|
||||
|
||||
### `sendgrid_delete_list`
|
||||
|
||||
Delete a contact list from SendGrid
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `listId` | string | Yes | List ID to delete |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Success message |
|
||||
|
||||
### `sendgrid_add_contacts_to_list`
|
||||
|
||||
Add or update contacts and assign them to a list in SendGrid (uses PUT /v3/marketing/contacts)
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `listId` | string | Yes | List ID to add contacts to |
|
||||
| `contacts` | json | Yes | JSON array of contact objects. Each contact must have at least: email \(or phone_number_id/external_id/anonymous_id\). Example: \[\{"email": "user@example.com", "first_name": "John"\}\] |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | Job ID for tracking the async operation |
|
||||
| `message` | string | Status message |
|
||||
|
||||
### `sendgrid_remove_contacts_from_list`
|
||||
|
||||
Remove contacts from a specific list in SendGrid
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `listId` | string | Yes | List ID |
|
||||
| `contactIds` | string | Yes | Comma-separated contact IDs to remove from the list |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | Job ID for the request |
|
||||
|
||||
### `sendgrid_create_template`
|
||||
|
||||
Create a new email template in SendGrid
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `name` | string | Yes | Template name |
|
||||
| `generation` | string | No | Template generation type \(legacy or dynamic, default: dynamic\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | Template ID |
|
||||
| `name` | string | Template name |
|
||||
| `generation` | string | Template generation |
|
||||
| `updatedAt` | string | Last update timestamp |
|
||||
| `versions` | json | Array of template versions |
|
||||
|
||||
### `sendgrid_get_template`
|
||||
|
||||
Get a specific template by ID from SendGrid
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `templateId` | string | Yes | Template ID |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | Template ID |
|
||||
| `name` | string | Template name |
|
||||
| `generation` | string | Template generation |
|
||||
| `updatedAt` | string | Last update timestamp |
|
||||
| `versions` | json | Array of template versions |
|
||||
|
||||
### `sendgrid_list_templates`
|
||||
|
||||
Get all email templates from SendGrid
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `generations` | string | No | Filter by generation \(legacy, dynamic, or both\) |
|
||||
| `pageSize` | number | No | Number of templates to return per page \(default: 20\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `templates` | json | Array of templates |
|
||||
|
||||
### `sendgrid_delete_template`
|
||||
|
||||
Delete an email template from SendGrid
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `templateId` | string | Yes | Template ID to delete |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Operation success status |
|
||||
| `messageId` | string | Email message ID \(send_mail\) |
|
||||
| `id` | string | Resource ID |
|
||||
| `jobId` | string | Job ID for async operations |
|
||||
| `email` | string | Email address |
|
||||
| `firstName` | string | First name |
|
||||
| `lastName` | string | Last name |
|
||||
| `contacts` | json | Array of contacts |
|
||||
| `contactCount` | number | Number of contacts |
|
||||
| `lists` | json | Array of lists |
|
||||
| `templates` | json | Array of templates |
|
||||
| `message` | string | Status or success message |
|
||||
| `name` | string | Resource name |
|
||||
| `generation` | string | Template generation |
|
||||
|
||||
### `sendgrid_create_template_version`
|
||||
|
||||
Create a new version of an email template in SendGrid
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | SendGrid API key |
|
||||
| `templateId` | string | Yes | Template ID |
|
||||
| `name` | string | Yes | Version name |
|
||||
| `subject` | string | Yes | Email subject line |
|
||||
| `htmlContent` | string | No | HTML content of the template |
|
||||
| `plainContent` | string | No | Plain text content of the template |
|
||||
| `active` | boolean | No | Whether this version is active \(default: true\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | Version ID |
|
||||
| `templateId` | string | Template ID |
|
||||
| `name` | string | Version name |
|
||||
| `subject` | string | Email subject |
|
||||
| `active` | boolean | Whether this version is active |
|
||||
| `htmlContent` | string | HTML content |
|
||||
| `plainContent` | string | Plain text content |
|
||||
| `updatedAt` | string | Last update timestamp |
|
||||
|
||||
|
||||
|
||||
## Notes
|
||||
|
||||
- Category: `tools`
|
||||
- Type: `sendgrid`
|
||||
78
apps/docs/content/docs/en/tools/smtp.mdx
Normal file
78
apps/docs/content/docs/en/tools/smtp.mdx
Normal file
@@ -0,0 +1,78 @@
|
||||
---
|
||||
title: SMTP
|
||||
description: Send emails via any SMTP mail server
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="smtp"
|
||||
color="#4A5568"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[SMTP (Simple Mail Transfer Protocol)](https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol) is the foundational standard for email transmission across the Internet. By connecting to any SMTP-compatible server—such as Gmail, Outlook, or your organization's own mail infrastructure—you can send emails programmatically and automate your outbound communications.
|
||||
|
||||
SMTP integration allows you to fully customize email sending through direct server connectivity, supporting both basic and advanced email use cases. With SMTP, you can control every aspect of message delivery, recipient management, and content formatting, making it suitable for transactional notifications, bulk mailings, and any automated workflow requiring robust outbound email delivery.
|
||||
|
||||
**Key features available via SMTP integration include:**
|
||||
|
||||
- **Universal Email Delivery:** Send emails using any SMTP server by configuring standard server connection parameters.
|
||||
- **Customizable Sender and Recipients:** Specify sender address, display name, primary recipients, as well as CC and BCC fields.
|
||||
- **Rich Content Support:** Send plain text or richly formatted HTML emails according to your requirements.
|
||||
- **Attachments:** Include multiple files as attachments in outgoing emails.
|
||||
- **Flexible Security:** Connect using TLS, SSL, or standard (unencrypted) protocols as supported by your SMTP provider.
|
||||
- **Advanced Headers:** Set reply-to headers and other advanced email options to cater for complex mailflows and user interactions.
|
||||
|
||||
By integrating SMTP with Sim, agents and workflows can programmatically send emails as part of any automated process—ranging from sending notifications and confirmations, to automating external communications, reporting, and document delivery. This offers a highly flexible, provider-agnostic approach to managing email directly within your AI-driven processes.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
|
||||
## Usage Instructions
|
||||
|
||||
Send emails using any SMTP server (Gmail, Outlook, custom servers, etc.). Configure SMTP connection settings and send emails with full control over content, recipients, and attachments.
|
||||
|
||||
|
||||
|
||||
## Tools
|
||||
|
||||
### `smtp_send_mail`
|
||||
|
||||
Send emails via SMTP server
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `smtpHost` | string | Yes | SMTP server hostname \(e.g., smtp.gmail.com\) |
|
||||
| `smtpPort` | number | Yes | SMTP server port \(587 for TLS, 465 for SSL\) |
|
||||
| `smtpUsername` | string | Yes | SMTP authentication username |
|
||||
| `smtpPassword` | string | Yes | SMTP authentication password |
|
||||
| `smtpSecure` | string | Yes | Security protocol \(TLS, SSL, or None\) |
|
||||
| `from` | string | Yes | Sender email address |
|
||||
| `to` | string | Yes | Recipient email address |
|
||||
| `subject` | string | Yes | Email subject |
|
||||
| `body` | string | Yes | Email body content |
|
||||
| `contentType` | string | No | Content type \(text or html\) |
|
||||
| `fromName` | string | No | Display name for sender |
|
||||
| `cc` | string | No | CC recipients \(comma-separated\) |
|
||||
| `bcc` | string | No | BCC recipients \(comma-separated\) |
|
||||
| `replyTo` | string | No | Reply-to email address |
|
||||
| `attachments` | file[] | No | Files to attach to the email |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Whether the email was sent successfully |
|
||||
| `messageId` | string | Message ID from SMTP server |
|
||||
| `to` | string | Recipient email address |
|
||||
| `subject` | string | Email subject |
|
||||
| `error` | string | Error message if sending failed |
|
||||
|
||||
|
||||
|
||||
## Notes
|
||||
|
||||
- Category: `tools`
|
||||
- Type: `smtp`
|
||||
89
apps/docs/content/docs/es/tools/apify.mdx
Normal file
89
apps/docs/content/docs/es/tools/apify.mdx
Normal file
@@ -0,0 +1,89 @@
|
||||
---
|
||||
title: Apify
|
||||
description: Ejecuta actores de Apify y obtén resultados
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="apify"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Apify](https://apify.com/) es una plataforma potente para crear, implementar y ejecutar automatización web y actores de scraping web a escala. Apify te permite extraer datos útiles de cualquier sitio web, automatizar flujos de trabajo y conectar tus canales de datos sin problemas.
|
||||
|
||||
Con Apify, puedes:
|
||||
|
||||
- **Ejecutar actores predefinidos o personalizados**: Integra actores públicos o desarrolla los tuyos propios, automatizando una amplia gama de tareas de extracción de datos web y navegador.
|
||||
- **Recuperar conjuntos de datos**: Accede y gestiona conjuntos de datos estructurados recopilados por actores en tiempo real.
|
||||
- **Escalar la automatización web**: Aprovecha la infraestructura en la nube para ejecutar tareas de manera confiable, de forma asíncrona o síncrona, con un manejo robusto de errores.
|
||||
|
||||
En Sim, la integración de Apify permite a tus agentes realizar operaciones principales de Apify de forma programática:
|
||||
|
||||
- **Ejecutar actor (Sincrónico)**: Usa `apify_run_actor_sync` para lanzar un actor de Apify y esperar a que se complete, obteniendo los resultados tan pronto como finalice la ejecución.
|
||||
- **Ejecutar actor (Asincrónico)**: Usa `apify_run_actor_async` para iniciar un actor en segundo plano y consultar periódicamente los resultados, adecuado para trabajos más largos o complejos.
|
||||
|
||||
Estas operaciones equipan a tus agentes para automatizar, extraer y orquestar tareas de recopilación de datos o automatización de navegador directamente dentro de los flujos de trabajo — todo con configuración flexible y manejo de resultados, sin necesidad de ejecuciones manuales o herramientas externas. Integra Apify como un motor dinámico de automatización y extracción de datos que impulsa programáticamente los flujos de trabajo a escala web de tus agentes.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instrucciones de uso
|
||||
|
||||
Integra Apify en tu flujo de trabajo. Ejecuta cualquier actor de Apify con entrada personalizada y obtén resultados. Admite ejecución tanto síncrona como asíncrona con recuperación automática de conjuntos de datos.
|
||||
|
||||
## Herramientas
|
||||
|
||||
### `apify_run_actor_sync`
|
||||
|
||||
Ejecuta un actor de APIFY de forma sincrónica y obtén resultados (máximo 5 minutos)
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `apiKey` | string | Sí | Token de API de APIFY desde console.apify.com/account#/integrations |
|
||||
| `actorId` | string | Sí | ID del actor o nombreusuario/nombre-actor \(p.ej., "janedoe/my-actor" o ID del actor\) |
|
||||
| `input` | string | No | Entrada del actor como cadena JSON. Consulta la documentación del actor para los campos requeridos. |
|
||||
| `timeout` | number | No | Tiempo de espera en segundos \(predeterminado: el predeterminado del actor\) |
|
||||
| `build` | string | No | Versión del actor a ejecutar \(p.ej., "latest", "beta", o etiqueta/número de versión\) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si la ejecución del actor tuvo éxito |
|
||||
| `runId` | string | ID de ejecución de APIFY |
|
||||
| `status` | string | Estado de la ejecución \(SUCCEEDED, FAILED, etc.\) |
|
||||
| `datasetId` | string | ID del conjunto de datos que contiene los resultados |
|
||||
| `items` | array | Elementos del conjunto de datos \(si se completó\) |
|
||||
|
||||
### `apify_run_actor_async`
|
||||
|
||||
Ejecuta un actor de APIFY de forma asincrónica con sondeo para tareas de larga duración
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `apiKey` | string | Sí | Token de API de APIFY desde console.apify.com/account#/integrations |
|
||||
| `actorId` | string | Sí | ID del actor o nombreusuario/nombre-actor \(p.ej., "janedoe/my-actor" o ID del actor\) |
|
||||
| `input` | string | No | Entrada del actor como cadena JSON |
|
||||
| `waitForFinish` | number | No | Tiempo de espera inicial en segundos \(0-60\) antes de que comience el sondeo |
|
||||
| `itemLimit` | number | No | Número máximo de elementos del conjunto de datos a recuperar \(1-250000, predeterminado 100\) |
|
||||
| `timeout` | number | No | Tiempo de espera en segundos \(predeterminado: el predeterminado del actor\) |
|
||||
| `build` | string | No | Versión del actor a ejecutar \(p.ej., "latest", "beta", o etiqueta/número de versión\) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si la ejecución del actor tuvo éxito |
|
||||
| `runId` | string | ID de ejecución de APIFY |
|
||||
| `status` | string | Estado de la ejecución \(SUCCEEDED, FAILED, etc.\) |
|
||||
| `datasetId` | string | ID del conjunto de datos que contiene los resultados |
|
||||
| `items` | array | Elementos del conjunto de datos \(si se completó\) |
|
||||
|
||||
## Notas
|
||||
|
||||
- Categoría: `tools`
|
||||
- Tipo: `apify`
|
||||
188
apps/docs/content/docs/es/tools/dynamodb.mdx
Normal file
188
apps/docs/content/docs/es/tools/dynamodb.mdx
Normal file
@@ -0,0 +1,188 @@
|
||||
---
|
||||
title: Amazon DynamoDB
|
||||
description: Conectar a Amazon DynamoDB
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="dynamodb"
|
||||
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Amazon DynamoDB](https://aws.amazon.com/dynamodb/) es un servicio de base de datos NoSQL completamente administrado ofrecido por AWS que proporciona un rendimiento rápido y predecible con escalabilidad perfecta. DynamoDB te permite almacenar y recuperar cualquier cantidad de datos y atender cualquier nivel de tráfico de solicitudes, sin necesidad de administrar hardware o infraestructura.
|
||||
|
||||
Con DynamoDB, puedes:
|
||||
|
||||
- **Obtener elementos**: Buscar elementos en tus tablas usando claves primarias
|
||||
- **Poner elementos**: Añadir o reemplazar elementos en tus tablas
|
||||
- **Consultar elementos**: Recuperar múltiples elementos usando consultas a través de índices
|
||||
- **Escanear tablas**: Leer todos o parte de los datos en una tabla
|
||||
- **Actualizar elementos**: Modificar atributos específicos de elementos existentes
|
||||
- **Eliminar elementos**: Eliminar registros de tus tablas
|
||||
|
||||
En Sim, la integración con DynamoDB permite a tus agentes acceder y manipular de forma segura las tablas de DynamoDB utilizando credenciales de AWS. Las operaciones compatibles incluyen:
|
||||
|
||||
- **Get**: Recuperar un elemento por su clave
|
||||
- **Put**: Insertar o sobrescribir elementos
|
||||
- **Query**: Ejecutar consultas utilizando condiciones de clave y filtros
|
||||
- **Scan**: Leer múltiples elementos escaneando la tabla o índice
|
||||
- **Update**: Cambiar atributos específicos de uno o más elementos
|
||||
- **Delete**: Eliminar un elemento de una tabla
|
||||
|
||||
Esta integración permite a los agentes de Sim automatizar tareas de gestión de datos dentro de tus tablas de DynamoDB de forma programática, para que puedas crear flujos de trabajo que gestionen, modifiquen y recuperen datos NoSQL escalables sin esfuerzo manual ni gestión de servidores.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instrucciones de uso
|
||||
|
||||
Integra Amazon DynamoDB en flujos de trabajo. Compatible con operaciones Get, Put, Query, Scan, Update y Delete en tablas de DynamoDB.
|
||||
|
||||
## Herramientas
|
||||
|
||||
### `dynamodb_get`
|
||||
|
||||
Obtener un elemento de una tabla DynamoDB mediante clave primaria
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Sí | Región de AWS \(p. ej., us-east-1\) |
|
||||
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
|
||||
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
|
||||
| `tableName` | string | Sí | Nombre de la tabla DynamoDB |
|
||||
| `key` | object | Sí | Clave primaria del elemento a recuperar |
|
||||
| `consistentRead` | boolean | No | Usar lectura fuertemente consistente |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Mensaje de estado de la operación |
|
||||
| `item` | object | Elemento recuperado |
|
||||
|
||||
### `dynamodb_put`
|
||||
|
||||
Poner un elemento en una tabla DynamoDB
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Sí | Región de AWS \(p. ej., us-east-1\) |
|
||||
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
|
||||
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
|
||||
| `tableName` | string | Sí | Nombre de la tabla DynamoDB |
|
||||
| `item` | object | Sí | Elemento a poner en la tabla |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Mensaje de estado de la operación |
|
||||
| `item` | object | Elemento creado |
|
||||
|
||||
### `dynamodb_query`
|
||||
|
||||
Consultar elementos de una tabla DynamoDB usando condiciones de clave
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Sí | Región de AWS \(p. ej., us-east-1\) |
|
||||
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
|
||||
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
|
||||
| `tableName` | string | Sí | Nombre de la tabla DynamoDB |
|
||||
| `keyConditionExpression` | string | Sí | Expresión de condición de clave \(p. ej., "pk = :pk"\) |
|
||||
| `filterExpression` | string | No | Expresión de filtro para resultados |
|
||||
| `expressionAttributeNames` | object | No | Mapeos de nombres de atributos para palabras reservadas |
|
||||
| `expressionAttributeValues` | object | No | Valores de atributos de expresión |
|
||||
| `indexName` | string | No | Nombre del índice secundario para consultar |
|
||||
| `limit` | number | No | Número máximo de elementos a devolver |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Mensaje de estado de la operación |
|
||||
| `items` | array | Array de elementos devueltos |
|
||||
| `count` | number | Número de elementos devueltos |
|
||||
|
||||
### `dynamodb_scan`
|
||||
|
||||
Escanear todos los elementos en una tabla DynamoDB
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Sí | Región de AWS \(p. ej., us-east-1\) |
|
||||
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
|
||||
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
|
||||
| `tableName` | string | Sí | Nombre de la tabla DynamoDB |
|
||||
| `filterExpression` | string | No | Expresión de filtro para resultados |
|
||||
| `projectionExpression` | string | No | Atributos a recuperar |
|
||||
| `expressionAttributeNames` | object | No | Mapeos de nombres de atributos para palabras reservadas |
|
||||
| `expressionAttributeValues` | object | No | Valores de atributos de expresión |
|
||||
| `limit` | number | No | Número máximo de elementos a devolver |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Mensaje de estado de la operación |
|
||||
| `items` | array | Array de elementos devueltos |
|
||||
| `count` | number | Número de elementos devueltos |
|
||||
|
||||
### `dynamodb_update`
|
||||
|
||||
Actualizar un elemento en una tabla de DynamoDB
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Sí | Región de AWS \(p. ej., us-east-1\) |
|
||||
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
|
||||
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
|
||||
| `tableName` | string | Sí | Nombre de la tabla de DynamoDB |
|
||||
| `key` | object | Sí | Clave primaria del elemento a actualizar |
|
||||
| `updateExpression` | string | Sí | Expresión de actualización \(p. ej., "SET #name = :name"\) |
|
||||
| `expressionAttributeNames` | object | No | Mapeos de nombres de atributos para palabras reservadas |
|
||||
| `expressionAttributeValues` | object | No | Valores de atributos de expresión |
|
||||
| `conditionExpression` | string | No | Condición que debe cumplirse para que la actualización tenga éxito |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Mensaje de estado de la operación |
|
||||
| `item` | object | Elemento actualizado |
|
||||
|
||||
### `dynamodb_delete`
|
||||
|
||||
Eliminar un elemento de una tabla de DynamoDB
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Sí | Región de AWS \(p. ej., us-east-1\) |
|
||||
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
|
||||
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
|
||||
| `tableName` | string | Sí | Nombre de la tabla de DynamoDB |
|
||||
| `key` | object | Sí | Clave primaria del elemento a eliminar |
|
||||
| `conditionExpression` | string | No | Condición que debe cumplirse para que la eliminación tenga éxito |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Mensaje de estado de la operación |
|
||||
|
||||
## Notas
|
||||
|
||||
- Categoría: `tools`
|
||||
- Tipo: `dynamodb`
|
||||
83
apps/docs/content/docs/es/tools/linkedin.mdx
Normal file
83
apps/docs/content/docs/es/tools/linkedin.mdx
Normal file
@@ -0,0 +1,83 @@
|
||||
---
|
||||
title: LinkedIn
|
||||
description: Comparte publicaciones y gestiona tu presencia en LinkedIn
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="linkedin"
|
||||
color="#0072B1"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[LinkedIn](https://www.linkedin.com) es la plataforma de redes profesionales más grande del mundo, que permite a los usuarios desarrollar sus carreras, conectarse con su red y compartir contenido profesional. LinkedIn es ampliamente utilizado por profesionales de diversas industrias para branding personal, reclutamiento, búsqueda de empleo y desarrollo de negocios.
|
||||
|
||||
Con LinkedIn, puedes compartir fácilmente publicaciones en tu feed personal para interactuar con tu red y acceder a información sobre tu perfil para destacar tus logros profesionales. La integración automatizada con Sim te permite aprovechar la funcionalidad de LinkedIn de forma programática, permitiendo que agentes y flujos de trabajo publiquen actualizaciones, informen sobre tu presencia profesional y mantengan tu feed activo sin esfuerzo manual.
|
||||
|
||||
Las características clave de LinkedIn disponibles a través de esta integración incluyen:
|
||||
|
||||
- **Compartir publicaciones:** Publica automáticamente actualizaciones profesionales, artículos o anuncios en tu feed personal de LinkedIn.
|
||||
- **Información del perfil:** Obtén información detallada sobre tu perfil de LinkedIn para monitorear o usar en tareas posteriores dentro de tus flujos de trabajo.
|
||||
|
||||
Estas capacidades facilitan mantener tu red de LinkedIn comprometida y extender tu alcance profesional de manera eficiente como parte de tu estrategia de automatización de IA o flujo de trabajo.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instrucciones de uso
|
||||
|
||||
Integra LinkedIn en flujos de trabajo. Comparte publicaciones en tu feed personal y accede a la información de tu perfil de LinkedIn.
|
||||
|
||||
## Herramientas
|
||||
|
||||
### `linkedin_share_post`
|
||||
|
||||
Comparte una publicación en tu feed personal de LinkedIn
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `text` | string | Sí | El contenido de texto de tu publicación en LinkedIn |
|
||||
| `visibility` | string | No | Quién puede ver esta publicación: "PUBLIC" o "CONNECTIONS" \(predeterminado: "PUBLIC"\) |
|
||||
| `request` | string | No | Sin descripción |
|
||||
| `output` | string | No | Sin descripción |
|
||||
| `output` | string | No | Sin descripción |
|
||||
| `specificContent` | string | No | Sin descripción |
|
||||
| `shareCommentary` | string | No | Sin descripción |
|
||||
| `visibility` | string | No | Sin descripción |
|
||||
| `headers` | string | No | Sin descripción |
|
||||
| `output` | string | No | Sin descripción |
|
||||
| `output` | string | No | Sin descripción |
|
||||
| `output` | string | No | Sin descripción |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Estado de éxito de la operación |
|
||||
| `postId` | string | ID de la publicación creada |
|
||||
| `profile` | json | Información del perfil de LinkedIn |
|
||||
| `error` | string | Mensaje de error si la operación falló |
|
||||
|
||||
### `linkedin_get_profile`
|
||||
|
||||
Recuperar la información de tu perfil de LinkedIn
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Requerido | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Estado de éxito de la operación |
|
||||
| `postId` | string | ID de la publicación creada |
|
||||
| `profile` | json | Información del perfil de LinkedIn |
|
||||
| `error` | string | Mensaje de error si la operación falló |
|
||||
|
||||
## Notas
|
||||
|
||||
- Categoría: `tools`
|
||||
- Tipo: `linkedin`
|
||||
216
apps/docs/content/docs/es/tools/mailgun.mdx
Normal file
216
apps/docs/content/docs/es/tools/mailgun.mdx
Normal file
@@ -0,0 +1,216 @@
|
||||
---
|
||||
title: Mailgun
|
||||
description: Envía correos electrónicos y gestiona listas de correo con Mailgun
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="mailgun"
|
||||
color="#F06248"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Mailgun](https://www.mailgun.com) es un potente servicio de envío de correos electrónicos diseñado para desarrolladores y empresas que permite enviar, recibir y rastrear correos electrónicos sin esfuerzo. Mailgun te permite aprovechar APIs robustas para correos electrónicos transaccionales y de marketing confiables, gestión flexible de listas de correo y seguimiento avanzado de eventos.
|
||||
|
||||
Con el conjunto completo de funciones de Mailgun, puedes automatizar operaciones clave de correo electrónico y monitorear de cerca la entregabilidad y el compromiso de los destinatarios. Esto lo convierte en una solución ideal para la automatización de flujos de trabajo donde las comunicaciones, notificaciones y correos de campaña son partes fundamentales de tus procesos.
|
||||
|
||||
Las características principales de Mailgun incluyen:
|
||||
|
||||
- **Envío de correos electrónicos transaccionales:** Entrega correos electrónicos de alto volumen como notificaciones de cuenta, recibos, alertas y restablecimientos de contraseña.
|
||||
- **Contenido de correo electrónico enriquecido:** Envía correos electrónicos tanto en texto plano como en HTML, y utiliza etiquetas para categorizar y rastrear tus mensajes.
|
||||
- **Gestión de listas de correo:** Crea, actualiza y gestiona listas de correo y miembros para enviar comunicaciones grupales de manera eficiente.
|
||||
- **Información de dominio:** Obtén detalles sobre tus dominios de envío para monitorear la configuración y el estado.
|
||||
- **Seguimiento de eventos:** Analiza la entregabilidad y el compromiso del correo electrónico con datos detallados de eventos en los mensajes enviados.
|
||||
- **Recuperación de mensajes:** Accede a mensajes almacenados para necesidades de cumplimiento, análisis o solución de problemas.
|
||||
|
||||
Al integrar Mailgun en Sim, tus agentes pueden enviar correos electrónicos programáticamente, gestionar listas de correo, acceder a información de dominio y monitorear eventos en tiempo real como parte de flujos de trabajo automatizados. Esto permite una participación inteligente y basada en datos con tus usuarios directamente desde tus procesos impulsados por IA.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instrucciones de uso
|
||||
|
||||
Integra Mailgun en tu flujo de trabajo. Envía correos electrónicos transaccionales, gestiona listas de correo y miembros, visualiza información de dominio y realiza seguimiento de eventos de correo electrónico. Compatible con correos electrónicos de texto y HTML, etiquetas para seguimiento y gestión integral de listas.
|
||||
|
||||
## Herramientas
|
||||
|
||||
### `mailgun_send_message`
|
||||
|
||||
Enviar un correo electrónico usando la API de Mailgun
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Mailgun |
|
||||
| `domain` | string | Sí | Dominio de Mailgun \(ej., mg.example.com\) |
|
||||
| `from` | string | Sí | Dirección de correo del remitente |
|
||||
| `to` | string | Sí | Dirección de correo del destinatario \(separados por comas para múltiples\) |
|
||||
| `subject` | string | Sí | Asunto del correo electrónico |
|
||||
| `text` | string | No | Cuerpo de texto plano del correo electrónico |
|
||||
| `html` | string | No | Cuerpo HTML del correo electrónico |
|
||||
| `cc` | string | No | Dirección de correo CC \(separados por comas para múltiples\) |
|
||||
| `bcc` | string | No | Dirección de correo BCC \(separados por comas para múltiples\) |
|
||||
| `tags` | string | No | Etiquetas para el correo electrónico \(separadas por comas\) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si el mensaje fue enviado con éxito |
|
||||
| `id` | string | ID del mensaje |
|
||||
| `message` | string | Mensaje de respuesta de Mailgun |
|
||||
|
||||
### `mailgun_get_message`
|
||||
|
||||
Recuperar un mensaje almacenado por su clave
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Mailgun |
|
||||
| `domain` | string | Sí | Dominio de Mailgun |
|
||||
| `messageKey` | string | Sí | Clave de almacenamiento del mensaje |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si la solicitud fue exitosa |
|
||||
| `recipients` | string | Destinatarios del mensaje |
|
||||
| `from` | string | Correo electrónico del remitente |
|
||||
| `subject` | string | Asunto del mensaje |
|
||||
| `bodyPlain` | string | Cuerpo en texto plano |
|
||||
| `strippedText` | string | Texto simplificado |
|
||||
| `strippedSignature` | string | Firma simplificada |
|
||||
| `bodyHtml` | string | Cuerpo HTML |
|
||||
| `strippedHtml` | string | HTML simplificado |
|
||||
| `attachmentCount` | number | Número de archivos adjuntos |
|
||||
| `timestamp` | number | Marca de tiempo del mensaje |
|
||||
| `messageHeaders` | json | Encabezados del mensaje |
|
||||
| `contentIdMap` | json | Mapa de ID de contenido |
|
||||
|
||||
### `mailgun_list_messages`
|
||||
|
||||
Listar eventos (registros) para mensajes enviados a través de Mailgun
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Mailgun |
|
||||
| `domain` | string | Sí | Dominio de Mailgun |
|
||||
| `event` | string | No | Filtrar por tipo de evento \(accepted, delivered, failed, opened, clicked, etc.\) |
|
||||
| `limit` | number | No | Número máximo de eventos a devolver \(predeterminado: 100\) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si la solicitud fue exitosa |
|
||||
| `items` | json | Array de elementos de eventos |
|
||||
| `paging` | json | Información de paginación |
|
||||
|
||||
### `mailgun_create_mailing_list`
|
||||
|
||||
Crear una nueva lista de correo
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Mailgun |
|
||||
| `address` | string | Sí | Dirección de la lista de correo \(ej., lista@ejemplo.com\) |
|
||||
| `name` | string | No | Nombre de la lista de correo |
|
||||
| `description` | string | No | Descripción de la lista de correo |
|
||||
| `accessLevel` | string | No | Nivel de acceso: readonly, members, o everyone |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si la lista fue creada con éxito |
|
||||
| `message` | string | Mensaje de respuesta |
|
||||
| `list` | json | Detalles de la lista de correo creada |
|
||||
|
||||
### `mailgun_get_mailing_list`
|
||||
|
||||
Obtener detalles de una lista de correo
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Mailgun |
|
||||
| `address` | string | Sí | Dirección de la lista de correo |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si la solicitud fue exitosa |
|
||||
| `list` | json | Detalles de la lista de correo |
|
||||
|
||||
### `mailgun_add_list_member`
|
||||
|
||||
Añadir un miembro a una lista de correo
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Mailgun |
|
||||
| `listAddress` | string | Sí | Dirección de la lista de correo |
|
||||
| `address` | string | Sí | Dirección de correo electrónico del miembro |
|
||||
| `name` | string | No | Nombre del miembro |
|
||||
| `vars` | string | No | Cadena JSON de variables personalizadas |
|
||||
| `subscribed` | boolean | No | Si el miembro está suscrito |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si el miembro fue añadido con éxito |
|
||||
| `message` | string | Mensaje de respuesta |
|
||||
| `member` | json | Detalles del miembro añadido |
|
||||
|
||||
### `mailgun_list_domains`
|
||||
|
||||
Listar todos los dominios para tu cuenta de Mailgun
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Mailgun |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si la solicitud fue exitosa |
|
||||
| `totalCount` | number | Número total de dominios |
|
||||
| `items` | json | Array de objetos de dominio |
|
||||
|
||||
### `mailgun_get_domain`
|
||||
|
||||
Obtener detalles de un dominio específico
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Mailgun |
|
||||
| `domain` | string | Sí | Nombre de dominio |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si la solicitud fue exitosa |
|
||||
| `domain` | json | Detalles del dominio |
|
||||
|
||||
## Notas
|
||||
|
||||
- Categoría: `tools`
|
||||
- Tipo: `mailgun`
|
||||
168
apps/docs/content/docs/es/tools/rds.mdx
Normal file
168
apps/docs/content/docs/es/tools/rds.mdx
Normal file
@@ -0,0 +1,168 @@
|
||||
---
|
||||
title: Amazon RDS
|
||||
description: Conéctate a Amazon RDS a través de Data API
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="rds"
|
||||
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Amazon RDS Aurora Serverless](https://aws.amazon.com/rds/aurora/serverless/) es una base de datos relacional completamente administrada que se inicia, se apaga y escala automáticamente según las necesidades de tu aplicación. Te permite ejecutar bases de datos SQL en la nube sin tener que administrar servidores de bases de datos.
|
||||
|
||||
Con RDS Aurora Serverless, puedes:
|
||||
|
||||
- **Consultar datos**: Ejecutar consultas SQL flexibles en tus tablas
|
||||
- **Insertar nuevos registros**: Añadir datos a tu base de datos automáticamente
|
||||
- **Actualizar registros existentes**: Modificar datos en tus tablas usando filtros personalizados
|
||||
- **Eliminar registros**: Quitar datos no deseados utilizando criterios precisos
|
||||
- **Ejecutar SQL puro**: Ejecutar cualquier comando SQL válido compatible con Aurora
|
||||
|
||||
En Sim, la integración con RDS permite a tus agentes trabajar con bases de datos Amazon Aurora Serverless de forma segura y programática. Las operaciones compatibles incluyen:
|
||||
|
||||
- **Consulta**: Ejecutar SELECT y otras consultas SQL para obtener filas de tu base de datos
|
||||
- **Inserción**: Insertar nuevos registros en tablas con datos estructurados
|
||||
- **Actualización**: Cambiar datos en filas que coincidan con tus condiciones especificadas
|
||||
- **Eliminación**: Eliminar registros de una tabla mediante filtros o criterios personalizados
|
||||
- **Ejecución**: Ejecutar SQL puro para escenarios avanzados
|
||||
|
||||
Esta integración permite a tus agentes automatizar una amplia gama de operaciones de bases de datos sin intervención manual. Al conectar Sim con Amazon RDS, puedes crear agentes que gestionen, actualicen y recuperen datos relacionales dentro de tus flujos de trabajo, todo sin tener que manejar infraestructura o conexiones de bases de datos.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instrucciones de uso
|
||||
|
||||
Integra Amazon RDS Aurora Serverless en el flujo de trabajo utilizando la Data API. Puede consultar, insertar, actualizar, eliminar y ejecutar SQL puro sin administrar conexiones de base de datos.
|
||||
|
||||
## Herramientas
|
||||
|
||||
### `rds_query`
|
||||
|
||||
Ejecutar una consulta SELECT en Amazon RDS utilizando la API de datos
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Sí | Región de AWS (p. ej., us-east-1) |
|
||||
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
|
||||
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
|
||||
| `resourceArn` | string | Sí | ARN del clúster de Aurora DB |
|
||||
| `secretArn` | string | Sí | ARN del secreto de Secrets Manager que contiene las credenciales de la base de datos |
|
||||
| `database` | string | No | Nombre de la base de datos (opcional) |
|
||||
| `query` | string | Sí | Consulta SQL SELECT para ejecutar |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Mensaje de estado de la operación |
|
||||
| `rows` | array | Array de filas devueltas por la consulta |
|
||||
| `rowCount` | number | Número de filas devueltas |
|
||||
|
||||
### `rds_insert`
|
||||
|
||||
Insertar datos en una tabla de Amazon RDS utilizando la API de datos
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Sí | Región de AWS (p. ej., us-east-1) |
|
||||
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
|
||||
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
|
||||
| `resourceArn` | string | Sí | ARN del clúster de Aurora DB |
|
||||
| `secretArn` | string | Sí | ARN del secreto de Secrets Manager que contiene las credenciales de la base de datos |
|
||||
| `database` | string | No | Nombre de la base de datos (opcional) |
|
||||
| `table` | string | Sí | Nombre de la tabla donde insertar |
|
||||
| `data` | object | Sí | Datos a insertar como pares clave-valor |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Mensaje de estado de la operación |
|
||||
| `rows` | array | Array de filas insertadas |
|
||||
| `rowCount` | number | Número de filas insertadas |
|
||||
|
||||
### `rds_update`
|
||||
|
||||
Actualizar datos en una tabla de Amazon RDS utilizando la API de datos
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Sí | Región de AWS (p. ej., us-east-1) |
|
||||
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
|
||||
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
|
||||
| `resourceArn` | string | Sí | ARN del clúster de Aurora DB |
|
||||
| `secretArn` | string | Sí | ARN del secreto de Secrets Manager que contiene las credenciales de la base de datos |
|
||||
| `database` | string | No | Nombre de la base de datos (opcional) |
|
||||
| `table` | string | Sí | Nombre de la tabla a actualizar |
|
||||
| `data` | object | Sí | Datos a actualizar como pares clave-valor |
|
||||
| `conditions` | object | Sí | Condiciones para la actualización (p. ej., `{"id": 1}`) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Mensaje de estado de la operación |
|
||||
| `rows` | array | Array de filas actualizadas |
|
||||
| `rowCount` | number | Número de filas actualizadas |
|
||||
|
||||
### `rds_delete`
|
||||
|
||||
Eliminar datos de una tabla de Amazon RDS utilizando la API de datos
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Sí | Región de AWS (p. ej., us-east-1) |
|
||||
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
|
||||
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
|
||||
| `resourceArn` | string | Sí | ARN del clúster de Aurora DB |
|
||||
| `secretArn` | string | Sí | ARN del secreto de Secrets Manager que contiene las credenciales de la base de datos |
|
||||
| `database` | string | No | Nombre de la base de datos (opcional) |
|
||||
| `table` | string | Sí | Nombre de la tabla de la que eliminar |
|
||||
| `conditions` | object | Sí | Condiciones para la eliminación (p. ej., `{"id": 1}`) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Mensaje de estado de la operación |
|
||||
| `rows` | array | Array de filas eliminadas |
|
||||
| `rowCount` | number | Número de filas eliminadas |
|
||||
|
||||
### `rds_execute`
|
||||
|
||||
Ejecutar SQL sin procesar en Amazon RDS usando la API de datos
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Sí | Región de AWS (p. ej., us-east-1) |
|
||||
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
|
||||
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
|
||||
| `resourceArn` | string | Sí | ARN del clúster de Aurora DB |
|
||||
| `secretArn` | string | Sí | ARN del secreto de Secrets Manager que contiene las credenciales de la base de datos |
|
||||
| `database` | string | No | Nombre de la base de datos (opcional) |
|
||||
| `query` | string | Sí | Consulta SQL sin procesar para ejecutar |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Mensaje de estado de la operación |
|
||||
| `rows` | array | Array de filas devueltas o afectadas |
|
||||
| `rowCount` | number | Número de filas afectadas |
|
||||
|
||||
## Notas
|
||||
|
||||
- Categoría: `tools`
|
||||
- Tipo: `rds`
|
||||
@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="s3"
|
||||
color="#E0E0E0"
|
||||
color="linear-gradient(45deg, #1B660F 0%, #6CAE3E 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
|
||||
54
apps/docs/content/docs/es/tools/search.mdx
Normal file
54
apps/docs/content/docs/es/tools/search.mdx
Normal file
@@ -0,0 +1,54 @@
|
||||
---
|
||||
title: Búsqueda
|
||||
description: Busca en la web ($0.01 por búsqueda)
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="search"
|
||||
color="#3B82F6"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
La herramienta de **Búsqueda** te permite buscar en la web desde tus flujos de trabajo de Sim utilizando motores de búsqueda de última generación. Úsala para obtener la información más reciente, noticias, hechos y contenido web directamente en tus agentes, automatizaciones o conversaciones.
|
||||
|
||||
- **Búsqueda general en la web**: Encuentra información actualizada de internet para complementar tus flujos de trabajo.
|
||||
- **Consultas automatizadas**: Permite que los agentes o la lógica del programa envíen consultas de búsqueda y manejen los resultados automáticamente.
|
||||
- **Resultados estructurados**: Devuelve los resultados web más relevantes, incluyendo título, enlace, fragmento y fecha para cada resultado.
|
||||
|
||||
> **Nota:** Cada búsqueda cuesta **$0.01** por consulta.
|
||||
|
||||
Esta herramienta es ideal para cualquier flujo de trabajo donde tus agentes necesiten acceso a datos web en tiempo real o deban hacer referencia a eventos actuales, realizar investigaciones o obtener contenido complementario.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instrucciones de uso
|
||||
|
||||
Busca en la web usando la herramienta de Búsqueda. Cada búsqueda cuesta $0.01 por consulta.
|
||||
|
||||
## Herramientas
|
||||
|
||||
### `search_tool`
|
||||
|
||||
Busca en la web. Devuelve los resultados web más relevantes, incluyendo título, enlace, fragmento y fecha para cada resultado.
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `query` | string | Sí | La consulta de búsqueda |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `results` | json | Resultados de búsqueda |
|
||||
| `query` | string | La consulta de búsqueda |
|
||||
| `totalResults` | number | Número total de resultados |
|
||||
| `source` | string | Fuente de búsqueda \(exa\) |
|
||||
| `cost` | json | Información de costo \($0.01\) |
|
||||
|
||||
## Notas
|
||||
|
||||
- Categoría: `tools`
|
||||
- Tipo: `search`
|
||||
392
apps/docs/content/docs/es/tools/sendgrid.mdx
Normal file
392
apps/docs/content/docs/es/tools/sendgrid.mdx
Normal file
@@ -0,0 +1,392 @@
|
||||
---
|
||||
title: SendGrid
|
||||
description: Envía correos electrónicos y gestiona contactos, listas y
|
||||
plantillas con SendGrid
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="sendgrid"
|
||||
color="#1A82E2"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[SendGrid](https://sendgrid.com) es una plataforma líder de envío de correos electrónicos en la nube en la que confían desarrolladores y empresas para enviar correos electrónicos transaccionales y de marketing fiables a gran escala. Con sus sólidas APIs y potentes herramientas, SendGrid te permite gestionar todos los aspectos de tu comunicación por correo electrónico, desde el envío de notificaciones y recibos hasta la gestión de complejas campañas de marketing.
|
||||
|
||||
SendGrid ofrece a los usuarios un conjunto completo de operaciones de correo electrónico, permitiéndote automatizar flujos de trabajo críticos de correo electrónico y gestionar de cerca listas de contactos, plantillas y la participación de los destinatarios. Su integración perfecta con Sim permite a los agentes y flujos de trabajo entregar mensajes específicos, mantener listas dinámicas de contactos y destinatarios, activar correos electrónicos personalizados a través de plantillas y seguir los resultados en tiempo real.
|
||||
|
||||
Las características principales de SendGrid incluyen:
|
||||
|
||||
- **Correo electrónico transaccional:** Envía correos electrónicos transaccionales automatizados y de alto volumen (como notificaciones, recibos y restablecimientos de contraseña).
|
||||
- **Plantillas dinámicas:** Utiliza plantillas de texto o HTML enriquecido con datos dinámicos para una comunicación altamente personalizada a gran escala.
|
||||
- **Gestión de contactos:** Añade y actualiza contactos de marketing, gestiona listas de destinatarios y segmentos objetivo para campañas.
|
||||
- **Soporte para archivos adjuntos:** Incluye uno o más archivos adjuntos en tus correos electrónicos.
|
||||
- **Cobertura integral de API:** Gestiona programáticamente correos electrónicos, contactos, listas, plantillas, grupos de supresión y más.
|
||||
|
||||
Al conectar SendGrid con Sim, tus agentes pueden:
|
||||
|
||||
- Enviar correos electrónicos tanto simples como avanzados (con plantillas o múltiples destinatarios) como parte de cualquier flujo de trabajo.
|
||||
- Gestionar y segmentar contactos y listas automáticamente.
|
||||
- Aprovechar las plantillas para mantener consistencia y personalización dinámica.
|
||||
- Realizar seguimiento y responder a la interacción con los correos electrónicos dentro de tus procesos automatizados.
|
||||
|
||||
Esta integración te permite automatizar todos los flujos de comunicación críticos, asegurar que los mensajes lleguen a la audiencia correcta y mantener el control sobre la estrategia de correo electrónico de tu organización, directamente desde los flujos de trabajo de Sim.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instrucciones de uso
|
||||
|
||||
Integra SendGrid en tu flujo de trabajo. Envía correos electrónicos transaccionales, gestiona contactos y listas de marketing, y trabaja con plantillas de correo electrónico. Compatible con plantillas dinámicas, archivos adjuntos y gestión integral de contactos.
|
||||
|
||||
## Herramientas
|
||||
|
||||
### `sendgrid_send_mail`
|
||||
|
||||
Enviar un correo electrónico usando la API de SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `from` | string | Sí | Dirección de correo electrónico del remitente \(debe estar verificada en SendGrid\) |
|
||||
| `fromName` | string | No | Nombre del remitente |
|
||||
| `to` | string | Sí | Dirección de correo electrónico del destinatario |
|
||||
| `toName` | string | No | Nombre del destinatario |
|
||||
| `subject` | string | No | Asunto del correo electrónico \(obligatorio a menos que se use una plantilla con asunto predefinido\) |
|
||||
| `content` | string | No | Contenido del cuerpo del correo electrónico \(obligatorio a menos que se use una plantilla con contenido predefinido\) |
|
||||
| `contentType` | string | No | Tipo de contenido \(text/plain o text/html\) |
|
||||
| `cc` | string | No | Dirección de correo electrónico CC |
|
||||
| `bcc` | string | No | Dirección de correo electrónico BCC |
|
||||
| `replyTo` | string | No | Dirección de correo electrónico de respuesta |
|
||||
| `replyToName` | string | No | Nombre de respuesta |
|
||||
| `attachments` | file[] | No | Archivos para adjuntar al correo electrónico |
|
||||
| `templateId` | string | No | ID de plantilla de SendGrid a utilizar |
|
||||
| `dynamicTemplateData` | json | No | Objeto JSON de datos de plantilla dinámica |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si el correo electrónico se envió correctamente |
|
||||
| `messageId` | string | ID del mensaje de SendGrid |
|
||||
| `to` | string | Dirección de correo electrónico del destinatario |
|
||||
| `subject` | string | Asunto del correo electrónico |
|
||||
|
||||
### `sendgrid_add_contact`
|
||||
|
||||
Añadir un nuevo contacto a SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `email` | string | Sí | Dirección de correo electrónico del contacto |
|
||||
| `firstName` | string | No | Nombre del contacto |
|
||||
| `lastName` | string | No | Apellido del contacto |
|
||||
| `customFields` | json | No | Objeto JSON de pares clave-valor de campos personalizados \(use IDs de campo como e1_T, e2_N, e3_D, no nombres de campo\) |
|
||||
| `listIds` | string | No | Lista separada por comas de IDs a los que añadir el contacto |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | ID de trabajo para seguimiento de la creación asíncrona de contactos |
|
||||
| `email` | string | Dirección de correo electrónico del contacto |
|
||||
| `firstName` | string | Nombre del contacto |
|
||||
| `lastName` | string | Apellido del contacto |
|
||||
| `message` | string | Mensaje de estado |
|
||||
|
||||
### `sendgrid_get_contact`
|
||||
|
||||
Obtener un contacto específico por ID desde SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `contactId` | string | Sí | ID del contacto |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | ID del contacto |
|
||||
| `email` | string | Dirección de correo electrónico del contacto |
|
||||
| `firstName` | string | Nombre del contacto |
|
||||
| `lastName` | string | Apellido del contacto |
|
||||
| `createdAt` | string | Marca de tiempo de creación |
|
||||
| `updatedAt` | string | Marca de tiempo de última actualización |
|
||||
| `listIds` | json | Array de IDs de listas a las que pertenece el contacto |
|
||||
| `customFields` | json | Valores de campos personalizados |
|
||||
|
||||
### `sendgrid_search_contacts`
|
||||
|
||||
Buscar contactos en SendGrid usando una consulta
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `query` | string | Sí | Consulta de búsqueda (p. ej., "email LIKE '%example.com%' AND CONTAINS(list_ids, 'list-id')") |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `contacts` | json | Array de contactos coincidentes |
|
||||
| `contactCount` | number | Número total de contactos encontrados |
|
||||
|
||||
### `sendgrid_delete_contacts`
|
||||
|
||||
Eliminar uno o más contactos de SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `contactIds` | string | Sí | IDs de contactos separados por comas para eliminar |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | ID de trabajo para la solicitud de eliminación |
|
||||
|
||||
### `sendgrid_create_list`
|
||||
|
||||
Crear una nueva lista de contactos en SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `name` | string | Sí | Nombre de la lista |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | ID de la lista |
|
||||
| `name` | string | Nombre de la lista |
|
||||
| `contactCount` | number | Número de contactos en la lista |
|
||||
|
||||
### `sendgrid_get_list`
|
||||
|
||||
Obtener una lista específica por ID desde SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `listId` | string | Sí | ID de la lista |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | ID de la lista |
|
||||
| `name` | string | Nombre de la lista |
|
||||
| `contactCount` | number | Número de contactos en la lista |
|
||||
|
||||
### `sendgrid_list_all_lists`
|
||||
|
||||
Obtener todas las listas de contactos desde SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `pageSize` | number | No | Número de listas a devolver por página \(predeterminado: 100\) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `lists` | json | Array de listas |
|
||||
|
||||
### `sendgrid_delete_list`
|
||||
|
||||
Eliminar una lista de contactos de SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `listId` | string | Sí | ID de la lista a eliminar |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Mensaje de éxito |
|
||||
|
||||
### `sendgrid_add_contacts_to_list`
|
||||
|
||||
Añadir o actualizar contactos y asignarlos a una lista en SendGrid (usa PUT /v3/marketing/contacts)
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `listId` | string | Sí | ID de la lista a la que añadir contactos |
|
||||
| `contacts` | json | Sí | Array JSON de objetos de contacto. Cada contacto debe tener al menos: email \(o phone_number_id/external_id/anonymous_id\). Ejemplo: \[\{"email": "user@example.com", "first_name": "John"\}\] |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | ID del trabajo para seguimiento de la operación asíncrona |
|
||||
| `message` | string | Mensaje de estado |
|
||||
|
||||
### `sendgrid_remove_contacts_from_list`
|
||||
|
||||
Eliminar contactos de una lista específica en SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `listId` | string | Sí | ID de la lista |
|
||||
| `contactIds` | string | Sí | IDs de contactos separados por comas para eliminar de la lista |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | ID del trabajo para la solicitud |
|
||||
|
||||
### `sendgrid_create_template`
|
||||
|
||||
Crear una nueva plantilla de correo electrónico en SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `name` | string | Sí | Nombre de la plantilla |
|
||||
| `generation` | string | No | Tipo de generación de plantilla \(legacy o dynamic, predeterminado: dynamic\) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | ID de la plantilla |
|
||||
| `name` | string | Nombre de la plantilla |
|
||||
| `generation` | string | Generación de la plantilla |
|
||||
| `updatedAt` | string | Marca de tiempo de la última actualización |
|
||||
| `versions` | json | Array de versiones de la plantilla |
|
||||
|
||||
### `sendgrid_get_template`
|
||||
|
||||
Obtener una plantilla específica por ID desde SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `templateId` | string | Sí | ID de la plantilla |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | ID de la plantilla |
|
||||
| `name` | string | Nombre de la plantilla |
|
||||
| `generation` | string | Generación de la plantilla |
|
||||
| `updatedAt` | string | Marca de tiempo de la última actualización |
|
||||
| `versions` | json | Array de versiones de la plantilla |
|
||||
|
||||
### `sendgrid_list_templates`
|
||||
|
||||
Obtener todas las plantillas de correo electrónico de SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `generations` | string | No | Filtrar por generación \(legacy, dynamic, o ambas\) |
|
||||
| `pageSize` | number | No | Número de plantillas a devolver por página \(predeterminado: 20\) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `templates` | json | Array de plantillas |
|
||||
|
||||
### `sendgrid_delete_template`
|
||||
|
||||
Eliminar una plantilla de correo electrónico de SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `templateId` | string | Sí | ID de la plantilla a eliminar |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Estado de éxito de la operación |
|
||||
| `messageId` | string | ID del mensaje de correo electrónico \(send_mail\) |
|
||||
| `id` | string | ID del recurso |
|
||||
| `jobId` | string | ID del trabajo para operaciones asíncronas |
|
||||
| `email` | string | Dirección de correo electrónico |
|
||||
| `firstName` | string | Nombre |
|
||||
| `lastName` | string | Apellido |
|
||||
| `contacts` | json | Array de contactos |
|
||||
| `contactCount` | number | Número de contactos |
|
||||
| `lists` | json | Array de listas |
|
||||
| `templates` | json | Array de plantillas |
|
||||
| `message` | string | Estado o mensaje de éxito |
|
||||
| `name` | string | Nombre del recurso |
|
||||
| `generation` | string | Generación de plantilla |
|
||||
|
||||
### `sendgrid_create_template_version`
|
||||
|
||||
Crear una nueva versión de una plantilla de correo electrónico en SendGrid
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de SendGrid |
|
||||
| `templateId` | string | Sí | ID de la plantilla |
|
||||
| `name` | string | Sí | Nombre de la versión |
|
||||
| `subject` | string | Sí | Línea de asunto del correo electrónico |
|
||||
| `htmlContent` | string | No | Contenido HTML de la plantilla |
|
||||
| `plainContent` | string | No | Contenido de texto plano de la plantilla |
|
||||
| `active` | boolean | No | Si esta versión está activa \(predeterminado: true\) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | ID de la versión |
|
||||
| `templateId` | string | ID de la plantilla |
|
||||
| `name` | string | Nombre de la versión |
|
||||
| `subject` | string | Asunto del correo electrónico |
|
||||
| `active` | boolean | Si esta versión está activa |
|
||||
| `htmlContent` | string | Contenido HTML |
|
||||
| `plainContent` | string | Contenido de texto plano |
|
||||
| `updatedAt` | string | Marca de tiempo de la última actualización |
|
||||
|
||||
## Notas
|
||||
|
||||
- Categoría: `tools`
|
||||
- Tipo: `sendgrid`
|
||||
73
apps/docs/content/docs/es/tools/smtp.mdx
Normal file
73
apps/docs/content/docs/es/tools/smtp.mdx
Normal file
@@ -0,0 +1,73 @@
|
||||
---
|
||||
title: SMTP
|
||||
description: Envía correos electrónicos a través de cualquier servidor de correo SMTP
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="smtp"
|
||||
color="#4A5568"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[SMTP (Simple Mail Transfer Protocol)](https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol) es el estándar fundamental para la transmisión de correos electrónicos a través de Internet. Al conectarte a cualquier servidor compatible con SMTP—como Gmail, Outlook, o la infraestructura de correo de tu organización—puedes enviar correos electrónicos de forma programática y automatizar tus comunicaciones salientes.
|
||||
|
||||
La integración SMTP te permite personalizar completamente el envío de correos electrónicos mediante conectividad directa con el servidor, admitiendo casos de uso de correo electrónico tanto básicos como avanzados. Con SMTP, puedes controlar todos los aspectos de la entrega de mensajes, la gestión de destinatarios y el formato del contenido, lo que lo hace adecuado para notificaciones transaccionales, envíos masivos y cualquier flujo de trabajo automatizado que requiera una entrega robusta de correos electrónicos salientes.
|
||||
|
||||
**Las características clave disponibles a través de la integración SMTP incluyen:**
|
||||
|
||||
- **Entrega universal de correos electrónicos:** Envía correos electrónicos utilizando cualquier servidor SMTP configurando parámetros estándar de conexión al servidor.
|
||||
- **Remitente y destinatarios personalizables:** Especifica la dirección del remitente, el nombre para mostrar, los destinatarios principales, así como los campos CC y CCO.
|
||||
- **Soporte para contenido enriquecido:** Envía correos electrónicos de texto plano o con formato HTML enriquecido según tus requisitos.
|
||||
- **Archivos adjuntos:** Incluye múltiples archivos como adjuntos en los correos electrónicos salientes.
|
||||
- **Seguridad flexible:** Conéctate usando protocolos TLS, SSL o estándar (sin cifrar) según lo admita tu proveedor SMTP.
|
||||
- **Encabezados avanzados:** Configura encabezados de respuesta y otras opciones avanzadas de correo electrónico para atender flujos de correo complejos e interacciones de usuario.
|
||||
|
||||
Al integrar SMTP con Sim, los agentes y flujos de trabajo pueden enviar correos electrónicos de forma programática como parte de cualquier proceso automatizado—desde el envío de notificaciones y confirmaciones, hasta la automatización de comunicaciones externas, informes y entrega de documentos. Esto ofrece un enfoque altamente flexible e independiente del proveedor para gestionar el correo electrónico directamente dentro de tus procesos impulsados por IA.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instrucciones de uso
|
||||
|
||||
Envía correos electrónicos utilizando cualquier servidor SMTP (Gmail, Outlook, servidores personalizados, etc.). Configura los ajustes de conexión SMTP y envía correos electrónicos con control total sobre el contenido, destinatarios y archivos adjuntos.
|
||||
|
||||
## Herramientas
|
||||
|
||||
### `smtp_send_mail`
|
||||
|
||||
Enviar correos electrónicos a través del servidor SMTP
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `smtpHost` | string | Sí | Nombre del host del servidor SMTP \(p. ej., smtp.gmail.com\) |
|
||||
| `smtpPort` | number | Sí | Puerto del servidor SMTP \(587 para TLS, 465 para SSL\) |
|
||||
| `smtpUsername` | string | Sí | Nombre de usuario para autenticación SMTP |
|
||||
| `smtpPassword` | string | Sí | Contraseña para autenticación SMTP |
|
||||
| `smtpSecure` | string | Sí | Protocolo de seguridad \(TLS, SSL o Ninguno\) |
|
||||
| `from` | string | Sí | Dirección de correo electrónico del remitente |
|
||||
| `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 |
|
||||
| `contentType` | string | No | Tipo de contenido \(texto o html\) |
|
||||
| `fromName` | string | No | Nombre para mostrar del remitente |
|
||||
| `cc` | string | No | Destinatarios en CC \(separados por comas\) |
|
||||
| `bcc` | string | No | Destinatarios en CCO \(separados por comas\) |
|
||||
| `replyTo` | string | No | Dirección de correo electrónico de respuesta |
|
||||
| `attachments` | file[] | No | Archivos para adjuntar al correo electrónico |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si el correo electrónico se envió correctamente |
|
||||
| `messageId` | string | ID del mensaje del servidor SMTP |
|
||||
| `to` | string | Dirección de correo electrónico del destinatario |
|
||||
| `subject` | string | Asunto del correo electrónico |
|
||||
| `error` | string | Mensaje de error si el envío falló |
|
||||
|
||||
## Notas
|
||||
|
||||
- Categoría: `tools`
|
||||
- Tipo: `smtp`
|
||||
89
apps/docs/content/docs/fr/tools/apify.mdx
Normal file
89
apps/docs/content/docs/fr/tools/apify.mdx
Normal file
@@ -0,0 +1,89 @@
|
||||
---
|
||||
title: Apify
|
||||
description: Exécutez des acteurs Apify et récupérez les résultats
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="apify"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Apify](https://apify.com/) est une plateforme puissante pour créer, déployer et exécuter des automatisations web et des acteurs de scraping à grande échelle. Apify vous permet d'extraire des données utiles de n'importe quel site web, d'automatiser des flux de travail et de connecter vos pipelines de données de manière transparente.
|
||||
|
||||
Avec Apify, vous pouvez :
|
||||
|
||||
- **Exécuter des acteurs prêts à l'emploi ou personnalisés** : Intégrez des acteurs publics ou développez les vôtres, en automatisant un large éventail d'extractions de données web et de tâches de navigation.
|
||||
- **Récupérer des ensembles de données** : Accédez et gérez des ensembles de données structurées collectées par les acteurs en temps réel.
|
||||
- **Mettre à l'échelle l'automatisation web** : Exploitez l'infrastructure cloud pour exécuter des tâches de manière fiable, de façon asynchrone ou synchrone, avec une gestion robuste des erreurs.
|
||||
|
||||
Dans Sim, l'intégration Apify permet à vos agents d'effectuer des opérations Apify essentielles de manière programmatique :
|
||||
|
||||
- **Exécuter un acteur (Sync)** : Utilisez `apify_run_actor_sync` pour lancer un acteur Apify et attendre sa complétion, récupérant les résultats dès que l'exécution se termine.
|
||||
- **Exécuter un acteur (Async)** : Utilisez `apify_run_actor_async` pour démarrer un acteur en arrière-plan et interroger périodiquement les résultats, adapté aux tâches plus longues ou complexes.
|
||||
|
||||
Ces opérations équipent vos agents pour automatiser, scraper et orchestrer la collecte de données ou les tâches d'automatisation de navigateur directement dans les flux de travail — le tout avec une configuration flexible et une gestion des résultats, sans nécessiter d'exécutions manuelles ou d'outils externes. Intégrez Apify comme un moteur dynamique d'automatisation et d'extraction de données qui alimente de manière programmatique les flux de travail à l'échelle du web de vos agents.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instructions d'utilisation
|
||||
|
||||
Intégrez Apify dans votre flux de travail. Exécutez n'importe quel acteur Apify avec des entrées personnalisées et récupérez les résultats. Prend en charge l'exécution synchrone et asynchrone avec récupération automatique des ensembles de données.
|
||||
|
||||
## Outils
|
||||
|
||||
### `apify_run_actor_sync`
|
||||
|
||||
Exécuter un acteur APIFY de manière synchrone et obtenir les résultats (maximum 5 minutes)
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Jeton API APIFY depuis console.apify.com/account#/integrations |
|
||||
| `actorId` | chaîne | Oui | ID de l'acteur ou nom d'utilisateur/nom-acteur \(ex. : "janedoe/my-actor" ou ID de l'acteur\) |
|
||||
| `input` | chaîne | Non | Entrée de l'acteur sous forme de chaîne JSON. Voir la documentation de l'acteur pour les champs requis. |
|
||||
| `timeout` | nombre | Non | Délai d'attente en secondes \(par défaut : valeur par défaut de l'acteur\) |
|
||||
| `build` | chaîne | Non | Version de l'acteur à exécuter \(ex. : "latest", "beta", ou tag/numéro de build\) |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | booléen | Indique si l'exécution de l'acteur a réussi |
|
||||
| `runId` | chaîne | ID d'exécution APIFY |
|
||||
| `status` | chaîne | Statut d'exécution \(SUCCEEDED, FAILED, etc.\) |
|
||||
| `datasetId` | chaîne | ID du jeu de données contenant les résultats |
|
||||
| `items` | tableau | Éléments du jeu de données \(si terminé\) |
|
||||
|
||||
### `apify_run_actor_async`
|
||||
|
||||
Exécuter un acteur APIFY de manière asynchrone avec interrogation périodique pour les tâches de longue durée
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Jeton API APIFY depuis console.apify.com/account#/integrations |
|
||||
| `actorId` | chaîne | Oui | ID de l'acteur ou nom d'utilisateur/nom-acteur \(ex. : "janedoe/my-actor" ou ID de l'acteur\) |
|
||||
| `input` | chaîne | Non | Entrée de l'acteur sous forme de chaîne JSON |
|
||||
| `waitForFinish` | nombre | Non | Temps d'attente initial en secondes \(0-60\) avant le début de l'interrogation |
|
||||
| `itemLimit` | nombre | Non | Nombre maximum d'éléments de jeu de données à récupérer \(1-250000, par défaut 100\) |
|
||||
| `timeout` | nombre | Non | Délai d'attente en secondes \(par défaut : valeur par défaut de l'acteur\) |
|
||||
| `build` | chaîne | Non | Version de l'acteur à exécuter \(ex. : "latest", "beta", ou tag/numéro de build\) |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Indique si l'exécution de l'acteur a réussi |
|
||||
| `runId` | string | ID d'exécution APIFY |
|
||||
| `status` | string | Statut d'exécution \(SUCCEEDED, FAILED, etc.\) |
|
||||
| `datasetId` | string | ID du dataset contenant les résultats |
|
||||
| `items` | array | Éléments du dataset \(si terminé\) |
|
||||
|
||||
## Notes
|
||||
|
||||
- Catégorie : `tools`
|
||||
- Type : `apify`
|
||||
188
apps/docs/content/docs/fr/tools/dynamodb.mdx
Normal file
188
apps/docs/content/docs/fr/tools/dynamodb.mdx
Normal file
@@ -0,0 +1,188 @@
|
||||
---
|
||||
title: Amazon DynamoDB
|
||||
description: Connexion à Amazon DynamoDB
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="dynamodb"
|
||||
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Amazon DynamoDB](https://aws.amazon.com/dynamodb/) est un service de base de données NoSQL entièrement géré proposé par AWS qui offre des performances rapides et prévisibles avec une évolutivité transparente. DynamoDB vous permet de stocker et de récupérer n'importe quelle quantité de données et gère n'importe quel niveau de trafic de requêtes, sans que vous ayez à gérer le matériel ou l'infrastructure.
|
||||
|
||||
Avec DynamoDB, vous pouvez :
|
||||
|
||||
- **Obtenir des éléments** : rechercher des éléments dans vos tables à l'aide de clés primaires
|
||||
- **Mettre des éléments** : ajouter ou remplacer des éléments dans vos tables
|
||||
- **Interroger des éléments** : récupérer plusieurs éléments à l'aide de requêtes sur les index
|
||||
- **Scanner des tables** : lire tout ou partie des données d'une table
|
||||
- **Mettre à jour des éléments** : modifier des attributs spécifiques d'éléments existants
|
||||
- **Supprimer des éléments** : supprimer des enregistrements de vos tables
|
||||
|
||||
Dans Sim, l'intégration DynamoDB permet à vos agents d'accéder en toute sécurité aux tables DynamoDB et de les manipuler à l'aide des identifiants AWS. Les opérations prises en charge comprennent :
|
||||
|
||||
- **Get** : récupérer un élément par sa clé
|
||||
- **Put** : insérer ou écraser des éléments
|
||||
- **Query** : exécuter des requêtes à l'aide de conditions de clé et de filtres
|
||||
- **Scan** : lire plusieurs éléments en scannant la table ou l'index
|
||||
- **Update** : modifier des attributs spécifiques d'un ou plusieurs éléments
|
||||
- **Delete** : supprimer un élément d'une table
|
||||
|
||||
Cette intégration permet aux agents Sim d'automatiser les tâches de gestion de données au sein de vos tables DynamoDB de manière programmatique, afin que vous puissiez créer des flux de travail qui gèrent, modifient et récupèrent des données NoSQL évolutives sans effort manuel ni gestion de serveur.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instructions d'utilisation
|
||||
|
||||
Intégrez Amazon DynamoDB dans les flux de travail. Prend en charge les opérations Get, Put, Query, Scan, Update et Delete sur les tables DynamoDB.
|
||||
|
||||
## Outils
|
||||
|
||||
### `dynamodb_get`
|
||||
|
||||
Récupérer un élément d'une table DynamoDB par clé primaire
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
|
||||
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
|
||||
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
|
||||
| `tableName` | chaîne | Oui | Nom de la table DynamoDB |
|
||||
| `key` | objet | Oui | Clé primaire de l'élément à récupérer |
|
||||
| `consistentRead` | booléen | Non | Utiliser une lecture fortement cohérente |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | chaîne | Message d'état de l'opération |
|
||||
| `item` | objet | Élément récupéré |
|
||||
|
||||
### `dynamodb_put`
|
||||
|
||||
Mettre un élément dans une table DynamoDB
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
|
||||
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
|
||||
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
|
||||
| `tableName` | chaîne | Oui | Nom de la table DynamoDB |
|
||||
| `item` | objet | Oui | Élément à mettre dans la table |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | chaîne | Message d'état de l'opération |
|
||||
| `item` | objet | Élément créé |
|
||||
|
||||
### `dynamodb_query`
|
||||
|
||||
Interroger les éléments d'une table DynamoDB à l'aide de conditions de clé
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
|
||||
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
|
||||
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
|
||||
| `tableName` | chaîne | Oui | Nom de la table DynamoDB |
|
||||
| `keyConditionExpression` | chaîne | Oui | Expression de condition de clé (par ex., "pk = :pk") |
|
||||
| `filterExpression` | chaîne | Non | Expression de filtre pour les résultats |
|
||||
| `expressionAttributeNames` | objet | Non | Mappages de noms d'attributs pour les mots réservés |
|
||||
| `expressionAttributeValues` | objet | Non | Valeurs d'attributs d'expression |
|
||||
| `indexName` | chaîne | Non | Nom de l'index secondaire à interroger |
|
||||
| `limit` | nombre | Non | Nombre maximum d'éléments à retourner |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | chaîne | Message d'état de l'opération |
|
||||
| `items` | tableau | Tableau des éléments retournés |
|
||||
| `count` | nombre | Nombre d'éléments retournés |
|
||||
|
||||
### `dynamodb_scan`
|
||||
|
||||
Scanner tous les éléments d'une table DynamoDB
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
|
||||
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
|
||||
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
|
||||
| `tableName` | chaîne | Oui | Nom de la table DynamoDB |
|
||||
| `filterExpression` | chaîne | Non | Expression de filtre pour les résultats |
|
||||
| `projectionExpression` | chaîne | Non | Attributs à récupérer |
|
||||
| `expressionAttributeNames` | objet | Non | Mappages de noms d'attributs pour les mots réservés |
|
||||
| `expressionAttributeValues` | objet | Non | Valeurs d'attributs d'expression |
|
||||
| `limit` | nombre | Non | Nombre maximum d'éléments à retourner |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Message d'état de l'opération |
|
||||
| `items` | array | Tableau des éléments retournés |
|
||||
| `count` | number | Nombre d'éléments retournés |
|
||||
|
||||
### `dynamodb_update`
|
||||
|
||||
Mettre à jour un élément dans une table DynamoDB
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Oui | Région AWS (par ex., us-east-1) |
|
||||
| `accessKeyId` | string | Oui | ID de clé d'accès AWS |
|
||||
| `secretAccessKey` | string | Oui | Clé d'accès secrète AWS |
|
||||
| `tableName` | string | Oui | Nom de la table DynamoDB |
|
||||
| `key` | object | Oui | Clé primaire de l'élément à mettre à jour |
|
||||
| `updateExpression` | string | Oui | Expression de mise à jour (par ex., "SET #name = :name") |
|
||||
| `expressionAttributeNames` | object | Non | Mappages de noms d'attributs pour les mots réservés |
|
||||
| `expressionAttributeValues` | object | Non | Valeurs d'attributs d'expression |
|
||||
| `conditionExpression` | string | Non | Condition qui doit être remplie pour que la mise à jour réussisse |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Message d'état de l'opération |
|
||||
| `item` | object | Élément mis à jour |
|
||||
|
||||
### `dynamodb_delete`
|
||||
|
||||
Supprimer un élément d'une table DynamoDB
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Oui | Région AWS (par ex., us-east-1) |
|
||||
| `accessKeyId` | string | Oui | ID de clé d'accès AWS |
|
||||
| `secretAccessKey` | string | Oui | Clé d'accès secrète AWS |
|
||||
| `tableName` | string | Oui | Nom de la table DynamoDB |
|
||||
| `key` | object | Oui | Clé primaire de l'élément à supprimer |
|
||||
| `conditionExpression` | string | Non | Condition qui doit être remplie pour que la suppression réussisse |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Message d'état de l'opération |
|
||||
|
||||
## Notes
|
||||
|
||||
- Catégorie : `tools`
|
||||
- Type : `dynamodb`
|
||||
83
apps/docs/content/docs/fr/tools/linkedin.mdx
Normal file
83
apps/docs/content/docs/fr/tools/linkedin.mdx
Normal file
@@ -0,0 +1,83 @@
|
||||
---
|
||||
title: LinkedIn
|
||||
description: Partagez des publications et gérez votre présence LinkedIn
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="linkedin"
|
||||
color="#0072B1"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[LinkedIn](https://www.linkedin.com) est la plus grande plateforme de réseautage professionnel au monde, permettant aux utilisateurs de développer leur carrière, de se connecter avec leur réseau et de partager du contenu professionnel. LinkedIn est largement utilisé par des professionnels de tous secteurs pour le développement de leur marque personnelle, le recrutement, la recherche d'emploi et le développement commercial.
|
||||
|
||||
Avec LinkedIn, vous pouvez facilement partager des publications sur votre fil personnel pour interagir avec votre réseau et accéder aux informations de votre profil pour mettre en valeur vos réalisations professionnelles. L'intégration automatisée avec Sim vous permet d'exploiter les fonctionnalités de LinkedIn de manière programmatique, permettant aux agents et aux flux de travail de publier des mises à jour, de générer des rapports sur votre présence professionnelle et de maintenir votre fil d'actualité actif sans effort manuel.
|
||||
|
||||
Les principales fonctionnalités de LinkedIn disponibles via cette intégration comprennent :
|
||||
|
||||
- **Partage de publications :** Publiez automatiquement des mises à jour professionnelles, des articles ou des annonces sur votre fil personnel LinkedIn.
|
||||
- **Informations de profil :** Récupérez des informations détaillées sur votre profil LinkedIn pour les surveiller ou les utiliser dans des tâches en aval au sein de vos flux de travail.
|
||||
|
||||
Ces capacités facilitent l'engagement de votre réseau LinkedIn et l'extension efficace de votre portée professionnelle dans le cadre de votre stratégie d'automatisation IA ou de flux de travail.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instructions d'utilisation
|
||||
|
||||
Intégrez LinkedIn dans vos flux de travail. Partagez des publications sur votre fil personnel et accédez aux informations de votre profil LinkedIn.
|
||||
|
||||
## Outils
|
||||
|
||||
### `linkedin_share_post`
|
||||
|
||||
Partager une publication sur votre fil personnel LinkedIn
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ---------- | ----------- |
|
||||
| `text` | string | Oui | Le contenu textuel de votre publication LinkedIn |
|
||||
| `visibility` | string | Non | Qui peut voir cette publication : "PUBLIC" ou "CONNECTIONS" \(par défaut : "PUBLIC"\) |
|
||||
| `request` | string | Non | Pas de description |
|
||||
| `output` | string | Non | Pas de description |
|
||||
| `output` | string | Non | Pas de description |
|
||||
| `specificContent` | string | Non | Pas de description |
|
||||
| `shareCommentary` | string | Non | Pas de description |
|
||||
| `visibility` | string | Non | Pas de description |
|
||||
| `headers` | string | Non | Pas de description |
|
||||
| `output` | string | Non | Pas de description |
|
||||
| `output` | string | Non | Pas de description |
|
||||
| `output` | string | Non | Pas de description |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Statut de réussite de l'opération |
|
||||
| `postId` | string | ID du post créé |
|
||||
| `profile` | json | Informations du profil LinkedIn |
|
||||
| `error` | string | Message d'erreur si l'opération a échoué |
|
||||
|
||||
### `linkedin_get_profile`
|
||||
|
||||
Récupérer les informations de votre profil LinkedIn
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Statut de réussite de l'opération |
|
||||
| `postId` | string | ID du post créé |
|
||||
| `profile` | json | Informations du profil LinkedIn |
|
||||
| `error` | string | Message d'erreur si l'opération a échoué |
|
||||
|
||||
## Notes
|
||||
|
||||
- Catégorie : `tools`
|
||||
- Type : `linkedin`
|
||||
216
apps/docs/content/docs/fr/tools/mailgun.mdx
Normal file
216
apps/docs/content/docs/fr/tools/mailgun.mdx
Normal file
@@ -0,0 +1,216 @@
|
||||
---
|
||||
title: Mailgun
|
||||
description: Envoyez des e-mails et gérez des listes de diffusion avec Mailgun
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="mailgun"
|
||||
color="#F06248"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Mailgun](https://www.mailgun.com) est un service puissant d'envoi d'e-mails conçu pour les développeurs et les entreprises afin d'envoyer, recevoir et suivre des e-mails sans effort. Mailgun vous permet d'exploiter des API robustes pour des e-mails transactionnels et marketing fiables, une gestion flexible des listes de diffusion et un suivi avancé des événements.
|
||||
|
||||
Avec l'ensemble complet de fonctionnalités de Mailgun, vous pouvez automatiser les opérations clés liées aux e-mails et surveiller étroitement la délivrabilité et l'engagement des destinataires. Cela en fait une solution idéale pour l'automatisation des flux de travail où les communications, les notifications et les campagnes d'e-mails sont des éléments essentiels de vos processus.
|
||||
|
||||
Les fonctionnalités clés de Mailgun comprennent :
|
||||
|
||||
- **Envoi d'e-mails transactionnels :** Livrez des e-mails à haut volume tels que des notifications de compte, des reçus, des alertes et des réinitialisations de mot de passe.
|
||||
- **Contenu d'e-mail enrichi :** Envoyez des e-mails en texte brut et en HTML, et utilisez des balises pour catégoriser et suivre vos messages.
|
||||
- **Gestion des listes de diffusion :** Créez, mettez à jour et gérez des listes de diffusion et des membres pour envoyer efficacement des communications groupées.
|
||||
- **Informations sur les domaines :** Récupérez des détails sur vos domaines d'envoi pour surveiller la configuration et la santé.
|
||||
- **Suivi des événements :** Analysez la délivrabilité des e-mails et l'engagement avec des données détaillées sur les messages envoyés.
|
||||
- **Récupération des messages :** Accédez aux messages stockés pour des besoins de conformité, d'analyse ou de dépannage.
|
||||
|
||||
En intégrant Mailgun à Sim, vos agents sont habilités à envoyer des e-mails par programmation, gérer des listes d'e-mails, accéder aux informations de domaine et surveiller les événements en temps réel dans le cadre de flux de travail automatisés. Cela permet un engagement intelligent et basé sur les données avec vos utilisateurs directement à partir de vos processus alimentés par l'IA.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instructions d'utilisation
|
||||
|
||||
Intégrez Mailgun dans votre flux de travail. Envoyez des e-mails transactionnels, gérez des listes de diffusion et leurs membres, consultez les informations de domaine et suivez les événements liés aux e-mails. Prend en charge les e-mails texte et HTML, les balises pour le suivi et une gestion complète des listes.
|
||||
|
||||
## Outils
|
||||
|
||||
### `mailgun_send_message`
|
||||
|
||||
Envoyer un e-mail en utilisant l'API Mailgun
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API Mailgun |
|
||||
| `domain` | chaîne | Oui | Domaine Mailgun \(ex. : mg.example.com\) |
|
||||
| `from` | chaîne | Oui | Adresse e-mail de l'expéditeur |
|
||||
| `to` | chaîne | Oui | Adresse e-mail du destinataire \(séparées par des virgules pour plusieurs\) |
|
||||
| `subject` | chaîne | Oui | Objet de l'e-mail |
|
||||
| `text` | chaîne | Non | Corps de l'e-mail en texte brut |
|
||||
| `html` | chaîne | Non | Corps de l'e-mail en HTML |
|
||||
| `cc` | chaîne | Non | Adresse e-mail en CC \(séparées par des virgules pour plusieurs\) |
|
||||
| `bcc` | chaîne | Non | Adresse e-mail en BCC \(séparées par des virgules pour plusieurs\) |
|
||||
| `tags` | chaîne | Non | Tags pour l'e-mail \(séparés par des virgules\) |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | booléen | Indique si le message a été envoyé avec succès |
|
||||
| `id` | chaîne | ID du message |
|
||||
| `message` | chaîne | Message de réponse de Mailgun |
|
||||
|
||||
### `mailgun_get_message`
|
||||
|
||||
Récupérer un message stocké par sa clé
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API Mailgun |
|
||||
| `domain` | chaîne | Oui | Domaine Mailgun |
|
||||
| `messageKey` | chaîne | Oui | Clé de stockage du message |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Indique si la requête a réussi |
|
||||
| `recipients` | string | Destinataires du message |
|
||||
| `from` | string | Email de l'expéditeur |
|
||||
| `subject` | string | Objet du message |
|
||||
| `bodyPlain` | string | Corps du texte brut |
|
||||
| `strippedText` | string | Texte épuré |
|
||||
| `strippedSignature` | string | Signature épurée |
|
||||
| `bodyHtml` | string | Corps HTML |
|
||||
| `strippedHtml` | string | HTML épuré |
|
||||
| `attachmentCount` | number | Nombre de pièces jointes |
|
||||
| `timestamp` | number | Horodatage du message |
|
||||
| `messageHeaders` | json | En-têtes du message |
|
||||
| `contentIdMap` | json | Carte des ID de contenu |
|
||||
|
||||
### `mailgun_list_messages`
|
||||
|
||||
Liste des événements (journaux) pour les messages envoyés via Mailgun
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `apiKey` | string | Oui | Clé API Mailgun |
|
||||
| `domain` | string | Oui | Domaine Mailgun |
|
||||
| `event` | string | Non | Filtrer par type d'événement \(accepted, delivered, failed, opened, clicked, etc.\) |
|
||||
| `limit` | number | Non | Nombre maximum d'événements à retourner \(par défaut : 100\) |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Indique si la requête a réussi |
|
||||
| `items` | json | Tableau d'éléments d'événements |
|
||||
| `paging` | json | Informations de pagination |
|
||||
|
||||
### `mailgun_create_mailing_list`
|
||||
|
||||
Créer une nouvelle liste de diffusion
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API Mailgun |
|
||||
| `address` | chaîne | Oui | Adresse de la liste de diffusion \(ex., liste@exemple.com\) |
|
||||
| `name` | chaîne | Non | Nom de la liste de diffusion |
|
||||
| `description` | chaîne | Non | Description de la liste de diffusion |
|
||||
| `accessLevel` | chaîne | Non | Niveau d'accès : readonly, members, ou everyone |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | booléen | Indique si la liste a été créée avec succès |
|
||||
| `message` | chaîne | Message de réponse |
|
||||
| `list` | json | Détails de la liste de diffusion créée |
|
||||
|
||||
### `mailgun_get_mailing_list`
|
||||
|
||||
Obtenir les détails d'une liste de diffusion
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API Mailgun |
|
||||
| `address` | chaîne | Oui | Adresse de la liste de diffusion |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | booléen | Indique si la requête a réussi |
|
||||
| `list` | json | Détails de la liste de diffusion |
|
||||
|
||||
### `mailgun_add_list_member`
|
||||
|
||||
Ajouter un membre à une liste de diffusion
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API Mailgun |
|
||||
| `listAddress` | chaîne | Oui | Adresse de la liste de diffusion |
|
||||
| `address` | chaîne | Oui | Adresse e-mail du membre |
|
||||
| `name` | chaîne | Non | Nom du membre |
|
||||
| `vars` | chaîne | Non | Chaîne JSON des variables personnalisées |
|
||||
| `subscribed` | booléen | Non | Indique si le membre est abonné |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Indique si le membre a été ajouté avec succès |
|
||||
| `message` | string | Message de réponse |
|
||||
| `member` | json | Détails du membre ajouté |
|
||||
|
||||
### `mailgun_list_domains`
|
||||
|
||||
Lister tous les domaines de votre compte Mailgun
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Oui | Clé API Mailgun |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Indique si la requête a réussi |
|
||||
| `totalCount` | number | Nombre total de domaines |
|
||||
| `items` | json | Tableau d'objets de domaine |
|
||||
|
||||
### `mailgun_get_domain`
|
||||
|
||||
Obtenir les détails d'un domaine spécifique
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Oui | Clé API Mailgun |
|
||||
| `domain` | string | Oui | Nom de domaine |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Indique si la requête a réussi |
|
||||
| `domain` | json | Détails du domaine |
|
||||
|
||||
## Notes
|
||||
|
||||
- Catégorie : `tools`
|
||||
- Type : `mailgun`
|
||||
168
apps/docs/content/docs/fr/tools/rds.mdx
Normal file
168
apps/docs/content/docs/fr/tools/rds.mdx
Normal file
@@ -0,0 +1,168 @@
|
||||
---
|
||||
title: Amazon RDS
|
||||
description: Connexion à Amazon RDS via l'API Data
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="rds"
|
||||
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Amazon RDS Aurora Serverless](https://aws.amazon.com/rds/aurora/serverless/) est une base de données relationnelle entièrement gérée qui démarre, s'arrête et adapte automatiquement sa capacité en fonction des besoins de votre application. Elle vous permet d'exécuter des bases de données SQL dans le cloud sans avoir à gérer des serveurs de base de données.
|
||||
|
||||
Avec RDS Aurora Serverless, vous pouvez :
|
||||
|
||||
- **Interroger des données** : exécuter des requêtes SQL flexibles sur vos tables
|
||||
- **Insérer de nouveaux enregistrements** : ajouter automatiquement des données à votre base de données
|
||||
- **Mettre à jour des enregistrements existants** : modifier des données dans vos tables à l'aide de filtres personnalisés
|
||||
- **Supprimer des enregistrements** : éliminer les données indésirables en utilisant des critères précis
|
||||
- **Exécuter du SQL brut** : lancer toute commande SQL valide prise en charge par Aurora
|
||||
|
||||
Dans Sim, l'intégration RDS permet à vos agents de travailler avec les bases de données Amazon Aurora Serverless de manière sécurisée et programmatique. Les opérations prises en charge comprennent :
|
||||
|
||||
- **Requête** : exécuter des requêtes SELECT et autres requêtes SQL pour récupérer des lignes de votre base de données
|
||||
- **Insertion** : insérer de nouveaux enregistrements dans les tables avec des données structurées
|
||||
- **Mise à jour** : modifier les données dans les lignes qui correspondent à vos conditions spécifiées
|
||||
- **Suppression** : supprimer des enregistrements d'une table par filtres ou critères personnalisés
|
||||
- **Exécution** : exécuter du SQL brut pour des scénarios avancés
|
||||
|
||||
Cette intégration permet à vos agents d'automatiser un large éventail d'opérations de base de données sans intervention manuelle. En connectant Sim avec Amazon RDS, vous pouvez créer des agents qui gèrent, mettent à jour et récupèrent des données relationnelles dans vos flux de travail, le tout sans avoir à gérer l'infrastructure ou les connexions de base de données.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instructions d'utilisation
|
||||
|
||||
Intégrez Amazon RDS Aurora Serverless dans le flux de travail en utilisant l'API Data. Possibilité d'interroger, d'insérer, de mettre à jour, de supprimer et d'exécuter du SQL brut sans gérer les connexions à la base de données.
|
||||
|
||||
## Outils
|
||||
|
||||
### `rds_query`
|
||||
|
||||
Exécuter une requête SELECT sur Amazon RDS en utilisant l'API Data
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | chaîne | Oui | Région AWS \(ex., us-east-1\) |
|
||||
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
|
||||
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
|
||||
| `resourceArn` | chaîne | Oui | ARN du cluster Aurora DB |
|
||||
| `secretArn` | chaîne | Oui | ARN du secret Secrets Manager contenant les identifiants de la base de données |
|
||||
| `database` | chaîne | Non | Nom de la base de données \(facultatif\) |
|
||||
| `query` | chaîne | Oui | Requête SQL SELECT à exécuter |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | chaîne | Message d'état de l'opération |
|
||||
| `rows` | tableau | Tableau des lignes retournées par la requête |
|
||||
| `rowCount` | nombre | Nombre de lignes retournées |
|
||||
|
||||
### `rds_insert`
|
||||
|
||||
Insérer des données dans une table Amazon RDS en utilisant l'API Data
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | chaîne | Oui | Région AWS \(ex., us-east-1\) |
|
||||
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
|
||||
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
|
||||
| `resourceArn` | chaîne | Oui | ARN du cluster Aurora DB |
|
||||
| `secretArn` | chaîne | Oui | ARN du secret Secrets Manager contenant les identifiants de la base de données |
|
||||
| `database` | chaîne | Non | Nom de la base de données \(facultatif\) |
|
||||
| `table` | chaîne | Oui | Nom de la table dans laquelle insérer |
|
||||
| `data` | objet | Oui | Données à insérer sous forme de paires clé-valeur |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Message d'état de l'opération |
|
||||
| `rows` | array | Tableau des lignes insérées |
|
||||
| `rowCount` | number | Nombre de lignes insérées |
|
||||
|
||||
### `rds_update`
|
||||
|
||||
Mettre à jour des données dans une table Amazon RDS en utilisant l'API Data
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | Oui | Région AWS (par ex., us-east-1) |
|
||||
| `accessKeyId` | string | Oui | ID de clé d'accès AWS |
|
||||
| `secretAccessKey` | string | Oui | Clé d'accès secrète AWS |
|
||||
| `resourceArn` | string | Oui | ARN du cluster de base de données Aurora |
|
||||
| `secretArn` | string | Oui | ARN du secret Secrets Manager contenant les identifiants de la base de données |
|
||||
| `database` | string | Non | Nom de la base de données (facultatif) |
|
||||
| `table` | string | Oui | Nom de la table à mettre à jour |
|
||||
| `data` | object | Oui | Données à mettre à jour sous forme de paires clé-valeur |
|
||||
| `conditions` | object | Oui | Conditions pour la mise à jour (par ex., `{"id": 1}`) |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Message d'état de l'opération |
|
||||
| `rows` | array | Tableau des lignes mises à jour |
|
||||
| `rowCount` | number | Nombre de lignes mises à jour |
|
||||
|
||||
### `rds_delete`
|
||||
|
||||
Supprimer des données d'une table Amazon RDS en utilisant l'API Data
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
|
||||
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
|
||||
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
|
||||
| `resourceArn` | chaîne | Oui | ARN du cluster de base de données Aurora |
|
||||
| `secretArn` | chaîne | Oui | ARN du secret Secrets Manager contenant les identifiants de la base de données |
|
||||
| `database` | chaîne | Non | Nom de la base de données (facultatif) |
|
||||
| `table` | chaîne | Oui | Nom de la table à supprimer |
|
||||
| `conditions` | objet | Oui | Conditions pour la suppression (par ex., `{"id": 1}`) |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | chaîne | Message d'état de l'opération |
|
||||
| `rows` | tableau | Tableau des lignes supprimées |
|
||||
| `rowCount` | nombre | Nombre de lignes supprimées |
|
||||
|
||||
### `rds_execute`
|
||||
|
||||
Exécuter du SQL brut sur Amazon RDS en utilisant l'API Data
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
|
||||
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
|
||||
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
|
||||
| `resourceArn` | chaîne | Oui | ARN du cluster de base de données Aurora |
|
||||
| `secretArn` | chaîne | Oui | ARN du secret Secrets Manager contenant les identifiants de la base de données |
|
||||
| `database` | chaîne | Non | Nom de la base de données (facultatif) |
|
||||
| `query` | chaîne | Oui | Requête SQL brute à exécuter |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Message d'état de l'opération |
|
||||
| `rows` | array | Tableau des lignes retournées ou affectées |
|
||||
| `rowCount` | number | Nombre de lignes affectées |
|
||||
|
||||
## Notes
|
||||
|
||||
- Catégorie : `tools`
|
||||
- Type : `rds`
|
||||
@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="s3"
|
||||
color="#E0E0E0"
|
||||
color="linear-gradient(45deg, #1B660F 0%, #6CAE3E 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
|
||||
54
apps/docs/content/docs/fr/tools/search.mdx
Normal file
54
apps/docs/content/docs/fr/tools/search.mdx
Normal file
@@ -0,0 +1,54 @@
|
||||
---
|
||||
title: Recherche
|
||||
description: Rechercher sur le web (0,01 $ par recherche)
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="search"
|
||||
color="#3B82F6"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
L'outil **Recherche** vous permet de rechercher sur le web depuis vos flux de travail Sim en utilisant des moteurs de recherche à la pointe de la technologie. Utilisez-le pour intégrer les dernières informations, actualités, faits et contenus web directement dans vos agents, automatisations ou conversations.
|
||||
|
||||
- **Recherche web générale** : trouvez des informations à jour sur internet pour compléter vos flux de travail.
|
||||
- **Requêtes automatisées** : laissez les agents ou la logique du programme soumettre des requêtes de recherche et traiter les résultats automatiquement.
|
||||
- **Résultats structurés** : renvoie les résultats web les plus pertinents, y compris le titre, le lien, l'extrait et la date pour chaque résultat.
|
||||
|
||||
> **Remarque :** chaque recherche coûte **0,01 $** par requête.
|
||||
|
||||
Cet outil est idéal pour tout flux de travail où vos agents ont besoin d'accéder à des données web en direct ou doivent faire référence à des événements actuels, effectuer des recherches ou récupérer du contenu supplémentaire.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instructions d'utilisation
|
||||
|
||||
Recherchez sur le web à l'aide de l'outil Recherche. Chaque recherche coûte 0,01 $ par requête.
|
||||
|
||||
## Outils
|
||||
|
||||
### `search_tool`
|
||||
|
||||
Rechercher sur le web. Renvoie les résultats web les plus pertinents, y compris le titre, le lien, l'extrait et la date pour chaque résultat.
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `query` | string | Oui | La requête de recherche |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `results` | json | Résultats de recherche |
|
||||
| `query` | string | La requête de recherche |
|
||||
| `totalResults` | number | Nombre total de résultats |
|
||||
| `source` | string | Source de recherche \(exa\) |
|
||||
| `cost` | json | Informations sur les coûts \(0,01 $\) |
|
||||
|
||||
## Notes
|
||||
|
||||
- Catégorie : `tools`
|
||||
- Type : `search`
|
||||
392
apps/docs/content/docs/fr/tools/sendgrid.mdx
Normal file
392
apps/docs/content/docs/fr/tools/sendgrid.mdx
Normal file
@@ -0,0 +1,392 @@
|
||||
---
|
||||
title: SendGrid
|
||||
description: Envoyez des emails et gérez des contacts, des listes et des modèles
|
||||
avec SendGrid
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="sendgrid"
|
||||
color="#1A82E2"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[SendGrid](https://sendgrid.com) est une plateforme d'envoi d'emails cloud de premier plan, reconnue par les développeurs et les entreprises pour l'envoi fiable d'emails transactionnels et marketing à grande échelle. Grâce à ses API robustes et ses outils puissants, SendGrid vous permet de gérer tous les aspects de votre communication par email, de l'envoi de notifications et de reçus à la gestion de campagnes marketing complexes.
|
||||
|
||||
SendGrid offre aux utilisateurs une suite complète d'opérations email, permettant d'automatiser les flux de travail email critiques et de gérer étroitement les listes de contacts, les modèles et l'engagement des destinataires. Son intégration transparente avec Sim permet aux agents et aux workflows de délivrer des messages ciblés, de maintenir des listes dynamiques de contacts et de destinataires, de déclencher des emails personnalisés via des modèles et de suivre les résultats en temps réel.
|
||||
|
||||
Les fonctionnalités clés de SendGrid comprennent :
|
||||
|
||||
- **Email transactionnel :** envoi automatisé d'emails transactionnels à haut volume (comme des notifications, reçus et réinitialisations de mot de passe).
|
||||
- **Modèles dynamiques :** utilisation de modèles HTML riches ou textuels avec des données dynamiques pour une communication hautement personnalisée à grande échelle.
|
||||
- **Gestion des contacts :** ajout et mise à jour de contacts marketing, gestion des listes de destinataires et ciblage de segments pour les campagnes.
|
||||
- **Prise en charge des pièces jointes :** inclusion d'une ou plusieurs pièces jointes dans vos emails.
|
||||
- **Couverture API complète :** gestion programmatique des emails, contacts, listes, modèles, groupes de suppression, et plus encore.
|
||||
|
||||
En connectant SendGrid avec Sim, vos agents peuvent :
|
||||
|
||||
- Envoyer des emails simples et avancés (avec modèles ou multi-destinataires) dans le cadre de n'importe quel workflow.
|
||||
- Gérer et segmenter automatiquement les contacts et les listes.
|
||||
- Exploiter des modèles pour assurer cohérence et personnalisation dynamique.
|
||||
- Suivre et répondre à l'engagement des emails au sein de vos processus automatisés.
|
||||
|
||||
Cette intégration vous permet d'automatiser tous les flux de communication critiques, de garantir que les messages atteignent le bon public et de maintenir le contrôle sur la stratégie de messagerie de votre organisation, directement à partir des flux de travail Sim.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instructions d'utilisation
|
||||
|
||||
Intégrez SendGrid dans votre flux de travail. Envoyez des e-mails transactionnels, gérez les contacts et les listes marketing, et travaillez avec des modèles d'e-mail. Prend en charge les modèles dynamiques, les pièces jointes et la gestion complète des contacts.
|
||||
|
||||
## Outils
|
||||
|
||||
### `sendgrid_send_mail`
|
||||
|
||||
Envoyer un e-mail en utilisant l'API SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Oui | Clé API SendGrid |
|
||||
| `from` | string | Oui | Adresse e-mail de l'expéditeur \(doit être vérifiée dans SendGrid\) |
|
||||
| `fromName` | string | Non | Nom de l'expéditeur |
|
||||
| `to` | string | Oui | Adresse e-mail du destinataire |
|
||||
| `toName` | string | Non | Nom du destinataire |
|
||||
| `subject` | string | Non | Objet de l'e-mail \(obligatoire sauf si vous utilisez un modèle avec un objet prédéfini\) |
|
||||
| `content` | string | Non | Contenu du corps de l'e-mail \(obligatoire sauf si vous utilisez un modèle avec un contenu prédéfini\) |
|
||||
| `contentType` | string | Non | Type de contenu \(text/plain ou text/html\) |
|
||||
| `cc` | string | Non | Adresse e-mail en CC |
|
||||
| `bcc` | string | Non | Adresse e-mail en BCC |
|
||||
| `replyTo` | string | Non | Adresse e-mail de réponse |
|
||||
| `replyToName` | string | Non | Nom de réponse |
|
||||
| `attachments` | file[] | Non | Fichiers à joindre à l'e-mail |
|
||||
| `templateId` | string | Non | ID du modèle SendGrid à utiliser |
|
||||
| `dynamicTemplateData` | json | Non | Objet JSON de données de modèle dynamique |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Indique si l'e-mail a été envoyé avec succès |
|
||||
| `messageId` | string | ID du message SendGrid |
|
||||
| `to` | string | Adresse e-mail du destinataire |
|
||||
| `subject` | string | Objet de l'e-mail |
|
||||
|
||||
### `sendgrid_add_contact`
|
||||
|
||||
Ajouter un nouveau contact à SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Oui | Clé API SendGrid |
|
||||
| `email` | string | Oui | Adresse e-mail du contact |
|
||||
| `firstName` | string | Non | Prénom du contact |
|
||||
| `lastName` | string | Non | Nom de famille du contact |
|
||||
| `customFields` | json | Non | Objet JSON de paires clé-valeur de champs personnalisés (utilisez les ID de champ comme e1_T, e2_N, e3_D, pas les noms de champ) |
|
||||
| `listIds` | string | Non | Liste d'ID séparés par des virgules pour ajouter le contact |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | ID de tâche pour suivre la création asynchrone du contact |
|
||||
| `email` | string | Adresse e-mail du contact |
|
||||
| `firstName` | string | Prénom du contact |
|
||||
| `lastName` | string | Nom de famille du contact |
|
||||
| `message` | string | Message d'état |
|
||||
|
||||
### `sendgrid_get_contact`
|
||||
|
||||
Obtenir un contact spécifique par ID depuis SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Oui | Clé API SendGrid |
|
||||
| `contactId` | string | Oui | ID du contact |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | ID du contact |
|
||||
| `email` | string | Adresse e-mail du contact |
|
||||
| `firstName` | string | Prénom du contact |
|
||||
| `lastName` | string | Nom de famille du contact |
|
||||
| `createdAt` | string | Horodatage de création |
|
||||
| `updatedAt` | string | Horodatage de dernière mise à jour |
|
||||
| `listIds` | json | Tableau des ID de listes auxquelles le contact appartient |
|
||||
| `customFields` | json | Valeurs des champs personnalisés |
|
||||
|
||||
### `sendgrid_search_contacts`
|
||||
|
||||
Rechercher des contacts dans SendGrid à l'aide d'une requête
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ---------- | ----------- |
|
||||
| `apiKey` | string | Oui | Clé API SendGrid |
|
||||
| `query` | string | Oui | Requête de recherche (par ex., "email LIKE '%example.com%' AND CONTAINS(list_ids, 'list-id')") |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `contacts` | json | Tableau des contacts correspondants |
|
||||
| `contactCount` | number | Nombre total de contacts trouvés |
|
||||
|
||||
### `sendgrid_delete_contacts`
|
||||
|
||||
Supprimer un ou plusieurs contacts de SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ---------- | ----------- |
|
||||
| `apiKey` | string | Oui | Clé API SendGrid |
|
||||
| `contactIds` | string | Oui | ID de contacts séparés par des virgules à supprimer |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | ID de tâche pour la demande de suppression |
|
||||
|
||||
### `sendgrid_create_list`
|
||||
|
||||
Créer une nouvelle liste de contacts dans SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API SendGrid |
|
||||
| `name` | chaîne | Oui | Nom de la liste |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | chaîne | ID de la liste |
|
||||
| `name` | chaîne | Nom de la liste |
|
||||
| `contactCount` | nombre | Nombre de contacts dans la liste |
|
||||
|
||||
### `sendgrid_get_list`
|
||||
|
||||
Obtenir une liste spécifique par ID depuis SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API SendGrid |
|
||||
| `listId` | chaîne | Oui | ID de la liste |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | chaîne | ID de la liste |
|
||||
| `name` | chaîne | Nom de la liste |
|
||||
| `contactCount` | nombre | Nombre de contacts dans la liste |
|
||||
|
||||
### `sendgrid_list_all_lists`
|
||||
|
||||
Obtenir toutes les listes de contacts depuis SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API SendGrid |
|
||||
| `pageSize` | nombre | Non | Nombre de listes à renvoyer par page \(par défaut : 100\) |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `lists` | json | Tableau de listes |
|
||||
|
||||
### `sendgrid_delete_list`
|
||||
|
||||
Supprimer une liste de contacts de SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API SendGrid |
|
||||
| `listId` | chaîne | Oui | ID de la liste à supprimer |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | chaîne | Message de succès |
|
||||
|
||||
### `sendgrid_add_contacts_to_list`
|
||||
|
||||
Ajouter ou mettre à jour des contacts et les assigner à une liste dans SendGrid (utilise PUT /v3/marketing/contacts)
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API SendGrid |
|
||||
| `listId` | chaîne | Oui | ID de la liste à laquelle ajouter les contacts |
|
||||
| `contacts` | json | Oui | Tableau JSON d'objets contact. Chaque contact doit avoir au minimum : email \(ou phone_number_id/external_id/anonymous_id\). Exemple : \[\{"email": "user@example.com", "first_name": "John"\}\] |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | chaîne | ID de tâche pour suivre l'opération asynchrone |
|
||||
| `message` | chaîne | Message de statut |
|
||||
|
||||
### `sendgrid_remove_contacts_from_list`
|
||||
|
||||
Supprimer des contacts d'une liste spécifique dans SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API SendGrid |
|
||||
| `listId` | chaîne | Oui | ID de la liste |
|
||||
| `contactIds` | chaîne | Oui | IDs de contacts séparés par des virgules à supprimer de la liste |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | ID de tâche pour la requête |
|
||||
|
||||
### `sendgrid_create_template`
|
||||
|
||||
Créer un nouveau modèle d'e-mail dans SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Oui | Clé API SendGrid |
|
||||
| `name` | string | Oui | Nom du modèle |
|
||||
| `generation` | string | Non | Type de génération de modèle \(legacy ou dynamic, par défaut : dynamic\) |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | ID du modèle |
|
||||
| `name` | string | Nom du modèle |
|
||||
| `generation` | string | Génération du modèle |
|
||||
| `updatedAt` | string | Horodatage de la dernière mise à jour |
|
||||
| `versions` | json | Tableau des versions du modèle |
|
||||
|
||||
### `sendgrid_get_template`
|
||||
|
||||
Obtenir un modèle spécifique par ID depuis SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Oui | Clé API SendGrid |
|
||||
| `templateId` | string | Oui | ID du modèle |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | ID du modèle |
|
||||
| `name` | string | Nom du modèle |
|
||||
| `generation` | string | Génération du modèle |
|
||||
| `updatedAt` | string | Horodatage de la dernière mise à jour |
|
||||
| `versions` | json | Tableau des versions du modèle |
|
||||
|
||||
### `sendgrid_list_templates`
|
||||
|
||||
Obtenir tous les modèles d'e-mail de SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API SendGrid |
|
||||
| `generations` | chaîne | Non | Filtrer par génération \(legacy, dynamic, ou les deux\) |
|
||||
| `pageSize` | nombre | Non | Nombre de modèles à renvoyer par page \(par défaut : 20\) |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `templates` | json | Tableau de modèles |
|
||||
|
||||
### `sendgrid_delete_template`
|
||||
|
||||
Supprimer un modèle d'e-mail de SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API SendGrid |
|
||||
| `templateId` | chaîne | Oui | ID du modèle à supprimer |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | booléen | Statut de réussite de l'opération |
|
||||
| `messageId` | chaîne | ID du message e-mail \(send_mail\) |
|
||||
| `id` | chaîne | ID de la ressource |
|
||||
| `jobId` | chaîne | ID de tâche pour les opérations asynchrones |
|
||||
| `email` | chaîne | Adresse e-mail |
|
||||
| `firstName` | chaîne | Prénom |
|
||||
| `lastName` | chaîne | Nom de famille |
|
||||
| `contacts` | json | Tableau de contacts |
|
||||
| `contactCount` | nombre | Nombre de contacts |
|
||||
| `lists` | json | Tableau de listes |
|
||||
| `templates` | json | Tableau de modèles |
|
||||
| `message` | chaîne | Statut ou message de réussite |
|
||||
| `name` | chaîne | Nom de la ressource |
|
||||
| `generation` | chaîne | Génération du modèle |
|
||||
|
||||
### `sendgrid_create_template_version`
|
||||
|
||||
Créer une nouvelle version d'un modèle d'e-mail dans SendGrid
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ---------- | ----------- |
|
||||
| `apiKey` | chaîne | Oui | Clé API SendGrid |
|
||||
| `templateId` | chaîne | Oui | ID du modèle |
|
||||
| `name` | chaîne | Oui | Nom de la version |
|
||||
| `subject` | chaîne | Oui | Objet de l'e-mail |
|
||||
| `htmlContent` | chaîne | Non | Contenu HTML du modèle |
|
||||
| `plainContent` | chaîne | Non | Contenu texte brut du modèle |
|
||||
| `active` | booléen | Non | Si cette version est active \(par défaut : true\) |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | chaîne | ID de la version |
|
||||
| `templateId` | chaîne | ID du modèle |
|
||||
| `name` | chaîne | Nom de la version |
|
||||
| `subject` | chaîne | Objet de l'e-mail |
|
||||
| `active` | booléen | Si cette version est active |
|
||||
| `htmlContent` | chaîne | Contenu HTML |
|
||||
| `plainContent` | chaîne | Contenu texte brut |
|
||||
| `updatedAt` | chaîne | Horodatage de la dernière mise à jour |
|
||||
|
||||
## Notes
|
||||
|
||||
- Catégorie : `tools`
|
||||
- Type : `sendgrid`
|
||||
73
apps/docs/content/docs/fr/tools/smtp.mdx
Normal file
73
apps/docs/content/docs/fr/tools/smtp.mdx
Normal file
@@ -0,0 +1,73 @@
|
||||
---
|
||||
title: SMTP
|
||||
description: Envoyez des emails via n'importe quel serveur de messagerie SMTP
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="smtp"
|
||||
color="#4A5568"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[SMTP (Simple Mail Transfer Protocol)](https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol) est la norme fondamentale pour la transmission d'emails sur Internet. En vous connectant à n'importe quel serveur compatible SMTP—comme Gmail, Outlook, ou l'infrastructure de messagerie de votre organisation—vous pouvez envoyer des emails de manière programmatique et automatiser vos communications sortantes.
|
||||
|
||||
L'intégration SMTP vous permet de personnaliser entièrement l'envoi d'emails grâce à une connectivité directe au serveur, prenant en charge les cas d'utilisation d'email basiques et avancés. Avec SMTP, vous pouvez contrôler tous les aspects de la livraison des messages, de la gestion des destinataires et du formatage du contenu, ce qui le rend adapté aux notifications transactionnelles, aux envois en masse et à tout flux de travail automatisé nécessitant une livraison robuste d'emails sortants.
|
||||
|
||||
**Les fonctionnalités clés disponibles via l'intégration SMTP incluent :**
|
||||
|
||||
- **Livraison universelle d'emails :** Envoyez des emails en utilisant n'importe quel serveur SMTP en configurant les paramètres de connexion standard.
|
||||
- **Expéditeur et destinataires personnalisables :** Spécifiez l'adresse de l'expéditeur, le nom d'affichage, les destinataires principaux, ainsi que les champs CC et BCC.
|
||||
- **Prise en charge de contenu enrichi :** Envoyez des emails en texte brut ou au format HTML richement formaté selon vos besoins.
|
||||
- **Pièces jointes :** Incluez plusieurs fichiers en pièces jointes dans les emails sortants.
|
||||
- **Sécurité flexible :** Connectez-vous en utilisant les protocoles TLS, SSL ou standard (non chiffré) selon ce que prend en charge votre fournisseur SMTP.
|
||||
- **En-têtes avancés :** Définissez les en-têtes de réponse et d'autres options d'email avancées pour répondre aux flux de messagerie complexes et aux interactions utilisateur.
|
||||
|
||||
En intégrant SMTP avec Sim, les agents et les flux de travail peuvent envoyer des emails de manière programmatique dans le cadre de tout processus automatisé—allant de l'envoi de notifications et de confirmations à l'automatisation des communications externes, des rapports et de la livraison de documents. Cela offre une approche hautement flexible et indépendante du fournisseur pour gérer les emails directement au sein de vos processus pilotés par l'IA.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instructions d'utilisation
|
||||
|
||||
Envoyez des emails en utilisant n'importe quel serveur SMTP (Gmail, Outlook, serveurs personnalisés, etc.). Configurez les paramètres de connexion SMTP et envoyez des emails avec un contrôle total sur le contenu, les destinataires et les pièces jointes.
|
||||
|
||||
## Outils
|
||||
|
||||
### `smtp_send_mail`
|
||||
|
||||
Envoyer des emails via un serveur SMTP
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `smtpHost` | string | Oui | Nom d'hôte du serveur SMTP \(ex., smtp.gmail.com\) |
|
||||
| `smtpPort` | number | Oui | Port du serveur SMTP \(587 pour TLS, 465 pour SSL\) |
|
||||
| `smtpUsername` | string | Oui | Nom d'utilisateur pour l'authentification SMTP |
|
||||
| `smtpPassword` | string | Oui | Mot de passe pour l'authentification SMTP |
|
||||
| `smtpSecure` | string | Oui | Protocole de sécurité \(TLS, SSL ou Aucun\) |
|
||||
| `from` | string | Oui | Adresse email de l'expéditeur |
|
||||
| `to` | string | Oui | Adresse email du destinataire |
|
||||
| `subject` | string | Oui | Objet de l'email |
|
||||
| `body` | string | Oui | Contenu du corps de l'email |
|
||||
| `contentType` | string | Non | Type de contenu \(texte ou html\) |
|
||||
| `fromName` | string | Non | Nom d'affichage de l'expéditeur |
|
||||
| `cc` | string | Non | Destinataires en copie \(séparés par des virgules\) |
|
||||
| `bcc` | string | Non | Destinataires en copie cachée \(séparés par des virgules\) |
|
||||
| `replyTo` | string | Non | Adresse email de réponse |
|
||||
| `attachments` | file[] | Non | Fichiers à joindre à l'email |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Indique si l'email a été envoyé avec succès |
|
||||
| `messageId` | string | ID du message du serveur SMTP |
|
||||
| `to` | string | Adresse email du destinataire |
|
||||
| `subject` | string | Objet de l'email |
|
||||
| `error` | string | Message d'erreur si l'envoi a échoué |
|
||||
|
||||
## Notes
|
||||
|
||||
- Catégorie : `tools`
|
||||
- Type : `smtp`
|
||||
89
apps/docs/content/docs/ja/tools/apify.mdx
Normal file
89
apps/docs/content/docs/ja/tools/apify.mdx
Normal file
@@ -0,0 +1,89 @@
|
||||
---
|
||||
title: Apify
|
||||
description: Apifyアクターを実行して結果を取得する
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="apify"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Apify](https://apify.com/)は、WebオートメーションとWebスクレイピングアクターを構築、デプロイ、大規模に実行するための強力なプラットフォームです。Apifyを使用すると、任意のWebサイトから有用なデータを抽出し、ワークフローを自動化し、データパイプラインをシームレスに接続できます。
|
||||
|
||||
Apifyでは以下のことが可能です:
|
||||
|
||||
- **既製または独自のアクターを実行する**:公開アクターを統合するか、独自のアクターを開発して、幅広いWebデータ抽出とブラウザタスクを自動化します。
|
||||
- **データセットを取得する**:アクターによって収集された構造化データセットにリアルタイムでアクセスし管理します。
|
||||
- **Webオートメーションをスケールする**:クラウドインフラストラクチャを活用して、堅牢なエラー処理を備えた同期または非同期のタスクを確実に実行します。
|
||||
|
||||
Simでは、Apify統合によりエージェントがプログラムでApifyの主要な操作を実行できます:
|
||||
|
||||
- **アクターの実行(同期)**:`apify_run_actor_sync`を使用してApifyアクターを起動し、完了を待って、実行が終了するとすぐに結果を取得します。
|
||||
- **アクターの実行(非同期)**:`apify_run_actor_async`を使用してバックグラウンドでアクターを開始し、定期的に結果をポーリングします。これは長時間または複雑なジョブに適しています。
|
||||
|
||||
これらの操作により、エージェントはワークフロー内で直接、自動化、スクレイピング、データ収集またはブラウザ自動化タスクのオーケストレーションを行うことができます — すべて柔軟な構成と結果処理を備え、手動実行や外部ツールを必要としません。Apifyを動的な自動化およびデータ抽出エンジンとして統合し、プログラムでエージェントのWebスケールワークフローを強化します。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用方法
|
||||
|
||||
Apifyをワークフローに統合します。カスタム入力で任意のApifyアクターを実行し、結果を取得します。自動データセット取得機能を備えた同期および非同期実行の両方をサポートしています。
|
||||
|
||||
## ツール
|
||||
|
||||
### `apify_run_actor_sync`
|
||||
|
||||
APIPYアクターを同期的に実行して結果を取得(最大5分)
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | console.apify.com/account#/integrationsから取得したAPIFY APIトークン |
|
||||
| `actorId` | string | はい | アクターIDまたはユーザー名/アクター名(例:"janedoe/my-actor"またはアクターID) |
|
||||
| `input` | string | いいえ | JSON文字列としてのアクター入力。必須フィールドについてはアクターのドキュメントを参照してください。 |
|
||||
| `timeout` | number | いいえ | タイムアウト(秒)(デフォルト:アクターのデフォルト) |
|
||||
| `build` | string | いいえ | 実行するアクタービルド(例:"latest"、"beta"、またはビルドタグ/番号) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | アクター実行が成功したかどうか |
|
||||
| `runId` | string | APIFY実行ID |
|
||||
| `status` | string | 実行ステータス(SUCCEEDED、FAILEDなど) |
|
||||
| `datasetId` | string | 結果を含むデータセットID |
|
||||
| `items` | array | データセット項目(完了した場合) |
|
||||
|
||||
### `apify_run_actor_async`
|
||||
|
||||
長時間実行タスク用のポーリングを使用して、APIPYアクターを非同期で実行
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | console.apify.com/account#/integrationsから取得したAPIFY APIトークン |
|
||||
| `actorId` | string | はい | アクターIDまたはユーザー名/アクター名(例:"janedoe/my-actor"またはアクターID) |
|
||||
| `input` | string | いいえ | JSON文字列としてのアクター入力 |
|
||||
| `waitForFinish` | number | いいえ | ポーリング開始前の初期待機時間(秒)(0-60) |
|
||||
| `itemLimit` | number | いいえ | 取得する最大データセット項目数(1-250000、デフォルト100) |
|
||||
| `timeout` | number | いいえ | タイムアウト(秒)(デフォルト:アクターのデフォルト) |
|
||||
| `build` | string | いいえ | 実行するアクタービルド(例:"latest"、"beta"、またはビルドタグ/番号) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | アクターの実行が成功したかどうか |
|
||||
| `runId` | string | APIFY実行ID |
|
||||
| `status` | string | 実行ステータス(SUCCEEDED、FAILED、など) |
|
||||
| `datasetId` | string | 結果を含むデータセットID |
|
||||
| `items` | array | データセット項目(完了した場合) |
|
||||
|
||||
## 注意事項
|
||||
|
||||
- カテゴリー: `tools`
|
||||
- タイプ: `apify`
|
||||
188
apps/docs/content/docs/ja/tools/dynamodb.mdx
Normal file
188
apps/docs/content/docs/ja/tools/dynamodb.mdx
Normal file
@@ -0,0 +1,188 @@
|
||||
---
|
||||
title: Amazon DynamoDB
|
||||
description: Amazon DynamoDBに接続する
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="dynamodb"
|
||||
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Amazon DynamoDB](https://aws.amazon.com/dynamodb/)はAWSが提供する完全マネージド型のNoSQLデータベースサービスで、シームレスなスケーラビリティを備えた高速で予測可能なパフォーマンスを提供します。DynamoDBを使用すると、ハードウェアやインフラストラクチャを管理する必要なく、任意の量のデータを保存および取得し、あらゆるレベルのリクエストトラフィックに対応できます。
|
||||
|
||||
DynamoDBでは、以下のことが可能です:
|
||||
|
||||
- **アイテムの取得**:プライマリキーを使用してテーブル内のアイテムを検索
|
||||
- **アイテムの配置**:テーブルにアイテムを追加または置換
|
||||
- **アイテムのクエリ**:インデックス全体でクエリを使用して複数のアイテムを取得
|
||||
- **テーブルのスキャン**:テーブル内のデータの全部または一部を読み取り
|
||||
- **アイテムの更新**:既存のアイテムの特定の属性を変更
|
||||
- **アイテムの削除**:テーブルからレコードを削除
|
||||
|
||||
Simでは、DynamoDB統合により、エージェントがAWS認証情報を使用してDynamoDBテーブルに安全にアクセスし操作することができます。サポートされている操作には以下が含まれます:
|
||||
|
||||
- **Get**:キーによるアイテムの取得
|
||||
- **Put**:アイテムの挿入または上書き
|
||||
- **Query**:キー条件とフィルターを使用したクエリの実行
|
||||
- **Scan**:テーブルまたはインデックスをスキャンして複数のアイテムを読み取り
|
||||
- **Update**:1つ以上のアイテムの特定の属性を変更
|
||||
- **Delete**:テーブルからアイテムを削除
|
||||
|
||||
この統合により、SimエージェントはプログラムによってDynamoDBテーブル内のデータ管理タスクを自動化できるようになり、手動の作業やサーバー管理なしでスケーラブルなNoSQLデータを管理、変更、取得するワークフローを構築できます。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用方法
|
||||
|
||||
Amazon DynamoDBをワークフローに統合します。DynamoDBテーブルに対するGet、Put、Query、Scan、Update、Delete操作をサポートしています。
|
||||
|
||||
## ツール
|
||||
|
||||
### `dynamodb_get`
|
||||
|
||||
プライマリキーを使用してDynamoDBテーブルからアイテムを取得する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | はい | AWSリージョン(例:us-east-1) |
|
||||
| `accessKeyId` | string | はい | AWSアクセスキーID |
|
||||
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
|
||||
| `tableName` | string | はい | DynamoDBテーブル名 |
|
||||
| `key` | object | はい | 取得するアイテムのプライマリキー |
|
||||
| `consistentRead` | boolean | いいえ | 強力な整合性のある読み取りを使用する |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作ステータスメッセージ |
|
||||
| `item` | object | 取得したアイテム |
|
||||
|
||||
### `dynamodb_put`
|
||||
|
||||
DynamoDBテーブルにアイテムを追加する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | はい | AWSリージョン(例:us-east-1) |
|
||||
| `accessKeyId` | string | はい | AWSアクセスキーID |
|
||||
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
|
||||
| `tableName` | string | はい | DynamoDBテーブル名 |
|
||||
| `item` | object | はい | テーブルに追加するアイテム |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作ステータスメッセージ |
|
||||
| `item` | object | 作成されたアイテム |
|
||||
|
||||
### `dynamodb_query`
|
||||
|
||||
キー条件を使用してDynamoDBテーブルからアイテムをクエリする
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | はい | AWSリージョン(例:us-east-1) |
|
||||
| `accessKeyId` | string | はい | AWSアクセスキーID |
|
||||
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
|
||||
| `tableName` | string | はい | DynamoDBテーブル名 |
|
||||
| `keyConditionExpression` | string | はい | キー条件式(例:"pk = :pk") |
|
||||
| `filterExpression` | string | いいえ | 結果のフィルター式 |
|
||||
| `expressionAttributeNames` | object | いいえ | 予約語の属性名マッピング |
|
||||
| `expressionAttributeValues` | object | いいえ | 式の属性値 |
|
||||
| `indexName` | string | いいえ | クエリするセカンダリインデックス名 |
|
||||
| `limit` | number | いいえ | 返すアイテムの最大数 |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作ステータスメッセージ |
|
||||
| `items` | array | 返されたアイテムの配列 |
|
||||
| `count` | number | 返されたアイテムの数 |
|
||||
|
||||
### `dynamodb_scan`
|
||||
|
||||
DynamoDBテーブル内のすべてのアイテムをスキャンする
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | はい | AWSリージョン(例:us-east-1) |
|
||||
| `accessKeyId` | string | はい | AWSアクセスキーID |
|
||||
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
|
||||
| `tableName` | string | はい | DynamoDBテーブル名 |
|
||||
| `filterExpression` | string | いいえ | 結果のフィルター式 |
|
||||
| `projectionExpression` | string | いいえ | 取得する属性 |
|
||||
| `expressionAttributeNames` | object | いいえ | 予約語の属性名マッピング |
|
||||
| `expressionAttributeValues` | object | いいえ | 式の属性値 |
|
||||
| `limit` | number | いいえ | 返すアイテムの最大数 |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作ステータスメッセージ |
|
||||
| `items` | array | 返されたアイテムの配列 |
|
||||
| `count` | number | 返されたアイテム数 |
|
||||
|
||||
### `dynamodb_update`
|
||||
|
||||
DynamoDBテーブル内のアイテムを更新する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | はい | AWSリージョン(例:us-east-1) |
|
||||
| `accessKeyId` | string | はい | AWSアクセスキーID |
|
||||
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
|
||||
| `tableName` | string | はい | DynamoDBテーブル名 |
|
||||
| `key` | object | はい | 更新するアイテムのプライマリキー |
|
||||
| `updateExpression` | string | はい | 更新式(例:"SET #name = :name") |
|
||||
| `expressionAttributeNames` | object | いいえ | 予約語の属性名マッピング |
|
||||
| `expressionAttributeValues` | object | いいえ | 式の属性値 |
|
||||
| `conditionExpression` | string | いいえ | 更新が成功するために満たす必要がある条件 |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作ステータスメッセージ |
|
||||
| `item` | object | 更新されたアイテム |
|
||||
|
||||
### `dynamodb_delete`
|
||||
|
||||
DynamoDBテーブルからアイテムを削除する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | はい | AWSリージョン(例:us-east-1) |
|
||||
| `accessKeyId` | string | はい | AWSアクセスキーID |
|
||||
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
|
||||
| `tableName` | string | はい | DynamoDBテーブル名 |
|
||||
| `key` | object | はい | 削除するアイテムのプライマリキー |
|
||||
| `conditionExpression` | string | いいえ | 削除が成功するために満たす必要がある条件 |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作ステータスメッセージ |
|
||||
|
||||
## 注意事項
|
||||
|
||||
- カテゴリー: `tools`
|
||||
- タイプ: `dynamodb`
|
||||
83
apps/docs/content/docs/ja/tools/linkedin.mdx
Normal file
83
apps/docs/content/docs/ja/tools/linkedin.mdx
Normal file
@@ -0,0 +1,83 @@
|
||||
---
|
||||
title: LinkedIn
|
||||
description: 投稿を共有し、LinkedInのプレゼンスを管理する
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="linkedin"
|
||||
color="#0072B1"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[LinkedIn](https://www.linkedin.com)は世界最大のプロフェッショナルネットワーキングプラットフォームで、ユーザーがキャリアを構築し、ネットワークとつながり、専門的なコンテンツを共有することを可能にします。LinkedInは、個人ブランディング、採用活動、求職活動、ビジネス開発など、様々な業界のプロフェッショナルに広く利用されています。
|
||||
|
||||
LinkedInを使用すると、個人フィードに投稿を簡単に共有してネットワークとエンゲージメントを取ったり、プロフェッショナルな実績を強調するためにプロフィール情報にアクセスしたりできます。Simとの自動統合により、LinkedInの機能をプログラムで活用できるようになり、エージェントやワークフローが更新を投稿したり、プロフェッショナルなプレゼンスについてレポートしたり、手動の作業なしにフィードをアクティブに保つことが可能になります。
|
||||
|
||||
この統合を通じて利用可能な主なLinkedIn機能には以下が含まれます:
|
||||
|
||||
- **投稿の共有:** プロフェッショナルな更新、記事、またはお知らせをLinkedInの個人フィードに自動的に公開します。
|
||||
- **プロフィール情報:** LinkedInプロフィールに関する詳細情報を取得し、ワークフロー内での監視や下流タスクでの使用が可能です。
|
||||
|
||||
これらの機能により、AIやワークフロー自動化戦略の一部として、LinkedInネットワークとのエンゲージメントを維持し、プロフェッショナルなリーチを効率的に拡大することが容易になります。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用方法
|
||||
|
||||
LinkedInをワークフローに統合します。個人フィードに投稿を共有し、LinkedInプロフィール情報にアクセスします。
|
||||
|
||||
## ツール
|
||||
|
||||
### `linkedin_share_post`
|
||||
|
||||
LinkedInの個人フィードに投稿を共有する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `text` | string | はい | LinkedInの投稿のテキスト内容 |
|
||||
| `visibility` | string | いいえ | この投稿を見ることができる人:「PUBLIC」または「CONNECTIONS」\(デフォルト:「PUBLIC」\) |
|
||||
| `request` | string | いいえ | 説明なし |
|
||||
| `output` | string | いいえ | 説明なし |
|
||||
| `output` | string | いいえ | 説明なし |
|
||||
| `specificContent` | string | いいえ | 説明なし |
|
||||
| `shareCommentary` | string | いいえ | 説明なし |
|
||||
| `visibility` | string | いいえ | 説明なし |
|
||||
| `headers` | string | いいえ | 説明なし |
|
||||
| `output` | string | いいえ | 説明なし |
|
||||
| `output` | string | いいえ | 説明なし |
|
||||
| `output` | string | いいえ | 説明なし |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 操作成功ステータス |
|
||||
| `postId` | string | 作成された投稿ID |
|
||||
| `profile` | json | LinkedInプロフィール情報 |
|
||||
| `error` | string | 操作が失敗した場合のエラーメッセージ |
|
||||
|
||||
### `linkedin_get_profile`
|
||||
|
||||
LinkedInプロフィール情報を取得する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 操作成功ステータス |
|
||||
| `postId` | string | 作成された投稿ID |
|
||||
| `profile` | json | LinkedInプロフィール情報 |
|
||||
| `error` | string | 操作が失敗した場合のエラーメッセージ |
|
||||
|
||||
## 注意事項
|
||||
|
||||
- カテゴリー: `tools`
|
||||
- タイプ: `linkedin`
|
||||
216
apps/docs/content/docs/ja/tools/mailgun.mdx
Normal file
216
apps/docs/content/docs/ja/tools/mailgun.mdx
Normal file
@@ -0,0 +1,216 @@
|
||||
---
|
||||
title: Mailgun
|
||||
description: Mailgunでメールを送信し、メーリングリストを管理する
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="mailgun"
|
||||
color="#F06248"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Mailgun](https://www.mailgun.com)は、開発者やビジネス向けに設計された強力なメール配信サービスで、メールの送受信やトラッキングを簡単に行うことができます。Mailgunを使用すると、信頼性の高いトランザクションメールやマーケティングメール、柔軟なメーリングリスト管理、高度なイベントトラッキングのための堅牢なAPIを活用できます。
|
||||
|
||||
Mailgunの包括的な機能セットにより、主要なメール操作を自動化し、配信可能性や受信者のエンゲージメントを緊密に監視することができます。これにより、コミュニケーション、通知、キャンペーンメールがワークフローの中核となるプロセスの理想的なソリューションとなります。
|
||||
|
||||
Mailgunの主な機能には以下が含まれます:
|
||||
|
||||
- **トランザクションメール送信:** アカウント通知、領収書、アラート、パスワードリセットなどの大量メールを配信。
|
||||
- **リッチメールコンテンツ:** プレーンテキストとHTMLの両方のメールを送信し、タグを使用してメッセージを分類・追跡。
|
||||
- **メーリングリスト管理:** メーリングリストとメンバーを作成、更新、管理して、グループコミュニケーションを効率的に送信。
|
||||
- **ドメイン情報:** 送信ドメインに関する詳細を取得して、構成と健全性を監視。
|
||||
- **イベントトラッキング:** 送信メッセージに関する詳細なイベントデータで、メールの配信可能性とエンゲージメントを分析。
|
||||
- **メッセージ取得:** コンプライアンス、分析、またはトラブルシューティングのニーズのために保存されたメッセージにアクセス。
|
||||
|
||||
MailgunをSimに統合することで、エージェントはプログラムによるメール送信、メーリングリスト管理、ドメイン情報へのアクセス、自動化されたワークフローの一部としてリアルタイムイベントの監視を行うことができます。これにより、AIを活用したプロセスから直接ユーザーとインテリジェントでデータ駆動型のエンゲージメントが可能になります。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用手順
|
||||
|
||||
Mailgunをワークフローに統合します。トランザクションメールの送信、メーリングリストとメンバーの管理、ドメイン情報の表示、メールイベントの追跡が可能です。テキストメールとHTMLメール、追跡用のタグ、包括的なリスト管理をサポートしています。
|
||||
|
||||
## ツール
|
||||
|
||||
### `mailgun_send_message`
|
||||
|
||||
Mailgun APIを使用してメールを送信する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Mailgun APIキー |
|
||||
| `domain` | string | はい | Mailgunドメイン(例:mg.example.com) |
|
||||
| `from` | string | はい | 送信者のメールアドレス |
|
||||
| `to` | string | はい | 受信者のメールアドレス(複数の場合はカンマ区切り) |
|
||||
| `subject` | string | はい | メールの件名 |
|
||||
| `text` | string | いいえ | メールのプレーンテキスト本文 |
|
||||
| `html` | string | いいえ | メールのHTML本文 |
|
||||
| `cc` | string | いいえ | CCメールアドレス(複数の場合はカンマ区切り) |
|
||||
| `bcc` | string | いいえ | BCCメールアドレス(複数の場合はカンマ区切り) |
|
||||
| `tags` | string | いいえ | メールのタグ(カンマ区切り) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | メッセージが正常に送信されたかどうか |
|
||||
| `id` | string | メッセージID |
|
||||
| `message` | string | Mailgunからのレスポンスメッセージ |
|
||||
|
||||
### `mailgun_get_message`
|
||||
|
||||
キーによって保存されたメッセージを取得する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Mailgun APIキー |
|
||||
| `domain` | string | はい | Mailgunドメイン |
|
||||
| `messageKey` | string | はい | メッセージストレージキー |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | リクエストが成功したかどうか |
|
||||
| `recipients` | string | メッセージの受信者 |
|
||||
| `from` | string | 送信者のメールアドレス |
|
||||
| `subject` | string | メッセージの件名 |
|
||||
| `bodyPlain` | string | プレーンテキスト本文 |
|
||||
| `strippedText` | string | 整形されたテキスト |
|
||||
| `strippedSignature` | string | 整形された署名 |
|
||||
| `bodyHtml` | string | HTML本文 |
|
||||
| `strippedHtml` | string | 整形されたHTML |
|
||||
| `attachmentCount` | number | 添付ファイルの数 |
|
||||
| `timestamp` | number | メッセージのタイムスタンプ |
|
||||
| `messageHeaders` | json | メッセージヘッダー |
|
||||
| `contentIdMap` | json | コンテンツIDマップ |
|
||||
|
||||
### `mailgun_list_messages`
|
||||
|
||||
Mailgunを通じて送信されたメッセージのイベント(ログ)を一覧表示する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Mailgun APIキー |
|
||||
| `domain` | string | はい | Mailgunドメイン |
|
||||
| `event` | string | いいえ | イベントタイプでフィルタリング(accepted、delivered、failed、opened、clickedなど) |
|
||||
| `limit` | number | いいえ | 返すイベントの最大数(デフォルト:100) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | リクエストが成功したかどうか |
|
||||
| `items` | json | イベント項目の配列 |
|
||||
| `paging` | json | ページング情報 |
|
||||
|
||||
### `mailgun_create_mailing_list`
|
||||
|
||||
新しいメーリングリストを作成する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Mailgun APIキー |
|
||||
| `address` | string | はい | メーリングリストアドレス(例:list@example.com) |
|
||||
| `name` | string | いいえ | メーリングリスト名 |
|
||||
| `description` | string | いいえ | メーリングリストの説明 |
|
||||
| `accessLevel` | string | いいえ | アクセスレベル:readonly、members、またはeveryone |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | リストが正常に作成されたかどうか |
|
||||
| `message` | string | レスポンスメッセージ |
|
||||
| `list` | json | 作成されたメーリングリストの詳細 |
|
||||
|
||||
### `mailgun_get_mailing_list`
|
||||
|
||||
メーリングリストの詳細を取得する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Mailgun APIキー |
|
||||
| `address` | string | はい | メーリングリストアドレス |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | リクエストが成功したかどうか |
|
||||
| `list` | json | メーリングリストの詳細 |
|
||||
|
||||
### `mailgun_add_list_member`
|
||||
|
||||
メーリングリストにメンバーを追加する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Mailgun APIキー |
|
||||
| `listAddress` | string | はい | メーリングリストアドレス |
|
||||
| `address` | string | はい | メンバーのメールアドレス |
|
||||
| `name` | string | いいえ | メンバー名 |
|
||||
| `vars` | string | いいえ | カスタム変数のJSON文字列 |
|
||||
| `subscribed` | boolean | いいえ | メンバーが購読しているかどうか |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | メンバーが正常に追加されたかどうか |
|
||||
| `message` | string | レスポンスメッセージ |
|
||||
| `member` | json | 追加されたメンバーの詳細 |
|
||||
|
||||
### `mailgun_list_domains`
|
||||
|
||||
Mailgunアカウントのすべてのドメインを一覧表示する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Mailgun APIキー |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | リクエストが成功したかどうか |
|
||||
| `totalCount` | number | ドメインの総数 |
|
||||
| `items` | json | ドメインオブジェクトの配列 |
|
||||
|
||||
### `mailgun_get_domain`
|
||||
|
||||
特定のドメインの詳細を取得する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Mailgun APIキー |
|
||||
| `domain` | string | はい | ドメイン名 |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | リクエストが成功したかどうか |
|
||||
| `domain` | json | ドメインの詳細 |
|
||||
|
||||
## 注意事項
|
||||
|
||||
- カテゴリー: `tools`
|
||||
- タイプ: `mailgun`
|
||||
168
apps/docs/content/docs/ja/tools/rds.mdx
Normal file
168
apps/docs/content/docs/ja/tools/rds.mdx
Normal file
@@ -0,0 +1,168 @@
|
||||
---
|
||||
title: Amazon RDS
|
||||
description: Data APIを通じてAmazon RDSに接続
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="rds"
|
||||
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Amazon RDS Aurora Serverless](https://aws.amazon.com/rds/aurora/serverless/)は、アプリケーションのニーズに基づいて自動的に起動、シャットダウン、容量のスケーリングを行う完全マネージド型のリレーショナルデータベースです。データベースサーバーを管理することなく、クラウドでSQLデータベースを実行できます。
|
||||
|
||||
RDS Aurora Serverlessでは、以下のことが可能です:
|
||||
|
||||
- **データのクエリ**: テーブル間で柔軟なSQLクエリを実行
|
||||
- **新しいレコードの挿入**: データベースに自動的にデータを追加
|
||||
- **既存レコードの更新**: カスタムフィルターを使用してテーブル内のデータを変更
|
||||
- **レコードの削除**: 正確な条件を使用して不要なデータを削除
|
||||
- **生のSQLの実行**: Auroraでサポートされている有効なSQLコマンドを実行
|
||||
|
||||
Simでは、RDS統合により、エージェントがAmazon Aurora Serverlessデータベースを安全かつプログラム的に操作できるようになります。サポートされている操作には以下が含まれます:
|
||||
|
||||
- **クエリ**: SELECTやその他のSQLクエリを実行してデータベースから行を取得
|
||||
- **挿入**: 構造化データを使用してテーブルに新しいレコードを挿入
|
||||
- **更新**: 指定した条件に一致する行のデータを変更
|
||||
- **削除**: カスタムフィルターや条件によってテーブルからレコードを削除
|
||||
- **実行**: 高度なシナリオ向けに生のSQLを実行
|
||||
|
||||
この統合により、エージェントは手動介入なしに幅広いデータベース操作を自動化できます。SimとAmazon RDSを接続することで、ワークフロー内でリレーショナルデータを管理、更新、取得するエージェントを構築できます—すべてデータベースインフラストラクチャや接続を扱うことなく実現できます。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用手順
|
||||
|
||||
Data APIを使用してAmazon RDS Aurora Serverlessをワークフローに統合します。データベース接続を管理することなく、クエリ、挿入、更新、削除、生のSQLの実行が可能です。
|
||||
|
||||
## ツール
|
||||
|
||||
### `rds_query`
|
||||
|
||||
Data APIを使用してAmazon RDSでSELECTクエリを実行する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | はい | AWSリージョン(例:us-east-1) |
|
||||
| `accessKeyId` | string | はい | AWSアクセスキーID |
|
||||
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
|
||||
| `resourceArn` | string | はい | Aurora DBクラスターのARN |
|
||||
| `secretArn` | string | はい | DB認証情報を含むSecrets ManagerシークレットのARN |
|
||||
| `database` | string | いいえ | データベース名(オプション) |
|
||||
| `query` | string | はい | 実行するSQL SELECTクエリ |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作ステータスメッセージ |
|
||||
| `rows` | array | クエリから返された行の配列 |
|
||||
| `rowCount` | number | 返された行数 |
|
||||
|
||||
### `rds_insert`
|
||||
|
||||
Data APIを使用してAmazon RDSテーブルにデータを挿入する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | はい | AWSリージョン(例:us-east-1) |
|
||||
| `accessKeyId` | string | はい | AWSアクセスキーID |
|
||||
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
|
||||
| `resourceArn` | string | はい | Aurora DBクラスターのARN |
|
||||
| `secretArn` | string | はい | DB認証情報を含むSecrets ManagerシークレットのARN |
|
||||
| `database` | string | いいえ | データベース名(オプション) |
|
||||
| `table` | string | はい | 挿入先のテーブル名 |
|
||||
| `data` | object | はい | キーと値のペアとして挿入するデータ |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作ステータスメッセージ |
|
||||
| `rows` | array | 挿入された行の配列 |
|
||||
| `rowCount` | number | 挿入された行数 |
|
||||
|
||||
### `rds_update`
|
||||
|
||||
Data APIを使用してAmazon RDSテーブルのデータを更新する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | はい | AWSリージョン(例:us-east-1) |
|
||||
| `accessKeyId` | string | はい | AWSアクセスキーID |
|
||||
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
|
||||
| `resourceArn` | string | はい | Aurora DBクラスターのARN |
|
||||
| `secretArn` | string | はい | DB認証情報を含むSecrets ManagerシークレットのARN |
|
||||
| `database` | string | いいえ | データベース名(オプション) |
|
||||
| `table` | string | はい | 更新するテーブル名 |
|
||||
| `data` | object | はい | キーと値のペアとして更新するデータ |
|
||||
| `conditions` | object | はい | 更新の条件(例:`{"id": 1}`) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作ステータスメッセージ |
|
||||
| `rows` | array | 更新された行の配列 |
|
||||
| `rowCount` | number | 更新された行数 |
|
||||
|
||||
### `rds_delete`
|
||||
|
||||
Data APIを使用してAmazon RDSテーブルからデータを削除する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | はい | AWS リージョン(例:us-east-1) |
|
||||
| `accessKeyId` | string | はい | AWS アクセスキーID |
|
||||
| `secretAccessKey` | string | はい | AWS シークレットアクセスキー |
|
||||
| `resourceArn` | string | はい | Aurora DBクラスターのARN |
|
||||
| `secretArn` | string | はい | DB認証情報を含むSecrets ManagerシークレットのARN |
|
||||
| `database` | string | いいえ | データベース名(オプション) |
|
||||
| `table` | string | はい | 削除対象のテーブル名 |
|
||||
| `conditions` | object | はい | 削除条件(例:`{"id": 1}`) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作ステータスメッセージ |
|
||||
| `rows` | array | 削除された行の配列 |
|
||||
| `rowCount` | number | 削除された行数 |
|
||||
|
||||
### `rds_execute`
|
||||
|
||||
Data APIを使用してAmazon RDSで生のSQLを実行する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | はい | AWS リージョン(例:us-east-1) |
|
||||
| `accessKeyId` | string | はい | AWS アクセスキーID |
|
||||
| `secretAccessKey` | string | はい | AWS シークレットアクセスキー |
|
||||
| `resourceArn` | string | はい | Aurora DBクラスターのARN |
|
||||
| `secretArn` | string | はい | DB認証情報を含むSecrets ManagerシークレットのARN |
|
||||
| `database` | string | いいえ | データベース名(オプション) |
|
||||
| `query` | string | はい | 実行する生のSQLクエリ |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作ステータスメッセージ |
|
||||
| `rows` | array | 返却または影響を受けた行の配列 |
|
||||
| `rowCount` | number | 影響を受けた行数 |
|
||||
|
||||
## 注意事項
|
||||
|
||||
- カテゴリー: `tools`
|
||||
- タイプ: `rds`
|
||||
@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="s3"
|
||||
color="#E0E0E0"
|
||||
color="linear-gradient(45deg, #1B660F 0%, #6CAE3E 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
|
||||
54
apps/docs/content/docs/ja/tools/search.mdx
Normal file
54
apps/docs/content/docs/ja/tools/search.mdx
Normal file
@@ -0,0 +1,54 @@
|
||||
---
|
||||
title: 検索
|
||||
description: ウェブを検索(検索1回あたり$0.01)
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="search"
|
||||
color="#3B82F6"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
**検索**ツールを使用すると、最先端の検索エンジンを活用してSimワークフロー内からウェブ検索ができます。これにより、最新の情報、ニュース、事実、ウェブコンテンツをエージェント、自動化、または会話に直接取り込むことができます。
|
||||
|
||||
- **一般的なウェブ検索**:ワークフローを補完するためにインターネットから最新情報を見つけることができます。
|
||||
- **自動クエリ**:エージェントやプログラムロジックが検索クエリを送信し、結果を自動的に処理できます。
|
||||
- **構造化された結果**:最も関連性の高いウェブ結果を返し、各結果のタイトル、リンク、スニペット、日付を含みます。
|
||||
|
||||
> **注意:** 検索は1クエリあたり**$0.01**の費用がかかります。
|
||||
|
||||
このツールは、エージェントがライブウェブデータにアクセスする必要がある、または現在のイベントを参照したり、調査を実行したり、補足コンテンツを取得したりする必要があるワークフローに最適です。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用方法
|
||||
|
||||
検索ツールを使用してウェブを検索します。検索は1クエリあたり$0.01の費用がかかります。
|
||||
|
||||
## ツール
|
||||
|
||||
### `search_tool`
|
||||
|
||||
ウェブを検索します。最も関連性の高いウェブ結果を返し、各結果のタイトル、リンク、スニペット、日付を含みます。
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `query` | string | はい | 検索クエリ |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `results` | json | 検索結果 |
|
||||
| `query` | string | 検索クエリ |
|
||||
| `totalResults` | number | 結果の総数 |
|
||||
| `source` | string | 検索ソース(exa) |
|
||||
| `cost` | json | コスト情報($0.01) |
|
||||
|
||||
## メモ
|
||||
|
||||
- カテゴリー: `tools`
|
||||
- タイプ: `search`
|
||||
391
apps/docs/content/docs/ja/tools/sendgrid.mdx
Normal file
391
apps/docs/content/docs/ja/tools/sendgrid.mdx
Normal file
@@ -0,0 +1,391 @@
|
||||
---
|
||||
title: SendGrid
|
||||
description: SendGridでメールの送信、連絡先、リスト、テンプレートの管理を行う
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="sendgrid"
|
||||
color="#1A82E2"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[SendGrid](https://sendgrid.com)は、開発者や企業が信頼する、スケーラブルなトランザクションメールやマーケティングメールを確実に配信するクラウドベースのメール配信プラットフォームです。強力なAPIとツールを備え、SendGridは通知や領収書の送信から複雑なマーケティングキャンペーンの管理まで、あらゆるメールコミュニケーションを管理できます。
|
||||
|
||||
SendGridは、重要なメールワークフローの自動化や連絡先リスト、テンプレート、受信者のエンゲージメントの緻密な管理など、メール運用の完全なスイートを提供します。Simとのシームレスな統合により、エージェントやワークフローはターゲットを絞ったメッセージの配信、動的な連絡先やリストの維持、テンプレートを通じたパーソナライズされたメールの送信、そしてリアルタイムでの結果追跡が可能になります。
|
||||
|
||||
SendGridの主な機能には以下が含まれます:
|
||||
|
||||
- **トランザクションメール:** 自動化された大量のトランザクションメール(通知、領収書、パスワードリセットなど)を送信。
|
||||
- **動的テンプレート:** リッチHTMLまたはテキストテンプレートに動的データを使用して、高度にパーソナライズされた大規模なコミュニケーションを実現。
|
||||
- **連絡先管理:** マーケティング連絡先の追加と更新、受信者リストの管理、キャンペーン向けのセグメントのターゲティング。
|
||||
- **添付ファイルのサポート:** メールに1つまたは複数のファイル添付が可能。
|
||||
- **包括的なAPIカバレッジ:** メール、連絡先、リスト、テンプレート、抑制グループなどをプログラムで管理。
|
||||
|
||||
SendGridとSimを連携させることで、エージェントは以下のことが可能になります:
|
||||
|
||||
- ワークフローの一部として、シンプルなメールと高度な(テンプレート化または複数の受信者向けの)メールの両方を送信。
|
||||
- 連絡先とリストを自動的に管理・セグメント化。
|
||||
- 一貫性と動的なパーソナライゼーションのためにテンプレートを活用。
|
||||
- 自動化されたプロセス内でメールのエンゲージメントを追跡し対応。
|
||||
|
||||
この連携により、重要なコミュニケーションフローをすべて自動化し、メッセージが適切な対象者に届くようにし、Simワークフローから直接組織のメール戦略を管理することができます。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用方法
|
||||
|
||||
SendGridをワークフローに統合します。トランザクションメールの送信、マーケティング連絡先とリストの管理、メールテンプレートの操作が可能です。動的テンプレート、添付ファイル、包括的な連絡先管理をサポートしています。
|
||||
|
||||
## ツール
|
||||
|
||||
### `sendgrid_send_mail`
|
||||
|
||||
SendGrid APIを使用してメールを送信する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 種類 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `from` | string | はい | 送信者のメールアドレス(SendGridで検証済みである必要があります) |
|
||||
| `fromName` | string | いいえ | 送信者名 |
|
||||
| `to` | string | はい | 受信者のメールアドレス |
|
||||
| `toName` | string | いいえ | 受信者名 |
|
||||
| `subject` | string | いいえ | メールの件名(事前定義された件名を持つテンプレートを使用しない限り必須) |
|
||||
| `content` | string | いいえ | メール本文のコンテンツ(事前定義されたコンテンツを持つテンプレートを使用しない限り必須) |
|
||||
| `contentType` | string | いいえ | コンテンツタイプ(text/plainまたはtext/html) |
|
||||
| `cc` | string | いいえ | CCメールアドレス |
|
||||
| `bcc` | string | いいえ | BCCメールアドレス |
|
||||
| `replyTo` | string | いいえ | 返信先メールアドレス |
|
||||
| `replyToName` | string | いいえ | 返信先名 |
|
||||
| `attachments` | file[] | いいえ | メールに添付するファイル |
|
||||
| `templateId` | string | いいえ | 使用するSendGridテンプレートID |
|
||||
| `dynamicTemplateData` | json | いいえ | 動的テンプレートデータのJSONオブジェクト |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | メールが正常に送信されたかどうか |
|
||||
| `messageId` | string | SendGridメッセージID |
|
||||
| `to` | string | 受信者のメールアドレス |
|
||||
| `subject` | string | メールの件名 |
|
||||
|
||||
### `sendgrid_add_contact`
|
||||
|
||||
SendGridに新しい連絡先を追加する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `email` | string | はい | 連絡先のメールアドレス |
|
||||
| `firstName` | string | いいえ | 連絡先の名 |
|
||||
| `lastName` | string | いいえ | 連絡先の姓 |
|
||||
| `customFields` | json | いいえ | カスタムフィールドのキーと値のペアのJSONオブジェクト(フィールド名ではなく、e1_T、e2_N、e3_DなどのフィールドIDを使用) |
|
||||
| `listIds` | string | いいえ | 連絡先を追加するリストIDのカンマ区切りリスト |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | 非同期連絡先作成を追跡するためのジョブID |
|
||||
| `email` | string | 連絡先のメールアドレス |
|
||||
| `firstName` | string | 連絡先の名 |
|
||||
| `lastName` | string | 連絡先の姓 |
|
||||
| `message` | string | ステータスメッセージ |
|
||||
|
||||
### `sendgrid_get_contact`
|
||||
|
||||
SendGridから特定の連絡先をIDで取得する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `contactId` | string | はい | 連絡先ID |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | 連絡先ID |
|
||||
| `email` | string | 連絡先のメールアドレス |
|
||||
| `firstName` | string | 連絡先の名 |
|
||||
| `lastName` | string | 連絡先の姓 |
|
||||
| `createdAt` | string | 作成タイムスタンプ |
|
||||
| `updatedAt` | string | 最終更新タイムスタンプ |
|
||||
| `listIds` | json | 連絡先が所属するリストIDの配列 |
|
||||
| `customFields` | json | カスタムフィールドの値 |
|
||||
|
||||
### `sendgrid_search_contacts`
|
||||
|
||||
クエリを使用してSendGrid内の連絡先を検索する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `query` | string | はい | 検索クエリ(例:"email LIKE '%example.com%' AND CONTAINS(list_ids, 'list-id')") |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `contacts` | json | 一致する連絡先の配列 |
|
||||
| `contactCount` | number | 見つかった連絡先の総数 |
|
||||
|
||||
### `sendgrid_delete_contacts`
|
||||
|
||||
SendGridから1つ以上の連絡先を削除する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `contactIds` | string | はい | 削除する連絡先IDのカンマ区切りリスト |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | 削除リクエストのジョブID |
|
||||
|
||||
### `sendgrid_create_list`
|
||||
|
||||
SendGridで新しいコンタクトリストを作成する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `name` | string | はい | リスト名 |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | リストID |
|
||||
| `name` | string | リスト名 |
|
||||
| `contactCount` | number | リスト内のコンタクト数 |
|
||||
|
||||
### `sendgrid_get_list`
|
||||
|
||||
SendGridから特定のリストをIDで取得する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `listId` | string | はい | リストID |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | リストID |
|
||||
| `name` | string | リスト名 |
|
||||
| `contactCount` | number | リスト内のコンタクト数 |
|
||||
|
||||
### `sendgrid_list_all_lists`
|
||||
|
||||
SendGridからすべてのコンタクトリストを取得する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `pageSize` | number | いいえ | ページごとに返すリスト数(デフォルト:100) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `lists` | json | リストの配列 |
|
||||
|
||||
### `sendgrid_delete_list`
|
||||
|
||||
SendGridからコンタクトリストを削除する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `listId` | string | はい | 削除するリストID |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 成功メッセージ |
|
||||
|
||||
### `sendgrid_add_contacts_to_list`
|
||||
|
||||
SendGridでコンタクトを追加または更新し、リストに割り当てる(PUT /v3/marketing/contactsを使用)
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `listId` | string | はい | コンタクトを追加するリストID |
|
||||
| `contacts` | json | はい | コンタクトオブジェクトのJSON配列。各コンタクトには少なくとも:email(またはphone_number_id/external_id/anonymous_id)が必要。例:\[\{"email": "user@example.com", "first_name": "John"\}\] |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | 非同期操作を追跡するためのジョブID |
|
||||
| `message` | string | ステータスメッセージ |
|
||||
|
||||
### `sendgrid_remove_contacts_from_list`
|
||||
|
||||
SendGridの特定のリストからコンタクトを削除する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `listId` | string | はい | リストID |
|
||||
| `contactIds` | string | はい | リストから削除するコンタクトIDのカンマ区切りリスト |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | リクエストのジョブID |
|
||||
|
||||
### `sendgrid_create_template`
|
||||
|
||||
SendGridで新しいメールテンプレートを作成する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `name` | string | はい | テンプレート名 |
|
||||
| `generation` | string | いいえ | テンプレート生成タイプ(レガシーまたはダイナミック、デフォルト:ダイナミック) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | テンプレートID |
|
||||
| `name` | string | テンプレート名 |
|
||||
| `generation` | string | テンプレート生成 |
|
||||
| `updatedAt` | string | 最終更新タイムスタンプ |
|
||||
| `versions` | json | テンプレートバージョンの配列 |
|
||||
|
||||
### `sendgrid_get_template`
|
||||
|
||||
SendGridから特定のテンプレートをIDで取得する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `templateId` | string | はい | テンプレートID |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | テンプレートID |
|
||||
| `name` | string | テンプレート名 |
|
||||
| `generation` | string | テンプレート生成 |
|
||||
| `updatedAt` | string | 最終更新タイムスタンプ |
|
||||
| `versions` | json | テンプレートバージョンの配列 |
|
||||
|
||||
### `sendgrid_list_templates`
|
||||
|
||||
SendGridからすべてのメールテンプレートを取得する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `generations` | string | いいえ | 生成方法でフィルタリング(legacy、dynamic、または両方) |
|
||||
| `pageSize` | number | いいえ | ページごとに返すテンプレートの数(デフォルト:20) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `templates` | json | テンプレートの配列 |
|
||||
|
||||
### `sendgrid_delete_template`
|
||||
|
||||
SendGridからメールテンプレートを削除する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `templateId` | string | はい | 削除するテンプレートID |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 操作成功ステータス |
|
||||
| `messageId` | string | メールメッセージID(send_mail) |
|
||||
| `id` | string | リソースID |
|
||||
| `jobId` | string | 非同期操作のジョブID |
|
||||
| `email` | string | メールアドレス |
|
||||
| `firstName` | string | 名 |
|
||||
| `lastName` | string | 姓 |
|
||||
| `contacts` | json | 連絡先の配列 |
|
||||
| `contactCount` | number | 連絡先の数 |
|
||||
| `lists` | json | リストの配列 |
|
||||
| `templates` | json | テンプレートの配列 |
|
||||
| `message` | string | ステータスまたは成功メッセージ |
|
||||
| `name` | string | リソース名 |
|
||||
| `generation` | string | テンプレート生成方法 |
|
||||
|
||||
### `sendgrid_create_template_version`
|
||||
|
||||
SendGridでメールテンプレートの新しいバージョンを作成する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | SendGrid APIキー |
|
||||
| `templateId` | string | はい | テンプレートID |
|
||||
| `name` | string | はい | バージョン名 |
|
||||
| `subject` | string | はい | メールの件名 |
|
||||
| `htmlContent` | string | いいえ | テンプレートのHTML内容 |
|
||||
| `plainContent` | string | いいえ | テンプレートのプレーンテキスト内容 |
|
||||
| `active` | boolean | いいえ | このバージョンがアクティブかどうか(デフォルト:true) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | バージョンID |
|
||||
| `templateId` | string | テンプレートID |
|
||||
| `name` | string | バージョン名 |
|
||||
| `subject` | string | メールの件名 |
|
||||
| `active` | boolean | このバージョンがアクティブかどうか |
|
||||
| `htmlContent` | string | HTML内容 |
|
||||
| `plainContent` | string | プレーンテキスト内容 |
|
||||
| `updatedAt` | string | 最終更新タイムスタンプ |
|
||||
|
||||
## 注意事項
|
||||
|
||||
- カテゴリー: `tools`
|
||||
- タイプ: `sendgrid`
|
||||
73
apps/docs/content/docs/ja/tools/smtp.mdx
Normal file
73
apps/docs/content/docs/ja/tools/smtp.mdx
Normal file
@@ -0,0 +1,73 @@
|
||||
---
|
||||
title: SMTP
|
||||
description: 任意のSMTPメールサーバーを介してメールを送信
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="smtp"
|
||||
color="#4A5568"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[SMTP(Simple Mail Transfer Protocol)](https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol)は、インターネット上でのメール送信の基本的な標準規格です。Gmail、Outlook、または組織独自のメールインフラなど、SMTP互換サーバーに接続することで、プログラムによるメール送信や送信コミュニケーションの自動化が可能になります。
|
||||
|
||||
SMTP統合により、サーバーへの直接接続を通じてメール送信を完全にカスタマイズでき、基本的なものから高度なメールユースケースまでサポートします。SMTPを使用すると、メッセージ配信、受信者管理、コンテンツフォーマットなどあらゆる側面を制御できるため、トランザクションメール通知、一括メール送信、堅牢な送信メール配信を必要とするあらゆる自動化ワークフローに適しています。
|
||||
|
||||
**SMTP統合で利用可能な主な機能:**
|
||||
|
||||
- **ユニバーサルなメール配信:** 標準的なサーバー接続パラメータを設定することで、任意のSMTPサーバーを使用してメールを送信できます。
|
||||
- **カスタマイズ可能な送信者と受信者:** 送信者アドレス、表示名、主要受信者、CCおよびBCCフィールドを指定できます。
|
||||
- **リッチコンテンツのサポート:** 要件に応じて、プレーンテキストまたはリッチフォーマットのHTMLメールを送信できます。
|
||||
- **添付ファイル:** 送信メールに複数のファイルを添付ファイルとして含めることができます。
|
||||
- **柔軟なセキュリティ:** SMTPプロバイダーがサポートするTLS、SSL、または標準(非暗号化)プロトコルを使用して接続できます。
|
||||
- **高度なヘッダー:** 返信先ヘッダーやその他の高度なメールオプションを設定して、複雑なメールフローやユーザーインタラクションに対応できます。
|
||||
|
||||
SMTPをSimと統合することで、エージェントやワークフローは、通知や確認メールの送信から、外部コミュニケーション、レポート作成、文書配信の自動化まで、あらゆる自動化プロセスの一部としてプログラムによるメール送信が可能になります。これにより、AI駆動プロセス内で直接メールを管理するための、非常に柔軟でプロバイダーに依存しないアプローチが提供されます。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用方法
|
||||
|
||||
任意のSMTPサーバー(Gmail、Outlook、カスタムサーバーなど)を使用してメールを送信します。SMTP接続設定を構成し、コンテンツ、受信者、添付ファイルを完全に制御してメールを送信できます。
|
||||
|
||||
## ツール
|
||||
|
||||
### `smtp_send_mail`
|
||||
|
||||
SMTPサーバー経由でメールを送信
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `smtpHost` | string | はい | SMTPサーバーのホスト名(例:smtp.gmail.com) |
|
||||
| `smtpPort` | number | はい | SMTPサーバーのポート(TLSの場合は587、SSLの場合は465) |
|
||||
| `smtpUsername` | string | はい | SMTP認証のユーザー名 |
|
||||
| `smtpPassword` | string | はい | SMTP認証のパスワード |
|
||||
| `smtpSecure` | string | はい | セキュリティプロトコル(TLS、SSL、またはNone) |
|
||||
| `from` | string | はい | 送信者のメールアドレス |
|
||||
| `to` | string | はい | 受信者のメールアドレス |
|
||||
| `subject` | string | はい | メールの件名 |
|
||||
| `body` | string | はい | メール本文の内容 |
|
||||
| `contentType` | string | いいえ | コンテンツタイプ(textまたはhtml) |
|
||||
| `fromName` | string | いいえ | 送信者の表示名 |
|
||||
| `cc` | string | いいえ | CC受信者(カンマ区切り) |
|
||||
| `bcc` | string | いいえ | BCC受信者(カンマ区切り) |
|
||||
| `replyTo` | string | いいえ | 返信先メールアドレス |
|
||||
| `attachments` | file[] | いいえ | メールに添付するファイル |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | メールが正常に送信されたかどうか |
|
||||
| `messageId` | string | SMTPサーバーからのメッセージID |
|
||||
| `to` | string | 受信者のメールアドレス |
|
||||
| `subject` | string | メールの件名 |
|
||||
| `error` | string | 送信に失敗した場合のエラーメッセージ |
|
||||
|
||||
## メモ
|
||||
|
||||
- カテゴリー: `tools`
|
||||
- タイプ: `smtp`
|
||||
89
apps/docs/content/docs/zh/tools/apify.mdx
Normal file
89
apps/docs/content/docs/zh/tools/apify.mdx
Normal file
@@ -0,0 +1,89 @@
|
||||
---
|
||||
title: Apify
|
||||
description: 运行 Apify actor 并获取结果
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="apify"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Apify](https://apify.com/) 是一个强大的平台,用于大规模构建、部署和运行网页自动化和网页抓取 actor。Apify 使您能够从任何网站提取有用的数据,自动化工作流程,并无缝连接您的数据管道。
|
||||
|
||||
使用 Apify,您可以:
|
||||
|
||||
- **运行现成或自定义的 actor**:集成公共 actor 或开发您自己的,自动化各种网页数据提取和浏览器任务。
|
||||
- **获取数据集**:实时访问和管理由 actor 收集的结构化数据集。
|
||||
- **扩展网页自动化**:利用云基础设施可靠地运行任务,可以异步或同步运行,并具有强大的错误处理能力。
|
||||
|
||||
在 Sim 中,Apify 集成允许您的代理以编程方式执行核心 Apify 操作:
|
||||
|
||||
- **运行 Actor(同步)**:使用 `apify_run_actor_sync` 启动一个 Apify actor 并等待其完成,在运行结束后立即获取结果。
|
||||
- **运行 Actor(异步)**:使用 `apify_run_actor_async` 在后台启动一个 actor 并定期轮询结果,适用于较长或复杂的任务。
|
||||
|
||||
这些操作使您的代理能够直接在工作流程中自动化、抓取和协调数据收集或浏览器自动化任务——所有这些都具有灵活的配置和结果处理,无需手动运行或外部工具。将 Apify 集成为一个动态的自动化和数据提取引擎,以编程方式为您的代理提供网页规模的工作流程支持。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用说明
|
||||
|
||||
将 Apify 集成到您的工作流程中。使用自定义输入运行任何 Apify actor 并获取结果。支持同步和异步执行,并自动获取数据集。
|
||||
|
||||
## 工具
|
||||
|
||||
### `apify_run_actor_sync`
|
||||
|
||||
同步运行 APIFY actor 并获取结果(最长 5 分钟)
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | 来自 console.apify.com/account#/integrations 的 APIFY API 令牌 |
|
||||
| `actorId` | string | 是 | Actor ID 或用户名/actor 名称 \(例如:"janedoe/my-actor" 或 actor ID\) |
|
||||
| `input` | string | 否 | 作为 JSON 字符串的 actor 输入。请参阅 actor 文档以了解所需字段。 |
|
||||
| `timeout` | number | 否 | 超时时间(秒)\(默认:actor 默认值\) |
|
||||
| `build` | string | 否 | 要运行的 actor 构建版本 \(例如:"latest"、"beta" 或构建标签/编号\) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | actor 运行是否成功 |
|
||||
| `runId` | string | APIFY 运行 ID |
|
||||
| `status` | string | 运行状态 \(SUCCEEDED, FAILED 等\) |
|
||||
| `datasetId` | string | 包含结果的数据集 ID |
|
||||
| `items` | array | 数据集条目 \(如果已完成\) |
|
||||
|
||||
### `apify_run_actor_async`
|
||||
|
||||
异步运行 APIFY actor 并轮询长时间运行的任务
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | 来自 console.apify.com/account#/integrations 的 APIFY API 令牌 |
|
||||
| `actorId` | string | 是 | Actor ID 或用户名/actor 名称 \(例如:"janedoe/my-actor" 或 actor ID\) |
|
||||
| `input` | string | 否 | 作为 JSON 字符串的 actor 输入 |
|
||||
| `waitForFinish` | number | 否 | 轮询开始前的初始等待时间(秒)\(0-60\) |
|
||||
| `itemLimit` | number | 否 | 要获取的最大数据集条目数 \(1-250000,默认 100\) |
|
||||
| `timeout` | number | 否 | 超时时间(秒)\(默认:actor 默认值\) |
|
||||
| `build` | string | 否 | 要运行的 actor 构建版本 \(例如:"latest"、"beta" 或构建标签/编号\) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | actor 运行是否成功 |
|
||||
| `runId` | string | APIFY 运行 ID |
|
||||
| `status` | string | 运行状态 \(SUCCEEDED, FAILED 等\) |
|
||||
| `datasetId` | string | 包含结果的数据集 ID |
|
||||
| `items` | array | 数据集条目 \(如果已完成\) |
|
||||
|
||||
## 注意
|
||||
|
||||
- 类别: `tools`
|
||||
- 类型: `apify`
|
||||
188
apps/docs/content/docs/zh/tools/dynamodb.mdx
Normal file
188
apps/docs/content/docs/zh/tools/dynamodb.mdx
Normal file
@@ -0,0 +1,188 @@
|
||||
---
|
||||
title: Amazon DynamoDB
|
||||
description: 连接到 Amazon DynamoDB
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="dynamodb"
|
||||
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Amazon DynamoDB](https://aws.amazon.com/dynamodb/) 是 AWS 提供的一项完全托管的 NoSQL 数据库服务,具有快速且可预测的性能,并支持无缝扩展。DynamoDB 允许您存储和检索任意数量的数据,并处理任何级别的请求流量,而无需您管理硬件或基础设施。
|
||||
|
||||
使用 DynamoDB,您可以:
|
||||
|
||||
- **获取项目**:使用主键查找表中的项目
|
||||
- **添加项目**:在表中添加或替换项目
|
||||
- **查询项目**:通过索引查询检索多个项目
|
||||
- **扫描表**:读取表中的全部或部分数据
|
||||
- **更新项目**:修改现有项目的特定属性
|
||||
- **删除项目**:从表中移除记录
|
||||
|
||||
在 Sim 中,DynamoDB 集成使您的代理能够使用 AWS 凭证安全地访问和操作 DynamoDB 表。支持的操作包括:
|
||||
|
||||
- **获取**:通过键检索项目
|
||||
- **添加**:插入或覆盖项目
|
||||
- **查询**:使用键条件和过滤器运行查询
|
||||
- **扫描**:通过扫描表或索引读取多个项目
|
||||
- **更新**:更改一个或多个项目的特定属性
|
||||
- **删除**:从表中移除项目
|
||||
|
||||
此集成使 Sim 代理能够以编程方式自动化管理 DynamoDB 表中的数据管理任务,从而构建无需手动操作或服务器管理的工作流,来管理、修改和检索可扩展的 NoSQL 数据。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用说明
|
||||
|
||||
将 Amazon DynamoDB 集成到工作流中。支持对 DynamoDB 表执行获取、添加、查询、扫描、更新和删除操作。
|
||||
|
||||
## 工具
|
||||
|
||||
### `dynamodb_get`
|
||||
|
||||
通过主键从 DynamoDB 表中获取一个项目
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | 是 | AWS 区域 \(例如,us-east-1\) |
|
||||
| `accessKeyId` | string | 是 | AWS 访问密钥 ID |
|
||||
| `secretAccessKey` | string | 是 | AWS 秘密访问密钥 |
|
||||
| `tableName` | string | 是 | DynamoDB 表名 |
|
||||
| `key` | object | 是 | 要检索的项目主键 |
|
||||
| `consistentRead` | boolean | 否 | 使用强一致性读取 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `item` | object | 检索到的项目 |
|
||||
|
||||
### `dynamodb_put`
|
||||
|
||||
将一个项目放入 DynamoDB 表中
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | 是 | AWS 区域 \(例如,us-east-1\) |
|
||||
| `accessKeyId` | string | 是 | AWS 访问密钥 ID |
|
||||
| `secretAccessKey` | string | 是 | AWS 秘密访问密钥 |
|
||||
| `tableName` | string | 是 | DynamoDB 表名 |
|
||||
| `item` | object | 是 | 要放入表中的项目 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `item` | object | 创建的项目 |
|
||||
|
||||
### `dynamodb_query`
|
||||
|
||||
使用键条件从 DynamoDB 表中查询项目
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | 是 | AWS 区域 \(例如,us-east-1\) |
|
||||
| `accessKeyId` | string | 是 | AWS 访问密钥 ID |
|
||||
| `secretAccessKey` | string | 是 | AWS 秘密访问密钥 |
|
||||
| `tableName` | string | 是 | DynamoDB 表名 |
|
||||
| `keyConditionExpression` | string | 是 | 键条件表达式 \(例如,"pk = :pk"\) |
|
||||
| `filterExpression` | string | 否 | 结果的过滤表达式 |
|
||||
| `expressionAttributeNames` | object | 否 | 保留字的属性名称映射 |
|
||||
| `expressionAttributeValues` | object | 否 | 表达式属性值 |
|
||||
| `indexName` | string | 否 | 要查询的二级索引名称 |
|
||||
| `limit` | number | 否 | 要返回的最大项目数 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `items` | array | 返回的项目数组 |
|
||||
| `count` | number | 返回的项目数量 |
|
||||
|
||||
### `dynamodb_scan`
|
||||
|
||||
扫描 DynamoDB 表中的所有项目
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | 是 | AWS 区域 \(例如,us-east-1\) |
|
||||
| `accessKeyId` | string | 是 | AWS 访问密钥 ID |
|
||||
| `secretAccessKey` | string | 是 | AWS 秘密访问密钥 |
|
||||
| `tableName` | string | 是 | DynamoDB 表名 |
|
||||
| `filterExpression` | string | 否 | 结果的过滤表达式 |
|
||||
| `projectionExpression` | string | 否 | 要检索的属性 |
|
||||
| `expressionAttributeNames` | object | 否 | 保留字的属性名称映射 |
|
||||
| `expressionAttributeValues` | object | 否 | 表达式属性值 |
|
||||
| `limit` | number | 否 | 要返回的最大项目数 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `items` | array | 返回的项目数组 |
|
||||
| `count` | number | 返回的项目数量 |
|
||||
|
||||
### `dynamodb_update`
|
||||
|
||||
更新 DynamoDB 表中的项目
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | 是 | AWS 区域 \(例如,us-east-1\) |
|
||||
| `accessKeyId` | string | 是 | AWS 访问密钥 ID |
|
||||
| `secretAccessKey` | string | 是 | AWS 秘密访问密钥 |
|
||||
| `tableName` | string | 是 | DynamoDB 表名 |
|
||||
| `key` | object | 是 | 要更新项目的主键 |
|
||||
| `updateExpression` | string | 是 | 更新表达式 \(例如,"SET #name = :name"\) |
|
||||
| `expressionAttributeNames` | object | 否 | 保留字的属性名称映射 |
|
||||
| `expressionAttributeValues` | object | 否 | 表达式属性值 |
|
||||
| `conditionExpression` | string | 否 | 更新成功所需满足的条件 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `item` | object | 更新后的项目 |
|
||||
|
||||
### `dynamodb_delete`
|
||||
|
||||
从 DynamoDB 表中删除项目
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | 是 | AWS 区域 \(例如,us-east-1\) |
|
||||
| `accessKeyId` | string | 是 | AWS 访问密钥 ID |
|
||||
| `secretAccessKey` | string | 是 | AWS 秘密访问密钥 |
|
||||
| `tableName` | string | 是 | DynamoDB 表名 |
|
||||
| `key` | object | 是 | 要删除项目的主键 |
|
||||
| `conditionExpression` | string | 否 | 删除成功所需满足的条件 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
|
||||
## 注意
|
||||
|
||||
- 类别: `tools`
|
||||
- 类型: `dynamodb`
|
||||
83
apps/docs/content/docs/zh/tools/linkedin.mdx
Normal file
83
apps/docs/content/docs/zh/tools/linkedin.mdx
Normal file
@@ -0,0 +1,83 @@
|
||||
---
|
||||
title: LinkedIn
|
||||
description: 分享帖子并管理您的 LinkedIn 存在
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="linkedin"
|
||||
color="#0072B1"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[LinkedIn](https://www.linkedin.com) 是全球最大的职业社交平台,帮助用户建立职业生涯,与人脉建立联系,并分享专业内容。LinkedIn 被各行业的专业人士广泛用于个人品牌建设、招聘、求职和业务发展。
|
||||
|
||||
通过 LinkedIn,您可以轻松地在个人动态中分享帖子,与您的网络互动,并访问您的个人资料信息以突出您的职业成就。与 Sim 的自动集成使您能够以编程方式利用 LinkedIn 的功能——让代理和工作流发布更新、报告您的职业存在,并在无需手动操作的情况下保持动态活跃。
|
||||
|
||||
通过此集成可用的 LinkedIn 关键功能包括:
|
||||
|
||||
- **分享帖子:** 自动将专业更新、文章或公告发布到您的 LinkedIn 个人动态。
|
||||
- **个人资料信息:** 检索有关您 LinkedIn 个人资料的详细信息,以便在工作流中进行监控或用于后续任务。
|
||||
|
||||
这些功能使您能够轻松地保持 LinkedIn 网络的互动,并作为您的 AI 或工作流自动化策略的一部分,高效地扩展您的职业影响力。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用说明
|
||||
|
||||
将 LinkedIn 集成到工作流中。在个人动态中分享帖子并访问您的 LinkedIn 个人资料信息。
|
||||
|
||||
## 工具
|
||||
|
||||
### `linkedin_share_post`
|
||||
|
||||
将帖子分享到您的个人 LinkedIn 动态
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `text` | string | 是 | 您的 LinkedIn 帖子的文本内容 |
|
||||
| `visibility` | string | 否 | 谁可以看到此帖子:“PUBLIC” 或 “CONNECTIONS” \(默认值:“PUBLIC”\) |
|
||||
| `request` | string | 否 | 无描述 |
|
||||
| `output` | string | 否 | 无描述 |
|
||||
| `output` | string | 否 | 无描述 |
|
||||
| `specificContent` | string | 否 | 无描述 |
|
||||
| `shareCommentary` | string | 否 | 无描述 |
|
||||
| `visibility` | string | 否 | 无描述 |
|
||||
| `headers` | string | 否 | 无描述 |
|
||||
| `output` | string | 否 | 无描述 |
|
||||
| `output` | string | 否 | 无描述 |
|
||||
| `output` | string | 否 | 无描述 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 操作成功状态 |
|
||||
| `postId` | string | 创建的帖子 ID |
|
||||
| `profile` | json | LinkedIn 个人资料信息 |
|
||||
| `error` | string | 如果操作失败的错误信息 |
|
||||
|
||||
### `linkedin_get_profile`
|
||||
|
||||
检索您的 LinkedIn 个人资料信息
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 操作成功状态 |
|
||||
| `postId` | string | 创建的帖子 ID |
|
||||
| `profile` | json | LinkedIn 个人资料信息 |
|
||||
| `error` | string | 如果操作失败的错误信息 |
|
||||
|
||||
## 注意事项
|
||||
|
||||
- 类别: `tools`
|
||||
- 类型: `linkedin`
|
||||
216
apps/docs/content/docs/zh/tools/mailgun.mdx
Normal file
216
apps/docs/content/docs/zh/tools/mailgun.mdx
Normal file
@@ -0,0 +1,216 @@
|
||||
---
|
||||
title: Mailgun
|
||||
description: 使用 Mailgun 发送电子邮件并管理邮件列表
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="mailgun"
|
||||
color="#F06248"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Mailgun](https://www.mailgun.com) 是一款功能强大的电子邮件发送服务,专为开发者和企业设计,能够轻松发送、接收和跟踪电子邮件。Mailgun 提供强大的 API,支持可靠的事务性和营销电子邮件、灵活的邮件列表管理以及高级事件跟踪。
|
||||
|
||||
通过 Mailgun 的全面功能集,您可以自动化关键的电子邮件操作,并密切监控投递率和收件人参与度。这使其成为在通信、通知和活动邮件是核心流程的工作流自动化中的理想解决方案。
|
||||
|
||||
Mailgun 的主要功能包括:
|
||||
|
||||
- **事务性电子邮件发送:** 发送大量电子邮件,例如账户通知、收据、警报和密码重置。
|
||||
- **丰富的电子邮件内容:** 发送纯文本和 HTML 格式的电子邮件,并使用标签对消息进行分类和跟踪。
|
||||
- **邮件列表管理:** 创建、更新和管理邮件列表及成员,以高效发送分组通信。
|
||||
- **域信息:** 检索发送域的详细信息,以监控配置和健康状况。
|
||||
- **事件跟踪:** 通过详细的事件数据分析电子邮件的投递率和参与度。
|
||||
- **消息检索:** 访问存储的消息以满足合规性、分析或故障排除需求。
|
||||
|
||||
通过将 Mailgun 集成到 Sim 中,您的代理可以以编程方式发送电子邮件、管理邮件列表、访问域信息并监控实时事件,作为自动化工作流的一部分。这使您能够直接从 AI 驱动的流程中实现智能、数据驱动的用户互动。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用说明
|
||||
|
||||
将 Mailgun 集成到您的工作流中。发送事务性电子邮件,管理邮件列表及成员,查看域信息并跟踪电子邮件事件。支持文本和 HTML 格式的电子邮件、用于跟踪的标签以及全面的列表管理功能。
|
||||
|
||||
## 工具
|
||||
|
||||
### `mailgun_send_message`
|
||||
|
||||
使用 Mailgun API 发送电子邮件
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Mailgun API 密钥 |
|
||||
| `domain` | string | 是 | Mailgun 域名 \(例如:mg.example.com\) |
|
||||
| `from` | string | 是 | 发件人电子邮件地址 |
|
||||
| `to` | string | 是 | 收件人电子邮件地址 \(多个地址用逗号分隔\) |
|
||||
| `subject` | string | 是 | 电子邮件主题 |
|
||||
| `text` | string | 否 | 电子邮件的纯文本正文 |
|
||||
| `html` | string | 否 | 电子邮件的 HTML 正文 |
|
||||
| `cc` | string | 否 | 抄送电子邮件地址 \(多个地址用逗号分隔\) |
|
||||
| `bcc` | string | 否 | 密送电子邮件地址 \(多个地址用逗号分隔\) |
|
||||
| `tags` | string | 否 | 电子邮件标签 \(用逗号分隔\) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 消息是否成功发送 |
|
||||
| `id` | string | 消息 ID |
|
||||
| `message` | string | 来自 Mailgun 的响应消息 |
|
||||
|
||||
### `mailgun_get_message`
|
||||
|
||||
通过其密钥检索存储的消息
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Mailgun API 密钥 |
|
||||
| `domain` | string | 是 | Mailgun 域名 |
|
||||
| `messageKey` | string | 是 | 消息存储密钥 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 请求是否成功 |
|
||||
| `recipients` | string | 消息接收者 |
|
||||
| `from` | string | 发件人邮箱 |
|
||||
| `subject` | string | 消息主题 |
|
||||
| `bodyPlain` | string | 纯文本正文 |
|
||||
| `strippedText` | string | 去除格式的文本 |
|
||||
| `strippedSignature` | string | 去除格式的签名 |
|
||||
| `bodyHtml` | string | HTML 正文 |
|
||||
| `strippedHtml` | string | 去除格式的 HTML |
|
||||
| `attachmentCount` | number | 附件数量 |
|
||||
| `timestamp` | number | 消息时间戳 |
|
||||
| `messageHeaders` | json | 消息头信息 |
|
||||
| `contentIdMap` | json | 内容 ID 映射 |
|
||||
|
||||
### `mailgun_list_messages`
|
||||
|
||||
列出通过 Mailgun 发送的消息的事件(日志)
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Mailgun API 密钥 |
|
||||
| `domain` | string | 是 | Mailgun 域名 |
|
||||
| `event` | string | 否 | 按事件类型过滤 \(accepted, delivered, failed, opened, clicked, etc.\) |
|
||||
| `limit` | number | 否 | 返回的最大事件数 \(默认值: 100\) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 请求是否成功 |
|
||||
| `items` | json | 事件项数组 |
|
||||
| `paging` | json | 分页信息 |
|
||||
|
||||
### `mailgun_create_mailing_list`
|
||||
|
||||
创建一个新的邮件列表
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Mailgun API 密钥 |
|
||||
| `address` | string | 是 | 邮件列表地址 \(例如:list@example.com\) |
|
||||
| `name` | string | 否 | 邮件列表名称 |
|
||||
| `description` | string | 否 | 邮件列表描述 |
|
||||
| `accessLevel` | string | 否 | 访问级别:readonly、members 或 everyone |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 是否成功创建了列表 |
|
||||
| `message` | string | 响应消息 |
|
||||
| `list` | json | 创建的邮件列表详情 |
|
||||
|
||||
### `mailgun_get_mailing_list`
|
||||
|
||||
获取邮件列表的详细信息
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Mailgun API 密钥 |
|
||||
| `address` | string | 是 | 邮件列表地址 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 请求是否成功 |
|
||||
| `list` | json | 邮件列表详情 |
|
||||
|
||||
### `mailgun_add_list_member`
|
||||
|
||||
向邮件列表添加成员
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Mailgun API 密钥 |
|
||||
| `listAddress` | string | 是 | 邮件列表地址 |
|
||||
| `address` | string | 是 | 成员邮箱地址 |
|
||||
| `name` | string | 否 | 成员名称 |
|
||||
| `vars` | string | 否 | 自定义变量的 JSON 字符串 |
|
||||
| `subscribed` | boolean | 否 | 成员是否已订阅 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 成员是否成功添加 |
|
||||
| `message` | string | 响应消息 |
|
||||
| `member` | json | 添加的成员详情 |
|
||||
|
||||
### `mailgun_list_domains`
|
||||
|
||||
列出您的 Mailgun 帐户的所有域名
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Mailgun API 密钥 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 请求是否成功 |
|
||||
| `totalCount` | number | 域名总数 |
|
||||
| `items` | json | 域名对象数组 |
|
||||
|
||||
### `mailgun_get_domain`
|
||||
|
||||
获取特定域名的详细信息
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Mailgun API 密钥 |
|
||||
| `domain` | string | 是 | 域名 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 请求是否成功 |
|
||||
| `domain` | json | 域名详情 |
|
||||
|
||||
## 注意事项
|
||||
|
||||
- 类别: `tools`
|
||||
- 类型: `mailgun`
|
||||
168
apps/docs/content/docs/zh/tools/rds.mdx
Normal file
168
apps/docs/content/docs/zh/tools/rds.mdx
Normal file
@@ -0,0 +1,168 @@
|
||||
---
|
||||
title: Amazon RDS
|
||||
description: 通过 Data API 连接到 Amazon RDS
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="rds"
|
||||
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Amazon RDS Aurora Serverless](https://aws.amazon.com/rds/aurora/serverless/) 是一种完全托管的关系型数据库,它会根据您的应用需求自动启动、关闭并调整容量。它允许您在云中运行 SQL 数据库,而无需管理数据库服务器。
|
||||
|
||||
使用 RDS Aurora Serverless,您可以:
|
||||
|
||||
- **查询数据**:在表中运行灵活的 SQL 查询
|
||||
- **插入新记录**:自动向数据库添加数据
|
||||
- **更新现有记录**:使用自定义筛选条件修改表中的数据
|
||||
- **删除记录**:通过精确的条件删除不需要的数据
|
||||
- **执行原始 SQL**:运行 Aurora 支持的任何有效 SQL 命令
|
||||
|
||||
在 Sim 中,RDS 集成使您的代理能够以安全且编程的方式与 Amazon Aurora Serverless 数据库交互。支持的操作包括:
|
||||
|
||||
- **查询**:运行 SELECT 和其他 SQL 查询以从数据库中获取行
|
||||
- **插入**:将新记录插入到具有结构化数据的表中
|
||||
- **更新**:更改符合指定条件的行中的数据
|
||||
- **删除**:通过自定义筛选条件从表中删除记录
|
||||
- **执行**:运行原始 SQL 以应对高级场景
|
||||
|
||||
此集成允许您的代理在无需人工干预的情况下自动化各种数据库操作。通过将 Sim 与 Amazon RDS 连接,您可以构建能够在工作流中管理、更新和检索关系数据的代理——无需处理数据库基础设施或连接。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用说明
|
||||
|
||||
通过 Data API 将 Amazon RDS Aurora Serverless 集成到工作流中。可以查询、插入、更新、删除以及执行原始 SQL,而无需管理数据库连接。
|
||||
|
||||
## 工具
|
||||
|
||||
### `rds_query`
|
||||
|
||||
使用数据 API 在 Amazon RDS 上执行 SELECT 查询
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | 是 | AWS 区域 \(例如,us-east-1\) |
|
||||
| `accessKeyId` | string | 是 | AWS 访问密钥 ID |
|
||||
| `secretAccessKey` | string | 是 | AWS 秘密访问密钥 |
|
||||
| `resourceArn` | string | 是 | Aurora 数据库集群的 ARN |
|
||||
| `secretArn` | string | 是 | 包含数据库凭据的 Secrets Manager 密钥的 ARN |
|
||||
| `database` | string | 否 | 数据库名称 \(可选\) |
|
||||
| `query` | string | 是 | 要执行的 SQL SELECT 查询 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `rows` | array | 查询返回的行数组 |
|
||||
| `rowCount` | number | 返回的行数 |
|
||||
|
||||
### `rds_insert`
|
||||
|
||||
使用数据 API 将数据插入 Amazon RDS 表
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | 是 | AWS 区域 \(例如,us-east-1\) |
|
||||
| `accessKeyId` | string | 是 | AWS 访问密钥 ID |
|
||||
| `secretAccessKey` | string | 是 | AWS 秘密访问密钥 |
|
||||
| `resourceArn` | string | 是 | Aurora 数据库集群的 ARN |
|
||||
| `secretArn` | string | 是 | 包含数据库凭据的 Secrets Manager 密钥的 ARN |
|
||||
| `database` | string | 否 | 数据库名称 \(可选\) |
|
||||
| `table` | string | 是 | 要插入的表名 |
|
||||
| `data` | object | 是 | 要插入的数据,作为键值对 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `rows` | array | 插入行的数组 |
|
||||
| `rowCount` | number | 插入的行数 |
|
||||
|
||||
### `rds_update`
|
||||
|
||||
使用 Data API 更新 Amazon RDS 表中的数据
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | 是 | AWS 区域 \(例如,us-east-1\) |
|
||||
| `accessKeyId` | string | 是 | AWS 访问密钥 ID |
|
||||
| `secretAccessKey` | string | 是 | AWS 秘密访问密钥 |
|
||||
| `resourceArn` | string | 是 | Aurora 数据库集群的 ARN |
|
||||
| `secretArn` | string | 是 | 包含数据库凭据的 Secrets Manager 密钥的 ARN |
|
||||
| `database` | string | 否 | 数据库名称 \(可选\) |
|
||||
| `table` | string | 是 | 要更新的表名 |
|
||||
| `data` | object | 是 | 要更新的数据,作为键值对 |
|
||||
| `conditions` | object | 是 | 更新条件 \(例如,\{"id": 1\}\) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `rows` | array | 更新行的数组 |
|
||||
| `rowCount` | number | 更新的行数 |
|
||||
|
||||
### `rds_delete`
|
||||
|
||||
使用 Data API 从 Amazon RDS 表中删除数据
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | 是 | AWS 区域 \(例如,us-east-1\) |
|
||||
| `accessKeyId` | string | 是 | AWS 访问密钥 ID |
|
||||
| `secretAccessKey` | string | 是 | AWS 秘密访问密钥 |
|
||||
| `resourceArn` | string | 是 | Aurora 数据库集群的 ARN |
|
||||
| `secretArn` | string | 是 | 包含数据库凭据的 Secrets Manager 密钥的 ARN |
|
||||
| `database` | string | 否 | 数据库名称 \(可选\) |
|
||||
| `table` | string | 是 | 要删除的表名 |
|
||||
| `conditions` | object | 是 | 删除条件 \(例如,\{"id": 1\}\) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `rows` | array | 已删除行的数组 |
|
||||
| `rowCount` | number | 已删除行的数量 |
|
||||
|
||||
### `rds_execute`
|
||||
|
||||
使用 Data API 在 Amazon RDS 上执行原始 SQL
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `region` | string | 是 | AWS 区域 \(例如,us-east-1\) |
|
||||
| `accessKeyId` | string | 是 | AWS 访问密钥 ID |
|
||||
| `secretAccessKey` | string | 是 | AWS 秘密访问密钥 |
|
||||
| `resourceArn` | string | 是 | Aurora 数据库集群的 ARN |
|
||||
| `secretArn` | string | 是 | 包含数据库凭据的 Secrets Manager 密钥的 ARN |
|
||||
| `database` | string | 否 | 数据库名称 \(可选\) |
|
||||
| `query` | string | 是 | 要执行的原始 SQL 查询 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `rows` | array | 返回或受影响的行数组 |
|
||||
| `rowCount` | number | 受影响的行数 |
|
||||
|
||||
## 注意
|
||||
|
||||
- 类别: `tools`
|
||||
- 类型: `rds`
|
||||
@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="s3"
|
||||
color="#E0E0E0"
|
||||
color="linear-gradient(45deg, #1B660F 0%, #6CAE3E 100%)"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
|
||||
54
apps/docs/content/docs/zh/tools/search.mdx
Normal file
54
apps/docs/content/docs/zh/tools/search.mdx
Normal file
@@ -0,0 +1,54 @@
|
||||
---
|
||||
title: 搜索
|
||||
description: 搜索网络(每次搜索 $0.01)
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="search"
|
||||
color="#3B82F6"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
**搜索**工具让您可以在 Sim 工作流中使用最先进的搜索引擎进行网络搜索。使用它可以将最新的信息、新闻、事实和网络内容直接引入您的代理、自动化或对话中。
|
||||
|
||||
- **通用网络搜索**:从互联网获取最新信息以补充您的工作流。
|
||||
- **自动化查询**:让代理或程序逻辑提交搜索查询并自动处理结果。
|
||||
- **结构化结果**:返回最相关的网络结果,包括每个结果的标题、链接、摘要和日期。
|
||||
|
||||
> **注意:** 每次搜索费用为 **$0.01**。
|
||||
|
||||
此工具非常适合任何需要访问实时网络数据的工作流,或需要参考当前事件、进行研究或获取补充内容的场景。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用说明
|
||||
|
||||
使用搜索工具进行网络搜索。每次搜索费用为 $0.01。
|
||||
|
||||
## 工具
|
||||
|
||||
### `search_tool`
|
||||
|
||||
搜索网络。返回最相关的网络结果,包括每个结果的标题、链接、摘要和日期。
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `query` | string | 是 | 搜索查询 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `results` | json | 搜索结果 |
|
||||
| `query` | string | 搜索查询 |
|
||||
| `totalResults` | number | 结果总数 |
|
||||
| `source` | string | 搜索来源(例如) |
|
||||
| `cost` | json | 成本信息($0.01) |
|
||||
|
||||
## 注意
|
||||
|
||||
- 类别:`tools`
|
||||
- 类型:`search`
|
||||
391
apps/docs/content/docs/zh/tools/sendgrid.mdx
Normal file
391
apps/docs/content/docs/zh/tools/sendgrid.mdx
Normal file
@@ -0,0 +1,391 @@
|
||||
---
|
||||
title: SendGrid
|
||||
description: 使用 SendGrid 发送电子邮件并管理联系人、列表和模板
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="sendgrid"
|
||||
color="#1A82E2"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[SendGrid](https://sendgrid.com) 是一个领先的基于云的电子邮件发送平台,受到开发者和企业的信赖,可大规模发送可靠的事务性和营销电子邮件。通过其强大的 API 和工具,SendGrid 使您能够管理电子邮件通信的各个方面,从发送通知和收据到管理复杂的营销活动。
|
||||
|
||||
SendGrid 为用户提供了一整套电子邮件操作功能,使您能够自动化关键的电子邮件工作流,并密切管理联系人列表、模板和收件人参与度。它与 Sim 的无缝集成使代理和工作流能够发送目标消息,维护动态联系人和收件人列表,通过模板触发个性化电子邮件,并实时跟踪结果。
|
||||
|
||||
SendGrid 的主要功能包括:
|
||||
|
||||
- **事务性电子邮件:** 发送自动化和大批量的事务性电子邮件(如通知、收据和密码重置)。
|
||||
- **动态模板:** 使用丰富的 HTML 或文本模板和动态数据,实现大规模高度个性化的通信。
|
||||
- **联系人管理:** 添加和更新营销联系人,管理收件人列表,并针对活动目标群体进行细分。
|
||||
- **附件支持:** 在电子邮件中包含一个或多个文件附件。
|
||||
- **全面的 API 覆盖:** 以编程方式管理电子邮件、联系人、列表、模板、抑制组等。
|
||||
|
||||
通过将 SendGrid 与 Sim 连接,您的代理可以:
|
||||
|
||||
- 在任何工作流中发送简单或高级(模板化或多收件人)的电子邮件。
|
||||
- 自动管理和细分联系人和列表。
|
||||
- 利用模板实现一致性和动态个性化。
|
||||
- 在自动化流程中跟踪和响应电子邮件参与情况。
|
||||
|
||||
此集成允许您自动化所有关键的通信流程,确保消息到达正确的受众,并直接从 Sim 工作流中维护对您组织电子邮件策略的控制。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用说明
|
||||
|
||||
将 SendGrid 集成到您的工作流中。发送事务性电子邮件,管理营销联系人和列表,并使用电子邮件模板。支持动态模板、附件和全面的联系人管理。
|
||||
|
||||
## 工具
|
||||
|
||||
### `sendgrid_send_mail`
|
||||
|
||||
使用 SendGrid API 发送电子邮件
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `from` | string | 是 | 发件人电子邮件地址 \(必须在 SendGrid 中验证\) |
|
||||
| `fromName` | string | 否 | 发件人名称 |
|
||||
| `to` | string | 是 | 收件人电子邮件地址 |
|
||||
| `toName` | string | 否 | 收件人名称 |
|
||||
| `subject` | string | 否 | 电子邮件主题 \(除非使用具有预定义主题的模板,否则必需\) |
|
||||
| `content` | string | 否 | 电子邮件正文内容 \(除非使用具有预定义内容的模板,否则必需\) |
|
||||
| `contentType` | string | 否 | 内容类型 \(text/plain 或 text/html\) |
|
||||
| `cc` | string | 否 | 抄送电子邮件地址 |
|
||||
| `bcc` | string | 否 | 密送电子邮件地址 |
|
||||
| `replyTo` | string | 否 | 回复电子邮件地址 |
|
||||
| `replyToName` | string | 否 | 回复名称 |
|
||||
| `attachments` | file[] | 否 | 附加到电子邮件的文件 |
|
||||
| `templateId` | string | 否 | 要使用的 SendGrid 模板 ID |
|
||||
| `dynamicTemplateData` | json | 否 | 动态模板数据的 JSON 对象 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 邮件是否成功发送 |
|
||||
| `messageId` | string | SendGrid 消息 ID |
|
||||
| `to` | string | 收件人邮箱地址 |
|
||||
| `subject` | string | 邮件主题 |
|
||||
|
||||
### `sendgrid_add_contact`
|
||||
|
||||
向 SendGrid 添加新联系人
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `email` | string | 是 | 联系人邮箱地址 |
|
||||
| `firstName` | string | 否 | 联系人名字 |
|
||||
| `lastName` | string | 否 | 联系人姓氏 |
|
||||
| `customFields` | json | 否 | 自定义字段键值对的 JSON 对象 \(使用字段 ID,如 e1_T, e2_N, e3_D,而不是字段名称\) |
|
||||
| `listIds` | string | 否 | 用逗号分隔的列表 ID,用于添加联系人 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | 用于跟踪异步联系人创建的作业 ID |
|
||||
| `email` | string | 联系人邮箱地址 |
|
||||
| `firstName` | string | 联系人名字 |
|
||||
| `lastName` | string | 联系人姓氏 |
|
||||
| `message` | string | 状态消息 |
|
||||
|
||||
### `sendgrid_get_contact`
|
||||
|
||||
通过 ID 从 SendGrid 获取特定联系人
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `contactId` | string | 是 | 联系人 ID |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | 联系人 ID |
|
||||
| `email` | string | 联系人邮箱地址 |
|
||||
| `firstName` | string | 联系人名字 |
|
||||
| `lastName` | string | 联系人姓氏 |
|
||||
| `createdAt` | string | 创建时间戳 |
|
||||
| `updatedAt` | string | 最后更新时间戳 |
|
||||
| `listIds` | json | 联系人所属列表 ID 的数组 |
|
||||
| `customFields` | json | 自定义字段值 |
|
||||
|
||||
### `sendgrid_search_contacts`
|
||||
|
||||
使用查询在 SendGrid 中搜索联系人
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `query` | string | 是 | 搜索查询 \(例如,\"email LIKE '%example.com%' AND CONTAINS\(list_ids, 'list-id'\)\"\) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `contacts` | json | 匹配联系人的数组 |
|
||||
| `contactCount` | number | 找到的联系人总数 |
|
||||
|
||||
### `sendgrid_delete_contacts`
|
||||
|
||||
从 SendGrid 中删除一个或多个联系人
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `contactIds` | string | 是 | 要删除的联系人 ID,逗号分隔 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | 删除请求的作业 ID |
|
||||
|
||||
### `sendgrid_create_list`
|
||||
|
||||
在 SendGrid 中创建一个新的联系人列表
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `name` | string | 是 | 列表名称 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | 列表 ID |
|
||||
| `name` | string | 列表名称 |
|
||||
| `contactCount` | number | 列表中的联系人数量 |
|
||||
|
||||
### `sendgrid_get_list`
|
||||
|
||||
通过 ID 从 SendGrid 获取特定列表
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `listId` | string | 是 | 列表 ID |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | 列表 ID |
|
||||
| `name` | string | 列表名称 |
|
||||
| `contactCount` | number | 列表中的联系人数量 |
|
||||
|
||||
### `sendgrid_list_all_lists`
|
||||
|
||||
从 SendGrid 获取所有联系人列表
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `pageSize` | number | 否 | 每页返回的列表数量 \(默认值: 100\) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `lists` | json | 列表数组 |
|
||||
|
||||
### `sendgrid_delete_list`
|
||||
|
||||
从 SendGrid 删除联系人列表
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `listId` | string | 是 | 要删除的列表 ID |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 成功消息 |
|
||||
|
||||
### `sendgrid_add_contacts_to_list`
|
||||
|
||||
在 SendGrid 中添加或更新联系人并将其分配到列表中(使用 PUT /v3/marketing/contacts)
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `listId` | string | 是 | 要添加联系人的列表 ID |
|
||||
| `contacts` | json | 是 | 联系人对象的 JSON 数组。每个联系人必须至少包含:email(或 phone_number_id/external_id/anonymous_id)。示例:\[\{"email": "user@example.com", "first_name": "John"\}\] |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | 用于跟踪异步操作的作业 ID |
|
||||
| `message` | string | 状态消息 |
|
||||
|
||||
### `sendgrid_remove_contacts_from_list`
|
||||
|
||||
从 SendGrid 的特定列表中移除联系人
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `listId` | string | 是 | 列表 ID |
|
||||
| `contactIds` | string | 是 | 要从列表中移除的逗号分隔的联系人 ID |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `jobId` | string | 请求的作业 ID |
|
||||
|
||||
### `sendgrid_create_template`
|
||||
|
||||
在 SendGrid 中创建一个新的电子邮件模板
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `name` | string | 是 | 模板名称 |
|
||||
| `generation` | string | 否 | 模板生成类型(legacy 或 dynamic,默认值:dynamic) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | 模板 ID |
|
||||
| `name` | string | 模板名称 |
|
||||
| `generation` | string | 模板生成 |
|
||||
| `updatedAt` | string | 最后更新时间戳 |
|
||||
| `versions` | json | 模板版本数组 |
|
||||
|
||||
### `sendgrid_get_template`
|
||||
|
||||
通过 ID 从 SendGrid 获取特定模板
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `templateId` | string | 是 | 模板 ID |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | 模板 ID |
|
||||
| `name` | string | 模板名称 |
|
||||
| `generation` | string | 模板生成 |
|
||||
| `updatedAt` | string | 最后更新时间戳 |
|
||||
| `versions` | json | 模板版本数组 |
|
||||
|
||||
### `sendgrid_list_templates`
|
||||
|
||||
从 SendGrid 获取所有电子邮件模板
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `generations` | string | 否 | 按生成方式筛选 \(legacy、dynamic 或 both\) |
|
||||
| `pageSize` | number | 否 | 每页返回的模板数量 \(默认值: 20\) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `templates` | json | 模板数组 |
|
||||
|
||||
### `sendgrid_delete_template`
|
||||
|
||||
从 SendGrid 删除电子邮件模板
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `templateId` | string | 是 | 要删除的模板 ID |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 操作成功状态 |
|
||||
| `messageId` | string | 电子邮件消息 ID \(send_mail\) |
|
||||
| `id` | string | 资源 ID |
|
||||
| `jobId` | string | 异步操作的作业 ID |
|
||||
| `email` | string | 电子邮件地址 |
|
||||
| `firstName` | string | 名字 |
|
||||
| `lastName` | string | 姓氏 |
|
||||
| `contacts` | json | 联系人数组 |
|
||||
| `contactCount` | number | 联系人数量 |
|
||||
| `lists` | json | 列表数组 |
|
||||
| `templates` | json | 模板数组 |
|
||||
| `message` | string | 状态或成功消息 |
|
||||
| `name` | string | 资源名称 |
|
||||
| `generation` | string | 模板生成方式 |
|
||||
|
||||
### `sendgrid_create_template_version`
|
||||
|
||||
在 SendGrid 中创建一个新的电子邮件模板版本
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | SendGrid API 密钥 |
|
||||
| `templateId` | string | 是 | 模板 ID |
|
||||
| `name` | string | 是 | 版本名称 |
|
||||
| `subject` | string | 是 | 电子邮件主题行 |
|
||||
| `htmlContent` | string | 否 | 模板的 HTML 内容 |
|
||||
| `plainContent` | string | 否 | 模板的纯文本内容 |
|
||||
| `active` | boolean | 否 | 此版本是否为激活状态(默认:true) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | 版本 ID |
|
||||
| `templateId` | string | 模板 ID |
|
||||
| `name` | string | 版本名称 |
|
||||
| `subject` | string | 电子邮件主题 |
|
||||
| `active` | boolean | 此版本是否为激活状态 |
|
||||
| `htmlContent` | string | HTML 内容 |
|
||||
| `plainContent` | string | 纯文本内容 |
|
||||
| `updatedAt` | string | 最后更新时间戳 |
|
||||
|
||||
## 注意事项
|
||||
|
||||
- 类别:`tools`
|
||||
- 类型:`sendgrid`
|
||||
73
apps/docs/content/docs/zh/tools/smtp.mdx
Normal file
73
apps/docs/content/docs/zh/tools/smtp.mdx
Normal file
@@ -0,0 +1,73 @@
|
||||
---
|
||||
title: SMTP
|
||||
description: 通过任何 SMTP 邮件服务器发送电子邮件
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="smtp"
|
||||
color="#4A5568"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[SMTP(简单邮件传输协议)](https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol) 是互联网电子邮件传输的基础标准。通过连接任何兼容 SMTP 的服务器(如 Gmail、Outlook 或您组织的邮件基础设施),您可以以编程方式发送电子邮件并自动化您的外发通信。
|
||||
|
||||
SMTP 集成允许您通过直接的服务器连接完全自定义电子邮件发送,支持基本和高级的电子邮件使用场景。使用 SMTP,您可以控制消息传递、收件人管理和内容格式的每个方面,使其适用于事务性通知、大量邮件发送以及任何需要强大外发电子邮件传递的自动化工作流程。
|
||||
|
||||
**通过 SMTP 集成可用的关键功能包括:**
|
||||
|
||||
- **通用电子邮件传递:** 通过配置标准服务器连接参数,使用任何 SMTP 服务器发送电子邮件。
|
||||
- **可自定义的发件人和收件人:** 指定发件人地址、显示名称、主要收件人,以及抄送 (CC) 和密送 (BCC) 字段。
|
||||
- **丰富的内容支持:** 根据您的需求发送纯文本或格式丰富的 HTML 电子邮件。
|
||||
- **附件:** 在外发电子邮件中包含多个文件作为附件。
|
||||
- **灵活的安全性:** 根据您的 SMTP 提供商支持的协议,使用 TLS、SSL 或标准(未加密)协议进行连接。
|
||||
- **高级头信息:** 设置回复地址头和其他高级电子邮件选项,以满足复杂的邮件流和用户交互需求。
|
||||
|
||||
通过将 SMTP 与 Sim 集成,代理和工作流程可以以编程方式将电子邮件作为任何自动化流程的一部分发送——从发送通知和确认,到自动化外部通信、报告和文档传递。这提供了一种高度灵活、与提供商无关的方法,可以直接在您的 AI 驱动流程中管理电子邮件。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用说明
|
||||
|
||||
使用任何 SMTP 服务器(如 Gmail、Outlook、自定义服务器等)发送电子邮件。配置 SMTP 连接设置,并完全控制内容、收件人和附件来发送电子邮件。
|
||||
|
||||
## 工具
|
||||
|
||||
### `smtp_send_mail`
|
||||
|
||||
通过 SMTP 服务器发送电子邮件
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `smtpHost` | string | 是 | SMTP 服务器主机名(例如:smtp.gmail.com) |
|
||||
| `smtpPort` | number | 是 | SMTP 服务器端口(TLS 为 587,SSL 为 465) |
|
||||
| `smtpUsername` | string | 是 | SMTP 身份验证用户名 |
|
||||
| `smtpPassword` | string | 是 | SMTP 身份验证密码 |
|
||||
| `smtpSecure` | string | 是 | 安全协议(TLS、SSL 或无) |
|
||||
| `from` | string | 是 | 发件人电子邮件地址 |
|
||||
| `to` | string | 是 | 收件人电子邮件地址 |
|
||||
| `subject` | string | 是 | 电子邮件主题 |
|
||||
| `body` | string | 是 | 电子邮件正文内容 |
|
||||
| `contentType` | string | 否 | 内容类型(text 或 html) |
|
||||
| `fromName` | string | 否 | 发件人显示名称 |
|
||||
| `cc` | string | 否 | 抄送收件人(逗号分隔) |
|
||||
| `bcc` | string | 否 | 密送收件人(逗号分隔) |
|
||||
| `replyTo` | string | 否 | 回复电子邮件地址 |
|
||||
| `attachments` | file[] | 否 | 附加到电子邮件的文件 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 邮件是否成功发送 |
|
||||
| `messageId` | string | 来自 SMTP 服务器的消息 ID |
|
||||
| `to` | string | 收件人电子邮件地址 |
|
||||
| `subject` | string | 电子邮件主题 |
|
||||
| `error` | string | 如果发送失败的错误消息 |
|
||||
|
||||
## 注意
|
||||
|
||||
- 分类:`tools`
|
||||
- 类型:`smtp`
|
||||
@@ -1028,7 +1028,7 @@ checksums:
|
||||
meta/title: cce1ae862f9851c02137f7be070e87bf
|
||||
meta/description: 9c24136d13767cf42d598ecd2cd7895b
|
||||
content/0: 1b031fb0c62c46b177aeed5c3d3f8f80
|
||||
content/1: 5cc75c9b77c8b8ee90fd3727b3b3e71a
|
||||
content/1: 4897888e9b93f43cfa08f08e01d63d45
|
||||
content/2: bd6df7d7d47e2f5a3562df04bb4c2be5
|
||||
content/3: a8184d3faf141c4c38d8a31b6374830d
|
||||
content/4: b0425d5c200cae7c869529ea3b8f7214
|
||||
@@ -47114,3 +47114,373 @@ checksums:
|
||||
content/104: c6d621ee3cdc66de2c20b70a39aafe12
|
||||
content/105: b3f310d5ef115bea5a8b75bf25d7ea9a
|
||||
content/106: 9d45ccf1c14d61412169be8f8510a960
|
||||
9ed109808041fe9022eed66e1feedfdd:
|
||||
meta/title: cba6e4eab965c94b8973e60e9ea10c05
|
||||
meta/description: 366d196f8f11ecd0e96516bb9181f8d5
|
||||
content/0: 1b031fb0c62c46b177aeed5c3d3f8f80
|
||||
content/1: dcf2843a8d5eb40192a44104c9c788a4
|
||||
content/2: 36ce181b1ca29664a1b6ddf4090623ae
|
||||
content/3: 0a9d2b209e2a8b8fadda104bc42ea92e
|
||||
content/4: 646bc61a952c9733ad296f441ae5ed9e
|
||||
content/5: 40acc2cabeac1517944e2cb7b798b1b2
|
||||
content/6: c398c5b62380e61ee01e211a35d51aba
|
||||
content/7: 821e6394b0a953e2b0842b04ae8f3105
|
||||
content/8: 46cd469dc3ba6864acfe2aedecb7d187
|
||||
content/9: 9c8aa3f09c9b2bd50ea4cdff3598ea4e
|
||||
content/10: 7c66bb1ee02987bc4bc88217e9b3bac7
|
||||
content/11: bd55d02bd4275b49af4b4c8b7c43628e
|
||||
content/12: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/13: a962eddcfdc6875bcb08a64d34c9cf1d
|
||||
content/14: bcadfc362b69078beee0088e5936c98b
|
||||
content/15: 0dc1675d63e9b8cf974548f7f33baff9
|
||||
content/16: b3f310d5ef115bea5a8b75bf25d7ea9a
|
||||
content/17: 591b0b21fdd6f07241c97381dcc7a554
|
||||
21c5c74229b0ec1318fd47b3bff76fbb:
|
||||
meta/title: 84ced5c0ab02fb2b72e8b6cfb40b4596
|
||||
meta/description: dca3d318d04d8b35a5a308daa424b261
|
||||
content/0: 1b031fb0c62c46b177aeed5c3d3f8f80
|
||||
content/1: 1731401b29cfa7e72b7e5b65f65c6267
|
||||
content/2: 3c4b8ba9b9a18779cc3946a989f8ef84
|
||||
content/3: be9b4ba1386fdfc17722872f13d8b065
|
||||
content/4: d503580fe34361dcb6496ec6694bc9e1
|
||||
content/5: 9dc3d3ec6dda629e88ae029b2d658bda
|
||||
content/6: 9152b2bb77feff0b825c6520a86487b5
|
||||
content/7: dc6788f18a57dcb0577312e34e5d97db
|
||||
content/8: 8b04440694729de9b0b36edd5ccba509
|
||||
content/9: 821e6394b0a953e2b0842b04ae8f3105
|
||||
content/10: 5363c89d96b289212e3b5a73f70c3189
|
||||
content/11: 9c8aa3f09c9b2bd50ea4cdff3598ea4e
|
||||
content/12: da4762bf046b4612a3d998ca8933d92d
|
||||
content/13: aa3b814b4a9c5553373e52aac8b87a52
|
||||
content/14: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/15: 887b87a8f3a5bb5ea3fd8793f47b7c61
|
||||
content/16: bcadfc362b69078beee0088e5936c98b
|
||||
content/17: e22392f49f990400f91cbb4cbee946e1
|
||||
content/18: 78d42fb8ee8a68ffa92ded3cc705edf1
|
||||
content/19: 911dab823f8bd10d7d8032976b3a6c8e
|
||||
content/20: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/21: 2bbd6012cfb6e25424f3b0f02aad3ce8
|
||||
content/22: bcadfc362b69078beee0088e5936c98b
|
||||
content/23: 1b595fc6d3e2bb3848b99027ff373009
|
||||
content/24: df354436708823f474ec0fc1cd363b3c
|
||||
content/25: f5fae0bbb4a96a36cda6feb280be5616
|
||||
content/26: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/27: cbbc03735b74fd325a091ed38fe04e9e
|
||||
content/28: bcadfc362b69078beee0088e5936c98b
|
||||
content/29: 95e0542011571ed7f06b49a4ae797954
|
||||
content/30: 807141bcd9f7eae7756fdc6c7f3806da
|
||||
content/31: cd7161901aeba94cb2ad2d99d22481f8
|
||||
content/32: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/33: f9e775fe3343f469407896cf20b547e6
|
||||
content/34: bcadfc362b69078beee0088e5936c98b
|
||||
content/35: b5e93d9a3d2d708d3b99e9d189c19646
|
||||
content/36: 179ccfc6418c245583fc29f53c15c39e
|
||||
content/37: 1087b0f7d5002dfa4c48eb546245c81d
|
||||
content/38: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/39: 239897f78db49f1283dc5a78538a2a06
|
||||
content/40: bcadfc362b69078beee0088e5936c98b
|
||||
content/41: d1b67021ac01a002ec893803e62ed45e
|
||||
content/42: df8777f6df9c498e1585ffb5dd830410
|
||||
content/43: d6c88c6b676978de09aa638118477ae3
|
||||
content/44: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/45: 2b306db45de9c58570b65d6cdcb6f247
|
||||
content/46: bcadfc362b69078beee0088e5936c98b
|
||||
content/47: a42eb9722e411fdbe979e2da1ce0b151
|
||||
content/48: f3216a0403673adcb4a519dbdcfd4f15
|
||||
content/49: 937ed84a57f0ae6f8d4e6ad43de884ea
|
||||
content/50: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/51: d723f832f4ecf3110fd9cba4846d4e2d
|
||||
content/52: bcadfc362b69078beee0088e5936c98b
|
||||
content/53: a42eb9722e411fdbe979e2da1ce0b151
|
||||
content/54: 61d9d10a79f2efadbf1a4620a6ab23d4
|
||||
content/55: 8882e6b7157c5c200aa8fed20a510697
|
||||
content/56: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/57: 44a38e8028982d5dbcb2f3c874fc9a61
|
||||
content/58: bcadfc362b69078beee0088e5936c98b
|
||||
content/59: 8b48d2809c6fa1801db032f00f6d3358
|
||||
content/60: 50559acbfd25cd27b2a089d7118752c5
|
||||
content/61: a3c1b2172bf5f755bb418a33af668049
|
||||
content/62: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/63: 215eb40066ac37e888a6f2e11350b43d
|
||||
content/64: bcadfc362b69078beee0088e5936c98b
|
||||
content/65: 2b3c80bcbce92fe344b5d92ace204b15
|
||||
content/66: 151113c0d69feef323a5b908914a7c26
|
||||
content/67: c858d6ce22f63c2b7e87889bbba17af8
|
||||
content/68: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/69: 7a7210108b3f95a91a6dd7ab05d540e5
|
||||
content/70: bcadfc362b69078beee0088e5936c98b
|
||||
content/71: 682c8f618848c1863ed7c349e1d2bd1e
|
||||
content/72: 29d7490bf106ad4aec4dac9ee0e03d8e
|
||||
content/73: e162edb4a88f5bb2772a6602061c5431
|
||||
content/74: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/75: 52b03f6ee6d9127d28c257b56798e115
|
||||
content/76: bcadfc362b69078beee0088e5936c98b
|
||||
content/77: 9faba3cf91d5594a2322f8312d081aef
|
||||
content/78: cdf86d7591c580bec3e74ae3a3693bef
|
||||
content/79: 3423a59063d9a61dd32733a60f93cff6
|
||||
content/80: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/81: 331770e146f9a6b6030dfb970d02cd40
|
||||
content/82: bcadfc362b69078beee0088e5936c98b
|
||||
content/83: 5144b9278e7aed0173286d6519681f92
|
||||
content/84: bd4c89e713278c619f95e5172e68d720
|
||||
content/85: 6694790c2343e744289bea26560c587d
|
||||
content/86: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/87: d12e5058c0c39696a7348b8e90805e15
|
||||
content/88: bcadfc362b69078beee0088e5936c98b
|
||||
content/89: 5144b9278e7aed0173286d6519681f92
|
||||
content/90: a7aeeb8f5eab372cb2fe1f733ccfc011
|
||||
content/91: 38a0744c3a333cf6914314dfee7cae6e
|
||||
content/92: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/93: e43952eea5785b1057955aa786dc886d
|
||||
content/94: bcadfc362b69078beee0088e5936c98b
|
||||
content/95: 6234f5259e8566496dc450b45a01d9d1
|
||||
content/96: bdb0431ec63f0513e6babe371ba64242
|
||||
content/97: 8970f32aeb56c03b00e2ade3c37a93fc
|
||||
content/98: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/99: 23aaf026b4d450b5bd6047e3acfe9a71
|
||||
content/100: bcadfc362b69078beee0088e5936c98b
|
||||
content/101: 7dec1de52492e6d0575c136baa1a8f92
|
||||
content/102: 22512b23811c21236e3ec39743e30267
|
||||
content/103: e70757a620b6d53b8232652c6f224100
|
||||
content/104: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/105: 84e1bbd2e9a45147bb63d122082e4e5b
|
||||
content/106: bcadfc362b69078beee0088e5936c98b
|
||||
content/107: acced4eaee40332522d797538a7c626f
|
||||
content/108: b3f310d5ef115bea5a8b75bf25d7ea9a
|
||||
content/109: 545417dfa5925e97177baf6f0bea938a
|
||||
f2d0730708c24f29942744f48297520b:
|
||||
meta/title: b0301322c66fcbf604c6988c11a8a0b6
|
||||
meta/description: 54233683a87a944c333d0a27a15f297e
|
||||
content/0: 1b031fb0c62c46b177aeed5c3d3f8f80
|
||||
content/1: 0aefa3b41a9d2ecaf2cfafe6818ed5d2
|
||||
content/2: 3f99340b6a2b22d8f91d8cabd457f4f5
|
||||
content/3: e64b467b3c7f0ade59c79c0a9a8da002
|
||||
content/4: a639faec4ba8d6237dd700c4c986f8cd
|
||||
content/5: 533ecdbe1ca2f2c741613ad29d92ec3a
|
||||
content/6: 856ec6f97e01acb2640d34a97299caee
|
||||
content/7: 821e6394b0a953e2b0842b04ae8f3105
|
||||
content/8: 57ea3ddd02ed5668f79c3943eeb3dc76
|
||||
content/9: 9c8aa3f09c9b2bd50ea4cdff3598ea4e
|
||||
content/10: 1dc07b63872647bf31f3a659eca63670
|
||||
content/11: d4f9d183b3eb7c221f2c407489a652c5
|
||||
content/12: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/13: f1d12e7ac02f81ccf00664735284675d
|
||||
content/14: bcadfc362b69078beee0088e5936c98b
|
||||
content/15: 388eb8cab2572fad0d8e65e48ad71644
|
||||
content/16: e4e994f0ae036ee5029a316e0daa5294
|
||||
content/17: 63b60341cc9c1b453e8596dd70e51f1b
|
||||
content/18: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/19: df1d35c7ecc90e9ed2658561aa90d530
|
||||
content/20: bcadfc362b69078beee0088e5936c98b
|
||||
content/21: 13df40111ce5ea2b93233798c40584e1
|
||||
content/22: 976dd71bcfd3d46c025abb54cdc55840
|
||||
content/23: d2af563f749bc199cb9680779f23bee8
|
||||
content/24: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/25: 5808af08b8e5d0ab78a1552500867be3
|
||||
content/26: bcadfc362b69078beee0088e5936c98b
|
||||
content/27: 678132234f320b948590cfe658b57c1d
|
||||
content/28: 9f67006276134ac8926b413a1d313885
|
||||
content/29: 0db8b422ae23ee6da45b980902ce258c
|
||||
content/30: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/31: e69d59f4199d43f83756b63ae881254f
|
||||
content/32: bcadfc362b69078beee0088e5936c98b
|
||||
content/33: f6096e61d6e1fd14969b9a71672ff3fd
|
||||
content/34: 46079dce2e875dfd4492ee61e3609bb6
|
||||
content/35: 97434ab9eddd245e0fe7b14ee242af6e
|
||||
content/36: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/37: d2d970ef7193db4c7358a08f580096a5
|
||||
content/38: bcadfc362b69078beee0088e5936c98b
|
||||
content/39: ba4a733914da618ac8e703d18d35b7ff
|
||||
content/40: 0ec0e400f9e3a1513126ad872ae2cfd1
|
||||
content/41: 9de50bb7fa9ef9e440680fba4022cfa7
|
||||
content/42: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/43: 8a34532b8d71279eb841adcd6df3f8bb
|
||||
content/44: bcadfc362b69078beee0088e5936c98b
|
||||
content/45: ef8d1c704e7355d1c5c495641f85abc6
|
||||
content/46: 8a30961afc7ff0df6da3b9fa24a06490
|
||||
content/47: c6c81afbd48ed9f53de42cc945011dc3
|
||||
content/48: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/49: e3722fb0dd04eaebcce70296b456acbc
|
||||
content/50: bcadfc362b69078beee0088e5936c98b
|
||||
content/51: 7f581ea28a88daa6235f93139c602778
|
||||
content/52: 18fbe27d3cd1f34db5fd225c07c5ed92
|
||||
content/53: 40c86fdce96ea2900fe530a7376b505c
|
||||
content/54: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/55: 94b2bd0c99bf1c4238a074ec656d5b95
|
||||
content/56: bcadfc362b69078beee0088e5936c98b
|
||||
content/57: d05d281cd29c0d01b05d59ae86fca97c
|
||||
content/58: b3f310d5ef115bea5a8b75bf25d7ea9a
|
||||
content/59: 944967ad6f93d68dcc558ed4c596007a
|
||||
245cfde62d1f4c088b441aeb697ba253:
|
||||
meta/title: f29b78f253094277c2e9ef79d10b5e4f
|
||||
meta/description: 46968f07e726825dfd597fae01d571b7
|
||||
content/0: 1b031fb0c62c46b177aeed5c3d3f8f80
|
||||
content/1: 46c206e964c4a6a8aa2aab9ad583d4b4
|
||||
content/2: 7a80ab974b86980eedf9c963682af79c
|
||||
content/3: 5707efa20a4903bed94356d557743546
|
||||
content/4: ebd030c32aef5a2dae774c4786fb6b62
|
||||
content/5: eb35ac44dc9c5e6d569b426251a7bdc7
|
||||
content/6: a14e113e70ac234065e31ab59bc82f8c
|
||||
content/7: 821e6394b0a953e2b0842b04ae8f3105
|
||||
content/8: 025c8bd1feda3927e30b54bdd27a61c6
|
||||
content/9: 9c8aa3f09c9b2bd50ea4cdff3598ea4e
|
||||
content/10: 35fd69ba2ad9468531fd35d31550ff24
|
||||
content/11: 0b70c103e0b75a1b268c4c1c2f6a65e1
|
||||
content/12: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/13: 667ede88de3709d56afc2109da5482e6
|
||||
content/14: bcadfc362b69078beee0088e5936c98b
|
||||
content/15: 0a7a099d582a926686c199dd7cc1f28c
|
||||
content/16: 57863aa36fddd82b172a2ebd415c0105
|
||||
content/17: b7f6f6c25d65128ca1e361a03dbdd000
|
||||
content/18: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/19: d71b6bb8e2dd6ce98101aec6a1dd77f2
|
||||
content/20: bcadfc362b69078beee0088e5936c98b
|
||||
content/21: 0a7a099d582a926686c199dd7cc1f28c
|
||||
content/22: b3f310d5ef115bea5a8b75bf25d7ea9a
|
||||
content/23: 5edfd3643d5fa96be8bdbdb3c6e6905d
|
||||
1d31f77eb0b1c63c6a30a0021a1c91a7:
|
||||
meta/title: 9f1084d4653cb60f1ce8db36f40496b0
|
||||
meta/description: 45de27663667ae7e6a583431fe4a5880
|
||||
content/0: 1b031fb0c62c46b177aeed5c3d3f8f80
|
||||
content/1: f0ca0a4c4900ee1d5b0f17ee3c533251
|
||||
content/2: 27d485e5e0595ae2bebb249da92db4e3
|
||||
content/3: 5a28d4a5bc7628a77a49b6e8691e6076
|
||||
content/4: b214a614c74fff80f2586a661afd4f7c
|
||||
content/5: c6085ddc45eb3065a8a9c2b88dcf92b2
|
||||
content/6: 5135d9bb78c3bb9a5c686b7a135ce499
|
||||
content/7: 88c9e9e37c52903912f0bd09ce6587f1
|
||||
content/8: 821e6394b0a953e2b0842b04ae8f3105
|
||||
content/9: 5cc5269dad965982af56eed8d1957036
|
||||
content/10: 9c8aa3f09c9b2bd50ea4cdff3598ea4e
|
||||
content/11: 8cc1d968c163eb0993c8cffe5142f9c4
|
||||
content/12: 1686853b699c5825bc3962ad4481dacb
|
||||
content/13: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/14: 6c217c31e3269045db51e0ca2e02dc40
|
||||
content/15: bcadfc362b69078beee0088e5936c98b
|
||||
content/16: 9a5ecda96a3113d95900df597cffc636
|
||||
content/17: e28cdc705de05af33fc86ed8d5d900d3
|
||||
content/18: 0e38f19d9fbfbd36051d2e5c7f65d0c0
|
||||
content/19: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/20: 9a0701ab299cc0a9bfd7b45f10c55449
|
||||
content/21: bcadfc362b69078beee0088e5936c98b
|
||||
content/22: 9a5ecda96a3113d95900df597cffc636
|
||||
content/23: b3f310d5ef115bea5a8b75bf25d7ea9a
|
||||
content/24: 052048d35cc259681ec571cb2a0ef40a
|
||||
3ba5675c103009fa6748b65637af354d:
|
||||
meta/title: 49dd6c21604b5e8d4153ff1aff2177e1
|
||||
meta/description: 88ab5b2b8f61ed1a63066181154fd8f8
|
||||
content/0: 1b031fb0c62c46b177aeed5c3d3f8f80
|
||||
content/1: 73f9a418f450bbae491b52737c9b2982
|
||||
content/2: 8fc2a3301b6fef2afa21759620b4bc33
|
||||
content/3: cd01d7f84456db76f6b47c88d4ad447f
|
||||
content/4: 7c3ae4ab9cdd0a7300cb613273b17ab2
|
||||
content/5: d7202506c9865536dd118962d21fdb80
|
||||
content/6: 821e6394b0a953e2b0842b04ae8f3105
|
||||
content/7: 4c7999d7c81740bdff526b4ae59d1d5a
|
||||
content/8: 9c8aa3f09c9b2bd50ea4cdff3598ea4e
|
||||
content/9: b175d6a78789313ce7504160d4070148
|
||||
content/10: 51b7b4e8d70b107a203dff9990e683c6
|
||||
content/11: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/12: 7e1661063806f676609f471d82e01a5c
|
||||
content/13: bcadfc362b69078beee0088e5936c98b
|
||||
content/14: 387026e7559d9305d0c39edb833e5dcc
|
||||
content/15: b3f310d5ef115bea5a8b75bf25d7ea9a
|
||||
content/16: 448c1ded449bcd1a71f9b589990e1e63
|
||||
0329dfb025ed7a18c4270a67b8e53e1d:
|
||||
meta/title: 985458a8500ac43c5066b77c5b7172a7
|
||||
meta/description: 3a9a5e355c6305088436e9e5295e5e74
|
||||
content/0: 1b031fb0c62c46b177aeed5c3d3f8f80
|
||||
content/1: 69eb63bb56f5c92f9a06a409fd06e127
|
||||
content/2: ceb73025bb48cd3988b5b75eef739ff8
|
||||
content/3: 155060ca67bead6a56e501f66d2a6f3e
|
||||
content/4: 7b84fdc9aa957bab919fe8e445a00127
|
||||
content/5: 35bef9915378b9fae2950c43b28d4c66
|
||||
content/6: c037e5ef2321d91a39c29c68b423e7d0
|
||||
content/7: 805694c6320ddd125301f4bd80948bc4
|
||||
content/8: 821e6394b0a953e2b0842b04ae8f3105
|
||||
content/9: 7b3b50d86217fa5327e2060db6dc79b1
|
||||
content/10: 9c8aa3f09c9b2bd50ea4cdff3598ea4e
|
||||
content/11: 4a83970297f02d066a140ace7a3ea574
|
||||
content/12: 3d0fd2cbd2fd3e61f4dfb545c979cc96
|
||||
content/13: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/14: c6324e539565645847c9b7dc307edbb7
|
||||
content/15: bcadfc362b69078beee0088e5936c98b
|
||||
content/16: d2ae8b29edb03c531de32ab61bdb8199
|
||||
content/17: afae946bba1f0a5067cdeacb54f5ff31
|
||||
content/18: 9a9d552a9a22b6bd6ee4817cf156548c
|
||||
content/19: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/20: 26c5931909354e24571974ccfd8e18f8
|
||||
content/21: bcadfc362b69078beee0088e5936c98b
|
||||
content/22: a6062bdeb33b01cee6c6341254b4f2ad
|
||||
content/23: 26f3623886a41211d0f929ea6877c370
|
||||
content/24: b7e6e86ed0a93dda08569bf6151ee889
|
||||
content/25: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/26: 00608072da9103c89fe5a185645516d0
|
||||
content/27: bcadfc362b69078beee0088e5936c98b
|
||||
content/28: 1afd7403b0fe00913c06e1d69761b7eb
|
||||
content/29: acf650b1fbe371415a38e1740cba105d
|
||||
content/30: 01f378c57892b72e3d2d275aca9eaadf
|
||||
content/31: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/32: abedb3d9f6ed8f86b76d315d08a2e42b
|
||||
content/33: bcadfc362b69078beee0088e5936c98b
|
||||
content/34: 8000c9a9f17a94f6145ebf73becfe558
|
||||
content/35: f4a9c229ff71084944a3a7684369a01f
|
||||
content/36: 7adc475d3c445bd57a77aedb9616da9a
|
||||
content/37: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/38: 48c59e09ee36b3d9af3313be2ae5c6d0
|
||||
content/39: bcadfc362b69078beee0088e5936c98b
|
||||
content/40: 59480e97be4e274ddfe5dd8d7f695f05
|
||||
content/41: b3f310d5ef115bea5a8b75bf25d7ea9a
|
||||
content/42: 901ec146345636911d3cc074b6ebfd74
|
||||
451a43cd6440c2447809c9fdc08c7829:
|
||||
meta/title: cf7ddc77722328e80e5c60d3f42d5577
|
||||
meta/description: b6a942fcfafc8821473cacceb558b1f2
|
||||
content/0: 1b031fb0c62c46b177aeed5c3d3f8f80
|
||||
content/1: 4cf45dd008600c03d0c0549a05110d19
|
||||
content/2: 1543a4668fafc72bbba8fe509d5dae57
|
||||
content/3: aac6c43b00d999ae7b17b75ef4dc4fc0
|
||||
content/4: d083836bb2cd4e5a2876b554e3cd4ae8
|
||||
content/5: f1fad0adc2cd25d9a94d5e8d3d275a95
|
||||
content/6: 228f96649fa48a0fd2d234d21670ce2f
|
||||
content/7: 5c2e954b6ee98bea3f3fc6245549c362
|
||||
content/8: 821e6394b0a953e2b0842b04ae8f3105
|
||||
content/9: b57dad4eb1172e3b0f53009b7d1da96e
|
||||
content/10: 9c8aa3f09c9b2bd50ea4cdff3598ea4e
|
||||
content/11: 8562eed524a2e830528798b198c96561
|
||||
content/12: 6d9d0007b39670c814a81d610501932e
|
||||
content/13: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/14: 6bf3965f5e253d978b652829301399dc
|
||||
content/15: bcadfc362b69078beee0088e5936c98b
|
||||
content/16: b7d1fb5e3ccc4a184957e304704a403a
|
||||
content/17: 808c733932b8cce795b7af43940d88fb
|
||||
content/18: bd99763a4125a2964039ae6220cfa9b8
|
||||
content/19: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/20: 058c6fe90a3d5d08068c818c6ab1bce1
|
||||
content/21: bcadfc362b69078beee0088e5936c98b
|
||||
content/22: 55600ea367d0b75b0d731dfafe3c4d03
|
||||
content/23: af471c6ba3cf808dc02acc3aa174c6ac
|
||||
content/24: 6cf95280ce4e38cbb1236063867bb681
|
||||
content/25: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/26: e8e70139db1670b1cce1a481ee6a4fec
|
||||
content/27: bcadfc362b69078beee0088e5936c98b
|
||||
content/28: f368f6303c8e1cd9670addb972c40dc7
|
||||
content/29: bc15e59ce2303dafb4f903468041ebfa
|
||||
content/30: 59c94fb79703463b63635dc5adf9dea8
|
||||
content/31: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/32: ff866c458970452e2d9d0b418ece0466
|
||||
content/33: bcadfc362b69078beee0088e5936c98b
|
||||
content/34: f368f6303c8e1cd9670addb972c40dc7
|
||||
content/35: 32e29c637f05979f7609c5275ad8b4d6
|
||||
content/36: 667d37e37c9f801b9aabe30ad900686d
|
||||
content/37: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/38: 7c963e0dcecc7000e73fa5a47a138953
|
||||
content/39: bcadfc362b69078beee0088e5936c98b
|
||||
content/40: 26051148e989cb79677c897f49d4f226
|
||||
content/41: 62cc98976187ecb6d598f16648eb4604
|
||||
content/42: e095759a2cc2de3b86130dfc21e87ff9
|
||||
content/43: 371d0e46b4bd2c23f559b8bc112f6955
|
||||
content/44: f5084008138beb64b1321b1bff0b6ccd
|
||||
content/45: bcadfc362b69078beee0088e5936c98b
|
||||
content/46: 1696af7fda8206f857591de089cea25c
|
||||
content/47: b3f310d5ef115bea5a8b75bf25d7ea9a
|
||||
content/48: 076d05c494cf5c494ed98e011b27b289
|
||||
|
||||
@@ -14,6 +14,7 @@ NEXT_PUBLIC_APP_URL=http://localhost:3000
|
||||
# Security (Required)
|
||||
ENCRYPTION_KEY=your_encryption_key # Use `openssl rand -hex 32` to generate, used to encrypt environment variables
|
||||
INTERNAL_API_SECRET=your_internal_api_secret # Use `openssl rand -hex 32` to generate, used to encrypt internal api routes
|
||||
API_ENCRYPTION_KEY=your_api_encryption_key # Use `openssl rand -hex 32` to generate, used to encrypt api keys
|
||||
|
||||
# Email Provider (Optional)
|
||||
# RESEND_API_KEY= # Uncomment and add your key from https://resend.com to send actual emails
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
|
||||
const DEFAULT_STARS = '15.4k'
|
||||
const DEFAULT_STARS = '18.6k'
|
||||
|
||||
const logger = createLogger('GitHubStars')
|
||||
|
||||
export async function getFormattedGitHubStars(): Promise<string> {
|
||||
try {
|
||||
const response = await fetch('/api/github-stars', {
|
||||
const response = await fetch('/api/stars', {
|
||||
headers: {
|
||||
'Cache-Control': 'max-age=3600', // Cache for 1 hour
|
||||
},
|
||||
|
||||
@@ -0,0 +1,26 @@
|
||||
import Image from 'next/image'
|
||||
import Link from 'next/link'
|
||||
import { HIPAABadgeIcon } from '@/components/icons'
|
||||
|
||||
export default function ComplianceBadges() {
|
||||
return (
|
||||
<div className='mt-[6px] flex items-center gap-[12px]'>
|
||||
{/* SOC2 badge */}
|
||||
<Link href='https://trust.delve.co/sim-studio' target='_blank' rel='noopener noreferrer'>
|
||||
<Image
|
||||
src='/footer/soc2.png'
|
||||
alt='SOC2 Compliant'
|
||||
width={54}
|
||||
height={54}
|
||||
className='object-contain'
|
||||
loading='lazy'
|
||||
quality={75}
|
||||
/>
|
||||
</Link>
|
||||
{/* HIPAA badge */}
|
||||
<Link href='https://trust.delve.co/sim-studio' target='_blank' rel='noopener noreferrer'>
|
||||
<HIPAABadgeIcon className='h-[54px] w-[54px]' />
|
||||
</Link>
|
||||
</div>
|
||||
)
|
||||
}
|
||||
@@ -0,0 +1,6 @@
|
||||
import ComplianceBadges from './compliance-badges'
|
||||
import Logo from './logo'
|
||||
import SocialLinks from './social-links'
|
||||
import StatusIndicator from './status-indicator'
|
||||
|
||||
export { ComplianceBadges, Logo, SocialLinks, StatusIndicator }
|
||||
17
apps/sim/app/(landing)/components/footer/components/logo.tsx
Normal file
17
apps/sim/app/(landing)/components/footer/components/logo.tsx
Normal file
@@ -0,0 +1,17 @@
|
||||
import Image from 'next/image'
|
||||
import Link from 'next/link'
|
||||
|
||||
export default function Logo() {
|
||||
return (
|
||||
<Link href='/' aria-label='Sim home'>
|
||||
<Image
|
||||
src='/logo/b&w/text/b&w.svg'
|
||||
alt='Sim - Workflows for LLMs'
|
||||
width={49.78314}
|
||||
height={24.276}
|
||||
priority
|
||||
quality={90}
|
||||
/>
|
||||
</Link>
|
||||
)
|
||||
}
|
||||
@@ -0,0 +1,44 @@
|
||||
import { DiscordIcon, GithubIcon, LinkedInIcon, xIcon as XIcon } from '@/components/icons'
|
||||
|
||||
export default function SocialLinks() {
|
||||
return (
|
||||
<div className='flex items-center gap-[12px]'>
|
||||
<a
|
||||
href='https://discord.gg/Hr4UWYEcTT'
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className='flex items-center text-[16px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
aria-label='Discord'
|
||||
>
|
||||
<DiscordIcon className='h-[20px] w-[20px]' aria-hidden='true' />
|
||||
</a>
|
||||
<a
|
||||
href='https://x.com/simdotai'
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className='flex items-center text-[16px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
aria-label='X (Twitter)'
|
||||
>
|
||||
<XIcon className='h-[18px] w-[18px]' aria-hidden='true' />
|
||||
</a>
|
||||
<a
|
||||
href='https://www.linkedin.com/company/simstudioai/'
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className='flex items-center text-[16px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
aria-label='LinkedIn'
|
||||
>
|
||||
<LinkedInIcon className='h-[18px] w-[18px]' aria-hidden='true' />
|
||||
</a>
|
||||
<a
|
||||
href='https://github.com/simstudioai/sim'
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className='flex items-center text-[16px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
aria-label='GitHub'
|
||||
>
|
||||
<GithubIcon className='h-[20px] w-[20px]' aria-hidden='true' />
|
||||
</a>
|
||||
</div>
|
||||
)
|
||||
}
|
||||
@@ -0,0 +1,69 @@
|
||||
'use client'
|
||||
|
||||
import type { SVGProps } from 'react'
|
||||
import Link from 'next/link'
|
||||
import type { StatusType } from '@/app/api/status/types'
|
||||
import { useStatus } from '@/hooks/queries/status'
|
||||
|
||||
interface StatusDotIconProps extends SVGProps<SVGSVGElement> {
|
||||
status: 'operational' | 'degraded' | 'outage' | 'maintenance' | 'loading' | 'error'
|
||||
}
|
||||
|
||||
export function StatusDotIcon({ status, className, ...props }: StatusDotIconProps) {
|
||||
const colors = {
|
||||
operational: '#10B981',
|
||||
degraded: '#F59E0B',
|
||||
outage: '#EF4444',
|
||||
maintenance: '#3B82F6',
|
||||
loading: '#9CA3AF',
|
||||
error: '#9CA3AF',
|
||||
}
|
||||
|
||||
return (
|
||||
<svg
|
||||
xmlns='http://www.w3.org/2000/svg'
|
||||
width={6}
|
||||
height={6}
|
||||
viewBox='0 0 6 6'
|
||||
fill='none'
|
||||
className={className}
|
||||
{...props}
|
||||
>
|
||||
<circle cx={3} cy={3} r={3} fill={colors[status]} />
|
||||
</svg>
|
||||
)
|
||||
}
|
||||
|
||||
const STATUS_COLORS: Record<StatusType, string> = {
|
||||
operational: 'text-[#10B981] hover:text-[#059669]',
|
||||
degraded: 'text-[#F59E0B] hover:text-[#D97706]',
|
||||
outage: 'text-[#EF4444] hover:text-[#DC2626]',
|
||||
maintenance: 'text-[#3B82F6] hover:text-[#2563EB]',
|
||||
loading: 'text-muted-foreground hover:text-foreground',
|
||||
error: 'text-muted-foreground hover:text-foreground',
|
||||
}
|
||||
|
||||
export default function StatusIndicator() {
|
||||
const { data, isLoading, isError } = useStatus()
|
||||
|
||||
const status = isLoading ? 'loading' : isError ? 'error' : data?.status || 'error'
|
||||
const message = isLoading
|
||||
? 'Checking Status...'
|
||||
: isError
|
||||
? 'Status Unknown'
|
||||
: data?.message || 'Status Unknown'
|
||||
const statusUrl = data?.url || 'https://status.sim.ai'
|
||||
|
||||
return (
|
||||
<Link
|
||||
href={statusUrl}
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className={`flex items-center gap-[6px] whitespace-nowrap text-[12px] transition-colors ${STATUS_COLORS[status]}`}
|
||||
aria-label={`System status: ${message}`}
|
||||
>
|
||||
<StatusDotIcon status={status} className='h-[6px] w-[6px]' aria-hidden='true' />
|
||||
<span>{message}</span>
|
||||
</Link>
|
||||
)
|
||||
}
|
||||
96
apps/sim/app/(landing)/components/footer/consts.ts
Normal file
96
apps/sim/app/(landing)/components/footer/consts.ts
Normal file
@@ -0,0 +1,96 @@
|
||||
export const FOOTER_BLOCKS = [
|
||||
'Agent',
|
||||
'API',
|
||||
'Condition',
|
||||
'Evaluator',
|
||||
'Function',
|
||||
'Human In The Loop',
|
||||
'Loop',
|
||||
'Parallel',
|
||||
'Response',
|
||||
'Router',
|
||||
'Starter',
|
||||
'Webhook',
|
||||
'Workflow',
|
||||
]
|
||||
|
||||
export const FOOTER_TOOLS = [
|
||||
'Airtable',
|
||||
'Apify',
|
||||
'Apollo',
|
||||
'ArXiv',
|
||||
'Browser Use',
|
||||
'Calendly',
|
||||
'Clay',
|
||||
'Confluence',
|
||||
'Discord',
|
||||
'ElevenLabs',
|
||||
'Exa',
|
||||
'Firecrawl',
|
||||
'GitHub',
|
||||
'Gmail',
|
||||
'Google Drive',
|
||||
'Guardrails',
|
||||
'HubSpot',
|
||||
'HuggingFace',
|
||||
'Hunter',
|
||||
'Incidentio',
|
||||
'Intercom',
|
||||
'Jina',
|
||||
'Jira',
|
||||
'Knowledge',
|
||||
'Linear',
|
||||
'LinkUp',
|
||||
'LinkedIn',
|
||||
'Mailchimp',
|
||||
'Mailgun',
|
||||
'MCP',
|
||||
'Mem0',
|
||||
'Microsoft Excel',
|
||||
'Microsoft Planner',
|
||||
'Microsoft Teams',
|
||||
'Mistral Parse',
|
||||
'MongoDB',
|
||||
'MySQL',
|
||||
'Neo4j',
|
||||
'Notion',
|
||||
'OneDrive',
|
||||
'OpenAI',
|
||||
'Outlook',
|
||||
'Parallel AI',
|
||||
'Perplexity',
|
||||
'Pinecone',
|
||||
'Pipedrive',
|
||||
'PostHog',
|
||||
'PostgreSQL',
|
||||
'Pylon',
|
||||
'Qdrant',
|
||||
'Reddit',
|
||||
'Resend',
|
||||
'S3',
|
||||
'Salesforce',
|
||||
'SendGrid',
|
||||
'Serper',
|
||||
'SharePoint',
|
||||
'Slack',
|
||||
'Smtp',
|
||||
'Stagehand',
|
||||
'Stripe',
|
||||
'Supabase',
|
||||
'Tavily',
|
||||
'Telegram',
|
||||
'Translate',
|
||||
'Trello',
|
||||
'Twilio',
|
||||
'Typeform',
|
||||
'Vision',
|
||||
'Wait',
|
||||
'Wealthbox',
|
||||
'Webflow',
|
||||
'WhatsApp',
|
||||
'Wikipedia',
|
||||
'X',
|
||||
'YouTube',
|
||||
'Zendesk',
|
||||
'Zep',
|
||||
]
|
||||
@@ -1,97 +1,12 @@
|
||||
import Image from 'next/image'
|
||||
import Link from 'next/link'
|
||||
import {
|
||||
DiscordIcon,
|
||||
GithubIcon,
|
||||
HIPAABadgeIcon,
|
||||
LinkedInIcon,
|
||||
xIcon as XIcon,
|
||||
} from '@/components/icons'
|
||||
import { inter } from '@/app/_styles/fonts/inter/inter'
|
||||
|
||||
const blocks = [
|
||||
'Agent',
|
||||
'API',
|
||||
'Condition',
|
||||
'Evaluator',
|
||||
'Function',
|
||||
'Loop',
|
||||
'Parallel',
|
||||
'Response',
|
||||
'Router',
|
||||
'Starter',
|
||||
'Webhook',
|
||||
'Workflow',
|
||||
]
|
||||
|
||||
const tools = [
|
||||
'Airtable',
|
||||
'ArXiv',
|
||||
'Browser Use',
|
||||
'Clay',
|
||||
'Confluence',
|
||||
'Discord',
|
||||
'ElevenLabs',
|
||||
'Exa',
|
||||
'File',
|
||||
'Firecrawl',
|
||||
'Generic Webhook',
|
||||
'GitHub',
|
||||
'Gmail',
|
||||
'Google Calendar',
|
||||
'Google Docs',
|
||||
'Google Drive',
|
||||
'Google Vault',
|
||||
'Google Search',
|
||||
'Google Sheets',
|
||||
'HuggingFace',
|
||||
'Hunter',
|
||||
'Image Generator',
|
||||
'Jina',
|
||||
'Jira',
|
||||
'Knowledge',
|
||||
'Linear',
|
||||
'LinkUp',
|
||||
'Mem0',
|
||||
'Memory',
|
||||
'Microsoft Excel',
|
||||
'Microsoft Planner',
|
||||
'Microsoft Teams',
|
||||
'Mistral Parse',
|
||||
'MySQL',
|
||||
'Notion',
|
||||
'OneDrive',
|
||||
'OpenAI',
|
||||
'Outlook',
|
||||
'Parallel AI',
|
||||
'Perplexity',
|
||||
'Pinecone',
|
||||
'PostgreSQL',
|
||||
'Qdrant',
|
||||
'Reddit',
|
||||
'S3',
|
||||
'Schedule',
|
||||
'Serper',
|
||||
'SharePoint',
|
||||
'Slack',
|
||||
'Stagehand',
|
||||
'Stagehand Agent',
|
||||
'Supabase',
|
||||
'Tavily',
|
||||
'Telegram',
|
||||
'Thinking',
|
||||
'Translate',
|
||||
'Twilio SMS',
|
||||
'Typeform',
|
||||
'Vision',
|
||||
'Wealthbox',
|
||||
'Webhook',
|
||||
'WhatsApp',
|
||||
'Wikipedia',
|
||||
'X',
|
||||
'YouTube',
|
||||
'Zep',
|
||||
]
|
||||
import {
|
||||
ComplianceBadges,
|
||||
Logo,
|
||||
SocialLinks,
|
||||
StatusIndicator,
|
||||
} from '@/app/(landing)/components/footer/components'
|
||||
import { FOOTER_BLOCKS, FOOTER_TOOLS } from '@/app/(landing)/components/footer/consts'
|
||||
|
||||
interface FooterProps {
|
||||
fullWidth?: boolean
|
||||
@@ -110,84 +25,10 @@ export default function Footer({ fullWidth = false }: FooterProps) {
|
||||
<div className={`flex gap-[80px] ${fullWidth ? 'justify-center' : ''}`}>
|
||||
{/* Logo and social links */}
|
||||
<div className='flex flex-col gap-[24px]'>
|
||||
<Link href='/' aria-label='Sim home'>
|
||||
<Image
|
||||
src='/logo/b&w/text/b&w.svg'
|
||||
alt='Sim - Workflows for LLMs'
|
||||
width={49.78314}
|
||||
height={24.276}
|
||||
priority
|
||||
quality={90}
|
||||
/>
|
||||
</Link>
|
||||
|
||||
{/* Social links */}
|
||||
<div className='flex items-center gap-[12px]'>
|
||||
<a
|
||||
href='https://discord.gg/Hr4UWYEcTT'
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className='flex items-center text-[16px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
aria-label='Discord'
|
||||
>
|
||||
<DiscordIcon className='h-[20px] w-[20px]' aria-hidden='true' />
|
||||
</a>
|
||||
<a
|
||||
href='https://x.com/simdotai'
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className='flex items-center text-[16px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
aria-label='X (Twitter)'
|
||||
>
|
||||
<XIcon className='h-[18px] w-[18px]' aria-hidden='true' />
|
||||
</a>
|
||||
<a
|
||||
href='https://www.linkedin.com/company/simstudioai/'
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className='flex items-center text-[16px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
aria-label='LinkedIn'
|
||||
>
|
||||
<LinkedInIcon className='h-[18px] w-[18px]' aria-hidden='true' />
|
||||
</a>
|
||||
<a
|
||||
href='https://github.com/simstudioai/sim'
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className='flex items-center text-[16px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
aria-label='GitHub'
|
||||
>
|
||||
<GithubIcon className='h-[20px] w-[20px]' aria-hidden='true' />
|
||||
</a>
|
||||
</div>
|
||||
|
||||
{/* Compliance badges */}
|
||||
<div className='mt-[6px] flex items-center gap-[12px]'>
|
||||
{/* SOC2 badge */}
|
||||
<Link
|
||||
href='https://trust.delve.co/sim-studio'
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
>
|
||||
<Image
|
||||
src='/footer/soc2.png'
|
||||
alt='SOC2 Compliant'
|
||||
width={54}
|
||||
height={54}
|
||||
className='object-contain'
|
||||
loading='lazy'
|
||||
quality={75}
|
||||
/>
|
||||
</Link>
|
||||
{/* HIPAA badge placeholder - add when available */}
|
||||
<Link
|
||||
href='https://trust.delve.co/sim-studio'
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
>
|
||||
<HIPAABadgeIcon className='h-[54px] w-[54px]' />
|
||||
</Link>
|
||||
</div>
|
||||
<Logo />
|
||||
<SocialLinks />
|
||||
<ComplianceBadges />
|
||||
<StatusIndicator />
|
||||
</div>
|
||||
|
||||
{/* Links section */}
|
||||
@@ -228,6 +69,14 @@ export default function Footer({ fullWidth = false }: FooterProps) {
|
||||
>
|
||||
Changelog
|
||||
</Link>
|
||||
<Link
|
||||
href='https://status.sim.ai'
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className='text-[14px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
>
|
||||
Status
|
||||
</Link>
|
||||
<Link
|
||||
href='/careers'
|
||||
className='text-[14px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
@@ -257,7 +106,7 @@ export default function Footer({ fullWidth = false }: FooterProps) {
|
||||
<div className='hidden sm:block'>
|
||||
<h2 className='mb-[16px] font-medium text-[14px] text-foreground'>Blocks</h2>
|
||||
<div className='flex flex-col gap-[12px]'>
|
||||
{blocks.map((block) => (
|
||||
{FOOTER_BLOCKS.map((block) => (
|
||||
<Link
|
||||
key={block}
|
||||
href={`https://docs.sim.ai/blocks/${block.toLowerCase().replace(' ', '-')}`}
|
||||
@@ -277,7 +126,7 @@ export default function Footer({ fullWidth = false }: FooterProps) {
|
||||
<div className='flex gap-[80px]'>
|
||||
{/* First column */}
|
||||
<div className='flex flex-col gap-[12px]'>
|
||||
{tools.slice(0, Math.ceil(tools.length / 4)).map((tool) => (
|
||||
{FOOTER_TOOLS.slice(0, Math.ceil(FOOTER_TOOLS.length / 4)).map((tool) => (
|
||||
<Link
|
||||
key={tool}
|
||||
href={`https://docs.sim.ai/tools/${tool.toLowerCase().replace(/\s+/g, '_')}`}
|
||||
@@ -291,39 +140,41 @@ export default function Footer({ fullWidth = false }: FooterProps) {
|
||||
</div>
|
||||
{/* Second column */}
|
||||
<div className='flex flex-col gap-[12px]'>
|
||||
{tools
|
||||
.slice(Math.ceil(tools.length / 4), Math.ceil((tools.length * 2) / 4))
|
||||
.map((tool) => (
|
||||
<Link
|
||||
key={tool}
|
||||
href={`https://docs.sim.ai/tools/${tool.toLowerCase().replace(/\s+/g, '_')}`}
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className='whitespace-nowrap text-[14px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
>
|
||||
{tool}
|
||||
</Link>
|
||||
))}
|
||||
{FOOTER_TOOLS.slice(
|
||||
Math.ceil(FOOTER_TOOLS.length / 4),
|
||||
Math.ceil((FOOTER_TOOLS.length * 2) / 4)
|
||||
).map((tool) => (
|
||||
<Link
|
||||
key={tool}
|
||||
href={`https://docs.sim.ai/tools/${tool.toLowerCase().replace(/\s+/g, '_')}`}
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className='whitespace-nowrap text-[14px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
>
|
||||
{tool}
|
||||
</Link>
|
||||
))}
|
||||
</div>
|
||||
{/* Third column */}
|
||||
<div className='flex flex-col gap-[12px]'>
|
||||
{tools
|
||||
.slice(Math.ceil((tools.length * 2) / 4), Math.ceil((tools.length * 3) / 4))
|
||||
.map((tool) => (
|
||||
<Link
|
||||
key={tool}
|
||||
href={`https://docs.sim.ai/tools/${tool.toLowerCase().replace(/\s+/g, '_')}`}
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className='whitespace-nowrap text-[14px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
>
|
||||
{tool}
|
||||
</Link>
|
||||
))}
|
||||
{FOOTER_TOOLS.slice(
|
||||
Math.ceil((FOOTER_TOOLS.length * 2) / 4),
|
||||
Math.ceil((FOOTER_TOOLS.length * 3) / 4)
|
||||
).map((tool) => (
|
||||
<Link
|
||||
key={tool}
|
||||
href={`https://docs.sim.ai/tools/${tool.toLowerCase().replace(/\s+/g, '_')}`}
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
className='whitespace-nowrap text-[14px] text-muted-foreground transition-colors hover:text-foreground'
|
||||
>
|
||||
{tool}
|
||||
</Link>
|
||||
))}
|
||||
</div>
|
||||
{/* Fourth column */}
|
||||
<div className='flex flex-col gap-[12px]'>
|
||||
{tools.slice(Math.ceil((tools.length * 3) / 4)).map((tool) => (
|
||||
{FOOTER_TOOLS.slice(Math.ceil((FOOTER_TOOLS.length * 3) / 4)).map((tool) => (
|
||||
<Link
|
||||
key={tool}
|
||||
href={`https://docs.sim.ai/tools/${tool.toLowerCase().replace(/\s+/g, '_')}`}
|
||||
|
||||
@@ -20,7 +20,7 @@ interface NavProps {
|
||||
}
|
||||
|
||||
export default function Nav({ hideAuthButtons = false, variant = 'landing' }: NavProps = {}) {
|
||||
const [githubStars, setGithubStars] = useState('18.5k')
|
||||
const [githubStars, setGithubStars] = useState('18.6k')
|
||||
const [isHovered, setIsHovered] = useState(false)
|
||||
const [isLoginHovered, setIsLoginHovered] = useState(false)
|
||||
const router = useRouter()
|
||||
|
||||
159
apps/sim/app/api/admin/import-workflow/route.ts
Normal file
159
apps/sim/app/api/admin/import-workflow/route.ts
Normal file
@@ -0,0 +1,159 @@
|
||||
import { db } from '@sim/db'
|
||||
import { user, workflow, workflowDeploymentVersion } from '@sim/db/schema'
|
||||
import { and, eq } from 'drizzle-orm'
|
||||
import { type NextRequest, NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { getSession } from '@/lib/auth'
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
import { generateRequestId } from '@/lib/utils'
|
||||
import { loadWorkflowFromNormalizedTables } from '@/lib/workflows/db-helpers'
|
||||
import { sanitizeForExport } from '@/lib/workflows/json-sanitizer'
|
||||
|
||||
const logger = createLogger('AdminImportWorkflowAPI')
|
||||
|
||||
const ImportWorkflowSchema = z.object({
|
||||
workflowId: z.string().min(1, 'Workflow ID is required'),
|
||||
targetWorkspaceId: z.string().min(1, 'Target workspace ID is required'),
|
||||
deploymentVersion: z.number().int().positive().optional(),
|
||||
})
|
||||
|
||||
/**
|
||||
* POST /api/admin/import-workflow
|
||||
* Export a workflow from database by ID (superuser only)
|
||||
*/
|
||||
export async function POST(request: NextRequest) {
|
||||
const requestId = generateRequestId()
|
||||
|
||||
try {
|
||||
const session = await getSession()
|
||||
if (!session?.user?.id) {
|
||||
logger.warn(`[${requestId}] Unauthorized import attempt`)
|
||||
return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
|
||||
}
|
||||
|
||||
// Check if user is superuser
|
||||
const currentUser = await db
|
||||
.select({ isSuperUser: user.isSuperUser })
|
||||
.from(user)
|
||||
.where(eq(user.id, session.user.id))
|
||||
.limit(1)
|
||||
|
||||
if (!currentUser[0]?.isSuperUser) {
|
||||
logger.warn(`[${requestId}] Non-superuser attempted workflow import: ${session.user.id}`)
|
||||
return NextResponse.json({ error: 'Forbidden - Superuser access required' }, { status: 403 })
|
||||
}
|
||||
|
||||
const body = await request.json()
|
||||
const validation = ImportWorkflowSchema.safeParse(body)
|
||||
|
||||
if (!validation.success) {
|
||||
return NextResponse.json(
|
||||
{ error: 'Invalid request', details: validation.error.errors },
|
||||
{ status: 400 }
|
||||
)
|
||||
}
|
||||
|
||||
const { workflowId, targetWorkspaceId, deploymentVersion } = validation.data
|
||||
|
||||
// Fetch workflow metadata
|
||||
const [workflowData] = await db
|
||||
.select()
|
||||
.from(workflow)
|
||||
.where(eq(workflow.id, workflowId))
|
||||
.limit(1)
|
||||
|
||||
if (!workflowData) {
|
||||
return NextResponse.json({ error: 'Workflow not found' }, { status: 404 })
|
||||
}
|
||||
|
||||
let workflowState: any
|
||||
let sourceLabel = 'current state'
|
||||
|
||||
if (deploymentVersion !== undefined) {
|
||||
// Load from deployment version
|
||||
const [deployedVersion] = await db
|
||||
.select({ state: workflowDeploymentVersion.state })
|
||||
.from(workflowDeploymentVersion)
|
||||
.where(
|
||||
and(
|
||||
eq(workflowDeploymentVersion.workflowId, workflowId),
|
||||
eq(workflowDeploymentVersion.version, deploymentVersion)
|
||||
)
|
||||
)
|
||||
.limit(1)
|
||||
|
||||
if (!deployedVersion?.state) {
|
||||
return NextResponse.json({ error: `Deployment version ${deploymentVersion} not found` }, { status: 404 })
|
||||
}
|
||||
|
||||
const deployedState = deployedVersion.state as any
|
||||
workflowState = {
|
||||
blocks: deployedState.blocks || {},
|
||||
edges: Array.isArray(deployedState.edges) ? deployedState.edges : [],
|
||||
loops: deployedState.loops || {},
|
||||
parallels: deployedState.parallels || {},
|
||||
metadata: {
|
||||
name: workflowData.name,
|
||||
description: workflowData.description ?? undefined,
|
||||
color: workflowData.color ?? undefined,
|
||||
},
|
||||
variables: Array.isArray(deployedState.variables) ? deployedState.variables : [],
|
||||
}
|
||||
sourceLabel = `deployment v${deploymentVersion}`
|
||||
} else {
|
||||
// Load current state from normalized tables
|
||||
const normalizedData = await loadWorkflowFromNormalizedTables(workflowId)
|
||||
|
||||
if (!normalizedData) {
|
||||
return NextResponse.json({ error: 'Workflow has no data' }, { status: 404 })
|
||||
}
|
||||
|
||||
let workflowVariables: any[] = []
|
||||
if (workflowData.variables && typeof workflowData.variables === 'object') {
|
||||
workflowVariables = Object.values(workflowData.variables).map((v: any) => ({
|
||||
id: v.id,
|
||||
name: v.name,
|
||||
type: v.type,
|
||||
value: v.value,
|
||||
}))
|
||||
}
|
||||
|
||||
workflowState = {
|
||||
blocks: normalizedData.blocks || {},
|
||||
edges: Array.isArray(normalizedData.edges) ? normalizedData.edges : [],
|
||||
loops: normalizedData.loops || {},
|
||||
parallels: normalizedData.parallels || {},
|
||||
metadata: {
|
||||
name: workflowData.name,
|
||||
description: workflowData.description ?? undefined,
|
||||
color: workflowData.color ?? undefined,
|
||||
},
|
||||
variables: workflowVariables,
|
||||
}
|
||||
}
|
||||
|
||||
const exportState = sanitizeForExport(workflowState)
|
||||
|
||||
logger.info(`[${requestId}] Exported workflow ${workflowId} (${sourceLabel})`)
|
||||
|
||||
return NextResponse.json({
|
||||
success: true,
|
||||
workflow: exportState,
|
||||
metadata: {
|
||||
originalId: workflowId,
|
||||
originalName: workflowData.name,
|
||||
originalDescription: workflowData.description,
|
||||
targetWorkspaceId,
|
||||
deploymentVersion: deploymentVersion ?? null,
|
||||
source: sourceLabel,
|
||||
},
|
||||
})
|
||||
} catch (error) {
|
||||
logger.error(`[${requestId}] Error importing workflow:`, error)
|
||||
return NextResponse.json(
|
||||
{ error: 'Failed to import workflow' },
|
||||
{ status: 500 }
|
||||
)
|
||||
}
|
||||
}
|
||||
|
||||
65
apps/sim/app/api/admin/workflow-deployments/route.ts
Normal file
65
apps/sim/app/api/admin/workflow-deployments/route.ts
Normal file
@@ -0,0 +1,65 @@
|
||||
import { db } from '@sim/db'
|
||||
import { user, workflowDeploymentVersion } from '@sim/db/schema'
|
||||
import { desc, eq } from 'drizzle-orm'
|
||||
import { type NextRequest, NextResponse } from 'next/server'
|
||||
import { getSession } from '@/lib/auth'
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
import { generateRequestId } from '@/lib/utils'
|
||||
|
||||
const logger = createLogger('AdminWorkflowDeploymentsAPI')
|
||||
|
||||
/**
|
||||
* GET /api/admin/workflow-deployments?workflowId=xxx
|
||||
* List all deployment versions for a workflow (superuser only)
|
||||
*/
|
||||
export async function GET(request: NextRequest) {
|
||||
const requestId = generateRequestId()
|
||||
|
||||
try {
|
||||
const session = await getSession()
|
||||
if (!session?.user?.id) {
|
||||
return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
|
||||
}
|
||||
|
||||
// Check if user is superuser
|
||||
const currentUser = await db
|
||||
.select({ isSuperUser: user.isSuperUser })
|
||||
.from(user)
|
||||
.where(eq(user.id, session.user.id))
|
||||
.limit(1)
|
||||
|
||||
if (!currentUser[0]?.isSuperUser) {
|
||||
return NextResponse.json({ error: 'Forbidden - Superuser access required' }, { status: 403 })
|
||||
}
|
||||
|
||||
const { searchParams } = new URL(request.url)
|
||||
const workflowId = searchParams.get('workflowId')
|
||||
|
||||
if (!workflowId) {
|
||||
return NextResponse.json({ error: 'workflowId query parameter is required' }, { status: 400 })
|
||||
}
|
||||
|
||||
const versions = await db
|
||||
.select({
|
||||
id: workflowDeploymentVersion.id,
|
||||
version: workflowDeploymentVersion.version,
|
||||
name: workflowDeploymentVersion.name,
|
||||
isActive: workflowDeploymentVersion.isActive,
|
||||
createdAt: workflowDeploymentVersion.createdAt,
|
||||
createdBy: workflowDeploymentVersion.createdBy,
|
||||
deployedBy: user.name,
|
||||
})
|
||||
.from(workflowDeploymentVersion)
|
||||
.leftJoin(user, eq(workflowDeploymentVersion.createdBy, user.id))
|
||||
.where(eq(workflowDeploymentVersion.workflowId, workflowId))
|
||||
.orderBy(desc(workflowDeploymentVersion.version))
|
||||
|
||||
logger.info(`[${requestId}] Retrieved ${versions.length} deployments for workflow ${workflowId}`)
|
||||
|
||||
return NextResponse.json({ success: true, versions })
|
||||
} catch (error) {
|
||||
logger.error(`[${requestId}] Error listing deployments:`, error)
|
||||
return NextResponse.json({ error: 'Failed to list deployments' }, { status: 500 })
|
||||
}
|
||||
}
|
||||
|
||||
@@ -6,6 +6,23 @@
|
||||
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
|
||||
import { createMockRequest } from '@/app/api/__test-utils__/utils'
|
||||
|
||||
const createMockStream = () => {
|
||||
return new ReadableStream({
|
||||
start(controller) {
|
||||
controller.enqueue(
|
||||
new TextEncoder().encode('data: {"blockId":"agent-1","chunk":"Hello"}\n\n')
|
||||
)
|
||||
controller.enqueue(
|
||||
new TextEncoder().encode('data: {"blockId":"agent-1","chunk":" world"}\n\n')
|
||||
)
|
||||
controller.enqueue(
|
||||
new TextEncoder().encode('data: {"event":"final","data":{"success":true}}\n\n')
|
||||
)
|
||||
controller.close()
|
||||
},
|
||||
})
|
||||
}
|
||||
|
||||
vi.mock('@/lib/execution/preprocessing', () => ({
|
||||
preprocessExecution: vi.fn().mockResolvedValue({
|
||||
success: true,
|
||||
@@ -36,28 +53,37 @@ vi.mock('@/lib/logs/execution/logging-session', () => ({
|
||||
})),
|
||||
}))
|
||||
|
||||
describe('Chat Identifier API Route', () => {
|
||||
const createMockStream = () => {
|
||||
return new ReadableStream({
|
||||
start(controller) {
|
||||
controller.enqueue(
|
||||
new TextEncoder().encode('data: {"blockId":"agent-1","chunk":"Hello"}\n\n')
|
||||
)
|
||||
controller.enqueue(
|
||||
new TextEncoder().encode('data: {"blockId":"agent-1","chunk":" world"}\n\n')
|
||||
)
|
||||
controller.enqueue(
|
||||
new TextEncoder().encode('data: {"event":"final","data":{"success":true}}\n\n')
|
||||
)
|
||||
controller.close()
|
||||
},
|
||||
})
|
||||
}
|
||||
vi.mock('@/lib/workflows/streaming', () => ({
|
||||
createStreamingResponse: vi.fn().mockImplementation(async () => createMockStream()),
|
||||
}))
|
||||
|
||||
vi.mock('@/lib/utils', () => ({
|
||||
SSE_HEADERS: {
|
||||
'Content-Type': 'text/event-stream',
|
||||
'Cache-Control': 'no-cache',
|
||||
Connection: 'keep-alive',
|
||||
'X-Accel-Buffering': 'no',
|
||||
},
|
||||
generateRequestId: vi.fn().mockReturnValue('test-request-id'),
|
||||
}))
|
||||
|
||||
vi.mock('@/app/api/workflows/[id]/execute/route', () => ({
|
||||
createFilteredResult: vi.fn().mockImplementation((result: any) => ({
|
||||
...result,
|
||||
logs: undefined,
|
||||
metadata: result.metadata
|
||||
? {
|
||||
...result.metadata,
|
||||
workflowConnections: undefined,
|
||||
}
|
||||
: undefined,
|
||||
})),
|
||||
}))
|
||||
|
||||
describe('Chat Identifier API Route', () => {
|
||||
const mockAddCorsHeaders = vi.fn().mockImplementation((response) => response)
|
||||
const mockValidateChatAuth = vi.fn().mockResolvedValue({ authorized: true })
|
||||
const mockSetChatAuthCookie = vi.fn()
|
||||
const mockCreateStreamingResponse = vi.fn().mockResolvedValue(createMockStream())
|
||||
|
||||
const mockChatResult = [
|
||||
{
|
||||
@@ -104,16 +130,6 @@ describe('Chat Identifier API Route', () => {
|
||||
validateAuthToken: vi.fn().mockReturnValue(true),
|
||||
}))
|
||||
|
||||
vi.doMock('@/lib/workflows/streaming', () => ({
|
||||
createStreamingResponse: mockCreateStreamingResponse,
|
||||
SSE_HEADERS: {
|
||||
'Content-Type': 'text/event-stream',
|
||||
'Cache-Control': 'no-cache',
|
||||
Connection: 'keep-alive',
|
||||
'X-Accel-Buffering': 'no',
|
||||
},
|
||||
}))
|
||||
|
||||
vi.doMock('@/lib/logs/console/logger', () => ({
|
||||
createLogger: vi.fn().mockReturnValue({
|
||||
debug: vi.fn(),
|
||||
@@ -372,6 +388,7 @@ describe('Chat Identifier API Route', () => {
|
||||
const params = Promise.resolve({ identifier: 'test-chat' })
|
||||
|
||||
const { POST } = await import('@/app/api/chat/[identifier]/route')
|
||||
const { createStreamingResponse } = await import('@/lib/workflows/streaming')
|
||||
|
||||
const response = await POST(req, { params })
|
||||
|
||||
@@ -380,7 +397,7 @@ describe('Chat Identifier API Route', () => {
|
||||
expect(response.headers.get('Cache-Control')).toBe('no-cache')
|
||||
expect(response.headers.get('Connection')).toBe('keep-alive')
|
||||
|
||||
expect(mockCreateStreamingResponse).toHaveBeenCalledWith(
|
||||
expect(createStreamingResponse).toHaveBeenCalledWith(
|
||||
expect.objectContaining({
|
||||
workflow: expect.objectContaining({
|
||||
id: 'workflow-id',
|
||||
@@ -396,7 +413,7 @@ describe('Chat Identifier API Route', () => {
|
||||
}),
|
||||
})
|
||||
)
|
||||
})
|
||||
}, 10000)
|
||||
|
||||
it('should handle streaming response body correctly', async () => {
|
||||
const req = createMockRequest('POST', { input: 'Hello world' })
|
||||
@@ -423,8 +440,9 @@ describe('Chat Identifier API Route', () => {
|
||||
})
|
||||
|
||||
it('should handle workflow execution errors gracefully', async () => {
|
||||
const originalStreamingResponse = mockCreateStreamingResponse.getMockImplementation()
|
||||
mockCreateStreamingResponse.mockImplementationOnce(async () => {
|
||||
const { createStreamingResponse } = await import('@/lib/workflows/streaming')
|
||||
const originalStreamingResponse = vi.mocked(createStreamingResponse).getMockImplementation()
|
||||
vi.mocked(createStreamingResponse).mockImplementationOnce(async () => {
|
||||
throw new Error('Execution failed')
|
||||
})
|
||||
|
||||
@@ -442,7 +460,7 @@ describe('Chat Identifier API Route', () => {
|
||||
expect(data).toHaveProperty('message', 'Execution failed')
|
||||
|
||||
if (originalStreamingResponse) {
|
||||
mockCreateStreamingResponse.mockImplementation(originalStreamingResponse)
|
||||
vi.mocked(createStreamingResponse).mockImplementation(originalStreamingResponse)
|
||||
}
|
||||
})
|
||||
|
||||
@@ -474,10 +492,11 @@ describe('Chat Identifier API Route', () => {
|
||||
const params = Promise.resolve({ identifier: 'test-chat' })
|
||||
|
||||
const { POST } = await import('@/app/api/chat/[identifier]/route')
|
||||
const { createStreamingResponse } = await import('@/lib/workflows/streaming')
|
||||
|
||||
await POST(req, { params })
|
||||
|
||||
expect(mockCreateStreamingResponse).toHaveBeenCalledWith(
|
||||
expect(createStreamingResponse).toHaveBeenCalledWith(
|
||||
expect.objectContaining({
|
||||
input: expect.objectContaining({
|
||||
input: 'Hello world',
|
||||
@@ -492,10 +511,11 @@ describe('Chat Identifier API Route', () => {
|
||||
const params = Promise.resolve({ identifier: 'test-chat' })
|
||||
|
||||
const { POST } = await import('@/app/api/chat/[identifier]/route')
|
||||
const { createStreamingResponse } = await import('@/lib/workflows/streaming')
|
||||
|
||||
await POST(req, { params })
|
||||
|
||||
expect(mockCreateStreamingResponse).toHaveBeenCalledWith(
|
||||
expect(createStreamingResponse).toHaveBeenCalledWith(
|
||||
expect.objectContaining({
|
||||
input: expect.objectContaining({
|
||||
input: 'Hello world',
|
||||
|
||||
@@ -45,7 +45,7 @@ async function hasPermission(userId: string, profile: any): Promise<boolean> {
|
||||
return false
|
||||
}
|
||||
|
||||
// GET /api/creator-profiles/[id] - Get a specific creator profile
|
||||
// GET /api/creators/[id] - Get a specific creator profile
|
||||
export async function GET(request: NextRequest, { params }: { params: Promise<{ id: string }> }) {
|
||||
const requestId = generateRequestId()
|
||||
const { id } = await params
|
||||
@@ -70,7 +70,7 @@ export async function GET(request: NextRequest, { params }: { params: Promise<{
|
||||
}
|
||||
}
|
||||
|
||||
// PUT /api/creator-profiles/[id] - Update a creator profile
|
||||
// PUT /api/creators/[id] - Update a creator profile
|
||||
export async function PUT(request: NextRequest, { params }: { params: Promise<{ id: string }> }) {
|
||||
const requestId = generateRequestId()
|
||||
const { id } = await params
|
||||
@@ -135,7 +135,7 @@ export async function PUT(request: NextRequest, { params }: { params: Promise<{
|
||||
}
|
||||
}
|
||||
|
||||
// DELETE /api/creator-profiles/[id] - Delete a creator profile
|
||||
// DELETE /api/creators/[id] - Delete a creator profile
|
||||
export async function DELETE(
|
||||
request: NextRequest,
|
||||
{ params }: { params: Promise<{ id: string }> }
|
||||
114
apps/sim/app/api/creators/[id]/verify/route.ts
Normal file
114
apps/sim/app/api/creators/[id]/verify/route.ts
Normal file
@@ -0,0 +1,114 @@
|
||||
import { db } from '@sim/db'
|
||||
import { templateCreators, user } from '@sim/db/schema'
|
||||
import { eq } from 'drizzle-orm'
|
||||
import { type NextRequest, NextResponse } from 'next/server'
|
||||
import { getSession } from '@/lib/auth'
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
import { generateRequestId } from '@/lib/utils'
|
||||
|
||||
const logger = createLogger('CreatorVerificationAPI')
|
||||
|
||||
export const revalidate = 0
|
||||
|
||||
// POST /api/creators/[id]/verify - Verify a creator (super users only)
|
||||
export async function POST(request: NextRequest, { params }: { params: Promise<{ id: string }> }) {
|
||||
const requestId = generateRequestId()
|
||||
const { id } = await params
|
||||
|
||||
try {
|
||||
const session = await getSession()
|
||||
if (!session?.user?.id) {
|
||||
logger.warn(`[${requestId}] Unauthorized verification attempt for creator: ${id}`)
|
||||
return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
|
||||
}
|
||||
|
||||
// Check if user is a super user
|
||||
const currentUser = await db.select().from(user).where(eq(user.id, session.user.id)).limit(1)
|
||||
|
||||
if (!currentUser[0]?.isSuperUser) {
|
||||
logger.warn(`[${requestId}] Non-super user attempted to verify creator: ${id}`)
|
||||
return NextResponse.json({ error: 'Only super users can verify creators' }, { status: 403 })
|
||||
}
|
||||
|
||||
// Check if creator exists
|
||||
const existingCreator = await db
|
||||
.select()
|
||||
.from(templateCreators)
|
||||
.where(eq(templateCreators.id, id))
|
||||
.limit(1)
|
||||
|
||||
if (existingCreator.length === 0) {
|
||||
logger.warn(`[${requestId}] Creator not found for verification: ${id}`)
|
||||
return NextResponse.json({ error: 'Creator not found' }, { status: 404 })
|
||||
}
|
||||
|
||||
// Update creator verified status to true
|
||||
await db
|
||||
.update(templateCreators)
|
||||
.set({ verified: true, updatedAt: new Date() })
|
||||
.where(eq(templateCreators.id, id))
|
||||
|
||||
logger.info(`[${requestId}] Creator verified: ${id} by super user: ${session.user.id}`)
|
||||
|
||||
return NextResponse.json({
|
||||
message: 'Creator verified successfully',
|
||||
creatorId: id,
|
||||
})
|
||||
} catch (error) {
|
||||
logger.error(`[${requestId}] Error verifying creator ${id}`, error)
|
||||
return NextResponse.json({ error: 'Internal server error' }, { status: 500 })
|
||||
}
|
||||
}
|
||||
|
||||
// DELETE /api/creators/[id]/verify - Unverify a creator (super users only)
|
||||
export async function DELETE(
|
||||
request: NextRequest,
|
||||
{ params }: { params: Promise<{ id: string }> }
|
||||
) {
|
||||
const requestId = generateRequestId()
|
||||
const { id } = await params
|
||||
|
||||
try {
|
||||
const session = await getSession()
|
||||
if (!session?.user?.id) {
|
||||
logger.warn(`[${requestId}] Unauthorized unverification attempt for creator: ${id}`)
|
||||
return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
|
||||
}
|
||||
|
||||
// Check if user is a super user
|
||||
const currentUser = await db.select().from(user).where(eq(user.id, session.user.id)).limit(1)
|
||||
|
||||
if (!currentUser[0]?.isSuperUser) {
|
||||
logger.warn(`[${requestId}] Non-super user attempted to unverify creator: ${id}`)
|
||||
return NextResponse.json({ error: 'Only super users can unverify creators' }, { status: 403 })
|
||||
}
|
||||
|
||||
// Check if creator exists
|
||||
const existingCreator = await db
|
||||
.select()
|
||||
.from(templateCreators)
|
||||
.where(eq(templateCreators.id, id))
|
||||
.limit(1)
|
||||
|
||||
if (existingCreator.length === 0) {
|
||||
logger.warn(`[${requestId}] Creator not found for unverification: ${id}`)
|
||||
return NextResponse.json({ error: 'Creator not found' }, { status: 404 })
|
||||
}
|
||||
|
||||
// Update creator verified status to false
|
||||
await db
|
||||
.update(templateCreators)
|
||||
.set({ verified: false, updatedAt: new Date() })
|
||||
.where(eq(templateCreators.id, id))
|
||||
|
||||
logger.info(`[${requestId}] Creator unverified: ${id} by super user: ${session.user.id}`)
|
||||
|
||||
return NextResponse.json({
|
||||
message: 'Creator unverified successfully',
|
||||
creatorId: id,
|
||||
})
|
||||
} catch (error) {
|
||||
logger.error(`[${requestId}] Error unverifying creator ${id}`, error)
|
||||
return NextResponse.json({ error: 'Internal server error' }, { status: 500 })
|
||||
}
|
||||
}
|
||||
@@ -27,7 +27,7 @@ const CreateCreatorProfileSchema = z.object({
|
||||
details: CreatorProfileDetailsSchema.optional(),
|
||||
})
|
||||
|
||||
// GET /api/creator-profiles - Get creator profiles for current user
|
||||
// GET /api/creators - Get creator profiles for current user
|
||||
export async function GET(request: NextRequest) {
|
||||
const requestId = generateRequestId()
|
||||
const { searchParams } = new URL(request.url)
|
||||
@@ -81,7 +81,7 @@ export async function GET(request: NextRequest) {
|
||||
}
|
||||
}
|
||||
|
||||
// POST /api/creator-profiles - Create a new creator profile
|
||||
// POST /api/creators - Create a new creator profile
|
||||
export async function POST(request: NextRequest) {
|
||||
const requestId = generateRequestId()
|
||||
|
||||
@@ -1,6 +1,12 @@
|
||||
import { db } from '@sim/db'
|
||||
import { member, subscription as subscriptionTable, user, userStats } from '@sim/db/schema'
|
||||
import { and, eq } from 'drizzle-orm'
|
||||
import {
|
||||
member,
|
||||
organization,
|
||||
subscription as subscriptionTable,
|
||||
user,
|
||||
userStats,
|
||||
} from '@sim/db/schema'
|
||||
import { and, eq, sql } from 'drizzle-orm'
|
||||
import { type NextRequest, NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { getSession } from '@/lib/auth'
|
||||
@@ -297,6 +303,44 @@ export async function DELETE(
|
||||
return NextResponse.json({ error: 'Cannot remove organization owner' }, { status: 400 })
|
||||
}
|
||||
|
||||
// Capture departed member's usage and reset their cost to prevent double billing
|
||||
try {
|
||||
const departingUserStats = await db
|
||||
.select({ currentPeriodCost: userStats.currentPeriodCost })
|
||||
.from(userStats)
|
||||
.where(eq(userStats.userId, memberId))
|
||||
.limit(1)
|
||||
|
||||
if (departingUserStats.length > 0 && departingUserStats[0].currentPeriodCost) {
|
||||
const usage = Number.parseFloat(departingUserStats[0].currentPeriodCost)
|
||||
if (usage > 0) {
|
||||
await db
|
||||
.update(organization)
|
||||
.set({
|
||||
departedMemberUsage: sql`${organization.departedMemberUsage} + ${usage}`,
|
||||
})
|
||||
.where(eq(organization.id, organizationId))
|
||||
|
||||
await db
|
||||
.update(userStats)
|
||||
.set({ currentPeriodCost: '0' })
|
||||
.where(eq(userStats.userId, memberId))
|
||||
|
||||
logger.info('Captured departed member usage and reset user cost', {
|
||||
organizationId,
|
||||
memberId,
|
||||
usage,
|
||||
})
|
||||
}
|
||||
}
|
||||
} catch (usageCaptureError) {
|
||||
logger.error('Failed to capture departed member usage', {
|
||||
organizationId,
|
||||
memberId,
|
||||
error: usageCaptureError,
|
||||
})
|
||||
}
|
||||
|
||||
// Remove member
|
||||
const removedMember = await db
|
||||
.delete(member)
|
||||
|
||||
97
apps/sim/app/api/status/route.ts
Normal file
97
apps/sim/app/api/status/route.ts
Normal file
@@ -0,0 +1,97 @@
|
||||
import { NextResponse } from 'next/server'
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
import type { IncidentIOWidgetResponse, StatusResponse, StatusType } from '@/app/api/status/types'
|
||||
|
||||
const logger = createLogger('StatusAPI')
|
||||
|
||||
let cachedResponse: { data: StatusResponse; timestamp: number } | null = null
|
||||
const CACHE_TTL = 2 * 60 * 1000
|
||||
|
||||
function determineStatus(data: IncidentIOWidgetResponse): {
|
||||
status: StatusType
|
||||
message: string
|
||||
} {
|
||||
if (data.ongoing_incidents && data.ongoing_incidents.length > 0) {
|
||||
const worstImpact = data.ongoing_incidents[0].current_worst_impact
|
||||
|
||||
if (worstImpact === 'full_outage') {
|
||||
return { status: 'outage', message: 'Service Disruption' }
|
||||
}
|
||||
if (worstImpact === 'partial_outage') {
|
||||
return { status: 'degraded', message: 'Experiencing Issues' }
|
||||
}
|
||||
return { status: 'degraded', message: 'Experiencing Issues' }
|
||||
}
|
||||
|
||||
if (data.in_progress_maintenances && data.in_progress_maintenances.length > 0) {
|
||||
return { status: 'maintenance', message: 'Under Maintenance' }
|
||||
}
|
||||
|
||||
return { status: 'operational', message: 'All Systems Operational' }
|
||||
}
|
||||
|
||||
export async function GET() {
|
||||
try {
|
||||
const now = Date.now()
|
||||
|
||||
if (cachedResponse && now - cachedResponse.timestamp < CACHE_TTL) {
|
||||
return NextResponse.json(cachedResponse.data, {
|
||||
headers: {
|
||||
'Cache-Control': 'public, max-age=60, s-maxage=60',
|
||||
'X-Cache': 'HIT',
|
||||
},
|
||||
})
|
||||
}
|
||||
|
||||
const response = await fetch('https://status.sim.ai/api/v1/summary', {
|
||||
method: 'GET',
|
||||
headers: {
|
||||
'Content-Type': 'application/json',
|
||||
},
|
||||
signal: AbortSignal.timeout(5000),
|
||||
})
|
||||
|
||||
if (!response.ok) {
|
||||
throw new Error(`incident.io API returned ${response.status}`)
|
||||
}
|
||||
|
||||
const data: IncidentIOWidgetResponse = await response.json()
|
||||
|
||||
const { status, message } = determineStatus(data)
|
||||
|
||||
const statusResponse: StatusResponse = {
|
||||
status,
|
||||
message,
|
||||
url: data.page_url || 'https://status.sim.ai',
|
||||
lastUpdated: new Date().toISOString(),
|
||||
}
|
||||
|
||||
cachedResponse = {
|
||||
data: statusResponse,
|
||||
timestamp: now,
|
||||
}
|
||||
|
||||
return NextResponse.json(statusResponse, {
|
||||
headers: {
|
||||
'Cache-Control': 'public, max-age=60, s-maxage=60',
|
||||
'X-Cache': 'MISS',
|
||||
},
|
||||
})
|
||||
} catch (error) {
|
||||
logger.error('Error fetching status from incident.io:', error)
|
||||
|
||||
const errorResponse: StatusResponse = {
|
||||
status: 'error',
|
||||
message: 'Status Unknown',
|
||||
url: 'https://status.sim.ai',
|
||||
lastUpdated: new Date().toISOString(),
|
||||
}
|
||||
|
||||
return NextResponse.json(errorResponse, {
|
||||
status: 200,
|
||||
headers: {
|
||||
'Cache-Control': 'public, max-age=30, s-maxage=30',
|
||||
},
|
||||
})
|
||||
}
|
||||
}
|
||||
48
apps/sim/app/api/status/types.ts
Normal file
48
apps/sim/app/api/status/types.ts
Normal file
@@ -0,0 +1,48 @@
|
||||
export interface IncidentIOComponent {
|
||||
id: string
|
||||
name: string
|
||||
group_name?: string
|
||||
current_status: 'operational' | 'degraded_performance' | 'partial_outage' | 'full_outage'
|
||||
}
|
||||
|
||||
export interface IncidentIOIncident {
|
||||
id: string
|
||||
name: string
|
||||
status: 'investigating' | 'identified' | 'monitoring'
|
||||
url: string
|
||||
last_update_at: string
|
||||
last_update_message: string
|
||||
current_worst_impact: 'degraded_performance' | 'partial_outage' | 'full_outage'
|
||||
affected_components: IncidentIOComponent[]
|
||||
}
|
||||
|
||||
export interface IncidentIOMaintenance {
|
||||
id: string
|
||||
name: string
|
||||
status: 'maintenance_scheduled' | 'maintenance_in_progress'
|
||||
url: string
|
||||
last_update_at: string
|
||||
last_update_message: string
|
||||
affected_components: IncidentIOComponent[]
|
||||
started_at?: string
|
||||
scheduled_end_at?: string
|
||||
starts_at?: string
|
||||
ends_at?: string
|
||||
}
|
||||
|
||||
export interface IncidentIOWidgetResponse {
|
||||
page_title: string
|
||||
page_url: string
|
||||
ongoing_incidents: IncidentIOIncident[]
|
||||
in_progress_maintenances: IncidentIOMaintenance[]
|
||||
scheduled_maintenances: IncidentIOMaintenance[]
|
||||
}
|
||||
|
||||
export type StatusType = 'operational' | 'degraded' | 'outage' | 'maintenance' | 'loading' | 'error'
|
||||
|
||||
export interface StatusResponse {
|
||||
status: StatusType
|
||||
message: string
|
||||
url: string
|
||||
lastUpdated: string
|
||||
}
|
||||
41
apps/sim/app/api/tools/dynamodb/delete/route.ts
Normal file
41
apps/sim/app/api/tools/dynamodb/delete/route.ts
Normal file
@@ -0,0 +1,41 @@
|
||||
import { NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { createDynamoDBClient, deleteItem } from '@/app/api/tools/dynamodb/utils'
|
||||
|
||||
const DeleteSchema = z.object({
|
||||
region: z.string().min(1, 'AWS region is required'),
|
||||
accessKeyId: z.string().min(1, 'AWS access key ID is required'),
|
||||
secretAccessKey: z.string().min(1, 'AWS secret access key is required'),
|
||||
tableName: z.string().min(1, 'Table name is required'),
|
||||
key: z.record(z.unknown()).refine((val) => Object.keys(val).length > 0, {
|
||||
message: 'Key is required',
|
||||
}),
|
||||
conditionExpression: z.string().optional(),
|
||||
})
|
||||
|
||||
export async function POST(request: Request) {
|
||||
try {
|
||||
const body = await request.json()
|
||||
const validatedData = DeleteSchema.parse(body)
|
||||
|
||||
const client = createDynamoDBClient({
|
||||
region: validatedData.region,
|
||||
accessKeyId: validatedData.accessKeyId,
|
||||
secretAccessKey: validatedData.secretAccessKey,
|
||||
})
|
||||
|
||||
await deleteItem(
|
||||
client,
|
||||
validatedData.tableName,
|
||||
validatedData.key,
|
||||
validatedData.conditionExpression
|
||||
)
|
||||
|
||||
return NextResponse.json({
|
||||
message: 'Item deleted successfully',
|
||||
})
|
||||
} catch (error) {
|
||||
const errorMessage = error instanceof Error ? error.message : 'DynamoDB delete failed'
|
||||
return NextResponse.json({ error: errorMessage }, { status: 500 })
|
||||
}
|
||||
}
|
||||
48
apps/sim/app/api/tools/dynamodb/get/route.ts
Normal file
48
apps/sim/app/api/tools/dynamodb/get/route.ts
Normal file
@@ -0,0 +1,48 @@
|
||||
import { NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { createDynamoDBClient, getItem } from '@/app/api/tools/dynamodb/utils'
|
||||
|
||||
const GetSchema = z.object({
|
||||
region: z.string().min(1, 'AWS region is required'),
|
||||
accessKeyId: z.string().min(1, 'AWS access key ID is required'),
|
||||
secretAccessKey: z.string().min(1, 'AWS secret access key is required'),
|
||||
tableName: z.string().min(1, 'Table name is required'),
|
||||
key: z.record(z.unknown()).refine((val) => Object.keys(val).length > 0, {
|
||||
message: 'Key is required',
|
||||
}),
|
||||
consistentRead: z
|
||||
.union([z.boolean(), z.string()])
|
||||
.optional()
|
||||
.transform((val) => {
|
||||
if (val === true || val === 'true') return true
|
||||
return undefined
|
||||
}),
|
||||
})
|
||||
|
||||
export async function POST(request: Request) {
|
||||
try {
|
||||
const body = await request.json()
|
||||
const validatedData = GetSchema.parse(body)
|
||||
|
||||
const client = createDynamoDBClient({
|
||||
region: validatedData.region,
|
||||
accessKeyId: validatedData.accessKeyId,
|
||||
secretAccessKey: validatedData.secretAccessKey,
|
||||
})
|
||||
|
||||
const result = await getItem(
|
||||
client,
|
||||
validatedData.tableName,
|
||||
validatedData.key,
|
||||
validatedData.consistentRead
|
||||
)
|
||||
|
||||
return NextResponse.json({
|
||||
message: result.item ? 'Item retrieved successfully' : 'Item not found',
|
||||
item: result.item,
|
||||
})
|
||||
} catch (error) {
|
||||
const errorMessage = error instanceof Error ? error.message : 'DynamoDB get failed'
|
||||
return NextResponse.json({ error: errorMessage }, { status: 500 })
|
||||
}
|
||||
}
|
||||
36
apps/sim/app/api/tools/dynamodb/put/route.ts
Normal file
36
apps/sim/app/api/tools/dynamodb/put/route.ts
Normal file
@@ -0,0 +1,36 @@
|
||||
import { NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { createDynamoDBClient, putItem } from '@/app/api/tools/dynamodb/utils'
|
||||
|
||||
const PutSchema = z.object({
|
||||
region: z.string().min(1, 'AWS region is required'),
|
||||
accessKeyId: z.string().min(1, 'AWS access key ID is required'),
|
||||
secretAccessKey: z.string().min(1, 'AWS secret access key is required'),
|
||||
tableName: z.string().min(1, 'Table name is required'),
|
||||
item: z.record(z.unknown()).refine((val) => Object.keys(val).length > 0, {
|
||||
message: 'Item is required',
|
||||
}),
|
||||
})
|
||||
|
||||
export async function POST(request: Request) {
|
||||
try {
|
||||
const body = await request.json()
|
||||
const validatedData = PutSchema.parse(body)
|
||||
|
||||
const client = createDynamoDBClient({
|
||||
region: validatedData.region,
|
||||
accessKeyId: validatedData.accessKeyId,
|
||||
secretAccessKey: validatedData.secretAccessKey,
|
||||
})
|
||||
|
||||
await putItem(client, validatedData.tableName, validatedData.item)
|
||||
|
||||
return NextResponse.json({
|
||||
message: 'Item created successfully',
|
||||
item: validatedData.item,
|
||||
})
|
||||
} catch (error) {
|
||||
const errorMessage = error instanceof Error ? error.message : 'DynamoDB put failed'
|
||||
return NextResponse.json({ error: errorMessage }, { status: 500 })
|
||||
}
|
||||
}
|
||||
51
apps/sim/app/api/tools/dynamodb/query/route.ts
Normal file
51
apps/sim/app/api/tools/dynamodb/query/route.ts
Normal file
@@ -0,0 +1,51 @@
|
||||
import { NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { createDynamoDBClient, queryItems } from '@/app/api/tools/dynamodb/utils'
|
||||
|
||||
const QuerySchema = z.object({
|
||||
region: z.string().min(1, 'AWS region is required'),
|
||||
accessKeyId: z.string().min(1, 'AWS access key ID is required'),
|
||||
secretAccessKey: z.string().min(1, 'AWS secret access key is required'),
|
||||
tableName: z.string().min(1, 'Table name is required'),
|
||||
keyConditionExpression: z.string().min(1, 'Key condition expression is required'),
|
||||
filterExpression: z.string().optional(),
|
||||
expressionAttributeNames: z.record(z.string()).optional(),
|
||||
expressionAttributeValues: z.record(z.unknown()).optional(),
|
||||
indexName: z.string().optional(),
|
||||
limit: z.number().positive().optional(),
|
||||
})
|
||||
|
||||
export async function POST(request: Request) {
|
||||
try {
|
||||
const body = await request.json()
|
||||
const validatedData = QuerySchema.parse(body)
|
||||
|
||||
const client = createDynamoDBClient({
|
||||
region: validatedData.region,
|
||||
accessKeyId: validatedData.accessKeyId,
|
||||
secretAccessKey: validatedData.secretAccessKey,
|
||||
})
|
||||
|
||||
const result = await queryItems(
|
||||
client,
|
||||
validatedData.tableName,
|
||||
validatedData.keyConditionExpression,
|
||||
{
|
||||
filterExpression: validatedData.filterExpression,
|
||||
expressionAttributeNames: validatedData.expressionAttributeNames,
|
||||
expressionAttributeValues: validatedData.expressionAttributeValues,
|
||||
indexName: validatedData.indexName,
|
||||
limit: validatedData.limit,
|
||||
}
|
||||
)
|
||||
|
||||
return NextResponse.json({
|
||||
message: `Query returned ${result.count} items`,
|
||||
items: result.items,
|
||||
count: result.count,
|
||||
})
|
||||
} catch (error) {
|
||||
const errorMessage = error instanceof Error ? error.message : 'DynamoDB query failed'
|
||||
return NextResponse.json({ error: errorMessage }, { status: 500 })
|
||||
}
|
||||
}
|
||||
45
apps/sim/app/api/tools/dynamodb/scan/route.ts
Normal file
45
apps/sim/app/api/tools/dynamodb/scan/route.ts
Normal file
@@ -0,0 +1,45 @@
|
||||
import { NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { createDynamoDBClient, scanItems } from '@/app/api/tools/dynamodb/utils'
|
||||
|
||||
const ScanSchema = z.object({
|
||||
region: z.string().min(1, 'AWS region is required'),
|
||||
accessKeyId: z.string().min(1, 'AWS access key ID is required'),
|
||||
secretAccessKey: z.string().min(1, 'AWS secret access key is required'),
|
||||
tableName: z.string().min(1, 'Table name is required'),
|
||||
filterExpression: z.string().optional(),
|
||||
projectionExpression: z.string().optional(),
|
||||
expressionAttributeNames: z.record(z.string()).optional(),
|
||||
expressionAttributeValues: z.record(z.unknown()).optional(),
|
||||
limit: z.number().positive().optional(),
|
||||
})
|
||||
|
||||
export async function POST(request: Request) {
|
||||
try {
|
||||
const body = await request.json()
|
||||
const validatedData = ScanSchema.parse(body)
|
||||
|
||||
const client = createDynamoDBClient({
|
||||
region: validatedData.region,
|
||||
accessKeyId: validatedData.accessKeyId,
|
||||
secretAccessKey: validatedData.secretAccessKey,
|
||||
})
|
||||
|
||||
const result = await scanItems(client, validatedData.tableName, {
|
||||
filterExpression: validatedData.filterExpression,
|
||||
projectionExpression: validatedData.projectionExpression,
|
||||
expressionAttributeNames: validatedData.expressionAttributeNames,
|
||||
expressionAttributeValues: validatedData.expressionAttributeValues,
|
||||
limit: validatedData.limit,
|
||||
})
|
||||
|
||||
return NextResponse.json({
|
||||
message: `Scan returned ${result.count} items`,
|
||||
items: result.items,
|
||||
count: result.count,
|
||||
})
|
||||
} catch (error) {
|
||||
const errorMessage = error instanceof Error ? error.message : 'DynamoDB scan failed'
|
||||
return NextResponse.json({ error: errorMessage }, { status: 500 })
|
||||
}
|
||||
}
|
||||
50
apps/sim/app/api/tools/dynamodb/update/route.ts
Normal file
50
apps/sim/app/api/tools/dynamodb/update/route.ts
Normal file
@@ -0,0 +1,50 @@
|
||||
import { NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { createDynamoDBClient, updateItem } from '@/app/api/tools/dynamodb/utils'
|
||||
|
||||
const UpdateSchema = z.object({
|
||||
region: z.string().min(1, 'AWS region is required'),
|
||||
accessKeyId: z.string().min(1, 'AWS access key ID is required'),
|
||||
secretAccessKey: z.string().min(1, 'AWS secret access key is required'),
|
||||
tableName: z.string().min(1, 'Table name is required'),
|
||||
key: z.record(z.unknown()).refine((val) => Object.keys(val).length > 0, {
|
||||
message: 'Key is required',
|
||||
}),
|
||||
updateExpression: z.string().min(1, 'Update expression is required'),
|
||||
expressionAttributeNames: z.record(z.string()).optional(),
|
||||
expressionAttributeValues: z.record(z.unknown()).optional(),
|
||||
conditionExpression: z.string().optional(),
|
||||
})
|
||||
|
||||
export async function POST(request: Request) {
|
||||
try {
|
||||
const body = await request.json()
|
||||
const validatedData = UpdateSchema.parse(body)
|
||||
|
||||
const client = createDynamoDBClient({
|
||||
region: validatedData.region,
|
||||
accessKeyId: validatedData.accessKeyId,
|
||||
secretAccessKey: validatedData.secretAccessKey,
|
||||
})
|
||||
|
||||
const result = await updateItem(
|
||||
client,
|
||||
validatedData.tableName,
|
||||
validatedData.key,
|
||||
validatedData.updateExpression,
|
||||
{
|
||||
expressionAttributeNames: validatedData.expressionAttributeNames,
|
||||
expressionAttributeValues: validatedData.expressionAttributeValues,
|
||||
conditionExpression: validatedData.conditionExpression,
|
||||
}
|
||||
)
|
||||
|
||||
return NextResponse.json({
|
||||
message: 'Item updated successfully',
|
||||
item: result.attributes,
|
||||
})
|
||||
} catch (error) {
|
||||
const errorMessage = error instanceof Error ? error.message : 'DynamoDB update failed'
|
||||
return NextResponse.json({ error: errorMessage }, { status: 500 })
|
||||
}
|
||||
}
|
||||
174
apps/sim/app/api/tools/dynamodb/utils.ts
Normal file
174
apps/sim/app/api/tools/dynamodb/utils.ts
Normal file
@@ -0,0 +1,174 @@
|
||||
import { DynamoDBClient } from '@aws-sdk/client-dynamodb'
|
||||
import {
|
||||
DeleteCommand,
|
||||
DynamoDBDocumentClient,
|
||||
GetCommand,
|
||||
PutCommand,
|
||||
QueryCommand,
|
||||
ScanCommand,
|
||||
UpdateCommand,
|
||||
} from '@aws-sdk/lib-dynamodb'
|
||||
import type { DynamoDBConnectionConfig } from '@/tools/dynamodb/types'
|
||||
|
||||
export function createDynamoDBClient(config: DynamoDBConnectionConfig): DynamoDBDocumentClient {
|
||||
const client = new DynamoDBClient({
|
||||
region: config.region,
|
||||
credentials: {
|
||||
accessKeyId: config.accessKeyId,
|
||||
secretAccessKey: config.secretAccessKey,
|
||||
},
|
||||
})
|
||||
|
||||
return DynamoDBDocumentClient.from(client, {
|
||||
marshallOptions: {
|
||||
removeUndefinedValues: true,
|
||||
convertEmptyValues: false,
|
||||
},
|
||||
unmarshallOptions: {
|
||||
wrapNumbers: false,
|
||||
},
|
||||
})
|
||||
}
|
||||
|
||||
export async function getItem(
|
||||
client: DynamoDBDocumentClient,
|
||||
tableName: string,
|
||||
key: Record<string, unknown>,
|
||||
consistentRead?: boolean
|
||||
): Promise<{ item: Record<string, unknown> | null }> {
|
||||
const command = new GetCommand({
|
||||
TableName: tableName,
|
||||
Key: key,
|
||||
ConsistentRead: consistentRead,
|
||||
})
|
||||
|
||||
const response = await client.send(command)
|
||||
return {
|
||||
item: (response.Item as Record<string, unknown>) || null,
|
||||
}
|
||||
}
|
||||
|
||||
export async function putItem(
|
||||
client: DynamoDBDocumentClient,
|
||||
tableName: string,
|
||||
item: Record<string, unknown>
|
||||
): Promise<{ success: boolean }> {
|
||||
const command = new PutCommand({
|
||||
TableName: tableName,
|
||||
Item: item,
|
||||
})
|
||||
|
||||
await client.send(command)
|
||||
return { success: true }
|
||||
}
|
||||
|
||||
export async function queryItems(
|
||||
client: DynamoDBDocumentClient,
|
||||
tableName: string,
|
||||
keyConditionExpression: string,
|
||||
options?: {
|
||||
filterExpression?: string
|
||||
expressionAttributeNames?: Record<string, string>
|
||||
expressionAttributeValues?: Record<string, unknown>
|
||||
indexName?: string
|
||||
limit?: number
|
||||
}
|
||||
): Promise<{ items: Record<string, unknown>[]; count: number }> {
|
||||
const command = new QueryCommand({
|
||||
TableName: tableName,
|
||||
KeyConditionExpression: keyConditionExpression,
|
||||
...(options?.filterExpression && { FilterExpression: options.filterExpression }),
|
||||
...(options?.expressionAttributeNames && {
|
||||
ExpressionAttributeNames: options.expressionAttributeNames,
|
||||
}),
|
||||
...(options?.expressionAttributeValues && {
|
||||
ExpressionAttributeValues: options.expressionAttributeValues,
|
||||
}),
|
||||
...(options?.indexName && { IndexName: options.indexName }),
|
||||
...(options?.limit && { Limit: options.limit }),
|
||||
})
|
||||
|
||||
const response = await client.send(command)
|
||||
return {
|
||||
items: (response.Items as Record<string, unknown>[]) || [],
|
||||
count: response.Count || 0,
|
||||
}
|
||||
}
|
||||
|
||||
export async function scanItems(
|
||||
client: DynamoDBDocumentClient,
|
||||
tableName: string,
|
||||
options?: {
|
||||
filterExpression?: string
|
||||
projectionExpression?: string
|
||||
expressionAttributeNames?: Record<string, string>
|
||||
expressionAttributeValues?: Record<string, unknown>
|
||||
limit?: number
|
||||
}
|
||||
): Promise<{ items: Record<string, unknown>[]; count: number }> {
|
||||
const command = new ScanCommand({
|
||||
TableName: tableName,
|
||||
...(options?.filterExpression && { FilterExpression: options.filterExpression }),
|
||||
...(options?.projectionExpression && { ProjectionExpression: options.projectionExpression }),
|
||||
...(options?.expressionAttributeNames && {
|
||||
ExpressionAttributeNames: options.expressionAttributeNames,
|
||||
}),
|
||||
...(options?.expressionAttributeValues && {
|
||||
ExpressionAttributeValues: options.expressionAttributeValues,
|
||||
}),
|
||||
...(options?.limit && { Limit: options.limit }),
|
||||
})
|
||||
|
||||
const response = await client.send(command)
|
||||
return {
|
||||
items: (response.Items as Record<string, unknown>[]) || [],
|
||||
count: response.Count || 0,
|
||||
}
|
||||
}
|
||||
|
||||
export async function updateItem(
|
||||
client: DynamoDBDocumentClient,
|
||||
tableName: string,
|
||||
key: Record<string, unknown>,
|
||||
updateExpression: string,
|
||||
options?: {
|
||||
expressionAttributeNames?: Record<string, string>
|
||||
expressionAttributeValues?: Record<string, unknown>
|
||||
conditionExpression?: string
|
||||
}
|
||||
): Promise<{ attributes: Record<string, unknown> | null }> {
|
||||
const command = new UpdateCommand({
|
||||
TableName: tableName,
|
||||
Key: key,
|
||||
UpdateExpression: updateExpression,
|
||||
...(options?.expressionAttributeNames && {
|
||||
ExpressionAttributeNames: options.expressionAttributeNames,
|
||||
}),
|
||||
...(options?.expressionAttributeValues && {
|
||||
ExpressionAttributeValues: options.expressionAttributeValues,
|
||||
}),
|
||||
...(options?.conditionExpression && { ConditionExpression: options.conditionExpression }),
|
||||
ReturnValues: 'ALL_NEW',
|
||||
})
|
||||
|
||||
const response = await client.send(command)
|
||||
return {
|
||||
attributes: (response.Attributes as Record<string, unknown>) || null,
|
||||
}
|
||||
}
|
||||
|
||||
export async function deleteItem(
|
||||
client: DynamoDBDocumentClient,
|
||||
tableName: string,
|
||||
key: Record<string, unknown>,
|
||||
conditionExpression?: string
|
||||
): Promise<{ success: boolean }> {
|
||||
const command = new DeleteCommand({
|
||||
TableName: tableName,
|
||||
Key: key,
|
||||
...(conditionExpression && { ConditionExpression: conditionExpression }),
|
||||
})
|
||||
|
||||
await client.send(command)
|
||||
return { success: true }
|
||||
}
|
||||
74
apps/sim/app/api/tools/rds/delete/route.ts
Normal file
74
apps/sim/app/api/tools/rds/delete/route.ts
Normal file
@@ -0,0 +1,74 @@
|
||||
import { randomUUID } from 'crypto'
|
||||
import { type NextRequest, NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
import { createRdsClient, executeDelete } from '@/app/api/tools/rds/utils'
|
||||
|
||||
const logger = createLogger('RDSDeleteAPI')
|
||||
|
||||
const DeleteSchema = z.object({
|
||||
region: z.string().min(1, 'AWS region is required'),
|
||||
accessKeyId: z.string().min(1, 'AWS access key ID is required'),
|
||||
secretAccessKey: z.string().min(1, 'AWS secret access key is required'),
|
||||
resourceArn: z.string().min(1, 'Resource ARN is required'),
|
||||
secretArn: z.string().min(1, 'Secret ARN is required'),
|
||||
database: z.string().optional(),
|
||||
table: z.string().min(1, 'Table name is required'),
|
||||
conditions: z.record(z.unknown()).refine((obj) => Object.keys(obj).length > 0, {
|
||||
message: 'At least one condition is required',
|
||||
}),
|
||||
})
|
||||
|
||||
export async function POST(request: NextRequest) {
|
||||
const requestId = randomUUID().slice(0, 8)
|
||||
|
||||
try {
|
||||
const body = await request.json()
|
||||
const params = DeleteSchema.parse(body)
|
||||
|
||||
logger.info(`[${requestId}] Deleting from RDS table ${params.table} in ${params.database}`)
|
||||
|
||||
const client = createRdsClient({
|
||||
region: params.region,
|
||||
accessKeyId: params.accessKeyId,
|
||||
secretAccessKey: params.secretAccessKey,
|
||||
resourceArn: params.resourceArn,
|
||||
secretArn: params.secretArn,
|
||||
database: params.database,
|
||||
})
|
||||
|
||||
try {
|
||||
const result = await executeDelete(
|
||||
client,
|
||||
params.resourceArn,
|
||||
params.secretArn,
|
||||
params.database,
|
||||
params.table,
|
||||
params.conditions
|
||||
)
|
||||
|
||||
logger.info(`[${requestId}] Delete executed successfully, affected ${result.rowCount} rows`)
|
||||
|
||||
return NextResponse.json({
|
||||
message: `Delete executed successfully. ${result.rowCount} row(s) deleted.`,
|
||||
rows: result.rows,
|
||||
rowCount: result.rowCount,
|
||||
})
|
||||
} finally {
|
||||
client.destroy()
|
||||
}
|
||||
} catch (error) {
|
||||
if (error instanceof z.ZodError) {
|
||||
logger.warn(`[${requestId}] Invalid request data`, { errors: error.errors })
|
||||
return NextResponse.json(
|
||||
{ error: 'Invalid request data', details: error.errors },
|
||||
{ status: 400 }
|
||||
)
|
||||
}
|
||||
|
||||
const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred'
|
||||
logger.error(`[${requestId}] RDS delete failed:`, error)
|
||||
|
||||
return NextResponse.json({ error: `RDS delete failed: ${errorMessage}` }, { status: 500 })
|
||||
}
|
||||
}
|
||||
70
apps/sim/app/api/tools/rds/execute/route.ts
Normal file
70
apps/sim/app/api/tools/rds/execute/route.ts
Normal file
@@ -0,0 +1,70 @@
|
||||
import { randomUUID } from 'crypto'
|
||||
import { type NextRequest, NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
import { createRdsClient, executeStatement } from '@/app/api/tools/rds/utils'
|
||||
|
||||
const logger = createLogger('RDSExecuteAPI')
|
||||
|
||||
const ExecuteSchema = z.object({
|
||||
region: z.string().min(1, 'AWS region is required'),
|
||||
accessKeyId: z.string().min(1, 'AWS access key ID is required'),
|
||||
secretAccessKey: z.string().min(1, 'AWS secret access key is required'),
|
||||
resourceArn: z.string().min(1, 'Resource ARN is required'),
|
||||
secretArn: z.string().min(1, 'Secret ARN is required'),
|
||||
database: z.string().optional(),
|
||||
query: z.string().min(1, 'Query is required'),
|
||||
})
|
||||
|
||||
export async function POST(request: NextRequest) {
|
||||
const requestId = randomUUID().slice(0, 8)
|
||||
|
||||
try {
|
||||
const body = await request.json()
|
||||
const params = ExecuteSchema.parse(body)
|
||||
|
||||
logger.info(`[${requestId}] Executing raw SQL on RDS database ${params.database}`)
|
||||
|
||||
const client = createRdsClient({
|
||||
region: params.region,
|
||||
accessKeyId: params.accessKeyId,
|
||||
secretAccessKey: params.secretAccessKey,
|
||||
resourceArn: params.resourceArn,
|
||||
secretArn: params.secretArn,
|
||||
database: params.database,
|
||||
})
|
||||
|
||||
try {
|
||||
const result = await executeStatement(
|
||||
client,
|
||||
params.resourceArn,
|
||||
params.secretArn,
|
||||
params.database,
|
||||
params.query
|
||||
)
|
||||
|
||||
logger.info(`[${requestId}] Execute completed successfully, affected ${result.rowCount} rows`)
|
||||
|
||||
return NextResponse.json({
|
||||
message: `Query executed successfully. ${result.rowCount} row(s) affected.`,
|
||||
rows: result.rows,
|
||||
rowCount: result.rowCount,
|
||||
})
|
||||
} finally {
|
||||
client.destroy()
|
||||
}
|
||||
} catch (error) {
|
||||
if (error instanceof z.ZodError) {
|
||||
logger.warn(`[${requestId}] Invalid request data`, { errors: error.errors })
|
||||
return NextResponse.json(
|
||||
{ error: 'Invalid request data', details: error.errors },
|
||||
{ status: 400 }
|
||||
)
|
||||
}
|
||||
|
||||
const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred'
|
||||
logger.error(`[${requestId}] RDS execute failed:`, error)
|
||||
|
||||
return NextResponse.json({ error: `RDS execute failed: ${errorMessage}` }, { status: 500 })
|
||||
}
|
||||
}
|
||||
74
apps/sim/app/api/tools/rds/insert/route.ts
Normal file
74
apps/sim/app/api/tools/rds/insert/route.ts
Normal file
@@ -0,0 +1,74 @@
|
||||
import { randomUUID } from 'crypto'
|
||||
import { type NextRequest, NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
import { createRdsClient, executeInsert } from '@/app/api/tools/rds/utils'
|
||||
|
||||
const logger = createLogger('RDSInsertAPI')
|
||||
|
||||
const InsertSchema = z.object({
|
||||
region: z.string().min(1, 'AWS region is required'),
|
||||
accessKeyId: z.string().min(1, 'AWS access key ID is required'),
|
||||
secretAccessKey: z.string().min(1, 'AWS secret access key is required'),
|
||||
resourceArn: z.string().min(1, 'Resource ARN is required'),
|
||||
secretArn: z.string().min(1, 'Secret ARN is required'),
|
||||
database: z.string().optional(),
|
||||
table: z.string().min(1, 'Table name is required'),
|
||||
data: z.record(z.unknown()).refine((obj) => Object.keys(obj).length > 0, {
|
||||
message: 'Data object must have at least one field',
|
||||
}),
|
||||
})
|
||||
|
||||
export async function POST(request: NextRequest) {
|
||||
const requestId = randomUUID().slice(0, 8)
|
||||
|
||||
try {
|
||||
const body = await request.json()
|
||||
const params = InsertSchema.parse(body)
|
||||
|
||||
logger.info(`[${requestId}] Inserting into RDS table ${params.table} in ${params.database}`)
|
||||
|
||||
const client = createRdsClient({
|
||||
region: params.region,
|
||||
accessKeyId: params.accessKeyId,
|
||||
secretAccessKey: params.secretAccessKey,
|
||||
resourceArn: params.resourceArn,
|
||||
secretArn: params.secretArn,
|
||||
database: params.database,
|
||||
})
|
||||
|
||||
try {
|
||||
const result = await executeInsert(
|
||||
client,
|
||||
params.resourceArn,
|
||||
params.secretArn,
|
||||
params.database,
|
||||
params.table,
|
||||
params.data
|
||||
)
|
||||
|
||||
logger.info(`[${requestId}] Insert executed successfully, affected ${result.rowCount} rows`)
|
||||
|
||||
return NextResponse.json({
|
||||
message: `Insert executed successfully. ${result.rowCount} row(s) inserted.`,
|
||||
rows: result.rows,
|
||||
rowCount: result.rowCount,
|
||||
})
|
||||
} finally {
|
||||
client.destroy()
|
||||
}
|
||||
} catch (error) {
|
||||
if (error instanceof z.ZodError) {
|
||||
logger.warn(`[${requestId}] Invalid request data`, { errors: error.errors })
|
||||
return NextResponse.json(
|
||||
{ error: 'Invalid request data', details: error.errors },
|
||||
{ status: 400 }
|
||||
)
|
||||
}
|
||||
|
||||
const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred'
|
||||
logger.error(`[${requestId}] RDS insert failed:`, error)
|
||||
|
||||
return NextResponse.json({ error: `RDS insert failed: ${errorMessage}` }, { status: 500 })
|
||||
}
|
||||
}
|
||||
77
apps/sim/app/api/tools/rds/query/route.ts
Normal file
77
apps/sim/app/api/tools/rds/query/route.ts
Normal file
@@ -0,0 +1,77 @@
|
||||
import { randomUUID } from 'crypto'
|
||||
import { type NextRequest, NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
import { createRdsClient, executeStatement, validateQuery } from '@/app/api/tools/rds/utils'
|
||||
|
||||
const logger = createLogger('RDSQueryAPI')
|
||||
|
||||
const QuerySchema = z.object({
|
||||
region: z.string().min(1, 'AWS region is required'),
|
||||
accessKeyId: z.string().min(1, 'AWS access key ID is required'),
|
||||
secretAccessKey: z.string().min(1, 'AWS secret access key is required'),
|
||||
resourceArn: z.string().min(1, 'Resource ARN is required'),
|
||||
secretArn: z.string().min(1, 'Secret ARN is required'),
|
||||
database: z.string().optional(),
|
||||
query: z.string().min(1, 'Query is required'),
|
||||
})
|
||||
|
||||
export async function POST(request: NextRequest) {
|
||||
const requestId = randomUUID().slice(0, 8)
|
||||
|
||||
try {
|
||||
const body = await request.json()
|
||||
const params = QuerySchema.parse(body)
|
||||
|
||||
logger.info(`[${requestId}] Executing RDS query on ${params.database}`)
|
||||
|
||||
// Validate the query
|
||||
const validation = validateQuery(params.query)
|
||||
if (!validation.isValid) {
|
||||
logger.warn(`[${requestId}] Query validation failed: ${validation.error}`)
|
||||
return NextResponse.json({ error: validation.error }, { status: 400 })
|
||||
}
|
||||
|
||||
const client = createRdsClient({
|
||||
region: params.region,
|
||||
accessKeyId: params.accessKeyId,
|
||||
secretAccessKey: params.secretAccessKey,
|
||||
resourceArn: params.resourceArn,
|
||||
secretArn: params.secretArn,
|
||||
database: params.database,
|
||||
})
|
||||
|
||||
try {
|
||||
const result = await executeStatement(
|
||||
client,
|
||||
params.resourceArn,
|
||||
params.secretArn,
|
||||
params.database,
|
||||
params.query
|
||||
)
|
||||
|
||||
logger.info(`[${requestId}] Query executed successfully, returned ${result.rowCount} rows`)
|
||||
|
||||
return NextResponse.json({
|
||||
message: `Query executed successfully. ${result.rowCount} row(s) returned.`,
|
||||
rows: result.rows,
|
||||
rowCount: result.rowCount,
|
||||
})
|
||||
} finally {
|
||||
client.destroy()
|
||||
}
|
||||
} catch (error) {
|
||||
if (error instanceof z.ZodError) {
|
||||
logger.warn(`[${requestId}] Invalid request data`, { errors: error.errors })
|
||||
return NextResponse.json(
|
||||
{ error: 'Invalid request data', details: error.errors },
|
||||
{ status: 400 }
|
||||
)
|
||||
}
|
||||
|
||||
const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred'
|
||||
logger.error(`[${requestId}] RDS query failed:`, error)
|
||||
|
||||
return NextResponse.json({ error: `RDS query failed: ${errorMessage}` }, { status: 500 })
|
||||
}
|
||||
}
|
||||
78
apps/sim/app/api/tools/rds/update/route.ts
Normal file
78
apps/sim/app/api/tools/rds/update/route.ts
Normal file
@@ -0,0 +1,78 @@
|
||||
import { randomUUID } from 'crypto'
|
||||
import { type NextRequest, NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
import { createRdsClient, executeUpdate } from '@/app/api/tools/rds/utils'
|
||||
|
||||
const logger = createLogger('RDSUpdateAPI')
|
||||
|
||||
const UpdateSchema = z.object({
|
||||
region: z.string().min(1, 'AWS region is required'),
|
||||
accessKeyId: z.string().min(1, 'AWS access key ID is required'),
|
||||
secretAccessKey: z.string().min(1, 'AWS secret access key is required'),
|
||||
resourceArn: z.string().min(1, 'Resource ARN is required'),
|
||||
secretArn: z.string().min(1, 'Secret ARN is required'),
|
||||
database: z.string().optional(),
|
||||
table: z.string().min(1, 'Table name is required'),
|
||||
data: z.record(z.unknown()).refine((obj) => Object.keys(obj).length > 0, {
|
||||
message: 'Data object must have at least one field',
|
||||
}),
|
||||
conditions: z.record(z.unknown()).refine((obj) => Object.keys(obj).length > 0, {
|
||||
message: 'At least one condition is required',
|
||||
}),
|
||||
})
|
||||
|
||||
export async function POST(request: NextRequest) {
|
||||
const requestId = randomUUID().slice(0, 8)
|
||||
|
||||
try {
|
||||
const body = await request.json()
|
||||
const params = UpdateSchema.parse(body)
|
||||
|
||||
logger.info(`[${requestId}] Updating RDS table ${params.table} in ${params.database}`)
|
||||
|
||||
const client = createRdsClient({
|
||||
region: params.region,
|
||||
accessKeyId: params.accessKeyId,
|
||||
secretAccessKey: params.secretAccessKey,
|
||||
resourceArn: params.resourceArn,
|
||||
secretArn: params.secretArn,
|
||||
database: params.database,
|
||||
})
|
||||
|
||||
try {
|
||||
const result = await executeUpdate(
|
||||
client,
|
||||
params.resourceArn,
|
||||
params.secretArn,
|
||||
params.database,
|
||||
params.table,
|
||||
params.data,
|
||||
params.conditions
|
||||
)
|
||||
|
||||
logger.info(`[${requestId}] Update executed successfully, affected ${result.rowCount} rows`)
|
||||
|
||||
return NextResponse.json({
|
||||
message: `Update executed successfully. ${result.rowCount} row(s) updated.`,
|
||||
rows: result.rows,
|
||||
rowCount: result.rowCount,
|
||||
})
|
||||
} finally {
|
||||
client.destroy()
|
||||
}
|
||||
} catch (error) {
|
||||
if (error instanceof z.ZodError) {
|
||||
logger.warn(`[${requestId}] Invalid request data`, { errors: error.errors })
|
||||
return NextResponse.json(
|
||||
{ error: 'Invalid request data', details: error.errors },
|
||||
{ status: 400 }
|
||||
)
|
||||
}
|
||||
|
||||
const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred'
|
||||
logger.error(`[${requestId}] RDS update failed:`, error)
|
||||
|
||||
return NextResponse.json({ error: `RDS update failed: ${errorMessage}` }, { status: 500 })
|
||||
}
|
||||
}
|
||||
266
apps/sim/app/api/tools/rds/utils.ts
Normal file
266
apps/sim/app/api/tools/rds/utils.ts
Normal file
@@ -0,0 +1,266 @@
|
||||
import {
|
||||
ExecuteStatementCommand,
|
||||
type ExecuteStatementCommandOutput,
|
||||
type Field,
|
||||
RDSDataClient,
|
||||
type SqlParameter,
|
||||
} from '@aws-sdk/client-rds-data'
|
||||
import type { RdsConnectionConfig } from '@/tools/rds/types'
|
||||
|
||||
export function createRdsClient(config: RdsConnectionConfig): RDSDataClient {
|
||||
return new RDSDataClient({
|
||||
region: config.region,
|
||||
credentials: {
|
||||
accessKeyId: config.accessKeyId,
|
||||
secretAccessKey: config.secretAccessKey,
|
||||
},
|
||||
})
|
||||
}
|
||||
|
||||
export async function executeStatement(
|
||||
client: RDSDataClient,
|
||||
resourceArn: string,
|
||||
secretArn: string,
|
||||
database: string | undefined,
|
||||
sql: string,
|
||||
parameters?: SqlParameter[]
|
||||
): Promise<{ rows: Record<string, unknown>[]; rowCount: number }> {
|
||||
const command = new ExecuteStatementCommand({
|
||||
resourceArn,
|
||||
secretArn,
|
||||
...(database && { database }),
|
||||
sql,
|
||||
...(parameters && parameters.length > 0 && { parameters }),
|
||||
includeResultMetadata: true,
|
||||
})
|
||||
|
||||
const response = await client.send(command)
|
||||
const rows = parseRdsResponse(response)
|
||||
|
||||
return {
|
||||
rows,
|
||||
rowCount: response.numberOfRecordsUpdated ?? rows.length,
|
||||
}
|
||||
}
|
||||
|
||||
function parseRdsResponse(response: ExecuteStatementCommandOutput): Record<string, unknown>[] {
|
||||
if (!response.records || !response.columnMetadata) {
|
||||
return []
|
||||
}
|
||||
|
||||
const columnNames = response.columnMetadata.map((col) => col.name || col.label || 'unknown')
|
||||
|
||||
return response.records.map((record) => {
|
||||
const row: Record<string, unknown> = {}
|
||||
record.forEach((field, index) => {
|
||||
const columnName = columnNames[index] || `column_${index}`
|
||||
row[columnName] = parseFieldValue(field)
|
||||
})
|
||||
return row
|
||||
})
|
||||
}
|
||||
|
||||
function parseFieldValue(field: Field): unknown {
|
||||
if (field.isNull) return null
|
||||
if (field.stringValue !== undefined) return field.stringValue
|
||||
if (field.longValue !== undefined) return field.longValue
|
||||
if (field.doubleValue !== undefined) return field.doubleValue
|
||||
if (field.booleanValue !== undefined) return field.booleanValue
|
||||
if (field.blobValue !== undefined) return Buffer.from(field.blobValue).toString('base64')
|
||||
if (field.arrayValue !== undefined) {
|
||||
const arr = field.arrayValue
|
||||
if (arr.stringValues) return arr.stringValues
|
||||
if (arr.longValues) return arr.longValues
|
||||
if (arr.doubleValues) return arr.doubleValues
|
||||
if (arr.booleanValues) return arr.booleanValues
|
||||
if (arr.arrayValues) return arr.arrayValues.map((f) => parseFieldValue({ arrayValue: f }))
|
||||
return []
|
||||
}
|
||||
return null
|
||||
}
|
||||
|
||||
export function validateQuery(query: string): { isValid: boolean; error?: string } {
|
||||
const trimmedQuery = query.trim().toLowerCase()
|
||||
|
||||
const dangerousPatterns = [
|
||||
/drop\s+database/i,
|
||||
/drop\s+schema/i,
|
||||
/drop\s+user/i,
|
||||
/create\s+user/i,
|
||||
/create\s+role/i,
|
||||
/grant\s+/i,
|
||||
/revoke\s+/i,
|
||||
/alter\s+user/i,
|
||||
/alter\s+role/i,
|
||||
/set\s+role/i,
|
||||
/reset\s+role/i,
|
||||
]
|
||||
|
||||
for (const pattern of dangerousPatterns) {
|
||||
if (pattern.test(query)) {
|
||||
return {
|
||||
isValid: false,
|
||||
error: `Query contains potentially dangerous operation: ${pattern.source}`,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
const allowedStatements = /^(select|insert|update|delete|with|explain|show)\s+/i
|
||||
if (!allowedStatements.test(trimmedQuery)) {
|
||||
return {
|
||||
isValid: false,
|
||||
error: 'Only SELECT, INSERT, UPDATE, DELETE, WITH, EXPLAIN, and SHOW statements are allowed',
|
||||
}
|
||||
}
|
||||
|
||||
return { isValid: true }
|
||||
}
|
||||
|
||||
export function sanitizeIdentifier(identifier: string): string {
|
||||
if (identifier.includes('.')) {
|
||||
const parts = identifier.split('.')
|
||||
return parts.map((part) => sanitizeSingleIdentifier(part)).join('.')
|
||||
}
|
||||
|
||||
return sanitizeSingleIdentifier(identifier)
|
||||
}
|
||||
|
||||
function sanitizeSingleIdentifier(identifier: string): string {
|
||||
const cleaned = identifier.replace(/`/g, '').replace(/"/g, '')
|
||||
|
||||
if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(cleaned)) {
|
||||
throw new Error(
|
||||
`Invalid identifier: ${identifier}. Identifiers must start with a letter or underscore and contain only letters, numbers, and underscores.`
|
||||
)
|
||||
}
|
||||
|
||||
return cleaned
|
||||
}
|
||||
|
||||
/**
|
||||
* Convert a JS value to an RDS Data API SqlParameter value
|
||||
*/
|
||||
function toSqlParameterValue(value: unknown): SqlParameter['value'] {
|
||||
if (value === null || value === undefined) {
|
||||
return { isNull: true }
|
||||
}
|
||||
if (typeof value === 'boolean') {
|
||||
return { booleanValue: value }
|
||||
}
|
||||
if (typeof value === 'number') {
|
||||
if (Number.isInteger(value)) {
|
||||
return { longValue: value }
|
||||
}
|
||||
return { doubleValue: value }
|
||||
}
|
||||
if (typeof value === 'string') {
|
||||
return { stringValue: value }
|
||||
}
|
||||
if (value instanceof Uint8Array || Buffer.isBuffer(value)) {
|
||||
return { blobValue: value }
|
||||
}
|
||||
// Objects/arrays as JSON strings
|
||||
return { stringValue: JSON.stringify(value) }
|
||||
}
|
||||
|
||||
/**
|
||||
* Build parameterized INSERT query
|
||||
*/
|
||||
export async function executeInsert(
|
||||
client: RDSDataClient,
|
||||
resourceArn: string,
|
||||
secretArn: string,
|
||||
database: string | undefined,
|
||||
table: string,
|
||||
data: Record<string, unknown>
|
||||
): Promise<{ rows: Record<string, unknown>[]; rowCount: number }> {
|
||||
const sanitizedTable = sanitizeIdentifier(table)
|
||||
const columns = Object.keys(data)
|
||||
const sanitizedColumns = columns.map((col) => sanitizeIdentifier(col))
|
||||
|
||||
const placeholders = columns.map((col) => `:${col}`)
|
||||
const parameters: SqlParameter[] = columns.map((col) => ({
|
||||
name: col,
|
||||
value: toSqlParameterValue(data[col]),
|
||||
}))
|
||||
|
||||
const sql = `INSERT INTO ${sanitizedTable} (${sanitizedColumns.join(', ')}) VALUES (${placeholders.join(', ')})`
|
||||
|
||||
return executeStatement(client, resourceArn, secretArn, database, sql, parameters)
|
||||
}
|
||||
|
||||
/**
|
||||
* Build parameterized UPDATE query with conditions
|
||||
*/
|
||||
export async function executeUpdate(
|
||||
client: RDSDataClient,
|
||||
resourceArn: string,
|
||||
secretArn: string,
|
||||
database: string | undefined,
|
||||
table: string,
|
||||
data: Record<string, unknown>,
|
||||
conditions: Record<string, unknown>
|
||||
): Promise<{ rows: Record<string, unknown>[]; rowCount: number }> {
|
||||
const sanitizedTable = sanitizeIdentifier(table)
|
||||
|
||||
// Build SET clause with parameters
|
||||
const dataColumns = Object.keys(data)
|
||||
const setClause = dataColumns.map((col) => `${sanitizeIdentifier(col)} = :set_${col}`).join(', ')
|
||||
|
||||
// Build WHERE clause with parameters
|
||||
const conditionColumns = Object.keys(conditions)
|
||||
if (conditionColumns.length === 0) {
|
||||
throw new Error('At least one condition is required for UPDATE operations')
|
||||
}
|
||||
const whereClause = conditionColumns
|
||||
.map((col) => `${sanitizeIdentifier(col)} = :where_${col}`)
|
||||
.join(' AND ')
|
||||
|
||||
// Build parameters array (prefixed to avoid name collisions)
|
||||
const parameters: SqlParameter[] = [
|
||||
...dataColumns.map((col) => ({
|
||||
name: `set_${col}`,
|
||||
value: toSqlParameterValue(data[col]),
|
||||
})),
|
||||
...conditionColumns.map((col) => ({
|
||||
name: `where_${col}`,
|
||||
value: toSqlParameterValue(conditions[col]),
|
||||
})),
|
||||
]
|
||||
|
||||
const sql = `UPDATE ${sanitizedTable} SET ${setClause} WHERE ${whereClause}`
|
||||
|
||||
return executeStatement(client, resourceArn, secretArn, database, sql, parameters)
|
||||
}
|
||||
|
||||
/**
|
||||
* Build parameterized DELETE query with conditions
|
||||
*/
|
||||
export async function executeDelete(
|
||||
client: RDSDataClient,
|
||||
resourceArn: string,
|
||||
secretArn: string,
|
||||
database: string | undefined,
|
||||
table: string,
|
||||
conditions: Record<string, unknown>
|
||||
): Promise<{ rows: Record<string, unknown>[]; rowCount: number }> {
|
||||
const sanitizedTable = sanitizeIdentifier(table)
|
||||
|
||||
// Build WHERE clause with parameters
|
||||
const conditionColumns = Object.keys(conditions)
|
||||
if (conditionColumns.length === 0) {
|
||||
throw new Error('At least one condition is required for DELETE operations')
|
||||
}
|
||||
const whereClause = conditionColumns
|
||||
.map((col) => `${sanitizeIdentifier(col)} = :${col}`)
|
||||
.join(' AND ')
|
||||
|
||||
const parameters: SqlParameter[] = conditionColumns.map((col) => ({
|
||||
name: col,
|
||||
value: toSqlParameterValue(conditions[col]),
|
||||
}))
|
||||
|
||||
const sql = `DELETE FROM ${sanitizedTable} WHERE ${whereClause}`
|
||||
|
||||
return executeStatement(client, resourceArn, secretArn, database, sql, parameters)
|
||||
}
|
||||
130
apps/sim/app/api/tools/search/route.ts
Normal file
130
apps/sim/app/api/tools/search/route.ts
Normal file
@@ -0,0 +1,130 @@
|
||||
import { type NextRequest, NextResponse } from 'next/server'
|
||||
import { z } from 'zod'
|
||||
import { checkHybridAuth } from '@/lib/auth/hybrid'
|
||||
import { SEARCH_TOOL_COST } from '@/lib/billing/constants'
|
||||
import { env } from '@/lib/env'
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
import { executeTool } from '@/tools'
|
||||
|
||||
const logger = createLogger('search')
|
||||
|
||||
const SearchRequestSchema = z.object({
|
||||
query: z.string().min(1),
|
||||
})
|
||||
|
||||
export const maxDuration = 60
|
||||
export const dynamic = 'force-dynamic'
|
||||
|
||||
export async function POST(request: NextRequest) {
|
||||
const requestId = crypto.randomUUID()
|
||||
|
||||
try {
|
||||
const { searchParams: urlParams } = new URL(request.url)
|
||||
const workflowId = urlParams.get('workflowId') || undefined
|
||||
|
||||
const authResult = await checkHybridAuth(request, { requireWorkflowId: false })
|
||||
|
||||
if (!authResult.success || !authResult.userId) {
|
||||
const errorMessage = workflowId ? 'Workflow not found' : authResult.error || 'Unauthorized'
|
||||
const statusCode = workflowId ? 404 : 401
|
||||
return NextResponse.json({ success: false, error: errorMessage }, { status: statusCode })
|
||||
}
|
||||
|
||||
const userId = authResult.userId
|
||||
|
||||
logger.info(`[${requestId}] Authenticated search request via ${authResult.authType}`, {
|
||||
userId,
|
||||
})
|
||||
|
||||
const body = await request.json()
|
||||
const validated = SearchRequestSchema.parse(body)
|
||||
|
||||
if (!env.EXA_API_KEY) {
|
||||
logger.error(`[${requestId}] EXA_API_KEY not configured`)
|
||||
return NextResponse.json(
|
||||
{ success: false, error: 'Search service not configured' },
|
||||
{ status: 503 }
|
||||
)
|
||||
}
|
||||
|
||||
logger.info(`[${requestId}] Executing search`, {
|
||||
userId,
|
||||
query: validated.query,
|
||||
})
|
||||
|
||||
const result = await executeTool('exa_search', {
|
||||
query: validated.query,
|
||||
type: 'auto',
|
||||
useAutoprompt: true,
|
||||
text: true,
|
||||
apiKey: env.EXA_API_KEY,
|
||||
})
|
||||
|
||||
if (!result.success) {
|
||||
logger.error(`[${requestId}] Search failed`, {
|
||||
userId,
|
||||
error: result.error,
|
||||
})
|
||||
return NextResponse.json(
|
||||
{
|
||||
success: false,
|
||||
error: result.error || 'Search failed',
|
||||
},
|
||||
{ status: 500 }
|
||||
)
|
||||
}
|
||||
|
||||
const results = (result.output.results || []).map((r: any, index: number) => ({
|
||||
title: r.title || '',
|
||||
link: r.url || '',
|
||||
snippet: r.text || '',
|
||||
date: r.publishedDate || undefined,
|
||||
position: index + 1,
|
||||
}))
|
||||
|
||||
const cost = {
|
||||
input: 0,
|
||||
output: 0,
|
||||
total: SEARCH_TOOL_COST,
|
||||
tokens: {
|
||||
prompt: 0,
|
||||
completion: 0,
|
||||
total: 0,
|
||||
},
|
||||
model: 'search-exa',
|
||||
pricing: {
|
||||
input: 0,
|
||||
cachedInput: 0,
|
||||
output: 0,
|
||||
updatedAt: new Date().toISOString(),
|
||||
},
|
||||
}
|
||||
|
||||
logger.info(`[${requestId}] Search completed`, {
|
||||
userId,
|
||||
resultCount: results.length,
|
||||
cost: cost.total,
|
||||
})
|
||||
|
||||
return NextResponse.json({
|
||||
results,
|
||||
query: validated.query,
|
||||
totalResults: results.length,
|
||||
source: 'exa',
|
||||
cost,
|
||||
})
|
||||
} catch (error: any) {
|
||||
logger.error(`[${requestId}] Search failed`, {
|
||||
error: error.message,
|
||||
stack: error.stack,
|
||||
})
|
||||
|
||||
return NextResponse.json(
|
||||
{
|
||||
success: false,
|
||||
error: error.message || 'Search failed',
|
||||
},
|
||||
{ status: 500 }
|
||||
)
|
||||
}
|
||||
}
|
||||
227
apps/sim/app/api/tools/smtp/send/route.ts
Normal file
227
apps/sim/app/api/tools/smtp/send/route.ts
Normal file
@@ -0,0 +1,227 @@
|
||||
import { type NextRequest, NextResponse } from 'next/server'
|
||||
import nodemailer from 'nodemailer'
|
||||
import { z } from 'zod'
|
||||
import { checkHybridAuth } from '@/lib/auth/hybrid'
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
import { processFilesToUserFiles } from '@/lib/uploads/utils/file-utils'
|
||||
import { downloadFileFromStorage } from '@/lib/uploads/utils/file-utils.server'
|
||||
import { generateRequestId } from '@/lib/utils'
|
||||
|
||||
export const dynamic = 'force-dynamic'
|
||||
|
||||
const logger = createLogger('SmtpSendAPI')
|
||||
|
||||
const SmtpSendSchema = z.object({
|
||||
smtpHost: z.string().min(1, 'SMTP host is required'),
|
||||
smtpPort: z.number().min(1).max(65535, 'Port must be between 1 and 65535'),
|
||||
smtpUsername: z.string().min(1, 'SMTP username is required'),
|
||||
smtpPassword: z.string().min(1, 'SMTP password is required'),
|
||||
smtpSecure: z.enum(['TLS', 'SSL', 'None']),
|
||||
|
||||
from: z.string().email('Invalid from email address').min(1, 'From address is required'),
|
||||
to: z.string().min(1, 'To email is required'),
|
||||
subject: z.string().min(1, 'Subject is required'),
|
||||
body: z.string().min(1, 'Email body is required'),
|
||||
contentType: z.enum(['text', 'html']).optional().nullable(),
|
||||
|
||||
fromName: z.string().optional().nullable(),
|
||||
cc: z.string().optional().nullable(),
|
||||
bcc: z.string().optional().nullable(),
|
||||
replyTo: z.string().optional().nullable(),
|
||||
attachments: z.array(z.any()).optional().nullable(),
|
||||
})
|
||||
|
||||
export async function POST(request: NextRequest) {
|
||||
const requestId = generateRequestId()
|
||||
|
||||
try {
|
||||
const authResult = await checkHybridAuth(request, { requireWorkflowId: false })
|
||||
|
||||
if (!authResult.success) {
|
||||
logger.warn(`[${requestId}] Unauthorized SMTP send attempt: ${authResult.error}`)
|
||||
return NextResponse.json(
|
||||
{
|
||||
success: false,
|
||||
error: authResult.error || 'Authentication required',
|
||||
},
|
||||
{ status: 401 }
|
||||
)
|
||||
}
|
||||
|
||||
logger.info(`[${requestId}] Authenticated SMTP request via ${authResult.authType}`, {
|
||||
userId: authResult.userId,
|
||||
})
|
||||
|
||||
const body = await request.json()
|
||||
const validatedData = SmtpSendSchema.parse(body)
|
||||
|
||||
logger.info(`[${requestId}] Sending email via SMTP`, {
|
||||
host: validatedData.smtpHost,
|
||||
port: validatedData.smtpPort,
|
||||
to: validatedData.to,
|
||||
subject: validatedData.subject,
|
||||
secure: validatedData.smtpSecure,
|
||||
})
|
||||
|
||||
const transporter = nodemailer.createTransport({
|
||||
host: validatedData.smtpHost,
|
||||
port: validatedData.smtpPort,
|
||||
secure: validatedData.smtpSecure === 'SSL',
|
||||
auth: {
|
||||
user: validatedData.smtpUsername,
|
||||
pass: validatedData.smtpPassword,
|
||||
},
|
||||
tls:
|
||||
validatedData.smtpSecure === 'None'
|
||||
? {
|
||||
rejectUnauthorized: false,
|
||||
}
|
||||
: {
|
||||
rejectUnauthorized: true,
|
||||
},
|
||||
})
|
||||
|
||||
const contentType = validatedData.contentType || 'text'
|
||||
const fromAddress = validatedData.fromName
|
||||
? `"${validatedData.fromName}" <${validatedData.from}>`
|
||||
: validatedData.from
|
||||
|
||||
const mailOptions: nodemailer.SendMailOptions = {
|
||||
from: fromAddress,
|
||||
to: validatedData.to,
|
||||
subject: validatedData.subject,
|
||||
[contentType === 'html' ? 'html' : 'text']: validatedData.body,
|
||||
}
|
||||
|
||||
if (validatedData.cc) {
|
||||
mailOptions.cc = validatedData.cc
|
||||
}
|
||||
if (validatedData.bcc) {
|
||||
mailOptions.bcc = validatedData.bcc
|
||||
}
|
||||
if (validatedData.replyTo) {
|
||||
mailOptions.replyTo = validatedData.replyTo
|
||||
}
|
||||
|
||||
if (validatedData.attachments && validatedData.attachments.length > 0) {
|
||||
const rawAttachments = validatedData.attachments
|
||||
logger.info(`[${requestId}] Processing ${rawAttachments.length} attachment(s)`)
|
||||
|
||||
const attachments = processFilesToUserFiles(rawAttachments, requestId, logger)
|
||||
|
||||
if (attachments.length > 0) {
|
||||
const totalSize = attachments.reduce((sum, file) => sum + file.size, 0)
|
||||
const maxSize = 25 * 1024 * 1024
|
||||
|
||||
if (totalSize > maxSize) {
|
||||
const sizeMB = (totalSize / (1024 * 1024)).toFixed(2)
|
||||
return NextResponse.json(
|
||||
{
|
||||
success: false,
|
||||
error: `Total attachment size (${sizeMB}MB) exceeds SMTP limit of 25MB`,
|
||||
},
|
||||
{ status: 400 }
|
||||
)
|
||||
}
|
||||
|
||||
const attachmentBuffers = await Promise.all(
|
||||
attachments.map(async (file) => {
|
||||
try {
|
||||
logger.info(
|
||||
`[${requestId}] Downloading attachment: ${file.name} (${file.size} bytes)`
|
||||
)
|
||||
|
||||
const buffer = await downloadFileFromStorage(file, requestId, logger)
|
||||
|
||||
return {
|
||||
filename: file.name,
|
||||
content: buffer,
|
||||
contentType: file.type || 'application/octet-stream',
|
||||
}
|
||||
} catch (error) {
|
||||
logger.error(`[${requestId}] Failed to download attachment ${file.name}:`, error)
|
||||
throw new Error(
|
||||
`Failed to download attachment "${file.name}": ${error instanceof Error ? error.message : 'Unknown error'}`
|
||||
)
|
||||
}
|
||||
})
|
||||
)
|
||||
|
||||
logger.info(`[${requestId}] Processed ${attachmentBuffers.length} attachment(s)`)
|
||||
mailOptions.attachments = attachmentBuffers
|
||||
}
|
||||
}
|
||||
|
||||
const result = await transporter.sendMail(mailOptions)
|
||||
|
||||
logger.info(`[${requestId}] Email sent successfully via SMTP`, {
|
||||
messageId: result.messageId,
|
||||
to: validatedData.to,
|
||||
})
|
||||
|
||||
return NextResponse.json({
|
||||
success: true,
|
||||
messageId: result.messageId,
|
||||
to: validatedData.to,
|
||||
subject: validatedData.subject,
|
||||
})
|
||||
} catch (error: unknown) {
|
||||
if (error instanceof z.ZodError) {
|
||||
logger.warn(`[${requestId}] Invalid request data`, { errors: error.errors })
|
||||
return NextResponse.json(
|
||||
{
|
||||
success: false,
|
||||
error: 'Invalid request data',
|
||||
details: error.errors,
|
||||
},
|
||||
{ status: 400 }
|
||||
)
|
||||
}
|
||||
|
||||
// Type guard for error objects with code property
|
||||
const isNodeError = (err: unknown): err is NodeJS.ErrnoException => {
|
||||
return err instanceof Error && 'code' in err
|
||||
}
|
||||
|
||||
let errorMessage = 'Failed to send email via SMTP'
|
||||
|
||||
if (isNodeError(error)) {
|
||||
if (error.code === 'EAUTH') {
|
||||
errorMessage = 'SMTP authentication failed - check username and password'
|
||||
} else if (error.code === 'ECONNECTION' || error.code === 'ECONNREFUSED') {
|
||||
errorMessage = 'Could not connect to SMTP server - check host and port'
|
||||
} else if (error.code === 'ECONNRESET') {
|
||||
errorMessage = 'Connection was reset by SMTP server'
|
||||
} else if (error.code === 'ETIMEDOUT') {
|
||||
errorMessage = 'SMTP server connection timeout'
|
||||
}
|
||||
}
|
||||
|
||||
// Check for SMTP response codes
|
||||
const hasResponseCode = (err: unknown): err is { responseCode: number } => {
|
||||
return typeof err === 'object' && err !== null && 'responseCode' in err
|
||||
}
|
||||
|
||||
if (hasResponseCode(error)) {
|
||||
if (error.responseCode >= 500) {
|
||||
errorMessage = 'SMTP server error - please try again later'
|
||||
} else if (error.responseCode >= 400) {
|
||||
errorMessage = 'Email rejected by SMTP server - check recipient addresses'
|
||||
}
|
||||
}
|
||||
|
||||
logger.error(`[${requestId}] Error sending email via SMTP:`, {
|
||||
error: error instanceof Error ? error.message : String(error),
|
||||
code: isNodeError(error) ? error.code : undefined,
|
||||
responseCode: hasResponseCode(error) ? error.responseCode : undefined,
|
||||
})
|
||||
|
||||
return NextResponse.json(
|
||||
{
|
||||
success: false,
|
||||
error: errorMessage,
|
||||
},
|
||||
{ status: 500 }
|
||||
)
|
||||
}
|
||||
}
|
||||
@@ -69,12 +69,7 @@ export async function POST(request: NextRequest, { params }: { params: Promise<{
|
||||
|
||||
let preprocessError: NextResponse | null = null
|
||||
try {
|
||||
preprocessError = await checkWebhookPreprocessing(
|
||||
foundWorkflow,
|
||||
foundWebhook,
|
||||
requestId,
|
||||
true // testMode - skips usage limits
|
||||
)
|
||||
preprocessError = await checkWebhookPreprocessing(foundWorkflow, foundWebhook, requestId)
|
||||
if (preprocessError) {
|
||||
return preprocessError
|
||||
}
|
||||
|
||||
@@ -11,6 +11,45 @@ import {
|
||||
mockTriggerDevSdk,
|
||||
} from '@/app/api/__test-utils__/utils'
|
||||
|
||||
const {
|
||||
hasProcessedMessageMock,
|
||||
markMessageAsProcessedMock,
|
||||
closeRedisConnectionMock,
|
||||
acquireLockMock,
|
||||
generateRequestHashMock,
|
||||
validateSlackSignatureMock,
|
||||
handleWhatsAppVerificationMock,
|
||||
handleSlackChallengeMock,
|
||||
processWhatsAppDeduplicationMock,
|
||||
processGenericDeduplicationMock,
|
||||
fetchAndProcessAirtablePayloadsMock,
|
||||
processWebhookMock,
|
||||
executeMock,
|
||||
} = vi.hoisted(() => ({
|
||||
hasProcessedMessageMock: vi.fn().mockResolvedValue(false),
|
||||
markMessageAsProcessedMock: vi.fn().mockResolvedValue(true),
|
||||
closeRedisConnectionMock: vi.fn().mockResolvedValue(undefined),
|
||||
acquireLockMock: vi.fn().mockResolvedValue(true),
|
||||
generateRequestHashMock: vi.fn().mockResolvedValue('test-hash-123'),
|
||||
validateSlackSignatureMock: vi.fn().mockResolvedValue(true),
|
||||
handleWhatsAppVerificationMock: vi.fn().mockResolvedValue(null),
|
||||
handleSlackChallengeMock: vi.fn().mockReturnValue(null),
|
||||
processWhatsAppDeduplicationMock: vi.fn().mockResolvedValue(null),
|
||||
processGenericDeduplicationMock: vi.fn().mockResolvedValue(null),
|
||||
fetchAndProcessAirtablePayloadsMock: vi.fn().mockResolvedValue(undefined),
|
||||
processWebhookMock: vi.fn().mockResolvedValue(new Response('Webhook processed', { status: 200 })),
|
||||
executeMock: vi.fn().mockResolvedValue({
|
||||
success: true,
|
||||
output: { response: 'Webhook execution success' },
|
||||
logs: [],
|
||||
metadata: {
|
||||
duration: 100,
|
||||
startTime: new Date().toISOString(),
|
||||
endTime: new Date().toISOString(),
|
||||
},
|
||||
}),
|
||||
}))
|
||||
|
||||
vi.mock('@trigger.dev/sdk', () => ({
|
||||
tasks: {
|
||||
trigger: vi.fn().mockResolvedValue({ id: 'mock-task-id' }),
|
||||
@@ -32,31 +71,6 @@ vi.mock('@/background/logs-webhook-delivery', () => ({
|
||||
logsWebhookDelivery: {},
|
||||
}))
|
||||
|
||||
const hasProcessedMessageMock = vi.fn().mockResolvedValue(false)
|
||||
const markMessageAsProcessedMock = vi.fn().mockResolvedValue(true)
|
||||
const closeRedisConnectionMock = vi.fn().mockResolvedValue(undefined)
|
||||
const acquireLockMock = vi.fn().mockResolvedValue(true)
|
||||
const generateRequestHashMock = vi.fn().mockResolvedValue('test-hash-123')
|
||||
const validateSlackSignatureMock = vi.fn().mockResolvedValue(true)
|
||||
const handleWhatsAppVerificationMock = vi.fn().mockResolvedValue(null)
|
||||
const handleSlackChallengeMock = vi.fn().mockReturnValue(null)
|
||||
const processWhatsAppDeduplicationMock = vi.fn().mockResolvedValue(null)
|
||||
const processGenericDeduplicationMock = vi.fn().mockResolvedValue(null)
|
||||
const fetchAndProcessAirtablePayloadsMock = vi.fn().mockResolvedValue(undefined)
|
||||
const processWebhookMock = vi
|
||||
.fn()
|
||||
.mockResolvedValue(new Response('Webhook processed', { status: 200 }))
|
||||
const executeMock = vi.fn().mockResolvedValue({
|
||||
success: true,
|
||||
output: { response: 'Webhook execution success' },
|
||||
logs: [],
|
||||
metadata: {
|
||||
duration: 100,
|
||||
startTime: new Date().toISOString(),
|
||||
endTime: new Date().toISOString(),
|
||||
},
|
||||
})
|
||||
|
||||
vi.mock('@/lib/redis', () => ({
|
||||
hasProcessedMessage: hasProcessedMessageMock,
|
||||
markMessageAsProcessed: markMessageAsProcessedMock,
|
||||
@@ -76,9 +90,6 @@ vi.mock('@/lib/webhooks/utils', () => ({
|
||||
|
||||
vi.mock('@/app/api/webhooks/utils', () => ({
|
||||
generateRequestHash: generateRequestHashMock,
|
||||
}))
|
||||
|
||||
vi.mock('@/app/api/webhooks/utils', () => ({
|
||||
validateSlackSignature: validateSlackSignatureMock,
|
||||
}))
|
||||
|
||||
@@ -117,7 +128,47 @@ vi.mock('@/lib/logs/execution/logging-session', () => ({
|
||||
})),
|
||||
}))
|
||||
|
||||
process.env.DATABASE_URL = 'postgresql://test:test@localhost:5432/test'
|
||||
vi.mock('@/lib/workspaces/utils', async () => {
|
||||
const actual = await vi.importActual('@/lib/workspaces/utils')
|
||||
return {
|
||||
...(actual as Record<string, unknown>),
|
||||
getWorkspaceBilledAccountUserId: vi
|
||||
.fn()
|
||||
.mockImplementation(async (workspaceId: string | null | undefined) =>
|
||||
workspaceId ? 'test-user-id' : null
|
||||
),
|
||||
}
|
||||
})
|
||||
|
||||
vi.mock('@/services/queue', () => ({
|
||||
RateLimiter: vi.fn().mockImplementation(() => ({
|
||||
checkRateLimit: vi.fn().mockResolvedValue({
|
||||
allowed: true,
|
||||
remaining: 10,
|
||||
resetAt: new Date(),
|
||||
}),
|
||||
})),
|
||||
RateLimitError: class RateLimitError extends Error {
|
||||
constructor(
|
||||
message: string,
|
||||
public statusCode = 429
|
||||
) {
|
||||
super(message)
|
||||
this.name = 'RateLimitError'
|
||||
}
|
||||
},
|
||||
}))
|
||||
|
||||
vi.mock('@/lib/workflows/db-helpers', () => ({
|
||||
loadWorkflowFromNormalizedTables: vi.fn().mockResolvedValue({
|
||||
blocks: {},
|
||||
edges: [],
|
||||
loops: {},
|
||||
parallels: {},
|
||||
isFromNormalizedTables: true,
|
||||
}),
|
||||
blockExistsInDeployment: vi.fn().mockResolvedValue(true),
|
||||
}))
|
||||
|
||||
vi.mock('drizzle-orm/postgres-js', () => ({
|
||||
drizzle: vi.fn().mockReturnValue({}),
|
||||
@@ -125,9 +176,12 @@ vi.mock('drizzle-orm/postgres-js', () => ({
|
||||
|
||||
vi.mock('postgres', () => vi.fn().mockReturnValue({}))
|
||||
|
||||
process.env.DATABASE_URL = 'postgresql://test:test@localhost:5432/test'
|
||||
|
||||
import { POST } from '@/app/api/webhooks/trigger/[path]/route'
|
||||
|
||||
describe('Webhook Trigger API Route', () => {
|
||||
beforeEach(() => {
|
||||
vi.resetModules()
|
||||
vi.clearAllMocks()
|
||||
|
||||
globalMockData.webhooks.length = 0
|
||||
@@ -143,48 +197,6 @@ describe('Webhook Trigger API Route', () => {
|
||||
workspaceId: 'test-workspace-id',
|
||||
})
|
||||
|
||||
vi.doMock('@/lib/workspaces/utils', async () => {
|
||||
const actual = await vi.importActual('@/lib/workspaces/utils')
|
||||
return {
|
||||
...(actual as Record<string, unknown>),
|
||||
getWorkspaceBilledAccountUserId: vi
|
||||
.fn()
|
||||
.mockImplementation(async (workspaceId: string | null | undefined) =>
|
||||
workspaceId ? 'test-user-id' : null
|
||||
),
|
||||
}
|
||||
})
|
||||
|
||||
vi.doMock('@/services/queue', () => ({
|
||||
RateLimiter: vi.fn().mockImplementation(() => ({
|
||||
checkRateLimit: vi.fn().mockResolvedValue({
|
||||
allowed: true,
|
||||
remaining: 10,
|
||||
resetAt: new Date(),
|
||||
}),
|
||||
})),
|
||||
RateLimitError: class RateLimitError extends Error {
|
||||
constructor(
|
||||
message: string,
|
||||
public statusCode = 429
|
||||
) {
|
||||
super(message)
|
||||
this.name = 'RateLimitError'
|
||||
}
|
||||
},
|
||||
}))
|
||||
|
||||
vi.doMock('@/lib/workflows/db-helpers', () => ({
|
||||
loadWorkflowFromNormalizedTables: vi.fn().mockResolvedValue({
|
||||
blocks: {},
|
||||
edges: [],
|
||||
loops: {},
|
||||
parallels: {},
|
||||
isFromNormalizedTables: true,
|
||||
}),
|
||||
blockExistsInDeployment: vi.fn().mockResolvedValue(true),
|
||||
}))
|
||||
|
||||
hasProcessedMessageMock.mockResolvedValue(false)
|
||||
markMessageAsProcessedMock.mockResolvedValue(true)
|
||||
acquireLockMock.mockResolvedValue(true)
|
||||
@@ -208,8 +220,6 @@ describe('Webhook Trigger API Route', () => {
|
||||
|
||||
const params = Promise.resolve({ path: 'non-existent-path' })
|
||||
|
||||
const { POST } = await import('@/app/api/webhooks/trigger/[path]/route')
|
||||
|
||||
const response = await POST(req, { params })
|
||||
|
||||
expect(response.status).toBe(404)
|
||||
@@ -239,7 +249,6 @@ describe('Webhook Trigger API Route', () => {
|
||||
const req = createMockRequest('POST', { event: 'test', id: 'test-123' })
|
||||
const params = Promise.resolve({ path: 'test-path' })
|
||||
|
||||
const { POST } = await import('@/app/api/webhooks/trigger/[path]/route')
|
||||
const response = await POST(req, { params })
|
||||
|
||||
expect(response.status).toBe(200)
|
||||
@@ -273,7 +282,6 @@ describe('Webhook Trigger API Route', () => {
|
||||
const req = createMockRequest('POST', { event: 'bearer.test' }, headers)
|
||||
const params = Promise.resolve({ path: 'test-path' })
|
||||
|
||||
const { POST } = await import('@/app/api/webhooks/trigger/[path]/route')
|
||||
const response = await POST(req, { params })
|
||||
|
||||
expect(response.status).toBe(200)
|
||||
@@ -305,7 +313,6 @@ describe('Webhook Trigger API Route', () => {
|
||||
const req = createMockRequest('POST', { event: 'custom.header.test' }, headers)
|
||||
const params = Promise.resolve({ path: 'test-path' })
|
||||
|
||||
const { POST } = await import('@/app/api/webhooks/trigger/[path]/route')
|
||||
const response = await POST(req, { params })
|
||||
|
||||
expect(response.status).toBe(200)
|
||||
@@ -347,7 +354,6 @@ describe('Webhook Trigger API Route', () => {
|
||||
const req = createMockRequest('POST', { event: 'case.test' }, headers)
|
||||
const params = Promise.resolve({ path: 'test-path' })
|
||||
|
||||
const { POST } = await import('@/app/api/webhooks/trigger/[path]/route')
|
||||
const response = await POST(req, { params })
|
||||
|
||||
expect(response.status).toBe(200)
|
||||
@@ -389,7 +395,6 @@ describe('Webhook Trigger API Route', () => {
|
||||
const req = createMockRequest('POST', { event: 'custom.case.test' }, headers)
|
||||
const params = Promise.resolve({ path: 'test-path' })
|
||||
|
||||
const { POST } = await import('@/app/api/webhooks/trigger/[path]/route')
|
||||
const response = await POST(req, { params })
|
||||
|
||||
expect(response.status).toBe(200)
|
||||
@@ -413,7 +418,6 @@ describe('Webhook Trigger API Route', () => {
|
||||
const req = createMockRequest('POST', { event: 'wrong.token.test' }, headers)
|
||||
const params = Promise.resolve({ path: 'test-path' })
|
||||
|
||||
const { POST } = await import('@/app/api/webhooks/trigger/[path]/route')
|
||||
const response = await POST(req, { params })
|
||||
|
||||
expect(response.status).toBe(401)
|
||||
@@ -442,7 +446,6 @@ describe('Webhook Trigger API Route', () => {
|
||||
const req = createMockRequest('POST', { event: 'wrong.custom.test' }, headers)
|
||||
const params = Promise.resolve({ path: 'test-path' })
|
||||
|
||||
const { POST } = await import('@/app/api/webhooks/trigger/[path]/route')
|
||||
const response = await POST(req, { params })
|
||||
|
||||
expect(response.status).toBe(401)
|
||||
@@ -463,7 +466,6 @@ describe('Webhook Trigger API Route', () => {
|
||||
const req = createMockRequest('POST', { event: 'no.auth.test' })
|
||||
const params = Promise.resolve({ path: 'test-path' })
|
||||
|
||||
const { POST } = await import('@/app/api/webhooks/trigger/[path]/route')
|
||||
const response = await POST(req, { params })
|
||||
|
||||
expect(response.status).toBe(401)
|
||||
@@ -492,7 +494,6 @@ describe('Webhook Trigger API Route', () => {
|
||||
const req = createMockRequest('POST', { event: 'exclusivity.test' }, headers)
|
||||
const params = Promise.resolve({ path: 'test-path' })
|
||||
|
||||
const { POST } = await import('@/app/api/webhooks/trigger/[path]/route')
|
||||
const response = await POST(req, { params })
|
||||
|
||||
expect(response.status).toBe(401)
|
||||
@@ -521,7 +522,6 @@ describe('Webhook Trigger API Route', () => {
|
||||
const req = createMockRequest('POST', { event: 'wrong.header.name.test' }, headers)
|
||||
const params = Promise.resolve({ path: 'test-path' })
|
||||
|
||||
const { POST } = await import('@/app/api/webhooks/trigger/[path]/route')
|
||||
const response = await POST(req, { params })
|
||||
|
||||
expect(response.status).toBe(401)
|
||||
@@ -547,7 +547,6 @@ describe('Webhook Trigger API Route', () => {
|
||||
const req = createMockRequest('POST', { event: 'no.token.config.test' }, headers)
|
||||
const params = Promise.resolve({ path: 'test-path' })
|
||||
|
||||
const { POST } = await import('@/app/api/webhooks/trigger/[path]/route')
|
||||
const response = await POST(req, { params })
|
||||
|
||||
expect(response.status).toBe(401)
|
||||
|
||||
@@ -125,12 +125,7 @@ export async function POST(
|
||||
|
||||
let preprocessError: NextResponse | null = null
|
||||
try {
|
||||
preprocessError = await checkWebhookPreprocessing(
|
||||
foundWorkflow,
|
||||
foundWebhook,
|
||||
requestId,
|
||||
false // testMode
|
||||
)
|
||||
preprocessError = await checkWebhookPreprocessing(foundWorkflow, foundWebhook, requestId)
|
||||
if (preprocessError) {
|
||||
return preprocessError
|
||||
}
|
||||
|
||||
@@ -29,6 +29,7 @@ import {
|
||||
DropdownMenuItem,
|
||||
DropdownMenuTrigger,
|
||||
} from '@/components/ui/dropdown-menu'
|
||||
import { VerifiedBadge } from '@/components/ui/verified-badge'
|
||||
import { useSession } from '@/lib/auth-client'
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
import { getBaseUrl } from '@/lib/urls/utils'
|
||||
@@ -64,6 +65,7 @@ export default function TemplateDetails({ isWorkspaceContext = false }: Template
|
||||
const [isEditing, setIsEditing] = useState(false)
|
||||
const [isApproving, setIsApproving] = useState(false)
|
||||
const [isRejecting, setIsRejecting] = useState(false)
|
||||
const [isVerifying, setIsVerifying] = useState(false)
|
||||
const [hasWorkspaceAccess, setHasWorkspaceAccess] = useState<boolean | null>(null)
|
||||
const [workspaces, setWorkspaces] = useState<
|
||||
Array<{ id: string; name: string; permissions: string }>
|
||||
@@ -462,6 +464,32 @@ export default function TemplateDetails({ isWorkspaceContext = false }: Template
|
||||
}
|
||||
}
|
||||
|
||||
const handleToggleVerification = async () => {
|
||||
if (isVerifying || !template?.creator?.id) return
|
||||
|
||||
setIsVerifying(true)
|
||||
try {
|
||||
const endpoint = `/api/creators/${template.creator.id}/verify`
|
||||
const method = template.creator.verified ? 'DELETE' : 'POST'
|
||||
|
||||
const response = await fetch(endpoint, { method })
|
||||
|
||||
if (response.ok) {
|
||||
// Refresh page to show updated verification status
|
||||
window.location.reload()
|
||||
} else {
|
||||
const error = await response.json()
|
||||
logger.error('Error toggling verification:', error)
|
||||
alert(`Failed to ${template.creator.verified ? 'unverify' : 'verify'} creator`)
|
||||
}
|
||||
} catch (error) {
|
||||
logger.error('Error toggling verification:', error)
|
||||
alert('An error occurred while toggling verification')
|
||||
} finally {
|
||||
setIsVerifying(false)
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Shares the template to X (Twitter)
|
||||
*/
|
||||
@@ -718,9 +746,12 @@ export default function TemplateDetails({ isWorkspaceContext = false }: Template
|
||||
</div>
|
||||
)}
|
||||
{/* Creator name */}
|
||||
<span className='font-medium text-[#8B8B8B] text-[14px]'>
|
||||
{template.creator?.name || 'Unknown'}
|
||||
</span>
|
||||
<div className='flex items-center gap-[4px]'>
|
||||
<span className='font-medium text-[#8B8B8B] text-[14px]'>
|
||||
{template.creator?.name || 'Unknown'}
|
||||
</span>
|
||||
{template.creator?.verified && <VerifiedBadge size='md' />}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Credentials needed */}
|
||||
@@ -849,9 +880,25 @@ export default function TemplateDetails({ isWorkspaceContext = false }: Template
|
||||
template.creator.details?.websiteUrl ||
|
||||
template.creator.details?.contactEmail) && (
|
||||
<div className='mt-8'>
|
||||
<h3 className='mb-4 font-sans font-semibold text-base text-foreground'>
|
||||
About the Creator
|
||||
</h3>
|
||||
<div className='mb-4 flex items-center justify-between'>
|
||||
<h3 className='font-sans font-semibold text-base text-foreground'>
|
||||
About the Creator
|
||||
</h3>
|
||||
{isSuperUser && template.creator && (
|
||||
<Button
|
||||
variant={template.creator.verified ? 'active' : 'default'}
|
||||
onClick={handleToggleVerification}
|
||||
disabled={isVerifying}
|
||||
className='h-[28px] rounded-[6px] text-[12px]'
|
||||
>
|
||||
{isVerifying
|
||||
? 'Updating...'
|
||||
: template.creator.verified
|
||||
? 'Unverify Creator'
|
||||
: 'Verify Creator'}
|
||||
</Button>
|
||||
)}
|
||||
</div>
|
||||
<div className='flex items-start gap-4'>
|
||||
{/* Creator profile image */}
|
||||
{template.creator.profileImageUrl ? (
|
||||
@@ -871,9 +918,12 @@ export default function TemplateDetails({ isWorkspaceContext = false }: Template
|
||||
{/* Creator details */}
|
||||
<div className='flex-1'>
|
||||
<div className='mb-[5px] flex items-center gap-3'>
|
||||
<h4 className='font-sans font-semibold text-base text-foreground'>
|
||||
{template.creator.name}
|
||||
</h4>
|
||||
<div className='flex items-center gap-[6px]'>
|
||||
<h4 className='font-sans font-semibold text-base text-foreground'>
|
||||
{template.creator.name}
|
||||
</h4>
|
||||
{template.creator.verified && <VerifiedBadge size='md' />}
|
||||
</div>
|
||||
|
||||
{/* Social links */}
|
||||
<div className='flex items-center gap-[12px]'>
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
import { memo, useCallback, useEffect, useMemo, useRef, useState } from 'react'
|
||||
import { Star, User } from 'lucide-react'
|
||||
import { useParams, useRouter } from 'next/navigation'
|
||||
import { VerifiedBadge } from '@/components/ui/verified-badge'
|
||||
import { createLogger } from '@/lib/logs/console/logger'
|
||||
import { cn } from '@/lib/utils'
|
||||
import { WorkflowPreview } from '@/app/workspace/[workspaceId]/w/components/workflow-preview/workflow-preview'
|
||||
@@ -21,6 +22,7 @@ interface TemplateCardProps {
|
||||
className?: string
|
||||
state?: WorkflowState
|
||||
isStarred?: boolean
|
||||
isVerified?: boolean
|
||||
}
|
||||
|
||||
export function TemplateCardSkeleton({ className }: { className?: string }) {
|
||||
@@ -125,6 +127,7 @@ function TemplateCardInner({
|
||||
className,
|
||||
state,
|
||||
isStarred = false,
|
||||
isVerified = false,
|
||||
}: TemplateCardProps) {
|
||||
const router = useRouter()
|
||||
const params = useParams()
|
||||
@@ -276,7 +279,10 @@ function TemplateCardInner({
|
||||
<User className='h-[18px] w-[18px] text-[#888888]' />
|
||||
</div>
|
||||
)}
|
||||
<span className='truncate font-medium text-[#888888] text-[12px]'>{author}</span>
|
||||
<div className='flex items-center gap-[4px]'>
|
||||
<span className='truncate font-medium text-[#888888] text-[12px]'>{author}</span>
|
||||
{isVerified && <VerifiedBadge size='sm' />}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className='flex flex-shrink-0 items-center gap-[6px] font-medium text-[#888888] text-[12px]'>
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user