mirror of
https://github.com/simstudioai/sim.git
synced 2026-01-09 06:58:07 -05:00
feat(i18n): update translations (#1926)
* feat(i18n): update translations * fix build --------- Co-authored-by: waleedlatif1 <waleedlatif1@users.noreply.github.com>
This commit is contained in:
@@ -13,7 +13,7 @@ Der Bedingungsblock verzweigt die Workflow-Ausführung basierend auf booleschen
|
||||
src="/static/blocks/condition.png"
|
||||
alt="Bedingungsblock"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -11,7 +11,7 @@ Der Funktionsblock führt benutzerdefinierten JavaScript- oder TypeScript-Code i
|
||||
src="/static/blocks/function.png"
|
||||
alt="Funktionsblock mit Code-Editor"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -11,9 +11,9 @@ Der Guardrails-Block validiert und schützt Ihre KI-Workflows, indem er Inhalte
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/guardrails.png"
|
||||
alt="Guardrails Block"
|
||||
alt="Guardrails-Block"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -149,20 +149,16 @@ Jede parallele Instanz läuft unabhängig:
|
||||
- Sie können keinen Container-Block in einen anderen Container-Block platzieren
|
||||
</Callout>
|
||||
|
||||
<Callout type="warning">
|
||||
Parallele Blöcke können nur einen einzigen Block enthalten. Sie können nicht mehrere Blöcke haben, die innerhalb einer Parallele miteinander verbunden sind - in diesem Fall würde nur der erste Block ausgeführt werden.
|
||||
</Callout>
|
||||
|
||||
<Callout type="info">
|
||||
Während die parallele Ausführung schneller ist, sollten Sie auf Folgendes achten:
|
||||
Während die parallele Ausführung schneller ist, beachten Sie bitte:
|
||||
- API-Ratenbegrenzungen bei gleichzeitigen Anfragen
|
||||
- Speichernutzung bei großen Datensätzen
|
||||
- Maximal 20 gleichzeitige Instanzen, um Ressourcenerschöpfung zu vermeiden
|
||||
- Speicherverbrauch bei großen Datensätzen
|
||||
- Maximum von 20 gleichzeitigen Instanzen, um Ressourcenerschöpfung zu vermeiden
|
||||
</Callout>
|
||||
|
||||
## Parallel vs. Schleife
|
||||
|
||||
Verständnis, wann was zu verwenden ist:
|
||||
Wann Sie welche Methode verwenden sollten:
|
||||
|
||||
| Funktion | Parallel | Schleife |
|
||||
|---------|----------|------|
|
||||
@@ -178,7 +174,7 @@ Verständnis, wann was zu verwenden ist:
|
||||
<Tab>
|
||||
<ul className="list-disc space-y-2 pl-6">
|
||||
<li>
|
||||
<strong>Paralleltyp</strong>: Wählen Sie zwischen 'count' oder 'collection'
|
||||
<strong>Parallel-Typ</strong>: Wählen Sie zwischen 'count' oder 'collection'
|
||||
</li>
|
||||
<li>
|
||||
<strong>Anzahl</strong>: Anzahl der auszuführenden Instanzen (anzahlbasiert)
|
||||
@@ -207,14 +203,14 @@ Verständnis, wann was zu verwenden ist:
|
||||
<strong>parallel.results</strong>: Array aller Instanzergebnisse
|
||||
</li>
|
||||
<li>
|
||||
<strong>Zugriff</strong>: Verfügbar in Blöcken nach der Parallele
|
||||
<strong>Zugriff</strong>: Verfügbar in Blöcken nach der Parallelausführung
|
||||
</li>
|
||||
</ul>
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
## Bewährte Methoden
|
||||
## Best Practices
|
||||
|
||||
- **Nur unabhängige Operationen**: Stellen Sie sicher, dass Operationen nicht voneinander abhängen
|
||||
- **Umgang mit Ratenbegrenzungen**: Fügen Sie Verzögerungen oder Drosselungen für API-intensive Workflows hinzu
|
||||
- **Ratenbegrenzungen berücksichtigen**: Fügen Sie Verzögerungen oder Drosselungen für API-intensive Workflows hinzu
|
||||
- **Fehlerbehandlung**: Jede Instanz sollte ihre eigenen Fehler angemessen behandeln
|
||||
|
||||
@@ -13,7 +13,7 @@ Der Variablen-Block aktualisiert Workflow-Variablen während der Ausführung. Va
|
||||
src="/static/blocks/variables.png"
|
||||
alt="Variablen-Block"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -11,9 +11,9 @@ Der Warten-Block pausiert deinen Workflow für eine bestimmte Zeit, bevor er mit
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/wait.png"
|
||||
alt="Warten-Block"
|
||||
alt="Warte-Block"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -12,8 +12,8 @@ import { Image } from '@/components/ui/image'
|
||||
<Image
|
||||
src='/static/blocks/workflow.png'
|
||||
alt='Workflow-Block-Konfiguration'
|
||||
width={400}
|
||||
height={280}
|
||||
width={500}
|
||||
height={400}
|
||||
className='rounded-xl border border-border shadow-sm'
|
||||
/>
|
||||
</div>
|
||||
@@ -40,10 +40,22 @@ Füge einen Workflow-Block hinzu, wenn du einen untergeordneten Workflow als Tei
|
||||
- `success` – ob er ohne Fehler ausgeführt wurde
|
||||
- `error` – Nachricht, wenn die Ausführung fehlschlägt
|
||||
|
||||
## Ausführungshinweise
|
||||
## Bereitstellungsstatus-Badge
|
||||
|
||||
- Untergeordnete Workflows werden im gleichen Workspace-Kontext ausgeführt, sodass Umgebungsvariablen und Tools übernommen werden.
|
||||
- Der Block verwendet Deployment-Versionierung: jede API-, Zeitplan-, Webhook-, manuelle oder Chat-Ausführung ruft den bereitgestellten Snapshot auf. Stelle den untergeordneten Workflow neu bereit, wenn du ihn änderst.
|
||||
Der Workflow-Block zeigt ein Bereitstellungsstatus-Badge an, das dir hilft zu verfolgen, ob der untergeordnete Workflow ausführungsbereit ist:
|
||||
|
||||
- **Bereitgestellt** – Der untergeordnete Workflow wurde bereitgestellt und ist einsatzbereit. Der Block führt die aktuell bereitgestellte Version aus.
|
||||
- **Nicht bereitgestellt** – Der untergeordnete Workflow wurde noch nie bereitgestellt. Du musst ihn bereitstellen, bevor der Workflow-Block ihn ausführen kann.
|
||||
- **Erneut bereitstellen** – Seit der letzten Bereitstellung wurden Änderungen im untergeordneten Workflow erkannt. Klicke auf das Badge, um den untergeordneten Workflow mit den neuesten Änderungen erneut bereitzustellen.
|
||||
|
||||
<Callout type="warn">
|
||||
Der Workflow-Block führt immer die zuletzt bereitgestellte Version des untergeordneten Workflows aus, nicht die Editor-Version. Stelle sicher, dass du nach Änderungen eine erneute Bereitstellung durchführst, damit der Block die neueste Logik verwendet.
|
||||
</Callout>
|
||||
|
||||
## Hinweise zur Ausführung
|
||||
|
||||
- Untergeordnete Workflows laufen im gleichen Workspace-Kontext, sodass Umgebungsvariablen und Tools übernommen werden.
|
||||
- Der Block verwendet Bereitstellungsversionierung: Jede API-, Zeitplan-, Webhook-, manuelle oder Chat-Ausführung ruft den bereitgestellten Snapshot auf. Stelle den untergeordneten Workflow nach Änderungen erneut bereit.
|
||||
- Wenn der untergeordnete Workflow fehlschlägt, löst der Block einen Fehler aus, es sei denn, du behandelst ihn nachgelagert.
|
||||
|
||||
<Callout>
|
||||
|
||||
@@ -10,43 +10,57 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
Das [MongoDB](https://www.mongodb.com/)-Tool ermöglicht es Ihnen, eine Verbindung zu einer MongoDB-Datenbank herzustellen und eine Vielzahl von dokumentenorientierten Operationen direkt innerhalb Ihrer agentischen Workflows durchzuführen. Mit flexibler Konfiguration und sicherem Verbindungsmanagement können Sie einfach mit Ihren Daten interagieren und diese manipulieren.
|
||||
|
||||
Mit dem MongoDB-Tool können Sie:
|
||||
|
||||
- **Dokumente finden**: Sammlungen abfragen und Dokumente mit der `mongodb_query`Operation unter Verwendung umfangreicher Abfragefilter abrufen.
|
||||
- **Dokumente einfügen**: Fügen Sie ein oder mehrere Dokumente zu einer Sammlung mit der `mongodb_insert`Operation hinzu.
|
||||
- **Dokumente aktualisieren**: Ändern Sie bestehende Dokumente mit der `mongodb_update`Operation, indem Sie Filterkriterien und Aktualisierungsaktionen angeben.
|
||||
- **Dokumente löschen**: Entfernen Sie Dokumente aus einer Sammlung mit der `mongodb_delete`Operation, indem Sie Filter und Löschoptionen angeben.
|
||||
- **Daten aggregieren**: Führen Sie komplexe Aggregationspipelines mit der `mongodb_execute`Operation aus, um Ihre Daten zu transformieren und zu analysieren.
|
||||
|
||||
Das MongoDB-Tool ist ideal für Workflows, bei denen Ihre Agenten strukturierte, dokumentenbasierte Daten verwalten oder analysieren müssen. Ob bei der Verarbeitung von benutzergenerierten Inhalten, der Verwaltung von App-Daten oder der Unterstützung von Analysen - das MongoDB-Tool vereinfacht den Datenzugriff und die Datenmanipulation auf sichere, programmatische Weise.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Gebrauchsanweisung
|
||||
|
||||
MongoDB in den Workflow integrieren. Kann Daten finden, einfügen, aktualisieren, löschen und aggregieren.
|
||||
Integrieren Sie MongoDB in den Workflow. Kann Daten finden, einfügen, aktualisieren, löschen und aggregieren.
|
||||
|
||||
## Tools
|
||||
|
||||
### `mongodb_query`
|
||||
|
||||
Führt eine Find-Operation auf einer MongoDB-Kollektion aus
|
||||
Führt eine Suchoperation in einer MongoDB-Sammlung aus
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `host` | string | Ja | MongoDB-Server-Hostname oder IP-Adresse |
|
||||
| `port` | number | Ja | MongoDB-Server-Port \(Standard: 27017\) |
|
||||
| `database` | string | Ja | Name der Datenbank, zu der verbunden werden soll |
|
||||
| `username` | string | Nein | MongoDB-Benutzername |
|
||||
| `password` | string | Nein | MongoDB-Passwort |
|
||||
| `authSource` | string | Nein | Authentifizierungsdatenbank |
|
||||
| `ssl` | string | Nein | SSL-Verbindungsmodus \(disabled, required, preferred\) |
|
||||
| `collection` | string | Ja | Name der zu abfragenden Kollektion |
|
||||
| `query` | string | Nein | MongoDB-Abfragefilter als JSON-String |
|
||||
| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Dokumente |
|
||||
| `sort` | string | Nein | Sortierkriterien als JSON-String |
|
||||
| `host` | string | Yes | MongoDB-Server-Hostname oder IP-Adresse |
|
||||
| `port` | number | Yes | MongoDB-Server-Port \(Standard: 27017\) |
|
||||
| `database` | string | Yes | Datenbankname, zu dem eine Verbindung hergestellt werden soll |
|
||||
| `username` | string | No | MongoDB-Benutzername |
|
||||
| `password` | string | No | MongoDB-Passwort |
|
||||
| `authSource` | string | No | Authentifizierungsdatenbank |
|
||||
| `ssl` | string | No | SSL-Verbindungsmodus \(disabled, required, preferred\) |
|
||||
| `collection` | string | Yes | Name der abzufragenden Sammlung |
|
||||
| `query` | string | No | MongoDB-Abfragefilter als JSON-String |
|
||||
| `limit` | number | No | Maximale Anzahl der zurückzugebenden Dokumente |
|
||||
| `sort` | string | No | Sortierkriterien als JSON-String |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `documents` | array | Array von Dokumenten, die von der Abfrage zurückgegeben wurden |
|
||||
| `documents` | array | Array der aus der Abfrage zurückgegebenen Dokumente |
|
||||
| `documentCount` | number | Anzahl der zurückgegebenen Dokumente |
|
||||
|
||||
### `mongodb_insert`
|
||||
|
||||
Dokumente in MongoDB-Kollektion einfügen
|
||||
Dokumente in MongoDB-Sammlung einfügen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
@@ -59,8 +73,8 @@ Dokumente in MongoDB-Kollektion einfügen
|
||||
| `password` | string | Nein | MongoDB-Passwort |
|
||||
| `authSource` | string | Nein | Authentifizierungsdatenbank |
|
||||
| `ssl` | string | Nein | SSL-Verbindungsmodus \(disabled, required, preferred\) |
|
||||
| `collection` | string | Ja | Name der Kollektion, in die eingefügt werden soll |
|
||||
| `documents` | array | Ja | Array von einzufügenden Dokumenten |
|
||||
| `collection` | string | Ja | Name der Sammlung, in die eingefügt werden soll |
|
||||
| `documents` | array | Ja | Array der einzufügenden Dokumente |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
@@ -69,7 +83,7 @@ Dokumente in MongoDB-Kollektion einfügen
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `documentCount` | number | Anzahl der eingefügten Dokumente |
|
||||
| `insertedId` | string | ID des eingefügten Dokuments \(einzelnes Einfügen\) |
|
||||
| `insertedIds` | array | Array der eingefügten Dokument-IDs \(mehrfaches Einfügen\) |
|
||||
| `insertedIds` | array | Array der IDs der eingefügten Dokumente \(mehrfaches Einfügen\) |
|
||||
|
||||
### `mongodb_update`
|
||||
|
||||
@@ -99,7 +113,7 @@ Dokumente in MongoDB-Sammlung aktualisieren
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `matchedCount` | number | Anzahl der vom Filter gefundenen Dokumente |
|
||||
| `modifiedCount` | number | Anzahl der geänderten Dokumente |
|
||||
| `documentCount` | number | Gesamtanzahl der betroffenen Dokumente |
|
||||
| `documentCount` | number | Gesamtzahl der betroffenen Dokumente |
|
||||
| `insertedId` | string | ID des eingefügten Dokuments \(bei Upsert\) |
|
||||
|
||||
### `mongodb_delete`
|
||||
@@ -127,7 +141,7 @@ Dokumente aus MongoDB-Sammlung löschen
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `deletedCount` | number | Anzahl der gelöschten Dokumente |
|
||||
| `documentCount` | number | Gesamtzahl der betroffenen Dokumente |
|
||||
| `documentCount` | number | Gesamtanzahl der betroffenen Dokumente |
|
||||
|
||||
### `mongodb_execute`
|
||||
|
||||
@@ -152,7 +166,7 @@ MongoDB-Aggregationspipeline ausführen
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Statusmeldung der Operation |
|
||||
| `documents` | array | Array von Dokumenten, die aus der Aggregation zurückgegeben wurden |
|
||||
| `documents` | array | Array von Dokumenten, die von der Aggregation zurückgegeben wurden |
|
||||
| `documentCount` | number | Anzahl der zurückgegebenen Dokumente |
|
||||
|
||||
## Hinweise
|
||||
|
||||
@@ -10,9 +10,23 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
## Nutzungsanweisungen
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
Das [Salesforce](https://www.salesforce.com/)-Tool ermöglicht es Ihnen, eine direkte Verbindung zu Ihrem Salesforce CRM herzustellen und eine Vielzahl von Kundenbeziehungsmanagement-Operationen innerhalb Ihrer agentischen Workflows durchzuführen. Mit nahtloser und sicherer Integration können Sie effizient auf wichtige Geschäftsprozesse zugreifen und diese automatisieren - über Ihre Vertriebs-, Support- und Marketingdaten hinweg.
|
||||
|
||||
Integrieren Sie Salesforce in Ihren Arbeitsablauf. Verwalten Sie Konten, Kontakte, Leads, Opportunities, Fälle und Aufgaben mit leistungsstarken Automatisierungsfunktionen.
|
||||
Mit dem Salesforce-Tool können Sie:
|
||||
|
||||
- **Konten abrufen**: Verwenden Sie die `salesforce_get_accounts`Operation, um Accounts aus Salesforce mit benutzerdefinierten Filtern, Sortierung und Feldauswahl abzurufen.
|
||||
- **Konten erstellen**: Fügen Sie automatisch neue Accounts zu Salesforce hinzu, indem Sie die `salesforce_create_account`Operation verwenden und Details wie Name, Branche und Rechnungsadresse angeben.
|
||||
- **Kontakte verwalten**: (Falls verfügbar, ähnliche Tools für Kontakte – Hinzufügen, Aktualisieren oder Abrufen von Kontakten nach Bedarf.)
|
||||
- **Leads & Opportunities verwalten**: Integrieren Sie Lead- und Opportunity-Management in Ihren Workflow und ermöglichen Sie Ihren Agenten, Vertriebspipeline-Daten zu erfassen, zu qualifizieren und zu aktualisieren.
|
||||
- **Fälle & Aufgaben verfolgen**: Automatisieren Sie Kundensupport und Follow-up-Aktivitäten durch Interaktion mit Cases und Tasks in Salesforce.
|
||||
|
||||
Das Salesforce-Tool ist ideal für Workflows, bei denen Ihre Agenten Vertriebs-, Kontomanagement-, Lead-Generierungs- und Support-Operationen optimieren müssen. Ob Ihre Agenten Daten über Plattformen hinweg synchronisieren, Echtzeit-Kundeneinblicke bereitstellen oder routinemäßige CRM-Updates automatisieren – das Salesforce-Tool bringt die volle Leistung und Erweiterbarkeit von Salesforce in Ihre programmatischen, agentengesteuerten Prozesse.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Nutzungsanleitung
|
||||
|
||||
Integrieren Sie Salesforce in Ihren Workflow. Verwalten Sie Konten, Kontakte, Leads, Opportunities, Cases und Aufgaben mit leistungsstarken Automatisierungsfunktionen.
|
||||
|
||||
## Tools
|
||||
|
||||
@@ -23,8 +37,8 @@ Konten aus Salesforce CRM abrufen
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `idToken` | string | Nein | Das ID-Token von Salesforce OAuth \(enthält Instanz-URL\) |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `idToken` | string | Nein | Das ID-Token aus Salesforce OAuth \(enthält Instanz-URL\) |
|
||||
| `instanceUrl` | string | Nein | Die Salesforce-Instanz-URL |
|
||||
| `limit` | string | Nein | Anzahl der zurückzugebenden Ergebnisse \(Standard: 100, max: 2000\) |
|
||||
| `fields` | string | Nein | Kommagetrennte Liste der zurückzugebenden Felder \(z.B. "Id,Name,Industry,Phone"\) |
|
||||
@@ -34,12 +48,12 @@ Konten aus Salesforce CRM abrufen
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Status des Operationserfolgs |
|
||||
| `output` | object | Kontendaten |
|
||||
| `success` | boolean | Erfolgsstatus der Operation |
|
||||
| `output` | object | Kontodaten |
|
||||
|
||||
### `salesforce_create_account`
|
||||
|
||||
Neues Konto in Salesforce CRM erstellen
|
||||
Ein neues Konto im Salesforce CRM erstellen
|
||||
|
||||
#### Eingabe
|
||||
|
||||
@@ -52,6 +66,38 @@ Neues Konto in Salesforce CRM erstellen
|
||||
| `industry` | string | Nein | Branche \(z.B. Technologie, Gesundheitswesen, Finanzen\) |
|
||||
| `phone` | string | Nein | Telefonnummer |
|
||||
| `website` | string | Nein | Website-URL |
|
||||
| `billingStreet` | string | Nein | Rechnungsadresse |
|
||||
| `billingCity` | string | Nein | Rechnungsstadt |
|
||||
| `billingState` | string | Nein | Rechnungsbundesland/Provinz |
|
||||
| `billingPostalCode` | string | Nein | Rechnungspostleitzahl |
|
||||
| `billingCountry` | string | Nein | Rechnungsland |
|
||||
| `description` | string | Nein | Kontobeschreibung |
|
||||
| `annualRevenue` | string | Nein | Jahresumsatz \(Zahl\) |
|
||||
| `numberOfEmployees` | string | Nein | Anzahl der Mitarbeiter \(Zahl\) |
|
||||
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Erfolgsstatus der Operation |
|
||||
| `output` | object | Daten des erstellten Kontos |
|
||||
|
||||
### `salesforce_update_account`
|
||||
|
||||
Aktualisieren eines bestehenden Kontos in Salesforce CRM
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `idToken` | string | Nein | Keine Beschreibung |
|
||||
| `instanceUrl` | string | Nein | Keine Beschreibung |
|
||||
| `accountId` | string | Ja | Zu aktualisierende Konto-ID \(erforderlich\) |
|
||||
| `name` | string | Nein | Kontoname |
|
||||
| `type` | string | Nein | Kontotyp |
|
||||
| `industry` | string | Nein | Branche |
|
||||
| `phone` | string | Nein | Telefonnummer |
|
||||
| `website` | string | Nein | Website-URL |
|
||||
| `billingStreet` | string | Nein | Rechnungsadresse \(Straße\) |
|
||||
| `billingCity` | string | Nein | Rechnungsadresse \(Stadt\) |
|
||||
| `billingState` | string | Nein | Rechnungsadresse \(Bundesland/Provinz\) |
|
||||
@@ -61,39 +107,7 @@ Neues Konto in Salesforce CRM erstellen
|
||||
| `annualRevenue` | string | Nein | Jahresumsatz \(Zahl\) |
|
||||
| `numberOfEmployees` | string | Nein | Anzahl der Mitarbeiter \(Zahl\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Status des Operationserfolgs |
|
||||
| `output` | object | Erstellte Kontodaten |
|
||||
|
||||
### `salesforce_update_account`
|
||||
|
||||
Aktualisieren eines bestehenden Kontos in Salesforce CRM
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `idToken` | string | Nein | Keine Beschreibung |
|
||||
| `instanceUrl` | string | Nein | Keine Beschreibung |
|
||||
| `accountId` | string | Ja | Zu aktualisierende Konto-ID (erforderlich) |
|
||||
| `name` | string | Nein | Kontoname |
|
||||
| `type` | string | Nein | Kontotyp |
|
||||
| `industry` | string | Nein | Branche |
|
||||
| `phone` | string | Nein | Telefonnummer |
|
||||
| `website` | string | Nein | Website-URL |
|
||||
| `billingStreet` | string | Nein | Rechnungsadresse (Straße) |
|
||||
| `billingCity` | string | Nein | Rechnungsadresse (Stadt) |
|
||||
| `billingState` | string | Nein | Rechnungsadresse (Bundesland/Provinz) |
|
||||
| `billingPostalCode` | string | Nein | Rechnungsadresse (Postleitzahl) |
|
||||
| `billingCountry` | string | Nein | Rechnungsadresse (Land) |
|
||||
| `description` | string | Nein | Kontobeschreibung |
|
||||
| `annualRevenue` | string | Nein | Jahresumsatz (Zahl) |
|
||||
| `numberOfEmployees` | string | Nein | Anzahl der Mitarbeiter (Zahl) |
|
||||
|
||||
#### Output
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
@@ -102,7 +116,7 @@ Aktualisieren eines bestehenden Kontos in Salesforce CRM
|
||||
|
||||
### `salesforce_delete_account`
|
||||
|
||||
Ein Konto aus Salesforce CRM löschen
|
||||
Löschen eines Kontos aus Salesforce CRM
|
||||
|
||||
#### Eingabe
|
||||
|
||||
@@ -116,7 +130,7 @@ Ein Konto aus Salesforce CRM löschen
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Erfolgsstatus der Operation |
|
||||
| `success` | boolean | Status des Operationserfolgs |
|
||||
| `output` | object | Daten des gelöschten Kontos |
|
||||
|
||||
### `salesforce_get_contacts`
|
||||
@@ -130,7 +144,7 @@ Ein Konto aus Salesforce CRM löschen
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Erfolgsstatus der Operation |
|
||||
| `success` | boolean | Status des Operationserfolgs |
|
||||
| `output` | json | Ergebnisdaten der Operation |
|
||||
|
||||
### `salesforce_create_contact`
|
||||
@@ -144,7 +158,7 @@ Ein Konto aus Salesforce CRM löschen
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Erfolgsstatus der Operation |
|
||||
| `success` | boolean | Status des Operationserfolgs |
|
||||
| `output` | json | Ergebnisdaten der Operation |
|
||||
|
||||
### `salesforce_update_contact`
|
||||
@@ -158,7 +172,7 @@ Ein Konto aus Salesforce CRM löschen
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Erfolgsstatus der Operation |
|
||||
| `success` | boolean | Status des Operationserfolgs |
|
||||
| `output` | json | Ergebnisdaten der Operation |
|
||||
|
||||
### `salesforce_delete_contact`
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -10,7 +10,22 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#0052CC"
|
||||
/>
|
||||
|
||||
## Gebrauchsanweisung
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Trello](https://trello.com) ist ein visuelles Kollaborationstool, das Ihnen hilft, Projekte, Aufgaben und Arbeitsabläufe mithilfe von Boards, Listen und Karten zu organisieren.
|
||||
|
||||
Mit Trello in Sim können Sie:
|
||||
|
||||
- **Boards und Listen anzeigen**: Sehen Sie die Boards, auf die Sie Zugriff haben, und die zugehörigen Listen ein.
|
||||
- **Karten auflisten und durchsuchen**: Rufen Sie alle Karten auf einem Board ab oder filtern Sie nach Listen, um deren Inhalt und Status zu sehen.
|
||||
- **Karten erstellen**: Fügen Sie einer Trello-Liste neue Karten hinzu, einschließlich Beschreibungen, Labels und Fälligkeitsdaten.
|
||||
- **Karten aktualisieren und verschieben**: Bearbeiten Sie Karteneigenschaften, verschieben Sie Karten zwischen Listen und legen Sie Fälligkeitsdaten oder Labels fest.
|
||||
- **Aktuelle Aktivitäten abrufen**: Rufen Sie Aktionen und Aktivitätsverlauf für Boards und Karten ab.
|
||||
- **Karten kommentieren**: Fügen Sie Karten Kommentare für die Zusammenarbeit und Nachverfolgung hinzu.
|
||||
|
||||
Die Integration von Trello mit Sim ermöglicht es Ihren Agenten, die Aufgaben, Boards und Projekte Ihres Teams programmatisch zu verwalten. Automatisieren Sie Projektmanagement-Workflows, halten Sie Aufgabenlisten aktuell, synchronisieren Sie mit anderen Tools oder lösen Sie intelligente Workflows als Reaktion auf Trello-Ereignisse aus – alles durch Ihre KI-Agenten.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Nutzungsanweisungen
|
||||
|
||||
Integrieren Sie Trello, um Boards und Karten zu verwalten. Listen Sie Boards auf, listen Sie Karten auf, erstellen Sie Karten, aktualisieren Sie Karten, rufen Sie Aktionen ab und fügen Sie Kommentare hinzu.
|
||||
|
||||
@@ -18,7 +33,7 @@ Integrieren Sie Trello, um Boards und Karten zu verwalten. Listen Sie Boards auf
|
||||
|
||||
### `trello_list_lists`
|
||||
|
||||
Alle Listen eines Trello-Boards auflisten
|
||||
Alle Listen auf einem Trello-Board auflisten
|
||||
|
||||
#### Eingabe
|
||||
|
||||
@@ -37,13 +52,13 @@ Alle Listen eines Trello-Boards auflisten
|
||||
|
||||
### `trello_list_cards`
|
||||
|
||||
Alle Karten eines Trello-Boards auflisten
|
||||
Alle Listen eines Trello-Boards auflisten
|
||||
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `boardId` | string | Ja | ID des Boards, von dem Karten aufgelistet werden sollen |
|
||||
| `boardId` | string | Ja | ID des Boards, von dem Listen aufgelistet werden sollen |
|
||||
| `listId` | string | Nein | Optional: Karten nach Listen-ID filtern |
|
||||
|
||||
#### Ausgabe
|
||||
@@ -51,7 +66,7 @@ Alle Karten eines Trello-Boards auflisten
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob der Vorgang erfolgreich war |
|
||||
| `cards` | array | Array von Kartenobjekten mit id, name, desc, url, board/list IDs, labels und Fälligkeitsdatum |
|
||||
| `cards` | array | Array von Kartenobjekten mit id, name, desc, url, Board/Listen-IDs, Labels und Fälligkeitsdatum |
|
||||
| `count` | number | Anzahl der zurückgegebenen Karten |
|
||||
| `error` | string | Fehlermeldung, wenn der Vorgang fehlgeschlagen ist |
|
||||
|
||||
@@ -76,7 +91,7 @@ Eine neue Karte auf einem Trello-Board erstellen
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob die Karte erfolgreich erstellt wurde |
|
||||
| `card` | object | Das erstellte Kartenobjekt mit id, name, desc, url und anderen Eigenschaften |
|
||||
| `card` | object | Das erstellte Kartenobjekt mit ID, Name, Beschreibung, URL und anderen Eigenschaften |
|
||||
| `error` | string | Fehlermeldung, falls der Vorgang fehlgeschlagen ist |
|
||||
|
||||
### `trello_update_card`
|
||||
@@ -95,33 +110,33 @@ Eine bestehende Karte in Trello aktualisieren
|
||||
| `due` | string | Nein | Fälligkeitsdatum \(ISO 8601-Format\) |
|
||||
| `dueComplete` | boolean | Nein | Fälligkeitsdatum als abgeschlossen markieren |
|
||||
|
||||
#### Output
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Type | Beschreibung |
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob die Karte erfolgreich aktualisiert wurde |
|
||||
| `card` | object | Das aktualisierte Kartenobjekt mit id, name, desc, url und anderen Eigenschaften |
|
||||
| `card` | object | Das aktualisierte Kartenobjekt mit ID, Name, Beschreibung, URL und anderen Eigenschaften |
|
||||
| `error` | string | Fehlermeldung, falls der Vorgang fehlgeschlagen ist |
|
||||
|
||||
### `trello_get_actions`
|
||||
|
||||
Aktivitäten/Aktionen von einem Board oder einer Karte abrufen
|
||||
|
||||
#### Input
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Type | Erforderlich | Beschreibung |
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `boardId` | string | Nein | ID des Boards, von dem Aktionen abgerufen werden sollen (entweder boardId oder cardId erforderlich) |
|
||||
| `cardId` | string | Nein | ID der Karte, von der Aktionen abgerufen werden sollen (entweder boardId oder cardId erforderlich) |
|
||||
| `filter` | string | Nein | Aktionen nach Typ filtern (z.B. "commentCard,updateCard,createCard" oder "all") |
|
||||
| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Aktionen (Standard: 50, max: 1000) |
|
||||
| `boardId` | string | Nein | ID des Boards, von dem Aktionen abgerufen werden sollen \(entweder boardId oder cardId erforderlich\) |
|
||||
| `cardId` | string | Nein | ID der Karte, von der Aktionen abgerufen werden sollen \(entweder boardId oder cardId erforderlich\) |
|
||||
| `filter` | string | Nein | Aktionen nach Typ filtern \(z.B. "commentCard,updateCard,createCard" oder "all"\) |
|
||||
| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Aktionen \(Standard: 50, max: 1000\) |
|
||||
|
||||
#### Output
|
||||
#### Ausgabe
|
||||
|
||||
| Parameter | Type | Beschreibung |
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob der Vorgang erfolgreich war |
|
||||
| `actions` | array | Array von Aktionsobjekten mit type, date, member und data |
|
||||
| `actions` | array | Array von Aktionsobjekten mit Typ, Datum, Mitglied und Daten |
|
||||
| `count` | number | Anzahl der zurückgegebenen Aktionen |
|
||||
| `error` | string | Fehlermeldung, falls der Vorgang fehlgeschlagen ist |
|
||||
|
||||
@@ -129,9 +144,9 @@ Aktivitäten/Aktionen von einem Board oder einer Karte abrufen
|
||||
|
||||
Einen Kommentar zu einer Trello-Karte hinzufügen
|
||||
|
||||
#### Input
|
||||
#### Eingabe
|
||||
|
||||
| Parameter | Type | Erforderlich | Beschreibung |
|
||||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `cardId` | string | Ja | ID der Karte, die kommentiert werden soll |
|
||||
| `text` | string | Ja | Kommentartext |
|
||||
@@ -141,7 +156,7 @@ Einen Kommentar zu einer Trello-Karte hinzufügen
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Ob der Kommentar erfolgreich hinzugefügt wurde |
|
||||
| `comment` | object | Das erstellte Kommentarobjekt mit id, text, date und member creator |
|
||||
| `comment` | object | Das erstellte Kommentarobjekt mit ID, Text, Datum und Mitglied-Ersteller |
|
||||
| `error` | string | Fehlermeldung, falls der Vorgang fehlgeschlagen ist |
|
||||
|
||||
## Hinweise
|
||||
|
||||
@@ -94,4 +94,14 @@ Referenzieren Sie strukturierte Werte nachgelagert mit Ausdrücken wie <code><
|
||||
|
||||
- Behandle den Start-Block als einzigen Einstiegspunkt, wenn du sowohl API- als auch Chat-Aufrufer unterstützen möchtest.
|
||||
- Bevorzuge benannte Eingabeformat-Felder gegenüber dem Parsen von rohem JSON in nachgelagerten Knoten; Typumwandlung erfolgt automatisch.
|
||||
- Füge unmittelbar nach dem Start Validierung oder Routing hinzu, wenn bestimmte Felder für den Erfolg deines Workflows erforderlich sind.
|
||||
- Füge unmittelbar nach dem Start Validierung oder Routing hinzu, wenn bestimmte Felder für den Erfolg deines Workflows erforderlich sind.
|
||||
|
||||
- Verbinde <code><start.fieldName></code> direkt mit Agenten, Tools oder Funktionen, die strukturierte Daten erwarten.
|
||||
- Verwende Template-Syntax wie <code><start.sampleField></code> oder <code><start.files[0].url></code> (nur im Chat) in Prompt-Feldern.
|
||||
- Halte <code><start.conversationId></code> bereit, wenn du Ausgaben gruppieren, Gesprächsverlauf aktualisieren oder die Chat-API erneut aufrufen musst.
|
||||
|
||||
## Bewährte Praktiken
|
||||
|
||||
- Behandle den Start-Block als einzigen Einstiegspunkt, wenn du sowohl API- als auch Chat-Aufrufer unterstützen möchtest.
|
||||
- Bevorzuge benannte Eingabeformat-Felder gegenüber dem Parsen von rohem JSON in nachgelagerten Knoten; Typumwandlung erfolgt automatisch.
|
||||
- Füge Validierung oder Routing unmittelbar nach dem Start hinzu, wenn bestimmte Felder für den Erfolg deines Workflows erforderlich sind.
|
||||
@@ -11,9 +11,9 @@ El bloque Condición ramifica la ejecución del flujo de trabajo basándose en e
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/condition.png"
|
||||
alt="Bloque de Condición"
|
||||
alt="Bloque de condición"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -11,7 +11,7 @@ El bloque de Función ejecuta código JavaScript o TypeScript personalizado en t
|
||||
src="/static/blocks/function.png"
|
||||
alt="Bloque de función con editor de código"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -11,9 +11,9 @@ El bloque Guardrails valida y protege tus flujos de trabajo de IA comprobando el
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/guardrails.png"
|
||||
alt="Bloque Guardrails"
|
||||
alt="Bloque de barandillas de protección"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -124,14 +124,10 @@ Cada instancia paralela se ejecuta de forma independiente:
|
||||
- No puedes colocar ningún bloque contenedor dentro de otro bloque contenedor
|
||||
</Callout>
|
||||
|
||||
<Callout type="warning">
|
||||
Los bloques paralelos solo pueden contener un único bloque. No puedes tener múltiples bloques conectados entre sí dentro de un paralelo - en ese caso solo se ejecutaría el primer bloque.
|
||||
</Callout>
|
||||
|
||||
<Callout type="info">
|
||||
Aunque la ejecución paralela es más rápida, ten en cuenta:
|
||||
- Los límites de tasa de API al realizar solicitudes concurrentes
|
||||
- El uso de memoria con conjuntos de datos grandes
|
||||
Aunque la ejecución en paralelo es más rápida, ten en cuenta:
|
||||
- Límites de tasa de API al realizar solicitudes concurrentes
|
||||
- Uso de memoria con conjuntos de datos grandes
|
||||
- Máximo de 20 instancias concurrentes para evitar el agotamiento de recursos
|
||||
</Callout>
|
||||
|
||||
@@ -147,9 +143,9 @@ Entendiendo cuándo usar cada uno:
|
||||
| Caso de uso | Operaciones independientes | Operaciones dependientes |
|
||||
| Uso de recursos | Mayor | Menor |
|
||||
|
||||
## Entradas y salidas
|
||||
## Entradas y Salidas
|
||||
|
||||
<Tabs items={['Configuration', 'Variables', 'Results']}>
|
||||
<Tabs items={['Configuración', 'Variables', 'Resultados']}>
|
||||
<Tab>
|
||||
<ul className="list-disc space-y-2 pl-6">
|
||||
<li>
|
||||
@@ -190,6 +186,6 @@ Entendiendo cuándo usar cada uno:
|
||||
|
||||
## Mejores prácticas
|
||||
|
||||
- **Solo operaciones independientes**: Asegúrate de que las operaciones no dependan unas de otras
|
||||
- **Gestiona los límites de frecuencia**: Añade retrasos o limitaciones para flujos de trabajo con uso intensivo de API
|
||||
- **Manejo de errores**: Cada instancia debe manejar sus propios errores de manera elegante
|
||||
- **Solo operaciones independientes**: Asegúrate de que las operaciones no dependan entre sí
|
||||
- **Gestionar límites de tasa**: Añade retrasos o limitaciones para flujos de trabajo con uso intensivo de API
|
||||
- **Manejo de errores**: Cada instancia debe manejar sus propios errores correctamente
|
||||
|
||||
@@ -11,9 +11,9 @@ El bloque Variables actualiza las variables del flujo de trabajo durante la ejec
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/variables.png"
|
||||
alt="Bloque de Variables"
|
||||
alt="Bloque de variables"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -11,9 +11,9 @@ El bloque Espera pausa tu flujo de trabajo durante un tiempo específico antes d
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/wait.png"
|
||||
alt="Bloque de Espera"
|
||||
alt="Bloque de espera"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -12,8 +12,8 @@ import { Image } from '@/components/ui/image'
|
||||
<Image
|
||||
src='/static/blocks/workflow.png'
|
||||
alt='Configuración del bloque de flujo de trabajo'
|
||||
width={400}
|
||||
height={280}
|
||||
width={500}
|
||||
height={400}
|
||||
className='rounded-xl border border-border shadow-sm'
|
||||
/>
|
||||
</div>
|
||||
@@ -40,12 +40,24 @@ Coloca un bloque de Flujo de trabajo cuando quieras llamar a un flujo de trabajo
|
||||
- `success` – si se ejecutó sin errores
|
||||
- `error` – mensaje cuando la ejecución falla
|
||||
|
||||
## Insignia de estado de implementación
|
||||
|
||||
El bloque de flujo de trabajo muestra una insignia de estado de implementación para ayudarte a realizar un seguimiento de si el flujo de trabajo secundario está listo para ejecutarse:
|
||||
|
||||
- **Implementado** – El flujo de trabajo secundario ha sido implementado y está listo para usar. El bloque ejecutará la versión implementada actual.
|
||||
- **No implementado** – El flujo de trabajo secundario nunca ha sido implementado. Debes implementarlo antes de que el bloque de flujo de trabajo pueda ejecutarlo.
|
||||
- **Reimplementar** – Se han detectado cambios en el flujo de trabajo secundario desde la última implementación. Haz clic en la insignia para reimplementar el flujo de trabajo secundario con los últimos cambios.
|
||||
|
||||
<Callout type="warn">
|
||||
El bloque de flujo de trabajo siempre ejecuta la versión implementada más reciente del flujo de trabajo secundario, no la versión del editor. Asegúrate de reimplementar después de hacer cambios para garantizar que el bloque utilice la lógica más reciente.
|
||||
</Callout>
|
||||
|
||||
## Notas de ejecución
|
||||
|
||||
- Los flujos de trabajo hijos se ejecutan en el mismo contexto de espacio de trabajo, por lo que las variables de entorno y herramientas se mantienen.
|
||||
- El bloque utiliza versionado de despliegue: cualquier ejecución de API, programación, webhook, manual o chat llama a la instantánea desplegada. Vuelve a desplegar el hijo cuando lo cambies.
|
||||
- Si el hijo falla, el bloque genera un error a menos que lo manejes en etapas posteriores.
|
||||
- Los flujos de trabajo secundarios se ejecutan en el mismo contexto de espacio de trabajo, por lo que las variables de entorno y las herramientas se mantienen.
|
||||
- El bloque utiliza el control de versiones de implementación: cualquier API, programación, webhook, ejecución manual o de chat llama a la instantánea implementada. Reimplementa el flujo secundario cuando lo cambies.
|
||||
- Si el flujo secundario falla, el bloque genera un error a menos que lo manejes posteriormente.
|
||||
|
||||
<Callout>
|
||||
Mantén los flujos de trabajo hijos enfocados. Los flujos pequeños y reutilizables facilitan su combinación sin crear anidamientos profundos.
|
||||
Mantén los flujos de trabajo secundarios enfocados. Los flujos pequeños y reutilizables facilitan su combinación sin crear anidamientos profundos.
|
||||
</Callout>
|
||||
|
||||
@@ -10,9 +10,23 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
La herramienta [MongoDB](https://www.mongodb.com/) te permite conectarte a una base de datos MongoDB y realizar una amplia gama de operaciones orientadas a documentos directamente dentro de tus flujos de trabajo con agentes. Con una configuración flexible y una gestión segura de conexiones, puedes interactuar fácilmente con tus datos y manipularlos.
|
||||
|
||||
Con la herramienta MongoDB, puedes:
|
||||
|
||||
- **Encontrar documentos**: Consultar colecciones y recuperar documentos con la operación `mongodb_query` utilizando filtros de consulta avanzados.
|
||||
- **Insertar documentos**: Añadir uno o varios documentos a una colección utilizando la operación `mongodb_insert`.
|
||||
- **Actualizar documentos**: Modificar documentos existentes con la operación `mongodb_update` especificando criterios de filtro y acciones de actualización.
|
||||
- **Eliminar documentos**: Eliminar documentos de una colección utilizando la operación `mongodb_delete`, especificando filtros y opciones de eliminación.
|
||||
- **Agregar datos**: Ejecutar pipelines de agregación complejos con la operación `mongodb_execute` para transformar y analizar tus datos.
|
||||
|
||||
La herramienta MongoDB es ideal para flujos de trabajo donde tus agentes necesitan gestionar o analizar datos estructurados basados en documentos. Ya sea procesando contenido generado por usuarios, gestionando datos de aplicaciones o impulsando análisis, la herramienta MongoDB simplifica el acceso y la manipulación de tus datos de manera segura y programática.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instrucciones de uso
|
||||
|
||||
Integrar MongoDB en el flujo de trabajo. Puede encontrar, insertar, actualizar, eliminar y agregar datos.
|
||||
Integra MongoDB en el flujo de trabajo. Puede encontrar, insertar, actualizar, eliminar y agregar datos.
|
||||
|
||||
## Herramientas
|
||||
|
||||
@@ -22,8 +36,8 @@ Ejecutar operación de búsqueda en colección de MongoDB
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| Parámetro | Tipo | Requerido | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `host` | string | Sí | Nombre de host o dirección IP del servidor MongoDB |
|
||||
| `port` | number | Sí | Puerto del servidor MongoDB \(predeterminado: 27017\) |
|
||||
| `database` | string | Sí | Nombre de la base de datos a la que conectarse |
|
||||
@@ -51,7 +65,7 @@ Insertar documentos en colección de MongoDB
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ---------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `host` | string | Sí | Nombre de host o dirección IP del servidor MongoDB |
|
||||
| `port` | number | Sí | Puerto del servidor MongoDB \(predeterminado: 27017\) |
|
||||
| `database` | string | Sí | Nombre de la base de datos a la que conectarse |
|
||||
@@ -59,7 +73,7 @@ Insertar documentos en colección de MongoDB
|
||||
| `password` | string | No | Contraseña de MongoDB |
|
||||
| `authSource` | string | No | Base de datos de autenticación |
|
||||
| `ssl` | string | No | Modo de conexión SSL \(disabled, required, preferred\) |
|
||||
| `collection` | string | Sí | Nombre de la colección donde insertar |
|
||||
| `collection` | string | Sí | Nombre de la colección en la que insertar |
|
||||
| `documents` | array | Sí | Array de documentos a insertar |
|
||||
|
||||
#### Salida
|
||||
@@ -73,7 +87,7 @@ Insertar documentos en colección de MongoDB
|
||||
|
||||
### `mongodb_update`
|
||||
|
||||
Actualizar documentos en una colección de MongoDB
|
||||
Actualizar documentos en colección de MongoDB
|
||||
|
||||
#### Entrada
|
||||
|
||||
@@ -100,7 +114,7 @@ Actualizar documentos en una colección de MongoDB
|
||||
| `matchedCount` | number | Número de documentos que coinciden con el filtro |
|
||||
| `modifiedCount` | number | Número de documentos modificados |
|
||||
| `documentCount` | number | Número total de documentos afectados |
|
||||
| `insertedId` | string | ID del documento insertado (si es upsert) |
|
||||
| `insertedId` | string | ID del documento insertado \(si hay upsert\) |
|
||||
|
||||
### `mongodb_delete`
|
||||
|
||||
@@ -109,15 +123,15 @@ Eliminar documentos de una colección de MongoDB
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | ---------- | ----------- |
|
||||
| `host` | string | Sí | Nombre de host o dirección IP del servidor MongoDB |
|
||||
| `port` | number | Sí | Puerto del servidor MongoDB (predeterminado: 27017) |
|
||||
| `port` | number | Sí | Puerto del servidor MongoDB \(predeterminado: 27017\) |
|
||||
| `database` | string | Sí | Nombre de la base de datos a la que conectarse |
|
||||
| `username` | string | No | Nombre de usuario de MongoDB |
|
||||
| `password` | string | No | Contraseña de MongoDB |
|
||||
| `authSource` | string | No | Base de datos de autenticación |
|
||||
| `ssl` | string | No | Modo de conexión SSL (disabled, required, preferred) |
|
||||
| `collection` | string | Sí | Nombre de la colección de la que eliminar |
|
||||
| `ssl` | string | No | Modo de conexión SSL \(disabled, required, preferred\) |
|
||||
| `collection` | string | Sí | Nombre de la colección de donde eliminar |
|
||||
| `filter` | string | Sí | Criterios de filtro como cadena JSON |
|
||||
| `multi` | boolean | No | Eliminar múltiples documentos |
|
||||
|
||||
@@ -136,7 +150,7 @@ Ejecutar pipeline de agregación de MongoDB
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | ---------- | ----------- |
|
||||
| `host` | string | Sí | Nombre de host o dirección IP del servidor MongoDB |
|
||||
| `port` | number | Sí | Puerto del servidor MongoDB \(predeterminado: 27017\) |
|
||||
| `database` | string | Sí | Nombre de la base de datos a la que conectarse |
|
||||
@@ -144,7 +158,7 @@ Ejecutar pipeline de agregación de MongoDB
|
||||
| `password` | string | No | Contraseña de MongoDB |
|
||||
| `authSource` | string | No | Base de datos de autenticación |
|
||||
| `ssl` | string | No | Modo de conexión SSL \(disabled, required, preferred\) |
|
||||
| `collection` | string | Sí | Nombre de la colección en la que ejecutar el pipeline |
|
||||
| `collection` | string | Sí | Nombre de la colección donde ejecutar el pipeline |
|
||||
| `pipeline` | string | Sí | Pipeline de agregación como cadena JSON |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -10,20 +10,34 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
La herramienta [Salesforce](https://www.salesforce.com/) te permite conectarte directamente a tu CRM de Salesforce y realizar una amplia gama de operaciones de gestión de relaciones con clientes dentro de tus flujos de trabajo con agentes. Con una integración fluida y segura, puedes acceder y automatizar eficientemente procesos empresariales clave en tus datos de ventas, soporte y marketing.
|
||||
|
||||
Con la herramienta Salesforce, puedes:
|
||||
|
||||
- **Recuperar cuentas**: Usa la operación `salesforce_get_accounts` para obtener Cuentas de Salesforce con filtros personalizados, ordenación y selección de campos.
|
||||
- **Crear cuentas**: Añade automáticamente nuevas Cuentas a Salesforce usando la operación `salesforce_create_account`, especificando detalles como nombre, industria y dirección de facturación.
|
||||
- **Gestionar contactos**: (Si se proporciona, hay herramientas similares disponibles para Contactos—añadir, actualizar o recuperar contactos según sea necesario.)
|
||||
- **Manejar leads y oportunidades**: Integra la gestión de leads y oportunidades en tu flujo de trabajo, permitiendo a tus agentes capturar, calificar y actualizar datos del pipeline de ventas.
|
||||
- **Seguimiento de casos y tareas**: Automatiza el soporte al cliente y las actividades de seguimiento interactuando con Casos y Tareas dentro de Salesforce.
|
||||
|
||||
La herramienta Salesforce es ideal para flujos de trabajo donde tus agentes necesitan agilizar las operaciones de ventas, gestión de cuentas, generación de leads y soporte. Ya sea que tus agentes estén sincronizando datos entre plataformas, proporcionando información de clientes en tiempo real o automatizando actualizaciones rutinarias de CRM, la herramienta Salesforce incorpora todo el poder y la extensibilidad de Salesforce en tus procesos programáticos impulsados por agentes.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instrucciones de uso
|
||||
|
||||
Integra Salesforce en tu flujo de trabajo. Gestiona cuentas, contactos, clientes potenciales, oportunidades, casos y tareas con potentes capacidades de automatización.
|
||||
Integra Salesforce en tu flujo de trabajo. Gestiona cuentas, contactos, leads, oportunidades, casos y tareas con potentes capacidades de automatización.
|
||||
|
||||
## Herramientas
|
||||
|
||||
### `salesforce_get_accounts`
|
||||
|
||||
Recuperar cuentas desde Salesforce CRM
|
||||
Recuperar cuentas del CRM de Salesforce
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| Parámetro | Tipo | Requerido | Descripción |
|
||||
| --------- | ---- | --------- | ----------- |
|
||||
| `idToken` | string | No | El token ID de OAuth de Salesforce \(contiene URL de instancia\) |
|
||||
| `instanceUrl` | string | No | La URL de instancia de Salesforce |
|
||||
| `limit` | string | No | Número de resultados a devolver \(predeterminado: 100, máximo: 2000\) |
|
||||
@@ -107,7 +121,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `idToken` | string | No | Sin descripción |
|
||||
| `instanceUrl` | string | No | Sin descripción |
|
||||
| `accountId` | string | Sí | ID de la cuenta a eliminar \(obligatorio\) |
|
||||
@@ -124,7 +138,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -138,7 +152,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -152,7 +166,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -166,7 +180,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -180,7 +194,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -194,7 +208,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -208,7 +222,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -222,7 +236,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -236,7 +250,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -250,7 +264,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -264,7 +278,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -278,7 +292,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -292,7 +306,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -306,7 +320,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -320,7 +334,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -334,7 +348,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -348,7 +362,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -362,7 +376,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -376,7 +390,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -390,7 +404,7 @@ Eliminar una cuenta de Salesforce CRM
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Salida
|
||||
|
||||
|
||||
@@ -10,6 +10,24 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#635BFF"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Stripe](https://stripe.com/) es una potente plataforma de pagos que te permite gestionar fácilmente pagos, clientes, suscripciones, facturas, productos y más.
|
||||
|
||||
Con Stripe integrado en Sim, tus agentes pueden:
|
||||
|
||||
- **Crear y gestionar intenciones de pago**: procesar pagos con opciones de configuración flexibles.
|
||||
- **Trabajar con clientes**: crear, recuperar y actualizar registros de clientes para tu negocio.
|
||||
- **Gestionar suscripciones**: administrar facturación recurrente y ciclos de vida de suscripciones.
|
||||
- **Crear y enviar facturas**: generar facturas para pagos únicos o recurrentes.
|
||||
- **Seguir y gestionar cargos**: recuperar y actualizar objetos de cargo para monitorear pagos.
|
||||
- **Configurar productos y precios**: configurar tu catálogo de productos, modelos de precios y ofertas.
|
||||
- **Escuchar y reaccionar a eventos de Stripe**: activar flujos de trabajo en respuesta a actualizaciones de pago, cargos exitosos y otros eventos de Stripe.
|
||||
|
||||
Al conectar Sim con Stripe, habilitas la automatización perfecta de operaciones financieras dentro de tus flujos de trabajo de agentes. Automatiza la incorporación de clientes, gestión de suscripciones, cobro de pagos, generación de facturas e incluso acciones personalizadas cuando ocurren eventos de pago—todo gestionado directamente por tus agentes, de forma segura a través de Stripe.
|
||||
|
||||
Ya sea que estés construyendo automatización de comercio electrónico, servicios de suscripción o ejecutando informes y conciliaciones, la herramienta de Stripe facilita la coordinación de pagos y datos financieros dentro de tus flujos de trabajo inteligentes de Sim.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instrucciones de uso
|
||||
|
||||
Integra Stripe en el flujo de trabajo. Gestiona intenciones de pago, clientes, suscripciones, facturas, cargos, productos, precios y eventos. Puede utilizarse en modo de activación para iniciar un flujo de trabajo cuando ocurre un evento de Stripe.
|
||||
@@ -18,21 +36,21 @@ Integra Stripe en el flujo de trabajo. Gestiona intenciones de pago, clientes, s
|
||||
|
||||
### `stripe_create_payment_intent`
|
||||
|
||||
Crear un nuevo Payment Intent para procesar un pago
|
||||
Crear una nueva intención de pago para procesar un pago
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| Parámetro | Tipo | Requerido | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `amount` | number | Sí | Cantidad en centavos (p. ej., 2000 para $20.00) |
|
||||
| `currency` | string | Sí | Código de moneda ISO de tres letras (p. ej., usd, eur) |
|
||||
| `amount` | number | Sí | Cantidad en centavos (ej., 2000 para $20.00) |
|
||||
| `currency` | string | Sí | Código de moneda ISO de tres letras (ej., usd, eur) |
|
||||
| `customer` | string | No | ID del cliente para asociar con este pago |
|
||||
| `payment_method` | string | No | ID del método de pago |
|
||||
| `description` | string | No | Descripción del pago |
|
||||
| `receipt_email` | string | No | Dirección de correo electrónico para enviar el recibo |
|
||||
| `metadata` | json | No | Conjunto de pares clave-valor para almacenar información adicional |
|
||||
| `automatic_payment_methods` | json | No | Habilitar métodos de pago automáticos \(p. ej., \{"enabled": true\}\) |
|
||||
| `automatic_payment_methods` | json | No | Habilitar métodos de pago automáticos (ej., `{"enabled": true}`) |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -50,7 +68,7 @@ Recuperar un Payment Intent existente por ID
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del Payment Intent (p. ej., pi_1234567890) |
|
||||
| `id` | string | Sí | ID del Payment Intent (ej., pi_1234567890) |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -67,8 +85,8 @@ Actualizar un Payment Intent existente
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID del Payment Intent \(p.ej., pi_1234567890\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del Payment Intent (ej., pi_1234567890) |
|
||||
| `amount` | number | No | Cantidad actualizada en centavos |
|
||||
| `currency` | string | No | Código de moneda ISO de tres letras |
|
||||
| `customer` | string | No | ID del cliente |
|
||||
@@ -90,8 +108,8 @@ Confirmar un Payment Intent para completar el pago
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID del Payment Intent \(p.ej., pi_1234567890\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del Payment Intent (p. ej., pi_1234567890) |
|
||||
| `payment_method` | string | No | ID del método de pago para confirmar |
|
||||
|
||||
#### Salida
|
||||
@@ -110,8 +128,8 @@ Capturar un Payment Intent autorizado
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del Payment Intent (ej., pi_1234567890) |
|
||||
| `amount_to_capture` | number | No | Cantidad a capturar en centavos (por defecto, la cantidad completa) |
|
||||
| `id` | string | Sí | ID del Payment Intent (p. ej., pi_1234567890) |
|
||||
| `amount_to_capture` | number | No | Cantidad a capturar en centavos (por defecto es la cantidad completa) |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -129,7 +147,7 @@ Cancelar un Payment Intent
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del Payment Intent (ej., pi_1234567890) |
|
||||
| `id` | string | Sí | ID del Payment Intent (p. ej., pi_1234567890) |
|
||||
| `cancellation_reason` | string | No | Motivo de la cancelación (duplicate, fraudulent, requested_by_customer, abandoned) |
|
||||
|
||||
#### Salida
|
||||
@@ -147,10 +165,10 @@ Listar todos los Payment Intents
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `limit` | number | No | Número de resultados a devolver \(predeterminado 10, máximo 100\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `limit` | number | No | Número de resultados a devolver (predeterminado 10, máximo 100) |
|
||||
| `customer` | string | No | Filtrar por ID de cliente |
|
||||
| `created` | json | No | Filtrar por fecha de creación \(p. ej., \{"gt": 1633024800\}\) |
|
||||
| `created` | json | No | Filtrar por fecha de creación (p. ej., `{"gt": 1633024800}`) |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -167,9 +185,9 @@ Buscar Payment Intents usando sintaxis de consulta
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `query` | string | Sí | Consulta de búsqueda \(p. ej., \"status:'succeeded' AND currency:'usd'\"\) |
|
||||
| `limit` | number | No | Número de resultados a devolver \(predeterminado 10, máximo 100\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `query` | string | Sí | Consulta de búsqueda (p. ej., "status:'succeeded' AND currency:'usd'") |
|
||||
| `limit` | number | No | Número de resultados a devolver (predeterminado 10, máximo 100) |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -180,26 +198,26 @@ Buscar Payment Intents usando sintaxis de consulta
|
||||
|
||||
### `stripe_create_customer`
|
||||
|
||||
Crear un nuevo objeto cliente
|
||||
Crear un nuevo objeto de cliente
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `email` | string | No | Dirección de correo electrónico del cliente |
|
||||
| `name` | string | No | Nombre completo del cliente |
|
||||
| `phone` | string | No | Número de teléfono del cliente |
|
||||
| `description` | string | No | Descripción del cliente |
|
||||
| `address` | json | No | Objeto de dirección del cliente |
|
||||
| `metadata` | json | No | Conjunto de pares clave-valor |
|
||||
| `payment_method` | string | No | ID del método de pago a adjuntar |
|
||||
| `payment_method` | string | No | ID del método de pago para adjuntar |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `customer` | json | El objeto cliente creado |
|
||||
| `customer` | json | El objeto de cliente creado |
|
||||
| `metadata` | json | Metadatos del cliente |
|
||||
|
||||
### `stripe_retrieve_customer`
|
||||
@@ -210,14 +228,14 @@ Recuperar un cliente existente por ID
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID del cliente \(p. ej., cus_1234567890\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del cliente (p. ej., cus_1234567890) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `customer` | json | El objeto cliente recuperado |
|
||||
| `customer` | json | El objeto de cliente recuperado |
|
||||
| `metadata` | json | Metadatos del cliente |
|
||||
|
||||
### `stripe_update_customer`
|
||||
@@ -228,8 +246,8 @@ Actualizar un cliente existente
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID del cliente \(p. ej., cus_1234567890\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del cliente (p. ej., cus_1234567890) |
|
||||
| `email` | string | No | Dirección de correo electrónico actualizada |
|
||||
| `name` | string | No | Nombre actualizado |
|
||||
| `phone` | string | No | Número de teléfono actualizado |
|
||||
@@ -252,14 +270,14 @@ Eliminar permanentemente un cliente
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID del cliente \(p. ej., cus_1234567890\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del cliente (p. ej., cus_1234567890) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `deleted` | boolean | Indica si el cliente fue eliminado |
|
||||
| `deleted` | boolean | Si el cliente fue eliminado |
|
||||
| `id` | string | El ID del cliente eliminado |
|
||||
| `metadata` | json | Metadatos de eliminación |
|
||||
|
||||
@@ -271,8 +289,8 @@ Listar todos los clientes
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `limit` | number | No | Número de resultados a devolver \(predeterminado 10, máximo 100\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `limit` | number | No | Número de resultados a devolver (predeterminado 10, máximo 100) |
|
||||
| `email` | string | No | Filtrar por dirección de correo electrónico |
|
||||
| `created` | json | No | Filtrar por fecha de creación |
|
||||
|
||||
@@ -280,20 +298,20 @@ Listar todos los clientes
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `customers` | json | Array de objetos de cliente |
|
||||
| `customers` | json | Array de objetos cliente |
|
||||
| `metadata` | json | Metadatos de la lista |
|
||||
|
||||
### `stripe_search_customers`
|
||||
|
||||
Buscar clientes usando sintaxis de consulta
|
||||
Buscar clientes utilizando sintaxis de consulta
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `query` | string | Sí | Consulta de búsqueda \(p. ej., "email:\'customer@example.com\'"\) |
|
||||
| `limit` | number | No | Número de resultados a devolver \(predeterminado 10, máximo 100\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `query` | string | Sí | Consulta de búsqueda (p. ej., "email:\'customer@example.com\'") |
|
||||
| `limit` | number | No | Número de resultados a devolver (predeterminado 10, máximo 100) |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -312,7 +330,7 @@ Crear una nueva suscripción para un cliente
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `customer` | string | Sí | ID del cliente a suscribir |
|
||||
| `items` | json | Sí | Array de elementos con IDs de precio \(p. ej., \[\{"price": "price_xxx", "quantity": 1\}\]\) |
|
||||
| `items` | json | Sí | Array de elementos con IDs de precio (p. ej., `[{"price": "price_xxx", "quantity": 1}]`) |
|
||||
| `trial_period_days` | number | No | Número de días de prueba |
|
||||
| `default_payment_method` | string | No | ID del método de pago |
|
||||
| `cancel_at_period_end` | boolean | No | Cancelar suscripción al final del período |
|
||||
@@ -323,7 +341,7 @@ Crear una nueva suscripción para un cliente
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `subscription` | json | El objeto de suscripción creado |
|
||||
| `metadata` | json | Metadatos de suscripción incluyendo ID, estado y cliente |
|
||||
| `metadata` | json | Metadatos de la suscripción incluyendo ID, estado y cliente |
|
||||
|
||||
### `stripe_retrieve_subscription`
|
||||
|
||||
@@ -341,7 +359,7 @@ Recuperar una suscripción existente por ID
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `subscription` | json | El objeto de suscripción recuperado |
|
||||
| `metadata` | json | Metadatos de la suscripción incluyendo ID, estado y cliente |
|
||||
| `metadata` | json | Metadatos de suscripción incluyendo ID, estado y cliente |
|
||||
|
||||
### `stripe_update_subscription`
|
||||
|
||||
@@ -351,8 +369,8 @@ Actualizar una suscripción existente
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID de suscripción \(p. ej., sub_1234567890\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID de suscripción (p. ej., sub_1234567890) |
|
||||
| `items` | json | No | Array actualizado de elementos con IDs de precio |
|
||||
| `cancel_at_period_end` | boolean | No | Cancelar suscripción al final del período |
|
||||
| `metadata` | json | No | Metadatos actualizados |
|
||||
@@ -362,7 +380,7 @@ Actualizar una suscripción existente
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `subscription` | json | El objeto de suscripción actualizado |
|
||||
| `metadata` | json | Metadatos de la suscripción incluyendo ID, estado y cliente |
|
||||
| `metadata` | json | Metadatos de suscripción incluyendo ID, estado y cliente |
|
||||
|
||||
### `stripe_cancel_subscription`
|
||||
|
||||
@@ -372,8 +390,8 @@ Cancelar una suscripción
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID de suscripción \(p. ej., sub_1234567890\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID de suscripción (p. ej., sub_1234567890) |
|
||||
| `prorate` | boolean | No | Si se debe prorratear la cancelación |
|
||||
| `invoice_now` | boolean | No | Si se debe facturar inmediatamente |
|
||||
|
||||
@@ -391,9 +409,9 @@ Reanudar una suscripción que estaba programada para cancelación
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID de suscripción \(p. ej., sub_1234567890\) |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID de suscripción (p. ej., sub_1234567890) |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -409,11 +427,11 @@ Listar todas las suscripciones
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `limit` | number | No | Número de resultados a devolver \(predeterminado 10, máximo 100\) |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `limit` | number | No | Número de resultados a devolver (predeterminado 10, máximo 100) |
|
||||
| `customer` | string | No | Filtrar por ID de cliente |
|
||||
| `status` | string | No | Filtrar por estado \(active, past_due, unpaid, canceled, incomplete, incomplete_expired, trialing, all\) |
|
||||
| `status` | string | No | Filtrar por estado (active, past_due, unpaid, canceled, incomplete, incomplete_expired, trialing, all) |
|
||||
| `price` | string | No | Filtrar por ID de precio |
|
||||
|
||||
#### Salida
|
||||
@@ -430,10 +448,10 @@ Buscar suscripciones usando sintaxis de consulta
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `query` | string | Sí | Consulta de búsqueda \(p. ej., \"status:'active' AND customer:'cus_xxx'\"\) |
|
||||
| `limit` | number | No | Número de resultados a devolver \(predeterminado 10, máximo 100\) |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `query` | string | Sí | Consulta de búsqueda (p. ej., "status:'active' AND customer:'cus_xxx'") |
|
||||
| `limit` | number | No | Número de resultados a devolver (predeterminado 10, máximo 100) |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -489,7 +507,7 @@ Actualizar una factura existente
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID de la factura (p. ej., in_1234567890) |
|
||||
| `description` | string | No | Descripción de la factura |
|
||||
@@ -510,7 +528,7 @@ Eliminar permanentemente un borrador de factura
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID de la factura (p. ej., in_1234567890) |
|
||||
|
||||
@@ -518,18 +536,18 @@ Eliminar permanentemente un borrador de factura
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `deleted` | boolean | Si la factura fue eliminada |
|
||||
| `deleted` | boolean | Indica si la factura fue eliminada |
|
||||
| `id` | string | El ID de la factura eliminada |
|
||||
| `metadata` | json | Metadatos de eliminación |
|
||||
|
||||
### `stripe_finalize_invoice`
|
||||
Eliminar permanentemente una factura en borrador
|
||||
|
||||
Finalizar un borrador de factura
|
||||
Finalizar una factura en borrador
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID de la factura (p. ej., in_1234567890) |
|
||||
| `auto_advance` | boolean | No | Avanzar automáticamente la factura |
|
||||
@@ -538,10 +556,10 @@ Finalizar un borrador de factura
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `invoice` | json | El objeto de factura finalizado |
|
||||
| `invoice` | json | El objeto de factura finalizada |
|
||||
| `metadata` | json | Metadatos de la factura |
|
||||
|
||||
### `stripe_pay_invoice`
|
||||
Pagar una factura
|
||||
|
||||
Pagar una factura
|
||||
|
||||
@@ -550,8 +568,8 @@ Pagar una factura
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID de factura (p. ej., in_1234567890) |
|
||||
| `paid_out_of_band` | boolean | No | Marcar factura como pagada fuera del sistema |
|
||||
| `id` | string | Sí | ID de la factura (p. ej., in_1234567890) |
|
||||
| `paid_out_of_band` | boolean | No | Marcar la factura como pagada fuera del sistema |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -560,7 +578,7 @@ Pagar una factura
|
||||
| `invoice` | json | El objeto de factura pagada |
|
||||
| `metadata` | json | Metadatos de la factura |
|
||||
|
||||
### `stripe_void_invoice`
|
||||
Anular una factura
|
||||
|
||||
Anular una factura
|
||||
|
||||
@@ -569,7 +587,7 @@ Anular una factura
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID de factura (p. ej., in_1234567890) |
|
||||
| `id` | string | Sí | ID de la factura (p. ej., in_1234567890) |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -587,13 +605,13 @@ Enviar una factura al cliente
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID de factura (p. ej., in_1234567890) |
|
||||
| `id` | string | Sí | ID de la factura (p. ej., in_1234567890) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `invoice` | json | El objeto de factura enviado |
|
||||
| `invoice` | json | El objeto de factura enviada |
|
||||
| `metadata` | json | Metadatos de la factura |
|
||||
|
||||
### `stripe_list_invoices`
|
||||
@@ -625,7 +643,7 @@ Buscar facturas usando sintaxis de consulta
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `query` | string | Sí | Consulta de búsqueda (p. ej., "customer:\'cus_1234567890\'"\) |
|
||||
| `query` | string | Sí | Consulta de búsqueda (p. ej., "customer:\'cus_1234567890\'") |
|
||||
| `limit` | number | No | Número de resultados a devolver (predeterminado 10, máximo 100) |
|
||||
|
||||
#### Salida
|
||||
@@ -643,21 +661,21 @@ Crear un nuevo cargo para procesar un pago
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `amount` | number | Sí | Cantidad en centavos \(p. ej., 2000 para $20.00\) |
|
||||
| `currency` | string | Sí | Código de moneda ISO de tres letras \(p. ej., usd, eur\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `amount` | number | Sí | Monto en centavos (p. ej., 2000 para $20.00) |
|
||||
| `currency` | string | Sí | Código de moneda ISO de tres letras (p. ej., usd, eur) |
|
||||
| `customer` | string | No | ID del cliente para asociar con este cargo |
|
||||
| `source` | string | No | ID de la fuente de pago \(p. ej., token de tarjeta o ID de tarjeta guardada\) |
|
||||
| `source` | string | No | ID de la fuente de pago (p. ej., token de tarjeta o ID de tarjeta guardada) |
|
||||
| `description` | string | No | Descripción del cargo |
|
||||
| `metadata` | json | No | Conjunto de pares clave-valor para almacenar información adicional |
|
||||
| `capture` | boolean | No | Si se debe capturar inmediatamente el cargo \(por defecto es true\) |
|
||||
| `capture` | boolean | No | Si se debe capturar inmediatamente el cargo (por defecto es true) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charge` | json | El objeto Charge creado |
|
||||
| `metadata` | json | Metadatos del cargo incluyendo ID, estado, cantidad, moneda y estado de pago |
|
||||
| `charge` | json | El objeto Cargo creado |
|
||||
| `metadata` | json | Metadatos del cargo incluyendo ID, estado, monto, moneda y estado de pago |
|
||||
|
||||
### `stripe_retrieve_charge`
|
||||
|
||||
@@ -667,8 +685,8 @@ Recuperar un cargo existente por ID
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID del cargo \(p. ej., ch_1234567890\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del cargo (p. ej., ch_1234567890) |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -685,8 +703,8 @@ Actualizar un cargo existente
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID del cargo \(p. ej., ch_1234567890\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del cargo (p. ej., ch_1234567890) |
|
||||
| `description` | string | No | Descripción actualizada |
|
||||
| `metadata` | json | No | Metadatos actualizados |
|
||||
|
||||
@@ -694,8 +712,8 @@ Actualizar un cargo existente
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charge` | json | El objeto Cargo actualizado |
|
||||
| `metadata` | json | Metadatos del cargo incluyendo ID, estado, monto, moneda y estado de pago |
|
||||
| `charge` | json | El objeto Charge actualizado |
|
||||
| `metadata` | json | Metadatos del cargo incluyendo ID, estado, cantidad, moneda y estado de pago |
|
||||
|
||||
### `stripe_capture_charge`
|
||||
|
||||
@@ -705,16 +723,16 @@ Capturar un cargo no capturado
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID del cargo \(p. ej., ch_1234567890\) |
|
||||
| `amount` | number | No | Monto a capturar en centavos \(por defecto el monto completo\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del cargo (p. ej., ch_1234567890) |
|
||||
| `amount` | number | No | Cantidad a capturar en centavos (por defecto la cantidad total) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charge` | json | El objeto Cargo capturado |
|
||||
| `metadata` | json | Metadatos del cargo incluyendo ID, estado, monto, moneda y estado de pago |
|
||||
| `charge` | json | El objeto Charge capturado |
|
||||
| `metadata` | json | Metadatos del cargo incluyendo ID, estado, cantidad, moneda y estado de pago |
|
||||
|
||||
### `stripe_list_charges`
|
||||
|
||||
@@ -724,17 +742,17 @@ Listar todos los cargos
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `limit` | number | No | Número de resultados a devolver \(predeterminado 10, máximo 100\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `limit` | number | No | Número de resultados a devolver (predeterminado 10, máximo 100) |
|
||||
| `customer` | string | No | Filtrar por ID de cliente |
|
||||
| `created` | json | No | Filtrar por fecha de creación \(p. ej., \{"gt": 1633024800\}\) |
|
||||
| `created` | json | No | Filtrar por fecha de creación (p. ej., `{"gt": 1633024800}`) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charges` | json | Array de objetos Charge |
|
||||
| `metadata` | json | Metadatos de lista incluyendo count y has_more |
|
||||
| `metadata` | json | Metadatos de la lista incluyendo recuento y has_more |
|
||||
|
||||
### `stripe_search_charges`
|
||||
|
||||
@@ -753,7 +771,7 @@ Buscar cargos utilizando sintaxis de consulta
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charges` | json | Array de objetos Charge coincidentes |
|
||||
| `metadata` | json | Metadatos de búsqueda incluyendo count y has_more |
|
||||
| `metadata` | json | Metadatos de búsqueda incluyendo recuento y has_more |
|
||||
|
||||
### `stripe_create_product`
|
||||
|
||||
@@ -785,8 +803,8 @@ Recuperar un producto existente por ID
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID del producto \(p. ej., prod_1234567890\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del producto (p. ej., prod_1234567890) |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -803,8 +821,8 @@ Actualizar un producto existente
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID del producto \(p. ej., prod_1234567890\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del producto (p. ej., prod_1234567890) |
|
||||
| `name` | string | No | Nombre actualizado del producto |
|
||||
| `description` | string | No | Descripción actualizada del producto |
|
||||
| `active` | boolean | No | Estado activo actualizado |
|
||||
@@ -820,20 +838,20 @@ Actualizar un producto existente
|
||||
|
||||
### `stripe_delete_product`
|
||||
|
||||
Eliminar un producto permanentemente
|
||||
Eliminar permanentemente un producto
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `id` | string | Sí | ID del producto \(p. ej., prod_1234567890\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del producto (p. ej., prod_1234567890) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `deleted` | boolean | Si el producto fue eliminado |
|
||||
| `deleted` | boolean | Indica si el producto fue eliminado |
|
||||
| `id` | string | El ID del producto eliminado |
|
||||
| `metadata` | json | Metadatos de eliminación |
|
||||
|
||||
@@ -845,8 +863,8 @@ Listar todos los productos
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `limit` | number | No | Número de resultados a devolver \(predeterminado 10, máximo 100\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `limit` | number | No | Número de resultados a devolver (predeterminado 10, máximo 100) |
|
||||
| `active` | boolean | No | Filtrar por estado activo |
|
||||
|
||||
#### Salida
|
||||
@@ -864,15 +882,15 @@ Buscar productos usando sintaxis de consulta
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe \(clave secreta\) |
|
||||
| `query` | string | Sí | Consulta de búsqueda \(p. ej., "name:\'shirt\'"\) |
|
||||
| `limit` | number | No | Número de resultados a devolver \(predeterminado 10, máximo 100\) |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `query` | string | Sí | Consulta de búsqueda (p. ej., "name:\'camisa\'") |
|
||||
| `limit` | number | No | Número de resultados a devolver (predeterminado 10, máximo 100) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `products` | json | Array de objetos de productos coincidentes |
|
||||
| `products` | json | Array de objetos de producto coincidentes |
|
||||
| `metadata` | json | Metadatos de búsqueda |
|
||||
|
||||
### `stripe_create_price`
|
||||
@@ -884,12 +902,12 @@ Crear un nuevo precio para un producto
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `product` | string | Sí | ID del producto (ej., prod_1234567890) |
|
||||
| `currency` | string | Sí | Código de moneda ISO de tres letras (ej., usd, eur) |
|
||||
| `unit_amount` | number | No | Cantidad en centavos (ej., 1000 para $10.00) |
|
||||
| `product` | string | Sí | ID del producto (p. ej., prod_1234567890) |
|
||||
| `currency` | string | Sí | Código de moneda ISO de tres letras (p. ej., usd, eur) |
|
||||
| `unit_amount` | number | No | Cantidad en centavos (p. ej., 1000 para $10.00) |
|
||||
| `recurring` | json | No | Configuración de facturación recurrente (intervalo: día/semana/mes/año) |
|
||||
| `metadata` | json | No | Conjunto de pares clave-valor |
|
||||
| `billing_scheme` | string | No | Esquema de facturación (per_unit o tiered) |
|
||||
| `billing_scheme` | string | No | Esquema de facturación (por_unidad o escalonado) |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -907,7 +925,7 @@ Recuperar un precio existente por ID
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del precio (ej., price_1234567890) |
|
||||
| `id` | string | Sí | ID del precio (p. ej., price_1234567890) |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -923,9 +941,9 @@ Actualizar un precio existente
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del precio (ej., price_1234567890) |
|
||||
| `id` | string | Sí | ID del precio (p. ej., price_1234567890) |
|
||||
| `active` | boolean | No | Si el precio está activo |
|
||||
| `metadata` | json | No | Metadatos actualizados |
|
||||
|
||||
@@ -943,7 +961,7 @@ Listar todos los precios
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `limit` | number | No | Número de resultados a devolver (predeterminado 10, máximo 100) |
|
||||
| `product` | string | No | Filtrar por ID de producto |
|
||||
@@ -963,9 +981,9 @@ Buscar precios usando sintaxis de consulta
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `query` | string | Sí | Consulta de búsqueda (ej., "active:'true' AND currency:'usd'") |
|
||||
| `query` | string | Sí | Consulta de búsqueda (p. ej., "active:'true' AND currency:'usd'") |
|
||||
| `limit` | number | No | Número de resultados a devolver (predeterminado 10, máximo 100) |
|
||||
|
||||
#### Salida
|
||||
@@ -977,25 +995,25 @@ Buscar precios usando sintaxis de consulta
|
||||
|
||||
### `stripe_retrieve_event`
|
||||
|
||||
Recuperar un evento existente por ID
|
||||
Recuperar un Evento existente por ID
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `id` | string | Sí | ID del evento (p. ej., evt_1234567890) |
|
||||
| `id` | string | Sí | ID del Evento (p. ej., evt_1234567890) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `event` | json | El objeto Event recuperado |
|
||||
| `event` | json | El objeto Evento recuperado |
|
||||
| `metadata` | json | Metadatos del evento incluyendo ID, tipo y marca de tiempo de creación |
|
||||
|
||||
### `stripe_list_events`
|
||||
|
||||
Listar todos los eventos
|
||||
Listar todos los Eventos
|
||||
|
||||
#### Entrada
|
||||
|
||||
@@ -1004,13 +1022,13 @@ Listar todos los eventos
|
||||
| `apiKey` | string | Sí | Clave API de Stripe (clave secreta) |
|
||||
| `limit` | number | No | Número de resultados a devolver (predeterminado 10, máximo 100) |
|
||||
| `type` | string | No | Filtrar por tipo de evento (p. ej., payment_intent.created) |
|
||||
| `created` | json | No | Filtrar por fecha de creación \(p. ej., \{"gt": 1633024800\}\) |
|
||||
| `created` | json | No | Filtrar por fecha de creación (p. ej., `{"gt": 1633024800}`) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `events` | json | Array de objetos Event |
|
||||
| `events` | json | Array de objetos Evento |
|
||||
| `metadata` | json | Metadatos de la lista incluyendo recuento y has_more |
|
||||
|
||||
## Notas
|
||||
|
||||
@@ -10,9 +10,24 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#0052CC"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Trello](https://trello.com) es una herramienta de colaboración visual que te ayuda a organizar proyectos, tareas y flujos de trabajo utilizando tableros, listas y tarjetas.
|
||||
|
||||
Con Trello en Sim, puedes:
|
||||
|
||||
- **Listar tableros y listas**: Ver los tableros a los que tienes acceso y sus listas asociadas.
|
||||
- **Listar y buscar tarjetas**: Obtener todas las tarjetas en un tablero o filtrar por lista para ver su contenido y estado.
|
||||
- **Crear tarjetas**: Añadir nuevas tarjetas a una lista de Trello, incluyendo descripciones, etiquetas y fechas de vencimiento.
|
||||
- **Actualizar y mover tarjetas**: Editar propiedades de tarjetas, mover tarjetas entre listas y establecer fechas de vencimiento o etiquetas.
|
||||
- **Obtener actividad reciente**: Recuperar acciones e historial de actividad para tableros y tarjetas.
|
||||
- **Comentar en tarjetas**: Añadir comentarios a las tarjetas para colaboración y seguimiento.
|
||||
|
||||
La integración de Trello con Sim permite a tus agentes gestionar programáticamente las tareas, tableros y proyectos de tu equipo. Automatiza flujos de trabajo de gestión de proyectos, mantén listas de tareas actualizadas, sincroniza con otras herramientas o activa flujos de trabajo inteligentes en respuesta a eventos de Trello, todo a través de tus agentes de IA.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instrucciones de uso
|
||||
|
||||
Intégrate con Trello para gestionar tableros y tarjetas. Lista tableros, lista tarjetas, crea tarjetas, actualiza tarjetas, obtén acciones y añade comentarios.
|
||||
Integra con Trello para gestionar tableros y tarjetas. Lista tableros, lista tarjetas, crea tarjetas, actualiza tarjetas, obtiene acciones y añade comentarios.
|
||||
|
||||
## Herramientas
|
||||
|
||||
@@ -31,27 +46,26 @@ Listar todas las listas en un tablero de Trello
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si la operación fue exitosa |
|
||||
| `lists` | array | Array de objetos de lista con id, nombre, cerrado, pos e idBoard |
|
||||
| `lists` | array | Array de objetos de lista con id, nombre, cerrado, posición e idTablero |
|
||||
| `count` | number | Número de listas devueltas |
|
||||
| `error` | string | Mensaje de error si la operación falló |
|
||||
|
||||
### `trello_list_cards`
|
||||
|
||||
Listar todas las tarjetas en un tablero de Trello
|
||||
Listar todas las listas en un tablero de Trello
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `boardId` | string | Sí | ID del tablero del que listar las tarjetas |
|
||||
| `listId` | string | No | Opcional: Filtrar tarjetas por ID de lista |
|
||||
| `boardId` | string | Sí | ID del tablero del que listar las listas |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si la operación fue exitosa |
|
||||
| `cards` | array | Array de objetos de tarjeta con id, nombre, descripción, url, IDs de tablero/lista, etiquetas y fecha de vencimiento |
|
||||
| `cards` | array | Array de objetos de tarjeta con id, nombre, desc, url, IDs de tablero/lista, etiquetas y fecha de vencimiento |
|
||||
| `count` | number | Número de tarjetas devueltas |
|
||||
| `error` | string | Mensaje de error si la operación falló |
|
||||
|
||||
@@ -63,13 +77,13 @@ Crear una nueva tarjeta en un tablero de Trello
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `boardId` | string | Sí | ID del tablero donde crear la tarjeta |
|
||||
| `listId` | string | Sí | ID de la lista donde crear la tarjeta |
|
||||
| `boardId` | string | Sí | ID del tablero en el que crear la tarjeta |
|
||||
| `listId` | string | Sí | ID de la lista en la que crear la tarjeta |
|
||||
| `name` | string | Sí | Nombre/título de la tarjeta |
|
||||
| `desc` | string | No | Descripción de la tarjeta |
|
||||
| `pos` | string | No | Posición de la tarjeta \(arriba, abajo o número flotante positivo\) |
|
||||
| `pos` | string | No | Posición de la tarjeta \(top, bottom, o número flotante positivo\) |
|
||||
| `due` | string | No | Fecha de vencimiento \(formato ISO 8601\) |
|
||||
| `labels` | string | No | Lista de IDs de etiquetas separadas por comas |
|
||||
| `labels` | string | No | Lista de IDs de etiquetas separados por comas |
|
||||
|
||||
#### Salida
|
||||
|
||||
@@ -99,8 +113,8 @@ Actualizar una tarjeta existente en Trello
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Indica si la tarjeta se actualizó correctamente |
|
||||
| `card` | object | El objeto de tarjeta actualizado con id, nombre, descripción, url y otras propiedades |
|
||||
| `success` | boolean | Si la tarjeta se actualizó correctamente |
|
||||
| `card` | object | El objeto de la tarjeta actualizada con id, nombre, descripción, url y otras propiedades |
|
||||
| `error` | string | Mensaje de error si la operación falló |
|
||||
|
||||
### `trello_get_actions`
|
||||
@@ -113,14 +127,14 @@ Obtener actividad/acciones de un tablero o tarjeta
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `boardId` | string | No | ID del tablero del que obtener acciones \(se requiere boardId o cardId\) |
|
||||
| `cardId` | string | No | ID de la tarjeta de la que obtener acciones \(se requiere boardId o cardId\) |
|
||||
| `filter` | string | No | Filtrar acciones por tipo \(p. ej., "commentCard,updateCard,createCard" o "all"\) |
|
||||
| `filter` | string | No | Filtrar acciones por tipo \(p.ej., "commentCard,updateCard,createCard" o "all"\) |
|
||||
| `limit` | number | No | Número máximo de acciones a devolver \(predeterminado: 50, máx: 1000\) |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Indica si la operación fue exitosa |
|
||||
| `success` | boolean | Si la operación fue exitosa |
|
||||
| `actions` | array | Array de objetos de acción con tipo, fecha, miembro y datos |
|
||||
| `count` | number | Número de acciones devueltas |
|
||||
| `error` | string | Mensaje de error si la operación falló |
|
||||
@@ -140,7 +154,7 @@ Añadir un comentario a una tarjeta de Trello
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Indica si el comentario se agregó correctamente |
|
||||
| `success` | boolean | Si el comentario se añadió correctamente |
|
||||
| `comment` | object | El objeto de comentario creado con id, texto, fecha y miembro creador |
|
||||
| `error` | string | Mensaje de error si la operación falló |
|
||||
|
||||
|
||||
@@ -94,4 +94,14 @@ Haz referencia a valores estructurados posteriores con expresiones como <code>&l
|
||||
|
||||
- Trata el bloque Start como el único punto de entrada cuando quieras dar soporte tanto a llamadas de API como de chat.
|
||||
- Prefiere campos con formato de entrada nombrados en lugar de analizar JSON sin procesar en nodos posteriores; la conversión de tipos ocurre automáticamente.
|
||||
- Añade validación o enrutamiento inmediatamente después de Start si ciertos campos son necesarios para que tu flujo de trabajo tenga éxito.
|
||||
|
||||
- Conecta <code><start.fieldName></code> directamente a agentes, herramientas o funciones que esperan cargas estructuradas.
|
||||
- Usa sintaxis de plantillas como <code><start.sampleField></code> o <code><start.files[0].url></code> (solo en chat) en campos de prompt.
|
||||
- Mantén <code><start.conversationId></code> a mano cuando necesites agrupar salidas, actualizar el historial de conversación o llamar de nuevo a la API de chat.
|
||||
|
||||
## Mejores prácticas
|
||||
|
||||
- Trata el bloque Start como el único punto de entrada cuando quieras admitir tanto llamadas de API como de chat.
|
||||
- Prefiere campos de Formato de Entrada con nombre en lugar de analizar JSON sin procesar en nodos posteriores; la conversión de tipos ocurre automáticamente.
|
||||
- Añade validación o enrutamiento inmediatamente después de Start si ciertos campos son necesarios para que tu flujo de trabajo tenga éxito.
|
||||
@@ -11,9 +11,9 @@ Le bloc Condition permet de ramifier l'exécution du flux de travail en fonction
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/condition.png"
|
||||
alt="Bloc Condition"
|
||||
alt="Bloc de condition"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -9,9 +9,9 @@ Le bloc Fonction exécute du code JavaScript ou TypeScript personnalisé dans vo
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/function.png"
|
||||
alt="Bloc Fonction avec Éditeur de Code"
|
||||
alt="Bloc de fonction avec éditeur de code"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -11,9 +11,9 @@ Le bloc Guardrails valide et protège vos flux de travail IA en vérifiant le co
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/guardrails.png"
|
||||
alt="Bloc Guardrails"
|
||||
alt="Bloc de garde-fous"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -124,10 +124,6 @@ Chaque instance parallèle s'exécute indépendamment :
|
||||
- Vous ne pouvez pas placer un bloc conteneur à l'intérieur d'un autre bloc conteneur
|
||||
</Callout>
|
||||
|
||||
<Callout type="warning">
|
||||
Les blocs parallèles ne peuvent contenir qu'un seul bloc. Vous ne pouvez pas avoir plusieurs blocs connectés les uns aux autres à l'intérieur d'un parallèle - seul le premier bloc s'exécuterait dans ce cas.
|
||||
</Callout>
|
||||
|
||||
<Callout type="info">
|
||||
Bien que l'exécution parallèle soit plus rapide, soyez attentif à :
|
||||
- Limites de taux des API lors de requêtes simultanées
|
||||
@@ -191,5 +187,5 @@ Comprendre quand utiliser chacun :
|
||||
## Bonnes pratiques
|
||||
|
||||
- **Opérations indépendantes uniquement** : Assurez-vous que les opérations ne dépendent pas les unes des autres
|
||||
- **Gérer les limites de débit** : Ajoutez des délais ou limitez le débit pour les workflows à forte utilisation d'API
|
||||
- **Gérer les limites de taux** : Ajoutez des délais ou une limitation pour les workflows intensifs en API
|
||||
- **Gestion des erreurs** : Chaque instance doit gérer ses propres erreurs avec élégance
|
||||
|
||||
@@ -11,9 +11,9 @@ Le bloc Variables met à jour les variables du workflow pendant l'exécution. Le
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/variables.png"
|
||||
alt="Bloc Variables"
|
||||
alt="Bloc de variables"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -13,7 +13,7 @@ Le bloc Attente met en pause votre flux de travail pendant une durée spécifié
|
||||
src="/static/blocks/wait.png"
|
||||
alt="Bloc d'attente"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -12,8 +12,8 @@ import { Image } from '@/components/ui/image'
|
||||
<Image
|
||||
src="/static/blocks/workflow.png"
|
||||
alt="Configuration du bloc de flux de travail"
|
||||
width={400}
|
||||
height={280}
|
||||
width={500}
|
||||
height={400}
|
||||
className="rounded-xl border border-border shadow-sm"
|
||||
/>
|
||||
</div>
|
||||
@@ -40,6 +40,18 @@ Déposez un bloc de flux de travail lorsque vous souhaitez appeler un flux de tr
|
||||
- `success` – s'il s'est exécuté sans erreurs
|
||||
- `error` – message lorsque l'exécution échoue
|
||||
|
||||
## Badge de statut de déploiement
|
||||
|
||||
Le bloc Workflow affiche un badge de statut de déploiement pour vous aider à suivre si le flux de travail enfant est prêt à être exécuté :
|
||||
|
||||
- **Déployé** – Le flux de travail enfant a été déployé et est prêt à être utilisé. Le bloc exécutera la version déployée actuelle.
|
||||
- **Non déployé** – Le flux de travail enfant n'a jamais été déployé. Vous devez le déployer avant que le bloc Workflow puisse l'exécuter.
|
||||
- **Redéployer** – Des modifications ont été détectées dans le flux de travail enfant depuis le dernier déploiement. Cliquez sur le badge pour redéployer le flux de travail enfant avec les dernières modifications.
|
||||
|
||||
<Callout type="warn">
|
||||
Le bloc Workflow exécute toujours la version déployée la plus récente du flux de travail enfant, pas la version de l'éditeur. Assurez-vous de redéployer après avoir apporté des modifications pour garantir que le bloc utilise la logique la plus récente.
|
||||
</Callout>
|
||||
|
||||
## Notes d'exécution
|
||||
|
||||
- Les flux de travail enfants s'exécutent dans le même contexte d'espace de travail, donc les variables d'environnement et les outils sont conservés.
|
||||
|
||||
@@ -10,9 +10,23 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
L'outil [MongoDB](https://www.mongodb.com/) vous permet de vous connecter à une base de données MongoDB et d'effectuer une large gamme d'opérations orientées document directement dans vos flux de travail d'agents. Avec une configuration flexible et une gestion sécurisée des connexions, vous pouvez facilement interagir avec vos données et les manipuler.
|
||||
|
||||
Avec l'outil MongoDB, vous pouvez :
|
||||
|
||||
- **Trouver des documents** : interroger des collections et récupérer des documents avec l'opération `mongodb_query` en utilisant des filtres de requête riches.
|
||||
- **Insérer des documents** : ajouter un ou plusieurs documents à une collection en utilisant l'opération `mongodb_insert`.
|
||||
- **Mettre à jour des documents** : modifier des documents existants avec l'opération `mongodb_update` en spécifiant des critères de filtre et les actions de mise à jour.
|
||||
- **Supprimer des documents** : retirer des documents d'une collection en utilisant l'opération `mongodb_delete`, en spécifiant des filtres et des options de suppression.
|
||||
- **Agréger des données** : exécuter des pipelines d'agrégation complexes avec l'opération `mongodb_execute` pour transformer et analyser vos données.
|
||||
|
||||
L'outil MongoDB est idéal pour les flux de travail où vos agents doivent gérer ou analyser des données structurées basées sur des documents. Qu'il s'agisse de traiter du contenu généré par les utilisateurs, de gérer des données d'application ou d'alimenter des analyses, l'outil MongoDB simplifie l'accès et la manipulation de vos données de manière sécurisée et programmatique.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instructions d'utilisation
|
||||
|
||||
Intégrer MongoDB dans le flux de travail. Peut trouver, insérer, mettre à jour, supprimer et agréger des données.
|
||||
Intégrez MongoDB dans le flux de travail. Permet de trouver, insérer, mettre à jour, supprimer et agréger des données.
|
||||
|
||||
## Outils
|
||||
|
||||
@@ -24,17 +38,17 @@ Exécuter une opération de recherche sur une collection MongoDB
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `host` | chaîne | Oui | Nom d'hôte ou adresse IP du serveur MongoDB |
|
||||
| `port` | nombre | Oui | Port du serveur MongoDB \(par défaut : 27017\) |
|
||||
| `database` | chaîne | Oui | Nom de la base de données à laquelle se connecter |
|
||||
| `username` | chaîne | Non | Nom d'utilisateur MongoDB |
|
||||
| `password` | chaîne | Non | Mot de passe MongoDB |
|
||||
| `authSource` | chaîne | Non | Base de données d'authentification |
|
||||
| `ssl` | chaîne | Non | Mode de connexion SSL \(disabled, required, preferred\) |
|
||||
| `collection` | chaîne | Oui | Nom de la collection à interroger |
|
||||
| `query` | chaîne | Non | Filtre de requête MongoDB sous forme de chaîne JSON |
|
||||
| `limit` | nombre | Non | Nombre maximum de documents à retourner |
|
||||
| `sort` | chaîne | Non | Critères de tri sous forme de chaîne JSON |
|
||||
| `host` | string | Oui | Nom d'hôte ou adresse IP du serveur MongoDB |
|
||||
| `port` | number | Oui | Port du serveur MongoDB \(par défaut : 27017\) |
|
||||
| `database` | string | Oui | Nom de la base de données à laquelle se connecter |
|
||||
| `username` | string | Non | Nom d'utilisateur MongoDB |
|
||||
| `password` | string | Non | Mot de passe MongoDB |
|
||||
| `authSource` | string | Non | Base de données d'authentification |
|
||||
| `ssl` | string | Non | Mode de connexion SSL \(disabled, required, preferred\) |
|
||||
| `collection` | string | Oui | Nom de la collection à interroger |
|
||||
| `query` | string | Non | Filtre de requête MongoDB au format JSON |
|
||||
| `limit` | number | Non | Nombre maximum de documents à retourner |
|
||||
| `sort` | string | Non | Critères de tri au format JSON |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -60,7 +74,7 @@ Insérer des documents dans une collection MongoDB
|
||||
| `authSource` | chaîne | Non | Base de données d'authentification |
|
||||
| `ssl` | chaîne | Non | Mode de connexion SSL \(disabled, required, preferred\) |
|
||||
| `collection` | chaîne | Oui | Nom de la collection dans laquelle insérer |
|
||||
| `documents` | tableau | Oui | Tableau de documents à insérer |
|
||||
| `documents` | tableau | Oui | Tableau des documents à insérer |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -96,11 +110,11 @@ Mettre à jour des documents dans une collection MongoDB
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Message d'état de l'opération |
|
||||
| `matchedCount` | number | Nombre de documents correspondant au filtre |
|
||||
| `modifiedCount` | number | Nombre de documents modifiés |
|
||||
| `documentCount` | number | Nombre total de documents affectés |
|
||||
| `insertedId` | string | ID du document inséré \(si upsert\) |
|
||||
| `message` | chaîne | Message d'état de l'opération |
|
||||
| `matchedCount` | nombre | Nombre de documents correspondant au filtre |
|
||||
| `modifiedCount` | nombre | Nombre de documents modifiés |
|
||||
| `documentCount` | nombre | Nombre total de documents affectés |
|
||||
| `insertedId` | chaîne | ID du document inséré \(si upsert\) |
|
||||
|
||||
### `mongodb_delete`
|
||||
|
||||
@@ -109,25 +123,25 @@ Supprimer des documents d'une collection MongoDB
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `host` | string | Oui | Nom d'hôte ou adresse IP du serveur MongoDB |
|
||||
| `port` | number | Oui | Port du serveur MongoDB \(par défaut : 27017\) |
|
||||
| `database` | string | Oui | Nom de la base de données à laquelle se connecter |
|
||||
| `username` | string | Non | Nom d'utilisateur MongoDB |
|
||||
| `password` | string | Non | Mot de passe MongoDB |
|
||||
| `authSource` | string | Non | Base de données d'authentification |
|
||||
| `ssl` | string | Non | Mode de connexion SSL \(disabled, required, preferred\) |
|
||||
| `collection` | string | Oui | Nom de la collection dans laquelle supprimer |
|
||||
| `filter` | string | Oui | Critères de filtre au format JSON |
|
||||
| `multi` | boolean | Non | Supprimer plusieurs documents |
|
||||
| --------- | ---- | ---------- | ----------- |
|
||||
| `host` | chaîne | Oui | Nom d'hôte ou adresse IP du serveur MongoDB |
|
||||
| `port` | nombre | Oui | Port du serveur MongoDB \(par défaut : 27017\) |
|
||||
| `database` | chaîne | Oui | Nom de la base de données à laquelle se connecter |
|
||||
| `username` | chaîne | Non | Nom d'utilisateur MongoDB |
|
||||
| `password` | chaîne | Non | Mot de passe MongoDB |
|
||||
| `authSource` | chaîne | Non | Base de données d'authentification |
|
||||
| `ssl` | chaîne | Non | Mode de connexion SSL \(disabled, required, preferred\) |
|
||||
| `collection` | chaîne | Oui | Nom de la collection de laquelle supprimer |
|
||||
| `filter` | chaîne | Oui | Critères de filtrage au format JSON |
|
||||
| `multi` | booléen | Non | Supprimer plusieurs documents |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | Message d'état de l'opération |
|
||||
| `deletedCount` | number | Nombre de documents supprimés |
|
||||
| `documentCount` | number | Nombre total de documents affectés |
|
||||
| `message` | chaîne | Message d'état de l'opération |
|
||||
| `deletedCount` | nombre | Nombre de documents supprimés |
|
||||
| `documentCount` | nombre | Nombre total de documents affectés |
|
||||
|
||||
### `mongodb_execute`
|
||||
|
||||
@@ -145,17 +159,17 @@ Exécuter un pipeline d'agrégation MongoDB
|
||||
| `authSource` | chaîne | Non | Base de données d'authentification |
|
||||
| `ssl` | chaîne | Non | Mode de connexion SSL \(disabled, required, preferred\) |
|
||||
| `collection` | chaîne | Oui | Nom de la collection sur laquelle exécuter le pipeline |
|
||||
| `pipeline` | chaîne | Oui | Pipeline d'agrégation sous forme de chaîne JSON |
|
||||
| `pipeline` | chaîne | Oui | Pipeline d'agrégation au format JSON |
|
||||
|
||||
#### Sortie
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | chaîne | Message d'état de l'opération |
|
||||
| `documents` | tableau | Tableau des documents retournés par l'agrégation |
|
||||
| `documents` | tableau | Tableau de documents retournés par l'agrégation |
|
||||
| `documentCount` | nombre | Nombre de documents retournés |
|
||||
|
||||
## Remarques
|
||||
## Notes
|
||||
|
||||
- Catégorie : `tools`
|
||||
- Type : `mongodb`
|
||||
|
||||
@@ -10,24 +10,38 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
L'outil [Salesforce](https://www.salesforce.com/) vous permet de vous connecter directement à votre CRM Salesforce et d'effectuer un large éventail d'opérations de gestion de la relation client dans vos flux de travail automatisés. Grâce à une intégration fluide et sécurisée, vous pouvez accéder efficacement à vos processus commerciaux clés et les automatiser à travers vos données de vente, d'assistance et de marketing.
|
||||
|
||||
Avec l'outil Salesforce, vous pouvez :
|
||||
|
||||
- **Récupérer des comptes** : Utilisez l'opération `salesforce_get_accounts` pour extraire des comptes de Salesforce avec des filtres personnalisés, des tris et une sélection de champs.
|
||||
- **Créer des comptes** : Ajoutez automatiquement de nouveaux comptes à Salesforce en utilisant l'opération `salesforce_create_account`, en spécifiant des détails comme le nom, le secteur d'activité et l'adresse de facturation.
|
||||
- **Gérer les contacts** : (Si fourni, des outils similaires sont disponibles pour les contacts - ajoutez, mettez à jour ou récupérez des contacts selon vos besoins.)
|
||||
- **Gérer les prospects et opportunités** : Intégrez la gestion des prospects et des opportunités dans votre flux de travail, permettant à vos agents de capturer, qualifier et mettre à jour les données du pipeline de vente.
|
||||
- **Suivre les dossiers et les tâches** : Automatisez les activités de support client et de suivi en interagissant avec les dossiers et les tâches dans Salesforce.
|
||||
|
||||
L'outil Salesforce est idéal pour les flux de travail où vos agents doivent rationaliser les opérations de vente, de gestion de comptes, de génération de prospects et d'assistance. Que vos agents synchronisent des données entre plateformes, fournissent des informations client en temps réel ou automatisent des mises à jour CRM de routine, l'outil Salesforce apporte toute la puissance et l'extensibilité de Salesforce dans vos processus programmatiques pilotés par des agents.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instructions d'utilisation
|
||||
|
||||
Intégrez Salesforce dans votre flux de travail. Gérez les comptes, contacts, prospects, opportunités, requêtes et tâches avec de puissantes capacités d'automatisation.
|
||||
Intégrez Salesforce dans votre flux de travail. Gérez les comptes, contacts, prospects, opportunités, dossiers et tâches avec de puissantes capacités d'automatisation.
|
||||
|
||||
## Outils
|
||||
|
||||
### `salesforce_get_accounts`
|
||||
|
||||
Récupérer des comptes depuis Salesforce CRM
|
||||
Récupérer des comptes depuis le CRM Salesforce
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `idToken` | string | Non | Le jeton ID de l'OAuth Salesforce \(contient l'URL de l'instance\) |
|
||||
| --------- | ---- | ---------- | ----------- |
|
||||
| `idToken` | string | Non | Le jeton d'ID de l'OAuth Salesforce \(contient l'URL de l'instance\) |
|
||||
| `instanceUrl` | string | Non | L'URL de l'instance Salesforce |
|
||||
| `limit` | string | Non | Nombre de résultats à retourner \(par défaut : 100, max : 2000\) |
|
||||
| `fields` | string | Non | Liste des champs à retourner séparés par des virgules \(ex. : "Id,Name,Industry,Phone"\) |
|
||||
| `fields` | string | Non | Liste de champs à retourner séparés par des virgules \(ex. : "Id,Name,Industry,Phone"\) |
|
||||
| `orderBy` | string | Non | Champ pour l'ordre de tri \(ex. : "Name ASC" ou "CreatedDate DESC"\) |
|
||||
|
||||
#### Sortie
|
||||
@@ -48,8 +62,8 @@ Créer un nouveau compte dans Salesforce CRM
|
||||
| `idToken` | string | Non | Pas de description |
|
||||
| `instanceUrl` | string | Non | Pas de description |
|
||||
| `name` | string | Oui | Nom du compte \(obligatoire\) |
|
||||
| `type` | string | Non | Type de compte \(ex. : Client, Partenaire, Prospect\) |
|
||||
| `industry` | string | Non | Secteur d'activité \(ex. : Technologie, Santé, Finance\) |
|
||||
| `type` | string | Non | Type de compte \(ex., Client, Partenaire, Prospect\) |
|
||||
| `industry` | string | Non | Secteur d'activité \(ex., Technologie, Santé, Finance\) |
|
||||
| `phone` | string | Non | Numéro de téléphone |
|
||||
| `website` | string | Non | URL du site web |
|
||||
| `billingStreet` | string | Non | Adresse de facturation |
|
||||
@@ -131,7 +145,7 @@ Supprimer un compte de Salesforce CRM
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Statut de réussite de l'opération |
|
||||
| `output` | json | Données du résultat de l'opération |
|
||||
| `output` | json | Données résultant de l'opération |
|
||||
|
||||
### `salesforce_create_contact`
|
||||
|
||||
@@ -145,7 +159,7 @@ Supprimer un compte de Salesforce CRM
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Statut de réussite de l'opération |
|
||||
| `output` | json | Données du résultat de l'opération |
|
||||
| `output` | json | Données résultant de l'opération |
|
||||
|
||||
### `salesforce_update_contact`
|
||||
|
||||
@@ -159,14 +173,14 @@ Supprimer un compte de Salesforce CRM
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Statut de réussite de l'opération |
|
||||
| `output` | json | Données du résultat de l'opération |
|
||||
| `output` | json | Données résultant de l'opération |
|
||||
|
||||
### `salesforce_delete_contact`
|
||||
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -180,7 +194,7 @@ Supprimer un compte de Salesforce CRM
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -194,7 +208,7 @@ Supprimer un compte de Salesforce CRM
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -208,7 +222,7 @@ Supprimer un compte de Salesforce CRM
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -222,7 +236,7 @@ Supprimer un compte de Salesforce CRM
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -306,7 +320,7 @@ Supprimer un compte de Salesforce CRM
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -320,7 +334,7 @@ Supprimer un compte de Salesforce CRM
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -334,7 +348,7 @@ Supprimer un compte de Salesforce CRM
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -348,7 +362,7 @@ Supprimer un compte de Salesforce CRM
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -362,7 +376,7 @@ Supprimer un compte de Salesforce CRM
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -376,7 +390,7 @@ Supprimer un compte de Salesforce CRM
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -390,7 +404,7 @@ Supprimer un compte de Salesforce CRM
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### Sortie
|
||||
|
||||
|
||||
@@ -10,6 +10,21 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#0052CC"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Trello](https://trello.com) est un outil de collaboration visuel qui vous aide à organiser des projets, des tâches et des flux de travail à l'aide de tableaux, de listes et de cartes.
|
||||
|
||||
Avec Trello dans Sim, vous pouvez :
|
||||
|
||||
- **Lister les tableaux et les listes** : Visualiser les tableaux auxquels vous avez accès et leurs listes associées.
|
||||
- **Lister et rechercher des cartes** : Récupérer toutes les cartes d'un tableau ou filtrer par liste pour voir leur contenu et leur statut.
|
||||
- **Créer des cartes** : Ajouter de nouvelles cartes à une liste Trello, y compris des descriptions, des étiquettes et des dates d'échéance.
|
||||
- **Mettre à jour et déplacer des cartes** : Modifier les propriétés des cartes, déplacer des cartes entre les listes, et définir des dates d'échéance ou des étiquettes.
|
||||
- **Obtenir l'activité récente** : Récupérer les actions et l'historique d'activité pour les tableaux et les cartes.
|
||||
- **Commenter les cartes** : Ajouter des commentaires aux cartes pour la collaboration et le suivi.
|
||||
|
||||
L'intégration de Trello avec Sim permet à vos agents de gérer les tâches, les tableaux et les projets de votre équipe de manière programmatique. Automatisez les flux de travail de gestion de projet, maintenez les listes de tâches à jour, synchronisez avec d'autres outils, ou déclenchez des flux de travail intelligents en réponse aux événements Trello — le tout grâce à vos agents IA.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## Instructions d'utilisation
|
||||
|
||||
Intégrez avec Trello pour gérer les tableaux et les cartes. Listez les tableaux, listez les cartes, créez des cartes, mettez à jour des cartes, obtenez des actions et ajoutez des commentaires.
|
||||
@@ -23,8 +38,8 @@ Lister toutes les listes d'un tableau Trello
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `boardId` | string | Oui | ID du tableau dont on veut lister les listes |
|
||||
| --------- | ---- | ---------- | ----------- |
|
||||
| `boardId` | chaîne | Oui | ID du tableau dont on veut lister les listes |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -51,7 +66,7 @@ Lister toutes les cartes d'un tableau Trello
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si l'opération a réussi |
|
||||
| `cards` | array | Tableau d'objets carte avec id, nom, description, url, IDs de tableau/liste, étiquettes et date d'échéance |
|
||||
| `cards` | array | Tableau d'objets carte avec id, nom, description, url, IDs du tableau/liste, étiquettes et date d'échéance |
|
||||
| `count` | number | Nombre de cartes retournées |
|
||||
| `error` | string | Message d'erreur si l'opération a échoué |
|
||||
|
||||
@@ -62,14 +77,14 @@ Créer une nouvelle carte sur un tableau Trello
|
||||
#### Entrée
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ---------- | ----------- |
|
||||
| `boardId` | chaîne | Oui | ID du tableau sur lequel créer la carte |
|
||||
| `listId` | chaîne | Oui | ID de la liste dans laquelle créer la carte |
|
||||
| `name` | chaîne | Oui | Nom/titre de la carte |
|
||||
| `desc` | chaîne | Non | Description de la carte |
|
||||
| `pos` | chaîne | Non | Position de la carte \(haut, bas, ou nombre flottant positif\) |
|
||||
| `due` | chaîne | Non | Date d'échéance \(format ISO 8601\) |
|
||||
| `labels` | chaîne | Non | Liste d'IDs d'étiquettes séparés par des virgules |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `boardId` | string | Oui | ID du tableau sur lequel créer la carte |
|
||||
| `listId` | string | Oui | ID de la liste dans laquelle créer la carte |
|
||||
| `name` | string | Oui | Nom/titre de la carte |
|
||||
| `desc` | string | Non | Description de la carte |
|
||||
| `pos` | string | Non | Position de la carte \(top, bottom, ou nombre flottant positif\) |
|
||||
| `due` | string | Non | Date d'échéance \(format ISO 8601\) |
|
||||
| `labels` | string | Non | Liste d'IDs d'étiquettes séparés par des virgules |
|
||||
|
||||
#### Sortie
|
||||
|
||||
@@ -99,9 +114,9 @@ Mettre à jour une carte existante sur Trello
|
||||
|
||||
| Paramètre | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Indique si la carte a été mise à jour avec succès |
|
||||
| `card` | object | L'objet carte mis à jour avec id, nom, description, url et autres propriétés |
|
||||
| `error` | string | Message d'erreur si l'opération a échoué |
|
||||
| `success` | booléen | Indique si la carte a été mise à jour avec succès |
|
||||
| `card` | objet | L'objet carte mis à jour avec id, nom, description, url et autres propriétés |
|
||||
| `error` | chaîne | Message d'erreur si l'opération a échoué |
|
||||
|
||||
### `trello_get_actions`
|
||||
|
||||
@@ -111,10 +126,10 @@ Obtenir l'activité/les actions d'un tableau ou d'une carte
|
||||
|
||||
| Paramètre | Type | Obligatoire | Description |
|
||||
| --------- | ---- | ---------- | ----------- |
|
||||
| `boardId` | string | Non | ID du tableau pour obtenir les actions (soit boardId soit cardId requis) |
|
||||
| `cardId` | string | Non | ID de la carte pour obtenir les actions (soit boardId soit cardId requis) |
|
||||
| `filter` | string | Non | Filtrer les actions par type (par exemple, "commentCard,updateCard,createCard" ou "all") |
|
||||
| `limit` | number | Non | Nombre maximum d'actions à retourner (par défaut : 50, max : 1000) |
|
||||
| `boardId` | chaîne | Non | ID du tableau dont on veut obtenir les actions \(soit boardId soit cardId requis\) |
|
||||
| `cardId` | chaîne | Non | ID de la carte dont on veut obtenir les actions \(soit boardId soit cardId requis\) |
|
||||
| `filter` | chaîne | Non | Filtrer les actions par type \(ex. : "commentCard,updateCard,createCard" ou "all"\) |
|
||||
| `limit` | nombre | Non | Nombre maximum d'actions à retourner \(par défaut : 50, max : 1000\) |
|
||||
|
||||
#### Sortie
|
||||
|
||||
|
||||
@@ -94,3 +94,13 @@ Référencez les valeurs structurées en aval avec des expressions telles que <c
|
||||
- Considérez le bloc Start comme le point d'entrée unique lorsque vous souhaitez prendre en charge à la fois les appelants API et chat.
|
||||
- Préférez les champs de format d'entrée nommés plutôt que d'analyser du JSON brut dans les nœuds en aval ; la conversion de type se fait automatiquement.
|
||||
- Ajoutez une validation ou un routage immédiatement après Start si certains champs sont nécessaires pour que votre flux de travail réussisse.
|
||||
|
||||
- Connectez <code><start.fieldName></code> directement aux agents, outils ou fonctions qui attendent des charges utiles structurées.
|
||||
- Utilisez la syntaxe de modèle comme <code><start.sampleField></code> ou <code><start.files[0].url></code> (chat uniquement) dans les champs de prompt.
|
||||
- Gardez <code><start.conversationId></code> à portée de main lorsque vous devez regrouper des sorties, mettre à jour l'historique de conversation ou rappeler l'API de chat.
|
||||
|
||||
## Meilleures pratiques
|
||||
|
||||
- Traitez le bloc Start comme le point d'entrée unique lorsque vous souhaitez prendre en charge à la fois les appelants API et chat.
|
||||
- Préférez les champs de format d'entrée nommés plutôt que d'analyser du JSON brut dans les nœuds en aval ; la conversion de type se fait automatiquement.
|
||||
- Ajoutez une validation ou un routage immédiatement après Start si certains champs sont nécessaires pour que votre flux de travail réussisse.
|
||||
|
||||
@@ -13,7 +13,7 @@ import { Image } from '@/components/ui/image'
|
||||
src="/static/blocks/condition.png"
|
||||
alt="条件ブロック"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -11,7 +11,7 @@ import { Image } from '@/components/ui/image'
|
||||
src="/static/blocks/function.png"
|
||||
alt="コードエディタ付き関数ブロック"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -13,7 +13,7 @@ import { Video } from '@/components/ui/video'
|
||||
src="/static/blocks/guardrails.png"
|
||||
alt="ガードレールブロック"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -124,10 +124,6 @@ Parallel (["gpt-4o", "claude-3.7-sonnet", "gemini-2.5-pro"]) → Agent → Evalu
|
||||
- どのコンテナブロック内にも別のコンテナブロックを配置できません
|
||||
</Callout>
|
||||
|
||||
<Callout type="warning">
|
||||
並列ブロックには単一のブロックしか含められません。並列内で複数のブロックを互いに接続することはできません - その場合、最初のブロックのみが実行されます。
|
||||
</Callout>
|
||||
|
||||
<Callout type="info">
|
||||
並列実行は高速ですが、以下の点に注意してください:
|
||||
- 同時リクエスト時のAPIレート制限
|
||||
@@ -135,13 +131,13 @@ Parallel (["gpt-4o", "claude-3.7-sonnet", "gemini-2.5-pro"]) → Agent → Evalu
|
||||
- リソース枯渇を防ぐための最大20の同時インスタンス
|
||||
</Callout>
|
||||
|
||||
## 並列とループの比較
|
||||
## 並列処理とループ処理の比較
|
||||
|
||||
それぞれの使用タイミングを理解する:
|
||||
|
||||
| 機能 | 並列 | ループ |
|
||||
| 機能 | 並列処理 | ループ処理 |
|
||||
|---------|----------|------|
|
||||
| 実行 | 同時 | 順次 |
|
||||
| 実行方法 | 同時実行 | 順次実行 |
|
||||
| 速度 | 独立した操作では高速 | 遅いが順序を保持 |
|
||||
| 順序 | 順序保証なし | 順序を維持 |
|
||||
| ユースケース | 独立した操作 | 依存関係のある操作 |
|
||||
@@ -159,7 +155,7 @@ Parallel (["gpt-4o", "claude-3.7-sonnet", "gemini-2.5-pro"]) → Agent → Evalu
|
||||
<strong>カウント</strong>:実行するインスタンス数(カウントベース)
|
||||
</li>
|
||||
<li>
|
||||
<strong>コレクション</strong>:分配する配列またはオブジェクト(コレクションベース)
|
||||
<strong>コレクション</strong>:分散する配列またはオブジェクト(コレクションベース)
|
||||
</li>
|
||||
</ul>
|
||||
</Tab>
|
||||
@@ -169,7 +165,7 @@ Parallel (["gpt-4o", "claude-3.7-sonnet", "gemini-2.5-pro"]) → Agent → Evalu
|
||||
<strong>parallel.currentItem</strong>:このインスタンスのアイテム
|
||||
</li>
|
||||
<li>
|
||||
<strong>parallel.index</strong>:インスタンス番号(0ベース)
|
||||
<strong>parallel.index</strong>:インスタンス番号(0から始まる)
|
||||
</li>
|
||||
<li>
|
||||
<strong>parallel.items</strong>:完全なコレクション(コレクションベース)
|
||||
@@ -182,7 +178,7 @@ Parallel (["gpt-4o", "claude-3.7-sonnet", "gemini-2.5-pro"]) → Agent → Evalu
|
||||
<strong>parallel.results</strong>:すべてのインスタンス結果の配列
|
||||
</li>
|
||||
<li>
|
||||
<strong>アクセス</strong>:並列後のブロックで利用可能
|
||||
<strong>アクセス</strong>:並列処理後のブロックで利用可能
|
||||
</li>
|
||||
</ul>
|
||||
</Tab>
|
||||
@@ -190,6 +186,6 @@ Parallel (["gpt-4o", "claude-3.7-sonnet", "gemini-2.5-pro"]) → Agent → Evalu
|
||||
|
||||
## ベストプラクティス
|
||||
|
||||
- **独立した操作のみ**: 操作が互いに依存しないようにする
|
||||
- **レート制限の処理**: API負荷の高いワークフローには遅延またはスロットリングを追加する
|
||||
- **エラー処理**: 各インスタンスは自身のエラーを適切に処理する必要がある
|
||||
- **独立した操作のみ**:操作が互いに依存しないようにする
|
||||
- **レート制限の処理**:API使用が多いワークフローには遅延やスロットリングを追加
|
||||
- **エラー処理**:各インスタンスは自身のエラーを適切に処理すべき
|
||||
|
||||
@@ -13,7 +13,7 @@ import { Image } from '@/components/ui/image'
|
||||
src="/static/blocks/variables.png"
|
||||
alt="変数ブロック"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -13,7 +13,7 @@ import { Image } from '@/components/ui/image'
|
||||
src="/static/blocks/wait.png"
|
||||
alt="待機ブロック"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -12,8 +12,8 @@ import { Image } from '@/components/ui/image'
|
||||
<Image
|
||||
src='/static/blocks/workflow.png'
|
||||
alt='ワークフローブロックの設定'
|
||||
width={400}
|
||||
height={280}
|
||||
width={500}
|
||||
height={400}
|
||||
className='rounded-xl border border-border shadow-sm'
|
||||
/>
|
||||
</div>
|
||||
@@ -40,12 +40,24 @@ import { Image } from '@/components/ui/image'
|
||||
- `success` – エラーなく実行されたかどうか
|
||||
- `error` – 実行が失敗した場合のメッセージ
|
||||
|
||||
## デプロイメントステータスバッジ
|
||||
|
||||
ワークフローブロックは、子ワークフローが実行準備ができているかどうかを追跡するのに役立つデプロイメントステータスバッジを表示します:
|
||||
|
||||
- **デプロイ済み** – 子ワークフローがデプロイされ、使用準備ができています。ブロックは現在デプロイされているバージョンを実行します。
|
||||
- **未デプロイ** – 子ワークフローが一度もデプロイされていません。ワークフローブロックが実行する前にデプロイする必要があります。
|
||||
- **再デプロイ** – 最後のデプロイ以降、子ワークフローに変更が検出されました。バッジをクリックして、最新の変更で子ワークフローを再デプロイしてください。
|
||||
|
||||
<Callout type="warn">
|
||||
ワークフローブロックは常に子ワークフローの最新デプロイバージョンを実行し、エディタバージョンではありません。変更を加えた後は必ず再デプロイして、ブロックが最新のロジックを使用するようにしてください。
|
||||
</Callout>
|
||||
|
||||
## 実行に関する注意事項
|
||||
|
||||
- 子ワークフローは同じワークスペースコンテキストで実行されるため、環境変数とツールは引き継がれます。
|
||||
- このブロックはデプロイメントバージョニングを使用します:API、スケジュール、ウェブフック、手動、またはチャット実行はデプロイされたスナップショットを呼び出します。子ワークフローを変更した場合は再デプロイしてください。
|
||||
- 子ワークフローは同じワークスペースコンテキストで実行されるため、環境変数やツールは引き継がれます。
|
||||
- ブロックはデプロイメントバージョン管理を使用します:API、スケジュール、ウェブフック、手動、またはチャット実行はすべてデプロイされたスナップショットを呼び出します。子ワークフローを変更した場合は再デプロイしてください。
|
||||
- 子ワークフローが失敗した場合、下流で処理しない限り、ブロックはエラーを発生させます。
|
||||
|
||||
<Callout>
|
||||
子ワークフローは焦点を絞ったものにしましょう。小さく再利用可能なフローを作ることで、深いネストを作らずに組み合わせやすくなります。
|
||||
子ワークフローは焦点を絞ったものにしましょう。小さく再利用可能なフローは、深いネストを作成せずに組み合わせやすくなります。
|
||||
</Callout>
|
||||
|
||||
@@ -10,6 +10,20 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[MongoDB](https://www.mongodb.com/)ツールを使用すると、MongoDBデータベースに接続し、エージェントワークフロー内で直接ドキュメント指向の幅広い操作を実行できます。柔軟な構成と安全な接続管理により、データの操作や操作が簡単に行えます。
|
||||
|
||||
MongoDBツールでは、以下のことができます:
|
||||
|
||||
- **ドキュメントの検索**: `mongodb_query`操作を使用して、リッチなクエリフィルターでコレクションに問い合わせ、ドキュメントを取得します。
|
||||
- **ドキュメントの挿入**: `mongodb_insert`操作を使用して、1つまたは複数のドキュメントをコレクションに追加します。
|
||||
- **ドキュメントの更新**: `mongodb_update`操作を使用して、フィルター条件と更新アクションを指定して既存のドキュメントを変更します。
|
||||
- **ドキュメントの削除**: `mongodb_delete`操作を使用して、フィルターと削除オプションを指定してコレクションからドキュメントを削除します。
|
||||
- **データの集計**: `mongodb_execute`操作を使用して複雑な集計パイプラインを実行し、データを変換および分析します。
|
||||
|
||||
MongoDBツールは、エージェントが構造化されたドキュメントベースのデータを管理または分析する必要があるワークフローに最適です。ユーザー生成コンテンツの処理、アプリデータの管理、分析の強化など、MongoDBツールはデータアクセスと操作を安全でプログラム的な方法で効率化します。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用方法
|
||||
|
||||
MongoDBをワークフローに統合します。データの検索、挿入、更新、削除、集計が可能です。
|
||||
@@ -18,47 +32,47 @@ MongoDBをワークフローに統合します。データの検索、挿入、
|
||||
|
||||
### `mongodb_query`
|
||||
|
||||
MongoDB コレクションに対して検索操作を実行
|
||||
MongoDBコレクションで検索操作を実行する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `host` | string | はい | MongoDBサーバーのホスト名またはIPアドレス |
|
||||
| `port` | number | はい | MongoDBサーバーのポート(デフォルト: 27017) |
|
||||
| `port` | number | はい | MongoDBサーバーのポート(デフォルト:27017) |
|
||||
| `database` | string | はい | 接続先のデータベース名 |
|
||||
| `username` | string | いいえ | MongoDBのユーザー名 |
|
||||
| `password` | string | いいえ | MongoDBのパスワード |
|
||||
| `username` | string | いいえ | MongoDBユーザー名 |
|
||||
| `password` | string | いいえ | MongoDBパスワード |
|
||||
| `authSource` | string | いいえ | 認証データベース |
|
||||
| `ssl` | string | いいえ | SSL接続モード(disabled, required, preferred) |
|
||||
| `ssl` | string | いいえ | SSL接続モード(disabled、required、preferred) |
|
||||
| `collection` | string | はい | クエリを実行するコレクション名 |
|
||||
| `query` | string | いいえ | JSON文字列形式のMongoDBクエリフィルター |
|
||||
| `query` | string | いいえ | JSON文字列としてのMongoDBクエリフィルター |
|
||||
| `limit` | number | いいえ | 返すドキュメントの最大数 |
|
||||
| `sort` | string | いいえ | JSON文字列形式のソート条件 |
|
||||
| `sort` | string | いいえ | JSON文字列としてのソート条件 |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作のステータスメッセージ |
|
||||
| `message` | string | 操作ステータスメッセージ |
|
||||
| `documents` | array | クエリから返されたドキュメントの配列 |
|
||||
| `documentCount` | number | 返されたドキュメントの数 |
|
||||
| `documentCount` | number | 返されたドキュメント数 |
|
||||
|
||||
### `mongodb_insert`
|
||||
|
||||
MongoDBコレクションにドキュメントを挿入
|
||||
MongoDBコレクションにドキュメントを挿入する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `host` | string | はい | MongoDBサーバーのホスト名またはIPアドレス |
|
||||
| `port` | number | はい | MongoDBサーバーのポート(デフォルト: 27017) |
|
||||
| `port` | number | はい | MongoDBサーバーのポート(デフォルト:27017) |
|
||||
| `database` | string | はい | 接続先のデータベース名 |
|
||||
| `username` | string | いいえ | MongoDBのユーザー名 |
|
||||
| `password` | string | いいえ | MongoDBのパスワード |
|
||||
| `username` | string | いいえ | MongoDBユーザー名 |
|
||||
| `password` | string | いいえ | MongoDBパスワード |
|
||||
| `authSource` | string | いいえ | 認証データベース |
|
||||
| `ssl` | string | いいえ | SSL接続モード(disabled, required, preferred) |
|
||||
| `ssl` | string | いいえ | SSL接続モード(disabled、required、preferred) |
|
||||
| `collection` | string | はい | 挿入先のコレクション名 |
|
||||
| `documents` | array | はい | 挿入するドキュメントの配列 |
|
||||
|
||||
@@ -117,8 +131,8 @@ MongoDBコレクションからドキュメントを削除する
|
||||
| `password` | string | いいえ | MongoDBパスワード |
|
||||
| `authSource` | string | いいえ | 認証データベース |
|
||||
| `ssl` | string | いいえ | SSL接続モード(disabled、required、preferred) |
|
||||
| `collection` | string | はい | 削除対象のコレクション名 |
|
||||
| `filter` | string | はい | フィルター条件(JSON文字列) |
|
||||
| `collection` | string | はい | 削除元のコレクション名 |
|
||||
| `filter` | string | はい | JSON文字列としてのフィルター条件 |
|
||||
| `multi` | boolean | いいえ | 複数のドキュメントを削除する |
|
||||
|
||||
#### 出力
|
||||
@@ -138,14 +152,14 @@ MongoDB集計パイプラインを実行する
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `host` | string | はい | MongoDBサーバーのホスト名またはIPアドレス |
|
||||
| `port` | number | はい | MongoDBサーバーのポート(デフォルト:27017) |
|
||||
| `port` | number | はい | MongoDBサーバーのポート(デフォルト: 27017) |
|
||||
| `database` | string | はい | 接続先のデータベース名 |
|
||||
| `username` | string | いいえ | MongoDBユーザー名 |
|
||||
| `password` | string | いいえ | MongoDBパスワード |
|
||||
| `username` | string | いいえ | MongoDBのユーザー名 |
|
||||
| `password` | string | いいえ | MongoDBのパスワード |
|
||||
| `authSource` | string | いいえ | 認証データベース |
|
||||
| `ssl` | string | いいえ | SSL接続モード(disabled、required、preferred) |
|
||||
| `collection` | string | はい | パイプラインを実行するコレクション名 |
|
||||
| `pipeline` | string | はい | 集計パイプライン(JSON文字列) |
|
||||
| `pipeline` | string | はい | JSON文字列としての集計パイプライン |
|
||||
|
||||
#### 出力
|
||||
|
||||
@@ -153,9 +167,9 @@ MongoDB集計パイプラインを実行する
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作ステータスメッセージ |
|
||||
| `documents` | array | 集計から返されたドキュメントの配列 |
|
||||
| `documentCount` | number | 返されたドキュメントの数 |
|
||||
| `documentCount` | number | 返されたドキュメント数 |
|
||||
|
||||
## 注意事項
|
||||
|
||||
- カテゴリー: `tools`
|
||||
- カテゴリ: `tools`
|
||||
- タイプ: `mongodb`
|
||||
|
||||
@@ -10,9 +10,23 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Salesforce](https://www.salesforce.com/)ツールを使用すると、SalesforceのCRMに直接接続し、エージェントワークフロー内で幅広い顧客関係管理操作を実行できます。シームレスで安全な統合により、営業、サポート、マーケティングデータ全体の主要なビジネスプロセスに効率的にアクセスし、自動化することができます。
|
||||
|
||||
Salesforceツールでは、以下のことが可能です:
|
||||
|
||||
- **アカウントの取得**: `salesforce_get_accounts`操作を使用して、カスタムフィルター、ソート、フィールド選択でSalesforceからアカウントを取得します。
|
||||
- **アカウントの作成**: `salesforce_create_account`操作を使用して、名前、業種、請求先住所などの詳細を指定して、新しいアカウントをSalesforceに自動的に追加します。
|
||||
- **連絡先の管理**: (提供されている場合、連絡先の追加、更新、または取得に利用できる同様のツール)
|
||||
- **リードと商談の管理**: リードと商談の管理をワークフローに統合し、エージェントが販売パイプラインデータをキャプチャ、評価、更新できるようにします。
|
||||
- **ケースとタスクの追跡**: Salesforce内のケースとタスクを操作することで、カスタマーサポートとフォローアップ活動を自動化します。
|
||||
|
||||
Salesforceツールは、エージェントが販売、アカウント管理、リード生成、サポート業務を効率化する必要があるワークフローに最適です。エージェントがプラットフォーム間でデータを同期する場合でも、リアルタイムの顧客インサイトを提供する場合でも、定期的なCRM更新を自動化する場合でも、Salesforceツールは、プログラム的なエージェント駆動プロセスにSalesforceの完全なパワーと拡張性をもたらします。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用方法
|
||||
|
||||
Salesforceをワークフローに統合します。アカウント、連絡先、リード、商談、ケース、タスクを強力な自動化機能で管理できます。
|
||||
Salesforceをワークフローに統合します。強力な自動化機能でアカウント、連絡先、リード、商談、ケース、タスクを管理します。
|
||||
|
||||
## ツール
|
||||
|
||||
@@ -34,7 +48,7 @@ Salesforce CRMからアカウントを取得する
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 操作の成功ステータス |
|
||||
| `success` | boolean | 操作成功ステータス |
|
||||
| `output` | object | アカウントデータ |
|
||||
|
||||
### `salesforce_create_account`
|
||||
@@ -89,7 +103,7 @@ Salesforce CRMの既存アカウントを更新する
|
||||
| `billingState` | string | いいえ | 請求先都道府県 |
|
||||
| `billingPostalCode` | string | いいえ | 請求先郵便番号 |
|
||||
| `billingCountry` | string | いいえ | 請求先国 |
|
||||
| `description` | string | いいえ | アカウント説明 |
|
||||
| `description` | string | いいえ | アカウントの説明 |
|
||||
| `annualRevenue` | string | いいえ | 年間売上(数値) |
|
||||
| `numberOfEmployees` | string | いいえ | 従業員数(数値) |
|
||||
|
||||
|
||||
@@ -10,29 +10,47 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#635BFF"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Stripe](https://stripe.com/)は、支払い、顧客、サブスクリプション、請求書、商品などを簡単に管理できる強力な決済プラットフォームです。
|
||||
|
||||
StripeをSimに統合することで、エージェントは以下のことができます:
|
||||
|
||||
- **決済インテントの作成と管理**: 柔軟な設定オプションで支払いを処理。
|
||||
- **顧客との連携**: ビジネスのための顧客記録の作成、取得、更新。
|
||||
- **サブスクリプションの処理**: 定期請求とサブスクリプションのライフサイクル管理。
|
||||
- **請求書の作成と送信**: 一回限りまたは定期的な支払いのための請求書生成。
|
||||
- **課金の追跡と管理**: 支払いを監視するための課金オブジェクトの取得と更新。
|
||||
- **商品と価格の設定**: 商品カタログ、価格モデル、オファーの設定。
|
||||
- **Stripeイベントの監視と対応**: 支払い更新、成功した課金、その他のStripeイベントに対応するワークフローのトリガー。
|
||||
|
||||
SimとStripeを接続することで、エージェントワークフロー内でのシームレスな自動化と財務オペレーションが可能になります。顧客のオンボーディング、サブスクリプション管理、支払い回収、請求書生成、さらには支払いイベント発生時のカスタムアクションなど、すべてをエージェントが直接Stripeを通じて安全に処理します。
|
||||
|
||||
eコマース自動化、サブスクリプションサービスの構築、レポーティングや照合の実行など、Stripeツールを使えば、インテリジェントなSimワークフロー内で支払いと財務データの連携が簡単に行えます。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用方法
|
||||
|
||||
ワークフローにStripeを統合します。決済意図、顧客、サブスクリプション、請求書、課金、商品、価格、イベントを管理できます。Stripeイベントが発生したときにワークフローをトリガーするトリガーモードでも使用できます。
|
||||
ワークフローにStripeを統合します。決済インテント、顧客、サブスクリプション、請求書、課金、商品、価格、イベントを管理します。Stripeイベントが発生したときにワークフローをトリガーするトリガーモードでも使用できます。
|
||||
|
||||
## ツール
|
||||
|
||||
### `stripe_create_payment_intent`
|
||||
|
||||
支払いを処理するための新しいPayment Intentを作成する
|
||||
支払いを処理するための新しい決済インテントを作成
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `amount` | number | はい | セント単位の金額(例:$20.00の場合は2000) |
|
||||
| `amount` | number | はい | 金額(セント単位)(例:2000は$20.00) |
|
||||
| `currency` | string | はい | 3文字のISO通貨コード(例:usd、eur) |
|
||||
| `customer` | string | いいえ | この支払いに関連付ける顧客ID |
|
||||
| `payment_method` | string | いいえ | 支払い方法ID |
|
||||
| `description` | string | いいえ | 支払いの説明 |
|
||||
| `receipt_email` | string | いいえ | 領収書を送信するメールアドレス |
|
||||
| `metadata` | json | いいえ | 追加情報を保存するためのキーと値のペアのセット |
|
||||
| `automatic_payment_methods` | json | いいえ | 自動支払い方法を有効にする(例:\{"enabled": true\}) |
|
||||
| `automatic_payment_methods` | json | いいえ | 自動支払い方法を有効にする(例:`{"enabled": true}`) |
|
||||
|
||||
#### 出力
|
||||
|
||||
@@ -56,8 +74,8 @@ IDで既存のPayment Intentを取得する
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `payment_intent` | json | 取得したPayment Intentオブジェクト |
|
||||
| `metadata` | json | Payment Intentのメタデータ(ID、ステータス、金額、通貨を含む) |
|
||||
| `payment_intent` | json | 取得されたPayment Intentオブジェクト |
|
||||
| `metadata` | json | ID、ステータス、金額、通貨を含むPayment Intentのメタデータ |
|
||||
|
||||
### `stripe_update_payment_intent`
|
||||
|
||||
@@ -80,11 +98,11 @@ IDで既存のPayment Intentを取得する
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `payment_intent` | json | 更新されたPayment Intentオブジェクト |
|
||||
| `metadata` | json | Payment Intentのメタデータ(ID、ステータス、金額、通貨を含む) |
|
||||
| `metadata` | json | ID、ステータス、金額、通貨を含むPayment Intentのメタデータ |
|
||||
|
||||
### `stripe_confirm_payment_intent`
|
||||
|
||||
決済を完了するためにPayment Intentを確定する
|
||||
決済を完了するためにPayment Intentを確認する
|
||||
|
||||
#### 入力
|
||||
|
||||
@@ -92,13 +110,13 @@ IDで既存のPayment Intentを取得する
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `id` | string | はい | Payment Intent ID(例:pi_1234567890) |
|
||||
| `payment_method` | string | いいえ | 確定に使用する決済方法ID |
|
||||
| `payment_method` | string | いいえ | 確認に使用する決済方法ID |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `payment_intent` | json | 確認済みのPayment Intentオブジェクト |
|
||||
| `payment_intent` | json | 確認されたPayment Intentオブジェクト |
|
||||
| `metadata` | json | ID、ステータス、金額、通貨を含むPayment Intentのメタデータ |
|
||||
|
||||
### `stripe_capture_payment_intent`
|
||||
@@ -141,7 +159,7 @@ Payment Intentをキャンセルする
|
||||
|
||||
### `stripe_list_payment_intents`
|
||||
|
||||
すべての決済インテントを一覧表示
|
||||
すべてのPayment Intentを一覧表示する
|
||||
|
||||
#### 入力
|
||||
|
||||
@@ -150,37 +168,37 @@ Payment Intentをキャンセルする
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `limit` | number | いいえ | 返す結果の数(デフォルト10、最大100) |
|
||||
| `customer` | string | いいえ | 顧客IDでフィルタリング |
|
||||
| `created` | json | いいえ | 作成日でフィルタリング(例:\{"gt": 1633024800\}) |
|
||||
| `created` | json | いいえ | 作成日でフィルタリング(例:`{"gt": 1633024800}`) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `payment_intents` | json | 決済インテントオブジェクトの配列 |
|
||||
| `metadata` | json | 数とhas_moreを含むリストメタデータ |
|
||||
| `payment_intents` | json | Payment Intentオブジェクトの配列 |
|
||||
| `metadata` | json | カウントとhas_moreを含むリストメタデータ |
|
||||
|
||||
### `stripe_search_payment_intents`
|
||||
|
||||
クエリ構文を使用して決済インテントを検索
|
||||
クエリ構文を使用してPayment Intentを検索する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `query` | string | はい | 検索クエリ(例:\"status:'succeeded' AND currency:'usd'\") |
|
||||
| `query` | string | はい | 検索クエリ(例:"status:'succeeded' AND currency:'usd'") |
|
||||
| `limit` | number | いいえ | 返す結果の数(デフォルト10、最大100) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `payment_intents` | json | 一致する決済インテントオブジェクトの配列 |
|
||||
| `metadata` | json | 数とhas_moreを含む検索メタデータ |
|
||||
| `payment_intents` | json | 一致するPayment Intentオブジェクトの配列 |
|
||||
| `metadata` | json | カウントとhas_moreを含む検索メタデータ |
|
||||
|
||||
### `stripe_create_customer`
|
||||
|
||||
新しい顧客オブジェクトを作成
|
||||
新しい顧客オブジェクトを作成する
|
||||
|
||||
#### 入力
|
||||
|
||||
@@ -193,7 +211,7 @@ Payment Intentをキャンセルする
|
||||
| `description` | string | いいえ | 顧客の説明 |
|
||||
| `address` | json | いいえ | 顧客の住所オブジェクト |
|
||||
| `metadata` | json | いいえ | キーと値のペアのセット |
|
||||
| `payment_method` | string | いいえ | 添付する決済方法ID |
|
||||
| `payment_method` | string | いいえ | 添付する支払い方法ID |
|
||||
|
||||
#### 出力
|
||||
|
||||
@@ -265,7 +283,7 @@ IDで既存の顧客を取得する
|
||||
|
||||
### `stripe_list_customers`
|
||||
|
||||
すべての顧客を一覧表示する
|
||||
すべての顧客をリスト表示する
|
||||
|
||||
#### 入力
|
||||
|
||||
@@ -311,11 +329,11 @@ IDで既存の顧客を取得する
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `customer` | string | はい | サブスクライブする顧客ID |
|
||||
| `items` | json | はい | 価格IDを含むアイテムの配列(例:\[\{"price": "price_xxx", "quantity": 1\}\]) |
|
||||
| `customer` | string | はい | サブスクリプションを作成する顧客ID |
|
||||
| `items` | json | はい | 価格IDを含むアイテムの配列(例:`[{"price": "price_xxx", "quantity": 1}]`) |
|
||||
| `trial_period_days` | number | いいえ | トライアル日数 |
|
||||
| `default_payment_method` | string | いいえ | 支払い方法ID |
|
||||
| `cancel_at_period_end` | boolean | いいえ | 期間終了時にサブスクリプションをキャンセルする |
|
||||
| `cancel_at_period_end` | boolean | いいえ | 期間終了時にサブスクリプションをキャンセルするかどうか |
|
||||
| `metadata` | json | いいえ | 追加情報を保存するためのキーと値のペアのセット |
|
||||
|
||||
#### 出力
|
||||
@@ -340,7 +358,7 @@ IDで既存のサブスクリプションを取得する
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `subscription` | json | 取得したサブスクリプションオブジェクト |
|
||||
| `subscription` | json | 取得されたサブスクリプションオブジェクト |
|
||||
| `metadata` | json | ID、ステータス、顧客を含むサブスクリプションメタデータ |
|
||||
|
||||
### `stripe_update_subscription`
|
||||
@@ -353,7 +371,7 @@ IDで既存のサブスクリプションを取得する
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `id` | string | はい | サブスクリプションID(例:sub_1234567890) |
|
||||
| `items` | json | いいえ | 価格IDを含む更新されたアイテムの配列 |
|
||||
| `items` | json | いいえ | 価格IDを含む更新された項目の配列 |
|
||||
| `cancel_at_period_end` | boolean | いいえ | 期間終了時にサブスクリプションをキャンセルするかどうか |
|
||||
| `metadata` | json | いいえ | 更新されたメタデータ |
|
||||
|
||||
@@ -374,7 +392,7 @@ IDで既存のサブスクリプションを取得する
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `id` | string | はい | サブスクリプションID(例:sub_1234567890) |
|
||||
| `prorate` | boolean | いいえ | キャンセルを按分するかどうか |
|
||||
| `prorate` | boolean | いいえ | キャンセルを日割り計算するかどうか |
|
||||
| `invoice_now` | boolean | いいえ | すぐに請求書を発行するかどうか |
|
||||
|
||||
#### 出力
|
||||
@@ -454,15 +472,15 @@ IDで既存のサブスクリプションを取得する
|
||||
| `customer` | string | はい | 顧客ID(例:cus_1234567890) |
|
||||
| `description` | string | いいえ | 請求書の説明 |
|
||||
| `metadata` | json | いいえ | キーと値のペアのセット |
|
||||
| `auto_advance` | boolean | いいえ | 請求書を自動確定する |
|
||||
| `collection_method` | string | いいえ | 回収方法:charge_automaticallyまたはsend_invoice |
|
||||
| `auto_advance` | boolean | いいえ | 請求書を自動的に確定するかどうか |
|
||||
| `collection_method` | string | いいえ | 回収方法:charge_automatically または send_invoice |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `invoice` | json | 作成された請求書オブジェクト |
|
||||
| `metadata` | json | 請求書メタデータ |
|
||||
| `metadata` | json | 請求書のメタデータ |
|
||||
|
||||
### `stripe_retrieve_invoice`
|
||||
|
||||
@@ -501,7 +519,7 @@ IDで既存の請求書を取得する
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `invoice` | json | 更新された請求書オブジェクト |
|
||||
| `metadata` | json | 請求書のメタデータ |
|
||||
| `metadata` | json | 請求書メタデータ |
|
||||
|
||||
### `stripe_delete_invoice`
|
||||
|
||||
@@ -520,11 +538,11 @@ IDで既存の請求書を取得する
|
||||
| --------- | ---- | ----------- |
|
||||
| `deleted` | boolean | 請求書が削除されたかどうか |
|
||||
| `id` | string | 削除された請求書のID |
|
||||
| `metadata` | json | 削除のメタデータ |
|
||||
| `metadata` | json | 削除メタデータ |
|
||||
|
||||
### `stripe_finalize_invoice`
|
||||
|
||||
下書き請求書を確定する
|
||||
ドラフト請求書を確定する
|
||||
|
||||
#### 入力
|
||||
|
||||
@@ -532,14 +550,14 @@ IDで既存の請求書を取得する
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `id` | string | はい | 請求書ID(例:in_1234567890) |
|
||||
| `auto_advance` | boolean | いいえ | 請求書を自動進行する |
|
||||
| `auto_advance` | boolean | いいえ | 請求書を自動的に進める |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `invoice` | json | 確定された請求書オブジェクト |
|
||||
| `metadata` | json | 請求書のメタデータ |
|
||||
| `metadata` | json | 請求書メタデータ |
|
||||
|
||||
### `stripe_pay_invoice`
|
||||
|
||||
@@ -551,14 +569,14 @@ IDで既存の請求書を取得する
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `id` | string | はい | 請求書ID(例:in_1234567890) |
|
||||
| `paid_out_of_band` | boolean | いいえ | 外部で支払われたとして請求書にマークする |
|
||||
| `paid_out_of_band` | boolean | いいえ | 請求書をオフラインで支払い済みとしてマークする |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `invoice` | json | 支払われた請求書オブジェクト |
|
||||
| `metadata` | json | 請求書のメタデータ |
|
||||
| `invoice` | json | 支払い済みの請求書オブジェクト |
|
||||
| `metadata` | json | 請求書メタデータ |
|
||||
|
||||
### `stripe_void_invoice`
|
||||
|
||||
@@ -575,12 +593,12 @@ IDで既存の請求書を取得する
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `invoice` | json | 無効にされた請求書オブジェクト |
|
||||
| `metadata` | json | 請求書のメタデータ |
|
||||
| `invoice` | json | 無効化された請求書オブジェクト |
|
||||
| `metadata` | json | 請求書メタデータ |
|
||||
|
||||
### `stripe_send_invoice`
|
||||
|
||||
請求書を顧客に送信する
|
||||
顧客に請求書を送信する
|
||||
|
||||
#### 入力
|
||||
|
||||
@@ -594,7 +612,7 @@ IDで既存の請求書を取得する
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `invoice` | json | 送信された請求書オブジェクト |
|
||||
| `metadata` | json | 請求書のメタデータ |
|
||||
| `metadata` | json | 請求書メタデータ |
|
||||
|
||||
### `stripe_list_invoices`
|
||||
|
||||
@@ -614,7 +632,7 @@ IDで既存の請求書を取得する
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `invoices` | json | 請求書オブジェクトの配列 |
|
||||
| `metadata` | json | リストのメタデータ |
|
||||
| `metadata` | json | リストメタデータ |
|
||||
|
||||
### `stripe_search_invoices`
|
||||
|
||||
@@ -637,49 +655,31 @@ IDで既存の請求書を取得する
|
||||
|
||||
### `stripe_create_charge`
|
||||
|
||||
支払いを処理するための新しい請求を作成する
|
||||
決済処理のための新しいチャージを作成する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `amount` | number | はい | セント単位の金額(例:$20.00の場合は2000) |
|
||||
| `amount` | number | はい | セント単位の金額(例:2000は$20.00) |
|
||||
| `currency` | string | はい | 3文字のISO通貨コード(例:usd、eur) |
|
||||
| `customer` | string | いいえ | この請求に関連付ける顧客ID |
|
||||
| `customer` | string | いいえ | このチャージに関連付ける顧客ID |
|
||||
| `source` | string | いいえ | 支払いソースID(例:カードトークンまたは保存されたカードID) |
|
||||
| `description` | string | いいえ | 請求の説明 |
|
||||
| `description` | string | いいえ | チャージの説明 |
|
||||
| `metadata` | json | いいえ | 追加情報を保存するためのキーと値のペアのセット |
|
||||
| `capture` | boolean | いいえ | 請求を即時に確定するかどうか(デフォルトはtrue) |
|
||||
| `capture` | boolean | いいえ | チャージをすぐにキャプチャするかどうか(デフォルトはtrue) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charge` | json | 作成された請求オブジェクト |
|
||||
| `metadata` | json | ID、ステータス、金額、通貨、支払い状況を含む請求メタデータ |
|
||||
| `charge` | json | 作成されたチャージオブジェクト |
|
||||
| `metadata` | json | ID、ステータス、金額、通貨、支払い状況を含むチャージメタデータ |
|
||||
|
||||
### `stripe_retrieve_charge`
|
||||
|
||||
IDで既存の請求を取得する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `id` | string | はい | 請求ID(例:ch_1234567890) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charge` | json | 取得された請求オブジェクト |
|
||||
| `metadata` | json | ID、ステータス、金額、通貨、支払い状況を含む請求メタデータ |
|
||||
|
||||
### `stripe_update_charge`
|
||||
|
||||
既存のチャージを更新する
|
||||
IDで既存のチャージを取得する
|
||||
|
||||
#### 入力
|
||||
|
||||
@@ -687,6 +687,24 @@ IDで既存の請求を取得する
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `id` | string | はい | チャージID(例:ch_1234567890) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charge` | json | 取得された課金オブジェクト |
|
||||
| `metadata` | json | ID、ステータス、金額、通貨、支払い状況を含む課金メタデータ |
|
||||
|
||||
### `stripe_update_charge`
|
||||
|
||||
既存の課金を更新する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `id` | string | はい | 課金ID(例:ch_1234567890) |
|
||||
| `description` | string | いいえ | 更新された説明 |
|
||||
| `metadata` | json | いいえ | 更新されたメタデータ |
|
||||
|
||||
@@ -694,31 +712,31 @@ IDで既存の請求を取得する
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charge` | json | 更新されたチャージオブジェクト |
|
||||
| `metadata` | json | ID、ステータス、金額、通貨、支払い状況を含むチャージメタデータ |
|
||||
| `charge` | json | 更新された課金オブジェクト |
|
||||
| `metadata` | json | ID、ステータス、金額、通貨、支払い状況を含む課金メタデータ |
|
||||
|
||||
### `stripe_capture_charge`
|
||||
|
||||
未キャプチャのチャージをキャプチャする
|
||||
未キャプチャの課金をキャプチャする
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `id` | string | はい | チャージID(例:ch_1234567890) |
|
||||
| `amount` | number | いいえ | キャプチャする金額(セント単位、デフォルトは全額) |
|
||||
| `id` | string | はい | 課金ID(例:ch_1234567890) |
|
||||
| `amount` | number | いいえ | キャプチャする金額(セント単位)(デフォルトは全額) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charge` | json | キャプチャされたチャージオブジェクト |
|
||||
| `metadata` | json | ID、ステータス、金額、通貨、支払い状況を含むチャージメタデータ |
|
||||
| `charge` | json | キャプチャされた課金オブジェクト |
|
||||
| `metadata` | json | ID、ステータス、金額、通貨、支払い状況を含む課金メタデータ |
|
||||
|
||||
### `stripe_list_charges`
|
||||
|
||||
すべてのチャージを一覧表示する
|
||||
すべての請求を一覧表示する
|
||||
|
||||
#### 入力
|
||||
|
||||
@@ -727,18 +745,18 @@ IDで既存の請求を取得する
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `limit` | number | いいえ | 返す結果の数(デフォルト10、最大100) |
|
||||
| `customer` | string | いいえ | 顧客IDでフィルタリング |
|
||||
| `created` | json | いいえ | 作成日でフィルタリング(例:\{"gt": 1633024800\}) |
|
||||
| `created` | json | いいえ | 作成日でフィルタリング(例:`{"gt": 1633024800}`) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charges` | json | 課金オブジェクトの配列 |
|
||||
| `metadata` | json | カウントやhas_moreを含むメタデータリスト |
|
||||
| `charges` | json | チャージオブジェクトの配列 |
|
||||
| `metadata` | json | 数とhas_moreを含むリストメタデータ |
|
||||
|
||||
### `stripe_search_charges`
|
||||
|
||||
クエリ構文を使用して課金を検索する
|
||||
クエリ構文を使用して請求を検索する
|
||||
|
||||
#### 入力
|
||||
|
||||
@@ -752,22 +770,22 @@ IDで既存の請求を取得する
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charges` | json | 一致する課金オブジェクトの配列 |
|
||||
| `metadata` | json | カウントやhas_moreを含む検索メタデータ |
|
||||
| `charges` | json | 一致するチャージオブジェクトの配列 |
|
||||
| `metadata` | json | 数とhas_moreを含む検索メタデータ |
|
||||
|
||||
### `stripe_create_product`
|
||||
|
||||
新しい製品オブジェクトを作成する
|
||||
新しい商品オブジェクトを作成する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `name` | string | はい | 製品名 |
|
||||
| `description` | string | いいえ | 製品説明 |
|
||||
| `active` | boolean | いいえ | 製品がアクティブかどうか |
|
||||
| `images` | json | いいえ | 製品の画像URLの配列 |
|
||||
| `name` | string | はい | 商品名 |
|
||||
| `description` | string | いいえ | 商品の説明 |
|
||||
| `active` | boolean | いいえ | 商品がアクティブかどうか |
|
||||
| `images` | json | いいえ | 商品の画像URLの配列 |
|
||||
| `metadata` | json | いいえ | キーと値のペアのセット |
|
||||
|
||||
#### 出力
|
||||
@@ -872,21 +890,21 @@ IDで既存の商品を取得する
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `products` | json | 一致する製品オブジェクトの配列 |
|
||||
| `products` | json | 一致する商品オブジェクトの配列 |
|
||||
| `metadata` | json | 検索メタデータ |
|
||||
|
||||
### `stripe_create_price`
|
||||
|
||||
製品の新しい価格を作成する
|
||||
商品の新しい価格を作成する
|
||||
|
||||
#### 入力
|
||||
|
||||
| パラメータ | 型 | 必須 | 説明 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `product` | string | はい | 製品ID(例:prod_1234567890) |
|
||||
| `product` | string | はい | 商品ID(例:prod_1234567890) |
|
||||
| `currency` | string | はい | 3文字のISO通貨コード(例:usd、eur) |
|
||||
| `unit_amount` | number | いいえ | セント単位の金額(例:$10.00の場合は1000) |
|
||||
| `unit_amount` | number | いいえ | 金額(セント単位、例:1000は$10.00) |
|
||||
| `recurring` | json | いいえ | 定期請求の設定(間隔:日/週/月/年) |
|
||||
| `metadata` | json | いいえ | キーと値のペアのセット |
|
||||
| `billing_scheme` | string | いいえ | 請求スキーム(per_unitまたはtiered) |
|
||||
@@ -946,8 +964,8 @@ IDで既存の価格を取得する
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `limit` | number | いいえ | 返す結果の数(デフォルト10、最大100) |
|
||||
| `product` | string | いいえ | 製品IDでフィルタリング |
|
||||
| `active` | boolean | いいえ | アクティブステータスでフィルタリング |
|
||||
| `product` | string | いいえ | 商品IDでフィルタリング |
|
||||
| `active` | boolean | いいえ | アクティブ状態でフィルタリング |
|
||||
|
||||
#### 出力
|
||||
|
||||
@@ -990,7 +1008,7 @@ IDで既存のイベントを取得する
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `event` | json | 取得したイベントオブジェクト |
|
||||
| `event` | json | 取得されたイベントオブジェクト |
|
||||
| `metadata` | json | ID、タイプ、作成タイムスタンプを含むイベントメタデータ |
|
||||
|
||||
### `stripe_list_events`
|
||||
@@ -1004,14 +1022,14 @@ IDで既存のイベントを取得する
|
||||
| `apiKey` | string | はい | Stripe APIキー(シークレットキー) |
|
||||
| `limit` | number | いいえ | 返す結果の数(デフォルト10、最大100) |
|
||||
| `type` | string | いいえ | イベントタイプでフィルタリング(例:payment_intent.created) |
|
||||
| `created` | json | いいえ | 作成日でフィルタリング(例:\{"gt": 1633024800\}) |
|
||||
| `created` | json | いいえ | 作成日でフィルタリング(例:`{"gt": 1633024800}`) |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `events` | json | イベントオブジェクトの配列 |
|
||||
| `metadata` | json | 数とhas_moreを含むリストメタデータ |
|
||||
| `metadata` | json | カウントとhas_moreを含むリストメタデータ |
|
||||
|
||||
## 注意事項
|
||||
|
||||
|
||||
@@ -10,9 +10,24 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#0052CC"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Trello](https://trello.com)は、ボード、リスト、カードを使用してプロジェクト、タスク、ワークフローを整理するのに役立つビジュアルコラボレーションツールです。
|
||||
|
||||
SimでTrelloを使用すると、以下のことができます:
|
||||
|
||||
- **ボードとリストの一覧表示**:アクセス権のあるボードとそれに関連するリストを表示します。
|
||||
- **カードの一覧表示と検索**:ボード上のすべてのカードを取得したり、リストでフィルタリングしてコンテンツとステータスを確認したりできます。
|
||||
- **カードの作成**:説明、ラベル、期限日を含む新しいカードをTrelloリストに追加します。
|
||||
- **カードの更新と移動**:カードのプロパティを編集し、リスト間でカードを移動し、期限日やラベルを設定します。
|
||||
- **最近のアクティビティの取得**:ボードやカードのアクションと活動履歴を取得します。
|
||||
- **カードへのコメント**:コラボレーションと追跡のためにカードにコメントを追加します。
|
||||
|
||||
TrelloをSimと統合することで、エージェントがチームのタスク、ボード、プロジェクトをプログラムで管理できるようになります。プロジェクト管理ワークフローの自動化、タスクリストの最新化、他のツールとの同期、またはTrelloイベントに応じたインテリジェントワークフローのトリガー—すべてをAIエージェントを通じて行うことができます。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用方法
|
||||
|
||||
Trelloと連携してボードとカードを管理します。ボードの一覧表示、カードの一覧表示、カードの作成、カードの更新、アクションの取得、コメントの追加が可能です。
|
||||
Trelloと統合してボードとカードを管理します。ボードの一覧表示、カードの一覧表示、カードの作成、カードの更新、アクションの取得、コメントの追加ができます。
|
||||
|
||||
## ツール
|
||||
|
||||
@@ -69,14 +84,14 @@ Trelloボードに新しいカードを作成する
|
||||
| `desc` | string | いいえ | カードの説明 |
|
||||
| `pos` | string | いいえ | カードの位置(top、bottom、または正の浮動小数点数) |
|
||||
| `due` | string | いいえ | 期限日(ISO 8601形式) |
|
||||
| `labels` | string | いいえ | ラベルIDのカンマ区切りリスト |
|
||||
| `labels` | string | いいえ | カンマ区切りのラベルIDリスト |
|
||||
|
||||
#### 出力
|
||||
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | カードが正常に作成されたかどうか |
|
||||
| `card` | object | 作成されたカードオブジェクト(id、name、desc、urlなどのプロパティを含む) |
|
||||
| `card` | object | 作成されたカードオブジェクト(id、name、desc、url、その他のプロパティを含む) |
|
||||
| `error` | string | 操作が失敗した場合のエラーメッセージ |
|
||||
|
||||
### `trello_update_card`
|
||||
@@ -100,7 +115,7 @@ Trelloの既存のカードを更新する
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | カードが正常に更新されたかどうか |
|
||||
| `card` | object | id、name、desc、urlなどのプロパティを含む更新されたカードオブジェクト |
|
||||
| `card` | object | 更新されたカードオブジェクト(id、name、desc、url、その他のプロパティを含む) |
|
||||
| `error` | string | 操作が失敗した場合のエラーメッセージ |
|
||||
|
||||
### `trello_get_actions`
|
||||
@@ -113,7 +128,7 @@ Trelloの既存のカードを更新する
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `boardId` | string | いいえ | アクションを取得するボードのID(boardIdまたはcardIdのいずれかが必要) |
|
||||
| `cardId` | string | いいえ | アクションを取得するカードのID(boardIdまたはcardIdのいずれかが必要) |
|
||||
| `filter` | string | いいえ | タイプでアクションをフィルタリング(例:"commentCard,updateCard,createCard"または"all") |
|
||||
| `filter` | string | いいえ | タイプでアクションをフィルタリング(例:「commentCard,updateCard,createCard」または「all」) |
|
||||
| `limit` | number | いいえ | 返すアクションの最大数(デフォルト:50、最大:1000) |
|
||||
|
||||
#### 出力
|
||||
@@ -141,7 +156,7 @@ Trelloカードにコメントを追加する
|
||||
| パラメータ | 型 | 説明 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | コメントが正常に追加されたかどうか |
|
||||
| `comment` | object | 作成されたコメントオブジェクト(id、テキスト、日付、作成者メンバーを含む) |
|
||||
| `comment` | object | ID、テキスト、日付、作成者メンバーを含む作成されたコメントオブジェクト |
|
||||
| `error` | string | 操作が失敗した場合のエラーメッセージ |
|
||||
|
||||
## 注意事項
|
||||
|
||||
@@ -87,4 +87,14 @@ import { Image } from '@/components/ui/image'
|
||||
|
||||
- APIとチャットの両方の呼び出し元をサポートしたい場合は、Startブロックを単一のエントリーポイントとして扱います。
|
||||
- 下流のノードで生のJSONを解析するよりも、名前付き入力フォーマットフィールドを優先します。型の強制変換は自動的に行われます。
|
||||
- ワークフローが成功するために特定のフィールドが必要な場合は、Startの直後に検証またはルーティングを追加します。
|
||||
- ワークフローが成功するために特定のフィールドが必要な場合は、Startの直後に検証またはルーティングを追加します。
|
||||
|
||||
- <code><start.fieldName></code>を構造化されたペイロードを期待するエージェント、ツール、または関数に直接接続します。
|
||||
- プロンプトフィールドで<code><start.sampleField></code>や<code><start.files[0].url></code>(チャットのみ)などのテンプレート構文を使用します。
|
||||
- 出力のグループ化、会話履歴の更新、またはチャットAPIへのコールバックが必要な場合は、<code><start.conversationId></code>を手元に置いておきます。
|
||||
|
||||
## ベストプラクティス
|
||||
|
||||
- APIとチャットの両方の呼び出し元をサポートしたい場合は、スタートブロックを単一のエントリーポイントとして扱います。
|
||||
- 下流のノードで生のJSONを解析するよりも、名前付き入力フォーマットフィールドを優先します。型の強制変換は自動的に行われます。
|
||||
- ワークフローの成功に特定のフィールドが必要な場合は、スタートの直後に検証またはルーティングを追加します。
|
||||
@@ -11,9 +11,9 @@ import { Image } from '@/components/ui/image'
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/condition.png"
|
||||
alt="条件模块"
|
||||
alt="条件块"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -9,9 +9,9 @@ Function 模块在您的工作流中执行自定义 JavaScript 或 TypeScript
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/function.png"
|
||||
alt="带有代码编辑器的函数模块"
|
||||
alt="函数块与代码编辑器"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -11,9 +11,9 @@ Guardrails 模块通过针对多种验证类型检查内容,验证并保护您
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/guardrails.png"
|
||||
alt="Guardrails 模块"
|
||||
alt="防护栏块"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -128,14 +128,10 @@ const allResults = input.parallel.results;
|
||||
- 您不能在一个容器块中放置另一个容器块
|
||||
</Callout>
|
||||
|
||||
<Callout type="warning">
|
||||
并行块只能包含一个块。您不能在并行块中连接多个块——在这种情况下,只有第一个块会执行。
|
||||
</Callout>
|
||||
|
||||
<Callout type="info">
|
||||
虽然并行执行速度更快,但请注意:
|
||||
- 在发出并发请求时的 API 速率限制
|
||||
- 使用大数据集时的内存使用情况
|
||||
- 在进行并发请求时的 API 速率限制
|
||||
- 使用大型数据集时的内存使用情况
|
||||
- 最多 20 个并发实例,以防止资源耗尽
|
||||
</Callout>
|
||||
|
||||
@@ -143,15 +139,15 @@ const allResults = input.parallel.results;
|
||||
|
||||
了解何时使用每种方式:
|
||||
|
||||
| 功能 | 并行 | 循环 |
|
||||
| 特性 | 并行 | 循环 |
|
||||
|---------|----------|------|
|
||||
| 执行 | 并发 | 顺序 |
|
||||
| 执行方式 | 并发 | 顺序 |
|
||||
| 速度 | 独立操作更快 | 较慢但有序 |
|
||||
| 顺序 | 无保证顺序 | 保持顺序 |
|
||||
| 用例 | 独立操作 | 依赖操作 |
|
||||
| 使用场景 | 独立操作 | 依赖操作 |
|
||||
| 资源使用 | 较高 | 较低 |
|
||||
|
||||
## 输入和输出
|
||||
## 输入与输出
|
||||
|
||||
<Tabs items={['配置', '变量', '结果']}>
|
||||
<Tab>
|
||||
@@ -186,7 +182,7 @@ const allResults = input.parallel.results;
|
||||
<strong>parallel.results</strong>:所有实例结果的数组
|
||||
</li>
|
||||
<li>
|
||||
<strong>访问</strong>:在并行块之后的块中可用
|
||||
<strong>访问</strong>:在并行之后的模块中可用
|
||||
</li>
|
||||
</ul>
|
||||
</Tab>
|
||||
@@ -195,5 +191,5 @@ const allResults = input.parallel.results;
|
||||
## 最佳实践
|
||||
|
||||
- **仅限独立操作**:确保操作之间没有依赖关系
|
||||
- **处理速率限制**:为依赖 API 的工作流添加延迟或限流
|
||||
- **错误处理**:每个实例都应优雅地处理自身的错误
|
||||
- **处理速率限制**:为 API 密集型工作流添加延迟或节流
|
||||
- **错误处理**:每个实例应优雅地处理自己的错误
|
||||
|
||||
@@ -11,9 +11,9 @@ import { Image } from '@/components/ui/image'
|
||||
<div className="flex justify-center">
|
||||
<Image
|
||||
src="/static/blocks/variables.png"
|
||||
alt="变量模块"
|
||||
alt="变量块"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -13,7 +13,7 @@ import { Image } from '@/components/ui/image'
|
||||
src="/static/blocks/wait.png"
|
||||
alt="等待模块"
|
||||
width={500}
|
||||
height={350}
|
||||
height={400}
|
||||
className="my-6"
|
||||
/>
|
||||
</div>
|
||||
|
||||
@@ -12,8 +12,8 @@ import { Image } from '@/components/ui/image'
|
||||
<Image
|
||||
src='/static/blocks/workflow.png'
|
||||
alt='工作流模块配置'
|
||||
width={400}
|
||||
height={280}
|
||||
width={500}
|
||||
height={400}
|
||||
className='rounded-xl border border-border shadow-sm'
|
||||
/>
|
||||
</div>
|
||||
@@ -40,12 +40,24 @@ import { Image } from '@/components/ui/image'
|
||||
- `success` – 是否运行无错误
|
||||
- `error` – 运行失败时的消息
|
||||
|
||||
## 部署状态徽章
|
||||
|
||||
工作流模块显示一个部署状态徽章,帮助您跟踪子工作流是否已准备好执行:
|
||||
|
||||
- **已部署** – 子工作流已部署并可以使用。模块将执行当前已部署的版本。
|
||||
- **未部署** – 子工作流从未部署过。您必须先部署它,工作流模块才能执行。
|
||||
- **重新部署** – 自上次部署以来,检测到子工作流发生了更改。点击徽章以重新部署子工作流并应用最新更改。
|
||||
|
||||
<Callout type="warn">
|
||||
工作流模块始终执行子工作流的最新已部署版本,而不是编辑器版本。请确保在进行更改后重新部署,以确保模块使用最新逻辑。
|
||||
</Callout>
|
||||
|
||||
## 执行注意事项
|
||||
|
||||
- 子工作流在相同的工作区上下文中运行,因此环境变量和工具会被继承。
|
||||
- 该模块使用部署版本控制:任何 API、计划、Webhook、手动或聊天执行都会调用已部署的快照。当您更改子工作流时需要重新部署。
|
||||
- 如果子工作流失败,该模块会引发错误,除非您在下游处理它。
|
||||
- 模块使用部署版本控制:任何 API、计划、Webhook、手动或聊天执行都会调用已部署的快照。当您更改子工作流时,请重新部署。
|
||||
- 如果子工作流失败,模块会引发错误,除非您在下游处理它。
|
||||
|
||||
<Callout>
|
||||
保持子工作流的专注性。小型、可重用的流程使其更容易组合,而不会创建深层嵌套。
|
||||
保持子工作流的专注性。小型、可重用的流程更容易组合,而不会导致深层嵌套。
|
||||
</Callout>
|
||||
|
||||
@@ -10,9 +10,23 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[MongoDB](https://www.mongodb.com/) 工具使您能够连接到 MongoDB 数据库,并直接在您的代理工作流中执行各种面向文档的操作。通过灵活的配置和安全的连接管理,您可以轻松地与数据交互并对其进行操作。
|
||||
|
||||
使用 MongoDB 工具,您可以:
|
||||
|
||||
- **查找文档**:使用 `mongodb_query` 操作,通过丰富的查询过滤器查询集合并检索文档。
|
||||
- **插入文档**:使用 `mongodb_insert` 操作,将一个或多个文档添加到集合中。
|
||||
- **更新文档**:通过指定过滤条件和更新操作,使用 `mongodb_update` 操作修改现有文档。
|
||||
- **删除文档**:使用 `mongodb_delete` 操作,从集合中删除文档,指定过滤器和删除选项。
|
||||
- **聚合数据**:使用 `mongodb_execute` 操作运行复杂的聚合管道,以转换和分析数据。
|
||||
|
||||
MongoDB 工具非常适合需要管理或分析结构化、基于文档的数据的工作流。无论是处理用户生成的内容、管理应用数据,还是支持分析,MongoDB 工具都能以安全、编程化的方式简化您的数据访问和操作。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用说明
|
||||
|
||||
将 MongoDB 集成到工作流程中。可以查找、插入、更新、删除和聚合数据。
|
||||
将 MongoDB 集成到工作流中。可以查找、插入、更新、删除和聚合数据。
|
||||
|
||||
## 工具
|
||||
|
||||
@@ -25,16 +39,16 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `host` | string | 是 | MongoDB 服务器主机名或 IP 地址 |
|
||||
| `port` | number | 是 | MongoDB 服务器端口 \(默认值:27017\) |
|
||||
| `port` | number | 是 | MongoDB 服务器端口 \(默认:27017\) |
|
||||
| `database` | string | 是 | 要连接的数据库名称 |
|
||||
| `username` | string | 否 | MongoDB 用户名 |
|
||||
| `password` | string | 否 | MongoDB 密码 |
|
||||
| `authSource` | string | 否 | 认证数据库 |
|
||||
| `ssl` | string | 否 | SSL 连接模式 \(禁用、必需、优先\) |
|
||||
| `ssl` | string | 否 | SSL 连接模式 \(禁用、必需、首选\) |
|
||||
| `collection` | string | 是 | 要查询的集合名称 |
|
||||
| `query` | string | 否 | 作为 JSON 字符串的 MongoDB 查询过滤器 |
|
||||
| `query` | string | 否 | MongoDB 查询过滤器(JSON 字符串) |
|
||||
| `limit` | number | 否 | 要返回的文档最大数量 |
|
||||
| `sort` | string | 否 | 作为 JSON 字符串的排序条件 |
|
||||
| `sort` | string | 否 | 排序条件(JSON 字符串) |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -50,7 +64,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必填 | 描述 |
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `host` | string | 是 | MongoDB 服务器主机名或 IP 地址 |
|
||||
| `port` | number | 是 | MongoDB 服务器端口 \(默认值:27017\) |
|
||||
@@ -69,7 +83,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `documentCount` | number | 插入的文档数量 |
|
||||
| `insertedId` | string | 插入文档的 ID \(单个插入\) |
|
||||
| `insertedIds` | array | 插入文档 ID 的数组 \(多个插入\) |
|
||||
| `insertedIds` | array | 插入文档的 ID 数组 \(多个插入\) |
|
||||
|
||||
### `mongodb_update`
|
||||
|
||||
@@ -97,10 +111,10 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `matchedCount` | number | 符合筛选条件的文档数量 |
|
||||
| `matchedCount` | number | 符合过滤条件的文档数量 |
|
||||
| `modifiedCount` | number | 被修改的文档数量 |
|
||||
| `documentCount` | number | 受影响的文档总数 |
|
||||
| `insertedId` | string | 插入文档的 ID(如果是 upsert) |
|
||||
| `insertedId` | string | 插入文档的 ID \(如果是 upsert\) |
|
||||
|
||||
### `mongodb_delete`
|
||||
|
||||
@@ -108,25 +122,25 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| 参数 | 类型 | 必填 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `host` | string | 是 | MongoDB 服务器主机名或 IP 地址 |
|
||||
| `port` | number | 是 | MongoDB 服务器端口(默认:27017) |
|
||||
| `port` | number | 是 | MongoDB 服务器端口 \(默认值:27017\) |
|
||||
| `database` | string | 是 | 要连接的数据库名称 |
|
||||
| `username` | string | 否 | MongoDB 用户名 |
|
||||
| `password` | string | 否 | MongoDB 密码 |
|
||||
| `authSource` | string | 否 | 认证数据库 |
|
||||
| `ssl` | string | 否 | SSL 连接模式(禁用、必需、首选) |
|
||||
| `ssl` | string | 否 | SSL 连接模式 \(禁用、必需、优先\) |
|
||||
| `collection` | string | 是 | 要删除的集合名称 |
|
||||
| `filter` | string | 是 | 作为 JSON 字符串的筛选条件 |
|
||||
| `multi` | boolean | 否 | 是否删除多个文档 |
|
||||
| `filter` | string | 是 | 过滤条件(JSON 字符串) |
|
||||
| `multi` | boolean | 否 | 删除多个文档 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `deletedCount` | number | 被删除的文档数量 |
|
||||
| `deletedCount` | number | 删除的文档数量 |
|
||||
| `documentCount` | number | 受影响的文档总数 |
|
||||
|
||||
### `mongodb_execute`
|
||||
@@ -135,7 +149,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| 参数 | 类型 | 必填 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `host` | string | 是 | MongoDB 服务器主机名或 IP 地址 |
|
||||
| `port` | number | 是 | MongoDB 服务器端口 \(默认值:27017\) |
|
||||
@@ -145,14 +159,14 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| `authSource` | string | 否 | 认证数据库 |
|
||||
| `ssl` | string | 否 | SSL 连接模式 \(禁用、必需、优先\) |
|
||||
| `collection` | string | 是 | 要执行管道的集合名称 |
|
||||
| `pipeline` | string | 是 | 作为 JSON 字符串的聚合管道 |
|
||||
| `pipeline` | string | 是 | 聚合管道(JSON 字符串) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `message` | string | 操作状态消息 |
|
||||
| `documents` | array | 从聚合中返回的文档数组 |
|
||||
| `documents` | array | 从聚合返回的文档数组 |
|
||||
| `documentCount` | number | 返回的文档数量 |
|
||||
|
||||
## 注意事项
|
||||
|
||||
@@ -10,9 +10,23 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#E0E0E0"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Salesforce](https://www.salesforce.com/) 工具使您能够直接连接到 Salesforce CRM,并在您的代理工作流中执行广泛的客户关系管理操作。通过无缝且安全的集成,您可以高效地访问并自动化销售、支持和营销数据中的关键业务流程。
|
||||
|
||||
使用 Salesforce 工具,您可以:
|
||||
|
||||
- **检索账户**:使用 `salesforce_get_accounts` 操作从 Salesforce 中获取账户,支持自定义过滤、排序和字段选择。
|
||||
- **创建账户**:通过 `salesforce_create_account` 操作自动将新账户添加到 Salesforce,指定名称、行业和账单地址等详细信息。
|
||||
- **管理联系人**:如果提供类似工具,可用于联系人管理——添加、更新或根据需要获取联系人。
|
||||
- **处理潜在客户和商机**:将潜在客户和商机管理集成到您的工作流中,让您的代理捕获、筛选并更新销售管道数据。
|
||||
- **跟踪案例和任务**:通过与 Salesforce 中的案例和任务交互,自动化客户支持和跟进活动。
|
||||
|
||||
Salesforce 工具非常适合需要简化销售、账户管理、潜在客户生成和支持操作的工作流。无论您的代理是跨平台同步数据、提供实时客户洞察,还是自动化常规 CRM 更新,Salesforce 工具都能将 Salesforce 的全部功能和可扩展性引入您的程序化、代理驱动的流程中。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用说明
|
||||
|
||||
将 Salesforce 集成到您的工作流程中。通过强大的自动化功能管理账户、联系人、潜在客户、商机、案例和任务。
|
||||
将 Salesforce 集成到您的工作流中。通过强大的自动化功能管理账户、联系人、潜在客户、商机、案例和任务。
|
||||
|
||||
## 工具
|
||||
|
||||
@@ -22,12 +36,12 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| 参数 | 类型 | 是否必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `idToken` | string | 否 | Salesforce OAuth 的 ID 令牌(包含实例 URL) |
|
||||
| `instanceUrl` | string | 否 | Salesforce 实例 URL |
|
||||
| `limit` | string | 否 | 返回结果数量(默认:100,最大:2000) |
|
||||
| `fields` | string | 否 | 逗号分隔的返回字段列表(例如:"Id,Name,Industry,Phone") |
|
||||
| `limit` | string | 否 | 返回结果的数量(默认:100,最大:2000) |
|
||||
| `fields` | string | 否 | 要返回的字段的逗号分隔列表(例如:"Id,Name,Industry,Phone") |
|
||||
| `orderBy` | string | 否 | 排序字段(例如:"Name ASC" 或 "CreatedDate DESC") |
|
||||
|
||||
#### 输出
|
||||
@@ -39,7 +53,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
### `salesforce_create_account`
|
||||
|
||||
在 Salesforce CRM 中创建新账户
|
||||
在 Salesforce CRM 中创建一个新账户
|
||||
|
||||
#### 输入
|
||||
|
||||
@@ -49,7 +63,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| `instanceUrl` | string | 否 | 无描述 |
|
||||
| `name` | string | 是 | 账户名称(必需) |
|
||||
| `type` | string | 否 | 账户类型(例如:客户、合作伙伴、潜在客户) |
|
||||
| `industry` | string | 否 | 行业(例如:技术、医疗、金融) |
|
||||
| `industry` | string | 否 | 行业(例如:科技、医疗、金融) |
|
||||
| `phone` | string | 否 | 电话号码 |
|
||||
| `website` | string | 否 | 网站 URL |
|
||||
| `billingStreet` | string | 否 | 账单街道地址 |
|
||||
@@ -98,11 +112,11 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 操作成功状态 |
|
||||
| `output` | object | 更新的账户数据 |
|
||||
| `output` | object | 更新后的账户数据 |
|
||||
|
||||
### `salesforce_delete_account`
|
||||
|
||||
从 Salesforce CRM 删除一个账户
|
||||
从 Salesforce CRM 中删除账户
|
||||
|
||||
#### 输入
|
||||
|
||||
@@ -117,7 +131,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 操作成功状态 |
|
||||
| `output` | object | 已删除账户数据 |
|
||||
| `output` | object | 已删除的账户数据 |
|
||||
|
||||
### `salesforce_get_contacts`
|
||||
|
||||
@@ -165,7 +179,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必填 | 描述 |
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### 输出
|
||||
@@ -179,7 +193,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必填 | 描述 |
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### 输出
|
||||
@@ -193,7 +207,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必填 | 描述 |
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### 输出
|
||||
@@ -207,7 +221,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必填 | 描述 |
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### 输出
|
||||
@@ -221,7 +235,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必填 | 描述 |
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -10,36 +10,54 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#635BFF"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Stripe](https://stripe.com/) 是一个强大的支付平台,可以让您轻松管理支付、客户、订阅、发票、产品等。
|
||||
|
||||
将 Stripe 集成到 Sim 中后,您的代理可以:
|
||||
|
||||
- **创建和管理支付意图**:通过灵活的配置选项处理支付。
|
||||
- **管理客户**:创建、检索和更新您的业务客户记录。
|
||||
- **处理订阅**:管理循环计费和订阅生命周期。
|
||||
- **创建和发送发票**:为一次性或循环支付生成发票。
|
||||
- **跟踪和管理收费**:检索和更新收费对象以监控支付。
|
||||
- **配置产品和价格**:设置您的产品目录、定价模型和优惠。
|
||||
- **监听和响应 Stripe 事件**:在支付更新、成功收费和其他 Stripe 事件发生时触发工作流。
|
||||
|
||||
通过将 Sim 与 Stripe 连接,您可以在代理工作流中实现无缝的自动化和财务操作。自动化客户入驻、订阅管理、支付收款、发票生成,甚至在支付事件发生时执行自定义操作——所有这些都由您的代理通过 Stripe 安全地直接处理。
|
||||
|
||||
无论您是在构建电子商务自动化、订阅服务,还是运行报告和对账,Stripe 工具都能让您轻松地在智能 Sim 工作流中协调支付和财务数据。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用说明
|
||||
|
||||
将 Stripe 集成到工作流程中。管理支付意图、客户、订阅、发票、收费、产品、价格和事件。可以在触发模式下使用,当发生 Stripe 事件时触发工作流程。
|
||||
将 Stripe 集成到工作流中。管理支付意图、客户、订阅、发票、收费、产品、价格和事件。可以在触发模式下使用,当发生 Stripe 事件时触发工作流。
|
||||
|
||||
## 工具
|
||||
|
||||
### `stripe_create_payment_intent`
|
||||
|
||||
创建一个新的 Payment Intent 以处理支付
|
||||
创建一个新的支付意图以处理支付
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `amount` | number | 是 | 金额(以分为单位,例如 2000 表示 $20.00) |
|
||||
| `currency` | string | 是 | 三字母 ISO 货币代码(例如 usd, eur) |
|
||||
| `customer` | string | 否 | 要与此支付关联的客户 ID |
|
||||
| --------- | ---- | ---- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥 \(secret key\) |
|
||||
| `amount` | number | 是 | 金额(以分为单位)\(例如,2000 表示 $20.00\) |
|
||||
| `currency` | string | 是 | 三字母 ISO 货币代码 \(例如,usd, eur\) |
|
||||
| `customer` | string | 否 | 与此支付关联的客户 ID |
|
||||
| `payment_method` | string | 否 | 支付方式 ID |
|
||||
| `description` | string | 否 | 支付描述 |
|
||||
| `receipt_email` | string | 否 | 用于发送收据的电子邮件地址 |
|
||||
| `metadata` | json | 否 | 用于存储附加信息的键值对集合 |
|
||||
| `automatic_payment_methods` | json | 否 | 启用自动支付方式(例如,\{"enabled": true\}) |
|
||||
| `automatic_payment_methods` | json | 否 | 启用自动支付方式 \(例如,\{"enabled": true\}\) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `payment_intent` | json | 创建的 Payment Intent 对象 |
|
||||
| `metadata` | json | Payment Intent 元数据,包括 ID、状态、金额和货币 |
|
||||
| `metadata` | json | 包含 ID、状态、金额和货币的 Payment Intent 元数据 |
|
||||
|
||||
### `stripe_retrieve_payment_intent`
|
||||
|
||||
@@ -67,7 +85,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | Payment Intent ID(例如,pi_1234567890) |
|
||||
| `amount` | number | 否 | 更新后的金额(以分为单位) |
|
||||
| `currency` | string | 否 | 三字母 ISO 货币代码 |
|
||||
@@ -90,7 +108,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | Payment Intent ID(例如,pi_1234567890) |
|
||||
| `payment_method` | string | 否 | 用于确认的支付方式 ID |
|
||||
|
||||
@@ -99,7 +117,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `payment_intent` | json | 确认的 Payment Intent 对象 |
|
||||
| `metadata` | json | 包含 ID、状态、金额和货币的 Payment Intent 元数据 |
|
||||
| `metadata` | json | 包括 ID、状态、金额和货币的 Payment Intent 元数据 |
|
||||
|
||||
### `stripe_capture_payment_intent`
|
||||
|
||||
@@ -111,14 +129,14 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | Payment Intent ID(例如,pi_1234567890) |
|
||||
| `amount_to_capture` | number | 否 | 要捕获的金额(以分为单位,默认为全额) |
|
||||
| `amount_to_capture` | number | 否 | 捕获的金额(以分为单位,默认为全额) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `payment_intent` | json | 捕获的 Payment Intent 对象 |
|
||||
| `metadata` | json | 包含 ID、状态、金额和货币的 Payment Intent 元数据 |
|
||||
| `metadata` | json | 包括 ID、状态、金额和货币的 Payment Intent 元数据 |
|
||||
|
||||
### `stripe_cancel_payment_intent`
|
||||
|
||||
@@ -130,7 +148,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | Payment Intent ID(例如,pi_1234567890) |
|
||||
| `cancellation_reason` | string | 否 | 取消原因(duplicate、fraudulent、requested_by_customer、abandoned) |
|
||||
| `cancellation_reason` | string | 否 | 取消原因(duplicate, fraudulent, requested_by_customer, abandoned) |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -141,27 +159,27 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
### `stripe_list_payment_intents`
|
||||
|
||||
列出所有 Payment Intents
|
||||
列出所有 Payment Intent
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `limit` | number | 否 | 返回结果数量(默认 10,最大 100) |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
| `customer` | string | 否 | 按客户 ID 过滤 |
|
||||
| `created` | json | 否 | 按创建日期过滤(例如,\{"gt": 1633024800\}) |
|
||||
| `created` | json | 否 | 按创建日期过滤(例如,`{"gt": 1633024800}`) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `payment_intents` | json | Payment Intent 对象数组 |
|
||||
| `metadata` | json | 包含计数和 has_more 的列表元数据 |
|
||||
| `payment_intents` | json | Payment Intent 对象的数组 |
|
||||
| `metadata` | json | 列表元数据,包括计数和 has_more |
|
||||
|
||||
### `stripe_search_payment_intents`
|
||||
|
||||
使用查询语法搜索 Payment Intents
|
||||
使用查询语法搜索 Payment Intent
|
||||
|
||||
#### 输入
|
||||
|
||||
@@ -169,14 +187,14 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `query` | string | 是 | 搜索查询(例如,"status:'succeeded' AND currency:'usd'") |
|
||||
| `limit` | number | 否 | 返回结果数量(默认 10,最大 100) |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `payment_intents` | json | 匹配的 Payment Intent 对象数组 |
|
||||
| `metadata` | json | 包含计数和 has_more 的搜索元数据 |
|
||||
| `payment_intents` | json | 匹配的 Payment Intent 对象的数组 |
|
||||
| `metadata` | json | 搜索元数据,包括计数和 has_more |
|
||||
|
||||
### `stripe_create_customer`
|
||||
|
||||
@@ -187,10 +205,10 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `email` | string | 否 | 客户电子邮件地址 |
|
||||
| `name` | string | 否 | 客户全名 |
|
||||
| `phone` | string | 否 | 客户电话号码 |
|
||||
| `description` | string | 否 | 客户描述 |
|
||||
| `email` | string | 否 | 客户的电子邮件地址 |
|
||||
| `name` | string | 否 | 客户的全名 |
|
||||
| `phone` | string | 否 | 客户的电话号码 |
|
||||
| `description` | string | 否 | 客户的描述 |
|
||||
| `address` | json | 否 | 客户地址对象 |
|
||||
| `metadata` | json | 否 | 键值对集合 |
|
||||
| `payment_method` | string | 否 | 要附加的支付方式 ID |
|
||||
@@ -210,8 +228,8 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥 \(秘密密钥\) |
|
||||
| `id` | string | 是 | 客户 ID \(例如,cus_1234567890\) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 客户 ID(例如,cus_1234567890) |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -228,14 +246,14 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥 \(秘密密钥\) |
|
||||
| `id` | string | 是 | 客户 ID \(例如,cus_1234567890\) |
|
||||
| `email` | string | 否 | 更新的电子邮件地址 |
|
||||
| `name` | string | 否 | 更新的姓名 |
|
||||
| `phone` | string | 否 | 更新的电话号码 |
|
||||
| `description` | string | 否 | 更新的描述 |
|
||||
| `address` | json | 否 | 更新的地址对象 |
|
||||
| `metadata` | json | 否 | 更新的元数据 |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 客户 ID(例如,cus_1234567890) |
|
||||
| `email` | string | 否 | 更新后的电子邮件地址 |
|
||||
| `name` | string | 否 | 更新后的姓名 |
|
||||
| `phone` | string | 否 | 更新后的电话号码 |
|
||||
| `description` | string | 否 | 更新后的描述 |
|
||||
| `address` | json | 否 | 更新后的地址对象 |
|
||||
| `metadata` | json | 否 | 更新后的元数据 |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -252,16 +270,16 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 客户 ID(例如,cus_1234567890) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `deleted` | boolean | 客户是否已被删除 |
|
||||
| `deleted` | boolean | 客户是否已删除 |
|
||||
| `id` | string | 已删除客户的 ID |
|
||||
| `metadata` | json | 删除的元数据 |
|
||||
| `metadata` | json | 删除元数据 |
|
||||
|
||||
### `stripe_list_customers`
|
||||
|
||||
@@ -271,8 +289,8 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `limit` | number | 否 | 返回结果数量(默认 10,最大 100) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
| `email` | string | 否 | 按电子邮件地址筛选 |
|
||||
| `created` | json | 否 | 按创建日期筛选 |
|
||||
|
||||
@@ -291,9 +309,9 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `query` | string | 是 | 搜索查询(例如,"email:'customer@example.com'") |
|
||||
| `limit` | number | 否 | 返回结果数量(默认 10,最大 100) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `query` | string | 是 | 搜索查询(例如,"email:\'customer@example.com\'") |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -304,13 +322,13 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
### `stripe_create_subscription`
|
||||
|
||||
为客户创建一个新的订阅
|
||||
为客户创建一个新订阅
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `customer` | string | 是 | 要订阅的客户 ID |
|
||||
| `items` | json | 是 | 包含价格 ID 的项目数组(例如,\[\{"price": "price_xxx", "quantity": 1\}\]) |
|
||||
| `trial_period_days` | number | 否 | 试用天数 |
|
||||
@@ -327,13 +345,13 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
### `stripe_retrieve_subscription`
|
||||
|
||||
通过 ID 检索现有订阅
|
||||
通过 ID 检索现有的订阅
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 订阅 ID(例如,sub_1234567890) |
|
||||
|
||||
#### 输出
|
||||
@@ -345,15 +363,15 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
### `stripe_update_subscription`
|
||||
|
||||
更新现有订阅
|
||||
更新现有的订阅
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 订阅 ID(例如,sub_1234567890) |
|
||||
| `items` | json | 否 | 包含价格 ID 的更新项目数组 |
|
||||
| `items` | json | 否 | 更新后的包含价格 ID 的项目数组 |
|
||||
| `cancel_at_period_end` | boolean | 否 | 是否在周期结束时取消订阅 |
|
||||
| `metadata` | json | 否 | 更新的元数据 |
|
||||
|
||||
@@ -372,9 +390,9 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 订阅 ID(例如,sub_1234567890) |
|
||||
| `prorate` | boolean | 否 | 是否按比例取消 |
|
||||
| `prorate` | boolean | 否 | 是否按比例分配取消 |
|
||||
| `invoice_now` | boolean | 否 | 是否立即开具发票 |
|
||||
|
||||
#### 输出
|
||||
@@ -392,7 +410,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 订阅 ID(例如,sub_1234567890) |
|
||||
|
||||
#### 输出
|
||||
@@ -410,8 +428,8 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `limit` | number | 否 | 返回结果数量(默认 10,最大 100) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
| `customer` | string | 否 | 按客户 ID 过滤 |
|
||||
| `status` | string | 否 | 按状态过滤(active, past_due, unpaid, canceled, incomplete, incomplete_expired, trialing, all) |
|
||||
| `price` | string | 否 | 按价格 ID 过滤 |
|
||||
@@ -431,9 +449,9 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `query` | string | 是 | 搜索查询(例如,"status:'active' AND customer:'cus_xxx'") |
|
||||
| `limit` | number | 否 | 返回结果数量(默认 10,最大 100) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `query` | string | 是 | 搜索查询(例如,\"status:'active' AND customer:'cus_xxx'\") |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -450,7 +468,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `customer` | string | 是 | 客户 ID(例如,cus_1234567890) |
|
||||
| `description` | string | 否 | 发票描述 |
|
||||
| `metadata` | json | 否 | 键值对集合 |
|
||||
@@ -472,7 +490,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 发票 ID(例如,in_1234567890) |
|
||||
|
||||
#### 输出
|
||||
@@ -490,9 +508,9 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `id` | string | 是 | 发票 ID(例如:in_1234567890) |
|
||||
| `description` | string | 否 | 发票描述 |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 发票 ID(例如,in_1234567890) |
|
||||
| `description` | string | 否 | 发票的描述 |
|
||||
| `metadata` | json | 否 | 键值对集合 |
|
||||
| `auto_advance` | boolean | 否 | 自动完成发票 |
|
||||
|
||||
@@ -511,16 +529,16 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `id` | string | 是 | 发票 ID(例如:in_1234567890) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 发票 ID(例如,in_1234567890) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `deleted` | boolean | 发票是否已删除 |
|
||||
| `deleted` | boolean | 发票是否已被删除 |
|
||||
| `id` | string | 已删除发票的 ID |
|
||||
| `metadata` | json | 删除元数据 |
|
||||
| `metadata` | json | 删除的元数据 |
|
||||
|
||||
### `stripe_finalize_invoice`
|
||||
|
||||
@@ -530,15 +548,15 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `id` | string | 是 | 发票 ID(例如:in_1234567890) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 发票 ID(例如,in_1234567890) |
|
||||
| `auto_advance` | boolean | 否 | 自动推进发票 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `invoice` | json | 最终的发票对象 |
|
||||
| `invoice` | json | 完成的发票对象 |
|
||||
| `metadata` | json | 发票元数据 |
|
||||
|
||||
### `stripe_pay_invoice`
|
||||
@@ -549,8 +567,8 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(私钥) |
|
||||
| `id` | string | 是 | 发票 ID(例如:in_1234567890) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 发票 ID(例如,in_1234567890) |
|
||||
| `paid_out_of_band` | boolean | 否 | 将发票标记为带外支付 |
|
||||
|
||||
#### 输出
|
||||
@@ -568,8 +586,8 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(私钥) |
|
||||
| `id` | string | 是 | 发票 ID(例如:in_1234567890) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 发票 ID(例如,in_1234567890) |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -586,14 +604,14 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(私钥) |
|
||||
| `id` | string | 是 | 发票 ID(例如:in_1234567890) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 发票 ID(例如,in_1234567890) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `invoice` | json | 发送的发票对象 |
|
||||
| `invoice` | json | 已发送的发票对象 |
|
||||
| `metadata` | json | 发票元数据 |
|
||||
|
||||
### `stripe_list_invoices`
|
||||
@@ -604,8 +622,8 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `limit` | number | 否 | 返回结果数量(默认 10,最大 100) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
| `customer` | string | 否 | 按客户 ID 过滤 |
|
||||
| `status` | string | 否 | 按发票状态过滤 |
|
||||
|
||||
@@ -624,9 +642,9 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `query` | string | 是 | 搜索查询(例如:"customer:\'cus_1234567890\'") |
|
||||
| `limit` | number | 否 | 返回结果数量(默认 10,最大 100) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `query` | string | 是 | 搜索查询(例如,"customer:\'cus_1234567890\'") |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -643,12 +661,12 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `amount` | number | 是 | 金额(以分为单位,例如 2000 表示 $20.00) |
|
||||
| `currency` | string | 是 | 三字母 ISO 货币代码(例如 usd, eur) |
|
||||
| `currency` | string | 是 | 三字母 ISO 货币代码(例如,usd、eur) |
|
||||
| `customer` | string | 否 | 要与此收费关联的客户 ID |
|
||||
| `source` | string | 否 | 支付来源 ID(例如,卡片令牌或已保存的卡片 ID) |
|
||||
| `description` | string | 否 | 收费描述 |
|
||||
| `description` | string | 否 | 收费的描述 |
|
||||
| `metadata` | json | 否 | 用于存储附加信息的键值对集合 |
|
||||
| `capture` | boolean | 否 | 是否立即捕获收费(默认为 true) |
|
||||
|
||||
@@ -661,21 +679,21 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
### `stripe_retrieve_charge`
|
||||
|
||||
通过 ID 检索现有收费
|
||||
通过 ID 检索现有的收费
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `id` | string | 是 | 收费 ID(例如 ch_1234567890) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 收费 ID(例如,ch_1234567890) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charge` | json | 检索到的收费对象 |
|
||||
| `metadata` | json | 收费元数据,包括 ID、状态、金额、货币和支付状态 |
|
||||
| `charge` | json | 检索到的 Charge 对象 |
|
||||
| `metadata` | json | Charge 元数据,包括 ID、状态、金额、货币和支付状态 |
|
||||
|
||||
### `stripe_update_charge`
|
||||
|
||||
@@ -685,8 +703,8 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `id` | string | 是 | 收费 ID(例如,ch_1234567890) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | Charge ID(例如,ch_1234567890) |
|
||||
| `description` | string | 否 | 更新的描述 |
|
||||
| `metadata` | json | 否 | 更新的元数据 |
|
||||
|
||||
@@ -694,8 +712,8 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charge` | json | 更新后的收费对象 |
|
||||
| `metadata` | json | 包括 ID、状态、金额、货币和支付状态的收费元数据 |
|
||||
| `charge` | json | 更新后的 Charge 对象 |
|
||||
| `metadata` | json | Charge 元数据,包括 ID、状态、金额、货币和支付状态 |
|
||||
|
||||
### `stripe_capture_charge`
|
||||
|
||||
@@ -705,16 +723,16 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `id` | string | 是 | 收费 ID(例如,ch_1234567890) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | Charge ID(例如,ch_1234567890) |
|
||||
| `amount` | number | 否 | 捕获的金额(以分为单位,默认为全额) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charge` | json | 捕获的收费对象 |
|
||||
| `metadata` | json | 包括 ID、状态、金额、货币和支付状态的收费元数据 |
|
||||
| `charge` | json | 捕获的 Charge 对象 |
|
||||
| `metadata` | json | Charge 元数据,包括 ID、状态、金额、货币和支付状态 |
|
||||
|
||||
### `stripe_list_charges`
|
||||
|
||||
@@ -724,36 +742,36 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
| `customer` | string | 否 | 按客户 ID 过滤 |
|
||||
| `created` | json | 否 | 按创建日期过滤(例如,\{"gt": 1633024800\}) |
|
||||
| `created` | json | 否 | 按创建日期过滤(例如,`{"gt": 1633024800}`) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charges` | json | Charge 对象的数组 |
|
||||
| `metadata` | json | 包括计数和 has_more 的列表元数据 |
|
||||
| `charges` | json | 收费对象数组 |
|
||||
| `metadata` | json | 列表元数据,包括计数和 has_more |
|
||||
|
||||
### `stripe_search_charges`
|
||||
|
||||
使用查询语法搜索收费记录
|
||||
使用查询语法搜索收费
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `query` | string | 是 | 搜索查询(例如,\"status:'succeeded' AND currency:'usd'\") |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `query` | string | 是 | 搜索查询(例如,"status:'succeeded' AND currency:'usd'") |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `charges` | json | 匹配的 Charge 对象的数组 |
|
||||
| `metadata` | json | 包括计数和 has_more 的搜索元数据 |
|
||||
| `charges` | json | 匹配的收费对象数组 |
|
||||
| `metadata` | json | 搜索元数据,包括计数和 has_more |
|
||||
|
||||
### `stripe_create_product`
|
||||
|
||||
@@ -763,10 +781,10 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `name` | string | 是 | 产品名称 |
|
||||
| `description` | string | 否 | 产品描述 |
|
||||
| `active` | boolean | 否 | 产品是否为激活状态 |
|
||||
| `active` | boolean | 否 | 产品是否处于激活状态 |
|
||||
| `images` | json | 否 | 产品的图片 URL 数组 |
|
||||
| `metadata` | json | 否 | 键值对集合 |
|
||||
|
||||
@@ -779,13 +797,13 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
### `stripe_retrieve_product`
|
||||
|
||||
通过 ID 检索现有产品
|
||||
通过 ID 检索现有的产品
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 产品 ID(例如,prod_1234567890) |
|
||||
|
||||
#### 输出
|
||||
@@ -797,13 +815,13 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
### `stripe_update_product`
|
||||
|
||||
更新现有产品
|
||||
更新现有的产品
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 产品 ID(例如,prod_1234567890) |
|
||||
| `name` | string | 否 | 更新的产品名称 |
|
||||
| `description` | string | 否 | 更新的产品描述 |
|
||||
@@ -826,16 +844,16 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 产品 ID(例如,prod_1234567890) |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `deleted` | boolean | 产品是否已删除 |
|
||||
| `deleted` | boolean | 产品是否已被删除 |
|
||||
| `id` | string | 已删除产品的 ID |
|
||||
| `metadata` | json | 删除的元数据 |
|
||||
| `metadata` | json | 删除元数据 |
|
||||
|
||||
### `stripe_list_products`
|
||||
|
||||
@@ -845,8 +863,8 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `limit` | number | 否 | 返回结果数量(默认 10,最大 100) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
| `active` | boolean | 否 | 按活动状态筛选 |
|
||||
|
||||
#### 输出
|
||||
@@ -864,9 +882,9 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `query` | string | 是 | 搜索查询(例如,"name:\'shirt\'") |
|
||||
| `limit` | number | 否 | 返回结果数量(默认 10,最大 100) |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -883,9 +901,9 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `product` | string | 是 | 产品 ID(例如,prod_1234567890) |
|
||||
| `currency` | string | 是 | 三字母 ISO 货币代码(例如,usd, eur) |
|
||||
| `currency` | string | 是 | 三字母 ISO 货币代码(例如,usd,eur) |
|
||||
| `unit_amount` | number | 否 | 金额(以分为单位,例如,1000 表示 $10.00) |
|
||||
| `recurring` | json | 否 | 循环计费配置(间隔:天/周/月/年) |
|
||||
| `metadata` | json | 否 | 键值对集合 |
|
||||
@@ -900,13 +918,13 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
### `stripe_retrieve_price`
|
||||
|
||||
通过 ID 检索现有价格
|
||||
通过 ID 检索现有的价格
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 价格 ID(例如,price_1234567890) |
|
||||
|
||||
#### 输出
|
||||
@@ -924,16 +942,16 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 价格 ID(例如,price_1234567890) |
|
||||
| `active` | boolean | 否 | 价格是否激活 |
|
||||
| `active` | boolean | 否 | 价格是否为激活状态 |
|
||||
| `metadata` | json | 否 | 更新的元数据 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `price` | json | 更新后的价格对象 |
|
||||
| `price` | json | 更新的价格对象 |
|
||||
| `metadata` | json | 价格元数据 |
|
||||
|
||||
### `stripe_list_prices`
|
||||
@@ -944,8 +962,8 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `limit` | number | 否 | 返回结果数量(默认 10,最大 100) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
| `product` | string | 否 | 按产品 ID 过滤 |
|
||||
| `active` | boolean | 否 | 按激活状态过滤 |
|
||||
|
||||
@@ -964,9 +982,9 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(秘密密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `query` | string | 是 | 搜索查询(例如,"active:'true' AND currency:'usd'") |
|
||||
| `limit` | number | 否 | 返回结果数量(默认 10,最大 100) |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -977,13 +995,13 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
### `stripe_retrieve_event`
|
||||
|
||||
通过 ID 检索现有事件
|
||||
通过 ID 检索现有的事件
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `id` | string | 是 | 事件 ID(例如,evt_1234567890) |
|
||||
|
||||
#### 输出
|
||||
@@ -991,7 +1009,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `event` | json | 检索到的事件对象 |
|
||||
| `metadata` | json | 包括 ID、类型和创建时间戳的事件元数据 |
|
||||
| `metadata` | json | 事件元数据,包括 ID、类型和创建时间戳 |
|
||||
|
||||
### `stripe_list_events`
|
||||
|
||||
@@ -1001,10 +1019,10 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(密钥) |
|
||||
| `limit` | number | 否 | 返回结果数量(默认 10,最大 100) |
|
||||
| `apiKey` | string | 是 | Stripe API 密钥(secret key) |
|
||||
| `limit` | number | 否 | 返回结果的数量(默认 10,最大 100) |
|
||||
| `type` | string | 否 | 按事件类型过滤(例如,payment_intent.created) |
|
||||
| `created` | json | 否 | 按创建日期过滤(例如,\{"gt": 1633024800\}) |
|
||||
| `created` | json | 否 | 按创建日期过滤(例如,`{"gt": 1633024800}`) |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -1013,7 +1031,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| `events` | json | 事件对象的数组 |
|
||||
| `metadata` | json | 列表元数据,包括计数和 has_more |
|
||||
|
||||
## 注意事项
|
||||
## 注意
|
||||
|
||||
- 分类:`tools`
|
||||
- 类别:`tools`
|
||||
- 类型:`stripe`
|
||||
|
||||
@@ -10,9 +10,24 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#0052CC"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Trello](https://trello.com) 是一个可视化协作工具,帮助您使用看板、列表和卡片来组织项目、任务和工作流程。
|
||||
|
||||
在 Sim 中使用 Trello,您可以:
|
||||
|
||||
- **列出看板和列表**:查看您有权限访问的看板及其关联的列表。
|
||||
- **列出和搜索卡片**:检索看板上的所有卡片,或按列表筛选以查看其内容和状态。
|
||||
- **创建卡片**:向 Trello 列表中添加新卡片,包括描述、标签和到期日期。
|
||||
- **更新和移动卡片**:编辑卡片属性,将卡片移动到不同的列表,并设置到期日期或标签。
|
||||
- **获取最近活动**:检索看板和卡片的操作和活动历史记录。
|
||||
- **评论卡片**:向卡片添加评论以便协作和跟踪。
|
||||
|
||||
将 Trello 与 Sim 集成,可以让您的代理以编程方式管理团队的任务、看板和项目。通过您的 AI 代理,自动化项目管理工作流程,保持任务列表的最新状态,与其他工具同步,或响应 Trello 事件触发智能工作流程。
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
## 使用说明
|
||||
|
||||
与 Trello 集成以管理看板和卡片。列出看板、列出卡片、创建卡片、更新卡片、获取操作并添加评论。
|
||||
集成 Trello 以管理看板和卡片。列出看板、列出卡片、创建卡片、更新卡片、获取操作记录以及添加评论。
|
||||
|
||||
## 工具
|
||||
|
||||
@@ -63,21 +78,21 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `boardId` | string | 是 | 要在其上创建卡片的看板 ID |
|
||||
| `listId` | string | 是 | 要在其中创建卡片的列表 ID |
|
||||
| `boardId` | string | 是 | 要创建卡片的看板 ID |
|
||||
| `listId` | string | 是 | 要创建卡片的列表 ID |
|
||||
| `name` | string | 是 | 卡片的名称/标题 |
|
||||
| `desc` | string | 否 | 卡片的描述 |
|
||||
| `pos` | string | 否 | 卡片的位置(顶部、底部或正浮点数) |
|
||||
| `pos` | string | 否 | 卡片的位置(top、bottom 或正浮点数) |
|
||||
| `due` | string | 否 | 到期日期(ISO 8601 格式) |
|
||||
| `labels` | string | 否 | 以逗号分隔的标签 ID 列表 |
|
||||
| `labels` | string | 否 | 逗号分隔的标签 ID 列表 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 卡片是否成功创建 |
|
||||
| `success` | boolean | 卡片是否创建成功 |
|
||||
| `card` | object | 创建的卡片对象,包含 id、name、desc、url 和其他属性 |
|
||||
| `error` | string | 如果操作失败的错误信息 |
|
||||
| `error` | string | 如果操作失败,返回错误信息 |
|
||||
|
||||
### `trello_update_card`
|
||||
|
||||
@@ -91,30 +106,30 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| `name` | string | 否 | 卡片的新名称/标题 |
|
||||
| `desc` | string | 否 | 卡片的新描述 |
|
||||
| `closed` | boolean | 否 | 归档/关闭卡片(true)或重新打开卡片(false) |
|
||||
| `idList` | string | 否 | 将卡片移动到不同的列表 |
|
||||
| `idList` | string | 否 | 将卡片移动到其他列表 |
|
||||
| `due` | string | 否 | 到期日期(ISO 8601 格式) |
|
||||
| `dueComplete` | boolean | 否 | 将到期日期标记为完成 |
|
||||
| `dueComplete` | boolean | 否 | 将到期日期标记为已完成 |
|
||||
|
||||
#### 输出
|
||||
|
||||
| 参数 | 类型 | 描述 |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 卡片是否成功更新 |
|
||||
| `card` | object | 更新后的卡片对象,包含 id、name、desc、url 和其他属性 |
|
||||
| `error` | string | 如果操作失败,则为错误信息 |
|
||||
| `success` | boolean | 卡片是否更新成功 |
|
||||
| `card` | object | 更新的卡片对象,包含 id、name、desc、url 和其他属性 |
|
||||
| `error` | string | 如果操作失败,返回错误信息 |
|
||||
|
||||
### `trello_get_actions`
|
||||
|
||||
从看板或卡片获取活动/操作
|
||||
获取看板或卡片的活动/操作
|
||||
|
||||
#### 输入
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `boardId` | string | 否 | 要获取操作的看板 ID(需要 boardId 或 cardId) |
|
||||
| `cardId` | string | 否 | 要获取操作的卡片 ID(需要 boardId 或 cardId) |
|
||||
| `filter` | string | 否 | 按类型筛选操作(例如:"commentCard,updateCard,createCard" 或 "all") |
|
||||
| `limit` | number | 否 | 返回的最大操作数(默认值:50,最大值:1000) |
|
||||
| `boardId` | string | 否 | 要获取操作的看板 ID(boardId 或 cardId 必填其一) |
|
||||
| `cardId` | string | 否 | 要获取操作的卡片 ID(boardId 或 cardId 必填其一) |
|
||||
| `filter` | string | 否 | 按类型筛选操作(例如 "commentCard,updateCard,createCard" 或 "all") |
|
||||
| `limit` | number | 否 | 返回的最大操作数(默认:50,最大:1000) |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -122,8 +137,8 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 操作是否成功 |
|
||||
| `actions` | array | 包含类型、日期、成员和数据的操作对象数组 |
|
||||
| `count` | number | 返回的操作数 |
|
||||
| `error` | string | 如果操作失败,则为错误信息 |
|
||||
| `count` | number | 返回的操作数量 |
|
||||
| `error` | string | 如果操作失败,返回的错误信息 |
|
||||
|
||||
### `trello_add_comment`
|
||||
|
||||
@@ -134,7 +149,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `cardId` | string | 是 | 要评论的卡片 ID |
|
||||
| `text` | string | 是 | 评论文本 |
|
||||
| `text` | string | 是 | 评论内容 |
|
||||
|
||||
#### 输出
|
||||
|
||||
@@ -142,9 +157,9 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | 评论是否成功添加 |
|
||||
| `comment` | object | 创建的评论对象,包含 id、text、date 和 member creator |
|
||||
| `error` | string | 如果操作失败的错误信息 |
|
||||
| `error` | string | 如果操作失败,返回的错误信息 |
|
||||
|
||||
## 注意
|
||||
## 注意事项
|
||||
|
||||
- 类别: `tools`
|
||||
- 类型: `trello`
|
||||
- 类别:`tools`
|
||||
- 类型:`trello`
|
||||
|
||||
@@ -87,4 +87,14 @@ import { Image } from '@/components/ui/image'
|
||||
|
||||
- 当您希望同时支持 API 和聊天调用者时,将 Start 块视为单一入口点。
|
||||
- 优先使用命名的输入格式字段,而不是在下游节点中解析原始 JSON;类型强制会自动发生。
|
||||
- 如果您的工作流需要某些字段才能成功,请在 Start 之后立即添加验证或路由。
|
||||
- 如果您的工作流需要某些字段才能成功,请在 Start 之后立即添加验证或路由。
|
||||
|
||||
- 将 <code><start.fieldName></code> 直接连接到需要结构化负载的代理、工具或函数。
|
||||
- 在提示字段中使用模板语法,例如 <code><start.sampleField></code> 或 <code><start.files[0].url></code>(仅限聊天)。
|
||||
- 当需要对输出进行分组、更新会话历史记录或回调到聊天 API 时,请随时使用 <code><start.conversationId></code>。
|
||||
|
||||
## 最佳实践
|
||||
|
||||
- 当您希望同时支持 API 和聊天调用者时,将 Start 块视为单一入口点。
|
||||
- 优先使用命名的输入格式字段,而不是在下游节点中解析原始 JSON;类型强制会自动发生。
|
||||
- 如果某些字段是工作流成功所必需的,请在 Start 之后立即添加验证或路由。
|
||||
1222
apps/docs/i18n.lock
1222
apps/docs/i18n.lock
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user