From 5d791cd55fea9c17cfeb6f35fc40bf6675612585 Mon Sep 17 00:00:00 2001 From: Waleed Date: Thu, 4 Dec 2025 00:18:21 -0800 Subject: [PATCH] feat(i18n): update translations (#2178) * feat(i18n): update translations * memory optimizations --------- Co-authored-by: waleedlatif1 --- apps/docs/content/docs/de/tools/ahrefs.mdx | 199 +++ apps/docs/content/docs/de/tools/datadog.mdx | 302 ++++ apps/docs/content/docs/de/tools/dropbox.mdx | 219 +++ .../content/docs/de/tools/elasticsearch.mdx | 365 +++++ apps/docs/content/docs/de/tools/gitlab.mdx | 429 ++++++ apps/docs/content/docs/de/tools/grafana.mdx | 494 +++++++ apps/docs/content/docs/de/tools/kalshi.mdx | 295 ++++ .../docs/content/docs/de/tools/polymarket.mdx | 352 +++++ apps/docs/content/docs/de/tools/pylon.mdx | 30 +- apps/docs/content/docs/de/tools/shopify.mdx | 444 ++++++ apps/docs/content/docs/de/tools/ssh.mdx | 394 ++++++ apps/docs/content/docs/de/tools/wordpress.mdx | 566 ++++++++ apps/docs/content/docs/de/tools/zendesk.mdx | 9 +- apps/docs/content/docs/de/tools/zoom.mdx | 250 ++++ apps/docs/content/docs/es/tools/ahrefs.mdx | 199 +++ apps/docs/content/docs/es/tools/datadog.mdx | 302 ++++ apps/docs/content/docs/es/tools/dropbox.mdx | 219 +++ .../content/docs/es/tools/elasticsearch.mdx | 365 +++++ apps/docs/content/docs/es/tools/gitlab.mdx | 429 ++++++ apps/docs/content/docs/es/tools/grafana.mdx | 494 +++++++ apps/docs/content/docs/es/tools/kalshi.mdx | 295 ++++ .../docs/content/docs/es/tools/polymarket.mdx | 352 +++++ apps/docs/content/docs/es/tools/pylon.mdx | 20 +- apps/docs/content/docs/es/tools/shopify.mdx | 444 ++++++ apps/docs/content/docs/es/tools/ssh.mdx | 394 ++++++ apps/docs/content/docs/es/tools/wordpress.mdx | 566 ++++++++ apps/docs/content/docs/es/tools/zendesk.mdx | 3 + apps/docs/content/docs/es/tools/zoom.mdx | 250 ++++ apps/docs/content/docs/fr/tools/ahrefs.mdx | 199 +++ apps/docs/content/docs/fr/tools/datadog.mdx | 302 ++++ apps/docs/content/docs/fr/tools/dropbox.mdx | 219 +++ .../content/docs/fr/tools/elasticsearch.mdx | 365 +++++ apps/docs/content/docs/fr/tools/gitlab.mdx | 430 ++++++ apps/docs/content/docs/fr/tools/grafana.mdx | 494 +++++++ apps/docs/content/docs/fr/tools/kalshi.mdx | 295 ++++ .../docs/content/docs/fr/tools/polymarket.mdx | 352 +++++ apps/docs/content/docs/fr/tools/pylon.mdx | 26 +- apps/docs/content/docs/fr/tools/shopify.mdx | 445 ++++++ apps/docs/content/docs/fr/tools/ssh.mdx | 394 ++++++ apps/docs/content/docs/fr/tools/wordpress.mdx | 566 ++++++++ apps/docs/content/docs/fr/tools/zendesk.mdx | 11 +- apps/docs/content/docs/fr/tools/zoom.mdx | 250 ++++ apps/docs/content/docs/ja/tools/ahrefs.mdx | 199 +++ apps/docs/content/docs/ja/tools/datadog.mdx | 302 ++++ apps/docs/content/docs/ja/tools/dropbox.mdx | 219 +++ .../content/docs/ja/tools/elasticsearch.mdx | 365 +++++ apps/docs/content/docs/ja/tools/gitlab.mdx | 429 ++++++ apps/docs/content/docs/ja/tools/grafana.mdx | 494 +++++++ apps/docs/content/docs/ja/tools/kalshi.mdx | 295 ++++ .../docs/content/docs/ja/tools/polymarket.mdx | 352 +++++ apps/docs/content/docs/ja/tools/pylon.mdx | 18 +- apps/docs/content/docs/ja/tools/shopify.mdx | 444 ++++++ apps/docs/content/docs/ja/tools/ssh.mdx | 394 ++++++ apps/docs/content/docs/ja/tools/wordpress.mdx | 566 ++++++++ apps/docs/content/docs/ja/tools/zendesk.mdx | 5 +- apps/docs/content/docs/ja/tools/zoom.mdx | 250 ++++ apps/docs/content/docs/zh/tools/ahrefs.mdx | 199 +++ apps/docs/content/docs/zh/tools/datadog.mdx | 302 ++++ apps/docs/content/docs/zh/tools/dropbox.mdx | 219 +++ .../content/docs/zh/tools/elasticsearch.mdx | 365 +++++ apps/docs/content/docs/zh/tools/gitlab.mdx | 429 ++++++ apps/docs/content/docs/zh/tools/grafana.mdx | 494 +++++++ apps/docs/content/docs/zh/tools/kalshi.mdx | 295 ++++ .../docs/content/docs/zh/tools/polymarket.mdx | 352 +++++ apps/docs/content/docs/zh/tools/pylon.mdx | 14 +- apps/docs/content/docs/zh/tools/shopify.mdx | 444 ++++++ apps/docs/content/docs/zh/tools/ssh.mdx | 394 ++++++ apps/docs/content/docs/zh/tools/wordpress.mdx | 566 ++++++++ apps/docs/content/docs/zh/tools/zendesk.mdx | 5 +- apps/docs/content/docs/zh/tools/zoom.mdx | 250 ++++ apps/docs/i18n.lock | 1260 ++++++++++++++++- apps/docs/next.config.ts | 4 + apps/docs/package.json | 2 +- bun.lock | 4 + 74 files changed, 22916 insertions(+), 42 deletions(-) create mode 100644 apps/docs/content/docs/de/tools/ahrefs.mdx create mode 100644 apps/docs/content/docs/de/tools/datadog.mdx create mode 100644 apps/docs/content/docs/de/tools/dropbox.mdx create mode 100644 apps/docs/content/docs/de/tools/elasticsearch.mdx create mode 100644 apps/docs/content/docs/de/tools/gitlab.mdx create mode 100644 apps/docs/content/docs/de/tools/grafana.mdx create mode 100644 apps/docs/content/docs/de/tools/kalshi.mdx create mode 100644 apps/docs/content/docs/de/tools/polymarket.mdx create mode 100644 apps/docs/content/docs/de/tools/shopify.mdx create mode 100644 apps/docs/content/docs/de/tools/ssh.mdx create mode 100644 apps/docs/content/docs/de/tools/wordpress.mdx create mode 100644 apps/docs/content/docs/de/tools/zoom.mdx create mode 100644 apps/docs/content/docs/es/tools/ahrefs.mdx create mode 100644 apps/docs/content/docs/es/tools/datadog.mdx create mode 100644 apps/docs/content/docs/es/tools/dropbox.mdx create mode 100644 apps/docs/content/docs/es/tools/elasticsearch.mdx create mode 100644 apps/docs/content/docs/es/tools/gitlab.mdx create mode 100644 apps/docs/content/docs/es/tools/grafana.mdx create mode 100644 apps/docs/content/docs/es/tools/kalshi.mdx create mode 100644 apps/docs/content/docs/es/tools/polymarket.mdx create mode 100644 apps/docs/content/docs/es/tools/shopify.mdx create mode 100644 apps/docs/content/docs/es/tools/ssh.mdx create mode 100644 apps/docs/content/docs/es/tools/wordpress.mdx create mode 100644 apps/docs/content/docs/es/tools/zoom.mdx create mode 100644 apps/docs/content/docs/fr/tools/ahrefs.mdx create mode 100644 apps/docs/content/docs/fr/tools/datadog.mdx create mode 100644 apps/docs/content/docs/fr/tools/dropbox.mdx create mode 100644 apps/docs/content/docs/fr/tools/elasticsearch.mdx create mode 100644 apps/docs/content/docs/fr/tools/gitlab.mdx create mode 100644 apps/docs/content/docs/fr/tools/grafana.mdx create mode 100644 apps/docs/content/docs/fr/tools/kalshi.mdx create mode 100644 apps/docs/content/docs/fr/tools/polymarket.mdx create mode 100644 apps/docs/content/docs/fr/tools/shopify.mdx create mode 100644 apps/docs/content/docs/fr/tools/ssh.mdx create mode 100644 apps/docs/content/docs/fr/tools/wordpress.mdx create mode 100644 apps/docs/content/docs/fr/tools/zoom.mdx create mode 100644 apps/docs/content/docs/ja/tools/ahrefs.mdx create mode 100644 apps/docs/content/docs/ja/tools/datadog.mdx create mode 100644 apps/docs/content/docs/ja/tools/dropbox.mdx create mode 100644 apps/docs/content/docs/ja/tools/elasticsearch.mdx create mode 100644 apps/docs/content/docs/ja/tools/gitlab.mdx create mode 100644 apps/docs/content/docs/ja/tools/grafana.mdx create mode 100644 apps/docs/content/docs/ja/tools/kalshi.mdx create mode 100644 apps/docs/content/docs/ja/tools/polymarket.mdx create mode 100644 apps/docs/content/docs/ja/tools/shopify.mdx create mode 100644 apps/docs/content/docs/ja/tools/ssh.mdx create mode 100644 apps/docs/content/docs/ja/tools/wordpress.mdx create mode 100644 apps/docs/content/docs/ja/tools/zoom.mdx create mode 100644 apps/docs/content/docs/zh/tools/ahrefs.mdx create mode 100644 apps/docs/content/docs/zh/tools/datadog.mdx create mode 100644 apps/docs/content/docs/zh/tools/dropbox.mdx create mode 100644 apps/docs/content/docs/zh/tools/elasticsearch.mdx create mode 100644 apps/docs/content/docs/zh/tools/gitlab.mdx create mode 100644 apps/docs/content/docs/zh/tools/grafana.mdx create mode 100644 apps/docs/content/docs/zh/tools/kalshi.mdx create mode 100644 apps/docs/content/docs/zh/tools/polymarket.mdx create mode 100644 apps/docs/content/docs/zh/tools/shopify.mdx create mode 100644 apps/docs/content/docs/zh/tools/ssh.mdx create mode 100644 apps/docs/content/docs/zh/tools/wordpress.mdx create mode 100644 apps/docs/content/docs/zh/tools/zoom.mdx diff --git a/apps/docs/content/docs/de/tools/ahrefs.mdx b/apps/docs/content/docs/de/tools/ahrefs.mdx new file mode 100644 index 000000000..5fa8a47d6 --- /dev/null +++ b/apps/docs/content/docs/de/tools/ahrefs.mdx @@ -0,0 +1,199 @@ +--- +title: Ahrefs +description: SEO-Analyse mit Ahrefs +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Ahrefs](https://ahrefs.com/) ist ein führendes SEO-Toolset zur Analyse von Websites, Verfolgung von Rankings, Überwachung von Backlinks und Keyword-Recherche. Es bietet detaillierte Einblicke in Ihre eigene Website sowie in die Ihrer Wettbewerber und hilft Ihnen, datengestützte Entscheidungen zur Verbesserung Ihrer Sichtbarkeit in Suchmaschinen zu treffen. + +Mit der Ahrefs-Integration in Sim können Sie: + +- **Domain Rating & Autorität analysieren**: Überprüfen Sie sofort die Domain Rating (DR) und den Ahrefs Rank jeder Website, um deren Autorität einzuschätzen. +- **Backlinks abrufen**: Rufen Sie eine Liste von Backlinks ab, die auf eine Website oder eine bestimmte URL verweisen, mit Details wie Ankertext, DR der verweisenden Seite und mehr. +- **Backlink-Statistiken erhalten**: Greifen Sie auf Metriken zu Backlink-Typen (dofollow, nofollow, Text, Bild, Weiterleitung usw.) für eine Domain oder URL zu. +- **Organische Keywords erkunden** *(geplant)*: Sehen Sie, für welche Keywords eine Domain rankt und welche Positionen sie in den Google-Suchergebnissen einnimmt. +- **Top-Seiten entdecken** *(geplant)*: Identifizieren Sie die leistungsstärksten Seiten nach organischem Traffic und Links. + +Diese Tools ermöglichen es Ihren Agenten, SEO-Recherchen zu automatisieren, Wettbewerber zu überwachen und Berichte zu erstellen – alles als Teil Ihrer Workflow-Automatisierungen. Um die Ahrefs-Integration zu nutzen, benötigen Sie ein Ahrefs Enterprise-Abonnement mit API-Zugang. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanleitung + +Integrieren Sie Ahrefs SEO-Tools in Ihren Workflow. Analysieren Sie Domain-Ratings, Backlinks, organische Keywords, Top-Seiten und mehr. Erfordert einen Ahrefs Enterprise-Plan mit API-Zugang. + +## Tools + +### `ahrefs_domain_rating` + +Erhalten Sie die Domain Rating (DR) und den Ahrefs Rank für eine Zieldomain. Die Domain Rating zeigt die Stärke einer Website + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `target` | string | Ja | Die zu analysierende Zieldomäne (z.B. example.com) | +| `date` | string | Nein | Datum für historische Daten im Format YYYY-MM-DD (standardmäßig heute) | +| `apiKey` | string | Ja | Ahrefs API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `domainRating` | number | Domain Rating Score (0-100) | +| `ahrefsRank` | number | Ahrefs Rank - globales Ranking basierend auf der Stärke des Backlink-Profils | + +### `ahrefs_backlinks` + +Erhalte eine Liste von Backlinks, die auf eine Zieldomäne oder URL verweisen. Liefert Details zu jedem Backlink, einschließlich Quell-URL, Ankertext und Domain Rating. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `target` | string | Ja | Die zu analysierende Zieldomäne oder URL | +| `mode` | string | Nein | Analysemodus: domain (gesamte Domäne), prefix (URL-Präfix), subdomains (alle Subdomänen einschließen), exact (exakte URL-Übereinstimmung) | +| `date` | string | Nein | Datum für historische Daten im Format YYYY-MM-DD (standardmäßig heute) | +| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 100) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für Paginierung | +| `apiKey` | string | Ja | Ahrefs API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `backlinks` | array | Liste der Backlinks, die auf das Ziel verweisen | + +### `ahrefs_backlinks_stats` + +Ruft Backlink-Statistiken für eine Zieldomäne oder URL ab. Gibt Gesamtwerte für verschiedene Backlink-Typen zurück, einschließlich Dofollow-, Nofollow-, Text-, Bild- und Weiterleitungslinks. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `target` | string | Ja | Die zu analysierende Zieldomäne oder URL | +| `mode` | string | Nein | Analysemodus: domain \(gesamte Domäne\), prefix \(URL-Präfix\), subdomains \(alle Subdomänen einschließen\), exact \(exakte URL-Übereinstimmung\) | +| `date` | string | Nein | Datum für historische Daten im Format JJJJ-MM-TT \(standardmäßig heute\) | +| `apiKey` | string | Ja | Ahrefs API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `stats` | object | Zusammenfassung der Backlink-Statistiken | + +### `ahrefs_referring_domains` + +Ruft eine Liste von Domänen ab, die auf eine Zieldomäne oder URL verlinken. Gibt eindeutige verweisende Domänen mit ihrem Domain-Rating, Backlink-Anzahl und Entdeckungsdaten zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `target` | string | Ja | Die zu analysierende Zieldomäne oder URL | +| `mode` | string | Nein | Analysemodus: domain \(gesamte Domäne\), prefix \(URL-Präfix\), subdomains \(alle Subdomänen einschließen\), exact \(exakte URL-Übereinstimmung\) | +| `date` | string | Nein | Datum für historische Daten im Format JJJJ-MM-TT \(standardmäßig heute\) | +| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Ergebnisse \(Standard: 100\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für die Paginierung | +| `apiKey` | string | Ja | Ahrefs API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `referringDomains` | array | Liste der Domains, die auf das Ziel verlinken | + +### `ahrefs_organic_keywords` + +Erhalte organische Keywords, für die eine Zieldomain oder URL in den Google-Suchergebnissen rankt. Liefert Keyword-Details einschließlich Suchvolumen, Ranking-Position und geschätztem Traffic. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `target` | string | Ja | Die zu analysierende Zieldomain oder URL | +| `country` | string | Nein | Ländercode für Suchergebnisse \(z.B. us, gb, de\). Standard: us | +| `mode` | string | Nein | Analysemodus: domain \(gesamte Domain\), prefix \(URL-Präfix\), subdomains \(alle Subdomains einschließen\), exact \(exakte URL-Übereinstimmung\) | +| `date` | string | Nein | Datum für historische Daten im Format JJJJ-MM-TT \(standardmäßig heute\) | +| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Ergebnisse \(Standard: 100\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für Paginierung | +| `apiKey` | string | Ja | Ahrefs API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `keywords` | array | Liste der organischen Keywords, für die das Ziel rankt | + +### `ahrefs_top_pages` + +Erhalte die Top-Seiten einer Zieldomain, sortiert nach organischem Traffic. Liefert Seiten-URLs mit ihrem Traffic, Keyword-Anzahl und geschätztem Traffic-Wert. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `target` | string | Ja | Die zu analysierende Zieldomäne | +| `country` | string | Nein | Ländercode für Verkehrsdaten \(z.B. us, gb, de\). Standard: us | +| `mode` | string | Nein | Analysemodus: domain \(gesamte Domain\), prefix \(URL-Präfix\), subdomains \(alle Subdomains einschließen\) | +| `date` | string | Nein | Datum für historische Daten im Format JJJJ-MM-TT \(standardmäßig heute\) | +| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Ergebnisse \(Standard: 100\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für Paginierung | +| `apiKey` | string | Ja | Ahrefs API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `pages` | array | Liste der Top-Seiten nach organischem Traffic | + +### `ahrefs_keyword_overview` + +Erhalten Sie detaillierte Metriken für ein Keyword, einschließlich Suchvolumen, Keyword-Schwierigkeit, CPC, Klicks und Traffic-Potenzial. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `keyword` | string | Ja | Das zu analysierende Keyword | +| `country` | string | Nein | Ländercode für Keyword-Daten \(z.B. us, gb, de\). Standard: us | +| `apiKey` | string | Ja | Ahrefs API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `overview` | object | Keyword-Metriken Übersicht | + +### `ahrefs_broken_backlinks` + +Erhalte eine Liste defekter Backlinks, die auf eine Zieldomäne oder URL verweisen. Nützlich zur Identifizierung von Möglichkeiten zur Link-Wiederherstellung. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `target` | string | Ja | Die zu analysierende Zieldomäne oder URL | +| `mode` | string | Nein | Analysemodus: domain \(gesamte Domäne\), prefix \(URL-Präfix\), subdomains \(alle Subdomänen einschließen\), exact \(exakte URL-Übereinstimmung\) | +| `date` | string | Nein | Datum für historische Daten im Format JJJJ-MM-TT \(standardmäßig heute\) | +| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Ergebnisse \(Standard: 100\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für Paginierung | +| `apiKey` | string | Ja | Ahrefs API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `brokenBacklinks` | array | Liste defekter Backlinks | + +## Hinweise + +- Kategorie: `tools` +- Typ: `ahrefs` diff --git a/apps/docs/content/docs/de/tools/datadog.mdx b/apps/docs/content/docs/de/tools/datadog.mdx new file mode 100644 index 000000000..b2d2cff70 --- /dev/null +++ b/apps/docs/content/docs/de/tools/datadog.mdx @@ -0,0 +1,302 @@ +--- +title: Datadog +description: Überwachen Sie Infrastruktur, Anwendungen und Logs mit Datadog +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Datadog](https://datadoghq.com/) ist eine umfassende Überwachungs- und Analyseplattform für Infrastruktur, Anwendungen, Logs und mehr. Sie ermöglicht Organisationen Echtzeit-Einblicke in den Zustand und die Leistung von Systemen, erkennt Anomalien und automatisiert die Reaktion auf Vorfälle. + +Mit Datadog können Sie: + +- **Metriken überwachen**: Sammeln, visualisieren und analysieren Sie Metriken von Servern, Cloud-Diensten und benutzerdefinierten Anwendungen. +- **Zeitreihendaten abfragen**: Führen Sie erweiterte Abfragen zu Leistungsmetriken für Trendanalysen und Berichte durch. +- **Monitore und Ereignisse verwalten**: Richten Sie Monitore ein, um Probleme zu erkennen, Warnungen auszulösen und Ereignisse für die Beobachtbarkeit zu erstellen. +- **Ausfallzeiten verwalten**: Planen und programmieren Sie geplante Ausfallzeiten, um Warnungen während der Wartung zu unterdrücken. +- **Logs und Traces analysieren** *(mit zusätzlicher Einrichtung in Datadog)*: Zentralisieren und untersuchen Sie Logs oder verteilte Traces für eine tiefere Fehlerbehebung. + +Die Datadog-Integration von Sim ermöglicht es Ihren Agenten, diese Vorgänge zu automatisieren und programmatisch mit Ihrem Datadog-Konto zu interagieren. Verwenden Sie sie, um benutzerdefinierte Metriken zu übermitteln, Zeitreihendaten abzufragen, Monitore zu verwalten, Ereignisse zu erstellen und Ihre Überwachungsabläufe direkt innerhalb von Sim-Automatisierungen zu optimieren. +{/* MANUAL-CONTENT-END */} + +## Gebrauchsanweisung + +Integrieren Sie Datadog-Überwachung in Workflows. Übermitteln Sie Metriken, verwalten Sie Monitore, fragen Sie Logs ab, erstellen Sie Ereignisse, handhaben Sie Ausfallzeiten und mehr. + +## Tools + +### `datadog_submit_metrics` + +Übermitteln Sie benutzerdefinierte Metriken an Datadog. Verwenden Sie diese zur Verfolgung der Anwendungsleistung, Geschäftsmetriken oder benutzerdefinierten Überwachungsdaten. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `series` | string | Ja | JSON-Array von Metrikserien zur Übermittlung. Jede Serie sollte den Metriknamen, Typ \(gauge/rate/count\), Punkte \(Zeitstempel/Wert-Paare\) und optionale Tags enthalten. | +| `apiKey` | string | Ja | Datadog API-Schlüssel | +| `site` | string | Nein | Datadog-Site/Region \(Standard: datadoghq.com\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Ob die Metriken erfolgreich übermittelt wurden | +| `errors` | array | Alle Fehler, die während der Übermittlung aufgetreten sind | + +### `datadog_query_timeseries` + +Abfrage von Metrik-Zeitreihendaten aus Datadog. Verwenden Sie dies zur Analyse von Trends, zur Erstellung von Berichten oder zum Abrufen von Metrikwerten. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `query` | string | Ja | Datadog-Metrikabfrage (z.B. "avg:system.cpu.user\{*\}") | +| `from` | number | Ja | Startzeit als Unix-Zeitstempel in Sekunden | +| `to` | number | Ja | Endzeit als Unix-Zeitstempel in Sekunden | +| `apiKey` | string | Ja | Datadog API-Schlüssel | +| `applicationKey` | string | Ja | Datadog Anwendungsschlüssel | +| `site` | string | Nein | Datadog-Site/Region (Standard: datadoghq.com) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `series` | array | Array von Zeitreihendaten mit Metrikname, Tags und Datenpunkten | +| `status` | string | Abfragestatus | + +### `datadog_create_event` + +Veröffentlichen Sie ein Ereignis im Datadog-Ereignisstrom. Verwenden Sie dies für Deployment-Benachrichtigungen, Warnungen oder andere wichtige Vorkommnisse. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `title` | string | Ja | Ereignistitel | +| `text` | string | Ja | Ereignistext/Beschreibung. Unterstützt Markdown. | +| `alertType` | string | Nein | Warnungstyp: error, warning, info, success, user_update, recommendation oder snapshot | +| `priority` | string | Nein | Ereignispriorität: normal oder low | +| `host` | string | Nein | Hostname, der mit diesem Ereignis verknüpft werden soll | +| `tags` | string | Nein | Kommagetrennte Liste von Tags (z.B. "env:production,service:api") | +| `aggregationKey` | string | Nein | Schlüssel zum Zusammenfassen von Ereignissen | +| `sourceTypeName` | string | Nein | Quelltypname für das Ereignis | +| `dateHappened` | number | Nein | Unix-Zeitstempel, wann das Ereignis aufgetreten ist (standardmäßig jetzt) | +| `apiKey` | string | Ja | Datadog API-Schlüssel | +| `site` | string | Nein | Datadog-Site/Region (Standard: datadoghq.com) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `event` | object | Die Details des erstellten Events | + +### `datadog_create_monitor` + +Erstellen Sie einen neuen Monitor/Alert in Datadog. Monitore können Metriken, Service-Checks, Events und mehr überwachen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `name` | string | Ja | Name des Monitors | +| `type` | string | Ja | Monitor-Typ: metric alert, service check, event alert, process alert, log alert, query alert, composite, synthetics alert, slo alert | +| `query` | string | Ja | Monitor-Abfrage (z.B. `avg(last_5m):avg:system.cpu.idle{*} < 20`) | +| `message` | string | Nein | Nachricht, die bei Benachrichtigungen enthalten sein soll. Kann @-Erwähnungen und Markdown enthalten. | +| `tags` | string | Nein | Kommagetrennte Liste von Tags | +| `priority` | number | Nein | Monitor-Priorität (1-5, wobei 1 die höchste ist) | +| `options` | string | Nein | JSON-String mit Monitor-Optionen (Schwellenwerte, notify_no_data, renotify_interval, usw.) | +| `apiKey` | string | Ja | Datadog API-Schlüssel | +| `applicationKey` | string | Ja | Datadog Anwendungsschlüssel | +| `site` | string | Nein | Datadog Site/Region (Standard: datadoghq.com) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `monitor` | object | Die Details des erstellten Monitors | + +### `datadog_get_monitor` + +Rufen Sie Details eines bestimmten Monitors anhand seiner ID ab. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `monitorId` | string | Ja | Die ID des abzurufenden Monitors | +| `groupStates` | string | Nein | Kommagetrennte Gruppenzustände, die einbezogen werden sollen: alert, warn, no data, ok | +| `withDowntimes` | boolean | Nein | Downtime-Daten mit dem Monitor einbeziehen | +| `apiKey` | string | Ja | Datadog API-Schlüssel | +| `applicationKey` | string | Ja | Datadog Anwendungsschlüssel | +| `site` | string | Nein | Datadog Site/Region (Standard: datadoghq.com) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `monitor` | object | Die Monitor-Details | + +### `datadog_list_monitors` + +Listet alle Monitore in Datadog auf, mit optionaler Filterung nach Namen, Tags oder Status. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `groupStates` | string | Nein | Kommagetrennte Gruppenstatus zur Filterung: alert, warn, no data, ok | +| `name` | string | Nein | Filtert Monitore nach Namen \(teilweise Übereinstimmung\) | +| `tags` | string | Nein | Kommagetrennte Liste von Tags zur Filterung | +| `monitorTags` | string | Nein | Kommagetrennte Liste von Monitor-Tags zur Filterung | +| `withDowntimes` | boolean | Nein | Downtime-Daten mit Monitoren einbeziehen | +| `page` | number | Nein | Seitennummer für Paginierung \(0-indiziert\) | +| `pageSize` | number | Nein | Anzahl der Monitore pro Seite \(max. 1000\) | +| `apiKey` | string | Ja | Datadog API-Schlüssel | +| `applicationKey` | string | Ja | Datadog Anwendungsschlüssel | +| `site` | string | Nein | Datadog Site/Region \(Standard: datadoghq.com\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `monitors` | array | Liste der Monitore | + +### `datadog_mute_monitor` + +Stummschalten eines Monitors, um Benachrichtigungen vorübergehend zu unterdrücken. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `monitorId` | string | Ja | Die ID des stummzuschaltenden Monitors | +| `scope` | string | Nein | Bereich zum Stummschalten \(z.B. "host:myhost"\). Wenn nicht angegeben, werden alle Bereiche stummgeschaltet. | +| `end` | number | Nein | Unix-Zeitstempel, wann die Stummschaltung enden soll. Wenn nicht angegeben, wird auf unbestimmte Zeit stummgeschaltet. | +| `apiKey` | string | Ja | Datadog API-Schlüssel | +| `applicationKey` | string | Ja | Datadog Anwendungsschlüssel | +| `site` | string | Nein | Datadog Site/Region \(Standard: datadoghq.com\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Gibt an, ob der Monitor erfolgreich stummgeschaltet wurde | + +### `datadog_query_logs` + +Suchen und abrufen von Logs aus Datadog. Verwenden Sie dies zur Fehlerbehebung, Analyse oder Überwachung. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `query` | string | Ja | Log-Suchabfrage (z.B. "service:web-app status:error") | +| `from` | string | Ja | Startzeit im ISO-8601-Format oder relativ (z.B. "now-1h") | +| `to` | string | Ja | Endzeit im ISO-8601-Format oder relativ (z.B. "now") | +| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Logs (Standard: 50, max: 1000) | +| `sort` | string | Nein | Sortierreihenfolge: timestamp (älteste zuerst) oder -timestamp (neueste zuerst) | +| `indexes` | string | Nein | Kommagetrennte Liste der zu durchsuchenden Log-Indizes | +| `apiKey` | string | Ja | Datadog API-Schlüssel | +| `applicationKey` | string | Ja | Datadog Anwendungsschlüssel | +| `site` | string | Nein | Datadog Site/Region (Standard: datadoghq.com) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `logs` | array | Liste der Log-Einträge | + +### `datadog_send_logs` + +Senden von Log-Einträgen an Datadog für zentralisiertes Logging und Analyse. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `logs` | string | Ja | JSON-Array von Log-Einträgen. Jeder Eintrag sollte message und optional ddsource, ddtags, hostname, service enthalten. | +| `apiKey` | string | Ja | Datadog API-Schlüssel | +| `site` | string | Nein | Datadog Site/Region (Standard: datadoghq.com) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Ob die Logs erfolgreich gesendet wurden | + +### `datadog_create_downtime` + +Planen Sie eine Ausfallzeit, um Monitor-Benachrichtigungen während Wartungsfenstern zu unterdrücken. + +#### Input + +| Parameter | Type | Required | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `scope` | string | Yes | Bereich, auf den die Ausfallzeit angewendet werden soll (z.B. "host:myhost", "env:production" oder "*" für alle) | +| `message` | string | No | Nachricht, die während der Ausfallzeit angezeigt werden soll | +| `start` | number | No | Unix-Zeitstempel für den Beginn der Ausfallzeit (standardmäßig jetzt) | +| `end` | number | No | Unix-Zeitstempel für das Ende der Ausfallzeit | +| `timezone` | string | No | Zeitzone für die Ausfallzeit (z.B. "America/New_York") | +| `monitorId` | string | No | Spezifische Monitor-ID, die stummgeschaltet werden soll | +| `monitorTags` | string | No | Kommagetrennte Monitor-Tags zur Übereinstimmung (z.B. "team:backend,priority:high") | +| `muteFirstRecoveryNotification` | boolean | No | Die erste Wiederherstellungsbenachrichtigung stummschalten | +| `apiKey` | string | Yes | Datadog API-Schlüssel | +| `applicationKey` | string | Yes | Datadog Anwendungsschlüssel | +| `site` | string | No | Datadog Site/Region (Standard: datadoghq.com) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `downtime` | object | Die Details der erstellten Ausfallzeit | + +### `datadog_list_downtimes` + +Listet alle geplanten Ausfallzeiten in Datadog auf. + +#### Input + +| Parameter | Type | Required | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `currentOnly` | boolean | No | Nur aktuell aktive Ausfallzeiten zurückgeben | +| `monitorId` | string | No | Nach Monitor-ID filtern | +| `apiKey` | string | Yes | Datadog API-Schlüssel | +| `applicationKey` | string | Yes | Datadog Anwendungsschlüssel | +| `site` | string | No | Datadog Site/Region (Standard: datadoghq.com) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `downtimes` | array | Liste der Ausfallzeiten | + +### `datadog_cancel_downtime` + +Eine geplante Ausfallzeit abbrechen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `downtimeId` | string | Ja | Die ID der abzubrechenden Ausfallzeit | +| `apiKey` | string | Ja | Datadog API-Schlüssel | +| `applicationKey` | string | Ja | Datadog Anwendungsschlüssel | +| `site` | string | Nein | Datadog Site/Region \(Standard: datadoghq.com\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Ob die Ausfallzeit erfolgreich abgebrochen wurde | + +## Hinweise + +- Kategorie: `tools` +- Typ: `datadog` diff --git a/apps/docs/content/docs/de/tools/dropbox.mdx b/apps/docs/content/docs/de/tools/dropbox.mdx new file mode 100644 index 000000000..91dc35f20 --- /dev/null +++ b/apps/docs/content/docs/de/tools/dropbox.mdx @@ -0,0 +1,219 @@ +--- +title: Dropbox +description: Dateien in Dropbox hochladen, herunterladen, teilen und verwalten +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Dropbox](https://dropbox.com/) ist eine beliebte Cloud-Speicher- und Kollaborationsplattform, die es Einzelpersonen und Teams ermöglicht, Dateien sicher zu speichern, darauf zuzugreifen und sie von überall aus zu teilen. Dropbox ist für einfache Dateiverwaltung, Synchronisierung und leistungsstarke Zusammenarbeit konzipiert, egal ob Sie allein oder in einer Gruppe arbeiten. + +Mit Dropbox in Sim können Sie: + +- **Dateien hoch- und herunterladen**: Laden Sie jede Datei nahtlos in Ihre Dropbox hoch oder rufen Sie Inhalte bei Bedarf ab +- **Ordnerinhalte auflisten**: Durchsuchen Sie die Dateien und Ordner in jedem Dropbox-Verzeichnis +- **Neue Ordner erstellen**: Organisieren Sie Ihre Dateien, indem Sie programmgesteuert neue Ordner in Ihrer Dropbox erstellen +- **Dateien und Ordner suchen**: Finden Sie Dokumente, Bilder oder andere Elemente nach Namen oder Inhalt +- **Geteilte Links generieren**: Erstellen Sie schnell teilbare öffentliche oder private Links für Dateien und Ordner +- **Dateien verwalten**: Verschieben, löschen oder benennen Sie Dateien und Ordner im Rahmen automatisierter Workflows um + +Diese Funktionen ermöglichen es Ihren Sim-Agenten, Dropbox-Operationen direkt in Ihren Workflows zu automatisieren – vom Sichern wichtiger Dateien bis hin zur Verteilung von Inhalten und der Pflege organisierter Ordner. Verwenden Sie Dropbox sowohl als Quelle als auch als Ziel für Dateien und ermöglichen Sie so eine nahtlose Cloud-Speicherverwaltung als Teil Ihrer Geschäftsprozesse. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanweisungen + +Integrieren Sie Dropbox in Ihren Workflow für Dateiverwaltung, Freigabe und Zusammenarbeit. Laden Sie Dateien hoch, laden Sie Inhalte herunter, erstellen Sie Ordner, verwalten Sie freigegebene Links und mehr. + +## Tools + +### `dropbox_upload` + +Eine Datei zu Dropbox hochladen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `path` | string | Ja | Der Pfad in Dropbox, wo die Datei gespeichert werden soll \(z.B. /ordner/dokument.pdf\) | +| `fileContent` | string | Ja | Der base64-kodierte Inhalt der hochzuladenden Datei | +| `fileName` | string | Nein | Optionaler Dateiname \(wird verwendet, wenn der Pfad ein Ordner ist\) | +| `mode` | string | Nein | Schreibmodus: add \(Standard\) oder overwrite | +| `autorename` | boolean | Nein | Wenn true, wird die Datei umbenannt, falls ein Konflikt besteht | +| `mute` | boolean | Nein | Wenn true, wird der Benutzer nicht über diesen Upload benachrichtigt | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `file` | object | Die Metadaten der hochgeladenen Datei | + +### `dropbox_download` + +Eine Datei von Dropbox herunterladen und einen temporären Link erhalten + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `path` | string | Ja | Der Pfad der herunterzuladenden Datei (z.B. /ordner/dokument.pdf) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `file` | object | Die Metadaten der Datei | + +### `dropbox_list_folder` + +Den Inhalt eines Ordners in Dropbox auflisten + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `path` | string | Ja | Der Pfad des aufzulistenden Ordners (verwende "" für das Stammverzeichnis) | +| `recursive` | boolean | Nein | Wenn true, Inhalte rekursiv auflisten | +| `includeDeleted` | boolean | Nein | Wenn true, gelöschte Dateien/Ordner einbeziehen | +| `includeMediaInfo` | boolean | Nein | Wenn true, Medieninfos für Fotos/Videos einbeziehen | +| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 500) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `entries` | array | Liste der Dateien und Ordner im Verzeichnis | + +### `dropbox_create_folder` + +Einen neuen Ordner in Dropbox erstellen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `path` | string | Ja | Der Pfad, an dem der Ordner erstellt werden soll (z.B. /neuer-ordner) | +| `autorename` | boolean | Nein | Wenn true, den Ordner umbenennen, falls ein Konflikt besteht | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `folder` | object | Die Metadaten des erstellten Ordners | + +### `dropbox_delete` + +Eine Datei oder einen Ordner in Dropbox löschen (wird in den Papierkorb verschoben) + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `path` | string | Ja | Der Pfad der zu löschenden Datei oder des zu löschenden Ordners | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `metadata` | object | Metadaten des gelöschten Elements | + +### `dropbox_copy` + +Eine Datei oder einen Ordner in Dropbox kopieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `fromPath` | string | Ja | Der Quellpfad der zu kopierenden Datei oder des zu kopierenden Ordners | +| `toPath` | string | Ja | Der Zielpfad für die kopierte Datei oder den kopierten Ordner | +| `autorename` | boolean | Nein | Wenn true, wird die Datei umbenannt, falls am Zielort ein Konflikt besteht | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `metadata` | object | Metadaten des kopierten Elements | + +### `dropbox_move` + +Eine Datei oder einen Ordner in Dropbox verschieben oder umbenennen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `fromPath` | string | Ja | Der Quellpfad der zu verschiebenden Datei oder des zu verschiebenden Ordners | +| `toPath` | string | Ja | Der Zielpfad für die verschobene Datei oder den verschobenen Ordner | +| `autorename` | boolean | Nein | Wenn true, wird die Datei umbenannt, falls am Zielort ein Konflikt besteht | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `metadata` | object | Metadaten des verschobenen Elements | + +### `dropbox_get_metadata` + +Metadaten für eine Datei oder einen Ordner in Dropbox abrufen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `path` | string | Ja | Der Pfad der Datei oder des Ordners, für die/den Metadaten abgerufen werden sollen | +| `includeMediaInfo` | boolean | Nein | Wenn true, werden Medieninformationen für Fotos/Videos einbezogen | +| `includeDeleted` | boolean | Nein | Wenn true, werden gelöschte Dateien in den Ergebnissen einbezogen | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `metadata` | object | Metadaten für die Datei oder den Ordner | + +### `dropbox_create_shared_link` + +Einen teilbaren Link für eine Datei oder einen Ordner in Dropbox erstellen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `path` | string | Ja | Der Pfad der Datei oder des Ordners, der geteilt werden soll | +| `requestedVisibility` | string | Nein | Sichtbarkeit: public, team_only oder password | +| `linkPassword` | string | Nein | Passwort für den geteilten Link \(nur wenn die Sichtbarkeit password ist\) | +| `expires` | string | Nein | Ablaufdatum im ISO 8601-Format \(z.B. 2025-12-31T23:59:59Z\) | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `sharedLink` | object | Der erstellte geteilte Link | + +### `dropbox_search` + +Suche nach Dateien und Ordnern in Dropbox + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `query` | string | Ja | Die Suchanfrage | +| `path` | string | Nein | Suche auf einen bestimmten Ordnerpfad beschränken | +| `fileExtensions` | string | Nein | Kommagetrennte Liste von Dateierweiterungen zur Filterung \(z.B. pdf,xlsx\) | +| `maxResults` | number | Nein | Maximale Anzahl der zurückzugebenden Ergebnisse \(Standard: 100\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `matches` | array | Suchergebnisse | + +## Hinweise + +- Kategorie: `tools` +- Typ: `dropbox` diff --git a/apps/docs/content/docs/de/tools/elasticsearch.mdx b/apps/docs/content/docs/de/tools/elasticsearch.mdx new file mode 100644 index 000000000..e234cde52 --- /dev/null +++ b/apps/docs/content/docs/de/tools/elasticsearch.mdx @@ -0,0 +1,365 @@ +--- +title: Elasticsearch +description: Suchen, indexieren und verwalten Sie Daten in Elasticsearch +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Elasticsearch](https://www.elastic.co/elasticsearch/) ist eine leistungsstarke verteilte Such- und Analysemaschine, die es Ihnen ermöglicht, große Datenmengen in Echtzeit zu indexieren, zu durchsuchen und zu analysieren. Sie wird häufig für Suchfunktionen, Log- und Ereignisdatenanalysen, Beobachtbarkeit und mehr eingesetzt. + +Mit Elasticsearch in Sim erhalten Sie programmatischen Zugriff auf die Kernfunktionen von Elasticsearch, darunter: + +- **Dokumente durchsuchen**: Führen Sie erweiterte Suchen in strukturiertem oder unstrukturiertem Text mit Query DSL durch, mit Unterstützung für Sortierung, Paginierung und Feldauswahl. +- **Dokumente indexieren**: Fügen Sie neue Dokumente hinzu oder aktualisieren Sie bestehende in jedem Elasticsearch-Index für sofortigen Abruf und Analyse. +- **Dokumente abrufen, aktualisieren oder löschen**: Rufen Sie bestimmte Dokumente nach ID ab, ändern oder entfernen Sie sie. +- **Massenoperationen**: Führen Sie mehrere Indexierungs- oder Aktualisierungsaktionen in einer einzigen Anfrage für Datenverarbeitung mit hohem Durchsatz aus. +- **Indizes verwalten**: Erstellen, löschen oder rufen Sie Details zu Indizes als Teil Ihrer Workflow-Automatisierung ab. +- **Cluster-Überwachung**: Überprüfen Sie den Zustand und die Statistiken Ihrer Elasticsearch-Bereitstellung. + +Sims Elasticsearch-Tools funktionieren sowohl mit selbst gehosteten als auch mit Elastic Cloud-Umgebungen. Integrieren Sie Elasticsearch in Ihre Agent-Workflows, um die Datenaufnahme zu automatisieren, große Datensätze zu durchsuchen, Berichte zu erstellen oder benutzerdefinierte, suchgestützte Anwendungen zu erstellen – alles ohne manuelle Eingriffe. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanweisungen + +Integrieren Sie Elasticsearch in Workflows für leistungsstarke Suche, Indexierung und Datenverwaltung. Unterstützt CRUD-Operationen für Dokumente, erweiterte Suchabfragen, Massenoperationen, Indexverwaltung und Cluster-Überwachung. Funktioniert sowohl mit selbst gehosteten als auch mit Elastic Cloud-Bereitstellungen. + +## Tools + +### `elasticsearch_search` + +Durchsuche Dokumente in Elasticsearch mit Query DSL. Gibt übereinstimmende Dokumente mit Scores und Metadaten zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Ja | Bereitstellungstyp: self_hosted oder cloud | +| `host` | string | Nein | Elasticsearch-Host-URL (für self-hosted) | +| `cloudId` | string | Nein | Elastic Cloud ID (für Cloud-Bereitstellungen) | +| `authMethod` | string | Ja | Authentifizierungsmethode: api_key oder basic_auth | +| `apiKey` | string | Nein | Elasticsearch API-Schlüssel | +| `username` | string | Nein | Benutzername für Basic Auth | +| `password` | string | Nein | Passwort für Basic Auth | +| `index` | string | Ja | Indexname für die Suche | +| `query` | string | Nein | Query DSL als JSON-String | +| `from` | number | Nein | Startoffset für Paginierung (Standard: 0) | +| `size` | number | Nein | Anzahl der zurückzugebenden Ergebnisse (Standard: 10) | +| `sort` | string | Nein | Sortierungsspezifikation als JSON-String | +| `sourceIncludes` | string | Nein | Kommagetrennte Liste von Feldern, die in _source eingeschlossen werden sollen | +| `sourceExcludes` | string | Nein | Kommagetrennte Liste von Feldern, die aus _source ausgeschlossen werden sollen | +| `trackTotalHits` | boolean | Nein | Genaue Gesamttrefferanzahl verfolgen (Standard: true) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `took` | number | Zeit in Millisekunden, die die Suche gedauert hat | +| `timed_out` | boolean | Ob die Suche ein Timeout hatte | +| `hits` | object | Suchergebnisse mit Gesamtanzahl und übereinstimmenden Dokumenten | +| `aggregations` | json | Aggregationsergebnisse, falls vorhanden | + +### `elasticsearch_index_document` + +Dokument in Elasticsearch indexieren (erstellen oder aktualisieren). + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Ja | Bereitstellungstyp: self_hosted oder cloud | +| `host` | string | Nein | Elasticsearch-Host-URL \(für self-hosted\) | +| `cloudId` | string | Nein | Elastic Cloud ID \(für Cloud-Bereitstellungen\) | +| `authMethod` | string | Ja | Authentifizierungsmethode: api_key oder basic_auth | +| `apiKey` | string | Nein | Elasticsearch API-Schlüssel | +| `username` | string | Nein | Benutzername für Basic-Auth | +| `password` | string | Nein | Passwort für Basic-Auth | +| `index` | string | Ja | Zielindexname | +| `documentId` | string | Nein | Dokument-ID \(wird automatisch generiert, wenn nicht angegeben\) | +| `document` | string | Ja | Dokumentinhalt als JSON-String | +| `refresh` | string | Nein | Aktualisierungsrichtlinie: true, false oder wait_for | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `_index` | string | Index, in dem das Dokument gespeichert wurde | +| `_id` | string | Dokument-ID | +| `_version` | number | Dokumentversion | +| `result` | string | Operationsergebnis \(erstellt oder aktualisiert\) | + +### `elasticsearch_get_document` + +Dokument anhand der ID aus Elasticsearch abrufen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Ja | Bereitstellungstyp: self_hosted oder cloud | +| `host` | string | Nein | Elasticsearch-Host-URL \(für self-hosted\) | +| `cloudId` | string | Nein | Elastic Cloud ID \(für Cloud-Bereitstellungen\) | +| `authMethod` | string | Ja | Authentifizierungsmethode: api_key oder basic_auth | +| `apiKey` | string | Nein | Elasticsearch API-Schlüssel | +| `username` | string | Nein | Benutzername für Basic-Auth | +| `password` | string | Nein | Passwort für Basic-Auth | +| `index` | string | Ja | Indexname | +| `documentId` | string | Ja | Abzurufende Dokument-ID | +| `sourceIncludes` | string | Nein | Kommagetrennte Liste der einzuschließenden Felder | +| `sourceExcludes` | string | Nein | Kommagetrennte Liste der auszuschließenden Felder | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `_index` | string | Indexname | +| `_id` | string | Dokument-ID | +| `_version` | number | Dokumentversion | +| `found` | boolean | Ob das Dokument gefunden wurde | +| `_source` | json | Dokumentinhalt | + +### `elasticsearch_update_document` + +Teilweise Aktualisierung eines Dokuments in Elasticsearch mittels Doc-Merge. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Ja | Bereitstellungstyp: self_hosted oder cloud | +| `host` | string | Nein | Elasticsearch-Host-URL (für self-hosted) | +| `cloudId` | string | Nein | Elastic Cloud ID (für Cloud-Bereitstellungen) | +| `authMethod` | string | Ja | Authentifizierungsmethode: api_key oder basic_auth | +| `apiKey` | string | Nein | Elasticsearch API-Schlüssel | +| `username` | string | Nein | Benutzername für Basic Auth | +| `password` | string | Nein | Passwort für Basic Auth | +| `index` | string | Ja | Indexname | +| `documentId` | string | Ja | Zu aktualisierende Dokument-ID | +| `document` | string | Ja | Teilweise Dokument zum Zusammenführen als JSON-String | +| `retryOnConflict` | number | Nein | Anzahl der Wiederholungen bei Versionskonflikten | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `_index` | string | Indexname | +| `_id` | string | Dokument-ID | +| `_version` | number | Neue Dokumentversion | +| `result` | string | Operationsergebnis (updated oder noop) | + +### `elasticsearch_delete_document` + +Löschen eines Dokuments aus Elasticsearch anhand der ID. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Ja | Bereitstellungstyp: self_hosted oder cloud | +| `host` | string | Nein | Elasticsearch-Host-URL \(für self-hosted\) | +| `cloudId` | string | Nein | Elastic Cloud ID \(für Cloud-Bereitstellungen\) | +| `authMethod` | string | Ja | Authentifizierungsmethode: api_key oder basic_auth | +| `apiKey` | string | Nein | Elasticsearch API-Schlüssel | +| `username` | string | Nein | Benutzername für Basic-Auth | +| `password` | string | Nein | Passwort für Basic-Auth | +| `index` | string | Ja | Index-Name | +| `documentId` | string | Ja | Dokument-ID zum Löschen | +| `refresh` | string | Nein | Aktualisierungsrichtlinie: true, false oder wait_for | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `_index` | string | Index-Name | +| `_id` | string | Dokument-ID | +| `_version` | number | Dokumentversion | +| `result` | string | Operationsergebnis \(deleted oder not_found\) | + +### `elasticsearch_bulk` + +Führen Sie mehrere Index-, Erstellungs-, Lösch- oder Aktualisierungsoperationen in einer einzigen Anfrage für hohe Leistung durch. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Ja | Bereitstellungstyp: self_hosted oder cloud | +| `host` | string | Nein | Elasticsearch-Host-URL \(für self-hosted\) | +| `cloudId` | string | Nein | Elastic Cloud ID \(für Cloud-Bereitstellungen\) | +| `authMethod` | string | Ja | Authentifizierungsmethode: api_key oder basic_auth | +| `apiKey` | string | Nein | Elasticsearch API-Schlüssel | +| `username` | string | Nein | Benutzername für Basic-Auth | +| `password` | string | Nein | Passwort für Basic-Auth | +| `index` | string | Nein | Standardindex für Operationen, die keinen angeben | +| `operations` | string | Ja | Massenoperationen als NDJSON-String \(zeilenweise abgegrenztes JSON\) | +| `refresh` | string | Nein | Aktualisierungsrichtlinie: true, false oder wait_for | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `took` | number | Zeit in Millisekunden, die der Massenvorgang gedauert hat | +| `errors` | boolean | Ob ein Vorgang einen Fehler hatte | +| `items` | array | Ergebnisse für jeden Vorgang | + +### `elasticsearch_count` + +Zählt Dokumente, die einer Abfrage in Elasticsearch entsprechen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Ja | Bereitstellungstyp: self_hosted oder cloud | +| `host` | string | Nein | Elasticsearch-Host-URL \(für self-hosted\) | +| `cloudId` | string | Nein | Elastic Cloud ID \(für Cloud-Bereitstellungen\) | +| `authMethod` | string | Ja | Authentifizierungsmethode: api_key oder basic_auth | +| `apiKey` | string | Nein | Elasticsearch API-Schlüssel | +| `username` | string | Nein | Benutzername für Basic-Auth | +| `password` | string | Nein | Passwort für Basic-Auth | +| `index` | string | Ja | Indexname, in dem Dokumente gezählt werden sollen | +| `query` | string | Nein | Optionale Abfrage zum Filtern von Dokumenten \(JSON-String\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `count` | number | Anzahl der Dokumente, die der Abfrage entsprechen | +| `_shards` | object | Shard-Statistiken | + +### `elasticsearch_create_index` + +Erstellt einen neuen Index mit optionalen Einstellungen und Mappings. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Ja | Bereitstellungstyp: self_hosted oder cloud | +| `host` | string | Nein | Elasticsearch-Host-URL \(für self-hosted\) | +| `cloudId` | string | Nein | Elastic Cloud ID \(für Cloud-Bereitstellungen\) | +| `authMethod` | string | Ja | Authentifizierungsmethode: api_key oder basic_auth | +| `apiKey` | string | Nein | Elasticsearch API-Schlüssel | +| `username` | string | Nein | Benutzername für Basic-Auth | +| `password` | string | Nein | Passwort für Basic-Auth | +| `index` | string | Ja | Zu erstellender Indexname | +| `settings` | string | Nein | Indexeinstellungen als JSON-String | +| `mappings` | string | Nein | Index-Mappings als JSON-String | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `acknowledged` | boolean | Ob die Anfrage bestätigt wurde | +| `shards_acknowledged` | boolean | Ob die Shards bestätigt wurden | +| `index` | string | Name des erstellten Index | + +### `elasticsearch_delete_index` + +Löscht einen Index und alle seine Dokumente. Dieser Vorgang ist nicht rückgängig zu machen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Ja | Bereitstellungstyp: self_hosted oder cloud | +| `host` | string | Nein | Elasticsearch-Host-URL \(für self-hosted\) | +| `cloudId` | string | Nein | Elastic Cloud ID \(für Cloud-Bereitstellungen\) | +| `authMethod` | string | Ja | Authentifizierungsmethode: api_key oder basic_auth | +| `apiKey` | string | Nein | Elasticsearch API-Schlüssel | +| `username` | string | Nein | Benutzername für Basic-Auth | +| `password` | string | Nein | Passwort für Basic-Auth | +| `index` | string | Ja | Name des zu löschenden Index | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `acknowledged` | boolean | Ob die Löschung bestätigt wurde | + +### `elasticsearch_get_index` + +Ruft Indexinformationen ab, einschließlich Einstellungen, Mappings und Aliase. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Ja | Bereitstellungstyp: self_hosted oder cloud | +| `host` | string | Nein | Elasticsearch-Host-URL \(für self-hosted\) | +| `cloudId` | string | Nein | Elastic Cloud ID \(für Cloud-Bereitstellungen\) | +| `authMethod` | string | Ja | Authentifizierungsmethode: api_key oder basic_auth | +| `apiKey` | string | Nein | Elasticsearch API-Schlüssel | +| `username` | string | Nein | Benutzername für Basic-Auth | +| `password` | string | Nein | Passwort für Basic-Auth | +| `index` | string | Ja | Name des Index, für den Informationen abgerufen werden sollen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `index` | json | Indexinformationen einschließlich Aliase, Mappings und Einstellungen | + +### `elasticsearch_cluster_health` + +Ruft den Gesundheitsstatus des Elasticsearch-Clusters ab. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Ja | Bereitstellungstyp: self_hosted oder cloud | +| `host` | string | Nein | Elasticsearch-Host-URL \(für self-hosted\) | +| `cloudId` | string | Nein | Elastic Cloud ID \(für Cloud-Bereitstellungen\) | +| `authMethod` | string | Ja | Authentifizierungsmethode: api_key oder basic_auth | +| `apiKey` | string | Nein | Elasticsearch API-Schlüssel | +| `username` | string | Nein | Benutzername für Basic-Auth | +| `password` | string | Nein | Passwort für Basic-Auth | +| `waitForStatus` | string | Nein | Warten bis der Cluster diesen Status erreicht: green, yellow oder red | +| `timeout` | string | Nein | Timeout für den Wartevorgang \(z.B. 30s, 1m\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `cluster_name` | string | Name des Clusters | +| `status` | string | Cluster-Gesundheitsstatus: green, yellow oder red | +| `number_of_nodes` | number | Gesamtzahl der Knoten im Cluster | +| `number_of_data_nodes` | number | Anzahl der Datenknoten | +| `active_shards` | number | Anzahl der aktiven Shards | +| `unassigned_shards` | number | Anzahl der nicht zugewiesenen Shards | + +### `elasticsearch_cluster_stats` + +Erhalte umfassende Statistiken über den Elasticsearch-Cluster. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Ja | Bereitstellungstyp: self_hosted oder cloud | +| `host` | string | Nein | Elasticsearch-Host-URL \(für self-hosted\) | +| `cloudId` | string | Nein | Elastic Cloud ID \(für Cloud-Bereitstellungen\) | +| `authMethod` | string | Ja | Authentifizierungsmethode: api_key oder basic_auth | +| `apiKey` | string | Nein | Elasticsearch API-Schlüssel | +| `username` | string | Nein | Benutzername für Basic-Auth | +| `password` | string | Nein | Passwort für Basic-Auth | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `cluster_name` | string | Name des Clusters | +| `status` | string | Cluster-Gesundheitsstatus | +| `nodes` | object | Knotenstatistiken einschließlich Anzahl und Versionen | +| `indices` | object | Indexstatistiken einschließlich Dokumentanzahl und Speichergröße | + +## Hinweise + +- Kategorie: `tools` +- Typ: `elasticsearch` diff --git a/apps/docs/content/docs/de/tools/gitlab.mdx b/apps/docs/content/docs/de/tools/gitlab.mdx new file mode 100644 index 000000000..ab075248b --- /dev/null +++ b/apps/docs/content/docs/de/tools/gitlab.mdx @@ -0,0 +1,429 @@ +--- +title: GitLab +description: Interagiere mit GitLab-Projekten, Issues, Merge Requests und Pipelines +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[GitLab](https://gitlab.com/) ist eine umfassende DevOps-Plattform, die Teams ermöglicht, ihren Software-Entwicklungszyklus zu verwalten, zusammenzuarbeiten und zu automatisieren. Mit GitLab kannst du mühelos Quellcodeverwaltung, CI/CD, Reviews und Zusammenarbeit in einer einzigen Anwendung handhaben. + +Mit GitLab in Sim kannst du: + +- **Projekte und Repositories verwalten**: Liste und rufe deine GitLab-Projekte ab, greife auf Details zu und organisiere deine Repositories +- **Mit Issues arbeiten**: Issues auflisten, erstellen und kommentieren, um Arbeit zu verfolgen und effektiv zusammenzuarbeiten +- **Merge Requests bearbeiten**: Überprüfe, erstelle und verwalte Merge Requests für Codeänderungen und Peer-Reviews +- **CI/CD-Pipelines automatisieren**: Starte, überwache und interagiere mit GitLab-Pipelines als Teil deiner Automatisierungsabläufe +- **Mit Kommentaren zusammenarbeiten**: Füge Kommentare zu Issues oder Merge Requests hinzu für eine effiziente Kommunikation innerhalb deines Teams + +Mit Sims GitLab-Integration können deine Agenten programmatisch mit deinen GitLab-Projekten interagieren. Automatisiere Projektverwaltung, Issue-Tracking, Code-Reviews und Pipeline-Operationen nahtlos in deinen Workflows, optimiere deinen Software-Entwicklungsprozess und verbessere die Zusammenarbeit in deinem Team. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanleitung + +Integriere GitLab in den Workflow. Kann Projekte, Issues, Merge Requests, Pipelines verwalten und Kommentare hinzufügen. Unterstützt alle grundlegenden GitLab DevOps-Operationen. + +## Tools + +### `gitlab_list_projects` + +GitLab-Projekte auflisten, auf die der authentifizierte Benutzer Zugriff hat + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `owned` | boolean | Nein | Beschränkung auf Projekte, die dem aktuellen Benutzer gehören | +| `membership` | boolean | Nein | Beschränkung auf Projekte, in denen der aktuelle Benutzer Mitglied ist | +| `search` | string | Nein | Projekte nach Namen durchsuchen | +| `visibility` | string | Nein | Nach Sichtbarkeit filtern \(public, internal, private\) | +| `orderBy` | string | Nein | Nach Feld sortieren \(id, name, path, created_at, updated_at, last_activity_at\) | +| `sort` | string | Nein | Sortierrichtung \(asc, desc\) | +| `perPage` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard 20, max 100\) | +| `page` | number | Nein | Seitennummer für Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `projects` | array | Liste der GitLab-Projekte | +| `total` | number | Gesamtanzahl der Projekte | + +### `gitlab_get_project` + +Details zu einem bestimmten GitLab-Projekt abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad \(z.B. "namespace/project"\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `project` | object | Die GitLab-Projektdetails | + +### `gitlab_list_issues` + +Issues in einem GitLab-Projekt auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad | +| `state` | string | Nein | Nach Status filtern \(opened, closed, all\) | +| `labels` | string | Nein | Kommagetrennte Liste von Label-Namen | +| `assigneeId` | number | Nein | Nach Bearbeiter-Benutzer-ID filtern | +| `milestoneTitle` | string | Nein | Nach Meilenstein-Titel filtern | +| `search` | string | Nein | Issues nach Titel und Beschreibung durchsuchen | +| `orderBy` | string | Nein | Sortieren nach Feld \(created_at, updated_at\) | +| `sort` | string | Nein | Sortierrichtung \(asc, desc\) | +| `perPage` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard 20, max 100\) | +| `page` | number | Nein | Seitennummer für Paginierung | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `issues` | array | Liste der GitLab-Issues | +| `total` | number | Gesamtanzahl der Issues | + +### `gitlab_get_issue` + +Details zu einem bestimmten GitLab-Issue abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad | +| `issueIid` | number | Ja | Issue-Nummer innerhalb des Projekts \(die # in der GitLab-UI angezeigt\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `issue` | object | Die GitLab-Issue-Details | + +### `gitlab_create_issue` + +Ein neues Issue in einem GitLab-Projekt erstellen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad | +| `title` | string | Ja | Issue-Titel | +| `description` | string | Nein | Issue-Beschreibung \(Markdown unterstützt\) | +| `labels` | string | Nein | Kommagetrennte Liste von Label-Namen | +| `assigneeIds` | array | Nein | Array von Benutzer-IDs für die Zuweisung | +| `milestoneId` | number | Nein | Meilenstein-ID für die Zuweisung | +| `dueDate` | string | Nein | Fälligkeitsdatum im Format JJJJ-MM-TT | +| `confidential` | boolean | Nein | Ob das Issue vertraulich ist | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `issue` | object | Das erstellte GitLab-Issue | + +### `gitlab_update_issue` + +Ein bestehendes Issue in einem GitLab-Projekt aktualisieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad | +| `issueIid` | number | Ja | Interne Issue-ID (IID) | +| `title` | string | Nein | Neuer Issue-Titel | +| `description` | string | Nein | Neue Issue-Beschreibung (Markdown unterstützt) | +| `stateEvent` | string | Nein | Status-Event (close oder reopen) | +| `labels` | string | Nein | Kommagetrennte Liste von Label-Namen | +| `assigneeIds` | array | Nein | Array von Benutzer-IDs für die Zuweisung | +| `milestoneId` | number | Nein | Meilenstein-ID für die Zuweisung | +| `dueDate` | string | Nein | Fälligkeitsdatum im Format JJJJ-MM-TT | +| `confidential` | boolean | Nein | Ob das Issue vertraulich ist | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `issue` | object | Das aktualisierte GitLab-Issue | + +### `gitlab_delete_issue` + +Ein Issue aus einem GitLab-Projekt löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad | +| `issueIid` | number | Ja | Interne Issue-ID (IID) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Ob das Issue erfolgreich gelöscht wurde | + +### `gitlab_create_issue_note` + +Einen Kommentar zu einem GitLab-Issue hinzufügen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad | +| `issueIid` | number | Ja | Interne Issue-ID (IID) | +| `body` | string | Ja | Kommentartext (Markdown unterstützt) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `note` | object | Der erstellte Kommentar | + +### `gitlab_list_merge_requests` + +Merge-Requests in einem GitLab-Projekt auflisten + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad | +| `state` | string | Nein | Nach Status filtern (opened, closed, merged, all) | +| `labels` | string | Nein | Kommagetrennte Liste von Label-Namen | +| `sourceBranch` | string | Nein | Nach Quell-Branch filtern | +| `targetBranch` | string | Nein | Nach Ziel-Branch filtern | +| `orderBy` | string | Nein | Sortieren nach Feld (created_at, updated_at) | +| `sort` | string | Nein | Sortierrichtung (asc, desc) | +| `perPage` | number | Nein | Anzahl der Ergebnisse pro Seite (Standard 20, max 100) | +| `page` | number | Nein | Seitennummer für Paginierung | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `mergeRequests` | array | Liste der GitLab Merge-Requests | +| `total` | number | Gesamtanzahl der Merge-Requests | + +### `gitlab_get_merge_request` + +Details zu einem bestimmten GitLab Merge-Request abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad | +| `mergeRequestIid` | number | Ja | Interne ID des Merge-Requests \(IID\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `mergeRequest` | object | Die Details des GitLab Merge-Requests | + +### `gitlab_create_merge_request` + +Einen neuen Merge-Request in einem GitLab-Projekt erstellen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad | +| `sourceBranch` | string | Ja | Name des Quellbranches | +| `targetBranch` | string | Ja | Name des Zielbranches | +| `title` | string | Ja | Titel des Merge-Requests | +| `description` | string | Nein | Beschreibung des Merge-Requests \(Markdown unterstützt\) | +| `labels` | string | Nein | Kommagetrennte Liste von Label-Namen | +| `assigneeIds` | array | Nein | Array von Benutzer-IDs für die Zuweisung | +| `milestoneId` | number | Nein | Meilenstein-ID für die Zuweisung | +| `removeSourceBranch` | boolean | Nein | Quellbranch nach dem Merge löschen | +| `squash` | boolean | Nein | Commits beim Merge zusammenfassen | +| `draft` | boolean | Nein | Als Entwurf markieren \(in Bearbeitung\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `mergeRequest` | object | Der erstellte GitLab Merge Request | + +### `gitlab_update_merge_request` + +Einen bestehenden Merge Request in einem GitLab-Projekt aktualisieren + +#### Input + +| Parameter | Type | Required | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Yes | Projekt-ID oder URL-kodierter Pfad | +| `mergeRequestIid` | number | Yes | Interne ID des Merge Requests \(IID\) | +| `title` | string | No | Neuer Titel des Merge Requests | +| `description` | string | No | Neue Beschreibung des Merge Requests | +| `stateEvent` | string | No | Status-Event \(close oder reopen\) | +| `labels` | string | No | Kommagetrennte Liste von Label-Namen | +| `assigneeIds` | array | No | Array von Benutzer-IDs für die Zuweisung | +| `milestoneId` | number | No | Meilenstein-ID für die Zuweisung | +| `targetBranch` | string | No | Neuer Ziel-Branch | +| `removeSourceBranch` | boolean | No | Quell-Branch nach dem Merge löschen | +| `squash` | boolean | No | Commits beim Merge zusammenfassen | +| `draft` | boolean | No | Als Entwurf markieren \(work in progress\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `mergeRequest` | object | Der aktualisierte GitLab Merge Request | + +### `gitlab_merge_merge_request` + +Einen Merge Request in einem GitLab-Projekt zusammenführen + +#### Input + +| Parameter | Type | Required | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Yes | Projekt-ID oder URL-kodierter Pfad | +| `mergeRequestIid` | number | Yes | Interne ID des Merge Requests \(IID\) | +| `mergeCommitMessage` | string | No | Benutzerdefinierte Merge-Commit-Nachricht | +| `squashCommitMessage` | string | No | Benutzerdefinierte Squash-Commit-Nachricht | +| `squash` | boolean | No | Commits vor dem Merge zusammenfassen | +| `shouldRemoveSourceBranch` | boolean | No | Quell-Branch nach dem Merge löschen | +| `mergeWhenPipelineSucceeds` | boolean | No | Merge durchführen, wenn Pipeline erfolgreich ist | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `mergeRequest` | object | Der zusammengeführte GitLab Merge Request | + +### `gitlab_create_merge_request_note` + +Einen Kommentar zu einem GitLab Merge Request hinzufügen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-kodierter Pfad | +| `mergeRequestIid` | number | Ja | Interne ID des Merge Requests \(IID\) | +| `body` | string | Ja | Kommentartext \(Markdown wird unterstützt\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `note` | object | Der erstellte Kommentar | + +### `gitlab_list_pipelines` + +Pipelines in einem GitLab-Projekt auflisten + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-kodierter Pfad | +| `ref` | string | Nein | Nach Ref filtern \(Branch oder Tag\) | +| `status` | string | Nein | Nach Status filtern \(created, waiting_for_resource, preparing, pending, running, success, failed, canceled, skipped, manual, scheduled\) | +| `orderBy` | string | Nein | Sortieren nach Feld \(id, status, ref, updated_at, user_id\) | +| `sort` | string | Nein | Sortierrichtung \(asc, desc\) | +| `perPage` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard 20, max 100\) | +| `page` | number | Nein | Seitennummer für Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `pipelines` | array | Liste der GitLab-Pipelines | +| `total` | number | Gesamtanzahl der Pipelines | + +### `gitlab_get_pipeline` + +Details zu einer bestimmten GitLab-Pipeline abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad | +| `pipelineId` | number | Ja | Pipeline-ID | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `pipeline` | object | Die GitLab-Pipeline-Details | + +### `gitlab_create_pipeline` + +Eine neue Pipeline in einem GitLab-Projekt auslösen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad | +| `ref` | string | Ja | Branch oder Tag, auf dem die Pipeline ausgeführt werden soll | +| `variables` | array | Nein | Array von Variablen für die Pipeline \(jede mit key, value und optionalem variable_type\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `pipeline` | object | Die erstellte GitLab-Pipeline | + +### `gitlab_retry_pipeline` + +Eine fehlgeschlagene GitLab-Pipeline wiederholen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad | +| `pipelineId` | number | Ja | Pipeline-ID | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `pipeline` | object | Die wiederholte GitLab-Pipeline | + +### `gitlab_cancel_pipeline` + +Eine laufende GitLab-Pipeline abbrechen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID oder URL-codierter Pfad | +| `pipelineId` | number | Ja | Pipeline-ID | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `pipeline` | object | Die abgebrochene GitLab-Pipeline | + +## Hinweise + +- Kategorie: `tools` +- Typ: `gitlab` diff --git a/apps/docs/content/docs/de/tools/grafana.mdx b/apps/docs/content/docs/de/tools/grafana.mdx new file mode 100644 index 000000000..8e694f5c9 --- /dev/null +++ b/apps/docs/content/docs/de/tools/grafana.mdx @@ -0,0 +1,494 @@ +--- +title: Grafana +description: Interagiere mit Grafana-Dashboards, Alarmen und Anmerkungen +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Grafana](https://grafana.com/) ist eine führende Open-Source-Plattform für Monitoring, Observability und Visualisierung. Sie ermöglicht Benutzern, Daten aus verschiedenen Quellen abzufragen, zu visualisieren, zu überwachen und zu analysieren, was sie zu einem wesentlichen Werkzeug für Infrastruktur- und Anwendungsmonitoring macht. + +Mit Grafana kannst du: + +- **Daten visualisieren**: Dashboards erstellen und anpassen, um Metriken, Logs und Traces in Echtzeit anzuzeigen +- **Gesundheit und Status überwachen**: Den Zustand deiner Grafana-Instanz und verbundener Datenquellen überprüfen +- **Alarme und Anmerkungen verwalten**: Alarmregeln einrichten, Benachrichtigungen verwalten und Dashboards mit wichtigen Ereignissen versehen +- **Inhalte organisieren**: Dashboards und Datenquellen in Ordnern organisieren für besseres Zugriffsmanagement + +In Sim ermöglicht die Grafana-Integration deinen Agenten, direkt über die API mit deiner Grafana-Instanz zu interagieren, was Aktionen wie folgende ermöglicht: + +- Überprüfung des Gesundheitsstatus von Grafana-Server, Datenbank und Datenquellen +- Abrufen, Auflisten und Verwalten von Dashboards, Alarmregeln, Anmerkungen, Datenquellen und Ordnern +- Automatisierung der Überwachung deiner Infrastruktur durch Integration von Grafana-Daten und Alarmen in deine Workflow-Automatisierungen + +Diese Fähigkeiten ermöglichen es Sim-Agenten, Systeme zu überwachen, proaktiv auf Alarme zu reagieren und die Zuverlässigkeit und Sichtbarkeit deiner Dienste zu gewährleisten – alles als Teil deiner automatisierten Workflows. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanleitung + +Integriere Grafana in Workflows. Verwalte Dashboards, Alarme, Anmerkungen, Datenquellen, Ordner und überwache den Gesundheitsstatus. + +## Tools + +### `grafana_get_dashboard` + +Ein Dashboard anhand seiner UID abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `dashboardUid` | string | Ja | Die UID des abzurufenden Dashboards | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `dashboard` | json | Das vollständige Dashboard-JSON-Objekt | +| `meta` | json | Dashboard-Metadaten \(Version, Berechtigungen usw.\) | + +### `grafana_list_dashboards` + +Suchen und auflisten aller Dashboards + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `query` | string | Nein | Suchanfrage zum Filtern von Dashboards nach Titel | +| `tag` | string | Nein | Nach Tag filtern \(kommagetrennt für mehrere Tags\) | +| `folderIds` | string | Nein | Nach Ordner-IDs filtern \(kommagetrennt\) | +| `starred` | boolean | Nein | Nur mit Stern markierte Dashboards zurückgeben | +| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Dashboards | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `dashboards` | array | Liste der Dashboard-Suchergebnisse | + +### `grafana_create_dashboard` + +Ein neues Dashboard erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `title` | string | Ja | Der Titel des neuen Dashboards | +| `folderUid` | string | Nein | Die UID des Ordners, in dem das Dashboard erstellt werden soll | +| `tags` | string | Nein | Kommagetrennte Liste von Tags | +| `timezone` | string | Nein | Dashboard-Zeitzone \(z.B. browser, utc\) | +| `refresh` | string | Nein | Auto-Aktualisierungsintervall \(z.B. 5s, 1m, 5m\) | +| `panels` | string | Nein | JSON-Array von Panel-Konfigurationen | +| `overwrite` | boolean | Nein | Vorhandenes Dashboard mit gleichem Titel überschreiben | +| `message` | string | Nein | Commit-Nachricht für die Dashboard-Version | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `id` | number | Die numerische ID des erstellten Dashboards | +| `uid` | string | Die UID des erstellten Dashboards | +| `url` | string | Der URL-Pfad zum Dashboard | +| `status` | string | Status der Operation \(success\) | +| `version` | number | Die Versionsnummer des Dashboards | +| `slug` | string | URL-freundlicher Slug des Dashboards | + +### `grafana_update_dashboard` + +Aktualisiert ein bestehendes Dashboard. Ruft das aktuelle Dashboard ab und führt Ihre Änderungen zusammen. + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `dashboardUid` | string | Ja | Die UID des zu aktualisierenden Dashboards | +| `title` | string | Nein | Neuer Titel für das Dashboard | +| `folderUid` | string | Nein | Neue Ordner-UID, um das Dashboard zu verschieben | +| `tags` | string | Nein | Kommagetrennte Liste neuer Tags | +| `timezone` | string | Nein | Dashboard-Zeitzone \(z.B. browser, utc\) | +| `refresh` | string | Nein | Auto-Refresh-Intervall \(z.B. 5s, 1m, 5m\) | +| `panels` | string | Nein | JSON-Array von Panel-Konfigurationen | +| `overwrite` | boolean | Nein | Überschreiben auch bei Versionskonflikten | +| `message` | string | Nein | Commit-Nachricht für diese Version | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `id` | number | Die numerische ID des aktualisierten Dashboards | +| `uid` | string | Die UID des aktualisierten Dashboards | +| `url` | string | Der URL-Pfad zum Dashboard | +| `status` | string | Status der Operation \(success\) | +| `version` | number | Die neue Versionsnummer des Dashboards | +| `slug` | string | URL-freundlicher Slug des Dashboards | + +### `grafana_delete_dashboard` + +Löschen eines Dashboards anhand seiner UID + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `dashboardUid` | string | Ja | Die UID des zu löschenden Dashboards | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `title` | string | Der Titel des gelöschten Dashboards | +| `message` | string | Bestätigungsnachricht | +| `id` | number | Die ID des gelöschten Dashboards | + +### `grafana_list_alert_rules` + +Alle Alarmregeln in der Grafana-Instanz auflisten + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `rules` | array | Liste der Alarmregeln | + +### `grafana_get_alert_rule` + +Eine bestimmte Alarmregel anhand ihrer UID abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `alertRuleUid` | string | Ja | Die UID der abzurufenden Alarmregel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `uid` | string | Alarmregel-UID | +| `title` | string | Alarmregel-Titel | +| `condition` | string | Alarmbedingung | +| `data` | json | Alarmregel-Abfragedaten | +| `folderUID` | string | Übergeordnete Ordner-UID | +| `ruleGroup` | string | Regelgruppenname | +| `noDataState` | string | Status, wenn keine Daten zurückgegeben werden | +| `execErrState` | string | Status bei Ausführungsfehler | +| `annotations` | json | Alarmanmerkungen | +| `labels` | json | Alarmlabels | + +### `grafana_create_alert_rule` + +Eine neue Alarmregel erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `title` | string | Ja | Der Titel der Alarmregel | +| `folderUid` | string | Ja | Die UID des Ordners, in dem der Alarm erstellt werden soll | +| `ruleGroup` | string | Ja | Der Name der Regelgruppe | +| `condition` | string | Ja | Die refId der Abfrage oder des Ausdrucks, der als Alarmbedingung verwendet werden soll | +| `data` | string | Ja | JSON-Array von Abfrage-/Ausdrucksdatenobjekten | +| `forDuration` | string | Nein | Wartezeit vor dem Auslösen \(z.B. 5m, 1h\) | +| `noDataState` | string | Nein | Status, wenn keine Daten zurückgegeben werden \(NoData, Alerting, OK\) | +| `execErrState` | string | Nein | Status bei Ausführungsfehler \(Alerting, OK\) | +| `annotations` | string | Nein | JSON-Objekt von Anmerkungen | +| `labels` | string | Nein | JSON-Objekt von Labels | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `uid` | string | Die UID der erstellten Alarmregel | +| `title` | string | Titel der Alarmregel | +| `folderUID` | string | UID des übergeordneten Ordners | +| `ruleGroup` | string | Name der Regelgruppe | + +### `grafana_update_alert_rule` + +Aktualisiert eine bestehende Alarmregel. Ruft die aktuelle Regel ab und führt Ihre Änderungen zusammen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service-Account-Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL (z.B. https://your-grafana.com) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `alertRuleUid` | string | Ja | Die UID der zu aktualisierenden Alarmregel | +| `title` | string | Nein | Neuer Titel für die Alarmregel | +| `folderUid` | string | Nein | Neue Ordner-UID, um den Alarm zu verschieben | +| `ruleGroup` | string | Nein | Neuer Name der Regelgruppe | +| `condition` | string | Nein | Neue Bedingung refId | +| `data` | string | Nein | Neues JSON-Array von Abfrage-/Ausdrucksdatenobjekten | +| `forDuration` | string | Nein | Wartezeit vor dem Auslösen (z.B. 5m, 1h) | +| `noDataState` | string | Nein | Status, wenn keine Daten zurückgegeben werden (NoData, Alerting, OK) | +| `execErrState` | string | Nein | Status bei Ausführungsfehler (Alerting, OK) | +| `annotations` | string | Nein | JSON-Objekt von Anmerkungen | +| `labels` | string | Nein | JSON-Objekt von Labels | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `uid` | string | Die UID der aktualisierten Alarmregel | +| `title` | string | Titel der Alarmregel | +| `folderUID` | string | UID des übergeordneten Ordners | +| `ruleGroup` | string | Name der Regelgruppe | + +### `grafana_delete_alert_rule` + +Löschen einer Alarmregel anhand ihrer UID + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service-Account-Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `alertRuleUid` | string | Ja | Die UID der zu löschenden Alarmregel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `message` | string | Bestätigungsnachricht | + +### `grafana_list_contact_points` + +Alle Alarmbenachrichtigungs-Kontaktpunkte auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service-Account-Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `contactPoints` | array | Liste der Kontaktpunkte | + +### `grafana_create_annotation` + +Eine Anmerkung auf einem Dashboard oder als globale Anmerkung erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `text` | string | Ja | Der Textinhalt der Anmerkung | +| `tags` | string | Nein | Kommagetrennte Liste von Tags | +| `dashboardUid` | string | Nein | UID des Dashboards, zu dem die Anmerkung hinzugefügt werden soll \(optional für globale Anmerkungen\) | +| `panelId` | number | Nein | ID des Panels, zu dem die Anmerkung hinzugefügt werden soll | +| `time` | number | Nein | Startzeit in Epochenmillisekunden \(standardmäßig jetzt\) | +| `timeEnd` | number | Nein | Endzeit in Epochenmillisekunden \(für Bereichsanmerkungen\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `id` | number | Die ID der erstellten Anmerkung | +| `message` | string | Bestätigungsnachricht | + +### `grafana_list_annotations` + +Anmerkungen nach Zeitraum, Dashboard oder Tags abfragen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `from` | number | Nein | Startzeit in Epochenmillisekunden | +| `to` | number | Nein | Endzeit in Epochenmillisekunden | +| `dashboardUid` | string | Nein | Nach Dashboard-UID filtern | +| `panelId` | number | Nein | Nach Panel-ID filtern | +| `tags` | string | Nein | Kommagetrennte Liste von Tags, nach denen gefiltert werden soll | +| `type` | string | Nein | Nach Typ filtern \(alert oder annotation\) | +| `limit` | number | Nein | Maximale Anzahl von zurückzugebenden Anmerkungen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `annotations` | array | Liste der Anmerkungen | + +### `grafana_update_annotation` + +Eine vorhandene Anmerkung aktualisieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service-Account-Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `annotationId` | number | Ja | Die ID der zu aktualisierenden Anmerkung | +| `text` | string | Ja | Neuer Textinhalt für die Anmerkung | +| `tags` | string | Nein | Kommagetrennte Liste neuer Tags | +| `time` | number | Nein | Neue Startzeit in Epochenmillisekunden | +| `timeEnd` | number | Nein | Neue Endzeit in Epochenmillisekunden | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `id` | number | Die ID der aktualisierten Anmerkung | +| `message` | string | Bestätigungsnachricht | + +### `grafana_delete_annotation` + +Eine Anmerkung anhand ihrer ID löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service-Account-Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `annotationId` | number | Ja | Die ID der zu löschenden Anmerkung | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `message` | string | Bestätigungsnachricht | + +### `grafana_list_data_sources` + +Alle in Grafana konfigurierten Datenquellen auflisten + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `dataSources` | array | Liste der Datenquellen | + +### `grafana_get_data_source` + +Eine Datenquelle anhand ihrer ID oder UID abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Multi-Org-Grafana-Instanzen | +| `dataSourceId` | string | Ja | Die ID oder UID der abzurufenden Datenquelle | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `id` | number | Datenquellen-ID | +| `uid` | string | Datenquellen-UID | +| `name` | string | Name der Datenquelle | +| `type` | string | Typ der Datenquelle | +| `url` | string | Verbindungs-URL der Datenquelle | +| `database` | string | Datenbankname \(falls zutreffend\) | +| `isDefault` | boolean | Ob dies die Standard-Datenquelle ist | +| `jsonData` | json | Zusätzliche Konfiguration der Datenquelle | + +### `grafana_list_folders` + +Alle Ordner in Grafana auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Grafana-Instanzen mit mehreren Organisationen | +| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Ordner | +| `page` | number | Nein | Seitennummer für Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `folders` | array | Liste der Ordner | + +### `grafana_create_folder` + +Einen neuen Ordner in Grafana erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Grafana Service Account Token | +| `baseUrl` | string | Ja | Grafana-Instanz-URL \(z.B. https://your-grafana.com\) | +| `organizationId` | string | Nein | Organisations-ID für Grafana-Instanzen mit mehreren Organisationen | +| `title` | string | Ja | Der Titel des neuen Ordners | +| `uid` | string | Nein | Optionale UID für den Ordner \(wird automatisch generiert, wenn nicht angegeben\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `id` | number | Die numerische ID des erstellten Ordners | +| `uid` | string | Die UID des erstellten Ordners | +| `title` | string | Der Titel des erstellten Ordners | +| `url` | string | Der URL-Pfad zum Ordner | + +## Notizen + +- Kategorie: `tools` +- Typ: `grafana` diff --git a/apps/docs/content/docs/de/tools/kalshi.mdx b/apps/docs/content/docs/de/tools/kalshi.mdx new file mode 100644 index 000000000..2f9ec900b --- /dev/null +++ b/apps/docs/content/docs/de/tools/kalshi.mdx @@ -0,0 +1,295 @@ +--- +title: Kalshi +description: Zugriff auf Prognosemarktdaten von Kalshi +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Kalshi](https://kalshi.com) ist eine bundesweit regulierte Börse, an der Nutzer direkt mit den Ergebnissen zukünftiger Ereignisse handeln können – Prognosemärkte. Kalshis robuste API und Sim-Integration ermöglichen es Agenten und Workflows, programmatisch auf alle Aspekte der Plattform zuzugreifen und unterstützen alles von Forschung und Analyse bis hin zu automatisiertem Handel und Überwachung. + +Mit Kalshis Integration in Sim können Sie: + +- **Markt- & Ereignisdaten:** Echtzeit- und historische Daten für Märkte und Ereignisse suchen, filtern und abrufen; detaillierte Informationen zum Marktstatus, Serien, Ereignisgruppierungen und mehr abrufen. +- **Konto- & Guthaben-Management:** Zugriff auf Kontostände, verfügbare Mittel und Überwachung von Echtzeit-Positionen. +- **Auftrags- & Handelsmanagement:** Neue Aufträge platzieren, bestehende stornieren, offene Aufträge einsehen, ein Live-Orderbuch abrufen und auf vollständige Handelshistorien zugreifen. +- **Ausführungsanalyse:** Abruf von aktuellen Trades, historischen Ausführungen und Candlestick-Daten für Backtesting oder Marktstrukturforschung. +- **Überwachung:** Börsenweiten oder serienspezifischen Status prüfen, Echtzeit-Updates über Marktänderungen oder Handelsunterbrechungen erhalten und Reaktionen automatisieren. +- **Automatisierungsbereit:** Entwicklung von End-to-End automatisierten Agenten und Dashboards, die Wahrscheinlichkeiten von Ereignissen in der realen Welt konsumieren, analysieren und damit handeln. + +Durch die Nutzung dieser einheitlichen Tools und Endpunkte können Sie Kalshis Prognosemärkte, Live-Handelsfunktionen und umfangreiche Ereignisdaten nahtlos in Ihre KI-gestützten Anwendungen, Dashboards und Workflows integrieren – und so eine anspruchsvolle, automatisierte Entscheidungsfindung ermöglichen, die an reale Ergebnisse gekoppelt ist. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanleitung + +Integrieren Sie Kalshi-Prognosemärkte in den Workflow. Kann Märkte, Markt, Ereignisse, Ereignis, Guthaben, Positionen, Aufträge, Orderbuch, Trades, Candlesticks, Ausführungen, Serien und Börsenstatus abrufen. + +## Tools + +### `kalshi_get_markets` + +Rufe eine Liste von Prognosemärkten von Kalshi mit optionaler Filterung ab + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `status` | string | Nein | Nach Status filtern \(unopened, open, closed, settled\) | +| `seriesTicker` | string | Nein | Nach Serien-Ticker filtern | +| `eventTicker` | string | Nein | Nach Event-Ticker filtern | +| `limit` | string | Nein | Anzahl der Ergebnisse \(1-1000, standard: 100\) | +| `cursor` | string | Nein | Paginierungscursor für die nächste Seite | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Marktdaten und Metadaten | + +### `kalshi_get_market` + +Rufe Details eines bestimmten Prognosemarkts nach Ticker ab + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `ticker` | string | Ja | Der Markt-Ticker \(z.B. "KXBTC-24DEC31"\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Marktdaten und Metadaten | + +### `kalshi_get_events` + +Rufe eine Liste von Events von Kalshi mit optionaler Filterung ab + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `status` | string | Nein | Nach Status filtern \(open, closed, settled\) | +| `seriesTicker` | string | Nein | Nach Serien-Ticker filtern | +| `withNestedMarkets` | string | Nein | Verschachtelte Märkte in der Antwort einschließen \(true/false\) | +| `limit` | string | Nein | Anzahl der Ergebnisse \(1-200, standard: 200\) | +| `cursor` | string | Nein | Paginierungscursor für die nächste Seite | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Ereignisdaten und Metadaten | + +### `kalshi_get_event` + +Details eines bestimmten Ereignisses anhand des Tickers abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `eventTicker` | string | Ja | Der Ereignis-Ticker | +| `withNestedMarkets` | string | Nein | Verschachtelte Märkte in die Antwort einbeziehen \(true/false\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Ereignisdaten und Metadaten | + +### `kalshi_get_balance` + +Kontostand und Portfoliowert von Kalshi abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | Ja | Ihre Kalshi API-Schlüssel-ID | +| `privateKey` | string | Ja | Ihr RSA Private Key \(PEM-Format\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Kontostandsdaten und Metadaten | + +### `kalshi_get_positions` + +Offene Positionen von Kalshi abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | Ja | Ihre Kalshi API-Schlüssel-ID | +| `privateKey` | string | Ja | Ihr RSA Private Key \(PEM-Format\) | +| `ticker` | string | Nein | Nach Markt-Ticker filtern | +| `eventTicker` | string | Nein | Nach Ereignis-Ticker filtern \(max. 10 durch Komma getrennt\) | +| `settlementStatus` | string | Nein | Nach Abrechnungsstatus filtern \(all, unsettled, settled\). Standard: unsettled | +| `limit` | string | Nein | Anzahl der Ergebnisse \(1-1000, Standard: 100\) | +| `cursor` | string | Nein | Paginierungscursor für die nächste Seite | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Positionsdaten und Metadaten | + +### `kalshi_get_orders` + +Rufen Sie Ihre Bestellungen von Kalshi mit optionaler Filterung ab + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | Ja | Ihre Kalshi API-Schlüssel-ID | +| `privateKey` | string | Ja | Ihr RSA Private Key \(PEM-Format\) | +| `ticker` | string | Nein | Nach Markt-Ticker filtern | +| `eventTicker` | string | Nein | Nach Event-Ticker filtern \(maximal 10 durch Komma getrennt\) | +| `status` | string | Nein | Nach Status filtern \(resting, canceled, executed\) | +| `limit` | string | Nein | Anzahl der Ergebnisse \(1-200, Standard: 100\) | +| `cursor` | string | Nein | Paginierungscursor für die nächste Seite | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Bestelldaten und Metadaten | + +### `kalshi_get_orderbook` + +Rufen Sie das Orderbuch (Gebote und Anfragen) für einen bestimmten Markt ab + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `ticker` | string | Ja | Markt-Ticker \(z.B. KXBTC-24DEC31\) | +| `depth` | number | Nein | Anzahl der Preisstufen, die pro Seite zurückgegeben werden sollen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Orderbuch-Daten und Metadaten | + +### `kalshi_get_trades` + +Ruft aktuelle Trades über alle Märkte oder für einen bestimmten Markt ab + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `ticker` | string | Nein | Nach Markt-Ticker filtern | +| `minTs` | number | Nein | Minimaler Zeitstempel (Unix-Millisekunden) | +| `maxTs` | number | Nein | Maximaler Zeitstempel (Unix-Millisekunden) | +| `limit` | string | Nein | Anzahl der Ergebnisse (1-1000, Standard: 100) | +| `cursor` | string | Nein | Paginierungscursor für die nächste Seite | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Trade-Daten und Metadaten | + +### `kalshi_get_candlesticks` + +Ruft OHLC-Kerzendaten für einen bestimmten Markt ab + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `seriesTicker` | string | Ja | Serien-Ticker | +| `ticker` | string | Ja | Markt-Ticker (z.B. KXBTC-24DEC31) | +| `startTs` | number | Nein | Startzeitstempel (Unix-Millisekunden) | +| `endTs` | number | Nein | Endzeitstempel (Unix-Millisekunden) | +| `periodInterval` | number | Nein | Periodenintervall: 1 (1min), 60 (1std), oder 1440 (1tag) | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Candlestick-Daten und Metadaten | + +### `kalshi_get_fills` + +Rufen Sie Ihr Portfolio ab + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | Ja | Ihre Kalshi API-Schlüssel-ID | +| `privateKey` | string | Ja | Ihr RSA Private Key \(PEM-Format\) | +| `ticker` | string | Nein | Nach Markt-Ticker filtern | +| `orderId` | string | Nein | Nach Auftrags-ID filtern | +| `minTs` | number | Nein | Minimaler Zeitstempel \(Unix-Millisekunden\) | +| `maxTs` | number | Nein | Maximaler Zeitstempel \(Unix-Millisekunden\) | +| `limit` | string | Nein | Anzahl der Ergebnisse \(1-1000, Standard: 100\) | +| `cursor` | string | Nein | Paginierungscursor für die nächste Seite | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Ausführungsdaten und Metadaten | + +### `kalshi_get_series_by_ticker` + +Rufen Sie Details einer bestimmten Marktserie nach Ticker ab + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `seriesTicker` | string | Ja | Serien-Ticker | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Seriendaten und Metadaten | + +### `kalshi_get_exchange_status` + +Ruft den aktuellen Status der Kalshi-Börse ab (Handels- und Börsenaktivität) + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Börsenstatus-Daten und Metadaten | + +## Hinweise + +- Kategorie: `tools` +- Typ: `kalshi` diff --git a/apps/docs/content/docs/de/tools/polymarket.mdx b/apps/docs/content/docs/de/tools/polymarket.mdx new file mode 100644 index 000000000..849047ebf --- /dev/null +++ b/apps/docs/content/docs/de/tools/polymarket.mdx @@ -0,0 +1,352 @@ +--- +title: Polymarket +description: Zugriff auf Prognosemarktdaten von Polymarket +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Polymarket](https://polymarket.com) ist eine dezentralisierte Plattform für Prognosemärkte, auf der Nutzer mit Blockchain-Technologie auf den Ausgang zukünftiger Ereignisse handeln können. Polymarket bietet eine umfassende API, die Entwicklern und Agenten den Zugriff auf Live-Marktdaten, Ereignislisten, Preisinformationen und Orderbuch-Statistiken ermöglicht, um datengesteuerte Workflows und KI-Automatisierungen zu unterstützen. + +Mit der API von Polymarket und der Sim-Integration können Sie Agenten befähigen, programmatisch Informationen zu Prognosemärkten abzurufen, offene Märkte und zugehörige Ereignisse zu erkunden, historische Preisdaten zu analysieren und auf Orderbücher und Markt-Mittelwerte zuzugreifen. Dies schafft neue Möglichkeiten für Recherchen, automatisierte Analysen und die Entwicklung intelligenter Agenten, die auf Echtzeit-Ereigniswahrscheinlichkeiten reagieren, die aus Marktpreisen abgeleitet werden. + +Zu den wichtigsten Funktionen der Polymarket-Integration gehören: + +- **Marktlisting & Filterung:** Auflistung aller aktuellen oder historischen Prognosemärkte, Filterung nach Tags, Sortierung und Seitenweise Durchblättern der Ergebnisse. +- **Marktdetails:** Abrufen von Details für einen einzelnen Markt anhand der Markt-ID oder des Slugs, einschließlich seiner Ergebnisse und Status. +- **Ereignislisten:** Zugriff auf Listen von Polymarket-Ereignissen und detaillierte Ereignisinformationen. +- **Orderbuch- & Preisdaten:** Analyse des Orderbuchs, Abruf der aktuellen Marktpreise, Einsicht in den Mittelwert oder Erhalt historischer Preisinformationen für jeden Markt. +- **Automatisierungsbereit:** Erstellen von Agenten oder Tools, die programmatisch auf Marktentwicklungen, sich ändernde Quoten oder bestimmte Ereignisausgänge reagieren. + +Durch die Nutzung dieser dokumentierten API-Endpunkte können Sie die umfangreichen On-Chain-Prognosemarktdaten von Polymarket nahtlos in Ihre eigenen KI-Workflows, Dashboards, Recherchetools und Handelsautomatisierungen integrieren. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanweisungen + +Integrieren Sie Polymarket-Prognosemärkte in den Workflow. Kann Märkte, Markt, Ereignisse, Ereignis, Tags, Serien, Orderbuch, Preis, Mittelpunkt, Preisverlauf, letzten Handelspreis, Spread, Tick-Größe, Positionen, Trades und Suche abrufen. + +## Tools + +### `polymarket_get_markets` + +Rufen Sie eine Liste von Prognosemärkten von Polymarket mit optionaler Filterung ab + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `closed` | string | Nein | Nach geschlossenem Status filtern \(true/false\). Verwenden Sie false für nur aktive Märkte. | +| `order` | string | Nein | Sortierfeld \(z.B. id, volume, liquidity\) | +| `ascending` | string | Nein | Sortierrichtung \(true für aufsteigend, false für absteigend\) | +| `tagId` | string | Nein | Nach Tag-ID filtern | +| `limit` | string | Nein | Anzahl der Ergebnisse pro Seite \(empfohlen: 25-50\) | +| `offset` | string | Nein | Paginierungsoffset \(überspringe so viele Ergebnisse\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Marktdaten und Metadaten | + +### `polymarket_get_market` + +Rufen Sie Details eines bestimmten Prognosemarktes nach ID oder Slug ab + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `marketId` | string | Nein | Die Markt-ID. Erforderlich, wenn Slug nicht angegeben wird. | +| `slug` | string | Nein | Der Markt-Slug \(z.B. "will-trump-win"\). Erforderlich, wenn marketId nicht angegeben wird. | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Marktdaten und Metadaten | + +### `polymarket_get_events` + +Ruft eine Liste von Events von Polymarket mit optionaler Filterung ab + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `closed` | string | Nein | Filtern nach geschlossenem Status \(true/false\). Verwenden Sie false für nur aktive Events. | +| `order` | string | Nein | Sortierfeld \(z.B. id, volume\) | +| `ascending` | string | Nein | Sortierrichtung \(true für aufsteigend, false für absteigend\) | +| `tagId` | string | Nein | Filtern nach Tag-ID | +| `limit` | string | Nein | Anzahl der Ergebnisse pro Seite \(empfohlen: 25-50\) | +| `offset` | string | Nein | Paginierungsoffset \(überspringe so viele Ergebnisse\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Event-Daten und Metadaten | + +### `polymarket_get_event` + +Ruft Details eines bestimmten Events nach ID oder Slug ab + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `eventId` | string | Nein | Die Event-ID. Erforderlich, wenn kein Slug angegeben wird. | +| `slug` | string | Nein | Der Event-Slug \(z.B. "2024-presidential-election"\). Erforderlich, wenn keine eventId angegeben wird. | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Ereignisdaten und Metadaten | + +### `polymarket_get_tags` + +Verfügbare Tags zum Filtern von Märkten von Polymarket abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `limit` | string | Nein | Anzahl der Ergebnisse pro Seite \(empfohlen: 25-50\) | +| `offset` | string | Nein | Paginierungsoffset \(überspringe diese Anzahl an Ergebnissen\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Tag-Daten und Metadaten | + +### `polymarket_search` + +Nach Märkten, Ereignissen und Profilen auf Polymarket suchen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `query` | string | Ja | Suchbegriff | +| `limit` | string | Nein | Anzahl der Ergebnisse pro Seite \(empfohlen: 25-50\) | +| `offset` | string | Nein | Paginierungsoffset \(überspringe diese Anzahl an Ergebnissen\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Suchergebnisse und Metadaten | + +### `polymarket_get_series` + +Serien (verwandte Marktgruppen) von Polymarket abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `limit` | string | Nein | Anzahl der Ergebnisse pro Seite \(empfohlen: 25-50\) | +| `offset` | string | Nein | Paginierungsoffset \(überspringe diese Anzahl an Ergebnissen\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Seriendaten und Metadaten | + +### `polymarket_get_series_by_id` + +Eine bestimmte Serie (zugehörige Marktgruppe) anhand der ID von Polymarket abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `seriesId` | string | Ja | Die Serien-ID | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Seriendaten und Metadaten | + +### `polymarket_get_orderbook` + +Die Orderbuch-Zusammenfassung für einen bestimmten Token abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Ja | Die CLOB-Token-ID (aus den clobTokenIds des Marktes) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Orderbuch-Daten und Metadaten | + +### `polymarket_get_price` + +Den Marktpreis für einen bestimmten Token und eine bestimmte Seite abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Ja | Die CLOB-Token-ID (aus den clobTokenIds des Marktes) | +| `side` | string | Ja | Orderseite: buy oder sell | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Preisdaten und Metadaten | + +### `polymarket_get_midpoint` + +Abrufen des Mittelpreises für einen bestimmten Token + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Ja | Die CLOB-Token-ID (aus market clobTokenIds) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Mittelpreisdaten und Metadaten | + +### `polymarket_get_price_history` + +Abrufen historischer Preisdaten für einen bestimmten Markttoken + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Ja | Die CLOB-Token-ID (aus market clobTokenIds) | +| `interval` | string | Nein | Zeitraum, der zum aktuellen Zeitpunkt endet (1m, 1h, 6h, 1d, 1w, max). Schließt sich gegenseitig mit startTs/endTs aus. | +| `fidelity` | number | Nein | Datenauflösung in Minuten (z.B. 60 für stündlich) | +| `startTs` | number | Nein | Startzeitstempel (Unix-Sekunden UTC) | +| `endTs` | number | Nein | Endzeitstempel (Unix-Sekunden UTC) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Preisverlaufsdaten und Metadaten | + +### `polymarket_get_last_trade_price` + +Den letzten Handelspreis für einen bestimmten Token abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Ja | Die CLOB-Token-ID \(aus market clobTokenIds\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Letzter Handelspreis und Metadaten | + +### `polymarket_get_spread` + +Die Geld-Brief-Spanne für einen bestimmten Token abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Ja | Die CLOB-Token-ID \(aus market clobTokenIds\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Spread-Daten und Metadaten | + +### `polymarket_get_tick_size` + +Die minimale Tickgröße für einen bestimmten Token abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Ja | Die CLOB-Token-ID \(aus market clobTokenIds\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Tickgröße und Metadaten | + +### `polymarket_get_positions` + +Benutzerpositionen von Polymarket abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `user` | string | Ja | Wallet-Adresse des Benutzers | +| `market` | string | Nein | Optionale Markt-ID zum Filtern von Positionen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Positionsdaten und Metadaten | + +### `polymarket_get_trades` + +Handelshistorie von Polymarket abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `user` | string | Nein | Wallet-Adresse des Benutzers zum Filtern von Trades | +| `market` | string | Nein | Markt-ID zum Filtern von Trades | +| `limit` | string | Nein | Anzahl der Ergebnisse pro Seite \(empfohlen: 25-50\) | +| `offset` | string | Nein | Paginierungsoffset \(überspringe so viele Ergebnisse\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Handelsdaten und Metadaten | + +## Hinweise + +- Kategorie: `tools` +- Typ: `polymarket` diff --git a/apps/docs/content/docs/de/tools/pylon.mdx b/apps/docs/content/docs/de/tools/pylon.mdx index df0f16086..987cd526d 100644 --- a/apps/docs/content/docs/de/tools/pylon.mdx +++ b/apps/docs/content/docs/de/tools/pylon.mdx @@ -83,10 +83,17 @@ Ein neues Anliegen mit bestimmten Eigenschaften erstellen | Parameter | Typ | Erforderlich | Beschreibung | | --------- | ---- | -------- | ----------- | | `apiToken` | string | Ja | Pylon API-Token | -| `title` | string | Ja | Titel des Anliegens | -| `bodyHtml` | string | Ja | Inhalt des Anliegens im HTML-Format | -| `accountId` | string | Nein | Konto-ID, die mit dem Anliegen verknüpft werden soll | -| `assigneeId` | string | Nein | Benutzer-ID, der das Anliegen zugewiesen werden soll | +| `title` | string | Ja | Titel des Problems | +| `bodyHtml` | string | Ja | Inhalt des Problems im HTML-Format | +| `accountId` | string | Nein | Konto-ID, die mit dem Problem verknüpft werden soll | +| `assigneeId` | string | Nein | Benutzer-ID, der das Problem zugewiesen werden soll | +| `teamId` | string | Nein | Team-ID, dem das Problem zugewiesen werden soll | +| `requesterId` | string | Nein | Anforderer-Benutzer-ID \(Alternative zu requester_email\) | +| `requesterEmail` | string | Nein | E-Mail-Adresse des Anforderers \(Alternative zu requester_id\) | +| `priority` | string | Nein | Priorität des Problems | +| `tags` | string | Nein | Durch Komma getrennte Tag-IDs | +| `customFields` | string | Nein | Benutzerdefinierte Felder als JSON-Objekt | +| `attachmentUrls` | string | Nein | Durch Komma getrennte Anhang-URLs | #### Output @@ -119,15 +126,18 @@ Aktualisiert ein bestehendes Issue #### Input -| Parameter | Type | Erforderlich | Beschreibung | +| Parameter | Typ | Erforderlich | Beschreibung | | --------- | ---- | -------- | ----------- | | `apiToken` | string | Ja | Pylon API-Token | -| `issueId` | string | Ja | Die ID des zu aktualisierenden Issues | -| `state` | string | Nein | Issue-Status | -| `assigneeId` | string | Nein | Benutzer-ID, der das Issue zugewiesen werden soll | -| `teamId` | string | Nein | Team-ID, dem das Issue zugewiesen werden soll | -| `tags` | string | Nein | Kommagetrennte Tag-IDs | +| `issueId` | string | Ja | Die ID des zu aktualisierenden Problems | +| `state` | string | Nein | Status des Problems | +| `assigneeId` | string | Nein | Benutzer-ID, der das Problem zugewiesen werden soll | +| `teamId` | string | Nein | Team-ID, dem das Problem zugewiesen werden soll | +| `tags` | string | Nein | Durch Komma getrennte Tag-IDs | | `customFields` | string | Nein | Benutzerdefinierte Felder als JSON-Objekt | +| `customerPortalVisible` | boolean | Nein | Ob das Problem im Kundenportal sichtbar ist | +| `requesterId` | string | Nein | Anforderer-Benutzer-ID | +| `accountId` | string | Nein | Konto-ID, die mit dem Problem verknüpft werden soll | #### Output diff --git a/apps/docs/content/docs/de/tools/shopify.mdx b/apps/docs/content/docs/de/tools/shopify.mdx new file mode 100644 index 000000000..5d17a5d1f --- /dev/null +++ b/apps/docs/content/docs/de/tools/shopify.mdx @@ -0,0 +1,444 @@ +--- +title: Shopify +description: Verwalte Produkte, Bestellungen, Kunden und Lagerbestand in deinem Shopify-Shop +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Shopify](https://www.shopify.com/) ist eine führende E-Commerce-Plattform, die entwickelt wurde, um Händlern beim Aufbau, Betrieb und Wachstum ihrer Online-Shops zu helfen. Shopify macht es einfach, jeden Aspekt deines Shops zu verwalten, von Produkten und Lagerbestand bis hin zu Bestellungen und Kunden. + +Mit Shopify in Sim können deine Agenten: + +- **Produkte erstellen und verwalten**: Neue Produkte hinzufügen, Produktdetails aktualisieren und Produkte aus deinem Shop entfernen. +- **Bestellungen auflisten und abrufen**: Informationen über Kundenbestellungen erhalten, einschließlich Filterung und Bestellverwaltung. +- **Kunden verwalten**: Auf Kundendetails zugreifen und diese aktualisieren oder neue Kunden zu deinem Shop hinzufügen. +- **Lagerbestände anpassen**: Produktbestände programmatisch ändern, um deinen Lagerbestand genau zu halten. + +Nutze Sims Shopify-Integration, um gängige Shop-Management-Workflows zu automatisieren – wie Lagerbestandssynchronisierung, Auftragsabwicklung oder Angebotsverwaltung – direkt aus deinen Automatisierungen heraus. Ermögliche deinen Agenten, auf alle deine Shop-Daten zuzugreifen, sie zu aktualisieren und zu organisieren, mit einfachen, programmatischen Tools. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanleitung + +Integriere Shopify in deinen Workflow. Verwalte Produkte, Bestellungen, Kunden und Lagerbestand. Erstelle, lese, aktualisiere und lösche Produkte. Liste und verwalte Bestellungen. Bearbeite Kundendaten und passe Lagerbestände an. + +## Tools + +### `shopify_create_product` + +Erstelle ein neues Produkt in deinem Shopify-Shop + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Deine Shopify-Shop-Domain \(z.B. meinshop.myshopify.com\) | +| `title` | string | Ja | Produkttitel | +| `descriptionHtml` | string | Nein | Produktbeschreibung \(HTML\) | +| `vendor` | string | Nein | Produktanbieter/Marke | +| `productType` | string | Nein | Produkttyp/Kategorie | +| `tags` | array | Nein | Produkt-Tags | +| `status` | string | Nein | Produktstatus \(ACTIVE, DRAFT, ARCHIVED\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `product` | object | Das erstellte Produkt | + +### `shopify_get_product` + +Ein einzelnes Produkt anhand der ID aus Ihrem Shopify-Shop abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Shop-Domain \(z.B. mystore.myshopify.com\) | +| `productId` | string | Ja | Produkt-ID \(gid://shopify/Product/123456789\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `product` | object | Die Produktdetails | + +### `shopify_list_products` + +Produkte aus Ihrem Shopify-Shop mit optionaler Filterung auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Shop-Domain \(z.B. mystore.myshopify.com\) | +| `first` | number | Nein | Anzahl der zurückzugebenden Produkte \(Standard: 50, max: 250\) | +| `query` | string | Nein | Suchanfrage zum Filtern von Produkten \(z.B. "title:shirt" oder "vendor:Nike" oder "status:active"\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `products` | array | Liste der Produkte | +| `pageInfo` | object | Paginierungsinformationen | + +### `shopify_update_product` + +Ein bestehendes Produkt in Ihrem Shopify-Shop aktualisieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Shop-Domain \(z.B. mystore.myshopify.com\) | +| `productId` | string | Ja | Zu aktualisierende Produkt-ID \(gid://shopify/Product/123456789\) | +| `title` | string | Nein | Neuer Produkttitel | +| `descriptionHtml` | string | Nein | Neue Produktbeschreibung \(HTML\) | +| `vendor` | string | Nein | Neuer Produktanbieter/Marke | +| `productType` | string | Nein | Neuer Produkttyp/Kategorie | +| `tags` | array | Nein | Neue Produkt-Tags | +| `status` | string | Nein | Neuer Produktstatus \(ACTIVE, DRAFT, ARCHIVED\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `product` | object | Das aktualisierte Produkt | + +### `shopify_delete_product` + +Ein Produkt aus Ihrem Shopify-Shop löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Shop-Domain \(z.B. mystore.myshopify.com\) | +| `productId` | string | Ja | Produkt-ID zum Löschen \(gid://shopify/Product/123456789\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `deletedId` | string | Die ID des gelöschten Produkts | + +### `shopify_get_order` + +Eine einzelne Bestellung anhand der ID aus Ihrem Shopify-Shop abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Shop-Domain \(z.B. mystore.myshopify.com\) | +| `orderId` | string | Ja | Bestell-ID \(gid://shopify/Order/123456789\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `order` | object | Die Bestelldetails | + +### `shopify_list_orders` + +Bestellungen aus Ihrem Shopify-Shop mit optionaler Filterung auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Shop-Domain \(z.B. mystore.myshopify.com\) | +| `first` | number | Nein | Anzahl der zurückzugebenden Bestellungen \(Standard: 50, max: 250\) | +| `status` | string | Nein | Nach Bestellstatus filtern \(open, closed, cancelled, any\) | +| `query` | string | Nein | Suchanfrage zum Filtern von Bestellungen \(z.B. "financial_status:paid" oder "fulfillment_status:unfulfilled" oder "email:customer@example.com"\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `orders` | array | Liste der Bestellungen | +| `pageInfo` | object | Paginierungsinformationen | + +### `shopify_update_order` + +Aktualisieren einer bestehenden Bestellung in Ihrem Shopify-Shop (Hinweis, Tags, E-Mail) + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Shop-Domain \(z.B. mystore.myshopify.com\) | +| `orderId` | string | Ja | Zu aktualisierende Bestell-ID \(gid://shopify/Order/123456789\) | +| `note` | string | Nein | Neuer Bestellhinweis | +| `tags` | array | Nein | Neue Bestell-Tags | +| `email` | string | Nein | Neue Kunden-E-Mail für die Bestellung | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `order` | object | Die aktualisierte Bestellung | + +### `shopify_cancel_order` + +Stornieren einer Bestellung in Ihrem Shopify-Shop + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Shop-Domain \(z.B. mystore.myshopify.com\) | +| `orderId` | string | Ja | Zu stornierende Bestell-ID \(gid://shopify/Order/123456789\) | +| `reason` | string | Ja | Stornierungsgrund \(CUSTOMER, DECLINED, FRAUD, INVENTORY, STAFF, OTHER\) | +| `notifyCustomer` | boolean | Nein | Ob der Kunde über die Stornierung benachrichtigt werden soll | +| `refund` | boolean | Nein | Ob die Bestellung erstattet werden soll | +| `restock` | boolean | Nein | Ob der Bestand wieder aufgefüllt werden soll | +| `staffNote` | string | Nein | Ein Hinweis zur Stornierung für Mitarbeiter | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `order` | object | Das Stornierungsergebnis | + +### `shopify_create_customer` + +Einen neuen Kunden in Ihrem Shopify-Shop erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Shop-Domain \(z.B. mystore.myshopify.com\) | +| `email` | string | Nein | E-Mail-Adresse des Kunden | +| `firstName` | string | Nein | Vorname des Kunden | +| `lastName` | string | Nein | Nachname des Kunden | +| `phone` | string | Nein | Telefonnummer des Kunden | +| `note` | string | Nein | Notiz zum Kunden | +| `tags` | array | Nein | Kundentags | +| `addresses` | array | Nein | Kundenanschriften | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `customer` | object | Der erstellte Kunde | + +### `shopify_get_customer` + +Einen einzelnen Kunden anhand der ID aus Ihrem Shopify-Shop abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Shop-Domain \(z.B. mystore.myshopify.com\) | +| `customerId` | string | Ja | Kunden-ID \(gid://shopify/Customer/123456789\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `customer` | object | Die Kundendetails | + +### `shopify_list_customers` + +Kunden aus deinem Shopify-Shop mit optionaler Filterung auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Deine Shopify-Shop-Domain \(z.B. meinshop.myshopify.com\) | +| `first` | number | Nein | Anzahl der zurückzugebenden Kunden \(Standard: 50, max: 250\) | +| `query` | string | Nein | Suchanfrage zum Filtern von Kunden \(z.B. "first_name:John" oder "last_name:Smith" oder "email:*@gmail.com" oder "tag:vip"\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `customers` | array | Liste der Kunden | +| `pageInfo` | object | Paginierungsinformationen | + +### `shopify_update_customer` + +Einen bestehenden Kunden in deinem Shopify-Shop aktualisieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Deine Shopify-Shop-Domain \(z.B. meinshop.myshopify.com\) | +| `customerId` | string | Ja | Kunden-ID zum Aktualisieren \(gid://shopify/Customer/123456789\) | +| `email` | string | Nein | Neue E-Mail-Adresse des Kunden | +| `firstName` | string | Nein | Neuer Vorname des Kunden | +| `lastName` | string | Nein | Neuer Nachname des Kunden | +| `phone` | string | Nein | Neue Telefonnummer des Kunden | +| `note` | string | Nein | Neue Notiz über den Kunden | +| `tags` | array | Nein | Neue Kunden-Tags | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `customer` | object | Der aktualisierte Kunde | + +### `shopify_delete_customer` + +Einen Kunden aus Ihrem Shopify-Shop löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Shop-Domain (z.B. meinshop.myshopify.com) | +| `customerId` | string | Ja | Kunden-ID zum Löschen (gid://shopify/Customer/123456789) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `deletedId` | string | Die ID des gelöschten Kunden | + +### `shopify_list_inventory_items` + +Bestandsartikel aus Ihrem Shopify-Shop auflisten. Verwenden Sie dies, um Bestandsartikel-IDs anhand der SKU zu finden. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Shop-Domain (z.B. meinshop.myshopify.com) | +| `first` | number | Nein | Anzahl der zurückzugebenden Bestandsartikel (Standard: 50, max: 250) | +| `query` | string | Nein | Suchanfrage zum Filtern von Bestandsartikeln (z.B. "sku:ABC123") | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `inventoryItems` | array | Liste der Bestandsartikel mit ihren IDs, SKUs und Lagerbeständen | +| `pageInfo` | object | Paginierungsinformationen | + +### `shopify_get_inventory_level` + +Bestandsmenge für eine Produktvariante an einem bestimmten Standort abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Shop-Domain (z.B. meinshop.myshopify.com) | +| `inventoryItemId` | string | Ja | Bestandsartikel-ID (gid://shopify/InventoryItem/123456789) | +| `locationId` | string | Nein | Standort-ID zum Filtern (optional) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `inventoryLevel` | object | Die Details zum Bestandsniveau | + +### `shopify_adjust_inventory` + +Bestandsmenge für eine Produktvariante an einem bestimmten Standort anpassen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Store-Domain (z.B. mystore.myshopify.com) | +| `inventoryItemId` | string | Ja | Inventar-Element-ID (gid://shopify/InventoryItem/123456789) | +| `locationId` | string | Ja | Standort-ID (gid://shopify/Location/123456789) | +| `delta` | number | Ja | Anzahl der Anpassung (positiv für Erhöhung, negativ für Verringerung) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `inventoryLevel` | object | Das Ergebnis der Bestandsanpassung | + +### `shopify_list_locations` + +Listet Bestandsstandorte aus Ihrem Shopify-Store auf. Verwenden Sie dies, um Standort-IDs zu finden, die für Bestandsoperationen benötigt werden. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Store-Domain (z.B. mystore.myshopify.com) | +| `first` | number | Nein | Anzahl der zurückzugebenden Standorte (Standard: 50, max: 250) | +| `includeInactive` | boolean | Nein | Ob deaktivierte Standorte einbezogen werden sollen (Standard: false) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `locations` | array | Liste der Standorte mit ihren IDs, Namen und Adressen | +| `pageInfo` | object | Paginierungsinformationen | + +### `shopify_create_fulfillment` + +Erstelle eine Fulfillment-Anfrage, um Bestellartikel als versendet zu markieren. Erfordert eine Fulfillment-Auftrags-ID (diese findest du in den Bestelldetails). + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Deine Shopify-Store-Domain \(z.B. meinshop.myshopify.com\) | +| `fulfillmentOrderId` | string | Ja | Die Fulfillment-Auftrags-ID \(z.B. gid://shopify/FulfillmentOrder/123456789\) | +| `trackingNumber` | string | Nein | Sendungsverfolgungsnummer | +| `trackingCompany` | string | Nein | Name des Versanddienstleisters \(z.B. UPS, FedEx, USPS, DHL\) | +| `trackingUrl` | string | Nein | URL zur Sendungsverfolgung | +| `notifyCustomer` | boolean | Nein | Ob eine Versandbestätigungs-E-Mail an den Kunden gesendet werden soll \(Standard: true\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `fulfillment` | object | Das erstellte Fulfillment mit Tracking-Informationen und erfüllten Artikeln | + +### `shopify_list_collections` + +Liste Produktkollektionen aus deinem Shopify-Shop auf. Filtere nach Titel, Typ (benutzerdefiniert/smart) oder Handle. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Deine Shopify-Store-Domain \(z.B. meinshop.myshopify.com\) | +| `first` | number | Nein | Anzahl der zurückzugebenden Kollektionen \(Standard: 50, max: 250\) | +| `query` | string | Nein | Suchanfrage zum Filtern von Kollektionen \(z.B. "title:Sommer" oder "collection_type:smart"\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `collections` | array | Liste der Kollektionen mit ihren IDs, Titeln und Produktanzahlen | +| `pageInfo` | object | Paginierungsinformationen | + +### `shopify_get_collection` + +Rufen Sie eine bestimmte Kollektion anhand ihrer ID ab, einschließlich ihrer Produkte. Verwenden Sie dies, um Produkte innerhalb einer Kollektion abzurufen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Ja | Ihre Shopify-Store-Domain \(z.B. mystore.myshopify.com\) | +| `collectionId` | string | Ja | Die Kollektions-ID \(z.B. gid://shopify/Collection/123456789\) | +| `productsFirst` | number | Nein | Anzahl der Produkte, die aus dieser Kollektion zurückgegeben werden sollen \(Standard: 50, max: 250\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `collection` | object | Die Kollektionsdetails einschließlich ihrer Produkte | + +## Hinweise + +- Kategorie: `tools` +- Typ: `shopify` diff --git a/apps/docs/content/docs/de/tools/ssh.mdx b/apps/docs/content/docs/de/tools/ssh.mdx new file mode 100644 index 000000000..3c2737813 --- /dev/null +++ b/apps/docs/content/docs/de/tools/ssh.mdx @@ -0,0 +1,394 @@ +--- +title: SSH +description: Verbindung zu Remote-Servern über SSH herstellen +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[SSH (Secure Shell)](https://en.wikipedia.org/wiki/Secure_Shell) ist ein weit verbreitetes Protokoll für die sichere Verbindung zu Remote-Servern, das es ermöglicht, Befehle auszuführen, Dateien zu übertragen und Systeme über verschlüsselte Kanäle zu verwalten. + +Mit SSH-Unterstützung in Sim können Ihre Agenten: + +- **Remote-Befehle ausführen**: Shell-Befehle auf jedem SSH-zugänglichen Server ausführen +- **Skripte hochladen und ausführen**: Einfaches Übertragen und Ausführen von mehrzeiligen Skripten für erweiterte Automatisierung +- **Dateien sicher übertragen**: Hoch- und Herunterladen von Dateien als Teil Ihrer Workflows (demnächst oder per Befehl) +- **Serververwaltung automatisieren**: Programmatische Durchführung von Updates, Wartung, Überwachung, Bereitstellungen und Konfigurationsaufgaben +- **Flexible Authentifizierung nutzen**: Verbindung mit Passwort- oder Private-Key-Authentifizierung, einschließlich Unterstützung für verschlüsselte Schlüssel + +Die folgenden Sim SSH-Tools ermöglichen es Ihren Agenten, mit Servern als Teil größerer Automatisierungen zu interagieren: + +- `ssh_execute_command`: Führt einen einzelnen Shell-Befehl remote aus und erfasst Ausgabe, Status und Fehler. +- `ssh_execute_script`: Lädt ein vollständiges mehrzeiliges Skript hoch und führt es auf dem Remote-System aus. +- (Weitere Tools wie Dateiübertragung kommen in Kürze.) + +Durch die Integration von SSH in Ihre Agenten-Workflows können Sie sicheren Zugriff, Remote-Operationen und Server-Orchestrierung automatisieren – und so DevOps, IT-Automatisierung und benutzerdefinierte Remote-Verwaltung rationalisieren, alles innerhalb von Sim. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanleitung + +Führen Sie Befehle aus, übertragen Sie Dateien und verwalten Sie Remote-Server über SSH. Unterstützt Passwort- und Private-Key-Authentifizierung für sicheren Serverzugriff. + +## Tools + +### `ssh_execute_command` + +Einen Shell-Befehl auf einem Remote-SSH-Server ausführen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `host` | string | Ja | SSH-Server-Hostname oder IP-Adresse | +| `port` | number | Ja | SSH-Server-Port \(Standard: 22\) | +| `username` | string | Ja | SSH-Benutzername | +| `password` | string | Nein | Passwort für die Authentifizierung \(wenn kein Private Key verwendet wird\) | +| `privateKey` | string | Nein | Private Key für die Authentifizierung \(OpenSSH-Format\) | +| `passphrase` | string | Nein | Passphrase für verschlüsselten Private Key | +| `command` | string | Ja | Shell-Befehl, der auf dem Remote-Server ausgeführt werden soll | +| `workingDirectory` | string | Nein | Arbeitsverzeichnis für die Befehlsausführung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `stdout` | string | Standardausgabe des Befehls | +| `stderr` | string | Standardfehlerausgabe | +| `exitCode` | number | Exit-Code des Befehls | +| `success` | boolean | Ob der Befehl erfolgreich war (Exit-Code 0) | +| `message` | string | Statusmeldung des Vorgangs | + +### `ssh_execute_script` + +Ein mehrzeiliges Skript auf einem entfernten SSH-Server hochladen und ausführen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `host` | string | Ja | SSH-Server-Hostname oder IP-Adresse | +| `port` | number | Ja | SSH-Server-Port (Standard: 22) | +| `username` | string | Ja | SSH-Benutzername | +| `password` | string | Nein | Passwort für die Authentifizierung (falls kein privater Schlüssel verwendet wird) | +| `privateKey` | string | Nein | Privater Schlüssel für die Authentifizierung (OpenSSH-Format) | +| `passphrase` | string | Nein | Passphrase für verschlüsselten privaten Schlüssel | +| `script` | string | Ja | Skriptinhalt zur Ausführung (bash, python, etc.) | +| `interpreter` | string | Nein | Skript-Interpreter (Standard: /bin/bash) | +| `workingDirectory` | string | Nein | Arbeitsverzeichnis für die Skriptausführung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `stdout` | string | Standardausgabe des Skripts | +| `stderr` | string | Standardfehlerausgabe | +| `exitCode` | number | Exit-Code des Skripts | +| `success` | boolean | Ob das Skript erfolgreich war (Exit-Code 0) | +| `scriptPath` | string | Temporärer Pfad, wohin das Skript hochgeladen wurde | +| `message` | string | Statusmeldung des Vorgangs | + +### `ssh_check_command_exists` + +Überprüfen, ob ein Befehl/Programm auf dem entfernten SSH-Server existiert + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `host` | string | Ja | SSH-Server-Hostname oder IP-Adresse | +| `port` | number | Ja | SSH-Server-Port \(Standard: 22\) | +| `username` | string | Ja | SSH-Benutzername | +| `password` | string | Nein | Passwort für die Authentifizierung \(wenn kein privater Schlüssel verwendet wird\) | +| `privateKey` | string | Nein | Privater Schlüssel für die Authentifizierung \(OpenSSH-Format\) | +| `passphrase` | string | Nein | Passphrase für verschlüsselten privaten Schlüssel | +| `commandName` | string | Ja | Zu überprüfender Befehlsname \(z.B. docker, git, python3\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `commandExists` | boolean | Ob der Befehl existiert | +| `commandPath` | string | Vollständiger Pfad zum Befehl \(falls gefunden\) | +| `version` | string | Versionsinformation des Befehls \(falls zutreffend\) | +| `message` | string | Statusmeldung der Operation | + +### `ssh_upload_file` + +Eine Datei auf einen entfernten SSH-Server hochladen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `host` | string | Ja | SSH-Server-Hostname oder IP-Adresse | +| `port` | number | Ja | SSH-Server-Port \(Standard: 22\) | +| `username` | string | Ja | SSH-Benutzername | +| `password` | string | Nein | Passwort für die Authentifizierung \(wenn kein privater Schlüssel verwendet wird\) | +| `privateKey` | string | Nein | Privater Schlüssel für die Authentifizierung \(OpenSSH-Format\) | +| `passphrase` | string | Nein | Passphrase für verschlüsselten privaten Schlüssel | +| `fileContent` | string | Ja | Hochzuladender Dateiinhalt \(base64-kodiert für Binärdateien\) | +| `fileName` | string | Ja | Name der hochzuladenden Datei | +| `remotePath` | string | Ja | Zielpfad auf dem entfernten Server | +| `permissions` | string | Nein | Dateiberechtigungen \(z.B. 0644\) | +| `overwrite` | boolean | Nein | Ob bestehende Dateien überschrieben werden sollen \(Standard: true\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `uploaded` | boolean | Ob die Datei erfolgreich hochgeladen wurde | +| `remotePath` | string | Endgültiger Pfad auf dem Remote-Server | +| `size` | number | Dateigröße in Bytes | +| `message` | string | Statusmeldung des Vorgangs | + +### `ssh_download_file` + +Eine Datei von einem Remote-SSH-Server herunterladen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `host` | string | Ja | SSH-Server-Hostname oder IP-Adresse | +| `port` | number | Ja | SSH-Server-Port \(Standard: 22\) | +| `username` | string | Ja | SSH-Benutzername | +| `password` | string | Nein | Passwort für die Authentifizierung \(wenn kein privater Schlüssel verwendet wird\) | +| `privateKey` | string | Nein | Privater Schlüssel für die Authentifizierung \(OpenSSH-Format\) | +| `passphrase` | string | Nein | Passphrase für verschlüsselten privaten Schlüssel | +| `remotePath` | string | Ja | Pfad der Datei auf dem Remote-Server | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `downloaded` | boolean | Ob die Datei erfolgreich heruntergeladen wurde | +| `fileContent` | string | Dateiinhalt \(base64-kodiert für Binärdateien\) | +| `fileName` | string | Name der heruntergeladenen Datei | +| `remotePath` | string | Quellpfad auf dem Remote-Server | +| `size` | number | Dateigröße in Bytes | +| `message` | string | Statusmeldung des Vorgangs | + +### `ssh_list_directory` + +Dateien und Verzeichnisse in einem Remote-Verzeichnis auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `host` | string | Ja | SSH-Server-Hostname oder IP-Adresse | +| `port` | number | Ja | SSH-Server-Port \(Standard: 22\) | +| `username` | string | Ja | SSH-Benutzername | +| `password` | string | Nein | Passwort für die Authentifizierung \(wenn kein privater Schlüssel verwendet wird\) | +| `privateKey` | string | Nein | Privater Schlüssel für die Authentifizierung \(OpenSSH-Format\) | +| `passphrase` | string | Nein | Passphrase für verschlüsselten privaten Schlüssel | +| `path` | string | Ja | Remote-Verzeichnispfad zum Auflisten | +| `detailed` | boolean | Nein | Dateidetails einschließen \(Größe, Berechtigungen, Änderungsdatum\) | +| `recursive` | boolean | Nein | Unterverzeichnisse rekursiv auflisten \(Standard: false\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `entries` | array | Array von Datei- und Verzeichniseinträgen | + +### `ssh_check_file_exists` + +Überprüfen, ob eine Datei oder ein Verzeichnis auf dem Remote-SSH-Server existiert + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `host` | string | Ja | SSH-Server-Hostname oder IP-Adresse | +| `port` | number | Ja | SSH-Server-Port \(Standard: 22\) | +| `username` | string | Ja | SSH-Benutzername | +| `password` | string | Nein | Passwort für die Authentifizierung \(wenn kein privater Schlüssel verwendet wird\) | +| `privateKey` | string | Nein | Privater Schlüssel für die Authentifizierung \(OpenSSH-Format\) | +| `passphrase` | string | Nein | Passphrase für verschlüsselten privaten Schlüssel | +| `path` | string | Ja | Remote-Datei- oder Verzeichnispfad zur Überprüfung | +| `type` | string | Nein | Erwarteter Typ: Datei, Verzeichnis oder beliebig \(Standard: beliebig\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `exists` | boolean | Ob der Pfad existiert | +| `type` | string | Typ des Pfads (Datei, Verzeichnis, Symlink, nicht_gefunden) | +| `size` | number | Dateigröße, wenn es eine Datei ist | +| `permissions` | string | Dateiberechtigungen (z.B. 0755) | +| `modified` | string | Zeitstempel der letzten Änderung | +| `message` | string | Statusmeldung des Vorgangs | + +### `ssh_create_directory` + +Erstellt ein Verzeichnis auf dem entfernten SSH-Server + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `host` | string | Ja | SSH-Server-Hostname oder IP-Adresse | +| `port` | number | Ja | SSH-Server-Port (Standard: 22) | +| `username` | string | Ja | SSH-Benutzername | +| `password` | string | Nein | Passwort für die Authentifizierung (wenn kein privater Schlüssel verwendet wird) | +| `privateKey` | string | Nein | Privater Schlüssel für die Authentifizierung (OpenSSH-Format) | +| `passphrase` | string | Nein | Passphrase für verschlüsselten privaten Schlüssel | +| `path` | string | Ja | Verzeichnispfad zum Erstellen | +| `recursive` | boolean | Nein | Übergeordnete Verzeichnisse erstellen, wenn sie nicht existieren (Standard: true) | +| `permissions` | string | Nein | Verzeichnisberechtigungen (Standard: 0755) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `created` | boolean | Ob das Verzeichnis erfolgreich erstellt wurde | +| `remotePath` | string | Erstellter Verzeichnispfad | +| `alreadyExists` | boolean | Ob das Verzeichnis bereits existierte | +| `message` | string | Statusmeldung des Vorgangs | + +### `ssh_delete_file` + +Löschen einer Datei oder eines Verzeichnisses vom entfernten SSH-Server + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `host` | string | Ja | SSH-Server-Hostname oder IP-Adresse | +| `port` | number | Ja | SSH-Server-Port \(Standard: 22\) | +| `username` | string | Ja | SSH-Benutzername | +| `password` | string | Nein | Passwort für die Authentifizierung \(wenn kein privater Schlüssel verwendet wird\) | +| `privateKey` | string | Nein | Privater Schlüssel für die Authentifizierung \(OpenSSH-Format\) | +| `passphrase` | string | Nein | Passphrase für verschlüsselten privaten Schlüssel | +| `path` | string | Ja | Zu löschender Pfad | +| `recursive` | boolean | Nein | Verzeichnisse rekursiv löschen \(Standard: false\) | +| `force` | boolean | Nein | Löschen ohne Bestätigung erzwingen \(Standard: false\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `deleted` | boolean | Ob der Pfad erfolgreich gelöscht wurde | +| `remotePath` | string | Gelöschter Pfad | +| `message` | string | Statusmeldung des Vorgangs | + +### `ssh_move_rename` + +Verschieben oder umbenennen einer Datei oder eines Verzeichnisses auf dem entfernten SSH-Server + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `host` | string | Ja | SSH-Server-Hostname oder IP-Adresse | +| `port` | number | Ja | SSH-Server-Port \(Standard: 22\) | +| `username` | string | Ja | SSH-Benutzername | +| `password` | string | Nein | Passwort für die Authentifizierung \(wenn kein privater Schlüssel verwendet wird\) | +| `privateKey` | string | Nein | Privater Schlüssel für die Authentifizierung \(OpenSSH-Format\) | +| `passphrase` | string | Nein | Passphrase für verschlüsselten privaten Schlüssel | +| `sourcePath` | string | Ja | Aktueller Pfad der Datei oder des Verzeichnisses | +| `destinationPath` | string | Ja | Neuer Pfad für die Datei oder das Verzeichnis | +| `overwrite` | boolean | Nein | Ziel überschreiben, falls es existiert \(Standard: false\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `moved` | boolean | Ob der Vorgang erfolgreich war | +| `sourcePath` | string | Ursprünglicher Pfad | +| `destinationPath` | string | Neuer Pfad | +| `message` | string | Statusmeldung des Vorgangs | + +### `ssh_get_system_info` + +Systeminformationen vom entfernten SSH-Server abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `host` | string | Ja | SSH-Server-Hostname oder IP-Adresse | +| `port` | number | Ja | SSH-Server-Port \(Standard: 22\) | +| `username` | string | Ja | SSH-Benutzername | +| `password` | string | Nein | Passwort für die Authentifizierung \(wenn kein privater Schlüssel verwendet wird\) | +| `privateKey` | string | Nein | Privater Schlüssel für die Authentifizierung \(OpenSSH-Format\) | +| `passphrase` | string | Nein | Passphrase für verschlüsselten privaten Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `hostname` | string | Server-Hostname | +| `os` | string | Betriebssystem \(z.B. Linux, Darwin\) | +| `architecture` | string | CPU-Architektur \(z.B. x64, arm64\) | +| `uptime` | number | Systemlaufzeit in Sekunden | +| `memory` | json | Speicherinformationen \(gesamt, frei, verwendet\) | +| `diskSpace` | json | Festplattenplatzinformationen \(gesamt, frei, verwendet\) | +| `message` | string | Statusmeldung des Vorgangs | + +### `ssh_read_file_content` + +Inhalt einer entfernten Datei lesen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `host` | string | Ja | SSH-Server-Hostname oder IP-Adresse | +| `port` | number | Ja | SSH-Server-Port \(Standard: 22\) | +| `username` | string | Ja | SSH-Benutzername | +| `password` | string | Nein | Passwort für die Authentifizierung \(wenn kein privater Schlüssel verwendet wird\) | +| `privateKey` | string | Nein | Privater Schlüssel für die Authentifizierung \(OpenSSH-Format\) | +| `passphrase` | string | Nein | Passphrase für verschlüsselten privaten Schlüssel | +| `path` | string | Ja | Pfad zur entfernten Datei, die gelesen werden soll | +| `encoding` | string | Nein | Dateikodierung \(Standard: utf-8\) | +| `maxSize` | number | Nein | Maximale zu lesende Dateigröße in MB \(Standard: 10\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `content` | string | Dateiinhalt als Zeichenfolge | +| `size` | number | Dateigröße in Bytes | +| `lines` | number | Anzahl der Zeilen in der Datei | +| `remotePath` | string | Pfad zur entfernten Datei | +| `message` | string | Statusmeldung des Vorgangs | + +### `ssh_write_file_content` + +Inhalt in eine entfernte Datei schreiben oder anhängen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `host` | string | Ja | SSH-Server-Hostname oder IP-Adresse | +| `port` | number | Ja | SSH-Server-Port \(Standard: 22\) | +| `username` | string | Ja | SSH-Benutzername | +| `password` | string | Nein | Passwort für die Authentifizierung \(wenn kein privater Schlüssel verwendet wird\) | +| `privateKey` | string | Nein | Privater Schlüssel für die Authentifizierung \(OpenSSH-Format\) | +| `passphrase` | string | Nein | Passphrase für verschlüsselten privaten Schlüssel | +| `path` | string | Ja | Pfad zur entfernten Datei, in die geschrieben werden soll | +| `content` | string | Ja | Inhalt, der in die Datei geschrieben werden soll | +| `mode` | string | Nein | Schreibmodus: überschreiben, anhängen oder erstellen \(Standard: überschreiben\) | +| `permissions` | string | Nein | Dateiberechtigungen \(z.B. 0644\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `written` | boolean | Ob die Datei erfolgreich geschrieben wurde | +| `remotePath` | string | Dateipfad | +| `size` | number | Endgültige Dateigröße in Bytes | +| `message` | string | Statusmeldung der Operation | + +## Hinweise + +- Kategorie: `tools` +- Typ: `ssh` diff --git a/apps/docs/content/docs/de/tools/wordpress.mdx b/apps/docs/content/docs/de/tools/wordpress.mdx new file mode 100644 index 000000000..c30808ea5 --- /dev/null +++ b/apps/docs/content/docs/de/tools/wordpress.mdx @@ -0,0 +1,566 @@ +--- +title: WordPress +description: WordPress-Inhalte verwalten +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[WordPress](https://wordpress.org/) ist das weltweit führende Open-Source-Content-Management-System, das es einfach macht, Websites, Blogs und alle Arten von Online-Inhalten zu veröffentlichen und zu verwalten. Mit WordPress können Sie Beiträge oder Seiten erstellen und aktualisieren, Ihre Inhalte mit Kategorien und Schlagwörtern organisieren, Mediendateien verwalten, Kommentare moderieren und Benutzerkonten verwalten – so können Sie alles von persönlichen Blogs bis hin zu komplexen Unternehmenswebsites betreiben. + +Die Integration von Sim mit WordPress ermöglicht es Ihren Agenten, wesentliche Website-Aufgaben zu automatisieren. Sie können programmatisch neue Blogbeiträge mit spezifischen Titeln, Inhalten, Kategorien, Schlagwörtern und Hauptbildern erstellen. Das Aktualisieren bestehender Beiträge – wie das Ändern von Inhalten, Titeln oder Veröffentlichungsstatus – ist unkompliziert. Sie können Inhalte auch veröffentlichen oder als Entwürfe speichern, statische Seiten verwalten, mit Medien-Uploads arbeiten, Kommentare überwachen und Inhalte relevanten Organisationstaxonomien zuweisen. + +Durch die Verbindung von WordPress mit Ihren Automatisierungen ermöglicht Sim Ihren Agenten, die Veröffentlichung von Inhalten, redaktionelle Arbeitsabläufe und die tägliche Website-Verwaltung zu optimieren – so bleibt Ihre Website ohne manuellen Aufwand aktuell, organisiert und sicher. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanleitung + +Integrieren Sie WordPress, um Beiträge, Seiten, Medien, Kommentare, Kategorien, Schlagwörter und Benutzer zu erstellen, zu aktualisieren und zu verwalten. Unterstützt WordPress.com-Websites über OAuth und selbst gehostete WordPress-Websites mit Anwendungspasswort-Authentifizierung. + +## Tools + +### `wordpress_create_post` + +Einen neuen Blogbeitrag in WordPress.com erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder meineseite.wordpress.com\) | +| `title` | string | Ja | Beitragstitel | +| `content` | string | Nein | Beitragsinhalt \(HTML oder Klartext\) | +| `status` | string | Nein | Beitragsstatus: publish, draft, pending, private oder future | +| `excerpt` | string | Nein | Beitragsauszug | +| `categories` | string | Nein | Kommagetrennte Kategorie-IDs | +| `tags` | string | Nein | Kommagetrennte Schlagwort-IDs | +| `featuredMedia` | number | Nein | Medien-ID des Hauptbildes | +| `slug` | string | Nein | URL-Slug für den Beitrag | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `post` | object | Der erstellte Beitrag | + +### `wordpress_update_post` + +Aktualisieren eines vorhandenen Blog-Beitrags in WordPress.com + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `postId` | number | Ja | Die ID des zu aktualisierenden Beitrags | +| `title` | string | Nein | Beitragstitel | +| `content` | string | Nein | Beitragsinhalt \(HTML oder Klartext\) | +| `status` | string | Nein | Beitragsstatus: publish, draft, pending, private oder future | +| `excerpt` | string | Nein | Beitragsauszug | +| `categories` | string | Nein | Kommagetrennte Kategorie-IDs | +| `tags` | string | Nein | Kommagetrennte Tag-IDs | +| `featuredMedia` | number | Nein | Medien-ID des Beitragsbilds | +| `slug` | string | Nein | URL-Slug für den Beitrag | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `post` | object | Der aktualisierte Beitrag | + +### `wordpress_delete_post` + +Löschen eines Blog-Beitrags von WordPress.com + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `postId` | number | Ja | Die ID des zu löschenden Beitrags | +| `force` | boolean | Nein | Papierkorb umgehen und dauerhaft löschen erzwingen | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `deleted` | boolean | Gibt an, ob der Beitrag gelöscht wurde | +| `post` | object | Der gelöschte Beitrag | + +### `wordpress_get_post` + +Einen einzelnen Blog-Beitrag von WordPress.com anhand der ID abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `postId` | number | Ja | Die ID des abzurufenden Beitrags | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `post` | object | Der abgerufene Beitrag | + +### `wordpress_list_posts` + +Blog-Beiträge von WordPress.com mit optionalen Filtern auflisten + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `perPage` | number | Nein | Anzahl der Beiträge pro Seite \(Standard: 10, max: 100\) | +| `page` | number | Nein | Seitennummer für Paginierung | +| `status` | string | Nein | Beitragsstatus-Filter: publish, draft, pending, private | +| `author` | number | Nein | Nach Autor-ID filtern | +| `categories` | string | Nein | Kommagetrennte Kategorie-IDs zum Filtern | +| `tags` | string | Nein | Kommagetrennte Tag-IDs zum Filtern | +| `search` | string | Nein | Suchbegriff zum Filtern von Beiträgen | +| `orderBy` | string | Nein | Sortieren nach Feld: date, id, title, slug, modified | +| `order` | string | Nein | Sortierrichtung: asc oder desc | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `posts` | array | Liste der Beiträge | + +### `wordpress_create_page` + +Eine neue Seite in WordPress.com erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder meinseite.wordpress.com\) | +| `title` | string | Ja | Seitentitel | +| `content` | string | Nein | Seiteninhalt \(HTML oder Klartext\) | +| `status` | string | Nein | Seitenstatus: publish, draft, pending, private | +| `excerpt` | string | Nein | Seitenauszug | +| `parent` | number | Nein | Übergeordnete Seiten-ID für hierarchische Seiten | +| `menuOrder` | number | Nein | Reihenfolge im Seitenmenü | +| `featuredMedia` | number | Nein | Medien-ID des Beitragsbilds | +| `slug` | string | Nein | URL-Slug für die Seite | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `page` | object | Die erstellte Seite | + +### `wordpress_update_page` + +Eine bestehende Seite in WordPress.com aktualisieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder meinseite.wordpress.com\) | +| `pageId` | number | Ja | Die ID der zu aktualisierenden Seite | +| `title` | string | Nein | Seitentitel | +| `content` | string | Nein | Seiteninhalt \(HTML oder Klartext\) | +| `status` | string | Nein | Seitenstatus: publish, draft, pending, private | +| `excerpt` | string | Nein | Seitenauszug | +| `parent` | number | Nein | Übergeordnete Seiten-ID für hierarchische Seiten | +| `menuOrder` | number | Nein | Reihenfolge im Seitenmenü | +| `featuredMedia` | number | Nein | Medien-ID des Beitragsbilds | +| `slug` | string | Nein | URL-Slug für die Seite | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `page` | object | Die aktualisierte Seite | + +### `wordpress_delete_page` + +Eine Seite von WordPress.com löschen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `pageId` | number | Ja | Die ID der zu löschenden Seite | +| `force` | boolean | Nein | Papierkorb umgehen und dauerhaft löschen erzwingen | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `deleted` | boolean | Ob die Seite gelöscht wurde | +| `page` | object | Die gelöschte Seite | + +### `wordpress_get_page` + +Eine einzelne Seite von WordPress.com anhand der ID abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `pageId` | number | Ja | Die ID der abzurufenden Seite | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `page` | object | Die abgerufene Seite | + +### `wordpress_list_pages` + +Seiten von WordPress.com mit optionalen Filtern auflisten + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `perPage` | number | Nein | Anzahl der Seiten pro Anfrage \(Standard: 10, max: 100\) | +| `page` | number | Nein | Seitennummer für Paginierung | +| `status` | string | Nein | Seitenstatus-Filter: publish, draft, pending, private | +| `parent` | number | Nein | Nach übergeordneter Seiten-ID filtern | +| `search` | string | Nein | Suchbegriff zum Filtern von Seiten | +| `orderBy` | string | Nein | Sortieren nach Feld: date, id, title, slug, modified, menu_order | +| `order` | string | Nein | Sortierrichtung: asc oder desc | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `pages` | array | Liste der Seiten | + +### `wordpress_upload_media` + +Eine Mediendatei (Bild, Video, Dokument) zu WordPress.com hochladen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Website-ID oder Domain \(z.B. 12345678 oder meinwebsite.wordpress.com\) | +| `file` | string | Ja | Base64-kodierte Dateidaten oder URL, von der die Datei abgerufen werden soll | +| `filename` | string | Ja | Dateiname mit Erweiterung \(z.B. bild.jpg\) | +| `title` | string | Nein | Medientitel | +| `caption` | string | Nein | Medienunterschrift | +| `altText` | string | Nein | Alternativer Text für Barrierefreiheit | +| `description` | string | Nein | Medienbeschreibung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `media` | object | Das hochgeladene Medienelement | + +### `wordpress_get_media` + +Ein einzelnes Medienelement von WordPress.com anhand der ID abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Website-ID oder Domain \(z.B. 12345678 oder meinwebsite.wordpress.com\) | +| `mediaId` | number | Ja | Die ID des abzurufenden Medienelements | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `media` | object | Das abgerufene Medienelement | + +### `wordpress_list_media` + +Medienelemente aus der WordPress.com-Medienbibliothek auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `perPage` | number | Nein | Anzahl der Medienelemente pro Anfrage \(Standard: 10, max: 100\) | +| `page` | number | Nein | Seitenzahl für Paginierung | +| `search` | string | Nein | Suchbegriff zum Filtern von Medien | +| `mediaType` | string | Nein | Nach Medientyp filtern: image, video, audio, application | +| `mimeType` | string | Nein | Nach spezifischem MIME-Typ filtern \(z.B. image/jpeg\) | +| `orderBy` | string | Nein | Sortieren nach Feld: date, id, title, slug | +| `order` | string | Nein | Sortierrichtung: asc oder desc | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `media` | array | Liste der Medienelemente | + +### `wordpress_delete_media` + +Ein Medienelement von WordPress.com löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `mediaId` | number | Ja | Die ID des zu löschenden Medienelements | +| `force` | boolean | Nein | Erzwungenes Löschen \(Medien haben keinen Papierkorb, daher ist das Löschen permanent\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `deleted` | boolean | Ob das Medium gelöscht wurde | +| `media` | object | Das gelöschte Medienelement | + +### `wordpress_create_comment` + +Einen neuen Kommentar zu einem WordPress.com-Beitrag erstellen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `postId` | number | Ja | Die ID des Beitrags, der kommentiert werden soll | +| `content` | string | Ja | Kommentarinhalt | +| `parent` | number | Nein | Übergeordnete Kommentar-ID für Antworten | +| `authorName` | string | Nein | Anzeigename des Kommentarautors | +| `authorEmail` | string | Nein | E-Mail des Kommentarautors | +| `authorUrl` | string | Nein | URL des Kommentarautors | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `comment` | object | Der erstellte Kommentar | + +### `wordpress_list_comments` + +Kommentare von WordPress.com mit optionalen Filtern auflisten + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `perPage` | number | Nein | Anzahl der Kommentare pro Anfrage \(Standard: 10, max: 100\) | +| `page` | number | Nein | Seitenzahl für Paginierung | +| `postId` | number | Nein | Nach Beitrags-ID filtern | +| `status` | string | Nein | Nach Kommentarstatus filtern: approved, hold, spam, trash | +| `search` | string | Nein | Suchbegriff zum Filtern von Kommentaren | +| `orderBy` | string | Nein | Sortieren nach Feld: date, id, parent | +| `order` | string | Nein | Sortierrichtung: asc oder desc | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `comments` | array | Liste der Kommentare | + +### `wordpress_update_comment` + +Aktualisieren eines Kommentars in WordPress.com (Inhalt oder Status) + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `commentId` | number | Ja | Die ID des zu aktualisierenden Kommentars | +| `content` | string | Nein | Aktualisierter Kommentarinhalt | +| `status` | string | Nein | Kommentarstatus: approved, hold, spam, trash | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `comment` | object | Der aktualisierte Kommentar | + +### `wordpress_delete_comment` + +Löschen eines Kommentars von WordPress.com + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `commentId` | number | Ja | Die ID des zu löschenden Kommentars | +| `force` | boolean | Nein | Papierkorb umgehen und dauerhaft löschen erzwingen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `deleted` | boolean | Ob der Kommentar gelöscht wurde | +| `comment` | object | Der gelöschte Kommentar | + +### `wordpress_create_category` + +Erstellen einer neuen Kategorie in WordPress.com + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder meinseite.wordpress.com\) | +| `name` | string | Ja | Kategoriename | +| `description` | string | Nein | Kategoriebeschreibung | +| `parent` | number | Nein | Übergeordnete Kategorie-ID für hierarchische Kategorien | +| `slug` | string | Nein | URL-Slug für die Kategorie | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `category` | object | Die erstellte Kategorie | + +### `wordpress_list_categories` + +Kategorien von WordPress.com auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder meinseite.wordpress.com\) | +| `perPage` | number | Nein | Anzahl der Kategorien pro Anfrage \(Standard: 10, max: 100\) | +| `page` | number | Nein | Seitenzahl für Paginierung | +| `search` | string | Nein | Suchbegriff zum Filtern von Kategorien | +| `order` | string | Nein | Sortierrichtung: asc oder desc | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `categories` | array | Liste der Kategorien | + +### `wordpress_create_tag` + +Einen neuen Tag in WordPress.com erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder meinseite.wordpress.com\) | +| `name` | string | Ja | Tag-Name | +| `description` | string | Nein | Tag-Beschreibung | +| `slug` | string | Nein | URL-Slug für den Tag | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `tag` | object | Der erstellte Tag | + +### `wordpress_list_tags` + +Tags von WordPress.com auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `perPage` | number | Nein | Anzahl der Tags pro Anfrage \(Standard: 10, max: 100\) | +| `page` | number | Nein | Seitennummer für Paginierung | +| `search` | string | Nein | Suchbegriff zum Filtern von Tags | +| `order` | string | Nein | Sortierrichtung: asc oder desc | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `tags` | array | Liste der Tags | + +### `wordpress_get_current_user` + +Informationen über den aktuell authentifizierten WordPress.com-Benutzer abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `user` | object | Der aktuelle Benutzer | + +### `wordpress_list_users` + +Benutzer von WordPress.com auflisten (erfordert Administratorrechte) + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `perPage` | number | Nein | Anzahl der Benutzer pro Anfrage \(Standard: 10, max: 100\) | +| `page` | number | Nein | Seitennummer für Paginierung | +| `search` | string | Nein | Suchbegriff zum Filtern von Benutzern | +| `roles` | string | Nein | Kommagetrennte Rollennamen zum Filtern | +| `order` | string | Nein | Sortierrichtung: asc oder desc | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `users` | array | Liste der Benutzer | + +### `wordpress_get_user` + +Einen bestimmten Benutzer von WordPress.com anhand der ID abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `userId` | number | Ja | Die ID des abzurufenden Benutzers | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `user` | object | Der abgerufene Benutzer | + +### `wordpress_search_content` + +Suche über alle Inhaltstypen in WordPress.com (Beiträge, Seiten, Medien) + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Ja | WordPress.com-Site-ID oder Domain \(z.B. 12345678 oder mysite.wordpress.com\) | +| `query` | string | Ja | Suchanfrage | +| `perPage` | number | Nein | Anzahl der Ergebnisse pro Anfrage \(Standard: 10, max: 100\) | +| `page` | number | Nein | Seitenzahl für Paginierung | +| `type` | string | Nein | Nach Inhaltstyp filtern: post, page, attachment | +| `subtype` | string | Nein | Nach Beitragstyp-Slug filtern \(z.B. post, page\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `results` | array | Suchergebnisse | + +## Notizen + +- Kategorie: `tools` +- Typ: `wordpress` diff --git a/apps/docs/content/docs/de/tools/zendesk.mdx b/apps/docs/content/docs/de/tools/zendesk.mdx index 264307aed..2cfbe6a2a 100644 --- a/apps/docs/content/docs/de/tools/zendesk.mdx +++ b/apps/docs/content/docs/de/tools/zendesk.mdx @@ -109,11 +109,14 @@ Ein neues Ticket in Zendesk erstellen mit Unterstützung für benutzerdefinierte | `subdomain` | string | Ja | Ihre Zendesk-Subdomain | | `subject` | string | Nein | Ticket-Betreff \(optional - wird automatisch generiert, wenn nicht angegeben\) | | `description` | string | Ja | Ticket-Beschreibung \(erster Kommentar\) | -| `priority` | string | Nein | Priorität \(niedrig, normal, hoch, dringend\) | -| `status` | string | Nein | Status \(neu, offen, ausstehend, angehalten, gelöst, geschlossen\) | -| `type` | string | Nein | Typ \(problem, vorfall, frage, aufgabe\) | +| `priority` | string | Nein | Priorität \(low, normal, high, urgent\) | +| `status` | string | Nein | Status \(new, open, pending, hold, solved, closed\) | +| `type` | string | Nein | Typ \(problem, incident, question, task\) | | `tags` | string | Nein | Kommagetrennte Tags | | `assigneeId` | string | Nein | Bearbeiter-Benutzer-ID | +| `groupId` | string | Nein | Gruppen-ID | +| `requesterId` | string | Nein | Anforderer-Benutzer-ID | +| `customFields` | string | Nein | Benutzerdefinierte Felder als JSON-Objekt \(z.B. \{"field_id": "value"\}\) | #### Output diff --git a/apps/docs/content/docs/de/tools/zoom.mdx b/apps/docs/content/docs/de/tools/zoom.mdx new file mode 100644 index 000000000..158b93a10 --- /dev/null +++ b/apps/docs/content/docs/de/tools/zoom.mdx @@ -0,0 +1,250 @@ +--- +title: Zoom +description: Zoom-Meetings und -Aufzeichnungen erstellen und verwalten +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Zoom](https://zoom.us/) ist eine führende cloudbasierte Kommunikationsplattform für Videomeetings, Webinare und Online-Zusammenarbeit. Sie ermöglicht Benutzern und Organisationen, Meetings einfach zu planen, zu hosten und zu verwalten und bietet Tools für Bildschirmfreigabe, Chat, Aufzeichnungen und mehr. + +Mit Zoom können Sie: + +- **Meetings planen und verwalten**: Sofortige oder geplante Meetings erstellen, einschließlich wiederkehrender Termine +- **Meeting-Optionen konfigurieren**: Meeting-Passwörter festlegen, Warteräume aktivieren und Video/Audio der Teilnehmer steuern +- **Einladungen versenden und Details teilen**: Meeting-Einladungen und Informationen zum einfachen Teilen abrufen +- **Meeting-Daten abrufen und aktualisieren**: Auf Meeting-Details zugreifen, bestehende Meetings ändern und Einstellungen programmgesteuert verwalten + +In Sim ermöglicht die Zoom-Integration Ihren Agenten die Automatisierung der Planung und Meeting-Verwaltung. Verwenden Sie Tool-Aktionen, um: + +- Neue Meetings mit benutzerdefinierten Einstellungen programmgesteuert zu erstellen +- Alle Meetings für einen bestimmten Benutzer (oder sich selbst) aufzulisten +- Details oder Einladungen für jedes Meeting abzurufen +- Bestehende Meetings direkt aus Ihren Automatisierungen zu aktualisieren oder zu löschen + +Diese Funktionen ermöglichen es Ihnen, die Remote-Zusammenarbeit zu optimieren, wiederkehrende Videositzungen zu automatisieren und die Zoom-Umgebung Ihrer Organisation als Teil Ihrer Workflows zu verwalten. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanleitung + +Integrieren Sie Zoom in Workflows. Erstellen, listen, aktualisieren und löschen Sie Zoom-Meetings. Rufen Sie Meeting-Details, Einladungen, Aufzeichnungen und Teilnehmer ab. Verwalten Sie Cloud-Aufzeichnungen programmgesteuert. + +## Tools + +### `zoom_create_meeting` + +Ein neues Zoom-Meeting erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `userId` | string | Ja | Die Benutzer-ID oder E-Mail-Adresse. Verwenden Sie "me" für den authentifizierten Benutzer. | +| `topic` | string | Ja | Meeting-Thema | +| `type` | number | Nein | Meeting-Typ: 1=sofort, 2=geplant, 3=wiederkehrend ohne feste Zeit, 8=wiederkehrend mit fester Zeit | +| `startTime` | string | Nein | Meeting-Startzeit im ISO 8601-Format \(z.B. 2025-06-03T10:00:00Z\) | +| `duration` | number | Nein | Meeting-Dauer in Minuten | +| `timezone` | string | Nein | Zeitzone für das Meeting \(z.B. Europe/Berlin\) | +| `password` | string | Nein | Meeting-Passwort | +| `agenda` | string | Nein | Meeting-Agenda | +| `hostVideo` | boolean | Nein | Mit eingeschaltetem Host-Video starten | +| `participantVideo` | boolean | Nein | Mit eingeschaltetem Teilnehmer-Video starten | +| `joinBeforeHost` | boolean | Nein | Teilnehmern erlauben, vor dem Host beizutreten | +| `muteUponEntry` | boolean | Nein | Teilnehmer beim Betreten stummschalten | +| `waitingRoom` | boolean | Nein | Warteraum aktivieren | +| `autoRecording` | string | Nein | Automatische Aufzeichnungseinstellung: local, cloud oder none | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `meeting` | object | Das erstellte Meeting mit allen seinen Eigenschaften | + +### `zoom_list_meetings` + +Alle Meetings eines Zoom-Benutzers auflisten + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `userId` | string | Ja | Die Benutzer-ID oder E-Mail-Adresse. Verwenden Sie "me" für den authentifizierten Benutzer. | +| `type` | string | Nein | Meeting-Typ-Filter: scheduled, live, upcoming, upcoming_meetings oder previous_meetings | +| `pageSize` | number | Nein | Anzahl der Datensätze pro Seite (max. 300) | +| `nextPageToken` | string | Nein | Token für Paginierung, um die nächste Ergebnisseite zu erhalten | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `meetings` | array | Liste der Meetings | +| `pageInfo` | object | Paginierungsinformationen | + +### `zoom_get_meeting` + +Details eines bestimmten Zoom-Meetings abrufen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Ja | Die Meeting-ID | +| `occurrenceId` | string | Nein | Vorkommnis-ID für wiederkehrende Meetings | +| `showPreviousOccurrences` | boolean | Nein | Frühere Vorkommnisse für wiederkehrende Meetings anzeigen | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `meeting` | object | Die Meeting-Details | + +### `zoom_update_meeting` + +Ein bestehendes Zoom-Meeting aktualisieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Ja | Die zu aktualisierende Meeting-ID | +| `topic` | string | Nein | Meeting-Thema | +| `type` | number | Nein | Meeting-Typ: 1=sofort, 2=geplant, 3=wiederkehrend ohne feste Zeit, 8=wiederkehrend mit fester Zeit | +| `startTime` | string | Nein | Meeting-Startzeit im ISO 8601-Format \(z.B. 2025-06-03T10:00:00Z\) | +| `duration` | number | Nein | Meeting-Dauer in Minuten | +| `timezone` | string | Nein | Zeitzone für das Meeting \(z.B. America/Los_Angeles\) | +| `password` | string | Nein | Meeting-Passwort | +| `agenda` | string | Nein | Meeting-Agenda | +| `hostVideo` | boolean | Nein | Mit eingeschalteter Host-Kamera starten | +| `participantVideo` | boolean | Nein | Mit eingeschalteter Teilnehmer-Kamera starten | +| `joinBeforeHost` | boolean | Nein | Teilnehmern erlauben, vor dem Host beizutreten | +| `muteUponEntry` | boolean | Nein | Teilnehmer beim Betreten stummschalten | +| `waitingRoom` | boolean | Nein | Warteraum aktivieren | +| `autoRecording` | string | Nein | Automatische Aufzeichnungseinstellung: local, cloud oder none | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Ob das Meeting erfolgreich aktualisiert wurde | + +### `zoom_delete_meeting` + +Ein Zoom-Meeting löschen oder abbrechen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Ja | Die zu löschende Meeting-ID | +| `occurrenceId` | string | Nein | Vorkommnis-ID zum Löschen eines bestimmten Vorkommnisses eines wiederkehrenden Meetings | +| `scheduleForReminder` | boolean | Nein | Erinnerungs-E-Mail zur Stornierung an Teilnehmer senden | +| `cancelMeetingReminder` | boolean | Nein | Stornierungsmail an Teilnehmer und alternative Hosts senden | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Ob das Meeting erfolgreich gelöscht wurde | + +### `zoom_get_meeting_invitation` + +Abrufen des Einladungstextes für ein Zoom-Meeting + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Ja | Die Meeting-ID | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `invitation` | string | Der Einladungstext für das Meeting | + +### `zoom_list_recordings` + +Alle Cloud-Aufzeichnungen für einen Zoom-Benutzer auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `userId` | string | Ja | Die Benutzer-ID oder E-Mail-Adresse. Verwenden Sie "me" für den authentifizierten Benutzer. | +| `from` | string | Nein | Startdatum im Format jjjj-mm-tt \(innerhalb der letzten 6 Monate\) | +| `to` | string | Nein | Enddatum im Format jjjj-mm-tt | +| `pageSize` | number | Nein | Anzahl der Datensätze pro Seite \(max. 300\) | +| `nextPageToken` | string | Nein | Token für die Paginierung, um die nächste Ergebnisseite zu erhalten | +| `trash` | boolean | Nein | Auf true setzen, um Aufzeichnungen aus dem Papierkorb aufzulisten | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `recordings` | array | Liste der Aufzeichnungen | +| `pageInfo` | object | Paginierungsinformationen | + +### `zoom_get_meeting_recordings` + +Alle Aufzeichnungen für ein bestimmtes Zoom-Meeting abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Ja | Die Meeting-ID oder Meeting-UUID | +| `includeFolderItems` | boolean | Nein | Elemente innerhalb eines Ordners einschließen | +| `ttl` | number | Nein | Gültigkeitsdauer für Download-URLs in Sekunden \(max 604800\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `recording` | object | Die Meeting-Aufzeichnung mit allen Dateien | + +### `zoom_delete_recording` + +Cloud-Aufzeichnungen für ein Zoom-Meeting löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Ja | Die Meeting-ID oder Meeting-UUID | +| `recordingId` | string | Nein | Spezifische Aufzeichnungsdatei-ID zum Löschen. Wenn nicht angegeben, werden alle Aufzeichnungen gelöscht. | +| `action` | string | Nein | Löschaktion: "trash" \(in Papierkorb verschieben\) oder "delete" \(dauerhaft löschen\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Ob die Aufzeichnung erfolgreich gelöscht wurde | + +### `zoom_list_past_participants` + +Teilnehmer eines vergangenen Zoom-Meetings auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Ja | Die vergangene Meeting-ID oder UUID | +| `pageSize` | number | Nein | Anzahl der Datensätze pro Seite \(max 300\) | +| `nextPageToken` | string | Nein | Token für Paginierung, um die nächste Ergebnisseite zu erhalten | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `participants` | array | Liste der Besprechungsteilnehmer | +| `pageInfo` | object | Paginierungsinformationen | + +## Hinweise + +- Kategorie: `tools` +- Typ: `zoom` diff --git a/apps/docs/content/docs/es/tools/ahrefs.mdx b/apps/docs/content/docs/es/tools/ahrefs.mdx new file mode 100644 index 000000000..38d065fa4 --- /dev/null +++ b/apps/docs/content/docs/es/tools/ahrefs.mdx @@ -0,0 +1,199 @@ +--- +title: Ahrefs +description: Análisis SEO con Ahrefs +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Ahrefs](https://ahrefs.com/) es un conjunto de herramientas SEO líder para analizar sitios web, seguir posiciones, monitorear backlinks e investigar palabras clave. Proporciona información detallada sobre tu propio sitio web y el de tus competidores, ayudándote a tomar decisiones basadas en datos para mejorar tu visibilidad en los buscadores. + +Con la integración de Ahrefs en Sim, puedes: + +- **Analizar Domain Rating y autoridad**: Comprobar instantáneamente el Domain Rating (DR) y el Ahrefs Rank de cualquier sitio web para evaluar su autoridad. +- **Obtener backlinks**: Recuperar una lista de backlinks que apuntan a un sitio o URL específica, con detalles como texto ancla, DR de la página referente y más. +- **Obtener estadísticas de backlinks**: Acceder a métricas sobre tipos de backlinks (dofollow, nofollow, texto, imagen, redirección, etc.) para un dominio o URL. +- **Explorar palabras clave orgánicas** *(planificado)*: Ver las palabras clave por las que un dominio se posiciona y sus posiciones en los resultados de búsqueda de Google. +- **Descubrir páginas principales** *(planificado)*: Identificar las páginas con mejor rendimiento por tráfico orgánico y enlaces. + +Estas herramientas permiten a tus agentes automatizar la investigación SEO, monitorear competidores y generar informes, todo como parte de tus automatizaciones de flujo de trabajo. Para usar la integración de Ahrefs, necesitarás una suscripción Ahrefs Enterprise con acceso a API. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra las herramientas SEO de Ahrefs en tu flujo de trabajo. Analiza calificaciones de dominio, backlinks, palabras clave orgánicas, páginas principales y más. Requiere un plan Ahrefs Enterprise con acceso a API. + +## Herramientas + +### `ahrefs_domain_rating` + +Obtén el Domain Rating (DR) y el Ahrefs Rank para un dominio objetivo. El Domain Rating muestra la fortaleza de un sitio web + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `target` | string | Sí | El dominio objetivo a analizar \(p. ej., example.com\) | +| `date` | string | No | Fecha para datos históricos en formato AAAA-MM-DD \(por defecto es hoy\) | +| `apiKey` | string | Sí | Clave API de Ahrefs | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `domainRating` | number | Puntuación de Domain Rating \(0-100\) | +| `ahrefsRank` | number | Ahrefs Rank - clasificación global basada en la fuerza del perfil de backlinks | + +### `ahrefs_backlinks` + +Obtener una lista de backlinks que apuntan a un dominio o URL objetivo. Devuelve detalles sobre cada backlink incluyendo URL de origen, texto de anclaje y domain rating. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `target` | string | Sí | El dominio o URL objetivo a analizar | +| `mode` | string | No | Modo de análisis: domain \(dominio completo\), prefix \(prefijo URL\), subdomains \(incluir todos los subdominios\), exact \(coincidencia exacta de URL\) | +| `date` | string | No | Fecha para datos históricos en formato AAAA-MM-DD \(por defecto es hoy\) | +| `limit` | number | No | Número máximo de resultados a devolver \(predeterminado: 100\) | +| `offset` | number | No | Número de resultados a omitir para paginación | +| `apiKey` | string | Sí | Clave API de Ahrefs | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `backlinks` | array | Lista de backlinks que apuntan al objetivo | + +### `ahrefs_backlinks_stats` + +Obtén estadísticas de backlinks para un dominio o URL objetivo. Devuelve totales para diferentes tipos de backlinks incluyendo enlaces dofollow, nofollow, texto, imagen y redirección. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `target` | string | Sí | El dominio o URL objetivo para analizar | +| `mode` | string | No | Modo de análisis: domain \(dominio completo\), prefix \(prefijo URL\), subdomains \(incluir todos los subdominios\), exact \(coincidencia exacta de URL\) | +| `date` | string | No | Fecha para datos históricos en formato AAAA-MM-DD \(por defecto es hoy\) | +| `apiKey` | string | Sí | Clave API de Ahrefs | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `stats` | object | Resumen de estadísticas de backlinks | + +### `ahrefs_referring_domains` + +Obtén una lista de dominios que enlazan a un dominio o URL objetivo. Devuelve dominios de referencia únicos con su calificación de dominio, recuento de backlinks y fechas de descubrimiento. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `target` | string | Sí | El dominio o URL objetivo para analizar | +| `mode` | string | No | Modo de análisis: domain \(dominio completo\), prefix \(prefijo URL\), subdomains \(incluir todos los subdominios\), exact \(coincidencia exacta de URL\) | +| `date` | string | No | Fecha para datos históricos en formato AAAA-MM-DD \(por defecto es hoy\) | +| `limit` | number | No | Número máximo de resultados a devolver \(predeterminado: 100\) | +| `offset` | number | No | Número de resultados a omitir para paginación | +| `apiKey` | string | Sí | Clave API de Ahrefs | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `referringDomains` | array | Lista de dominios que enlazan al objetivo | + +### `ahrefs_organic_keywords` + +Obtén palabras clave orgánicas por las que un dominio o URL objetivo se posiciona en los resultados de búsqueda de Google. Devuelve detalles de las palabras clave, incluyendo volumen de búsqueda, posición en el ranking y tráfico estimado. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `target` | string | Sí | El dominio o URL objetivo a analizar | +| `country` | string | No | Código de país para los resultados de búsqueda \(p. ej., us, gb, de\). Predeterminado: us | +| `mode` | string | No | Modo de análisis: domain \(dominio completo\), prefix \(prefijo de URL\), subdomains \(incluir todos los subdominios\), exact \(coincidencia exacta de URL\) | +| `date` | string | No | Fecha para datos históricos en formato AAAA-MM-DD \(por defecto: hoy\) | +| `limit` | number | No | Número máximo de resultados a devolver \(predeterminado: 100\) | +| `offset` | number | No | Número de resultados a omitir para la paginación | +| `apiKey` | string | Sí | Clave API de Ahrefs | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `keywords` | array | Lista de palabras clave orgánicas por las que se posiciona el objetivo | + +### `ahrefs_top_pages` + +Obtén las páginas principales de un dominio objetivo ordenadas por tráfico orgánico. Devuelve URLs de páginas con su tráfico, recuento de palabras clave y valor estimado del tráfico. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ---------- | ----------- | +| `target` | string | Sí | El dominio objetivo para analizar | +| `country` | string | No | Código de país para datos de tráfico \(p. ej., us, gb, de\). Predeterminado: us | +| `mode` | string | No | Modo de análisis: domain \(dominio completo\), prefix \(prefijo URL\), subdomains \(incluir todos los subdominios\) | +| `date` | string | No | Fecha para datos históricos en formato AAAA-MM-DD \(predeterminado: hoy\) | +| `limit` | number | No | Número máximo de resultados a devolver \(predeterminado: 100\) | +| `offset` | number | No | Número de resultados a omitir para paginación | +| `apiKey` | string | Sí | Clave API de Ahrefs | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `pages` | array | Lista de páginas principales por tráfico orgánico | + +### `ahrefs_keyword_overview` + +Obtener métricas detalladas para una palabra clave incluyendo volumen de búsqueda, dificultad de la palabra clave, CPC, clics y potencial de tráfico. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ---------- | ----------- | +| `keyword` | string | Sí | La palabra clave a analizar | +| `country` | string | No | Código de país para datos de palabras clave \(p. ej., us, gb, de\). Predeterminado: us | +| `apiKey` | string | Sí | Clave API de Ahrefs | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `overview` | object | Resumen de métricas de palabra clave | + +### `ahrefs_broken_backlinks` + +Obtén una lista de backlinks rotos que apuntan a un dominio o URL objetivo. Útil para identificar oportunidades de recuperación de enlaces. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `target` | string | Sí | El dominio o URL objetivo para analizar | +| `mode` | string | No | Modo de análisis: domain \(dominio completo\), prefix \(prefijo de URL\), subdomains \(incluir todos los subdominios\), exact \(coincidencia exacta de URL\) | +| `date` | string | No | Fecha para datos históricos en formato AAAA-MM-DD \(por defecto: hoy\) | +| `limit` | number | No | Número máximo de resultados a devolver \(predeterminado: 100\) | +| `offset` | number | No | Número de resultados a omitir para paginación | +| `apiKey` | string | Sí | Clave API de Ahrefs | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `brokenBacklinks` | array | Lista de backlinks rotos | + +## Notas + +- Categoría: `tools` +- Tipo: `ahrefs` diff --git a/apps/docs/content/docs/es/tools/datadog.mdx b/apps/docs/content/docs/es/tools/datadog.mdx new file mode 100644 index 000000000..46cf4d4d5 --- /dev/null +++ b/apps/docs/content/docs/es/tools/datadog.mdx @@ -0,0 +1,302 @@ +--- +title: Datadog +description: Monitorea infraestructura, aplicaciones y registros con Datadog +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Datadog](https://datadoghq.com/) es una plataforma integral de monitoreo y análisis para infraestructura, aplicaciones, registros y más. Permite a las organizaciones obtener visibilidad en tiempo real sobre la salud y el rendimiento de los sistemas, detectar anomalías y automatizar la respuesta a incidentes. + +Con Datadog, puedes: + +- **Monitorear métricas**: Recopilar, visualizar y analizar métricas de servidores, servicios en la nube y aplicaciones personalizadas. +- **Consultar datos de series temporales**: Ejecutar consultas avanzadas sobre métricas de rendimiento para análisis de tendencias e informes. +- **Gestionar monitores y eventos**: Configurar monitores para detectar problemas, activar alertas y crear eventos para observabilidad. +- **Manejar tiempos de inactividad**: Programar y gestionar de forma programática los tiempos de inactividad planificados para suprimir alertas durante el mantenimiento. +- **Analizar registros y trazas** *(con configuración adicional en Datadog)*: Centralizar e inspeccionar registros o trazas distribuidas para una solución de problemas más profunda. + +La integración de Datadog de Sim permite que tus agentes automaticen estas operaciones e interactúen con tu cuenta de Datadog de forma programática. Úsala para enviar métricas personalizadas, consultar datos de series temporales, gestionar monitores, crear eventos y optimizar tus flujos de trabajo de monitoreo directamente dentro de las automatizaciones de Sim. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra el monitoreo de Datadog en los flujos de trabajo. Envía métricas, gestiona monitores, consulta registros, crea eventos, maneja tiempos de inactividad y más. + +## Herramientas + +### `datadog_submit_metrics` + +Envía métricas personalizadas a Datadog. Utilízalo para seguir el rendimiento de aplicaciones, métricas de negocio o datos de monitoreo personalizados. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `series` | string | Sí | Array JSON de series métricas para enviar. Cada serie debe incluir nombre de métrica, tipo \(gauge/rate/count\), puntos \(pares de marca de tiempo/valor\) y etiquetas opcionales. | +| `apiKey` | string | Sí | Clave API de Datadog | +| `site` | string | No | Sitio/región de Datadog \(predeterminado: datadoghq.com\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Indica si las métricas se enviaron correctamente | +| `errors` | array | Cualquier error que haya ocurrido durante el envío | + +### `datadog_query_timeseries` + +Consulta datos de series temporales de métricas desde Datadog. Útil para analizar tendencias, crear informes o recuperar valores de métricas. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `query` | string | Sí | Consulta de métricas de Datadog (p. ej., "avg:system.cpu.user\{*\}") | +| `from` | number | Sí | Tiempo de inicio como marca de tiempo Unix en segundos | +| `to` | number | Sí | Tiempo de finalización como marca de tiempo Unix en segundos | +| `apiKey` | string | Sí | Clave API de Datadog | +| `applicationKey` | string | Sí | Clave de aplicación de Datadog | +| `site` | string | No | Sitio/región de Datadog (predeterminado: datadoghq.com) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `series` | array | Array de datos de series temporales con nombre de métrica, etiquetas y puntos de datos | +| `status` | string | Estado de la consulta | + +### `datadog_create_event` + +Publica un evento en el flujo de eventos de Datadog. Útil para notificaciones de despliegue, alertas o cualquier suceso significativo. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `title` | string | Sí | Título del evento | +| `text` | string | Sí | Cuerpo/descripción del evento. Admite markdown. | +| `alertType` | string | No | Tipo de alerta: error, warning, info, success, user_update, recommendation o snapshot | +| `priority` | string | No | Prioridad del evento: normal o low | +| `host` | string | No | Nombre del host asociado con este evento | +| `tags` | string | No | Lista de etiquetas separadas por comas (p. ej., "env:production,service:api") | +| `aggregationKey` | string | No | Clave para agrupar eventos | +| `sourceTypeName` | string | No | Nombre del tipo de fuente para el evento | +| `dateHappened` | number | No | Marca de tiempo Unix cuando ocurrió el evento (por defecto: ahora) | +| `apiKey` | string | Sí | Clave API de Datadog | +| `site` | string | No | Sitio/región de Datadog (predeterminado: datadoghq.com) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `event` | object | Los detalles del evento creado | + +### `datadog_create_monitor` + +Crear un nuevo monitor/alerta en Datadog. Los monitores pueden rastrear métricas, verificaciones de servicio, eventos y más. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `name` | string | Sí | Nombre del monitor | +| `type` | string | Sí | Tipo de monitor: alerta de métrica, verificación de servicio, alerta de evento, alerta de proceso, alerta de registro, alerta de consulta, compuesto, alerta de sintéticos, alerta de slo | +| `query` | string | Sí | Consulta del monitor \(p. ej., "avg\(last_5m\):avg:system.cpu.idle\{*\} < 20"\) | +| `message` | string | No | Mensaje para incluir con las notificaciones. Puede incluir menciones con @ y markdown. | +| `tags` | string | No | Lista de etiquetas separadas por comas | +| `priority` | number | No | Prioridad del monitor \(1-5, donde 1 es la más alta\) | +| `options` | string | No | Cadena JSON de opciones del monitor \(umbrales, notify_no_data, renotify_interval, etc.\) | +| `apiKey` | string | Sí | Clave API de Datadog | +| `applicationKey` | string | Sí | Clave de aplicación de Datadog | +| `site` | string | No | Sitio/región de Datadog \(predeterminado: datadoghq.com\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `monitor` | object | Los detalles del monitor creado | + +### `datadog_get_monitor` + +Recuperar detalles de un monitor específico por ID. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `monitorId` | string | Sí | El ID del monitor a recuperar | +| `groupStates` | string | No | Estados de grupo separados por comas para incluir: alerta, advertencia, sin datos, ok | +| `withDowntimes` | boolean | No | Incluir datos de tiempo de inactividad con el monitor | +| `apiKey` | string | Sí | Clave API de Datadog | +| `applicationKey` | string | Sí | Clave de aplicación de Datadog | +| `site` | string | No | Sitio/región de Datadog \(predeterminado: datadoghq.com\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `monitor` | object | Los detalles del monitor | + +### `datadog_list_monitors` + +Lista todos los monitores en Datadog con filtrado opcional por nombre, etiquetas o estado. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `groupStates` | string | No | Estados de grupo separados por comas para filtrar: alert, warn, no data, ok | +| `name` | string | No | Filtrar monitores por nombre \(coincidencia parcial\) | +| `tags` | string | No | Lista de etiquetas separadas por comas para filtrar | +| `monitorTags` | string | No | Lista de etiquetas de monitor separadas por comas para filtrar | +| `withDowntimes` | boolean | No | Incluir datos de tiempo de inactividad con los monitores | +| `page` | number | No | Número de página para paginación \(indexado desde 0\) | +| `pageSize` | number | No | Número de monitores por página \(máximo 1000\) | +| `apiKey` | string | Sí | Clave API de Datadog | +| `applicationKey` | string | Sí | Clave de aplicación de Datadog | +| `site` | string | No | Sitio/región de Datadog \(predeterminado: datadoghq.com\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `monitors` | array | Lista de monitores | + +### `datadog_mute_monitor` + +Silencia un monitor para suprimir temporalmente las notificaciones. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `monitorId` | string | Sí | El ID del monitor a silenciar | +| `scope` | string | No | Ámbito a silenciar \(p. ej., "host:myhost"\). Si no se especifica, silencia todos los ámbitos. | +| `end` | number | No | Marca de tiempo Unix cuando debe finalizar el silenciamiento. Si no se especifica, silencia indefinidamente. | +| `apiKey` | string | Sí | Clave API de Datadog | +| `applicationKey` | string | Sí | Clave de aplicación de Datadog | +| `site` | string | No | Sitio/región de Datadog \(predeterminado: datadoghq.com\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Indica si el monitor se silenció correctamente | + +### `datadog_query_logs` + +Busca y recupera registros desde Datadog. Útil para solución de problemas, análisis o monitoreo. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `query` | string | Sí | Consulta de búsqueda de registros \(p. ej., "service:web-app status:error"\) | +| `from` | string | Sí | Hora de inicio en formato ISO-8601 o relativo \(p. ej., "now-1h"\) | +| `to` | string | Sí | Hora de fin en formato ISO-8601 o relativo \(p. ej., "now"\) | +| `limit` | number | No | Número máximo de registros a devolver \(predeterminado: 50, máx: 1000\) | +| `sort` | string | No | Orden de clasificación: timestamp \(más antiguos primero\) o -timestamp \(más recientes primero\) | +| `indexes` | string | No | Lista separada por comas de índices de registros para buscar | +| `apiKey` | string | Sí | Clave API de Datadog | +| `applicationKey` | string | Sí | Clave de aplicación de Datadog | +| `site` | string | No | Sitio/región de Datadog \(predeterminado: datadoghq.com\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `logs` | array | Lista de entradas de registro | + +### `datadog_send_logs` + +Envía entradas de registro a Datadog para registro centralizado y análisis. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `logs` | string | Sí | Array JSON de entradas de registro. Cada entrada debe tener message y opcionalmente ddsource, ddtags, hostname, service. | +| `apiKey` | string | Sí | Clave API de Datadog | +| `site` | string | No | Sitio/región de Datadog \(predeterminado: datadoghq.com\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Indica si los registros se enviaron correctamente | + +### `datadog_create_downtime` + +Programa un tiempo de inactividad para suprimir las notificaciones del monitor durante las ventanas de mantenimiento. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `scope` | string | Sí | Ámbito para aplicar el tiempo de inactividad \(p. ej., "host:myhost", "env:production", o "*" para todos\) | +| `message` | string | No | Mensaje a mostrar durante el tiempo de inactividad | +| `start` | number | No | Marca de tiempo Unix para el inicio del tiempo de inactividad \(por defecto es ahora\) | +| `end` | number | No | Marca de tiempo Unix para el final del tiempo de inactividad | +| `timezone` | string | No | Zona horaria para el tiempo de inactividad \(p. ej., "America/New_York"\) | +| `monitorId` | string | No | ID específico del monitor a silenciar | +| `monitorTags` | string | No | Etiquetas de monitor separadas por comas para coincidir \(p. ej., "team:backend,priority:high"\) | +| `muteFirstRecoveryNotification` | boolean | No | Silenciar la primera notificación de recuperación | +| `apiKey` | string | Sí | Clave API de Datadog | +| `applicationKey` | string | Sí | Clave de aplicación de Datadog | +| `site` | string | No | Sitio/región de Datadog \(por defecto: datadoghq.com\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `downtime` | object | Los detalles del tiempo de inactividad creado | + +### `datadog_list_downtimes` + +Listar todos los tiempos de inactividad programados en Datadog. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `currentOnly` | boolean | No | Solo devolver tiempos de inactividad actualmente activos | +| `monitorId` | string | No | Filtrar por ID de monitor | +| `apiKey` | string | Sí | Clave API de Datadog | +| `applicationKey` | string | Sí | Clave de aplicación de Datadog | +| `site` | string | No | Sitio/región de Datadog \(por defecto: datadoghq.com\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `downtimes` | array | Lista de tiempos de inactividad | + +### `datadog_cancel_downtime` + +Cancelar un tiempo de inactividad programado. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `downtimeId` | string | Sí | El ID del tiempo de inactividad a cancelar | +| `apiKey` | string | Sí | Clave API de Datadog | +| `applicationKey` | string | Sí | Clave de aplicación de Datadog | +| `site` | string | No | Sitio/región de Datadog (predeterminado: datadoghq.com) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Indica si el tiempo de inactividad se canceló correctamente | + +## Notas + +- Categoría: `tools` +- Tipo: `datadog` diff --git a/apps/docs/content/docs/es/tools/dropbox.mdx b/apps/docs/content/docs/es/tools/dropbox.mdx new file mode 100644 index 000000000..9035e2cbb --- /dev/null +++ b/apps/docs/content/docs/es/tools/dropbox.mdx @@ -0,0 +1,219 @@ +--- +title: Dropbox +description: Sube, descarga, comparte y gestiona archivos en Dropbox +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Dropbox](https://dropbox.com/) es una popular plataforma de almacenamiento en la nube y colaboración que permite a individuos y equipos almacenar, acceder y compartir archivos de forma segura desde cualquier lugar. Dropbox está diseñado para facilitar la gestión de archivos, la sincronización y una potente colaboración, ya sea que trabajes solo o en grupo. + +Con Dropbox en Sim, puedes: + +- **Subir y descargar archivos**: Sube cualquier archivo a tu Dropbox o recupera contenido bajo demanda sin problemas +- **Listar contenidos de carpetas**: Navega por los archivos y carpetas dentro de cualquier directorio de Dropbox +- **Crear nuevas carpetas**: Organiza tus archivos creando programáticamente nuevas carpetas en tu Dropbox +- **Buscar archivos y carpetas**: Localiza documentos, imágenes u otros elementos por nombre o contenido +- **Generar enlaces compartidos**: Crea rápidamente enlaces públicos o privados compartibles para archivos y carpetas +- **Gestionar archivos**: Mueve, elimina o renombra archivos y carpetas como parte de flujos de trabajo automatizados + +Estas capacidades permiten a tus agentes Sim automatizar operaciones de Dropbox directamente dentro de tus flujos de trabajo — desde hacer copias de seguridad de archivos importantes hasta distribuir contenido y mantener carpetas organizadas. Usa Dropbox como fuente y destino para archivos, permitiendo una gestión fluida del almacenamiento en la nube como parte de tus procesos de negocio. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra Dropbox en tu flujo de trabajo para la gestión de archivos, compartir y colaboración. Sube archivos, descarga contenido, crea carpetas, gestiona enlaces compartidos y más. + +## Herramientas + +### `dropbox_upload` + +Subir un archivo a Dropbox + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `path` | string | Sí | La ruta en Dropbox donde se guardará el archivo \(p. ej., /carpeta/documento.pdf\) | +| `fileContent` | string | Sí | El contenido codificado en base64 del archivo a subir | +| `fileName` | string | No | Nombre de archivo opcional \(usado si la ruta es una carpeta\) | +| `mode` | string | No | Modo de escritura: add \(predeterminado\) u overwrite | +| `autorename` | boolean | No | Si es true, renombra el archivo si hay un conflicto | +| `mute` | boolean | No | Si es true, no notifica al usuario sobre esta subida | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `file` | object | Los metadatos del archivo subido | + +### `dropbox_download` + +Descargar un archivo de Dropbox y obtener un enlace temporal + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `path` | string | Sí | La ruta del archivo a descargar \(p. ej., /carpeta/documento.pdf\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `file` | object | Los metadatos del archivo | + +### `dropbox_list_folder` + +Listar el contenido de una carpeta en Dropbox + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `path` | string | Sí | La ruta de la carpeta a listar \(usar "" para la raíz\) | +| `recursive` | boolean | No | Si es verdadero, lista el contenido recursivamente | +| `includeDeleted` | boolean | No | Si es verdadero, incluye archivos/carpetas eliminados | +| `includeMediaInfo` | boolean | No | Si es verdadero, incluye información multimedia para fotos/videos | +| `limit` | number | No | Número máximo de resultados a devolver \(predeterminado: 500\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `entries` | array | Lista de archivos y carpetas en el directorio | + +### `dropbox_create_folder` + +Crear una nueva carpeta en Dropbox + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `path` | string | Sí | La ruta donde se debe crear la carpeta \(p. ej., /nueva-carpeta\) | +| `autorename` | boolean | No | Si es verdadero, renombra la carpeta si hay un conflicto | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `folder` | objeto | Los metadatos de la carpeta creada | + +### `dropbox_delete` + +Eliminar un archivo o carpeta en Dropbox (mueve a la papelera) + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `path` | cadena | Sí | La ruta del archivo o carpeta a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `metadata` | objeto | Metadatos del elemento eliminado | + +### `dropbox_copy` + +Copiar un archivo o carpeta en Dropbox + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `fromPath` | cadena | Sí | La ruta de origen del archivo o carpeta a copiar | +| `toPath` | cadena | Sí | La ruta de destino para el archivo o carpeta copiado | +| `autorename` | booleano | No | Si es verdadero, renombra el archivo si hay un conflicto en el destino | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `metadata` | objeto | Metadatos del elemento copiado | + +### `dropbox_move` + +Mover o renombrar un archivo o carpeta en Dropbox + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `fromPath` | cadena | Sí | La ruta de origen del archivo o carpeta a mover | +| `toPath` | cadena | Sí | La ruta de destino para el archivo o carpeta movido | +| `autorename` | booleano | No | Si es verdadero, renombra el archivo si hay un conflicto en el destino | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `metadata` | object | Metadatos del elemento movido | + +### `dropbox_get_metadata` + +Obtener metadatos de un archivo o carpeta en Dropbox + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `path` | string | Sí | La ruta del archivo o carpeta del que obtener metadatos | +| `includeMediaInfo` | boolean | No | Si es verdadero, incluye información multimedia para fotos/videos | +| `includeDeleted` | boolean | No | Si es verdadero, incluye archivos eliminados en los resultados | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `metadata` | object | Metadatos del archivo o carpeta | + +### `dropbox_create_shared_link` + +Crear un enlace compartible para un archivo o carpeta en Dropbox + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `path` | string | Sí | La ruta del archivo o carpeta a compartir | +| `requestedVisibility` | string | No | Visibilidad: public, team_only, o password | +| `linkPassword` | string | No | Contraseña para el enlace compartido \(solo si la visibilidad es password\) | +| `expires` | string | No | Fecha de caducidad en formato ISO 8601 \(p. ej., 2025-12-31T23:59:59Z\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `sharedLink` | object | El enlace compartido creado | + +### `dropbox_search` + +Buscar archivos y carpetas en Dropbox + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `query` | string | Sí | La consulta de búsqueda | +| `path` | string | No | Limitar la búsqueda a una ruta de carpeta específica | +| `fileExtensions` | string | No | Lista separada por comas de extensiones de archivo para filtrar \(p. ej., pdf,xlsx\) | +| `maxResults` | number | No | Número máximo de resultados a devolver \(predeterminado: 100\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `matches` | array | Resultados de la búsqueda | + +## Notas + +- Categoría: `tools` +- Tipo: `dropbox` diff --git a/apps/docs/content/docs/es/tools/elasticsearch.mdx b/apps/docs/content/docs/es/tools/elasticsearch.mdx new file mode 100644 index 000000000..ecd9deae3 --- /dev/null +++ b/apps/docs/content/docs/es/tools/elasticsearch.mdx @@ -0,0 +1,365 @@ +--- +title: Elasticsearch +description: Busca, indexa y gestiona datos en Elasticsearch +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Elasticsearch](https://www.elastic.co/elasticsearch/) es un potente motor de búsqueda y análisis distribuido que te permite indexar, buscar y analizar grandes volúmenes de datos en tiempo real. Es ampliamente utilizado para potenciar funciones de búsqueda, análisis de datos de registros y eventos, observabilidad y más. + +Con Elasticsearch en Sim, obtienes acceso programático a las capacidades principales de Elasticsearch, incluyendo: + +- **Búsqueda de documentos**: Realiza búsquedas avanzadas en texto estructurado o no estructurado utilizando Query DSL, con soporte para ordenación, paginación y selección de campos. +- **Indexación de documentos**: Añade nuevos documentos o actualiza los existentes en cualquier índice de Elasticsearch para su recuperación y análisis inmediatos. +- **Obtener, actualizar o eliminar documentos**: Recupera, modifica o elimina documentos específicos por ID. +- **Operaciones masivas**: Ejecuta múltiples acciones de indexación o actualización en una sola solicitud para un procesamiento de datos de alto rendimiento. +- **Gestión de índices**: Crea, elimina u obtén detalles sobre índices como parte de tu automatización de flujo de trabajo. +- **Monitorización de clústeres**: Comprueba la salud y las estadísticas de tu despliegue de Elasticsearch. + +Las herramientas de Elasticsearch de Sim funcionan tanto con entornos autoalojados como con Elastic Cloud. Integra Elasticsearch en tus flujos de trabajo de agentes para automatizar la ingesta de datos, buscar en vastos conjuntos de datos, ejecutar informes o construir aplicaciones personalizadas basadas en búsquedas, todo sin intervención manual. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra Elasticsearch en flujos de trabajo para búsquedas potentes, indexación y gestión de datos. Admite operaciones CRUD de documentos, consultas de búsqueda avanzadas, operaciones masivas, gestión de índices y monitorización de clústeres. Funciona tanto con despliegues autoalojados como con Elastic Cloud. + +## Herramientas + +### `elasticsearch_search` + +Busca documentos en Elasticsearch usando Query DSL. Devuelve documentos coincidentes con puntuaciones y metadatos. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ---------- | ----------- | +| `deploymentType` | string | Sí | Tipo de despliegue: self_hosted o cloud | +| `host` | string | No | URL del host de Elasticsearch (para self-hosted) | +| `cloudId` | string | No | ID de Elastic Cloud (para despliegues en la nube) | +| `authMethod` | string | Sí | Método de autenticación: api_key o basic_auth | +| `apiKey` | string | No | Clave API de Elasticsearch | +| `username` | string | No | Nombre de usuario para autenticación básica | +| `password` | string | No | Contraseña para autenticación básica | +| `index` | string | Sí | Nombre del índice para buscar | +| `query` | string | No | Query DSL como cadena JSON | +| `from` | number | No | Desplazamiento inicial para paginación (predeterminado: 0) | +| `size` | number | No | Número de resultados a devolver (predeterminado: 10) | +| `sort` | string | No | Especificación de ordenación como cadena JSON | +| `sourceIncludes` | string | No | Lista separada por comas de campos a incluir en _source | +| `sourceExcludes` | string | No | Lista separada por comas de campos a excluir de _source | +| `trackTotalHits` | boolean | No | Seguimiento preciso del recuento total de coincidencias (predeterminado: true) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `took` | number | Tiempo en milisegundos que tardó la búsqueda | +| `timed_out` | boolean | Si la búsqueda agotó el tiempo de espera | +| `hits` | object | Resultados de búsqueda con recuento total y documentos coincidentes | +| `aggregations` | json | Resultados de agregación si los hay | + +### `elasticsearch_index_document` + +Indexar (crear o actualizar) un documento en Elasticsearch. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Sí | Tipo de despliegue: self_hosted o cloud | +| `host` | string | No | URL del host de Elasticsearch \(para self-hosted\) | +| `cloudId` | string | No | ID de Elastic Cloud \(para despliegues en cloud\) | +| `authMethod` | string | Sí | Método de autenticación: api_key o basic_auth | +| `apiKey` | string | No | Clave API de Elasticsearch | +| `username` | string | No | Nombre de usuario para autenticación básica | +| `password` | string | No | Contraseña para autenticación básica | +| `index` | string | Sí | Nombre del índice de destino | +| `documentId` | string | No | ID del documento \(se genera automáticamente si no se proporciona\) | +| `document` | string | Sí | Cuerpo del documento como cadena JSON | +| `refresh` | string | No | Política de actualización: true, false o wait_for | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `_index` | string | Índice donde se almacenó el documento | +| `_id` | string | ID del documento | +| `_version` | number | Versión del documento | +| `result` | string | Resultado de la operación \(created o updated\) | + +### `elasticsearch_get_document` + +Recuperar un documento por ID desde Elasticsearch. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Sí | Tipo de despliegue: self_hosted o cloud | +| `host` | string | No | URL del host de Elasticsearch \(para self-hosted\) | +| `cloudId` | string | No | ID de Elastic Cloud \(para despliegues en cloud\) | +| `authMethod` | string | Sí | Método de autenticación: api_key o basic_auth | +| `apiKey` | string | No | Clave API de Elasticsearch | +| `username` | string | No | Nombre de usuario para autenticación básica | +| `password` | string | No | Contraseña para autenticación básica | +| `index` | string | Sí | Nombre del índice | +| `documentId` | string | Sí | ID del documento a recuperar | +| `sourceIncludes` | string | No | Lista separada por comas de campos a incluir | +| `sourceExcludes` | string | No | Lista separada por comas de campos a excluir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `_index` | string | Nombre del índice | +| `_id` | string | ID del documento | +| `_version` | number | Versión del documento | +| `found` | boolean | Si el documento fue encontrado | +| `_source` | json | Contenido del documento | + +### `elasticsearch_update_document` + +Actualiza parcialmente un documento en Elasticsearch usando la fusión de documentos. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Sí | Tipo de despliegue: self_hosted o cloud | +| `host` | string | No | URL del host de Elasticsearch (para self-hosted) | +| `cloudId` | string | No | ID de Elastic Cloud (para despliegues en la nube) | +| `authMethod` | string | Sí | Método de autenticación: api_key o basic_auth | +| `apiKey` | string | No | Clave API de Elasticsearch | +| `username` | string | No | Nombre de usuario para autenticación básica | +| `password` | string | No | Contraseña para autenticación básica | +| `index` | string | Sí | Nombre del índice | +| `documentId` | string | Sí | ID del documento a actualizar | +| `document` | string | Sí | Documento parcial para fusionar como cadena JSON | +| `retryOnConflict` | number | No | Número de reintentos en conflicto de versión | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `_index` | string | Nombre del índice | +| `_id` | string | ID del documento | +| `_version` | number | Nueva versión del documento | +| `result` | string | Resultado de la operación (updated o noop) | + +### `elasticsearch_delete_document` + +Elimina un documento de Elasticsearch por ID. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Sí | Tipo de despliegue: self_hosted o cloud | +| `host` | string | No | URL del host de Elasticsearch \(para self-hosted\) | +| `cloudId` | string | No | ID de Elastic Cloud \(para despliegues en la nube\) | +| `authMethod` | string | Sí | Método de autenticación: api_key o basic_auth | +| `apiKey` | string | No | Clave API de Elasticsearch | +| `username` | string | No | Nombre de usuario para autenticación básica | +| `password` | string | No | Contraseña para autenticación básica | +| `index` | string | Sí | Nombre del índice | +| `documentId` | string | Sí | ID del documento a eliminar | +| `refresh` | string | No | Política de actualización: true, false o wait_for | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `_index` | string | Nombre del índice | +| `_id` | string | ID del documento | +| `_version` | number | Versión del documento | +| `result` | string | Resultado de la operación \(deleted o not_found\) | + +### `elasticsearch_bulk` + +Realiza múltiples operaciones de indexación, creación, eliminación o actualización en una sola petición para un alto rendimiento. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Sí | Tipo de despliegue: self_hosted o cloud | +| `host` | string | No | URL del host de Elasticsearch \(para self-hosted\) | +| `cloudId` | string | No | ID de Elastic Cloud \(para despliegues en la nube\) | +| `authMethod` | string | Sí | Método de autenticación: api_key o basic_auth | +| `apiKey` | string | No | Clave API de Elasticsearch | +| `username` | string | No | Nombre de usuario para autenticación básica | +| `password` | string | No | Contraseña para autenticación básica | +| `index` | string | No | Índice predeterminado para operaciones que no especifican uno | +| `operations` | string | Sí | Operaciones masivas como cadena NDJSON \(JSON delimitado por nuevas líneas\) | +| `refresh` | string | No | Política de actualización: true, false o wait_for | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `took` | number | Tiempo en milisegundos que tardó la operación masiva | +| `errors` | boolean | Si alguna operación tuvo un error | +| `items` | array | Resultados para cada operación | + +### `elasticsearch_count` + +Contar documentos que coinciden con una consulta en Elasticsearch. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Sí | Tipo de despliegue: self_hosted o cloud | +| `host` | string | No | URL del host de Elasticsearch \(para self-hosted\) | +| `cloudId` | string | No | ID de Elastic Cloud \(para despliegues en la nube\) | +| `authMethod` | string | Sí | Método de autenticación: api_key o basic_auth | +| `apiKey` | string | No | Clave API de Elasticsearch | +| `username` | string | No | Nombre de usuario para autenticación básica | +| `password` | string | No | Contraseña para autenticación básica | +| `index` | string | Sí | Nombre del índice donde contar documentos | +| `query` | string | No | Consulta opcional para filtrar documentos \(cadena JSON\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `count` | number | Número de documentos que coinciden con la consulta | +| `_shards` | object | Estadísticas de fragmentos | + +### `elasticsearch_create_index` + +Crear un nuevo índice con configuraciones y mapeos opcionales. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Sí | Tipo de despliegue: self_hosted o cloud | +| `host` | string | No | URL del host de Elasticsearch \(para self-hosted\) | +| `cloudId` | string | No | ID de Elastic Cloud \(para despliegues en la nube\) | +| `authMethod` | string | Sí | Método de autenticación: api_key o basic_auth | +| `apiKey` | string | No | Clave API de Elasticsearch | +| `username` | string | No | Nombre de usuario para autenticación básica | +| `password` | string | No | Contraseña para autenticación básica | +| `index` | string | Sí | Nombre del índice a crear | +| `settings` | string | No | Configuraciones del índice como cadena JSON | +| `mappings` | string | No | Mapeos del índice como cadena JSON | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `acknowledged` | boolean | Si la solicitud fue reconocida | +| `shards_acknowledged` | boolean | Si los fragmentos fueron reconocidos | +| `index` | string | Nombre del índice creado | + +### `elasticsearch_delete_index` + +Elimina un índice y todos sus documentos. Esta operación es irreversible. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Sí | Tipo de despliegue: self_hosted o cloud | +| `host` | string | No | URL del host de Elasticsearch \(para self-hosted\) | +| `cloudId` | string | No | ID de Elastic Cloud \(para despliegues en la nube\) | +| `authMethod` | string | Sí | Método de autenticación: api_key o basic_auth | +| `apiKey` | string | No | Clave API de Elasticsearch | +| `username` | string | No | Nombre de usuario para autenticación básica | +| `password` | string | No | Contraseña para autenticación básica | +| `index` | string | Sí | Nombre del índice a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `acknowledged` | boolean | Si la eliminación fue reconocida | + +### `elasticsearch_get_index` + +Recupera información del índice incluyendo configuraciones, mapeos y alias. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Sí | Tipo de despliegue: self_hosted o cloud | +| `host` | string | No | URL del host de Elasticsearch \(para self-hosted\) | +| `cloudId` | string | No | ID de Elastic Cloud \(para despliegues en la nube\) | +| `authMethod` | string | Sí | Método de autenticación: api_key o basic_auth | +| `apiKey` | string | No | Clave API de Elasticsearch | +| `username` | string | No | Nombre de usuario para autenticación básica | +| `password` | string | No | Contraseña para autenticación básica | +| `index` | string | Sí | Nombre del índice del que recuperar información | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `index` | json | Información del índice incluyendo alias, mapeos y configuraciones | + +### `elasticsearch_cluster_health` + +Obtener el estado de salud del clúster de Elasticsearch. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Sí | Tipo de despliegue: self_hosted o cloud | +| `host` | string | No | URL del host de Elasticsearch \(para self-hosted\) | +| `cloudId` | string | No | ID de Elastic Cloud \(para despliegues en la nube\) | +| `authMethod` | string | Sí | Método de autenticación: api_key o basic_auth | +| `apiKey` | string | No | Clave API de Elasticsearch | +| `username` | string | No | Nombre de usuario para autenticación básica | +| `password` | string | No | Contraseña para autenticación básica | +| `waitForStatus` | string | No | Esperar hasta que el clúster alcance este estado: green, yellow o red | +| `timeout` | string | No | Tiempo de espera para la operación de espera \(p. ej., 30s, 1m\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `cluster_name` | string | Nombre del clúster | +| `status` | string | Estado de salud del clúster: green, yellow o red | +| `number_of_nodes` | number | Número total de nodos en el clúster | +| `number_of_data_nodes` | number | Número de nodos de datos | +| `active_shards` | number | Número de fragmentos activos | +| `unassigned_shards` | number | Número de fragmentos no asignados | + +### `elasticsearch_cluster_stats` + +Obtén estadísticas completas sobre el clúster de Elasticsearch. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `deploymentType` | string | Sí | Tipo de despliegue: self_hosted o cloud | +| `host` | string | No | URL del host de Elasticsearch (para self-hosted) | +| `cloudId` | string | No | ID de Elastic Cloud (para despliegues en la nube) | +| `authMethod` | string | Sí | Método de autenticación: api_key o basic_auth | +| `apiKey` | string | No | Clave API de Elasticsearch | +| `username` | string | No | Nombre de usuario para autenticación básica | +| `password` | string | No | Contraseña para autenticación básica | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `cluster_name` | string | Nombre del clúster | +| `status` | string | Estado de salud del clúster | +| `nodes` | object | Estadísticas de nodos incluyendo recuento y versiones | +| `indices` | object | Estadísticas de índices incluyendo recuento de documentos y tamaño de almacenamiento | + +## Notas + +- Categoría: `tools` +- Tipo: `elasticsearch` diff --git a/apps/docs/content/docs/es/tools/gitlab.mdx b/apps/docs/content/docs/es/tools/gitlab.mdx new file mode 100644 index 000000000..671fef823 --- /dev/null +++ b/apps/docs/content/docs/es/tools/gitlab.mdx @@ -0,0 +1,429 @@ +--- +title: GitLab +description: Interactúa con proyectos, issues, solicitudes de fusión y pipelines de GitLab +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[GitLab](https://gitlab.com/) es una plataforma DevOps integral que permite a los equipos gestionar, colaborar y automatizar su ciclo de vida de desarrollo de software. Con GitLab, puedes manejar sin esfuerzo la gestión del código fuente, CI/CD, revisiones y colaboración en una sola aplicación. + +Con GitLab en Sim, puedes: + +- **Gestionar proyectos y repositorios**: Listar y recuperar tus proyectos de GitLab, acceder a detalles y organizar tus repositorios +- **Trabajar con issues**: Listar, crear y comentar issues para realizar seguimiento del trabajo y colaborar eficazmente +- **Gestionar solicitudes de fusión**: Revisar, crear y gestionar solicitudes de fusión para cambios de código y revisiones por pares +- **Automatizar pipelines de CI/CD**: Activar, monitorear e interactuar con pipelines de GitLab como parte de tus flujos de automatización +- **Colaborar con comentarios**: Añadir comentarios a issues o solicitudes de fusión para una comunicación eficiente dentro de tu equipo + +Usando la integración de GitLab en Sim, tus agentes pueden interactuar programáticamente con tus proyectos de GitLab. Automatiza la gestión de proyectos, seguimiento de issues, revisiones de código y operaciones de pipeline de manera fluida en tus flujos de trabajo, optimizando tu proceso de desarrollo de software y mejorando la colaboración en todo tu equipo. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra GitLab en el flujo de trabajo. Puede gestionar proyectos, issues, solicitudes de fusión, pipelines y añadir comentarios. Compatible con todas las operaciones principales de DevOps de GitLab. + +## Herramientas + +### `gitlab_list_projects` + +Listar proyectos de GitLab accesibles para el usuario autenticado + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `owned` | boolean | No | Limitar a proyectos propiedad del usuario actual | +| `membership` | boolean | No | Limitar a proyectos de los que el usuario actual es miembro | +| `search` | string | No | Buscar proyectos por nombre | +| `visibility` | string | No | Filtrar por visibilidad \(public, internal, private\) | +| `orderBy` | string | No | Ordenar por campo \(id, name, path, created_at, updated_at, last_activity_at\) | +| `sort` | string | No | Dirección de ordenación \(asc, desc\) | +| `perPage` | number | No | Número de resultados por página \(predeterminado 20, máximo 100\) | +| `page` | number | No | Número de página para paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `projects` | array | Lista de proyectos de GitLab | +| `total` | number | Número total de proyectos | + +### `gitlab_get_project` + +Obtener detalles de un proyecto específico de GitLab + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL \(p. ej., "namespace/project"\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `project` | object | Los detalles del proyecto de GitLab | + +### `gitlab_list_issues` + +Listar issues en un proyecto de GitLab + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `state` | string | No | Filtrar por estado \(opened, closed, all\) | +| `labels` | string | No | Lista de nombres de etiquetas separados por comas | +| `assigneeId` | number | No | Filtrar por ID de usuario asignado | +| `milestoneTitle` | string | No | Filtrar por título de hito | +| `search` | string | No | Buscar issues por título y descripción | +| `orderBy` | string | No | Ordenar por campo \(created_at, updated_at\) | +| `sort` | string | No | Dirección de ordenación \(asc, desc\) | +| `perPage` | number | No | Número de resultados por página \(predeterminado 20, máximo 100\) | +| `page` | number | No | Número de página para paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `issues` | array | Lista de issues de GitLab | +| `total` | number | Número total de issues | + +### `gitlab_get_issue` + +Obtener detalles de un issue específico de GitLab + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `issueIid` | number | Sí | Número del issue dentro del proyecto \(el # mostrado en la interfaz de GitLab\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `issue` | object | Los detalles del issue de GitLab | + +### `gitlab_create_issue` + +Crear un nuevo issue en un proyecto de GitLab + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `title` | string | Sí | Título del issue | +| `description` | string | No | Descripción del issue \(Markdown soportado\) | +| `labels` | string | No | Lista de nombres de etiquetas separados por comas | +| `assigneeIds` | array | No | Array de IDs de usuarios para asignar | +| `milestoneId` | number | No | ID del hito para asignar | +| `dueDate` | string | No | Fecha de vencimiento en formato AAAA-MM-DD | +| `confidential` | boolean | No | Si el issue es confidencial | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `issue` | object | El issue de GitLab creado | + +### `gitlab_update_issue` + +Actualizar un issue existente en un proyecto de GitLab + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `issueIid` | number | Sí | ID interno del issue (IID) | +| `title` | string | No | Nuevo título del issue | +| `description` | string | No | Nueva descripción del issue (compatible con Markdown) | +| `stateEvent` | string | No | Evento de estado (cerrar o reabrir) | +| `labels` | string | No | Lista de nombres de etiquetas separados por comas | +| `assigneeIds` | array | No | Array de IDs de usuarios para asignar | +| `milestoneId` | number | No | ID del hito para asignar | +| `dueDate` | string | No | Fecha de vencimiento en formato AAAA-MM-DD | +| `confidential` | boolean | No | Si el issue es confidencial | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `issue` | object | El issue de GitLab actualizado | + +### `gitlab_delete_issue` + +Eliminar un issue de un proyecto de GitLab + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `issueIid` | number | Sí | ID interno del issue (IID) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Indica si el issue fue eliminado correctamente | + +### `gitlab_create_issue_note` + +Añadir un comentario a un issue de GitLab + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `issueIid` | number | Sí | ID interno del issue (IID) | +| `body` | string | Sí | Cuerpo del comentario (compatible con Markdown) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `note` | object | El comentario creado | + +### `gitlab_list_merge_requests` + +Listar merge requests en un proyecto de GitLab + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `state` | string | No | Filtrar por estado (opened, closed, merged, all) | +| `labels` | string | No | Lista de nombres de etiquetas separados por comas | +| `sourceBranch` | string | No | Filtrar por rama de origen | +| `targetBranch` | string | No | Filtrar por rama de destino | +| `orderBy` | string | No | Ordenar por campo (created_at, updated_at) | +| `sort` | string | No | Dirección de ordenación (asc, desc) | +| `perPage` | number | No | Número de resultados por página (predeterminado 20, máximo 100) | +| `page` | number | No | Número de página para paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `mergeRequests` | array | Lista de solicitudes de fusión de GitLab | +| `total` | number | Número total de solicitudes de fusión | + +### `gitlab_get_merge_request` + +Obtener detalles de una solicitud de fusión específica de GitLab + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `mergeRequestIid` | number | Sí | ID interno de la solicitud de fusión \(IID\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `mergeRequest` | object | Los detalles de la solicitud de fusión de GitLab | + +### `gitlab_create_merge_request` + +Crear una nueva solicitud de fusión en un proyecto de GitLab + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `sourceBranch` | string | Sí | Nombre de la rama de origen | +| `targetBranch` | string | Sí | Nombre de la rama de destino | +| `title` | string | Sí | Título de la solicitud de fusión | +| `description` | string | No | Descripción de la solicitud de fusión \(Markdown soportado\) | +| `labels` | string | No | Lista de nombres de etiquetas separados por comas | +| `assigneeIds` | array | No | Array de IDs de usuarios para asignar | +| `milestoneId` | number | No | ID del hito para asignar | +| `removeSourceBranch` | boolean | No | Eliminar rama de origen después de la fusión | +| `squash` | boolean | No | Comprimir commits al fusionar | +| `draft` | boolean | No | Marcar como borrador \(trabajo en progreso\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `mergeRequest` | object | La solicitud de fusión de GitLab creada | + +### `gitlab_update_merge_request` + +Actualizar una solicitud de fusión existente en un proyecto de GitLab + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `mergeRequestIid` | number | Sí | ID interno de la solicitud de fusión (IID) | +| `title` | string | No | Nuevo título de la solicitud de fusión | +| `description` | string | No | Nueva descripción de la solicitud de fusión | +| `stateEvent` | string | No | Evento de estado (cerrar o reabrir) | +| `labels` | string | No | Lista de nombres de etiquetas separados por comas | +| `assigneeIds` | array | No | Array de IDs de usuarios para asignar | +| `milestoneId` | number | No | ID del hito para asignar | +| `targetBranch` | string | No | Nueva rama de destino | +| `removeSourceBranch` | boolean | No | Eliminar rama de origen después de la fusión | +| `squash` | boolean | No | Comprimir commits al fusionar | +| `draft` | boolean | No | Marcar como borrador (trabajo en progreso) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `mergeRequest` | object | La solicitud de fusión de GitLab actualizada | + +### `gitlab_merge_merge_request` + +Fusionar una solicitud de fusión en un proyecto de GitLab + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `mergeRequestIid` | number | Sí | ID interno de la solicitud de fusión (IID) | +| `mergeCommitMessage` | string | No | Mensaje personalizado para el commit de fusión | +| `squashCommitMessage` | string | No | Mensaje personalizado para el commit comprimido | +| `squash` | boolean | No | Comprimir commits antes de fusionar | +| `shouldRemoveSourceBranch` | boolean | No | Eliminar rama de origen después de la fusión | +| `mergeWhenPipelineSucceeds` | boolean | No | Fusionar cuando la pipeline tenga éxito | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `mergeRequest` | object | La solicitud de fusión de GitLab fusionada | + +### `gitlab_create_merge_request_note` + +Añadir un comentario a una solicitud de fusión de GitLab + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `mergeRequestIid` | number | Sí | ID interno de la solicitud de fusión (IID) | +| `body` | string | Sí | Cuerpo del comentario (compatible con Markdown) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `note` | object | El comentario creado | + +### `gitlab_list_pipelines` + +Listar pipelines en un proyecto de GitLab + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `ref` | string | No | Filtrar por ref (rama o etiqueta) | +| `status` | string | No | Filtrar por estado (created, waiting_for_resource, preparing, pending, running, success, failed, canceled, skipped, manual, scheduled) | +| `orderBy` | string | No | Ordenar por campo (id, status, ref, updated_at, user_id) | +| `sort` | string | No | Dirección de ordenación (asc, desc) | +| `perPage` | number | No | Número de resultados por página (predeterminado 20, máximo 100) | +| `page` | number | No | Número de página para paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `pipelines` | array | Lista de pipelines de GitLab | +| `total` | number | Número total de pipelines | + +### `gitlab_get_pipeline` + +Obtener detalles de un pipeline específico de GitLab + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `pipelineId` | number | Sí | ID del pipeline | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `pipeline` | object | Los detalles del pipeline de GitLab | + +### `gitlab_create_pipeline` + +Activar un nuevo pipeline en un proyecto de GitLab + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `ref` | string | Sí | Rama o etiqueta en la que ejecutar el pipeline | +| `variables` | array | No | Array de variables para el pipeline \(cada una con clave, valor y tipo de variable opcional\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `pipeline` | object | El pipeline de GitLab creado | + +### `gitlab_retry_pipeline` + +Reintentar un pipeline de GitLab fallido + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto o ruta codificada en URL | +| `pipelineId` | number | Sí | ID del pipeline | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `pipeline` | objeto | El pipeline de GitLab reintentado | + +### `gitlab_cancel_pipeline` + +Cancelar un pipeline de GitLab en ejecución + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | cadena | Sí | ID del proyecto o ruta codificada en URL | +| `pipelineId` | número | Sí | ID del pipeline | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `pipeline` | objeto | El pipeline de GitLab cancelado | + +## Notas + +- Categoría: `tools` +- Tipo: `gitlab` diff --git a/apps/docs/content/docs/es/tools/grafana.mdx b/apps/docs/content/docs/es/tools/grafana.mdx new file mode 100644 index 000000000..8b2d0cd5f --- /dev/null +++ b/apps/docs/content/docs/es/tools/grafana.mdx @@ -0,0 +1,494 @@ +--- +title: Grafana +description: Interactúa con paneles, alertas y anotaciones de Grafana +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Grafana](https://grafana.com/) es una plataforma líder de código abierto para monitorización, observabilidad y visualización. Permite a los usuarios consultar, visualizar, alertar y analizar datos de diversas fuentes, convirtiéndola en una herramienta esencial para la monitorización de infraestructuras y aplicaciones. + +Con Grafana, puedes: + +- **Visualizar datos**: Crear y personalizar paneles para mostrar métricas, registros y trazas en tiempo real +- **Monitorizar salud y estado**: Comprobar la salud de tu instancia de Grafana y las fuentes de datos conectadas +- **Gestionar alertas y anotaciones**: Configurar reglas de alerta, gestionar notificaciones y anotar paneles con eventos importantes +- **Organizar contenido**: Organizar paneles y fuentes de datos en carpetas para una mejor gestión de acceso + +En Sim, la integración de Grafana permite a tus agentes interactuar directamente con tu instancia de Grafana a través de API, habilitando acciones como: + +- Comprobar el estado de salud del servidor Grafana, la base de datos y las fuentes de datos +- Recuperar, listar y gestionar paneles, reglas de alerta, anotaciones, fuentes de datos y carpetas +- Automatizar la monitorización de tu infraestructura integrando datos y alertas de Grafana en tus automatizaciones de flujo de trabajo + +Estas capacidades permiten a los agentes de Sim monitorizar sistemas, responder proactivamente a las alertas y ayudar a garantizar la fiabilidad y visibilidad de tus servicios, todo como parte de tus flujos de trabajo automatizados. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra Grafana en flujos de trabajo. Gestiona paneles, alertas, anotaciones, fuentes de datos, carpetas y monitoriza el estado de salud. + +## Herramientas + +### `grafana_get_dashboard` + +Obtener un panel por su UID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de organización para instancias Grafana multi-organización | +| `dashboardUid` | string | Sí | El UID del panel a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `dashboard` | json | El objeto JSON completo del panel de control | +| `meta` | json | Metadatos del panel de control \(versión, permisos, etc.\) | + +### `grafana_list_dashboards` + +Buscar y listar todos los paneles de control + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de la organización para instancias Grafana multi-organización | +| `query` | string | No | Consulta de búsqueda para filtrar paneles por título | +| `tag` | string | No | Filtrar por etiqueta \(separadas por comas para múltiples etiquetas\) | +| `folderIds` | string | No | Filtrar por IDs de carpetas \(separados por comas\) | +| `starred` | boolean | No | Devolver solo paneles destacados | +| `limit` | number | No | Número máximo de paneles a devolver | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `dashboards` | array | Lista de resultados de búsqueda de paneles | + +### `grafana_create_dashboard` + +Crear un nuevo panel de control + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de la organización para instancias Grafana multi-organización | +| `title` | string | Sí | El título del nuevo panel de control | +| `folderUid` | string | No | El UID de la carpeta donde crear el panel de control | +| `tags` | string | No | Lista de etiquetas separadas por comas | +| `timezone` | string | No | Zona horaria del panel \(p. ej., browser, utc\) | +| `refresh` | string | No | Intervalo de actualización automática \(p. ej., 5s, 1m, 5m\) | +| `panels` | string | No | Array JSON de configuraciones de paneles | +| `overwrite` | boolean | No | Sobrescribir panel existente con el mismo título | +| `message` | string | No | Mensaje de commit para la versión del panel | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | number | El ID numérico del panel de control creado | +| `uid` | string | El UID del panel de control creado | +| `url` | string | La ruta URL al panel de control | +| `status` | string | Estado de la operación \(éxito\) | +| `version` | number | El número de versión del panel de control | +| `slug` | string | Slug amigable para URL del panel de control | + +### `grafana_update_dashboard` + +Actualiza un panel de control existente. Obtiene el panel de control actual y fusiona tus cambios. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de organización para instancias Grafana multi-organización | +| `dashboardUid` | string | Sí | El UID del panel de control a actualizar | +| `title` | string | No | Nuevo título para el panel de control | +| `folderUid` | string | No | Nuevo UID de carpeta para mover el panel de control | +| `tags` | string | No | Lista de nuevas etiquetas separadas por comas | +| `timezone` | string | No | Zona horaria del panel de control \(p. ej., browser, utc\) | +| `refresh` | string | No | Intervalo de actualización automática \(p. ej., 5s, 1m, 5m\) | +| `panels` | string | No | Array JSON de configuraciones de paneles | +| `overwrite` | boolean | No | Sobrescribir incluso si hay un conflicto de versiones | +| `message` | string | No | Mensaje de commit para esta versión | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | number | El ID numérico del panel actualizado | +| `uid` | string | El UID del panel actualizado | +| `url` | string | La ruta URL al panel | +| `status` | string | Estado de la operación \(éxito\) | +| `version` | number | El nuevo número de versión del panel | +| `slug` | string | Slug amigable para URL del panel | + +### `grafana_delete_dashboard` + +Eliminar un panel por su UID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de organización para instancias Grafana multi-organización | +| `dashboardUid` | string | Sí | El UID del panel a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `title` | string | El título del panel eliminado | +| `message` | string | Mensaje de confirmación | +| `id` | number | El ID del panel eliminado | + +### `grafana_list_alert_rules` + +Listar todas las reglas de alerta en la instancia de Grafana + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de organización para instancias Grafana multi-organización | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `rules` | array | Lista de reglas de alerta | + +### `grafana_get_alert_rule` + +Obtener una regla de alerta específica por su UID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de organización para instancias Grafana multi-organización | +| `alertRuleUid` | string | Sí | El UID de la regla de alerta a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `uid` | string | UID de la regla de alerta | +| `title` | string | Título de la regla de alerta | +| `condition` | string | Condición de alerta | +| `data` | json | Datos de consulta de la regla de alerta | +| `folderUID` | string | UID de la carpeta principal | +| `ruleGroup` | string | Nombre del grupo de reglas | +| `noDataState` | string | Estado cuando no se devuelven datos | +| `execErrState` | string | Estado en caso de error de ejecución | +| `annotations` | json | Anotaciones de alerta | +| `labels` | json | Etiquetas de alerta | + +### `grafana_create_alert_rule` + +Crear una nueva regla de alerta + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de organización para instancias Grafana multi-organización | +| `title` | string | Sí | El título de la regla de alerta | +| `folderUid` | string | Sí | El UID de la carpeta donde crear la alerta | +| `ruleGroup` | string | Sí | El nombre del grupo de reglas | +| `condition` | string | Sí | El refId de la consulta o expresión a usar como condición de alerta | +| `data` | string | Sí | Array JSON de objetos de datos de consulta/expresión | +| `forDuration` | string | No | Duración de espera antes de activarse \(p. ej., 5m, 1h\) | +| `noDataState` | string | No | Estado cuando no se devuelven datos \(NoData, Alerting, OK\) | +| `execErrState` | string | No | Estado en caso de error de ejecución \(Alerting, OK\) | +| `annotations` | string | No | Objeto JSON de anotaciones | +| `labels` | string | No | Objeto JSON de etiquetas | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `uid` | string | El UID de la regla de alerta creada | +| `title` | string | Título de la regla de alerta | +| `folderUID` | string | UID de la carpeta principal | +| `ruleGroup` | string | Nombre del grupo de reglas | + +### `grafana_update_alert_rule` + +Actualiza una regla de alerta existente. Obtiene la regla actual y fusiona tus cambios. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana (p. ej., https://your-grafana.com) | +| `organizationId` | string | No | ID de la organización para instancias de Grafana multi-organización | +| `alertRuleUid` | string | Sí | El UID de la regla de alerta a actualizar | +| `title` | string | No | Nuevo título para la regla de alerta | +| `folderUid` | string | No | Nuevo UID de carpeta para mover la alerta | +| `ruleGroup` | string | No | Nuevo nombre del grupo de reglas | +| `condition` | string | No | Nuevo refId de condición | +| `data` | string | No | Nuevo array JSON de objetos de datos de consulta/expresión | +| `forDuration` | string | No | Duración de espera antes de activar (p. ej., 5m, 1h) | +| `noDataState` | string | No | Estado cuando no se devuelven datos (NoData, Alerting, OK) | +| `execErrState` | string | No | Estado en caso de error de ejecución (Alerting, OK) | +| `annotations` | string | No | Objeto JSON de anotaciones | +| `labels` | string | No | Objeto JSON de etiquetas | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `uid` | string | El UID de la regla de alerta actualizada | +| `title` | string | Título de la regla de alerta | +| `folderUID` | string | UID de la carpeta principal | +| `ruleGroup` | string | Nombre del grupo de reglas | + +### `grafana_delete_alert_rule` + +Eliminar una regla de alerta por su UID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana (p. ej., https://your-grafana.com) | +| `organizationId` | string | No | ID de la organización para instancias de Grafana multi-organización | +| `alertRuleUid` | string | Sí | El UID de la regla de alerta a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `message` | string | Mensaje de confirmación | + +### `grafana_list_contact_points` + +Listar todos los puntos de contacto para notificaciones de alerta + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana (p. ej., https://your-grafana.com) | +| `organizationId` | string | No | ID de la organización para instancias de Grafana multi-organización | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `contactPoints` | array | Lista de puntos de contacto | + +### `grafana_create_annotation` + +Crear una anotación en un panel o como una anotación global + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de la organización para instancias de Grafana multi-organización | +| `text` | string | Sí | El contenido de texto de la anotación | +| `tags` | string | No | Lista de etiquetas separadas por comas | +| `dashboardUid` | string | No | UID del panel donde añadir la anotación \(opcional para anotaciones globales\) | +| `panelId` | number | No | ID del panel donde añadir la anotación | +| `time` | number | No | Hora de inicio en milisegundos de época \(por defecto es ahora\) | +| `timeEnd` | number | No | Hora de finalización en milisegundos de época \(para anotaciones de rango\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | number | El ID de la anotación creada | +| `message` | string | Mensaje de confirmación | + +### `grafana_list_annotations` + +Consultar anotaciones por rango de tiempo, panel o etiquetas + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de la organización para instancias de Grafana multi-organización | +| `from` | number | No | Hora de inicio en milisegundos de época | +| `to` | number | No | Hora de finalización en milisegundos de época | +| `dashboardUid` | string | No | Filtrar por UID del panel | +| `panelId` | number | No | Filtrar por ID del panel | +| `tags` | string | No | Lista de etiquetas separadas por comas para filtrar | +| `type` | string | No | Filtrar por tipo \(alerta o anotación\) | +| `limit` | number | No | Número máximo de anotaciones a devolver | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `annotations` | array | Lista de anotaciones | + +### `grafana_update_annotation` + +Actualizar una anotación existente + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de organización para instancias Grafana multi-organización | +| `annotationId` | number | Sí | El ID de la anotación a actualizar | +| `text` | string | Sí | Nuevo contenido de texto para la anotación | +| `tags` | string | No | Lista de nuevas etiquetas separadas por comas | +| `time` | number | No | Nueva hora de inicio en milisegundos de época | +| `timeEnd` | number | No | Nueva hora de finalización en milisegundos de época | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | number | El ID de la anotación actualizada | +| `message` | string | Mensaje de confirmación | + +### `grafana_delete_annotation` + +Eliminar una anotación por su ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de organización para instancias Grafana multi-organización | +| `annotationId` | number | Sí | El ID de la anotación a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `message` | string | Mensaje de confirmación | + +### `grafana_list_data_sources` + +Listar todas las fuentes de datos configuradas en Grafana + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana (ej., https://your-grafana.com) | +| `organizationId` | string | No | ID de organización para instancias Grafana multi-organización | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `dataSources` | array | Lista de fuentes de datos | + +### `grafana_get_data_source` + +Obtener una fuente de datos por su ID o UID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana (ej., https://your-grafana.com) | +| `organizationId` | string | No | ID de organización para instancias Grafana multi-organización | +| `dataSourceId` | string | Sí | El ID o UID de la fuente de datos a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | number | ID de la fuente de datos | +| `uid` | string | UID de la fuente de datos | +| `name` | string | Nombre de la fuente de datos | +| `type` | string | Tipo de fuente de datos | +| `url` | string | URL de conexión de la fuente de datos | +| `database` | string | Nombre de la base de datos (si aplica) | +| `isDefault` | boolean | Si esta es la fuente de datos predeterminada | +| `jsonData` | json | Configuración adicional de la fuente de datos | + +### `grafana_list_folders` + +Listar todas las carpetas en Grafana + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de la organización para instancias de Grafana multi-organización | +| `limit` | number | No | Número máximo de carpetas a devolver | +| `page` | number | No | Número de página para paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `folders` | array | Lista de carpetas | + +### `grafana_create_folder` + +Crear una nueva carpeta en Grafana + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de cuenta de servicio de Grafana | +| `baseUrl` | string | Sí | URL de la instancia de Grafana \(p. ej., https://your-grafana.com\) | +| `organizationId` | string | No | ID de la organización para instancias de Grafana multi-organización | +| `title` | string | Sí | El título de la nueva carpeta | +| `uid` | string | No | UID opcional para la carpeta \(se genera automáticamente si no se proporciona\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | number | El ID numérico de la carpeta creada | +| `uid` | string | El UID de la carpeta creada | +| `title` | string | El título de la carpeta creada | +| `url` | string | La ruta URL a la carpeta | + +## Notas + +- Categoría: `tools` +- Tipo: `grafana` diff --git a/apps/docs/content/docs/es/tools/kalshi.mdx b/apps/docs/content/docs/es/tools/kalshi.mdx new file mode 100644 index 000000000..7f850bace --- /dev/null +++ b/apps/docs/content/docs/es/tools/kalshi.mdx @@ -0,0 +1,295 @@ +--- +title: Kalshi +description: Accede a datos de mercados de predicción de Kalshi +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Kalshi](https://kalshi.com) es un mercado regulado federalmente donde los usuarios pueden operar directamente sobre los resultados de eventos futuros—mercados de predicción. La robusta API de Kalshi y la integración con Sim permiten a los agentes y flujos de trabajo acceder programáticamente a todos los aspectos de la plataforma, admitiendo desde investigación y análisis hasta operaciones automatizadas y monitoreo. + +Con la integración de Kalshi en Sim, puedes: + +- **Datos de mercados y eventos:** Buscar, filtrar y obtener datos en tiempo real e históricos de mercados y eventos; obtener detalles granulares sobre el estado del mercado, series, agrupaciones de eventos y más. +- **Gestión de cuentas y saldos:** Acceder a saldos de cuenta, fondos disponibles y monitorear posiciones abiertas en tiempo real. +- **Gestión de órdenes y operaciones:** Colocar nuevas órdenes, cancelar las existentes, ver órdenes abiertas, obtener un libro de órdenes en vivo y acceder a historiales completos de operaciones. +- **Análisis de ejecución:** Obtener operaciones recientes, ejecuciones históricas y datos de velas para backtesting o investigación de estructura de mercado. +- **Monitoreo:** Verificar el estado de todo el mercado o a nivel de series, recibir actualizaciones en tiempo real sobre cambios en el mercado o interrupciones de operaciones, y automatizar respuestas. +- **Listo para automatización:** Construir agentes automatizados y paneles de control de extremo a extremo que consuman, analicen y operen con probabilidades de eventos del mundo real. + +Al utilizar estas herramientas y puntos de acceso unificados, puedes incorporar sin problemas los mercados de predicción de Kalshi, capacidades de operación en vivo y datos profundos de eventos en tus aplicaciones impulsadas por IA, paneles de control y flujos de trabajo, permitiendo una toma de decisiones sofisticada y automatizada vinculada a resultados del mundo real. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra los mercados de predicción de Kalshi en el flujo de trabajo. Puede obtener mercados, mercado, eventos, evento, saldo, posiciones, órdenes, libro de órdenes, operaciones, velas, ejecuciones, series y estado del mercado. + +## Herramientas + +### `kalshi_get_markets` + +Obtener una lista de mercados de predicción de Kalshi con filtrado opcional + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `status` | string | No | Filtrar por estado \(unopened, open, closed, settled\) | +| `seriesTicker` | string | No | Filtrar por ticker de serie | +| `eventTicker` | string | No | Filtrar por ticker de evento | +| `limit` | string | No | Número de resultados \(1-1000, predeterminado: 100\) | +| `cursor` | string | No | Cursor de paginación para la siguiente página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de mercados y metadatos | + +### `kalshi_get_market` + +Obtener detalles de un mercado de predicción específico por ticker + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `ticker` | string | Sí | El ticker del mercado \(p. ej., "KXBTC-24DEC31"\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del mercado y metadatos | + +### `kalshi_get_events` + +Obtener una lista de eventos de Kalshi con filtrado opcional + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `status` | string | No | Filtrar por estado \(open, closed, settled\) | +| `seriesTicker` | string | No | Filtrar por ticker de serie | +| `withNestedMarkets` | string | No | Incluir mercados anidados en la respuesta \(true/false\) | +| `limit` | string | No | Número de resultados \(1-200, predeterminado: 200\) | +| `cursor` | string | No | Cursor de paginación para la siguiente página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de eventos | + +### `kalshi_get_event` + +Recuperar detalles de un evento específico por ticker + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `eventTicker` | string | Sí | El ticker del evento | +| `withNestedMarkets` | string | No | Incluir mercados anidados en la respuesta \(true/false\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos del evento | + +### `kalshi_get_balance` + +Recuperar el saldo de tu cuenta y el valor de la cartera desde Kalshi + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | Sí | Tu ID de clave API de Kalshi | +| `privateKey` | string | Sí | Tu clave privada RSA \(formato PEM\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos del saldo | + +### `kalshi_get_positions` + +Recuperar tus posiciones abiertas desde Kalshi + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | Sí | Tu ID de clave API de Kalshi | +| `privateKey` | string | Sí | Tu clave privada RSA \(formato PEM\) | +| `ticker` | string | No | Filtrar por ticker de mercado | +| `eventTicker` | string | No | Filtrar por ticker de evento \(máximo 10 separados por comas\) | +| `settlementStatus` | string | No | Filtrar por estado de liquidación \(all, unsettled, settled\). Predeterminado: unsettled | +| `limit` | string | No | Número de resultados \(1-1000, predeterminado: 100\) | +| `cursor` | string | No | Cursor de paginación para la siguiente página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de posiciones y metadatos | + +### `kalshi_get_orders` + +Recupera tus órdenes de Kalshi con filtrado opcional + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | Sí | Tu ID de clave API de Kalshi | +| `privateKey` | string | Sí | Tu clave privada RSA \(formato PEM\) | +| `ticker` | string | No | Filtrar por ticker de mercado | +| `eventTicker` | string | No | Filtrar por ticker de evento \(máximo 10 separados por comas\) | +| `status` | string | No | Filtrar por estado \(en espera, cancelado, ejecutado\) | +| `limit` | string | No | Número de resultados \(1-200, predeterminado: 100\) | +| `cursor` | string | No | Cursor de paginación para la siguiente página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de órdenes y metadatos | + +### `kalshi_get_orderbook` + +Recupera el libro de órdenes (ofertas de compra y venta) para un mercado específico + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `ticker` | string | Sí | Ticker del mercado \(p. ej., KXBTC-24DEC31\) | +| `depth` | number | No | Número de niveles de precio a devolver por lado | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos del libro de órdenes | + +### `kalshi_get_trades` + +Recuperar operaciones recientes en todos los mercados o para un mercado específico + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `ticker` | string | No | Filtrar por ticker de mercado | +| `minTs` | number | No | Marca de tiempo mínima \(Unix en milisegundos\) | +| `maxTs` | number | No | Marca de tiempo máxima \(Unix en milisegundos\) | +| `limit` | string | No | Número de resultados \(1-1000, predeterminado: 100\) | +| `cursor` | string | No | Cursor de paginación para la siguiente página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de operaciones | + +### `kalshi_get_candlesticks` + +Recuperar datos de velas OHLC para un mercado específico + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `seriesTicker` | string | Sí | Ticker de serie | +| `ticker` | string | Sí | Ticker de mercado \(p. ej., KXBTC-24DEC31\) | +| `startTs` | number | No | Marca de tiempo de inicio \(Unix en milisegundos\) | +| `endTs` | number | No | Marca de tiempo de fin \(Unix en milisegundos\) | +| `periodInterval` | number | No | Intervalo de período: 1 \(1min\), 60 \(1hora\), o 1440 \(1día\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de velas e información adicional | + +### `kalshi_get_fills` + +Recuperar tu cartera + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | Sí | Tu ID de clave API de Kalshi | +| `privateKey` | string | Sí | Tu clave privada RSA (formato PEM) | +| `ticker` | string | No | Filtrar por ticker de mercado | +| `orderId` | string | No | Filtrar por ID de orden | +| `minTs` | number | No | Marca de tiempo mínima (milisegundos Unix) | +| `maxTs` | number | No | Marca de tiempo máxima (milisegundos Unix) | +| `limit` | string | No | Número de resultados (1-1000, predeterminado: 100) | +| `cursor` | string | No | Cursor de paginación para la siguiente página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de ejecuciones e información adicional | + +### `kalshi_get_series_by_ticker` + +Recuperar detalles de una serie de mercado específica por ticker + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `seriesTicker` | string | Sí | Ticker de la serie | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la serie e información adicional | + +### `kalshi_get_exchange_status` + +Recupera el estado actual del intercambio Kalshi (actividad de trading y del intercambio) + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de estado del intercambio y metadatos | + +## Notas + +- Categoría: `tools` +- Tipo: `kalshi` diff --git a/apps/docs/content/docs/es/tools/polymarket.mdx b/apps/docs/content/docs/es/tools/polymarket.mdx new file mode 100644 index 000000000..9eea68def --- /dev/null +++ b/apps/docs/content/docs/es/tools/polymarket.mdx @@ -0,0 +1,352 @@ +--- +title: Polymarket +description: Accede a datos de mercados de predicción desde Polymarket +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Polymarket](https://polymarket.com) es una plataforma descentralizada de mercados de predicción donde los usuarios pueden operar sobre el resultado de eventos futuros utilizando tecnología blockchain. Polymarket proporciona una API completa, permitiendo a desarrolladores y agentes acceder a datos de mercado en vivo, listados de eventos, información de precios y estadísticas de libro de órdenes para potenciar flujos de trabajo basados en datos y automatizaciones de IA. + +Con la API de Polymarket y la integración de Sim, puedes permitir que los agentes recuperen programáticamente información de mercados de predicción, exploren mercados abiertos y eventos asociados, analicen datos históricos de precios y accedan a libros de órdenes y puntos medios del mercado. Esto crea nuevas posibilidades para la investigación, análisis automatizado y desarrollo de agentes inteligentes que reaccionan a probabilidades de eventos en tiempo real derivadas de los precios del mercado. + +Las características principales de la integración de Polymarket incluyen: + +- **Listado y filtrado de mercados:** Lista todos los mercados de predicción actuales o históricos, filtra por etiqueta, ordena y navega por los resultados paginados. +- **Detalle del mercado:** Recupera detalles de un solo mercado por ID o slug, incluyendo sus resultados y estado. +- **Listados de eventos:** Accede a listas de eventos de Polymarket e información detallada de eventos. +- **Libro de órdenes y datos de precios:** Analiza el libro de órdenes, obtén los últimos precios del mercado, visualiza el punto medio u obtén información histórica de precios para cualquier mercado. +- **Listo para automatización:** Construye agentes o herramientas que reaccionan programáticamente a desarrollos del mercado, cambios en las probabilidades o resultados específicos de eventos. + +Al utilizar estos endpoints de API documentados, puedes integrar perfectamente los ricos datos de mercados de predicción en cadena de Polymarket en tus propios flujos de trabajo de IA, paneles de control, herramientas de investigación y automatizaciones de trading. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra los mercados de predicción de Polymarket en el flujo de trabajo. Puede obtener mercados, mercado, eventos, evento, etiquetas, series, libro de órdenes, precio, punto medio, historial de precios, último precio de operación, diferencial, tamaño de tick, posiciones, operaciones y búsqueda. + +## Herramientas + +### `polymarket_get_markets` + +Obtener una lista de mercados de predicción de Polymarket con filtrado opcional + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `closed` | string | No | Filtrar por estado cerrado \(true/false\). Usa false para mercados activos solamente. | +| `order` | string | No | Campo de ordenación \(p. ej., id, volume, liquidity\) | +| `ascending` | string | No | Dirección de ordenación \(true para ascendente, false para descendente\) | +| `tagId` | string | No | Filtrar por ID de etiqueta | +| `limit` | string | No | Número de resultados por página \(recomendado: 25-50\) | +| `offset` | string | No | Desplazamiento de paginación \(omitir esta cantidad de resultados\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de mercados y metadatos | + +### `polymarket_get_market` + +Obtener detalles de un mercado de predicción específico por ID o slug + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `marketId` | string | No | El ID del mercado. Requerido si no se proporciona el slug. | +| `slug` | string | No | El slug del mercado \(p. ej., "will-trump-win"\). Requerido si no se proporciona marketId. | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de mercado y metadatos | + +### `polymarket_get_events` + +Obtener una lista de eventos de Polymarket con filtrado opcional + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `closed` | string | No | Filtrar por estado cerrado (true/false). Usar false para eventos activos solamente. | +| `order` | string | No | Campo de ordenación (ej., id, volume) | +| `ascending` | string | No | Dirección de ordenación (true para ascendente, false para descendente) | +| `tagId` | string | No | Filtrar por ID de etiqueta | +| `limit` | string | No | Número de resultados por página (recomendado: 25-50) | +| `offset` | string | No | Desplazamiento de paginación (omitir esta cantidad de resultados) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de eventos y metadatos | + +### `polymarket_get_event` + +Obtener detalles de un evento específico por ID o slug + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `eventId` | string | No | El ID del evento. Requerido si no se proporciona el slug. | +| `slug` | string | No | El slug del evento (ej., "2024-presidential-election"). Requerido si no se proporciona eventId. | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos del evento | + +### `polymarket_get_tags` + +Obtener etiquetas disponibles para filtrar mercados de Polymarket + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `limit` | string | No | Número de resultados por página \(recomendado: 25-50\) | +| `offset` | string | No | Desplazamiento de paginación \(omitir esta cantidad de resultados\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de etiquetas | + +### `polymarket_search` + +Buscar mercados, eventos y perfiles en Polymarket + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `query` | string | Sí | Término de búsqueda | +| `limit` | string | No | Número de resultados por página \(recomendado: 25-50\) | +| `offset` | string | No | Desplazamiento de paginación \(omitir esta cantidad de resultados\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultados de búsqueda y metadatos | + +### `polymarket_get_series` + +Obtener series (grupos de mercados relacionados) de Polymarket + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `limit` | string | No | Número de resultados por página \(recomendado: 25-50\) | +| `offset` | string | No | Desplazamiento de paginación \(omitir esta cantidad de resultados\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de la serie | + +### `polymarket_get_series_by_id` + +Recuperar una serie específica (grupo de mercado relacionado) por ID desde Polymarket + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `seriesId` | string | Sí | El ID de la serie | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de la serie | + +### `polymarket_get_orderbook` + +Recuperar el resumen del libro de órdenes para un token específico + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos del libro de órdenes | + +### `polymarket_get_price` + +Recuperar el precio de mercado para un token y lado específicos + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) | +| `side` | string | Sí | Lado de la orden: compra o venta | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de precio y metadatos | + +### `polymarket_get_midpoint` + +Recuperar el precio medio para un token específico + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del precio medio y metadatos | + +### `polymarket_get_price_history` + +Recuperar datos históricos de precios para un token de mercado específico + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) | +| `interval` | string | No | Duración que termina en el tiempo actual (1m, 1h, 6h, 1d, 1w, max). Mutuamente excluyente con startTs/endTs. | +| `fidelity` | number | No | Resolución de datos en minutos (por ejemplo, 60 para datos por hora) | +| `startTs` | number | No | Marca de tiempo de inicio (segundos Unix UTC) | +| `endTs` | number | No | Marca de tiempo de fin (segundos Unix UTC) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del historial de precios y metadatos | + +### `polymarket_get_last_trade_price` + +Recuperar el último precio de operación para un token específico + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Último precio de operación y metadatos | + +### `polymarket_get_spread` + +Recuperar el diferencial de oferta y demanda para un token específico + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del diferencial y metadatos | + +### `polymarket_get_tick_size` + +Recuperar el tamaño mínimo de tick para un token específico + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Tamaño del tick y metadatos | + +### `polymarket_get_positions` + +Recuperar las posiciones del usuario desde Polymarket + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `user` | string | Sí | Dirección de la cartera del usuario | +| `market` | string | No | ID de mercado opcional para filtrar posiciones | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de posiciones y metadatos | + +### `polymarket_get_trades` + +Recuperar historial de operaciones de Polymarket + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `user` | string | No | Dirección de la cartera del usuario para filtrar operaciones | +| `market` | string | No | ID de mercado para filtrar operaciones | +| `limit` | string | No | Número de resultados por página \(recomendado: 25-50\) | +| `offset` | string | No | Desplazamiento de paginación \(omitir esta cantidad de resultados\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de operaciones y metadatos | + +## Notas + +- Categoría: `tools` +- Tipo: `polymarket` diff --git a/apps/docs/content/docs/es/tools/pylon.mdx b/apps/docs/content/docs/es/tools/pylon.mdx index d5d20d145..1689af5bb 100644 --- a/apps/docs/content/docs/es/tools/pylon.mdx +++ b/apps/docs/content/docs/es/tools/pylon.mdx @@ -81,12 +81,19 @@ Crear un nuevo problema con propiedades específicas #### Entrada | Parámetro | Tipo | Obligatorio | Descripción | -| --------- | ---- | ----------- | ----------- | +| --------- | ---- | -------- | ----------- | | `apiToken` | string | Sí | Token de API de Pylon | | `title` | string | Sí | Título del problema | | `bodyHtml` | string | Sí | Cuerpo del problema en formato HTML | -| `accountId` | string | No | ID de cuenta para asociar con el problema | -| `assigneeId` | string | No | ID de usuario para asignar el problema | +| `accountId` | string | No | ID de la cuenta a asociar con el problema | +| `assigneeId` | string | No | ID del usuario al que asignar el problema | +| `teamId` | string | No | ID del equipo al que asignar el problema | +| `requesterId` | string | No | ID del usuario solicitante \(alternativa a requester_email\) | +| `requesterEmail` | string | No | Dirección de correo electrónico del solicitante \(alternativa a requester_id\) | +| `priority` | string | No | Prioridad del problema | +| `tags` | string | No | IDs de etiquetas separados por comas | +| `customFields` | string | No | Campos personalizados como objeto JSON | +| `attachmentUrls` | string | No | URLs de archivos adjuntos separados por comas | #### Salida @@ -124,10 +131,13 @@ Actualizar un problema existente | `apiToken` | string | Sí | Token de API de Pylon | | `issueId` | string | Sí | El ID del problema a actualizar | | `state` | string | No | Estado del problema | -| `assigneeId` | string | No | ID de usuario para asignar el problema | -| `teamId` | string | No | ID del equipo para asignar el problema | +| `assigneeId` | string | No | ID del usuario al que asignar el problema | +| `teamId` | string | No | ID del equipo al que asignar el problema | | `tags` | string | No | IDs de etiquetas separados por comas | | `customFields` | string | No | Campos personalizados como objeto JSON | +| `customerPortalVisible` | boolean | No | Si el problema es visible en el portal del cliente | +| `requesterId` | string | No | ID del usuario solicitante | +| `accountId` | string | No | ID de la cuenta a asociar con el problema | #### Salida diff --git a/apps/docs/content/docs/es/tools/shopify.mdx b/apps/docs/content/docs/es/tools/shopify.mdx new file mode 100644 index 000000000..9f9c92051 --- /dev/null +++ b/apps/docs/content/docs/es/tools/shopify.mdx @@ -0,0 +1,444 @@ +--- +title: Shopify +description: Gestiona productos, pedidos, clientes e inventario en tu tienda Shopify +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Shopify](https://www.shopify.com/) es una plataforma líder de comercio electrónico diseñada para ayudar a los comerciantes a construir, administrar y hacer crecer sus tiendas en línea. Shopify facilita la gestión de todos los aspectos de tu tienda, desde productos e inventario hasta pedidos y clientes. + +Con Shopify en Sim, tus agentes pueden: + +- **Crear y gestionar productos**: Añadir nuevos productos, actualizar detalles de productos y eliminar productos de tu tienda. +- **Listar y recuperar pedidos**: Obtener información sobre los pedidos de los clientes, incluyendo filtrado y gestión de pedidos. +- **Gestionar clientes**: Acceder y actualizar detalles de clientes, o añadir nuevos clientes a tu tienda. +- **Ajustar niveles de inventario**: Cambiar programáticamente los niveles de stock de productos para mantener tu inventario preciso. + +Utiliza la integración de Shopify en Sim para automatizar flujos de trabajo comunes de gestión de tiendas, como sincronizar inventario, cumplir pedidos o gestionar listados, directamente desde tus automatizaciones. Permite a tus agentes acceder, actualizar y organizar todos los datos de tu tienda utilizando herramientas simples y programáticas. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra Shopify en tu flujo de trabajo. Gestiona productos, pedidos, clientes e inventario. Crea, lee, actualiza y elimina productos. Lista y gestiona pedidos. Maneja datos de clientes y ajusta niveles de inventario. + +## Herramientas + +### `shopify_create_product` + +Crear un nuevo producto en tu tienda Shopify + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(ej., mitienda.myshopify.com\) | +| `title` | string | Sí | Título del producto | +| `descriptionHtml` | string | No | Descripción del producto \(HTML\) | +| `vendor` | string | No | Proveedor/marca del producto | +| `productType` | string | No | Tipo/categoría del producto | +| `tags` | array | No | Etiquetas del producto | +| `status` | string | No | Estado del producto \(ACTIVE, DRAFT, ARCHIVED\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `product` | object | El producto creado | + +### `shopify_get_product` + +Obtener un solo producto por ID de tu tienda Shopify + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(p. ej., mitienda.myshopify.com\) | +| `productId` | string | Sí | ID del producto \(gid://shopify/Product/123456789\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `product` | object | Los detalles del producto | + +### `shopify_list_products` + +Listar productos de tu tienda Shopify con filtrado opcional + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(p. ej., mitienda.myshopify.com\) | +| `first` | number | No | Número de productos a devolver \(predeterminado: 50, máximo: 250\) | +| `query` | string | No | Consulta de búsqueda para filtrar productos \(p. ej., "title:camisa" o "vendor:Nike" o "status:active"\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `products` | array | Lista de productos | +| `pageInfo` | object | Información de paginación | + +### `shopify_update_product` + +Actualizar un producto existente en tu tienda Shopify + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(p. ej., mitienda.myshopify.com\) | +| `productId` | string | Sí | ID del producto a actualizar \(gid://shopify/Product/123456789\) | +| `title` | string | No | Nuevo título del producto | +| `descriptionHtml` | string | No | Nueva descripción del producto \(HTML\) | +| `vendor` | string | No | Nuevo proveedor/marca del producto | +| `productType` | string | No | Nuevo tipo/categoría del producto | +| `tags` | array | No | Nuevas etiquetas del producto | +| `status` | string | No | Nuevo estado del producto \(ACTIVE, DRAFT, ARCHIVED\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `product` | objeto | El producto actualizado | + +### `shopify_delete_product` + +Eliminar un producto de tu tienda Shopify + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(p. ej., mitienda.myshopify.com\) | +| `productId` | string | Sí | ID del producto a eliminar \(gid://shopify/Product/123456789\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `deletedId` | string | El ID del producto eliminado | + +### `shopify_get_order` + +Obtener un pedido individual por ID de tu tienda Shopify + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(p. ej., mitienda.myshopify.com\) | +| `orderId` | string | Sí | ID del pedido \(gid://shopify/Order/123456789\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `order` | objeto | Los detalles del pedido | + +### `shopify_list_orders` + +Listar pedidos de tu tienda Shopify con filtrado opcional + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(p. ej., mitienda.myshopify.com\) | +| `first` | number | No | Número de pedidos a devolver \(predeterminado: 50, máximo: 250\) | +| `status` | string | No | Filtrar por estado del pedido \(abierto, cerrado, cancelado, cualquiera\) | +| `query` | string | No | Consulta de búsqueda para filtrar pedidos \(p. ej., "financial_status:paid" o "fulfillment_status:unfulfilled" o "email:customer@example.com"\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `orders` | array | Lista de pedidos | +| `pageInfo` | object | Información de paginación | + +### `shopify_update_order` + +Actualizar un pedido existente en tu tienda Shopify (nota, etiquetas, correo electrónico) + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(p. ej., mitienda.myshopify.com\) | +| `orderId` | string | Sí | ID del pedido a actualizar \(gid://shopify/Order/123456789\) | +| `note` | string | No | Nueva nota del pedido | +| `tags` | array | No | Nuevas etiquetas del pedido | +| `email` | string | No | Nuevo correo electrónico del cliente para el pedido | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `order` | object | El pedido actualizado | + +### `shopify_cancel_order` + +Cancelar un pedido en tu tienda Shopify + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(p. ej., mitienda.myshopify.com\) | +| `orderId` | string | Sí | ID del pedido a cancelar \(gid://shopify/Order/123456789\) | +| `reason` | string | Sí | Motivo de cancelación \(CUSTOMER, DECLINED, FRAUD, INVENTORY, STAFF, OTHER\) | +| `notifyCustomer` | boolean | No | Si se debe notificar al cliente sobre la cancelación | +| `refund` | boolean | No | Si se debe reembolsar el pedido | +| `restock` | boolean | No | Si se debe reponer el inventario | +| `staffNote` | string | No | Una nota sobre la cancelación para referencia del personal | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `order` | object | El resultado de la cancelación | + +### `shopify_create_customer` + +Crear un nuevo cliente en tu tienda Shopify + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(p. ej., mitienda.myshopify.com\) | +| `email` | string | No | Dirección de correo electrónico del cliente | +| `firstName` | string | No | Nombre del cliente | +| `lastName` | string | No | Apellido del cliente | +| `phone` | string | No | Número de teléfono del cliente | +| `note` | string | No | Nota sobre el cliente | +| `tags` | array | No | Etiquetas del cliente | +| `addresses` | array | No | Direcciones del cliente | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `customer` | object | El cliente creado | + +### `shopify_get_customer` + +Obtener un solo cliente por ID de tu tienda Shopify + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(p. ej., mitienda.myshopify.com\) | +| `customerId` | string | Sí | ID del cliente \(gid://shopify/Customer/123456789\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `customer` | object | Los detalles del cliente | + +### `shopify_list_customers` + +Lista los clientes de tu tienda Shopify con filtrado opcional + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(ej., mitienda.myshopify.com\) | +| `first` | number | No | Número de clientes a devolver \(predeterminado: 50, máximo: 250\) | +| `query` | string | No | Consulta de búsqueda para filtrar clientes \(ej., "first_name:John" o "last_name:Smith" o "email:*@gmail.com" o "tag:vip"\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `customers` | array | Lista de clientes | +| `pageInfo` | object | Información de paginación | + +### `shopify_update_customer` + +Actualiza un cliente existente en tu tienda Shopify + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(ej., mitienda.myshopify.com\) | +| `customerId` | string | Sí | ID del cliente a actualizar \(gid://shopify/Customer/123456789\) | +| `email` | string | No | Nueva dirección de correo electrónico del cliente | +| `firstName` | string | No | Nuevo nombre del cliente | +| `lastName` | string | No | Nuevo apellido del cliente | +| `phone` | string | No | Nuevo número de teléfono del cliente | +| `note` | string | No | Nueva nota sobre el cliente | +| `tags` | array | No | Nuevas etiquetas del cliente | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `customer` | object | El cliente actualizado | + +### `shopify_delete_customer` + +Eliminar un cliente de tu tienda Shopify + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(ej., mitienda.myshopify.com\) | +| `customerId` | string | Sí | ID del cliente a eliminar \(gid://shopify/Customer/123456789\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `deletedId` | string | El ID del cliente eliminado | + +### `shopify_list_inventory_items` + +Listar artículos de inventario de tu tienda Shopify. Utiliza esto para encontrar IDs de artículos de inventario por SKU. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(ej., mitienda.myshopify.com\) | +| `first` | number | No | Número de artículos de inventario a devolver \(predeterminado: 50, máximo: 250\) | +| `query` | string | No | Consulta de búsqueda para filtrar artículos de inventario \(ej., "sku:ABC123"\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `inventoryItems` | array | Lista de artículos de inventario con sus IDs, SKUs y niveles de stock | +| `pageInfo` | object | Información de paginación | + +### `shopify_get_inventory_level` + +Obtener nivel de inventario para una variante de producto en una ubicación específica + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(ej., mitienda.myshopify.com\) | +| `inventoryItemId` | string | Sí | ID del artículo de inventario \(gid://shopify/InventoryItem/123456789\) | +| `locationId` | string | No | ID de ubicación para filtrar \(opcional\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `inventoryLevel` | object | Los detalles del nivel de inventario | + +### `shopify_adjust_inventory` + +Ajustar la cantidad de inventario para una variante de producto en una ubicación específica + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(p. ej., mitienda.myshopify.com\) | +| `inventoryItemId` | string | Sí | ID del artículo de inventario \(gid://shopify/InventoryItem/123456789\) | +| `locationId` | string | Sí | ID de ubicación \(gid://shopify/Location/123456789\) | +| `delta` | number | Sí | Cantidad a ajustar \(positivo para aumentar, negativo para disminuir\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `inventoryLevel` | object | El resultado del ajuste de inventario | + +### `shopify_list_locations` + +Listar ubicaciones de inventario de tu tienda Shopify. Utiliza esto para encontrar los IDs de ubicación necesarios para operaciones de inventario. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(p. ej., mitienda.myshopify.com\) | +| `first` | number | No | Número de ubicaciones a devolver \(predeterminado: 50, máximo: 250\) | +| `includeInactive` | boolean | No | Si se deben incluir ubicaciones desactivadas \(predeterminado: false\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `locations` | array | Lista de ubicaciones con sus IDs, nombres y direcciones | +| `pageInfo` | object | Información de paginación | + +### `shopify_create_fulfillment` + +Crea un envío para marcar los artículos del pedido como enviados. Requiere un ID de orden de envío (obtén esto desde los detalles del pedido). + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(ej., mitienda.myshopify.com\) | +| `fulfillmentOrderId` | string | Sí | El ID de la orden de envío \(ej., gid://shopify/FulfillmentOrder/123456789\) | +| `trackingNumber` | string | No | Número de seguimiento para el envío | +| `trackingCompany` | string | No | Nombre del transportista \(ej., UPS, FedEx, USPS, DHL\) | +| `trackingUrl` | string | No | URL para rastrear el envío | +| `notifyCustomer` | boolean | No | Si se debe enviar un correo electrónico de confirmación de envío al cliente \(predeterminado: true\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `fulfillment` | object | El envío creado con información de seguimiento y artículos enviados | + +### `shopify_list_collections` + +Lista las colecciones de productos de tu tienda Shopify. Filtra por título, tipo (personalizada/inteligente) o identificador. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(ej., mitienda.myshopify.com\) | +| `first` | number | No | Número de colecciones a devolver \(predeterminado: 50, máx: 250\) | +| `query` | string | No | Consulta de búsqueda para filtrar colecciones \(ej., "title:Verano" o "collection_type:smart"\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `collections` | array | Lista de colecciones con sus IDs, títulos y recuentos de productos | +| `pageInfo` | object | Información de paginación | + +### `shopify_get_collection` + +Obtén una colección específica por ID, incluyendo sus productos. Usa esto para recuperar productos dentro de una colección. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Sí | El dominio de tu tienda Shopify \(p. ej., mitienda.myshopify.com\) | +| `collectionId` | string | Sí | El ID de la colección \(p. ej., gid://shopify/Collection/123456789\) | +| `productsFirst` | number | No | Número de productos a devolver de esta colección \(predeterminado: 50, máx: 250\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `collection` | object | Los detalles de la colección incluyendo sus productos | + +## Notas + +- Categoría: `tools` +- Tipo: `shopify` diff --git a/apps/docs/content/docs/es/tools/ssh.mdx b/apps/docs/content/docs/es/tools/ssh.mdx new file mode 100644 index 000000000..8da93c259 --- /dev/null +++ b/apps/docs/content/docs/es/tools/ssh.mdx @@ -0,0 +1,394 @@ +--- +title: SSH +description: Conéctate a servidores remotos vía SSH +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[SSH (Secure Shell)](https://en.wikipedia.org/wiki/Secure_Shell) es un protocolo ampliamente utilizado para conectarse de forma segura a servidores remotos, permitiéndote ejecutar comandos, transferir archivos y gestionar sistemas a través de canales cifrados. + +Con el soporte SSH en Sim, tus agentes pueden: + +- **Ejecutar comandos remotos**: Ejecuta comandos de shell en cualquier servidor accesible por SSH +- **Subir y ejecutar scripts**: Transfiere y ejecuta fácilmente scripts de múltiples líneas para automatización avanzada +- **Transferir archivos de forma segura**: Sube y descarga archivos como parte de tus flujos de trabajo (próximamente o mediante comando) +- **Automatizar la gestión de servidores**: Realiza actualizaciones, mantenimiento, monitoreo, despliegues y tareas de configuración de forma programática +- **Usar autenticación flexible**: Conéctate con autenticación por contraseña o clave privada, incluyendo soporte para claves cifradas + +Las siguientes herramientas SSH de Sim permiten a tus agentes interactuar con servidores como parte de automatizaciones más amplias: + +- `ssh_execute_command`: Ejecuta cualquier comando shell de forma remota y captura la salida, el estado y los errores. +- `ssh_execute_script`: Sube y ejecuta un script completo de múltiples líneas en el sistema remoto. +- (Próximamente herramientas adicionales, como la transferencia de archivos). + +Al integrar SSH en los flujos de trabajo de tus agentes, puedes automatizar el acceso seguro, las operaciones remotas y la orquestación de servidores, agilizando DevOps, automatización de TI y gestión remota personalizada, todo desde Sim. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Ejecuta comandos, transfiere archivos y gestiona servidores remotos vía SSH. Compatible con autenticación por contraseña y clave privada para acceso seguro al servidor. + +## Herramientas + +### `ssh_execute_command` + +Ejecuta un comando shell en un servidor SSH remoto + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SSH | +| `port` | number | Sí | Puerto del servidor SSH \(predeterminado: 22\) | +| `username` | string | Sí | Nombre de usuario SSH | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | +| `command` | string | Sí | Comando shell para ejecutar en el servidor remoto | +| `workingDirectory` | string | No | Directorio de trabajo para la ejecución del comando | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `stdout` | string | Salida estándar del comando | +| `stderr` | string | Salida de error estándar | +| `exitCode` | number | Código de salida del comando | +| `success` | boolean | Si el comando tuvo éxito \(código de salida 0\) | +| `message` | string | Mensaje de estado de la operación | + +### `ssh_execute_script` + +Subir y ejecutar un script de múltiples líneas en un servidor SSH remoto + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SSH | +| `port` | number | Sí | Puerto del servidor SSH \(predeterminado: 22\) | +| `username` | string | Sí | Nombre de usuario SSH | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | +| `script` | string | Sí | Contenido del script a ejecutar \(bash, python, etc.\) | +| `interpreter` | string | No | Intérprete del script \(predeterminado: /bin/bash\) | +| `workingDirectory` | string | No | Directorio de trabajo para la ejecución del script | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `stdout` | string | Salida estándar del script | +| `stderr` | string | Salida de error estándar | +| `exitCode` | number | Código de salida del script | +| `success` | boolean | Si el script tuvo éxito \(código de salida 0\) | +| `scriptPath` | string | Ruta temporal donde se subió el script | +| `message` | string | Mensaje de estado de la operación | + +### `ssh_check_command_exists` + +Comprobar si un comando/programa existe en el servidor SSH remoto + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SSH | +| `port` | number | Sí | Puerto del servidor SSH \(predeterminado: 22\) | +| `username` | string | Sí | Nombre de usuario SSH | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | +| `commandName` | string | Sí | Nombre del comando a comprobar \(p. ej., docker, git, python3\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `commandExists` | boolean | Si el comando existe o no | +| `commandPath` | string | Ruta completa al comando \(si se encuentra\) | +| `version` | string | Salida de la versión del comando \(si es aplicable\) | +| `message` | string | Mensaje de estado de la operación | + +### `ssh_upload_file` + +Subir un archivo a un servidor SSH remoto + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SSH | +| `port` | number | Sí | Puerto del servidor SSH \(predeterminado: 22\) | +| `username` | string | Sí | Nombre de usuario SSH | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | +| `fileContent` | string | Sí | Contenido del archivo a subir \(codificado en base64 para archivos binarios\) | +| `fileName` | string | Sí | Nombre del archivo que se está subiendo | +| `remotePath` | string | Sí | Ruta de destino en el servidor remoto | +| `permissions` | string | No | Permisos del archivo \(p. ej., 0644\) | +| `overwrite` | boolean | No | Si se deben sobrescribir archivos existentes \(predeterminado: true\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `uploaded` | boolean | Indica si el archivo se subió correctamente | +| `remotePath` | string | Ruta final en el servidor remoto | +| `size` | number | Tamaño del archivo en bytes | +| `message` | string | Mensaje de estado de la operación | + +### `ssh_download_file` + +Descargar un archivo desde un servidor SSH remoto + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SSH | +| `port` | number | Sí | Puerto del servidor SSH \(predeterminado: 22\) | +| `username` | string | Sí | Nombre de usuario SSH | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | +| `remotePath` | string | Sí | Ruta del archivo en el servidor remoto | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `downloaded` | boolean | Indica si el archivo se descargó correctamente | +| `fileContent` | string | Contenido del archivo \(codificado en base64 para archivos binarios\) | +| `fileName` | string | Nombre del archivo descargado | +| `remotePath` | string | Ruta de origen en el servidor remoto | +| `size` | number | Tamaño del archivo en bytes | +| `message` | string | Mensaje de estado de la operación | + +### `ssh_list_directory` + +Listar archivos y directorios en un directorio remoto + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SSH | +| `port` | number | Sí | Puerto del servidor SSH \(predeterminado: 22\) | +| `username` | string | Sí | Nombre de usuario SSH | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | +| `path` | string | Sí | Ruta del directorio remoto a listar | +| `detailed` | boolean | No | Incluir detalles del archivo \(tamaño, permisos, fecha de modificación\) | +| `recursive` | boolean | No | Listar subdirectorios recursivamente \(predeterminado: false\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `entries` | array | Array de entradas de archivos y directorios | + +### `ssh_check_file_exists` + +Comprobar si un archivo o directorio existe en el servidor SSH remoto + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SSH | +| `port` | number | Sí | Puerto del servidor SSH \(predeterminado: 22\) | +| `username` | string | Sí | Nombre de usuario SSH | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | +| `path` | string | Sí | Ruta del archivo o directorio remoto a comprobar | +| `type` | string | No | Tipo esperado: archivo, directorio o cualquiera \(predeterminado: cualquiera\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `exists` | boolean | Si la ruta existe | +| `type` | string | Tipo de ruta (archivo, directorio, enlace simbólico, no_encontrado) | +| `size` | number | Tamaño del archivo si es un archivo | +| `permissions` | string | Permisos del archivo (p. ej., 0755) | +| `modified` | string | Marca de tiempo de última modificación | +| `message` | string | Mensaje de estado de la operación | + +### `ssh_create_directory` + +Crear un directorio en el servidor SSH remoto + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SSH | +| `port` | number | Sí | Puerto del servidor SSH (predeterminado: 22) | +| `username` | string | Sí | Nombre de usuario SSH | +| `password` | string | No | Contraseña para autenticación (si no se usa clave privada) | +| `privateKey` | string | No | Clave privada para autenticación (formato OpenSSH) | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | +| `path` | string | Sí | Ruta del directorio a crear | +| `recursive` | boolean | No | Crear directorios padre si no existen (predeterminado: true) | +| `permissions` | string | No | Permisos del directorio (predeterminado: 0755) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `created` | boolean | Si el directorio se creó correctamente | +| `remotePath` | string | Ruta del directorio creado | +| `alreadyExists` | boolean | Si el directorio ya existía | +| `message` | string | Mensaje de estado de la operación | + +### `ssh_delete_file` + +Eliminar un archivo o directorio del servidor SSH remoto + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SSH | +| `port` | number | Sí | Puerto del servidor SSH \(predeterminado: 22\) | +| `username` | string | Sí | Nombre de usuario SSH | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | +| `path` | string | Sí | Ruta a eliminar | +| `recursive` | boolean | No | Eliminar directorios recursivamente \(predeterminado: false\) | +| `force` | boolean | No | Forzar eliminación sin confirmación \(predeterminado: false\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `deleted` | boolean | Si la ruta se eliminó correctamente | +| `remotePath` | string | Ruta eliminada | +| `message` | string | Mensaje de estado de la operación | + +### `ssh_move_rename` + +Mover o renombrar un archivo o directorio en el servidor SSH remoto + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SSH | +| `port` | number | Sí | Puerto del servidor SSH \(predeterminado: 22\) | +| `username` | string | Sí | Nombre de usuario SSH | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | +| `sourcePath` | string | Sí | Ruta actual del archivo o directorio | +| `destinationPath` | string | Sí | Nueva ruta para el archivo o directorio | +| `overwrite` | boolean | No | Sobrescribir destino si existe \(predeterminado: false\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `moved` | boolean | Si la operación fue exitosa | +| `sourcePath` | string | Ruta original | +| `destinationPath` | string | Nueva ruta | +| `message` | string | Mensaje de estado de la operación | + +### `ssh_get_system_info` + +Obtener información del sistema desde el servidor SSH remoto + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SSH | +| `port` | number | Sí | Puerto del servidor SSH \(predeterminado: 22\) | +| `username` | string | Sí | Nombre de usuario SSH | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `hostname` | string | Nombre de host del servidor | +| `os` | string | Sistema operativo \(p. ej., Linux, Darwin\) | +| `architecture` | string | Arquitectura de CPU \(p. ej., x64, arm64\) | +| `uptime` | number | Tiempo de actividad del sistema en segundos | +| `memory` | json | Información de memoria \(total, libre, usada\) | +| `diskSpace` | json | Información de espacio en disco \(total, libre, usado\) | +| `message` | string | Mensaje de estado de la operación | + +### `ssh_read_file_content` + +Leer el contenido de un archivo remoto + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SSH | +| `port` | number | Sí | Puerto del servidor SSH \(predeterminado: 22\) | +| `username` | string | Sí | Nombre de usuario SSH | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | +| `path` | string | Sí | Ruta del archivo remoto a leer | +| `encoding` | string | No | Codificación del archivo \(predeterminado: utf-8\) | +| `maxSize` | number | No | Tamaño máximo de archivo a leer en MB \(predeterminado: 10\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `content` | string | Contenido del archivo como cadena de texto | +| `size` | number | Tamaño del archivo en bytes | +| `lines` | number | Número de líneas en el archivo | +| `remotePath` | string | Ruta del archivo remoto | +| `message` | string | Mensaje de estado de la operación | + +### `ssh_write_file_content` + +Escribir o añadir contenido a un archivo remoto + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SSH | +| `port` | number | Sí | Puerto del servidor SSH \(predeterminado: 22\) | +| `username` | string | Sí | Nombre de usuario SSH | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | +| `path` | string | Sí | Ruta del archivo remoto donde escribir | +| `content` | string | Sí | Contenido a escribir en el archivo | +| `mode` | string | No | Modo de escritura: sobrescribir, añadir o crear \(predeterminado: sobrescribir\) | +| `permissions` | string | No | Permisos del archivo \(p. ej., 0644\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `written` | boolean | Si el archivo se escribió correctamente | +| `remotePath` | string | Ruta del archivo | +| `size` | number | Tamaño final del archivo en bytes | +| `message` | string | Mensaje de estado de la operación | + +## Notas + +- Categoría: `tools` +- Tipo: `ssh` diff --git a/apps/docs/content/docs/es/tools/wordpress.mdx b/apps/docs/content/docs/es/tools/wordpress.mdx new file mode 100644 index 000000000..c75a6bfd7 --- /dev/null +++ b/apps/docs/content/docs/es/tools/wordpress.mdx @@ -0,0 +1,566 @@ +--- +title: WordPress +description: Gestionar contenido de WordPress +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[WordPress](https://wordpress.org/) es el sistema de gestión de contenido de código abierto líder en el mundo, que facilita la publicación y gestión de sitios web, blogs y todo tipo de contenido en línea. Con WordPress, puedes crear y actualizar entradas o páginas, organizar tu contenido con categorías y etiquetas, gestionar archivos multimedia, moderar comentarios y administrar cuentas de usuario, lo que te permite ejecutar desde blogs personales hasta sitios web empresariales complejos. + +La integración de Sim con WordPress permite a tus agentes automatizar tareas esenciales del sitio web. Puedes crear programáticamente nuevas entradas de blog con títulos específicos, contenido, categorías, etiquetas e imágenes destacadas. Actualizar entradas existentes —como cambiar su contenido, título o estado de publicación— es sencillo. También puedes publicar o guardar contenido como borradores, gestionar páginas estáticas, trabajar con cargas multimedia, supervisar comentarios y asignar contenido a taxonomías organizativas relevantes. + +Al conectar WordPress con tus automatizaciones, Sim permite a tus agentes agilizar la publicación de contenido, los flujos de trabajo editoriales y la gestión diaria del sitio, ayudándote a mantener tu sitio web actualizado, organizado y seguro sin esfuerzo manual. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Intégrate con WordPress para crear, actualizar y gestionar entradas, páginas, multimedia, comentarios, categorías, etiquetas y usuarios. Compatible con sitios de WordPress.com mediante OAuth y sitios de WordPress autoalojados utilizando autenticación de Contraseñas de Aplicación. + +## Herramientas + +### `wordpress_create_post` + +Crear una nueva entrada de blog en WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `title` | string | Sí | Título de la entrada | +| `content` | string | No | Contenido de la entrada \(HTML o texto plano\) | +| `status` | string | No | Estado de la entrada: publish, draft, pending, private o future | +| `excerpt` | string | No | Extracto de la entrada | +| `categories` | string | No | IDs de categorías separados por comas | +| `tags` | string | No | IDs de etiquetas separados por comas | +| `featuredMedia` | number | No | ID del medio de la imagen destacada | +| `slug` | string | No | Slug de URL para la entrada | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `post` | object | La entrada creada | + +### `wordpress_update_post` + +Actualizar una entrada de blog existente en WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `postId` | number | Sí | El ID de la entrada a actualizar | +| `title` | string | No | Título de la entrada | +| `content` | string | No | Contenido de la entrada \(HTML o texto plano\) | +| `status` | string | No | Estado de la entrada: publish, draft, pending, private, o future | +| `excerpt` | string | No | Extracto de la entrada | +| `categories` | string | No | IDs de categorías separados por comas | +| `tags` | string | No | IDs de etiquetas separados por comas | +| `featuredMedia` | number | No | ID del archivo multimedia de la imagen destacada | +| `slug` | string | No | URL slug para la entrada | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `post` | object | La entrada actualizada | + +### `wordpress_delete_post` + +Eliminar una entrada de blog de WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `postId` | number | Sí | El ID de la entrada a eliminar | +| `force` | boolean | No | Omitir la papelera y forzar la eliminación permanente | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `deleted` | boolean | Indica si la publicación fue eliminada | +| `post` | object | La publicación eliminada | + +### `wordpress_get_post` + +Obtener una sola publicación de blog de WordPress.com por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `postId` | number | Sí | El ID de la publicación a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `post` | object | La publicación recuperada | + +### `wordpress_list_posts` + +Listar publicaciones de blog de WordPress.com con filtros opcionales + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `perPage` | number | No | Número de publicaciones por página \(predeterminado: 10, máx: 100\) | +| `page` | number | No | Número de página para paginación | +| `status` | string | No | Filtro de estado de publicación: publish, draft, pending, private | +| `author` | number | No | Filtrar por ID de autor | +| `categories` | string | No | IDs de categorías separados por comas para filtrar | +| `tags` | string | No | IDs de etiquetas separados por comas para filtrar | +| `search` | string | No | Término de búsqueda para filtrar publicaciones | +| `orderBy` | string | No | Ordenar por campo: date, id, title, slug, modified | +| `order` | string | No | Dirección de ordenamiento: asc o desc | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `posts` | array | Lista de publicaciones | + +### `wordpress_create_page` + +Crear una nueva página en WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `title` | string | Sí | Título de la página | +| `content` | string | No | Contenido de la página \(HTML o texto plano\) | +| `status` | string | No | Estado de la página: publish, draft, pending, private | +| `excerpt` | string | No | Extracto de la página | +| `parent` | number | No | ID de la página padre para páginas jerárquicas | +| `menuOrder` | number | No | Orden en el menú de páginas | +| `featuredMedia` | number | No | ID del medio de la imagen destacada | +| `slug` | string | No | Slug de URL para la página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `page` | object | La página creada | + +### `wordpress_update_page` + +Actualizar una página existente en WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `pageId` | number | Sí | El ID de la página a actualizar | +| `title` | string | No | Título de la página | +| `content` | string | No | Contenido de la página \(HTML o texto plano\) | +| `status` | string | No | Estado de la página: publish, draft, pending, private | +| `excerpt` | string | No | Extracto de la página | +| `parent` | number | No | ID de la página padre para páginas jerárquicas | +| `menuOrder` | number | No | Orden en el menú de páginas | +| `featuredMedia` | number | No | ID del medio de la imagen destacada | +| `slug` | string | No | Slug de URL para la página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `page` | objeto | La página actualizada | + +### `wordpress_delete_page` + +Eliminar una página de WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | cadena | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `pageId` | número | Sí | El ID de la página a eliminar | +| `force` | booleano | No | Omitir la papelera y forzar la eliminación permanente | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `deleted` | booleano | Si la página fue eliminada | +| `page` | objeto | La página eliminada | + +### `wordpress_get_page` + +Obtener una sola página de WordPress.com por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | cadena | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `pageId` | número | Sí | El ID de la página a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `page` | objeto | La página recuperada | + +### `wordpress_list_pages` + +Listar páginas de WordPress.com con filtros opcionales + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | cadena | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `perPage` | número | No | Número de páginas por solicitud \(predeterminado: 10, máx: 100\) | +| `page` | número | No | Número de página para paginación | +| `status` | cadena | No | Filtro de estado de página: publish, draft, pending, private | +| `parent` | número | No | Filtrar por ID de página padre | +| `search` | cadena | No | Término de búsqueda para filtrar páginas | +| `orderBy` | cadena | No | Ordenar por campo: date, id, title, slug, modified, menu_order | +| `order` | cadena | No | Dirección de ordenamiento: asc o desc | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `pages` | array | Lista de páginas | + +### `wordpress_upload_media` + +Subir un archivo multimedia (imagen, video, documento) a WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `file` | string | Sí | Datos del archivo codificados en Base64 o URL para obtener el archivo | +| `filename` | string | Sí | Nombre del archivo con extensión \(p. ej., imagen.jpg\) | +| `title` | string | No | Título del archivo multimedia | +| `caption` | string | No | Leyenda del archivo multimedia | +| `altText` | string | No | Texto alternativo para accesibilidad | +| `description` | string | No | Descripción del archivo multimedia | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `media` | object | El elemento multimedia subido | + +### `wordpress_get_media` + +Obtener un solo elemento multimedia de WordPress.com por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `mediaId` | number | Sí | El ID del elemento multimedia a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `media` | object | El elemento multimedia recuperado | + +### `wordpress_list_media` + +Listar elementos multimedia de la biblioteca multimedia de WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `perPage` | number | No | Número de elementos multimedia por solicitud \(predeterminado: 10, máx: 100\) | +| `page` | number | No | Número de página para paginación | +| `search` | string | No | Término de búsqueda para filtrar multimedia | +| `mediaType` | string | No | Filtrar por tipo de multimedia: imagen, video, audio, aplicación | +| `mimeType` | string | No | Filtrar por tipo MIME específico \(p. ej., image/jpeg\) | +| `orderBy` | string | No | Ordenar por campo: fecha, id, título, slug | +| `order` | string | No | Dirección de ordenamiento: asc o desc | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `media` | array | Lista de elementos multimedia | + +### `wordpress_delete_media` + +Eliminar un elemento multimedia de WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `mediaId` | number | Sí | El ID del elemento multimedia a eliminar | +| `force` | boolean | No | Forzar eliminación \(los elementos multimedia no tienen papelera, por lo que la eliminación es permanente\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `deleted` | boolean | Si el medio fue eliminado | +| `media` | object | El elemento multimedia eliminado | + +### `wordpress_create_comment` + +Crear un nuevo comentario en una entrada de WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `postId` | number | Sí | El ID de la entrada en la que comentar | +| `content` | string | Sí | Contenido del comentario | +| `parent` | number | No | ID del comentario padre para respuestas | +| `authorName` | string | No | Nombre visible del autor del comentario | +| `authorEmail` | string | No | Correo electrónico del autor del comentario | +| `authorUrl` | string | No | URL del autor del comentario | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `comment` | object | El comentario creado | + +### `wordpress_list_comments` + +Listar comentarios de WordPress.com con filtros opcionales + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `perPage` | number | No | Número de comentarios por solicitud \(predeterminado: 10, máx: 100\) | +| `page` | number | No | Número de página para paginación | +| `postId` | number | No | Filtrar por ID de entrada | +| `status` | string | No | Filtrar por estado del comentario: approved, hold, spam, trash | +| `search` | string | No | Término de búsqueda para filtrar comentarios | +| `orderBy` | string | No | Ordenar por campo: date, id, parent | +| `order` | string | No | Dirección de ordenamiento: asc o desc | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `comments` | array | Lista de comentarios | + +### `wordpress_update_comment` + +Actualizar un comentario en WordPress.com (contenido o estado) + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `commentId` | number | Sí | El ID del comentario a actualizar | +| `content` | string | No | Contenido actualizado del comentario | +| `status` | string | No | Estado del comentario: approved, hold, spam, trash | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `comment` | object | El comentario actualizado | + +### `wordpress_delete_comment` + +Eliminar un comentario de WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `commentId` | number | Sí | El ID del comentario a eliminar | +| `force` | boolean | No | Omitir la papelera y forzar la eliminación permanente | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `deleted` | boolean | Si el comentario fue eliminado | +| `comment` | object | El comentario eliminado | + +### `wordpress_create_category` + +Crear una nueva categoría en WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com (p. ej., 12345678 o misitio.wordpress.com) | +| `name` | string | Sí | Nombre de la categoría | +| `description` | string | No | Descripción de la categoría | +| `parent` | number | No | ID de la categoría padre para categorías jerárquicas | +| `slug` | string | No | Slug de URL para la categoría | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `category` | object | La categoría creada | + +### `wordpress_list_categories` + +Listar categorías de WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com (p. ej., 12345678 o misitio.wordpress.com) | +| `perPage` | number | No | Número de categorías por solicitud (predeterminado: 10, máx: 100) | +| `page` | number | No | Número de página para paginación | +| `search` | string | No | Término de búsqueda para filtrar categorías | +| `order` | string | No | Dirección de ordenamiento: asc o desc | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `categories` | array | Lista de categorías | + +### `wordpress_create_tag` + +Crear una nueva etiqueta en WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com (p. ej., 12345678 o misitio.wordpress.com) | +| `name` | string | Sí | Nombre de la etiqueta | +| `description` | string | No | Descripción de la etiqueta | +| `slug` | string | No | Slug de URL para la etiqueta | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `tag` | object | La etiqueta creada | + +### `wordpress_list_tags` + +Listar etiquetas de WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `perPage` | number | No | Número de etiquetas por solicitud \(predeterminado: 10, máx: 100\) | +| `page` | number | No | Número de página para paginación | +| `search` | string | No | Término de búsqueda para filtrar etiquetas | +| `order` | string | No | Dirección de ordenamiento: asc o desc | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `tags` | array | Lista de etiquetas | + +### `wordpress_get_current_user` + +Obtener información sobre el usuario autenticado actualmente en WordPress.com + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `user` | object | El usuario actual | + +### `wordpress_list_users` + +Listar usuarios de WordPress.com (requiere privilegios de administrador) + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `perPage` | number | No | Número de usuarios por solicitud \(predeterminado: 10, máx: 100\) | +| `page` | number | No | Número de página para paginación | +| `search` | string | No | Término de búsqueda para filtrar usuarios | +| `roles` | string | No | Nombres de roles separados por comas para filtrar | +| `order` | string | No | Dirección de ordenamiento: asc o desc | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `users` | array | Lista de usuarios | + +### `wordpress_get_user` + +Obtener un usuario específico de WordPress.com por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `userId` | number | Sí | El ID del usuario a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `user` | object | El usuario recuperado | + +### `wordpress_search_content` + +Buscar en todos los tipos de contenido en WordPress.com (entradas, páginas, multimedia) + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Sí | ID del sitio o dominio de WordPress.com \(p. ej., 12345678 o misitio.wordpress.com\) | +| `query` | string | Sí | Consulta de búsqueda | +| `perPage` | number | No | Número de resultados por solicitud \(predeterminado: 10, máx: 100\) | +| `page` | number | No | Número de página para paginación | +| `type` | string | No | Filtrar por tipo de contenido: post, page, attachment | +| `subtype` | string | No | Filtrar por slug de tipo de entrada \(p. ej., post, page\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `results` | array | Resultados de búsqueda | + +## Notas + +- Categoría: `tools` +- Tipo: `wordpress` diff --git a/apps/docs/content/docs/es/tools/zendesk.mdx b/apps/docs/content/docs/es/tools/zendesk.mdx index 272f5ad66..6ef2829db 100644 --- a/apps/docs/content/docs/es/tools/zendesk.mdx +++ b/apps/docs/content/docs/es/tools/zendesk.mdx @@ -114,6 +114,9 @@ Crear un nuevo ticket en Zendesk con soporte para campos personalizados | `type` | string | No | Tipo \(problem, incident, question, task\) | | `tags` | string | No | Etiquetas separadas por comas | | `assigneeId` | string | No | ID de usuario asignado | +| `groupId` | string | No | ID del grupo | +| `requesterId` | string | No | ID de usuario solicitante | +| `customFields` | string | No | Campos personalizados como objeto JSON \(p. ej., \{"field_id": "value"\}\) | #### Salida diff --git a/apps/docs/content/docs/es/tools/zoom.mdx b/apps/docs/content/docs/es/tools/zoom.mdx new file mode 100644 index 000000000..13646da7e --- /dev/null +++ b/apps/docs/content/docs/es/tools/zoom.mdx @@ -0,0 +1,250 @@ +--- +title: Zoom +description: Crea y gestiona reuniones y grabaciones de Zoom +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Zoom](https://zoom.us/) es una plataforma líder de comunicaciones basada en la nube para videoconferencias, webinars y colaboración en línea. Permite a usuarios y organizaciones programar, organizar y gestionar reuniones fácilmente, proporcionando herramientas para compartir pantalla, chat, grabaciones y más. + +Con Zoom, puedes: + +- **Programar y gestionar reuniones**: Crear reuniones instantáneas o programadas, incluyendo eventos recurrentes +- **Configurar opciones de reunión**: Establecer contraseñas de reunión, habilitar salas de espera y controlar el video/audio de los participantes +- **Enviar invitaciones y compartir detalles**: Obtener invitaciones e información de reuniones para compartir fácilmente +- **Obtener y actualizar datos de reuniones**: Acceder a detalles de reuniones, modificar reuniones existentes y gestionar configuraciones de forma programática + +En Sim, la integración con Zoom permite a tus agentes automatizar la programación y gestión de reuniones. Usa acciones de herramientas para: + +- Crear programáticamente nuevas reuniones con configuraciones personalizadas +- Listar todas las reuniones para un usuario específico (o para ti mismo) +- Obtener detalles o invitaciones para cualquier reunión +- Actualizar o eliminar reuniones existentes directamente desde tus automatizaciones + +Estas capacidades te permiten agilizar la colaboración remota, automatizar sesiones de video recurrentes y gestionar el entorno Zoom de tu organización como parte de tus flujos de trabajo. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra Zoom en flujos de trabajo. Crea, lista, actualiza y elimina reuniones de Zoom. Obtén detalles de reuniones, invitaciones, grabaciones y participantes. Gestiona grabaciones en la nube de forma programática. + +## Herramientas + +### `zoom_create_meeting` + +Crear una nueva reunión de Zoom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `userId` | string | Sí | El ID de usuario o dirección de correo electrónico. Usa "me" para el usuario autenticado. | +| `topic` | string | Sí | Tema de la reunión | +| `type` | number | No | Tipo de reunión: 1=instantánea, 2=programada, 3=recurrente sin hora fija, 8=recurrente con hora fija | +| `startTime` | string | No | Hora de inicio de la reunión en formato ISO 8601 \(p. ej., 2025-06-03T10:00:00Z\) | +| `duration` | number | No | Duración de la reunión en minutos | +| `timezone` | string | No | Zona horaria para la reunión \(p. ej., America/Los_Angeles\) | +| `password` | string | No | Contraseña de la reunión | +| `agenda` | string | No | Agenda de la reunión | +| `hostVideo` | boolean | No | Iniciar con video del anfitrión activado | +| `participantVideo` | boolean | No | Iniciar con video de participantes activado | +| `joinBeforeHost` | boolean | No | Permitir que los participantes se unan antes que el anfitrión | +| `muteUponEntry` | boolean | No | Silenciar participantes al entrar | +| `waitingRoom` | boolean | No | Habilitar sala de espera | +| `autoRecording` | string | No | Configuración de grabación automática: local, cloud o none | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `meeting` | object | La reunión creada con todas sus propiedades | + +### `zoom_list_meetings` + +Listar todas las reuniones para un usuario de Zoom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `userId` | string | Sí | El ID de usuario o dirección de correo electrónico. Use "me" para el usuario autenticado. | +| `type` | string | No | Filtro de tipo de reunión: scheduled, live, upcoming, upcoming_meetings, o previous_meetings | +| `pageSize` | number | No | Número de registros por página \(máximo 300\) | +| `nextPageToken` | string | No | Token para paginación para obtener la siguiente página de resultados | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `meetings` | array | Lista de reuniones | +| `pageInfo` | object | Información de paginación | + +### `zoom_get_meeting` + +Obtener detalles de una reunión específica de Zoom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Sí | El ID de la reunión | +| `occurrenceId` | string | No | ID de ocurrencia para reuniones recurrentes | +| `showPreviousOccurrences` | boolean | No | Mostrar ocurrencias anteriores para reuniones recurrentes | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `meeting` | object | Los detalles de la reunión | + +### `zoom_update_meeting` + +Actualizar una reunión existente de Zoom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Sí | El ID de la reunión a actualizar | +| `topic` | string | No | Tema de la reunión | +| `type` | number | No | Tipo de reunión: 1=instantánea, 2=programada, 3=recurrente sin hora fija, 8=recurrente con hora fija | +| `startTime` | string | No | Hora de inicio de la reunión en formato ISO 8601 \(p. ej., 2025-06-03T10:00:00Z\) | +| `duration` | number | No | Duración de la reunión en minutos | +| `timezone` | string | No | Zona horaria para la reunión \(p. ej., America/Los_Angeles\) | +| `password` | string | No | Contraseña de la reunión | +| `agenda` | string | No | Agenda de la reunión | +| `hostVideo` | boolean | No | Iniciar con video del anfitrión activado | +| `participantVideo` | boolean | No | Iniciar con video de participantes activado | +| `joinBeforeHost` | boolean | No | Permitir que los participantes se unan antes que el anfitrión | +| `muteUponEntry` | boolean | No | Silenciar a los participantes al entrar | +| `waitingRoom` | boolean | No | Habilitar sala de espera | +| `autoRecording` | string | No | Configuración de grabación automática: local, en la nube o ninguna | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Si la reunión se actualizó correctamente | + +### `zoom_delete_meeting` + +Eliminar o cancelar una reunión de Zoom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Sí | El ID de la reunión a eliminar | +| `occurrenceId` | string | No | ID de ocurrencia para eliminar una ocurrencia específica de una reunión recurrente | +| `scheduleForReminder` | boolean | No | Enviar correo electrónico de recordatorio de cancelación a los inscritos | +| `cancelMeetingReminder` | boolean | No | Enviar correo electrónico de cancelación a los inscritos y anfitriones alternativos | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Indica si la reunión se eliminó correctamente | + +### `zoom_get_meeting_invitation` + +Obtener el texto de invitación para una reunión de Zoom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Sí | El ID de la reunión | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `invitation` | string | El texto de invitación de la reunión | + +### `zoom_list_recordings` + +Listar todas las grabaciones en la nube para un usuario de Zoom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `userId` | string | Sí | El ID de usuario o dirección de correo electrónico. Use "me" para el usuario autenticado. | +| `from` | string | No | Fecha de inicio en formato aaaa-mm-dd \(dentro de los últimos 6 meses\) | +| `to` | string | No | Fecha de fin en formato aaaa-mm-dd | +| `pageSize` | number | No | Número de registros por página \(máximo 300\) | +| `nextPageToken` | string | No | Token para paginación para obtener la siguiente página de resultados | +| `trash` | boolean | No | Establecer como true para listar grabaciones de la papelera | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `recordings` | array | Lista de grabaciones | +| `pageInfo` | object | Información de paginación | + +### `zoom_get_meeting_recordings` + +Obtener todas las grabaciones de una reunión específica de Zoom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Sí | El ID de la reunión o UUID de la reunión | +| `includeFolderItems` | boolean | No | Incluir elementos dentro de una carpeta | +| `ttl` | number | No | Tiempo de vida para las URLs de descarga en segundos \(máx. 604800\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `recording` | object | La grabación de la reunión con todos los archivos | + +### `zoom_delete_recording` + +Eliminar grabaciones en la nube de una reunión de Zoom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Sí | El ID de la reunión o UUID de la reunión | +| `recordingId` | string | No | ID específico del archivo de grabación a eliminar. Si no se proporciona, elimina todas las grabaciones. | +| `action` | string | No | Acción de eliminación: "trash" \(mover a la papelera\) o "delete" \(eliminar permanentemente\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Si la grabación se eliminó correctamente | + +### `zoom_list_past_participants` + +Listar participantes de una reunión pasada de Zoom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Sí | El ID o UUID de la reunión pasada | +| `pageSize` | number | No | Número de registros por página \(máx. 300\) | +| `nextPageToken` | string | No | Token para paginación para obtener la siguiente página de resultados | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `participants` | array | Lista de participantes de la reunión | +| `pageInfo` | object | Información de paginación | + +## Notas + +- Categoría: `tools` +- Tipo: `zoom` diff --git a/apps/docs/content/docs/fr/tools/ahrefs.mdx b/apps/docs/content/docs/fr/tools/ahrefs.mdx new file mode 100644 index 000000000..ab09c3a10 --- /dev/null +++ b/apps/docs/content/docs/fr/tools/ahrefs.mdx @@ -0,0 +1,199 @@ +--- +title: Ahrefs +description: Analyse SEO avec Ahrefs +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Ahrefs](https://ahrefs.com/) est un ensemble d'outils SEO de premier plan pour analyser les sites web, suivre les classements, surveiller les backlinks et rechercher des mots-clés. Il fournit des informations détaillées sur votre propre site web ainsi que sur ceux de vos concurrents, vous aidant à prendre des décisions basées sur les données pour améliorer votre visibilité dans les moteurs de recherche. + +Avec l'intégration d'Ahrefs dans Sim, vous pouvez : + +- **Analyser le Domain Rating et l'autorité** : vérifier instantanément le Domain Rating (DR) et le rang Ahrefs de n'importe quel site web pour évaluer son autorité. +- **Récupérer les backlinks** : obtenir une liste des backlinks pointant vers un site ou une URL spécifique, avec des détails comme le texte d'ancrage, le DR de la page référente, et plus encore. +- **Obtenir des statistiques sur les backlinks** : accéder aux métriques sur les types de backlinks (dofollow, nofollow, texte, image, redirection, etc.) pour un domaine ou une URL. +- **Explorer les mots-clés organiques** *(prévu)* : voir les mots-clés pour lesquels un domaine est classé et leurs positions dans les résultats de recherche Google. +- **Découvrir les meilleures pages** *(prévu)* : identifier les pages les plus performantes par trafic organique et liens. + +Ces outils permettent à vos agents d'automatiser la recherche SEO, de surveiller les concurrents et de générer des rapports, le tout dans le cadre de vos automatisations de flux de travail. Pour utiliser l'intégration Ahrefs, vous aurez besoin d'un abonnement Ahrefs Enterprise avec accès API. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez les outils SEO d'Ahrefs dans votre flux de travail. Analysez les évaluations de domaine, les backlinks, les mots-clés organiques, les meilleures pages et plus encore. Nécessite un plan Ahrefs Enterprise avec accès API. + +## Outils + +### `ahrefs_domain_rating` + +Obtenez le Domain Rating (DR) et le rang Ahrefs pour un domaine cible. Le Domain Rating montre la force d'un site web + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `target` | chaîne | Oui | Le domaine cible à analyser \(par ex., example.com\) | +| `date` | chaîne | Non | Date pour les données historiques au format AAAA-MM-JJ \(par défaut : aujourd'hui\) | +| `apiKey` | chaîne | Oui | Clé API Ahrefs | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `domainRating` | nombre | Score de Domain Rating \(0-100\) | +| `ahrefsRank` | nombre | Ahrefs Rank - classement mondial basé sur la force du profil de backlinks | + +### `ahrefs_backlinks` + +Obtenir une liste de backlinks pointant vers un domaine ou une URL cible. Renvoie des détails sur chaque backlink, y compris l'URL source, le texte d'ancrage et le domain rating. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `target` | chaîne | Oui | Le domaine ou l'URL cible à analyser | +| `mode` | chaîne | Non | Mode d'analyse : domain \(domaine entier\), prefix \(préfixe d'URL\), subdomains \(inclure tous les sous-domaines\), exact \(correspondance exacte d'URL\) | +| `date` | chaîne | Non | Date pour les données historiques au format AAAA-MM-JJ \(par défaut : aujourd'hui\) | +| `limit` | nombre | Non | Nombre maximum de résultats à renvoyer \(par défaut : 100\) | +| `offset` | nombre | Non | Nombre de résultats à ignorer pour la pagination | +| `apiKey` | chaîne | Oui | Clé API Ahrefs | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `backlinks` | array | Liste des backlinks pointant vers la cible | + +### `ahrefs_backlinks_stats` + +Obtenez des statistiques de backlinks pour un domaine ou une URL cible. Renvoie les totaux pour différents types de backlinks, y compris les liens dofollow, nofollow, texte, image et de redirection. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `target` | string | Oui | Le domaine ou l'URL cible à analyser | +| `mode` | string | Non | Mode d'analyse : domain \(domaine entier\), prefix \(préfixe d'URL\), subdomains \(inclure tous les sous-domaines\), exact \(correspondance exacte d'URL\) | +| `date` | string | Non | Date pour les données historiques au format AAAA-MM-JJ \(par défaut : aujourd'hui\) | +| `apiKey` | string | Oui | Clé API Ahrefs | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `stats` | object | Résumé des statistiques de backlinks | + +### `ahrefs_referring_domains` + +Obtenez une liste des domaines qui renvoient vers un domaine ou une URL cible. Renvoie des domaines référents uniques avec leur notation de domaine, le nombre de backlinks et les dates de découverte. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `target` | string | Oui | Le domaine ou l'URL cible à analyser | +| `mode` | string | Non | Mode d'analyse : domain \(domaine entier\), prefix \(préfixe d'URL\), subdomains \(inclure tous les sous-domaines\), exact \(correspondance exacte d'URL\) | +| `date` | string | Non | Date pour les données historiques au format AAAA-MM-JJ \(par défaut : aujourd'hui\) | +| `limit` | number | Non | Nombre maximum de résultats à renvoyer \(par défaut : 100\) | +| `offset` | number | Non | Nombre de résultats à ignorer pour la pagination | +| `apiKey` | string | Oui | Clé API Ahrefs | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `referringDomains` | array | Liste des domaines pointant vers la cible | + +### `ahrefs_organic_keywords` + +Obtenez les mots-clés organiques pour lesquels un domaine ou une URL cible est classé dans les résultats de recherche Google. Renvoie les détails des mots-clés, y compris le volume de recherche, la position de classement et le trafic estimé. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `target` | string | Oui | Le domaine ou l'URL cible à analyser | +| `country` | string | Non | Code pays pour les résultats de recherche \(ex. : us, gb, de\). Par défaut : us | +| `mode` | string | Non | Mode d'analyse : domain \(domaine entier\), prefix \(préfixe d'URL\), subdomains \(inclure tous les sous-domaines\), exact \(correspondance exacte d'URL\) | +| `date` | string | Non | Date pour les données historiques au format AAAA-MM-JJ \(par défaut : aujourd'hui\) | +| `limit` | number | Non | Nombre maximum de résultats à renvoyer \(par défaut : 100\) | +| `offset` | number | Non | Nombre de résultats à ignorer pour la pagination | +| `apiKey` | string | Oui | Clé API Ahrefs | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `keywords` | array | Liste des mots-clés organiques pour lesquels la cible est classée | + +### `ahrefs_top_pages` + +Obtenez les meilleures pages d'un domaine cible triées par trafic organique. Renvoie les URL des pages avec leur trafic, le nombre de mots-clés et la valeur estimée du trafic. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `target` | string | Oui | Le domaine cible à analyser | +| `country` | string | Non | Code pays pour les données de trafic \(ex., us, gb, de\). Par défaut : us | +| `mode` | string | Non | Mode d'analyse : domain \(domaine entier\), prefix \(préfixe d'URL\), subdomains \(inclure tous les sous-domaines\) | +| `date` | string | Non | Date pour les données historiques au format AAAA-MM-JJ \(par défaut : aujourd'hui\) | +| `limit` | number | Non | Nombre maximum de résultats à retourner \(par défaut : 100\) | +| `offset` | number | Non | Nombre de résultats à ignorer pour la pagination | +| `apiKey` | string | Oui | Clé API Ahrefs | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `pages` | array | Liste des meilleures pages par trafic organique | + +### `ahrefs_keyword_overview` + +Obtenez des métriques détaillées pour un mot-clé, y compris le volume de recherche, la difficulté du mot-clé, le CPC, les clics et le potentiel de trafic. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `keyword` | string | Oui | Le mot-clé à analyser | +| `country` | string | Non | Code pays pour les données de mot-clé \(ex., us, gb, de\). Par défaut : us | +| `apiKey` | string | Oui | Clé API Ahrefs | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `overview` | object | Aperçu des métriques du mot-clé | + +### `ahrefs_broken_backlinks` + +Obtenez une liste de backlinks brisés pointant vers un domaine ou une URL cible. Utile pour identifier les opportunités de récupération de liens. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `target` | chaîne | Oui | Le domaine ou l'URL cible à analyser | +| `mode` | chaîne | Non | Mode d'analyse : domain \(domaine entier\), prefix \(préfixe d'URL\), subdomains \(inclure tous les sous-domaines\), exact \(correspondance exacte d'URL\) | +| `date` | chaîne | Non | Date pour les données historiques au format AAAA-MM-JJ \(par défaut : aujourd'hui\) | +| `limit` | nombre | Non | Nombre maximum de résultats à retourner \(par défaut : 100\) | +| `offset` | nombre | Non | Nombre de résultats à ignorer pour la pagination | +| `apiKey` | chaîne | Oui | Clé API Ahrefs | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `brokenBacklinks` | tableau | Liste des backlinks brisés | + +## Remarques + +- Catégorie : `tools` +- Type : `ahrefs` diff --git a/apps/docs/content/docs/fr/tools/datadog.mdx b/apps/docs/content/docs/fr/tools/datadog.mdx new file mode 100644 index 000000000..47cf30125 --- /dev/null +++ b/apps/docs/content/docs/fr/tools/datadog.mdx @@ -0,0 +1,302 @@ +--- +title: Datadog +description: Surveillez l'infrastructure, les applications et les journaux avec Datadog +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Datadog](https://datadoghq.com/) est une plateforme complète de surveillance et d'analyse pour l'infrastructure, les applications, les journaux et plus encore. Elle permet aux organisations d'obtenir une visibilité en temps réel sur la santé et les performances des systèmes, de détecter les anomalies et d'automatiser la réponse aux incidents. + +Avec Datadog, vous pouvez : + +- **Surveiller les métriques** : collecter, visualiser et analyser les métriques des serveurs, des services cloud et des applications personnalisées. +- **Interroger les données chronologiques** : exécuter des requêtes avancées sur les métriques de performance pour l'analyse des tendances et les rapports. +- **Gérer les moniteurs et les événements** : configurer des moniteurs pour détecter les problèmes, déclencher des alertes et créer des événements pour l'observabilité. +- **Gérer les temps d'arrêt** : planifier et gérer de manière programmatique les temps d'arrêt planifiés pour supprimer les alertes pendant la maintenance. +- **Analyser les journaux et les traces** *(avec une configuration supplémentaire dans Datadog)* : centraliser et inspecter les journaux ou les traces distribuées pour un dépannage plus approfondi. + +L'intégration Datadog de Sim permet à vos agents d'automatiser ces opérations et d'interagir avec votre compte Datadog de manière programmatique. Utilisez-la pour soumettre des métriques personnalisées, interroger des données chronologiques, gérer des moniteurs, créer des événements et rationaliser vos flux de travail de surveillance directement dans les automatisations Sim. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez la surveillance Datadog dans les flux de travail. Soumettez des métriques, gérez des moniteurs, interrogez des journaux, créez des événements, gérez des temps d'arrêt et plus encore. + +## Outils + +### `datadog_submit_metrics` + +Soumettez des métriques personnalisées à Datadog. Utilisez-les pour suivre les performances des applications, les métriques commerciales ou les données de surveillance personnalisées. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `series` | string | Oui | Tableau JSON des séries de métriques à soumettre. Chaque série doit inclure le nom de la métrique, le type \(gauge/rate/count\), les points \(paires timestamp/valeur\) et des tags optionnels. | +| `apiKey` | string | Oui | Clé API Datadog | +| `site` | string | Non | Site/région Datadog \(par défaut : datadoghq.com\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Indique si les métriques ont été soumises avec succès | +| `errors` | array | Toutes les erreurs survenues pendant la soumission | + +### `datadog_query_timeseries` + +Interroge les données de séries temporelles de métriques depuis Datadog. Utilisez-le pour analyser les tendances, créer des rapports ou récupérer des valeurs de métriques. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `query` | string | Oui | Requête de métriques Datadog (par exemple, "avg:system.cpu.user\{*\}") | +| `from` | number | Oui | Heure de début sous forme d'horodatage Unix en secondes | +| `to` | number | Oui | Heure de fin sous forme d'horodatage Unix en secondes | +| `apiKey` | string | Oui | Clé API Datadog | +| `applicationKey` | string | Oui | Clé d'application Datadog | +| `site` | string | Non | Site/région Datadog (par défaut : datadoghq.com) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `series` | array | Tableau de données de séries temporelles avec nom de métrique, tags et points de données | +| `status` | string | Statut de la requête | + +### `datadog_create_event` + +Publie un événement dans le flux d'événements Datadog. Utilisez-le pour les notifications de déploiement, les alertes ou tout autre événement significatif. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `title` | string | Oui | Titre de l'événement | +| `text` | string | Oui | Corps/description de l'événement. Prend en charge le markdown. | +| `alertType` | string | Non | Type d'alerte : error, warning, info, success, user_update, recommendation ou snapshot | +| `priority` | string | Non | Priorité de l'événement : normal ou low | +| `host` | string | Non | Nom d'hôte à associer à cet événement | +| `tags` | string | Non | Liste de tags séparés par des virgules (par exemple, "env:production,service:api") | +| `aggregationKey` | string | Non | Clé pour regrouper les événements ensemble | +| `sourceTypeName` | string | Non | Nom du type de source pour l'événement | +| `dateHappened` | number | Non | Horodatage Unix indiquant quand l'événement s'est produit (par défaut : maintenant) | +| `apiKey` | string | Oui | Clé API Datadog | +| `site` | string | Non | Site/région Datadog (par défaut : datadoghq.com) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `event` | objet | Les détails de l'événement créé | + +### `datadog_create_monitor` + +Créer un nouveau moniteur/alerte dans Datadog. Les moniteurs peuvent suivre des métriques, des vérifications de service, des événements et plus encore. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `name` | chaîne | Oui | Nom du moniteur | +| `type` | chaîne | Oui | Type de moniteur : alerte métrique, vérification de service, alerte d'événement, alerte de processus, alerte de journal, alerte de requête, composite, alerte de synthèse, alerte SLO | +| `query` | chaîne | Oui | Requête du moniteur \(ex., "avg\(last_5m\):avg:system.cpu.idle\{*\} < 20"\) | +| `message` | chaîne | Non | Message à inclure avec les notifications. Peut inclure des @-mentions et du markdown. | +| `tags` | chaîne | Non | Liste de tags séparés par des virgules | +| `priority` | nombre | Non | Priorité du moniteur \(1-5, où 1 est la plus haute\) | +| `options` | chaîne | Non | Chaîne JSON des options du moniteur \(seuils, notify_no_data, renotify_interval, etc.\) | +| `apiKey` | chaîne | Oui | Clé API Datadog | +| `applicationKey` | chaîne | Oui | Clé d'application Datadog | +| `site` | chaîne | Non | Site/région Datadog \(par défaut : datadoghq.com\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `monitor` | objet | Les détails du moniteur créé | + +### `datadog_get_monitor` + +Récupérer les détails d'un moniteur spécifique par ID. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `monitorId` | chaîne | Oui | L'ID du moniteur à récupérer | +| `groupStates` | chaîne | Non | États de groupe séparés par des virgules à inclure : alert, warn, no data, ok | +| `withDowntimes` | booléen | Non | Inclure les données de temps d'arrêt avec le moniteur | +| `apiKey` | chaîne | Oui | Clé API Datadog | +| `applicationKey` | chaîne | Oui | Clé d'application Datadog | +| `site` | chaîne | Non | Site/région Datadog \(par défaut : datadoghq.com\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `monitor` | objet | Les détails du moniteur | + +### `datadog_list_monitors` + +Liste tous les moniteurs dans Datadog avec filtrage optionnel par nom, tags ou état. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `groupStates` | chaîne | Non | États de groupe séparés par des virgules pour filtrer : alert, warn, no data, ok | +| `name` | chaîne | Non | Filtrer les moniteurs par nom \(correspondance partielle\) | +| `tags` | chaîne | Non | Liste de tags séparés par des virgules pour filtrer | +| `monitorTags` | chaîne | Non | Liste de tags de moniteur séparés par des virgules pour filtrer | +| `withDowntimes` | booléen | Non | Inclure les données de temps d'arrêt avec les moniteurs | +| `page` | nombre | Non | Numéro de page pour la pagination \(indexé à partir de 0\) | +| `pageSize` | nombre | Non | Nombre de moniteurs par page \(max 1000\) | +| `apiKey` | chaîne | Oui | Clé API Datadog | +| `applicationKey` | chaîne | Oui | Clé d'application Datadog | +| `site` | chaîne | Non | Site/région Datadog \(par défaut : datadoghq.com\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `monitors` | tableau | Liste des moniteurs | + +### `datadog_mute_monitor` + +Mettre en sourdine un moniteur pour supprimer temporairement les notifications. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `monitorId` | chaîne | Oui | L'ID du moniteur à mettre en sourdine | +| `scope` | chaîne | Non | Portée à mettre en sourdine \(par ex., "host:myhost"\). Si non spécifié, met en sourdine toutes les portées. | +| `end` | nombre | Non | Horodatage Unix indiquant quand la mise en sourdine doit se terminer. Si non spécifié, met en sourdine indéfiniment. | +| `apiKey` | chaîne | Oui | Clé API Datadog | +| `applicationKey` | chaîne | Oui | Clé d'application Datadog | +| `site` | chaîne | Non | Site/région Datadog \(par défaut : datadoghq.com\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Indique si le moniteur a été mis en sourdine avec succès | + +### `datadog_query_logs` + +Recherchez et récupérez des logs depuis Datadog. Utilisez-les pour le dépannage, l'analyse ou la surveillance. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `query` | string | Oui | Requête de recherche de logs \(ex., "service:web-app status:error"\) | +| `from` | string | Oui | Heure de début au format ISO-8601 ou relatif \(ex., "now-1h"\) | +| `to` | string | Oui | Heure de fin au format ISO-8601 ou relatif \(ex., "now"\) | +| `limit` | number | Non | Nombre maximum de logs à retourner \(par défaut : 50, max : 1000\) | +| `sort` | string | Non | Ordre de tri : timestamp \(plus ancien d'abord\) ou -timestamp \(plus récent d'abord\) | +| `indexes` | string | Non | Liste d'index de logs à rechercher, séparés par des virgules | +| `apiKey` | string | Oui | Clé API Datadog | +| `applicationKey` | string | Oui | Clé d'application Datadog | +| `site` | string | Non | Site/région Datadog \(par défaut : datadoghq.com\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `logs` | array | Liste des entrées de logs | + +### `datadog_send_logs` + +Envoyez des entrées de logs à Datadog pour une journalisation et une analyse centralisées. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `logs` | string | Oui | Tableau JSON d'entrées de logs. Chaque entrée doit avoir un message et éventuellement ddsource, ddtags, hostname, service. | +| `apiKey` | string | Oui | Clé API Datadog | +| `site` | string | Non | Site/région Datadog \(par défaut : datadoghq.com\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Indique si les journaux ont été envoyés avec succès | + +### `datadog_create_downtime` + +Planifiez une période d'arrêt pour supprimer les notifications de surveillance pendant les fenêtres de maintenance. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `scope` | string | Oui | Portée à laquelle appliquer la période d'arrêt (par ex., "host:myhost", "env:production", ou "*" pour tous) | +| `message` | string | Non | Message à afficher pendant la période d'arrêt | +| `start` | number | Non | Horodatage Unix pour le début de la période d'arrêt (par défaut : maintenant) | +| `end` | number | Non | Horodatage Unix pour la fin de la période d'arrêt | +| `timezone` | string | Non | Fuseau horaire pour la période d'arrêt (par ex., "America/New_York") | +| `monitorId` | string | Non | ID de surveillance spécifique à mettre en sourdine | +| `monitorTags` | string | Non | Tags de surveillance séparés par des virgules à faire correspondre (par ex., "team:backend,priority:high") | +| `muteFirstRecoveryNotification` | boolean | Non | Mettre en sourdine la première notification de récupération | +| `apiKey` | string | Oui | Clé API Datadog | +| `applicationKey` | string | Oui | Clé d'application Datadog | +| `site` | string | Non | Site/région Datadog (par défaut : datadoghq.com) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `downtime` | object | Les détails de la période d'arrêt créée | + +### `datadog_list_downtimes` + +Listez toutes les périodes d'arrêt planifiées dans Datadog. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `currentOnly` | boolean | Non | Renvoyer uniquement les périodes d'arrêt actuellement actives | +| `monitorId` | string | Non | Filtrer par ID de surveillance | +| `apiKey` | string | Oui | Clé API Datadog | +| `applicationKey` | string | Oui | Clé d'application Datadog | +| `site` | string | Non | Site/région Datadog (par défaut : datadoghq.com) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `downtimes` | array | Liste des temps d'arrêt | + +### `datadog_cancel_downtime` + +Annuler un temps d'arrêt programmé. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `downtimeId` | string | Oui | L'ID du temps d'arrêt à annuler | +| `apiKey` | string | Oui | Clé API Datadog | +| `applicationKey` | string | Oui | Clé d'application Datadog | +| `site` | string | Non | Site/région Datadog \(par défaut : datadoghq.com\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Indique si le temps d'arrêt a été annulé avec succès | + +## Remarques + +- Catégorie : `tools` +- Type : `datadog` diff --git a/apps/docs/content/docs/fr/tools/dropbox.mdx b/apps/docs/content/docs/fr/tools/dropbox.mdx new file mode 100644 index 000000000..186f4dd06 --- /dev/null +++ b/apps/docs/content/docs/fr/tools/dropbox.mdx @@ -0,0 +1,219 @@ +--- +title: Dropbox +description: Téléchargez, téléchargez, partagez et gérez des fichiers dans Dropbox +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Dropbox](https://dropbox.com/) est une plateforme populaire de stockage cloud et de collaboration qui permet aux individus et aux équipes de stocker, d'accéder et de partager des fichiers en toute sécurité depuis n'importe où. Dropbox est conçu pour une gestion de fichiers facile, la synchronisation et une collaboration puissante, que vous travailliez seul ou en groupe. + +Avec Dropbox dans Sim, vous pouvez : + +- **Télécharger et télécharger des fichiers** : téléchargez facilement n'importe quel fichier vers votre Dropbox ou récupérez du contenu à la demande +- **Lister le contenu des dossiers** : parcourez les fichiers et dossiers dans n'importe quel répertoire Dropbox +- **Créer de nouveaux dossiers** : organisez vos fichiers en créant programmatiquement de nouveaux dossiers dans votre Dropbox +- **Rechercher des fichiers et dossiers** : localisez des documents, des images ou d'autres éléments par nom ou contenu +- **Générer des liens partagés** : créez rapidement des liens publics ou privés partageables pour des fichiers et dossiers +- **Gérer des fichiers** : déplacez, supprimez ou renommez des fichiers et dossiers dans le cadre de flux de travail automatisés + +Ces capacités permettent à vos agents Sim d'automatiser les opérations Dropbox directement dans vos flux de travail — de la sauvegarde de fichiers importants à la distribution de contenu et à la maintenance de dossiers organisés. Utilisez Dropbox comme source et destination pour les fichiers, permettant une gestion transparente du stockage cloud dans le cadre de vos processus d'entreprise. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez Dropbox dans votre flux de travail pour la gestion de fichiers, le partage et la collaboration. Téléchargez des fichiers, téléchargez du contenu, créez des dossiers, gérez des liens partagés, et plus encore. + +## Outils + +### `dropbox_upload` + +Télécharger un fichier vers Dropbox + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `path` | string | Oui | Le chemin dans Dropbox où le fichier doit être enregistré \(ex. : /dossier/document.pdf\) | +| `fileContent` | string | Oui | Le contenu encodé en base64 du fichier à télécharger | +| `fileName` | string | Non | Nom de fichier optionnel \(utilisé si le chemin est un dossier\) | +| `mode` | string | Non | Mode d'écriture : add \(par défaut\) ou overwrite | +| `autorename` | boolean | Non | Si vrai, renomme le fichier en cas de conflit | +| `mute` | boolean | Non | Si vrai, ne notifie pas l'utilisateur de ce téléchargement | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `file` | objet | Les métadonnées du fichier téléversé | + +### `dropbox_download` + +Télécharger un fichier depuis Dropbox et obtenir un lien temporaire + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `path` | chaîne | Oui | Le chemin du fichier à télécharger \(ex. : /dossier/document.pdf\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `file` | objet | Les métadonnées du fichier | + +### `dropbox_list_folder` + +Lister le contenu d'un dossier dans Dropbox + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `path` | chaîne | Oui | Le chemin du dossier à lister \(utilisez "" pour la racine\) | +| `recursive` | booléen | Non | Si vrai, liste le contenu de façon récursive | +| `includeDeleted` | booléen | Non | Si vrai, inclut les fichiers/dossiers supprimés | +| `includeMediaInfo` | booléen | Non | Si vrai, inclut les informations média pour les photos/vidéos | +| `limit` | nombre | Non | Nombre maximum de résultats à retourner \(par défaut : 500\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `entries` | tableau | Liste des fichiers et dossiers dans le répertoire | + +### `dropbox_create_folder` + +Créer un nouveau dossier dans Dropbox + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `path` | chaîne | Oui | Le chemin où le dossier doit être créé \(ex. : /nouveau-dossier\) | +| `autorename` | booléen | Non | Si vrai, renomme le dossier s'il y a un conflit | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `folder` | objet | Les métadonnées du dossier créé | + +### `dropbox_delete` + +Supprimer un fichier ou un dossier dans Dropbox (déplace vers la corbeille) + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `path` | chaîne | Oui | Le chemin du fichier ou du dossier à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `metadata` | objet | Métadonnées de l'élément supprimé | + +### `dropbox_copy` + +Copier un fichier ou un dossier dans Dropbox + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `fromPath` | chaîne | Oui | Le chemin source du fichier ou du dossier à copier | +| `toPath` | chaîne | Oui | Le chemin de destination pour le fichier ou dossier copié | +| `autorename` | booléen | Non | Si vrai, renomme le fichier en cas de conflit à destination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `metadata` | objet | Métadonnées de l'élément copié | + +### `dropbox_move` + +Déplacer ou renommer un fichier ou un dossier dans Dropbox + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `fromPath` | chaîne | Oui | Le chemin source du fichier ou du dossier à déplacer | +| `toPath` | chaîne | Oui | Le chemin de destination pour le fichier ou dossier déplacé | +| `autorename` | booléen | Non | Si vrai, renomme le fichier en cas de conflit à destination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `metadata` | objet | Métadonnées de l'élément déplacé | + +### `dropbox_get_metadata` + +Obtenir les métadonnées d'un fichier ou d'un dossier dans Dropbox + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `path` | chaîne | Oui | Le chemin du fichier ou du dossier dont on souhaite obtenir les métadonnées | +| `includeMediaInfo` | booléen | Non | Si vrai, inclure les informations média pour les photos/vidéos | +| `includeDeleted` | booléen | Non | Si vrai, inclure les fichiers supprimés dans les résultats | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `metadata` | objet | Métadonnées du fichier ou du dossier | + +### `dropbox_create_shared_link` + +Créer un lien partageable pour un fichier ou un dossier dans Dropbox + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `path` | chaîne | Oui | Le chemin du fichier ou du dossier à partager | +| `requestedVisibility` | chaîne | Non | Visibilité : public, team_only, ou password | +| `linkPassword` | chaîne | Non | Mot de passe pour le lien partagé \(uniquement si la visibilité est password\) | +| `expires` | chaîne | Non | Date d'expiration au format ISO 8601 \(ex., 2025-12-31T23:59:59Z\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `sharedLink` | objet | Le lien partagé créé | + +### `dropbox_search` + +Rechercher des fichiers et dossiers dans Dropbox + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `query` | string | Oui | La requête de recherche | +| `path` | string | Non | Limiter la recherche à un chemin de dossier spécifique | +| `fileExtensions` | string | Non | Liste d'extensions de fichiers séparées par des virgules pour filtrer \(ex. pdf,xlsx\) | +| `maxResults` | number | Non | Nombre maximum de résultats à retourner \(par défaut : 100\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `matches` | array | Résultats de recherche | + +## Notes + +- Catégorie : `tools` +- Type : `dropbox` diff --git a/apps/docs/content/docs/fr/tools/elasticsearch.mdx b/apps/docs/content/docs/fr/tools/elasticsearch.mdx new file mode 100644 index 000000000..9d06988c4 --- /dev/null +++ b/apps/docs/content/docs/fr/tools/elasticsearch.mdx @@ -0,0 +1,365 @@ +--- +title: Elasticsearch +description: Recherchez, indexez et gérez des données dans Elasticsearch +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Elasticsearch](https://www.elastic.co/elasticsearch/) est un puissant moteur de recherche et d'analyse distribué qui vous permet d'indexer, de rechercher et d'analyser de grands volumes de données en temps réel. Il est largement utilisé pour alimenter les fonctionnalités de recherche, l'analyse des données de journaux et d'événements, l'observabilité, et plus encore. + +Avec Elasticsearch dans Sim, vous bénéficiez d'un accès programmatique aux capacités essentielles d'Elasticsearch, notamment : + +- **Recherche de documents** : effectuez des recherches avancées sur du texte structuré ou non structuré à l'aide du langage DSL, avec prise en charge du tri, de la pagination et de la sélection de champs. +- **Indexation de documents** : ajoutez de nouveaux documents ou mettez à jour des documents existants dans n'importe quel index Elasticsearch pour une récupération et une analyse immédiates. +- **Obtenir, mettre à jour ou supprimer des documents** : récupérez, modifiez ou supprimez des documents spécifiques par ID. +- **Opérations en masse** : exécutez plusieurs actions d'indexation ou de mise à jour en une seule requête pour un traitement de données à haut débit. +- **Gestion des index** : créez, supprimez ou obtenez des détails sur les index dans le cadre de votre automatisation de flux de travail. +- **Surveillance du cluster** : vérifiez l'état et les statistiques de votre déploiement Elasticsearch. + +Les outils Elasticsearch de Sim fonctionnent aussi bien avec des environnements auto-hébergés qu'avec Elastic Cloud. Intégrez Elasticsearch dans vos flux de travail d'agents pour automatiser l'ingestion de données, effectuer des recherches dans de vastes ensembles de données, exécuter des rapports ou créer des applications personnalisées basées sur la recherche - le tout sans intervention manuelle. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez Elasticsearch dans les flux de travail pour une recherche puissante, l'indexation et la gestion des données. Prend en charge les opérations CRUD de documents, les requêtes de recherche avancées, les opérations en masse, la gestion des index et la surveillance des clusters. Fonctionne avec les déploiements auto-hébergés et Elastic Cloud. + +## Outils + +### `elasticsearch_search` + +Recherchez des documents dans Elasticsearch en utilisant Query DSL. Renvoie les documents correspondants avec scores et métadonnées. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `deploymentType` | chaîne | Oui | Type de déploiement : self_hosted ou cloud | +| `host` | chaîne | Non | URL de l'hôte Elasticsearch (pour self-hosted) | +| `cloudId` | chaîne | Non | ID Elastic Cloud (pour les déploiements cloud) | +| `authMethod` | chaîne | Oui | Méthode d'authentification : api_key ou basic_auth | +| `apiKey` | chaîne | Non | Clé API Elasticsearch | +| `username` | chaîne | Non | Nom d'utilisateur pour l'authentification basique | +| `password` | chaîne | Non | Mot de passe pour l'authentification basique | +| `index` | chaîne | Oui | Nom de l'index à rechercher | +| `query` | chaîne | Non | Query DSL sous forme de chaîne JSON | +| `from` | nombre | Non | Décalage initial pour la pagination (par défaut : 0) | +| `size` | nombre | Non | Nombre de résultats à renvoyer (par défaut : 10) | +| `sort` | chaîne | Non | Spécification de tri sous forme de chaîne JSON | +| `sourceIncludes` | chaîne | Non | Liste de champs séparés par des virgules à inclure dans _source | +| `sourceExcludes` | chaîne | Non | Liste de champs séparés par des virgules à exclure de _source | +| `trackTotalHits` | booléen | Non | Suivre le nombre exact de résultats (par défaut : true) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `took` | nombre | Temps en millisecondes pris par la recherche | +| `timed_out` | booléen | Si la recherche a expiré | +| `hits` | objet | Résultats de recherche avec nombre total et documents correspondants | +| `aggregations` | json | Résultats d'agrégation, le cas échéant | + +### `elasticsearch_index_document` + +Indexer (créer ou mettre à jour) un document dans Elasticsearch. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | chaîne | Oui | Type de déploiement : self_hosted ou cloud | +| `host` | chaîne | Non | URL de l'hôte Elasticsearch \(pour self-hosted\) | +| `cloudId` | chaîne | Non | ID Cloud Elastic \(pour les déploiements cloud\) | +| `authMethod` | chaîne | Oui | Méthode d'authentification : api_key ou basic_auth | +| `apiKey` | chaîne | Non | Clé API Elasticsearch | +| `username` | chaîne | Non | Nom d'utilisateur pour l'authentification basique | +| `password` | chaîne | Non | Mot de passe pour l'authentification basique | +| `index` | chaîne | Oui | Nom de l'index cible | +| `documentId` | chaîne | Non | ID du document \(généré automatiquement si non fourni\) | +| `document` | chaîne | Oui | Corps du document au format JSON | +| `refresh` | chaîne | Non | Politique de rafraîchissement : true, false ou wait_for | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `_index` | chaîne | Index où le document a été stocké | +| `_id` | chaîne | ID du document | +| `_version` | nombre | Version du document | +| `result` | chaîne | Résultat de l'opération \(créé ou mis à jour\) | + +### `elasticsearch_get_document` + +Récupérer un document par ID depuis Elasticsearch. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | chaîne | Oui | Type de déploiement : self_hosted ou cloud | +| `host` | chaîne | Non | URL de l'hôte Elasticsearch \(pour self-hosted\) | +| `cloudId` | chaîne | Non | ID Cloud Elastic \(pour les déploiements cloud\) | +| `authMethod` | chaîne | Oui | Méthode d'authentification : api_key ou basic_auth | +| `apiKey` | chaîne | Non | Clé API Elasticsearch | +| `username` | chaîne | Non | Nom d'utilisateur pour l'authentification basique | +| `password` | chaîne | Non | Mot de passe pour l'authentification basique | +| `index` | chaîne | Oui | Nom de l'index | +| `documentId` | chaîne | Oui | ID du document à récupérer | +| `sourceIncludes` | chaîne | Non | Liste de champs à inclure, séparés par des virgules | +| `sourceExcludes` | chaîne | Non | Liste de champs à exclure, séparés par des virgules | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `_index` | string | Nom de l'index | +| `_id` | string | ID du document | +| `_version` | number | Version du document | +| `found` | boolean | Si le document a été trouvé | +| `_source` | json | Contenu du document | + +### `elasticsearch_update_document` + +Mettre à jour partiellement un document dans Elasticsearch en utilisant la fusion de documents. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `deploymentType` | string | Oui | Type de déploiement : self_hosted ou cloud | +| `host` | string | Non | URL de l'hôte Elasticsearch \(pour self-hosted\) | +| `cloudId` | string | Non | ID Elastic Cloud \(pour les déploiements cloud\) | +| `authMethod` | string | Oui | Méthode d'authentification : api_key ou basic_auth | +| `apiKey` | string | Non | Clé API Elasticsearch | +| `username` | string | Non | Nom d'utilisateur pour l'authentification basique | +| `password` | string | Non | Mot de passe pour l'authentification basique | +| `index` | string | Oui | Nom de l'index | +| `documentId` | string | Oui | ID du document à mettre à jour | +| `document` | string | Oui | Document partiel à fusionner sous forme de chaîne JSON | +| `retryOnConflict` | number | Non | Nombre de tentatives en cas de conflit de version | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `_index` | string | Nom de l'index | +| `_id` | string | ID du document | +| `_version` | number | Nouvelle version du document | +| `result` | string | Résultat de l'opération \(updated ou noop\) | + +### `elasticsearch_delete_document` + +Supprimer un document d'Elasticsearch par ID. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Oui | Type de déploiement : self_hosted ou cloud | +| `host` | string | Non | URL de l'hôte Elasticsearch \(pour self-hosted\) | +| `cloudId` | string | Non | ID Elastic Cloud \(pour les déploiements cloud\) | +| `authMethod` | string | Oui | Méthode d'authentification : api_key ou basic_auth | +| `apiKey` | string | Non | Clé API Elasticsearch | +| `username` | string | Non | Nom d'utilisateur pour l'authentification basique | +| `password` | string | Non | Mot de passe pour l'authentification basique | +| `index` | string | Oui | Nom de l'index | +| `documentId` | string | Oui | ID du document à supprimer | +| `refresh` | string | Non | Politique de rafraîchissement : true, false, ou wait_for | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `_index` | string | Nom de l'index | +| `_id` | string | ID du document | +| `_version` | number | Version du document | +| `result` | string | Résultat de l'opération \(deleted ou not_found\) | + +### `elasticsearch_bulk` + +Effectuer plusieurs opérations d'indexation, de création, de suppression ou de mise à jour en une seule requête pour une performance élevée. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Oui | Type de déploiement : self_hosted ou cloud | +| `host` | string | Non | URL de l'hôte Elasticsearch \(pour self-hosted\) | +| `cloudId` | string | Non | ID Elastic Cloud \(pour les déploiements cloud\) | +| `authMethod` | string | Oui | Méthode d'authentification : api_key ou basic_auth | +| `apiKey` | string | Non | Clé API Elasticsearch | +| `username` | string | Non | Nom d'utilisateur pour l'authentification basique | +| `password` | string | Non | Mot de passe pour l'authentification basique | +| `index` | string | Non | Index par défaut pour les opérations qui n'en spécifient pas | +| `operations` | string | Oui | Opérations en masse sous forme de chaîne NDJSON \(JSON délimité par des sauts de ligne\) | +| `refresh` | string | Non | Politique de rafraîchissement : true, false, ou wait_for | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `took` | number | Temps en millisecondes pris par l'opération en masse | +| `errors` | boolean | Indique si une opération a rencontré une erreur | +| `items` | array | Résultats pour chaque opération | + +### `elasticsearch_count` + +Compter les documents correspondant à une requête dans Elasticsearch. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Oui | Type de déploiement : self_hosted ou cloud | +| `host` | string | Non | URL de l'hôte Elasticsearch \(pour self-hosted\) | +| `cloudId` | string | Non | ID Elastic Cloud \(pour les déploiements cloud\) | +| `authMethod` | string | Oui | Méthode d'authentification : api_key ou basic_auth | +| `apiKey` | string | Non | Clé API Elasticsearch | +| `username` | string | Non | Nom d'utilisateur pour l'authentification basique | +| `password` | string | Non | Mot de passe pour l'authentification basique | +| `index` | string | Oui | Nom de l'index dans lequel compter les documents | +| `query` | string | Non | Requête optionnelle pour filtrer les documents \(chaîne JSON\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `count` | number | Nombre de documents correspondant à la requête | +| `_shards` | object | Statistiques des partitions | + +### `elasticsearch_create_index` + +Créer un nouvel index avec des paramètres et des mappages optionnels. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Oui | Type de déploiement : self_hosted ou cloud | +| `host` | string | Non | URL de l'hôte Elasticsearch \(pour self-hosted\) | +| `cloudId` | string | Non | ID Elastic Cloud \(pour les déploiements cloud\) | +| `authMethod` | string | Oui | Méthode d'authentification : api_key ou basic_auth | +| `apiKey` | string | Non | Clé API Elasticsearch | +| `username` | string | Non | Nom d'utilisateur pour l'authentification basique | +| `password` | string | Non | Mot de passe pour l'authentification basique | +| `index` | string | Oui | Nom de l'index à créer | +| `settings` | string | Non | Paramètres de l'index sous forme de chaîne JSON | +| `mappings` | string | Non | Mappages de l'index sous forme de chaîne JSON | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `acknowledged` | boolean | Indique si la requête a été confirmée | +| `shards_acknowledged` | boolean | Indique si les shards ont été confirmés | +| `index` | string | Nom de l'index créé | + +### `elasticsearch_delete_index` + +Supprimer un index et tous ses documents. Cette opération est irréversible. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Oui | Type de déploiement : self_hosted ou cloud | +| `host` | string | Non | URL de l'hôte Elasticsearch \(pour self-hosted\) | +| `cloudId` | string | Non | ID Elastic Cloud \(pour les déploiements cloud\) | +| `authMethod` | string | Oui | Méthode d'authentification : api_key ou basic_auth | +| `apiKey` | string | Non | Clé API Elasticsearch | +| `username` | string | Non | Nom d'utilisateur pour l'authentification basique | +| `password` | string | Non | Mot de passe pour l'authentification basique | +| `index` | string | Oui | Nom de l'index à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `acknowledged` | boolean | Indique si la suppression a été confirmée | + +### `elasticsearch_get_index` + +Récupérer les informations d'un index, y compris les paramètres, les mappings et les alias. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Oui | Type de déploiement : self_hosted ou cloud | +| `host` | string | Non | URL de l'hôte Elasticsearch \(pour self-hosted\) | +| `cloudId` | string | Non | ID Elastic Cloud \(pour les déploiements cloud\) | +| `authMethod` | string | Oui | Méthode d'authentification : api_key ou basic_auth | +| `apiKey` | string | Non | Clé API Elasticsearch | +| `username` | string | Non | Nom d'utilisateur pour l'authentification basique | +| `password` | string | Non | Mot de passe pour l'authentification basique | +| `index` | string | Oui | Nom de l'index dont on souhaite récupérer les informations | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `index` | json | Informations d'index incluant les alias, les mappages et les paramètres | + +### `elasticsearch_cluster_health` + +Obtenir l'état de santé du cluster Elasticsearch. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | Oui | Type de déploiement : self_hosted ou cloud | +| `host` | string | Non | URL de l'hôte Elasticsearch \(pour self-hosted\) | +| `cloudId` | string | Non | ID Elastic Cloud \(pour les déploiements cloud\) | +| `authMethod` | string | Oui | Méthode d'authentification : api_key ou basic_auth | +| `apiKey` | string | Non | Clé API Elasticsearch | +| `username` | string | Non | Nom d'utilisateur pour l'authentification basique | +| `password` | string | Non | Mot de passe pour l'authentification basique | +| `waitForStatus` | string | Non | Attendre jusqu'à ce que le cluster atteigne ce statut : green, yellow ou red | +| `timeout` | string | Non | Délai d'attente pour l'opération d'attente \(ex. 30s, 1m\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `cluster_name` | string | Nom du cluster | +| `status` | string | État de santé du cluster : green, yellow ou red | +| `number_of_nodes` | number | Nombre total de nœuds dans le cluster | +| `number_of_data_nodes` | number | Nombre de nœuds de données | +| `active_shards` | number | Nombre de shards actifs | +| `unassigned_shards` | number | Nombre de shards non assignés | + +### `elasticsearch_cluster_stats` + +Obtenez des statistiques complètes sur le cluster Elasticsearch. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `deploymentType` | chaîne | Oui | Type de déploiement : self_hosted ou cloud | +| `host` | chaîne | Non | URL de l'hôte Elasticsearch (pour self-hosted) | +| `cloudId` | chaîne | Non | ID Elastic Cloud (pour les déploiements cloud) | +| `authMethod` | chaîne | Oui | Méthode d'authentification : api_key ou basic_auth | +| `apiKey` | chaîne | Non | Clé API Elasticsearch | +| `username` | chaîne | Non | Nom d'utilisateur pour l'authentification de base | +| `password` | chaîne | Non | Mot de passe pour l'authentification de base | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `cluster_name` | chaîne | Nom du cluster | +| `status` | chaîne | État de santé du cluster | +| `nodes` | objet | Statistiques des nœuds incluant le nombre et les versions | +| `indices` | objet | Statistiques des index incluant le nombre de documents et la taille de stockage | + +## Notes + +- Catégorie : `tools` +- Type : `elasticsearch` diff --git a/apps/docs/content/docs/fr/tools/gitlab.mdx b/apps/docs/content/docs/fr/tools/gitlab.mdx new file mode 100644 index 000000000..25338adb9 --- /dev/null +++ b/apps/docs/content/docs/fr/tools/gitlab.mdx @@ -0,0 +1,430 @@ +--- +title: GitLab +description: Interagissez avec les projets, les problèmes, les demandes de + fusion et les pipelines GitLab +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[GitLab](https://gitlab.com/) est une plateforme DevOps complète qui permet aux équipes de gérer, collaborer et automatiser leur cycle de développement logiciel. Avec GitLab, vous pouvez facilement gérer le code source, l'intégration continue/déploiement continu (CI/CD), les révisions et la collaboration dans une seule application. + +Avec GitLab dans Sim, vous pouvez : + +- **Gérer des projets et des dépôts** : lister et récupérer vos projets GitLab, accéder aux détails et organiser vos dépôts +- **Travailler avec des problèmes** : lister, créer et commenter des problèmes pour suivre le travail et collaborer efficacement +- **Gérer les demandes de fusion** : examiner, créer et gérer les demandes de fusion pour les modifications de code et les révisions par les pairs +- **Automatiser les pipelines CI/CD** : déclencher, surveiller et interagir avec les pipelines GitLab dans le cadre de vos flux d'automatisation +- **Collaborer avec des commentaires** : ajouter des commentaires aux problèmes ou aux demandes de fusion pour une communication efficace au sein de votre équipe + +En utilisant l'intégration GitLab de Sim, vos agents peuvent interagir par programmation avec vos projets GitLab. Automatisez la gestion de projet, le suivi des problèmes, les révisions de code et les opérations de pipeline de manière transparente dans vos flux de travail, optimisant ainsi votre processus de développement logiciel et améliorant la collaboration au sein de votre équipe. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez GitLab dans le flux de travail. Peut gérer les projets, les problèmes, les demandes de fusion, les pipelines et ajouter des commentaires. Prend en charge toutes les opérations DevOps de base de GitLab. + +## Outils + +### `gitlab_list_projects` + +Lister les projets GitLab accessibles à l'utilisateur authentifié + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `owned` | boolean | Non | Limiter aux projets appartenant à l'utilisateur actuel | +| `membership` | boolean | Non | Limiter aux projets dont l'utilisateur actuel est membre | +| `search` | string | Non | Rechercher des projets par nom | +| `visibility` | string | Non | Filtrer par visibilité \(public, internal, private\) | +| `orderBy` | string | Non | Trier par champ \(id, name, path, created_at, updated_at, last_activity_at\) | +| `sort` | string | Non | Direction de tri \(asc, desc\) | +| `perPage` | number | Non | Nombre de résultats par page \(20 par défaut, 100 max\) | +| `page` | number | Non | Numéro de page pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `projects` | array | Liste des projets GitLab | +| `total` | number | Nombre total de projets | + +### `gitlab_get_project` + +Obtenir les détails d'un projet GitLab spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | ID du projet ou chemin encodé en URL \(ex. : "namespace/project"\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `project` | object | Les détails du projet GitLab | + +### `gitlab_list_issues` + +Lister les problèmes dans un projet GitLab + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | ID du projet ou chemin encodé en URL | +| `state` | string | Non | Filtrer par état \(opened, closed, all\) | +| `labels` | string | Non | Liste de noms d'étiquettes séparés par des virgules | +| `assigneeId` | number | Non | Filtrer par ID d'utilisateur assigné | +| `milestoneTitle` | string | Non | Filtrer par titre de jalon | +| `search` | string | Non | Rechercher des problèmes par titre et description | +| `orderBy` | string | Non | Trier par champ \(created_at, updated_at\) | +| `sort` | string | Non | Direction de tri \(asc, desc\) | +| `perPage` | number | Non | Nombre de résultats par page \(20 par défaut, max 100\) | +| `page` | number | Non | Numéro de page pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `issues` | array | Liste des problèmes GitLab | +| `total` | number | Nombre total de problèmes | + +### `gitlab_get_issue` + +Obtenir les détails d'un problème GitLab spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | ID du projet ou chemin encodé URL | +| `issueIid` | number | Oui | Numéro du problème dans le projet \(le # affiché dans l'interface GitLab\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `issue` | object | Les détails du problème GitLab | + +### `gitlab_create_issue` + +Créer un nouveau problème dans un projet GitLab + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | ID du projet ou chemin encodé URL | +| `title` | string | Oui | Titre du problème | +| `description` | string | Non | Description du problème \(Markdown pris en charge\) | +| `labels` | string | Non | Liste d'étiquettes séparées par des virgules | +| `assigneeIds` | array | Non | Tableau d'ID utilisateurs à assigner | +| `milestoneId` | number | Non | ID du jalon à assigner | +| `dueDate` | string | Non | Date d'échéance au format AAAA-MM-JJ | +| `confidential` | boolean | Non | Si le problème est confidentiel | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `issue` | objet | Le ticket GitLab créé | + +### `gitlab_update_issue` + +Mettre à jour un ticket existant dans un projet GitLab + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | chaîne | Oui | ID du projet ou chemin encodé URL | +| `issueIid` | nombre | Oui | ID interne du ticket \(IID\) | +| `title` | chaîne | Non | Nouveau titre du ticket | +| `description` | chaîne | Non | Nouvelle description du ticket \(Markdown pris en charge\) | +| `stateEvent` | chaîne | Non | Événement d'état \(close ou reopen\) | +| `labels` | chaîne | Non | Liste de noms d'étiquettes séparés par des virgules | +| `assigneeIds` | tableau | Non | Tableau d'ID utilisateurs à assigner | +| `milestoneId` | nombre | Non | ID du jalon à assigner | +| `dueDate` | chaîne | Non | Date d'échéance au format AAAA-MM-JJ | +| `confidential` | booléen | Non | Indique si le ticket est confidentiel | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `issue` | objet | Le ticket GitLab mis à jour | + +### `gitlab_delete_issue` + +Supprimer un ticket d'un projet GitLab + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | chaîne | Oui | ID du projet ou chemin encodé URL | +| `issueIid` | nombre | Oui | ID interne du ticket \(IID\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Indique si le problème a été supprimé avec succès | + +### `gitlab_create_issue_note` + +Ajouter un commentaire à un problème GitLab + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | ID du projet ou chemin encodé en URL | +| `issueIid` | number | Oui | ID interne du problème (IID) | +| `body` | string | Oui | Corps du commentaire (Markdown pris en charge) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `note` | object | Le commentaire créé | + +### `gitlab_list_merge_requests` + +Lister les demandes de fusion dans un projet GitLab + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | ID du projet ou chemin encodé en URL | +| `state` | string | Non | Filtrer par état (opened, closed, merged, all) | +| `labels` | string | Non | Liste de noms d'étiquettes séparés par des virgules | +| `sourceBranch` | string | Non | Filtrer par branche source | +| `targetBranch` | string | Non | Filtrer par branche cible | +| `orderBy` | string | Non | Trier par champ (created_at, updated_at) | +| `sort` | string | Non | Direction de tri (asc, desc) | +| `perPage` | number | Non | Nombre de résultats par page (20 par défaut, 100 max) | +| `page` | number | Non | Numéro de page pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `mergeRequests` | array | Liste des demandes de fusion GitLab | +| `total` | number | Nombre total de demandes de fusion | + +### `gitlab_get_merge_request` + +Obtenir les détails d'une demande de fusion GitLab spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `projectId` | string | Oui | ID du projet ou chemin encodé en URL | +| `mergeRequestIid` | number | Oui | ID interne de la demande de fusion \(IID\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `mergeRequest` | object | Les détails de la demande de fusion GitLab | + +### `gitlab_create_merge_request` + +Créer une nouvelle demande de fusion dans un projet GitLab + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `projectId` | string | Oui | ID du projet ou chemin encodé en URL | +| `sourceBranch` | string | Oui | Nom de la branche source | +| `targetBranch` | string | Oui | Nom de la branche cible | +| `title` | string | Oui | Titre de la demande de fusion | +| `description` | string | Non | Description de la demande de fusion \(Markdown pris en charge\) | +| `labels` | string | Non | Liste de noms d'étiquettes séparés par des virgules | +| `assigneeIds` | array | Non | Tableau d'ID utilisateurs à assigner | +| `milestoneId` | number | Non | ID du jalon à assigner | +| `removeSourceBranch` | boolean | Non | Supprimer la branche source après la fusion | +| `squash` | boolean | Non | Regrouper les commits lors de la fusion | +| `draft` | boolean | Non | Marquer comme brouillon \(travail en cours\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `mergeRequest` | objet | La demande de fusion GitLab créée | + +### `gitlab_update_merge_request` + +Mettre à jour une demande de fusion existante dans un projet GitLab + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | chaîne | Oui | ID du projet ou chemin encodé URL | +| `mergeRequestIid` | nombre | Oui | ID interne de la demande de fusion \(IID\) | +| `title` | chaîne | Non | Nouveau titre de la demande de fusion | +| `description` | chaîne | Non | Nouvelle description de la demande de fusion | +| `stateEvent` | chaîne | Non | Événement d'état \(close ou reopen\) | +| `labels` | chaîne | Non | Liste de noms d'étiquettes séparés par des virgules | +| `assigneeIds` | tableau | Non | Tableau d'ID utilisateurs à assigner | +| `milestoneId` | nombre | Non | ID du jalon à assigner | +| `targetBranch` | chaîne | Non | Nouvelle branche cible | +| `removeSourceBranch` | booléen | Non | Supprimer la branche source après la fusion | +| `squash` | booléen | Non | Regrouper les commits lors de la fusion | +| `draft` | booléen | Non | Marquer comme brouillon \(travail en cours\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `mergeRequest` | objet | La demande de fusion GitLab mise à jour | + +### `gitlab_merge_merge_request` + +Fusionner une demande de fusion dans un projet GitLab + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | chaîne | Oui | ID du projet ou chemin encodé URL | +| `mergeRequestIid` | nombre | Oui | ID interne de la demande de fusion \(IID\) | +| `mergeCommitMessage` | chaîne | Non | Message personnalisé du commit de fusion | +| `squashCommitMessage` | chaîne | Non | Message personnalisé du commit de regroupement | +| `squash` | booléen | Non | Regrouper les commits avant la fusion | +| `shouldRemoveSourceBranch` | booléen | Non | Supprimer la branche source après la fusion | +| `mergeWhenPipelineSucceeds` | booléen | Non | Fusionner lorsque le pipeline réussit | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `mergeRequest` | objet | La demande de fusion GitLab fusionnée | + +### `gitlab_create_merge_request_note` + +Ajouter un commentaire à une demande de fusion GitLab + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | chaîne | Oui | ID du projet ou chemin encodé en URL | +| `mergeRequestIid` | nombre | Oui | ID interne de la demande de fusion \(IID\) | +| `body` | chaîne | Oui | Corps du commentaire \(Markdown pris en charge\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `note` | objet | Le commentaire créé | + +### `gitlab_list_pipelines` + +Lister les pipelines dans un projet GitLab + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | chaîne | Oui | ID du projet ou chemin encodé en URL | +| `ref` | chaîne | Non | Filtrer par ref \(branche ou tag\) | +| `status` | chaîne | Non | Filtrer par statut \(created, waiting_for_resource, preparing, pending, running, success, failed, canceled, skipped, manual, scheduled\) | +| `orderBy` | chaîne | Non | Trier par champ \(id, status, ref, updated_at, user_id\) | +| `sort` | chaîne | Non | Direction de tri \(asc, desc\) | +| `perPage` | nombre | Non | Nombre de résultats par page \(20 par défaut, 100 max\) | +| `page` | nombre | Non | Numéro de page pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `pipelines` | array | Liste des pipelines GitLab | +| `total` | number | Nombre total de pipelines | + +### `gitlab_get_pipeline` + +Obtenir les détails d'un pipeline GitLab spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | ID du projet ou chemin encodé URL | +| `pipelineId` | number | Oui | ID du pipeline | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `pipeline` | object | Les détails du pipeline GitLab | + +### `gitlab_create_pipeline` + +Déclencher un nouveau pipeline dans un projet GitLab + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | ID du projet ou chemin encodé URL | +| `ref` | string | Oui | Branche ou tag sur lequel exécuter le pipeline | +| `variables` | array | Non | Tableau de variables pour le pipeline \(chacune avec clé, valeur et type de variable optionnel\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `pipeline` | object | Le pipeline GitLab créé | + +### `gitlab_retry_pipeline` + +Réessayer un pipeline GitLab échoué + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | ID du projet ou chemin encodé URL | +| `pipelineId` | number | Oui | ID du pipeline | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `pipeline` | objet | Le pipeline GitLab relancé | + +### `gitlab_cancel_pipeline` + +Annuler un pipeline GitLab en cours d'exécution + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `projectId` | chaîne | Oui | ID du projet ou chemin encodé en URL | +| `pipelineId` | nombre | Oui | ID du pipeline | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `pipeline` | objet | Le pipeline GitLab annulé | + +## Remarques + +- Catégorie : `tools` +- Type : `gitlab` diff --git a/apps/docs/content/docs/fr/tools/grafana.mdx b/apps/docs/content/docs/fr/tools/grafana.mdx new file mode 100644 index 000000000..04a8bd017 --- /dev/null +++ b/apps/docs/content/docs/fr/tools/grafana.mdx @@ -0,0 +1,494 @@ +--- +title: Grafana +description: Interagissez avec les tableaux de bord, les alertes et les annotations Grafana +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Grafana](https://grafana.com/) est une plateforme open-source de premier plan pour la surveillance, l'observabilité et la visualisation. Elle permet aux utilisateurs d'interroger, de visualiser, d'alerter et d'analyser des données provenant de diverses sources, ce qui en fait un outil essentiel pour la surveillance des infrastructures et des applications. + +Avec Grafana, vous pouvez : + +- **Visualiser des données** : créer et personnaliser des tableaux de bord pour afficher des métriques, des journaux et des traces en temps réel +- **Surveiller la santé et le statut** : vérifier la santé de votre instance Grafana et des sources de données connectées +- **Gérer les alertes et les annotations** : configurer des règles d'alerte, gérer les notifications et annoter les tableaux de bord avec des événements importants +- **Organiser le contenu** : organiser les tableaux de bord et les sources de données dans des dossiers pour une meilleure gestion des accès + +Dans Sim, l'intégration Grafana permet à vos agents d'interagir directement avec votre instance Grafana via API, permettant des actions telles que : + +- Vérifier l'état de santé du serveur Grafana, de la base de données et des sources de données +- Récupérer, lister et gérer les tableaux de bord, les règles d'alerte, les annotations, les sources de données et les dossiers +- Automatiser la surveillance de votre infrastructure en intégrant les données et les alertes Grafana dans vos automatisations de flux de travail + +Ces capacités permettent aux agents Sim de surveiller les systèmes, de répondre de manière proactive aux alertes et d'aider à assurer la fiabilité et la visibilité de vos services — le tout dans le cadre de vos flux de travail automatisés. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez Grafana dans les flux de travail. Gérez les tableaux de bord, les alertes, les annotations, les sources de données, les dossiers et surveillez l'état de santé. + +## Outils + +### `grafana_get_dashboard` + +Obtenir un tableau de bord par son UID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Jeton de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana \(ex. : https://your-grafana.com\) | +| `organizationId` | string | Non | ID de l'organisation pour les instances Grafana multi-organisations | +| `dashboardUid` | string | Oui | L'UID du tableau de bord à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `dashboard` | json | L'objet JSON complet du tableau de bord | +| `meta` | json | Métadonnées du tableau de bord \(version, permissions, etc.\) | + +### `grafana_list_dashboards` + +Rechercher et lister tous les tableaux de bord + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Jeton de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana \(ex., https://your-grafana.com\) | +| `organizationId` | string | Non | ID de l'organisation pour les instances Grafana multi-organisations | +| `query` | string | Non | Requête de recherche pour filtrer les tableaux de bord par titre | +| `tag` | string | Non | Filtrer par tag \(séparés par des virgules pour plusieurs tags\) | +| `folderIds` | string | Non | Filtrer par ID de dossier \(séparés par des virgules\) | +| `starred` | boolean | Non | Renvoyer uniquement les tableaux de bord favoris | +| `limit` | number | Non | Nombre maximum de tableaux de bord à renvoyer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `dashboards` | array | Liste des résultats de recherche de tableaux de bord | + +### `grafana_create_dashboard` + +Créer un nouveau tableau de bord + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Jeton de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana \(ex., https://your-grafana.com\) | +| `organizationId` | string | Non | ID de l'organisation pour les instances Grafana multi-organisations | +| `title` | string | Oui | Le titre du nouveau tableau de bord | +| `folderUid` | string | Non | L'UID du dossier dans lequel créer le tableau de bord | +| `tags` | string | Non | Liste de tags séparés par des virgules | +| `timezone` | string | Non | Fuseau horaire du tableau de bord \(ex., browser, utc\) | +| `refresh` | string | Non | Intervalle d'actualisation automatique \(ex., 5s, 1m, 5m\) | +| `panels` | string | Non | Tableau JSON des configurations de panneaux | +| `overwrite` | boolean | Non | Écraser le tableau de bord existant avec le même titre | +| `message` | string | Non | Message de commit pour la version du tableau de bord | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | number | L'ID numérique du tableau de bord créé | +| `uid` | string | L'UID du tableau de bord créé | +| `url` | string | Le chemin d'URL vers le tableau de bord | +| `status` | string | Statut de l'opération \(success\) | +| `version` | number | Le numéro de version du tableau de bord | +| `slug` | string | Slug convivial pour l'URL du tableau de bord | + +### `grafana_update_dashboard` + +Mettre à jour un tableau de bord existant. Récupère le tableau de bord actuel et fusionne vos modifications. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | string | Oui | Token de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana \(ex. : https://your-grafana.com\) | +| `organizationId` | string | Non | ID d'organisation pour les instances Grafana multi-organisations | +| `dashboardUid` | string | Oui | L'UID du tableau de bord à mettre à jour | +| `title` | string | Non | Nouveau titre pour le tableau de bord | +| `folderUid` | string | Non | Nouvel UID de dossier pour déplacer le tableau de bord | +| `tags` | string | Non | Liste de nouvelles étiquettes séparées par des virgules | +| `timezone` | string | Non | Fuseau horaire du tableau de bord \(ex. : browser, utc\) | +| `refresh` | string | Non | Intervalle d'actualisation automatique \(ex. : 5s, 1m, 5m\) | +| `panels` | string | Non | Tableau JSON des configurations de panneaux | +| `overwrite` | boolean | Non | Écraser même en cas de conflit de version | +| `message` | string | Non | Message de commit pour cette version | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | number | L'ID numérique du tableau de bord mis à jour | +| `uid` | string | L'UID du tableau de bord mis à jour | +| `url` | string | Le chemin URL vers le tableau de bord | +| `status` | string | Statut de l'opération \(success\) | +| `version` | number | Le nouveau numéro de version du tableau de bord | +| `slug` | string | Slug convivial pour URL du tableau de bord | + +### `grafana_delete_dashboard` + +Supprimer un tableau de bord par son UID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | string | Oui | Token de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana \(ex. : https://your-grafana.com\) | +| `organizationId` | string | Non | ID d'organisation pour les instances Grafana multi-organisations | +| `dashboardUid` | string | Oui | L'UID du tableau de bord à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `title` | string | Le titre du tableau de bord supprimé | +| `message` | string | Message de confirmation | +| `id` | number | L'ID du tableau de bord supprimé | + +### `grafana_list_alert_rules` + +Lister toutes les règles d'alerte dans l'instance Grafana + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | string | Oui | Token de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana \(ex. : https://your-grafana.com\) | +| `organizationId` | string | Non | ID d'organisation pour les instances Grafana multi-organisations | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `rules` | array | Liste des règles d'alerte | + +### `grafana_get_alert_rule` + +Obtenir une règle d'alerte spécifique par son UID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Jeton de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana \(ex., https://your-grafana.com\) | +| `organizationId` | string | Non | ID de l'organisation pour les instances Grafana multi-organisations | +| `alertRuleUid` | string | Oui | L'UID de la règle d'alerte à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `uid` | string | UID de la règle d'alerte | +| `title` | string | Titre de la règle d'alerte | +| `condition` | string | Condition d'alerte | +| `data` | json | Données de requête de la règle d'alerte | +| `folderUID` | string | UID du dossier parent | +| `ruleGroup` | string | Nom du groupe de règles | +| `noDataState` | string | État lorsqu'aucune donnée n'est retournée | +| `execErrState` | string | État en cas d'erreur d'exécution | +| `annotations` | json | Annotations d'alerte | +| `labels` | json | Étiquettes d'alerte | + +### `grafana_create_alert_rule` + +Créer une nouvelle règle d'alerte + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Jeton de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana \(ex., https://your-grafana.com\) | +| `organizationId` | string | Non | ID de l'organisation pour les instances Grafana multi-organisations | +| `title` | string | Oui | Le titre de la règle d'alerte | +| `folderUid` | string | Oui | L'UID du dossier dans lequel créer l'alerte | +| `ruleGroup` | string | Oui | Le nom du groupe de règles | +| `condition` | string | Oui | Le refId de la requête ou de l'expression à utiliser comme condition d'alerte | +| `data` | string | Oui | Tableau JSON d'objets de données de requête/expression | +| `forDuration` | string | Non | Durée d'attente avant déclenchement \(ex., 5m, 1h\) | +| `noDataState` | string | Non | État lorsqu'aucune donnée n'est retournée \(NoData, Alerting, OK\) | +| `execErrState` | string | Non | État en cas d'erreur d'exécution \(Alerting, OK\) | +| `annotations` | string | Non | Objet JSON d'annotations | +| `labels` | string | Non | Objet JSON d'étiquettes | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `uid` | string | L'UID de la règle d'alerte créée | +| `title` | string | Titre de la règle d'alerte | +| `folderUID` | string | UID du dossier parent | +| `ruleGroup` | string | Nom du groupe de règles | + +### `grafana_update_alert_rule` + +Mettre à jour une règle d'alerte existante. Récupère la règle actuelle et fusionne vos modifications. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | string | Oui | Jeton de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana (ex. : https://your-grafana.com) | +| `organizationId` | string | Non | ID de l'organisation pour les instances Grafana multi-organisations | +| `alertRuleUid` | string | Oui | L'UID de la règle d'alerte à mettre à jour | +| `title` | string | Non | Nouveau titre pour la règle d'alerte | +| `folderUid` | string | Non | Nouvel UID de dossier pour déplacer l'alerte | +| `ruleGroup` | string | Non | Nouveau nom du groupe de règles | +| `condition` | string | Non | Nouvelle référence de condition | +| `data` | string | Non | Nouveau tableau JSON d'objets de données de requête/expression | +| `forDuration` | string | Non | Durée d'attente avant déclenchement (ex. : 5m, 1h) | +| `noDataState` | string | Non | État en l'absence de données (NoData, Alerting, OK) | +| `execErrState` | string | Non | État en cas d'erreur d'exécution (Alerting, OK) | +| `annotations` | string | Non | Objet JSON d'annotations | +| `labels` | string | Non | Objet JSON d'étiquettes | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `uid` | string | L'UID de la règle d'alerte mise à jour | +| `title` | string | Titre de la règle d'alerte | +| `folderUID` | string | UID du dossier parent | +| `ruleGroup` | string | Nom du groupe de règles | + +### `grafana_delete_alert_rule` + +Supprimer une règle d'alerte par son UID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Jeton de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana (par ex., https://your-grafana.com) | +| `organizationId` | string | Non | ID d'organisation pour les instances Grafana multi-organisations | +| `alertRuleUid` | string | Oui | L'UID de la règle d'alerte à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `message` | string | Message de confirmation | + +### `grafana_list_contact_points` + +Lister tous les points de contact de notification d'alerte + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Jeton de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana (par ex., https://your-grafana.com) | +| `organizationId` | string | Non | ID d'organisation pour les instances Grafana multi-organisations | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `contactPoints` | array | Liste des points de contact | + +### `grafana_create_annotation` + +Créer une annotation sur un tableau de bord ou comme annotation globale + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Jeton de compte de service Grafana | +| `baseUrl` | chaîne | Oui | URL de l'instance Grafana \(ex., https://your-grafana.com\) | +| `organizationId` | chaîne | Non | ID d'organisation pour les instances Grafana multi-organisations | +| `text` | chaîne | Oui | Le contenu textuel de l'annotation | +| `tags` | chaîne | Non | Liste de tags séparés par des virgules | +| `dashboardUid` | chaîne | Non | UID du tableau de bord auquel ajouter l'annotation \(facultatif pour les annotations globales\) | +| `panelId` | nombre | Non | ID du panneau auquel ajouter l'annotation | +| `time` | nombre | Non | Heure de début en millisecondes d'époque \(par défaut : maintenant\) | +| `timeEnd` | nombre | Non | Heure de fin en millisecondes d'époque \(pour les annotations de plage\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | nombre | L'ID de l'annotation créée | +| `message` | chaîne | Message de confirmation | + +### `grafana_list_annotations` + +Interroger les annotations par plage de temps, tableau de bord ou tags + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Jeton de compte de service Grafana | +| `baseUrl` | chaîne | Oui | URL de l'instance Grafana \(ex., https://your-grafana.com\) | +| `organizationId` | chaîne | Non | ID d'organisation pour les instances Grafana multi-organisations | +| `from` | nombre | Non | Heure de début en millisecondes d'époque | +| `to` | nombre | Non | Heure de fin en millisecondes d'époque | +| `dashboardUid` | chaîne | Non | Filtrer par UID de tableau de bord | +| `panelId` | nombre | Non | Filtrer par ID de panneau | +| `tags` | chaîne | Non | Liste de tags séparés par des virgules pour filtrer | +| `type` | chaîne | Non | Filtrer par type \(alerte ou annotation\) | +| `limit` | nombre | Non | Nombre maximum d'annotations à retourner | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `annotations` | array | Liste des annotations | + +### `grafana_update_annotation` + +Mettre à jour une annotation existante + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Jeton de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana (ex. : https://your-grafana.com) | +| `organizationId` | string | Non | ID de l'organisation pour les instances Grafana multi-organisations | +| `annotationId` | number | Oui | L'ID de l'annotation à mettre à jour | +| `text` | string | Oui | Nouveau contenu textuel pour l'annotation | +| `tags` | string | Non | Liste de nouvelles balises séparées par des virgules | +| `time` | number | Non | Nouvelle heure de début en millisecondes d'époque | +| `timeEnd` | number | Non | Nouvelle heure de fin en millisecondes d'époque | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | number | L'ID de l'annotation mise à jour | +| `message` | string | Message de confirmation | + +### `grafana_delete_annotation` + +Supprimer une annotation par son ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Jeton de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana (ex. : https://your-grafana.com) | +| `organizationId` | string | Non | ID de l'organisation pour les instances Grafana multi-organisations | +| `annotationId` | number | Oui | L'ID de l'annotation à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `message` | string | Message de confirmation | + +### `grafana_list_data_sources` + +Lister toutes les sources de données configurées dans Grafana + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | string | Oui | Jeton de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana (ex. : https://your-grafana.com) | +| `organizationId` | string | Non | ID d'organisation pour les instances Grafana multi-organisations | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `dataSources` | array | Liste des sources de données | + +### `grafana_get_data_source` + +Obtenir une source de données par son ID ou UID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | string | Oui | Jeton de compte de service Grafana | +| `baseUrl` | string | Oui | URL de l'instance Grafana (ex. : https://your-grafana.com) | +| `organizationId` | string | Non | ID d'organisation pour les instances Grafana multi-organisations | +| `dataSourceId` | string | Oui | L'ID ou l'UID de la source de données à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | number | ID de la source de données | +| `uid` | string | UID de la source de données | +| `name` | string | Nom de la source de données | +| `type` | string | Type de source de données | +| `url` | string | URL de connexion de la source de données | +| `database` | string | Nom de la base de données (si applicable) | +| `isDefault` | boolean | Indique si c'est la source de données par défaut | +| `jsonData` | json | Configuration supplémentaire de la source de données | + +### `grafana_list_folders` + +Lister tous les dossiers dans Grafana + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Jeton de compte de service Grafana | +| `baseUrl` | chaîne | Oui | URL de l'instance Grafana \(ex., https://your-grafana.com\) | +| `organizationId` | chaîne | Non | ID de l'organisation pour les instances Grafana multi-organisations | +| `limit` | nombre | Non | Nombre maximum de dossiers à retourner | +| `page` | nombre | Non | Numéro de page pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `folders` | tableau | Liste des dossiers | + +### `grafana_create_folder` + +Créer un nouveau dossier dans Grafana + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Jeton de compte de service Grafana | +| `baseUrl` | chaîne | Oui | URL de l'instance Grafana \(ex., https://your-grafana.com\) | +| `organizationId` | chaîne | Non | ID de l'organisation pour les instances Grafana multi-organisations | +| `title` | chaîne | Oui | Le titre du nouveau dossier | +| `uid` | chaîne | Non | UID optionnel pour le dossier \(généré automatiquement si non fourni\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | nombre | L'ID numérique du dossier créé | +| `uid` | chaîne | L'UID du dossier créé | +| `title` | chaîne | Le titre du dossier créé | +| `url` | chaîne | Le chemin URL vers le dossier | + +## Notes + +- Catégorie : `tools` +- Type : `grafana` diff --git a/apps/docs/content/docs/fr/tools/kalshi.mdx b/apps/docs/content/docs/fr/tools/kalshi.mdx new file mode 100644 index 000000000..a33ad47d3 --- /dev/null +++ b/apps/docs/content/docs/fr/tools/kalshi.mdx @@ -0,0 +1,295 @@ +--- +title: Kalshi +description: Accédez aux données des marchés prédictifs de Kalshi +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Kalshi](https://kalshi.com) est une bourse réglementée au niveau fédéral où les utilisateurs peuvent négocier directement sur les résultats d'événements futurs — des marchés prédictifs. L'API robuste de Kalshi et l'intégration Sim permettent aux agents et aux flux de travail d'accéder par programmation à tous les aspects de la plateforme, prenant en charge tout, de la recherche et l'analyse jusqu'au trading automatisé et à la surveillance. + +Avec l'intégration de Kalshi dans Sim, vous pouvez : + +- **Données de marché et d'événement :** rechercher, filtrer et récupérer des données en temps réel et historiques pour les marchés et les événements ; obtenir des détails précis sur le statut du marché, les séries, les regroupements d'événements, et plus encore. +- **Gestion de compte et de solde :** accéder aux soldes de compte, aux fonds disponibles et surveiller les positions ouvertes en temps réel. +- **Gestion des ordres et des transactions :** placer de nouveaux ordres, annuler ceux existants, consulter les ordres ouverts, récupérer un carnet d'ordres en direct et accéder aux historiques complets des transactions. +- **Analyse d'exécution :** récupérer les transactions récentes, les exécutions historiques et les données en chandeliers pour le backtesting ou la recherche sur la structure du marché. +- **Surveillance :** vérifier le statut à l'échelle de la bourse ou au niveau des séries, recevoir des mises à jour en temps réel sur les changements de marché ou les arrêts de trading, et automatiser les réponses. +- **Prêt pour l'automatisation :** créer des agents automatisés et des tableaux de bord de bout en bout qui consomment, analysent et négocient sur les probabilités d'événements réels. + +En utilisant ces outils et points d'accès unifiés, vous pouvez intégrer de manière transparente les marchés prédictifs de Kalshi, les capacités de trading en direct et les données d'événements approfondies dans vos applications, tableaux de bord et flux de travail alimentés par l'IA — permettant une prise de décision sophistiquée et automatisée liée aux résultats du monde réel. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez les marchés prédictifs de Kalshi dans le flux de travail. Peut obtenir les marchés, le marché, les événements, l'événement, le solde, les positions, les ordres, le carnet d'ordres, les transactions, les chandeliers, les exécutions, les séries et le statut de la bourse. + +## Outils + +### `kalshi_get_markets` + +Récupérer une liste de marchés prédictifs de Kalshi avec filtrage optionnel + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `status` | chaîne | Non | Filtrer par statut \(non ouvert, ouvert, fermé, réglé\) | +| `seriesTicker` | chaîne | Non | Filtrer par code de série | +| `eventTicker` | chaîne | Non | Filtrer par code d'événement | +| `limit` | chaîne | Non | Nombre de résultats \(1-1000, par défaut : 100\) | +| `cursor` | chaîne | Non | Curseur de pagination pour la page suivante | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données des marchés et métadonnées | + +### `kalshi_get_market` + +Récupérer les détails d'un marché prédictif spécifique par code + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `ticker` | chaîne | Oui | Le code du marché \(ex. : "KXBTC-24DEC31"\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données du marché et métadonnées | + +### `kalshi_get_events` + +Récupérer une liste d'événements de Kalshi avec filtrage optionnel + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `status` | chaîne | Non | Filtrer par statut \(ouvert, fermé, réglé\) | +| `seriesTicker` | chaîne | Non | Filtrer par code de série | +| `withNestedMarkets` | chaîne | Non | Inclure les marchés imbriqués dans la réponse \(vrai/faux\) | +| `limit` | chaîne | Non | Nombre de résultats \(1-200, par défaut : 200\) | +| `cursor` | chaîne | Non | Curseur de pagination pour la page suivante | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées des événements | + +### `kalshi_get_event` + +Récupérer les détails d'un événement spécifique par ticker + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `eventTicker` | string | Oui | Le ticker de l'événement | +| `withNestedMarkets` | string | Non | Inclure les marchés imbriqués dans la réponse \(true/false\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées de l'événement | + +### `kalshi_get_balance` + +Récupérer le solde de votre compte et la valeur de votre portefeuille depuis Kalshi + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | Oui | Votre ID de clé API Kalshi | +| `privateKey` | string | Oui | Votre clé privée RSA \(format PEM\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées du solde | + +### `kalshi_get_positions` + +Récupérer vos positions ouvertes depuis Kalshi + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | Oui | Votre ID de clé API Kalshi | +| `privateKey` | string | Oui | Votre clé privée RSA \(format PEM\) | +| `ticker` | string | Non | Filtrer par ticker de marché | +| `eventTicker` | string | Non | Filtrer par ticker d'événement \(max 10 séparés par des virgules\) | +| `settlementStatus` | string | Non | Filtrer par statut de règlement \(all, unsettled, settled\). Par défaut : unsettled | +| `limit` | string | Non | Nombre de résultats \(1-1000, par défaut : 100\) | +| `cursor` | string | Non | Curseur de pagination pour la page suivante | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de positions et métadonnées | + +### `kalshi_get_orders` + +Récupérez vos ordres depuis Kalshi avec filtrage optionnel + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | Oui | Votre ID de clé API Kalshi | +| `privateKey` | string | Oui | Votre clé privée RSA \(format PEM\) | +| `ticker` | string | Non | Filtrer par ticker de marché | +| `eventTicker` | string | Non | Filtrer par ticker d'événement \(max 10 séparés par des virgules\) | +| `status` | string | Non | Filtrer par statut \(en attente, annulé, exécuté\) | +| `limit` | string | Non | Nombre de résultats \(1-200, par défaut : 100\) | +| `cursor` | string | Non | Curseur de pagination pour la page suivante | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données des ordres et métadonnées | + +### `kalshi_get_orderbook` + +Récupérez le carnet d'ordres (offres d'achat et de vente) pour un marché spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `ticker` | string | Oui | Ticker du marché \(ex. : KXBTC-24DEC31\) | +| `depth` | number | Non | Nombre de niveaux de prix à retourner par côté | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées du carnet d'ordres | + +### `kalshi_get_trades` + +Récupérer les transactions récentes sur tous les marchés ou pour un marché spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `ticker` | string | Non | Filtrer par symbole de marché | +| `minTs` | number | Non | Horodatage minimum (millisecondes Unix) | +| `maxTs` | number | Non | Horodatage maximum (millisecondes Unix) | +| `limit` | string | Non | Nombre de résultats (1-1000, par défaut : 100) | +| `cursor` | string | Non | Curseur de pagination pour la page suivante | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées des transactions | + +### `kalshi_get_candlesticks` + +Récupérer les données de chandeliers OHLC pour un marché spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `seriesTicker` | string | Oui | Symbole de la série | +| `ticker` | string | Oui | Symbole du marché (ex. : KXBTC-24DEC31) | +| `startTs` | number | Non | Horodatage de début (millisecondes Unix) | +| `endTs` | number | Non | Horodatage de fin (millisecondes Unix) | +| `periodInterval` | number | Non | Intervalle de période : 1 (1min), 60 (1heure), ou 1440 (1jour) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées du chandelier | + +### `kalshi_get_fills` + +Récupérer votre portefeuille + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | Oui | Votre ID de clé API Kalshi | +| `privateKey` | string | Oui | Votre clé privée RSA \(format PEM\) | +| `ticker` | string | Non | Filtrer par ticker de marché | +| `orderId` | string | Non | Filtrer par ID de commande | +| `minTs` | number | Non | Horodatage minimum \(millisecondes Unix\) | +| `maxTs` | number | Non | Horodatage maximum \(millisecondes Unix\) | +| `limit` | string | Non | Nombre de résultats \(1-1000, par défaut : 100\) | +| `cursor` | string | Non | Curseur de pagination pour la page suivante | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées des exécutions | + +### `kalshi_get_series_by_ticker` + +Récupérer les détails d'une série de marché spécifique par ticker + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `seriesTicker` | string | Oui | Ticker de la série | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées de la série | + +### `kalshi_get_exchange_status` + +Récupérer l'état actuel de l'échange Kalshi (activité de trading et d'échange) + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données d'état de l'échange et métadonnées | + +## Notes + +- Catégorie : `tools` +- Type : `kalshi` diff --git a/apps/docs/content/docs/fr/tools/polymarket.mdx b/apps/docs/content/docs/fr/tools/polymarket.mdx new file mode 100644 index 000000000..19acbbf75 --- /dev/null +++ b/apps/docs/content/docs/fr/tools/polymarket.mdx @@ -0,0 +1,352 @@ +--- +title: Polymarket +description: Accédez aux données des marchés prédictifs de Polymarket +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Polymarket](https://polymarket.com) est une plateforme décentralisée de marchés prédictifs où les utilisateurs peuvent négocier sur l'issue d'événements futurs en utilisant la technologie blockchain. Polymarket fournit une API complète, permettant aux développeurs et aux agents d'accéder aux données de marché en direct, aux listes d'événements, aux informations de prix et aux statistiques du carnet d'ordres pour alimenter des flux de travail basés sur les données et des automatisations d'IA. + +Avec l'API de Polymarket et l'intégration Sim, vous pouvez permettre aux agents de récupérer programmatiquement des informations sur les marchés prédictifs, d'explorer les marchés ouverts et les événements associés, d'analyser les données historiques de prix, et d'accéder aux carnets d'ordres et aux points médians du marché. Cela crée de nouvelles possibilités pour la recherche, l'analyse automatisée et le développement d'agents intelligents qui réagissent aux probabilités d'événements en temps réel dérivées des prix du marché. + +Les fonctionnalités clés de l'intégration Polymarket comprennent : + +- **Liste et filtrage des marchés :** listez tous les marchés prédictifs actuels ou historiques, filtrez par tag, triez et naviguez à travers les résultats. +- **Détail du marché :** récupérez les détails d'un marché spécifique par ID ou slug, y compris ses résultats et son statut. +- **Listes d'événements :** accédez aux listes d'événements Polymarket et aux informations détaillées sur les événements. +- **Carnet d'ordres et données de prix :** analysez le carnet d'ordres, obtenez les derniers prix du marché, consultez le point médian ou obtenez des informations historiques sur les prix pour n'importe quel marché. +- **Prêt pour l'automatisation :** créez des agents ou des outils qui réagissent de manière programmatique aux développements du marché, aux changements de cotes ou aux résultats d'événements spécifiques. + +En utilisant ces points de terminaison API documentés, vous pouvez intégrer de manière transparente les riches données des marchés prédictifs on-chain de Polymarket dans vos propres flux de travail d'IA, tableaux de bord, outils de recherche et automatisations de trading. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez les marchés prédictifs de Polymarket dans le flux de travail. Peut obtenir les marchés, le marché, les événements, l'événement, les tags, les séries, le carnet d'ordres, le prix, le point médian, l'historique des prix, le dernier prix de transaction, l'écart, la taille du tick, les positions, les transactions et effectuer des recherches. + +## Outils + +### `polymarket_get_markets` + +Récupérer une liste des marchés prédictifs de Polymarket avec filtrage optionnel + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `closed` | chaîne | Non | Filtrer par statut fermé \(true/false\). Utilisez false pour les marchés actifs uniquement. | +| `order` | chaîne | Non | Champ de tri \(ex. id, volume, liquidity\) | +| `ascending` | chaîne | Non | Direction de tri \(true pour ascendant, false pour descendant\) | +| `tagId` | chaîne | Non | Filtrer par ID de tag | +| `limit` | chaîne | Non | Nombre de résultats par page \(recommandé : 25-50\) | +| `offset` | chaîne | Non | Décalage de pagination \(ignorer ce nombre de résultats\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données des marchés et métadonnées | + +### `polymarket_get_market` + +Récupérer les détails d'un marché prédictif spécifique par ID ou slug + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `marketId` | chaîne | Non | L'ID du marché. Obligatoire si le slug n'est pas fourni. | +| `slug` | chaîne | Non | Le slug du marché \(ex. "will-trump-win"\). Obligatoire si marketId n'est pas fourni. | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de marché et métadonnées | + +### `polymarket_get_events` + +Récupérer une liste d'événements de Polymarket avec filtrage optionnel + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `closed` | string | Non | Filtrer par statut fermé \(true/false\). Utilisez false pour les événements actifs uniquement. | +| `order` | string | Non | Champ de tri \(ex. : id, volume\) | +| `ascending` | string | Non | Direction de tri \(true pour ascendant, false pour descendant\) | +| `tagId` | string | Non | Filtrer par ID de tag | +| `limit` | string | Non | Nombre de résultats par page \(recommandé : 25-50\) | +| `offset` | string | Non | Décalage de pagination \(ignorer ce nombre de résultats\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données d'événements et métadonnées | + +### `polymarket_get_event` + +Récupérer les détails d'un événement spécifique par ID ou slug + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `eventId` | string | Non | L'ID de l'événement. Obligatoire si le slug n'est pas fourni. | +| `slug` | string | Non | Le slug de l'événement \(ex. : "2024-presidential-election"\). Obligatoire si eventId n'est pas fourni. | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées de l'événement | + +### `polymarket_get_tags` + +Récupérer les tags disponibles pour filtrer les marchés sur Polymarket + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `limit` | string | Non | Nombre de résultats par page \(recommandé : 25-50\) | +| `offset` | string | Non | Décalage de pagination \(ignorer ce nombre de résultats\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées des tags | + +### `polymarket_search` + +Rechercher des marchés, des événements et des profils sur Polymarket + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `query` | string | Oui | Terme de recherche | +| `limit` | string | Non | Nombre de résultats par page \(recommandé : 25-50\) | +| `offset` | string | Non | Décalage de pagination \(ignorer ce nombre de résultats\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Résultats de recherche et métadonnées | + +### `polymarket_get_series` + +Récupérer des séries (groupes de marchés liés) depuis Polymarket + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `limit` | string | Non | Nombre de résultats par page \(recommandé : 25-50\) | +| `offset` | string | Non | Décalage de pagination \(ignorer ce nombre de résultats\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées de la série | + +### `polymarket_get_series_by_id` + +Récupérer une série spécifique (groupe de marché associé) par ID depuis Polymarket + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `seriesId` | string | Oui | L'ID de la série | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées de la série | + +### `polymarket_get_orderbook` + +Récupérer le résumé du carnet d'ordres pour un jeton spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `tokenId` | string | Oui | L'ID du jeton CLOB (provenant des clobTokenIds du marché) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées du carnet d'ordres | + +### `polymarket_get_price` + +Récupérer le prix du marché pour un jeton et un côté spécifiques + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `tokenId` | string | Oui | L'ID du jeton CLOB (provenant des clobTokenIds du marché) | +| `side` | string | Oui | Côté de l'ordre : achat ou vente | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de prix et métadonnées | + +### `polymarket_get_midpoint` + +Récupérer le prix médian pour un jeton spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Oui | L'ID du jeton CLOB (depuis market clobTokenIds) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de prix médian et métadonnées | + +### `polymarket_get_price_history` + +Récupérer les données historiques de prix pour un jeton de marché spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Oui | L'ID du jeton CLOB (depuis market clobTokenIds) | +| `interval` | string | Non | Durée se terminant au moment actuel (1m, 1h, 6h, 1d, 1w, max). Mutuellement exclusif avec startTs/endTs. | +| `fidelity` | number | Non | Résolution des données en minutes (par ex., 60 pour horaire) | +| `startTs` | number | Non | Horodatage de début (secondes Unix UTC) | +| `endTs` | number | Non | Horodatage de fin (secondes Unix UTC) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données d'historique de prix et métadonnées | + +### `polymarket_get_last_trade_price` + +Récupérer le dernier prix de transaction pour un jeton spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Oui | L'ID du jeton CLOB (depuis market clobTokenIds) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Dernier prix de transaction et métadonnées | + +### `polymarket_get_spread` + +Récupérer l'écart entre l'offre et la demande pour un jeton spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Oui | L'ID du jeton CLOB (depuis market clobTokenIds) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données d'écart et métadonnées | + +### `polymarket_get_tick_size` + +Récupérer la taille minimale du tick pour un jeton spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | Oui | L'ID du jeton CLOB (depuis market clobTokenIds) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Taille du tick et métadonnées | + +### `polymarket_get_positions` + +Récupérer les positions de l'utilisateur depuis Polymarket + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `user` | string | Oui | Adresse du portefeuille de l'utilisateur | +| `market` | string | Non | ID de marché optionnel pour filtrer les positions | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données des positions et métadonnées | + +### `polymarket_get_trades` + +Récupérer l'historique des transactions depuis Polymarket + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `user` | string | Non | Adresse du portefeuille de l'utilisateur pour filtrer les transactions | +| `market` | string | Non | ID de marché pour filtrer les transactions | +| `limit` | string | Non | Nombre de résultats par page \(recommandé : 25-50\) | +| `offset` | string | Non | Décalage de pagination \(ignorer ce nombre de résultats\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données des transactions et métadonnées | + +## Notes + +- Catégorie : `tools` +- Type : `polymarket` diff --git a/apps/docs/content/docs/fr/tools/pylon.mdx b/apps/docs/content/docs/fr/tools/pylon.mdx index 8db52a1d9..994a8b3c7 100644 --- a/apps/docs/content/docs/fr/tools/pylon.mdx +++ b/apps/docs/content/docs/fr/tools/pylon.mdx @@ -81,12 +81,19 @@ Créer un nouveau problème avec les propriétés spécifiées #### Entrée | Paramètre | Type | Obligatoire | Description | -| --------- | ---- | ----------- | ----------- | -| `apiToken` | chaîne | Oui | Jeton API Pylon | -| `title` | chaîne | Oui | Titre du problème | -| `bodyHtml` | chaîne | Oui | Corps du problème au format HTML | -| `accountId` | chaîne | Non | ID du compte à associer au problème | -| `assigneeId` | chaîne | Non | ID de l'utilisateur à qui attribuer le problème | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `title` | string | Oui | Titre du problème | +| `bodyHtml` | string | Oui | Corps du problème au format HTML | +| `accountId` | string | Non | ID du compte à associer au problème | +| `assigneeId` | string | Non | ID de l'utilisateur à qui assigner le problème | +| `teamId` | string | Non | ID de l'équipe à qui assigner le problème | +| `requesterId` | string | Non | ID de l'utilisateur demandeur \(alternative à requester_email\) | +| `requesterEmail` | string | Non | Adresse e-mail du demandeur \(alternative à requester_id\) | +| `priority` | string | Non | Priorité du problème | +| `tags` | string | Non | IDs de tags séparés par des virgules | +| `customFields` | string | Non | Champs personnalisés sous forme d'objet JSON | +| `attachmentUrls` | string | Non | URLs des pièces jointes séparées par des virgules | #### Sortie @@ -124,10 +131,13 @@ Mettre à jour un problème existant | `apiToken` | string | Oui | Jeton API Pylon | | `issueId` | string | Oui | L'ID du problème à mettre à jour | | `state` | string | Non | État du problème | -| `assigneeId` | string | Non | ID utilisateur à qui assigner le problème | -| `teamId` | string | Non | ID d'équipe à qui assigner le problème | +| `assigneeId` | string | Non | ID de l'utilisateur à qui assigner le problème | +| `teamId` | string | Non | ID de l'équipe à qui assigner le problème | | `tags` | string | Non | IDs de tags séparés par des virgules | | `customFields` | string | Non | Champs personnalisés sous forme d'objet JSON | +| `customerPortalVisible` | boolean | Non | Indique si le problème est visible dans le portail client | +| `requesterId` | string | Non | ID de l'utilisateur demandeur | +| `accountId` | string | Non | ID du compte à associer au problème | #### Sortie diff --git a/apps/docs/content/docs/fr/tools/shopify.mdx b/apps/docs/content/docs/fr/tools/shopify.mdx new file mode 100644 index 000000000..16fa841bf --- /dev/null +++ b/apps/docs/content/docs/fr/tools/shopify.mdx @@ -0,0 +1,445 @@ +--- +title: Shopify +description: Gérez les produits, les commandes, les clients et l'inventaire dans + votre boutique Shopify +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Shopify](https://www.shopify.com/) est une plateforme e-commerce de premier plan conçue pour aider les marchands à construire, gérer et développer leurs boutiques en ligne. Shopify facilite la gestion de tous les aspects de votre boutique, des produits et de l'inventaire aux commandes et aux clients. + +Avec Shopify dans Sim, vos agents peuvent : + +- **Créer et gérer des produits** : ajouter de nouveaux produits, mettre à jour les détails des produits et supprimer des produits de votre boutique. +- **Lister et récupérer les commandes** : obtenir des informations sur les commandes des clients, y compris le filtrage et la gestion des commandes. +- **Gérer les clients** : accéder et mettre à jour les détails des clients, ou ajouter de nouveaux clients à votre boutique. +- **Ajuster les niveaux d'inventaire** : modifier par programmation les niveaux de stock des produits pour maintenir votre inventaire précis. + +Utilisez l'intégration Shopify de Sim pour automatiser les flux de travail courants de gestion de boutique — comme la synchronisation de l'inventaire, l'exécution des commandes ou la gestion des annonces — directement depuis vos automatisations. Donnez à vos agents les moyens d'accéder, de mettre à jour et d'organiser toutes les données de votre boutique à l'aide d'outils simples et programmatiques. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez Shopify dans votre flux de travail. Gérez les produits, les commandes, les clients et l'inventaire. Créez, lisez, mettez à jour et supprimez des produits. Listez et gérez les commandes. Traitez les données clients et ajustez les niveaux d'inventaire. + +## Outils + +### `shopify_create_product` + +Créer un nouveau produit dans votre boutique Shopify + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `title` | string | Oui | Titre du produit | +| `descriptionHtml` | string | Non | Description du produit \(HTML\) | +| `vendor` | string | Non | Fournisseur/marque du produit | +| `productType` | string | Non | Type/catégorie du produit | +| `tags` | array | Non | Tags du produit | +| `status` | string | Non | Statut du produit \(ACTIVE, DRAFT, ARCHIVED\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `product` | object | Le produit créé | + +### `shopify_get_product` + +Obtenir un produit unique par ID depuis votre boutique Shopify + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `productId` | string | Oui | ID du produit \(gid://shopify/Product/123456789\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `product` | object | Les détails du produit | + +### `shopify_list_products` + +Lister les produits de votre boutique Shopify avec filtrage optionnel + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `first` | number | Non | Nombre de produits à retourner \(par défaut : 50, max : 250\) | +| `query` | string | Non | Requête de recherche pour filtrer les produits \(ex., "title:chemise" ou "vendor:Nike" ou "status:active"\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `products` | array | Liste des produits | +| `pageInfo` | object | Informations de pagination | + +### `shopify_update_product` + +Mettre à jour un produit existant dans votre boutique Shopify + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `productId` | string | Oui | ID du produit à mettre à jour \(gid://shopify/Product/123456789\) | +| `title` | string | Non | Nouveau titre du produit | +| `descriptionHtml` | string | Non | Nouvelle description du produit \(HTML\) | +| `vendor` | string | Non | Nouveau fournisseur/marque du produit | +| `productType` | string | Non | Nouveau type/catégorie du produit | +| `tags` | array | Non | Nouvelles étiquettes du produit | +| `status` | string | Non | Nouveau statut du produit \(ACTIVE, DRAFT, ARCHIVED\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `product` | objet | Le produit mis à jour | + +### `shopify_delete_product` + +Supprimer un produit de votre boutique Shopify + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex. : maboutique.myshopify.com\) | +| `productId` | chaîne | Oui | ID du produit à supprimer \(gid://shopify/Product/123456789\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `deletedId` | chaîne | L'ID du produit supprimé | + +### `shopify_get_order` + +Obtenir une commande spécifique par ID depuis votre boutique Shopify + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex. : maboutique.myshopify.com\) | +| `orderId` | chaîne | Oui | ID de la commande \(gid://shopify/Order/123456789\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `order` | objet | Les détails de la commande | + +### `shopify_list_orders` + +Lister les commandes de votre boutique Shopify avec filtrage optionnel + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex. : maboutique.myshopify.com\) | +| `first` | nombre | Non | Nombre de commandes à retourner \(par défaut : 50, max : 250\) | +| `status` | chaîne | Non | Filtrer par statut de commande \(open, closed, cancelled, any\) | +| `query` | chaîne | Non | Requête de recherche pour filtrer les commandes \(ex. : "financial_status:paid" ou "fulfillment_status:unfulfilled" ou "email:customer@example.com"\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `orders` | array | Liste des commandes | +| `pageInfo` | object | Informations de pagination | + +### `shopify_update_order` + +Mettre à jour une commande existante dans votre boutique Shopify (note, tags, email) + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `orderId` | string | Oui | ID de la commande à mettre à jour \(gid://shopify/Order/123456789\) | +| `note` | string | Non | Nouvelle note de commande | +| `tags` | array | Non | Nouveaux tags de commande | +| `email` | string | Non | Nouvel email client pour la commande | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `order` | object | La commande mise à jour | + +### `shopify_cancel_order` + +Annuler une commande dans votre boutique Shopify + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `orderId` | string | Oui | ID de la commande à annuler \(gid://shopify/Order/123456789\) | +| `reason` | string | Oui | Motif d'annulation \(CUSTOMER, DECLINED, FRAUD, INVENTORY, STAFF, OTHER\) | +| `notifyCustomer` | boolean | Non | Indique s'il faut informer le client de l'annulation | +| `refund` | boolean | Non | Indique s'il faut rembourser la commande | +| `restock` | boolean | Non | Indique s'il faut réapprovisionner le stock | +| `staffNote` | string | Non | Une note sur l'annulation pour référence interne | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `order` | objet | Le résultat de l'annulation | + +### `shopify_create_customer` + +Créer un nouveau client dans votre boutique Shopify + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `email` | chaîne | Non | Adresse e-mail du client | +| `firstName` | chaîne | Non | Prénom du client | +| `lastName` | chaîne | Non | Nom de famille du client | +| `phone` | chaîne | Non | Numéro de téléphone du client | +| `note` | chaîne | Non | Note concernant le client | +| `tags` | tableau | Non | Tags du client | +| `addresses` | tableau | Non | Adresses du client | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `customer` | objet | Le client créé | + +### `shopify_get_customer` + +Obtenir un client unique par ID depuis votre boutique Shopify + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `customerId` | chaîne | Oui | ID du client \(gid://shopify/Customer/123456789\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `customer` | objet | Les détails du client | + +### `shopify_list_customers` + +Listez les clients de votre boutique Shopify avec filtrage optionnel + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex. : maboutique.myshopify.com\) | +| `first` | nombre | Non | Nombre de clients à retourner \(par défaut : 50, max : 250\) | +| `query` | chaîne | Non | Requête de recherche pour filtrer les clients \(ex. : "first_name:John" ou "last_name:Smith" ou "email:*@gmail.com" ou "tag:vip"\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `customers` | tableau | Liste des clients | +| `pageInfo` | objet | Informations de pagination | + +### `shopify_update_customer` + +Mettre à jour un client existant dans votre boutique Shopify + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex. : maboutique.myshopify.com\) | +| `customerId` | chaîne | Oui | ID du client à mettre à jour \(gid://shopify/Customer/123456789\) | +| `email` | chaîne | Non | Nouvelle adresse e-mail du client | +| `firstName` | chaîne | Non | Nouveau prénom du client | +| `lastName` | chaîne | Non | Nouveau nom de famille du client | +| `phone` | chaîne | Non | Nouveau numéro de téléphone du client | +| `note` | chaîne | Non | Nouvelle note concernant le client | +| `tags` | tableau | Non | Nouvelles étiquettes du client | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `customer` | objet | Le client mis à jour | + +### `shopify_delete_customer` + +Supprimer un client de votre boutique Shopify + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `customerId` | chaîne | Oui | ID du client à supprimer \(gid://shopify/Customer/123456789\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `deletedId` | chaîne | L'ID du client supprimé | + +### `shopify_list_inventory_items` + +Lister les articles d'inventaire de votre boutique Shopify. Utilisez cette fonction pour trouver les ID d'articles d'inventaire par SKU. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `first` | nombre | Non | Nombre d'articles d'inventaire à retourner \(par défaut : 50, max : 250\) | +| `query` | chaîne | Non | Requête de recherche pour filtrer les articles d'inventaire \(ex., "sku:ABC123"\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `inventoryItems` | tableau | Liste des articles d'inventaire avec leurs ID, SKU et niveaux de stock | +| `pageInfo` | objet | Informations de pagination | + +### `shopify_get_inventory_level` + +Obtenir le niveau d'inventaire pour une variante de produit à un emplacement spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `inventoryItemId` | chaîne | Oui | ID de l'article d'inventaire \(gid://shopify/InventoryItem/123456789\) | +| `locationId` | chaîne | Non | ID de l'emplacement pour filtrer \(facultatif\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `inventoryLevel` | objet | Les détails du niveau d'inventaire | + +### `shopify_adjust_inventory` + +Ajuster la quantité d'inventaire pour une variante de produit à un emplacement spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `inventoryItemId` | chaîne | Oui | ID de l'article d'inventaire \(gid://shopify/InventoryItem/123456789\) | +| `locationId` | chaîne | Oui | ID de l'emplacement \(gid://shopify/Location/123456789\) | +| `delta` | nombre | Oui | Montant à ajuster \(positif pour augmenter, négatif pour diminuer\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `inventoryLevel` | objet | Le résultat de l'ajustement d'inventaire | + +### `shopify_list_locations` + +Lister les emplacements d'inventaire de votre boutique Shopify. Utilisez ceci pour trouver les ID d'emplacement nécessaires pour les opérations d'inventaire. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `first` | nombre | Non | Nombre d'emplacements à retourner \(par défaut : 50, max : 250\) | +| `includeInactive` | booléen | Non | Inclure ou non les emplacements désactivés \(par défaut : false\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `locations` | tableau | Liste des emplacements avec leurs ID, noms et adresses | +| `pageInfo` | objet | Informations de pagination | + +### `shopify_create_fulfillment` + +Créez un traitement pour marquer les articles de commande comme expédiés. Nécessite un ID de commande de traitement (obtenez-le à partir des détails de la commande). + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `fulfillmentOrderId` | chaîne | Oui | L'ID de commande de traitement \(ex., gid://shopify/FulfillmentOrder/123456789\) | +| `trackingNumber` | chaîne | Non | Numéro de suivi pour l'expédition | +| `trackingCompany` | chaîne | Non | Nom du transporteur \(ex., UPS, FedEx, USPS, DHL\) | +| `trackingUrl` | chaîne | Non | URL pour suivre l'expédition | +| `notifyCustomer` | booléen | Non | Indique s'il faut envoyer un e-mail de confirmation d'expédition au client \(par défaut : true\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `fulfillment` | objet | Le traitement créé avec les informations de suivi et les articles traités | + +### `shopify_list_collections` + +Listez les collections de produits de votre boutique Shopify. Filtrez par titre, type (personnalisé/intelligent) ou identifiant. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `first` | nombre | Non | Nombre de collections à retourner \(par défaut : 50, max : 250\) | +| `query` | chaîne | Non | Requête de recherche pour filtrer les collections \(ex., "title:Été" ou "collection_type:smart"\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `collections` | tableau | Liste des collections avec leurs IDs, titres et nombre de produits | +| `pageInfo` | objet | Informations de pagination | + +### `shopify_get_collection` + +Obtenez une collection spécifique par ID, y compris ses produits. Utilisez ceci pour récupérer les produits au sein d'une collection. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `shopDomain` | chaîne | Oui | Le domaine de votre boutique Shopify \(ex., maboutique.myshopify.com\) | +| `collectionId` | chaîne | Oui | L'ID de la collection \(ex., gid://shopify/Collection/123456789\) | +| `productsFirst` | nombre | Non | Nombre de produits à retourner de cette collection \(par défaut : 50, max : 250\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `collection` | objet | Les détails de la collection incluant ses produits | + +## Remarques + +- Catégorie : `tools` +- Type : `shopify` diff --git a/apps/docs/content/docs/fr/tools/ssh.mdx b/apps/docs/content/docs/fr/tools/ssh.mdx new file mode 100644 index 000000000..0b2b58466 --- /dev/null +++ b/apps/docs/content/docs/fr/tools/ssh.mdx @@ -0,0 +1,394 @@ +--- +title: SSH +description: Connectez-vous aux serveurs distants via SSH +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[SSH (Secure Shell)](https://en.wikipedia.org/wiki/Secure_Shell) est un protocole largement utilisé pour se connecter de manière sécurisée à des serveurs distants, vous permettant d'exécuter des commandes, de transférer des fichiers et de gérer des systèmes via des canaux chiffrés. + +Avec la prise en charge SSH dans Sim, vos agents peuvent : + +- **Exécuter des commandes à distance** : lancer des commandes shell sur n'importe quel serveur accessible via SSH +- **Télécharger et exécuter des scripts** : transférer et exécuter facilement des scripts multi-lignes pour une automatisation avancée +- **Transférer des fichiers en toute sécurité** : télécharger et téléverser des fichiers dans le cadre de vos flux de travail (bientôt disponible ou via commande) +- **Automatiser la gestion des serveurs** : effectuer des mises à jour, de la maintenance, de la surveillance, des déploiements et des tâches de configuration de manière programmatique +- **Utiliser une authentification flexible** : se connecter avec une authentification par mot de passe ou par clé privée, y compris la prise en charge des clés chiffrées + +Les outils SSH Sim suivants permettent à vos agents d'interagir avec les serveurs dans le cadre d'automatisations plus larges : + +- `ssh_execute_command` : exécuter n'importe quelle commande shell à distance et capturer la sortie, le statut et les erreurs. +- `ssh_execute_script` : téléverser et exécuter un script complet multi-lignes sur le système distant. +- (D'autres outils seront bientôt disponibles, comme le transfert de fichiers.) + +En intégrant SSH dans vos flux de travail d'agents, vous pouvez automatiser l'accès sécurisé, les opérations à distance et l'orchestration de serveurs—simplifiant ainsi DevOps, l'automatisation informatique et la gestion à distance personnalisée, le tout depuis Sim. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Exécutez des commandes, transférez des fichiers et gérez des serveurs distants via SSH. Prend en charge l'authentification par mot de passe et par clé privée pour un accès sécurisé aux serveurs. + +## Outils + +### `ssh_execute_command` + +Exécuter une commande shell sur un serveur SSH distant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `host` | string | Oui | Nom d'hôte ou adresse IP du serveur SSH | +| `port` | number | Oui | Port du serveur SSH \(par défaut : 22\) | +| `username` | string | Oui | Nom d'utilisateur SSH | +| `password` | string | Non | Mot de passe pour l'authentification \(si vous n'utilisez pas de clé privée\) | +| `privateKey` | string | Non | Clé privée pour l'authentification \(format OpenSSH\) | +| `passphrase` | string | Non | Phrase secrète pour la clé privée chiffrée | +| `command` | string | Oui | Commande shell à exécuter sur le serveur distant | +| `workingDirectory` | string | Non | Répertoire de travail pour l'exécution de la commande | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `stdout` | string | Sortie standard de la commande | +| `stderr` | string | Sortie d'erreur standard | +| `exitCode` | number | Code de sortie de la commande | +| `success` | boolean | Si la commande a réussi \(code de sortie 0\) | +| `message` | string | Message d'état de l'opération | + +### `ssh_execute_script` + +Télécharger et exécuter un script multi-lignes sur un serveur SSH distant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `host` | string | Oui | Nom d'hôte ou adresse IP du serveur SSH | +| `port` | number | Oui | Port du serveur SSH \(par défaut : 22\) | +| `username` | string | Oui | Nom d'utilisateur SSH | +| `password` | string | Non | Mot de passe pour l'authentification \(si vous n'utilisez pas de clé privée\) | +| `privateKey` | string | Non | Clé privée pour l'authentification \(format OpenSSH\) | +| `passphrase` | string | Non | Phrase secrète pour la clé privée chiffrée | +| `script` | string | Oui | Contenu du script à exécuter \(bash, python, etc.\) | +| `interpreter` | string | Non | Interpréteur de script \(par défaut : /bin/bash\) | +| `workingDirectory` | string | Non | Répertoire de travail pour l'exécution du script | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `stdout` | string | Sortie standard du script | +| `stderr` | string | Sortie d'erreur standard | +| `exitCode` | number | Code de sortie du script | +| `success` | boolean | Si le script a réussi \(code de sortie 0\) | +| `scriptPath` | string | Chemin temporaire où le script a été téléchargé | +| `message` | string | Message d'état de l'opération | + +### `ssh_check_command_exists` + +Vérifier si une commande/un programme existe sur le serveur SSH distant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `host` | chaîne | Oui | Nom d'hôte ou adresse IP du serveur SSH | +| `port` | nombre | Oui | Port du serveur SSH \(par défaut : 22\) | +| `username` | chaîne | Oui | Nom d'utilisateur SSH | +| `password` | chaîne | Non | Mot de passe pour l'authentification \(si vous n'utilisez pas de clé privée\) | +| `privateKey` | chaîne | Non | Clé privée pour l'authentification \(format OpenSSH\) | +| `passphrase` | chaîne | Non | Phrase secrète pour la clé privée chiffrée | +| `commandName` | chaîne | Oui | Nom de la commande à vérifier \(ex. docker, git, python3\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `commandExists` | booléen | Indique si la commande existe | +| `commandPath` | chaîne | Chemin complet vers la commande \(si trouvée\) | +| `version` | chaîne | Sortie de la version de la commande \(si applicable\) | +| `message` | chaîne | Message d'état de l'opération | + +### `ssh_upload_file` + +Téléverser un fichier vers un serveur SSH distant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `host` | chaîne | Oui | Nom d'hôte ou adresse IP du serveur SSH | +| `port` | nombre | Oui | Port du serveur SSH \(par défaut : 22\) | +| `username` | chaîne | Oui | Nom d'utilisateur SSH | +| `password` | chaîne | Non | Mot de passe pour l'authentification \(si vous n'utilisez pas de clé privée\) | +| `privateKey` | chaîne | Non | Clé privée pour l'authentification \(format OpenSSH\) | +| `passphrase` | chaîne | Non | Phrase secrète pour la clé privée chiffrée | +| `fileContent` | chaîne | Oui | Contenu du fichier à téléverser \(encodé en base64 pour les fichiers binaires\) | +| `fileName` | chaîne | Oui | Nom du fichier à téléverser | +| `remotePath` | chaîne | Oui | Chemin de destination sur le serveur distant | +| `permissions` | chaîne | Non | Permissions du fichier \(ex. 0644\) | +| `overwrite` | booléen | Non | Indique s'il faut écraser les fichiers existants \(par défaut : true\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `uploaded` | boolean | Indique si le fichier a été téléversé avec succès | +| `remotePath` | string | Chemin final sur le serveur distant | +| `size` | number | Taille du fichier en octets | +| `message` | string | Message d'état de l'opération | + +### `ssh_download_file` + +Télécharger un fichier depuis un serveur SSH distant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `host` | string | Oui | Nom d'hôte ou adresse IP du serveur SSH | +| `port` | number | Oui | Port du serveur SSH \(par défaut : 22\) | +| `username` | string | Oui | Nom d'utilisateur SSH | +| `password` | string | Non | Mot de passe pour l'authentification \(si vous n'utilisez pas de clé privée\) | +| `privateKey` | string | Non | Clé privée pour l'authentification \(format OpenSSH\) | +| `passphrase` | string | Non | Phrase secrète pour la clé privée chiffrée | +| `remotePath` | string | Oui | Chemin du fichier sur le serveur distant | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `downloaded` | boolean | Indique si le fichier a été téléchargé avec succès | +| `fileContent` | string | Contenu du fichier \(encodé en base64 pour les fichiers binaires\) | +| `fileName` | string | Nom du fichier téléchargé | +| `remotePath` | string | Chemin source sur le serveur distant | +| `size` | number | Taille du fichier en octets | +| `message` | string | Message d'état de l'opération | + +### `ssh_list_directory` + +Lister les fichiers et répertoires dans un répertoire distant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `host` | chaîne | Oui | Nom d'hôte ou adresse IP du serveur SSH | +| `port` | nombre | Oui | Port du serveur SSH (par défaut : 22) | +| `username` | chaîne | Oui | Nom d'utilisateur SSH | +| `password` | chaîne | Non | Mot de passe pour l'authentification (si vous n'utilisez pas de clé privée) | +| `privateKey` | chaîne | Non | Clé privée pour l'authentification (format OpenSSH) | +| `passphrase` | chaîne | Non | Phrase secrète pour la clé privée chiffrée | +| `path` | chaîne | Oui | Chemin du répertoire distant à lister | +| `detailed` | booléen | Non | Inclure les détails des fichiers (taille, permissions, date de modification) | +| `recursive` | booléen | Non | Lister les sous-répertoires de manière récursive (par défaut : false) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `entries` | tableau | Tableau des entrées de fichiers et de répertoires | + +### `ssh_check_file_exists` + +Vérifier si un fichier ou un répertoire existe sur le serveur SSH distant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `host` | chaîne | Oui | Nom d'hôte ou adresse IP du serveur SSH | +| `port` | nombre | Oui | Port du serveur SSH (par défaut : 22) | +| `username` | chaîne | Oui | Nom d'utilisateur SSH | +| `password` | chaîne | Non | Mot de passe pour l'authentification (si vous n'utilisez pas de clé privée) | +| `privateKey` | chaîne | Non | Clé privée pour l'authentification (format OpenSSH) | +| `passphrase` | chaîne | Non | Phrase secrète pour la clé privée chiffrée | +| `path` | chaîne | Oui | Chemin du fichier ou du répertoire distant à vérifier | +| `type` | chaîne | Non | Type attendu : fichier, répertoire ou n'importe lequel (par défaut : n'importe lequel) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `exists` | boolean | Indique si le chemin existe | +| `type` | string | Type de chemin (fichier, répertoire, lien symbolique, non_trouvé) | +| `size` | number | Taille du fichier s'il s'agit d'un fichier | +| `permissions` | string | Permissions du fichier (ex. 0755) | +| `modified` | string | Horodatage de dernière modification | +| `message` | string | Message d'état de l'opération | + +### `ssh_create_directory` + +Créer un répertoire sur le serveur SSH distant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `host` | string | Oui | Nom d'hôte ou adresse IP du serveur SSH | +| `port` | number | Oui | Port du serveur SSH (par défaut : 22) | +| `username` | string | Oui | Nom d'utilisateur SSH | +| `password` | string | Non | Mot de passe pour l'authentification (si vous n'utilisez pas de clé privée) | +| `privateKey` | string | Non | Clé privée pour l'authentification (format OpenSSH) | +| `passphrase` | string | Non | Phrase secrète pour la clé privée chiffrée | +| `path` | string | Oui | Chemin du répertoire à créer | +| `recursive` | boolean | Non | Créer les répertoires parents s'ils n'existent pas (par défaut : true) | +| `permissions` | string | Non | Permissions du répertoire (par défaut : 0755) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `created` | boolean | Indique si le répertoire a été créé avec succès | +| `remotePath` | string | Chemin du répertoire créé | +| `alreadyExists` | boolean | Indique si le répertoire existait déjà | +| `message` | string | Message d'état de l'opération | + +### `ssh_delete_file` + +Supprimer un fichier ou un répertoire du serveur SSH distant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `host` | string | Oui | Nom d'hôte ou adresse IP du serveur SSH | +| `port` | number | Oui | Port du serveur SSH \(par défaut : 22\) | +| `username` | string | Oui | Nom d'utilisateur SSH | +| `password` | string | Non | Mot de passe pour l'authentification \(si vous n'utilisez pas de clé privée\) | +| `privateKey` | string | Non | Clé privée pour l'authentification \(format OpenSSH\) | +| `passphrase` | string | Non | Phrase secrète pour la clé privée chiffrée | +| `path` | string | Oui | Chemin à supprimer | +| `recursive` | boolean | Non | Supprimer récursivement les répertoires \(par défaut : false\) | +| `force` | boolean | Non | Forcer la suppression sans confirmation \(par défaut : false\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `deleted` | boolean | Indique si le chemin a été supprimé avec succès | +| `remotePath` | string | Chemin supprimé | +| `message` | string | Message d'état de l'opération | + +### `ssh_move_rename` + +Déplacer ou renommer un fichier ou un répertoire sur le serveur SSH distant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `host` | string | Oui | Nom d'hôte ou adresse IP du serveur SSH | +| `port` | number | Oui | Port du serveur SSH \(par défaut : 22\) | +| `username` | string | Oui | Nom d'utilisateur SSH | +| `password` | string | Non | Mot de passe pour l'authentification \(si vous n'utilisez pas de clé privée\) | +| `privateKey` | string | Non | Clé privée pour l'authentification \(format OpenSSH\) | +| `passphrase` | string | Non | Phrase secrète pour la clé privée chiffrée | +| `sourcePath` | string | Oui | Chemin actuel du fichier ou du répertoire | +| `destinationPath` | string | Oui | Nouveau chemin pour le fichier ou le répertoire | +| `overwrite` | boolean | Non | Écraser la destination si elle existe \(par défaut : false\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `moved` | boolean | Indique si l'opération a réussi | +| `sourcePath` | string | Chemin d'origine | +| `destinationPath` | string | Nouveau chemin | +| `message` | string | Message d'état de l'opération | + +### `ssh_get_system_info` + +Récupérer les informations système du serveur SSH distant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `host` | string | Oui | Nom d'hôte ou adresse IP du serveur SSH | +| `port` | number | Oui | Port du serveur SSH \(par défaut : 22\) | +| `username` | string | Oui | Nom d'utilisateur SSH | +| `password` | string | Non | Mot de passe pour l'authentification \(si vous n'utilisez pas de clé privée\) | +| `privateKey` | string | Non | Clé privée pour l'authentification \(format OpenSSH\) | +| `passphrase` | string | Non | Phrase secrète pour la clé privée chiffrée | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `hostname` | string | Nom d'hôte du serveur | +| `os` | string | Système d'exploitation \(ex. : Linux, Darwin\) | +| `architecture` | string | Architecture CPU \(ex. : x64, arm64\) | +| `uptime` | number | Temps de fonctionnement du système en secondes | +| `memory` | json | Informations sur la mémoire \(totale, libre, utilisée\) | +| `diskSpace` | json | Informations sur l'espace disque \(total, libre, utilisé\) | +| `message` | string | Message d'état de l'opération | + +### `ssh_read_file_content` + +Lire le contenu d'un fichier distant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `host` | chaîne | Oui | Nom d'hôte ou adresse IP du serveur SSH | +| `port` | nombre | Oui | Port du serveur SSH \(par défaut : 22\) | +| `username` | chaîne | Oui | Nom d'utilisateur SSH | +| `password` | chaîne | Non | Mot de passe pour l'authentification \(si vous n'utilisez pas de clé privée\) | +| `privateKey` | chaîne | Non | Clé privée pour l'authentification \(format OpenSSH\) | +| `passphrase` | chaîne | Non | Phrase secrète pour la clé privée chiffrée | +| `path` | chaîne | Oui | Chemin du fichier distant à lire | +| `encoding` | chaîne | Non | Encodage du fichier \(par défaut : utf-8\) | +| `maxSize` | nombre | Non | Taille maximale du fichier à lire en Mo \(par défaut : 10\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `content` | chaîne | Contenu du fichier sous forme de chaîne | +| `size` | nombre | Taille du fichier en octets | +| `lines` | nombre | Nombre de lignes dans le fichier | +| `remotePath` | chaîne | Chemin du fichier distant | +| `message` | chaîne | Message d'état de l'opération | + +### `ssh_write_file_content` + +Écrire ou ajouter du contenu à un fichier distant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `host` | chaîne | Oui | Nom d'hôte ou adresse IP du serveur SSH | +| `port` | nombre | Oui | Port du serveur SSH \(par défaut : 22\) | +| `username` | chaîne | Oui | Nom d'utilisateur SSH | +| `password` | chaîne | Non | Mot de passe pour l'authentification \(si vous n'utilisez pas de clé privée\) | +| `privateKey` | chaîne | Non | Clé privée pour l'authentification \(format OpenSSH\) | +| `passphrase` | chaîne | Non | Phrase secrète pour la clé privée chiffrée | +| `path` | chaîne | Oui | Chemin du fichier distant où écrire | +| `content` | chaîne | Oui | Contenu à écrire dans le fichier | +| `mode` | chaîne | Non | Mode d'écriture : overwrite, append, ou create \(par défaut : overwrite\) | +| `permissions` | chaîne | Non | Permissions du fichier \(ex. : 0644\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `written` | boolean | Indique si le fichier a été écrit avec succès | +| `remotePath` | string | Chemin du fichier | +| `size` | number | Taille finale du fichier en octets | +| `message` | string | Message d'état de l'opération | + +## Notes + +- Catégorie : `tools` +- Type : `ssh` diff --git a/apps/docs/content/docs/fr/tools/wordpress.mdx b/apps/docs/content/docs/fr/tools/wordpress.mdx new file mode 100644 index 000000000..74f31849b --- /dev/null +++ b/apps/docs/content/docs/fr/tools/wordpress.mdx @@ -0,0 +1,566 @@ +--- +title: WordPress +description: Gérer le contenu WordPress +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[WordPress](https://wordpress.org/) est le système de gestion de contenu open-source le plus utilisé au monde, facilitant la publication et la gestion de sites web, blogs et tous types de contenus en ligne. Avec WordPress, vous pouvez créer et mettre à jour des articles ou des pages, organiser votre contenu avec des catégories et des étiquettes, gérer des fichiers multimédias, modérer des commentaires et gérer des comptes utilisateurs, vous permettant ainsi de faire fonctionner aussi bien des blogs personnels que des sites d'entreprise complexes. + +L'intégration de Sim avec WordPress permet à vos agents d'automatiser des tâches essentielles du site web. Vous pouvez créer par programmation de nouveaux articles de blog avec des titres, contenus, catégories, étiquettes et images à la une spécifiques. La mise à jour d'articles existants (comme la modification de leur contenu, titre ou statut de publication) est simple. Vous pouvez également publier ou enregistrer du contenu comme brouillon, gérer des pages statiques, travailler avec des téléchargements de médias, superviser les commentaires et attribuer du contenu aux taxonomies organisationnelles pertinentes. + +En connectant WordPress à vos automatisations, Sim permet à vos agents de rationaliser la publication de contenu, les flux de travail éditoriaux et la gestion quotidienne du site, vous aidant ainsi à maintenir votre site web à jour, organisé et sécurisé sans effort manuel. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez avec WordPress pour créer, mettre à jour et gérer des articles, pages, médias, commentaires, catégories, étiquettes et utilisateurs. Prend en charge les sites WordPress.com via OAuth et les sites WordPress auto-hébergés en utilisant l'authentification par mots de passe d'application. + +## Outils + +### `wordpress_create_post` + +Créer un nouvel article de blog sur WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | chaîne | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `title` | chaîne | Oui | Titre de l'article | +| `content` | chaîne | Non | Contenu de l'article \(HTML ou texte brut\) | +| `status` | chaîne | Non | Statut de l'article : publish, draft, pending, private, ou future | +| `excerpt` | chaîne | Non | Extrait de l'article | +| `categories` | chaîne | Non | IDs de catégories séparés par des virgules | +| `tags` | chaîne | Non | IDs d'étiquettes séparés par des virgules | +| `featuredMedia` | nombre | Non | ID du média de l'image à la une | +| `slug` | chaîne | Non | Slug URL pour l'article | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `post` | object | L'article créé | + +### `wordpress_update_post` + +Mettre à jour un article de blog existant sur WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `postId` | number | Oui | L'ID de l'article à mettre à jour | +| `title` | string | Non | Titre de l'article | +| `content` | string | Non | Contenu de l'article \(HTML ou texte brut\) | +| `status` | string | Non | Statut de l'article : publish, draft, pending, private, ou future | +| `excerpt` | string | Non | Extrait de l'article | +| `categories` | string | Non | IDs de catégories séparés par des virgules | +| `tags` | string | Non | IDs de tags séparés par des virgules | +| `featuredMedia` | number | Non | ID du média de l'image à la une | +| `slug` | string | Non | Slug URL pour l'article | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `post` | object | L'article mis à jour | + +### `wordpress_delete_post` + +Supprimer un article de blog de WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `postId` | number | Oui | L'ID de l'article à supprimer | +| `force` | boolean | Non | Contourner la corbeille et forcer la suppression définitive | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `deleted` | boolean | Indique si l'article a été supprimé | +| `post` | object | L'article supprimé | + +### `wordpress_get_post` + +Obtenir un seul article de blog WordPress.com par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine (par ex., 12345678 ou monsite.wordpress.com) | +| `postId` | number | Oui | L'ID de l'article à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `post` | object | L'article récupéré | + +### `wordpress_list_posts` + +Lister les articles de blog WordPress.com avec filtres optionnels + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine (par ex., 12345678 ou monsite.wordpress.com) | +| `perPage` | number | Non | Nombre d'articles par page (par défaut : 10, max : 100) | +| `page` | number | Non | Numéro de page pour la pagination | +| `status` | string | Non | Filtre par statut d'article : publish, draft, pending, private | +| `author` | number | Non | Filtrer par ID d'auteur | +| `categories` | string | Non | IDs de catégories séparés par des virgules pour filtrer | +| `tags` | string | Non | IDs de tags séparés par des virgules pour filtrer | +| `search` | string | Non | Terme de recherche pour filtrer les articles | +| `orderBy` | string | Non | Trier par champ : date, id, title, slug, modified | +| `order` | string | Non | Direction du tri : asc ou desc | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `posts` | array | Liste des articles | + +### `wordpress_create_page` + +Créer une nouvelle page sur WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `title` | string | Oui | Titre de la page | +| `content` | string | Non | Contenu de la page \(HTML ou texte brut\) | +| `status` | string | Non | Statut de la page : publish, draft, pending, private | +| `excerpt` | string | Non | Extrait de la page | +| `parent` | number | Non | ID de la page parente pour les pages hiérarchiques | +| `menuOrder` | number | Non | Ordre dans le menu des pages | +| `featuredMedia` | number | Non | ID du média de l'image mise en avant | +| `slug` | string | Non | Slug URL pour la page | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `page` | object | La page créée | + +### `wordpress_update_page` + +Mettre à jour une page existante sur WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `pageId` | number | Oui | L'ID de la page à mettre à jour | +| `title` | string | Non | Titre de la page | +| `content` | string | Non | Contenu de la page \(HTML ou texte brut\) | +| `status` | string | Non | Statut de la page : publish, draft, pending, private | +| `excerpt` | string | Non | Extrait de la page | +| `parent` | number | Non | ID de la page parente pour les pages hiérarchiques | +| `menuOrder` | number | Non | Ordre dans le menu des pages | +| `featuredMedia` | number | Non | ID du média de l'image mise en avant | +| `slug` | string | Non | Slug URL pour la page | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `page` | objet | La page mise à jour | + +### `wordpress_delete_page` + +Supprimer une page de WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | chaîne | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `pageId` | nombre | Oui | L'ID de la page à supprimer | +| `force` | booléen | Non | Contourner la corbeille et forcer la suppression définitive | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `deleted` | booléen | Indique si la page a été supprimée | +| `page` | objet | La page supprimée | + +### `wordpress_get_page` + +Obtenir une seule page de WordPress.com par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | chaîne | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `pageId` | nombre | Oui | L'ID de la page à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `page` | objet | La page récupérée | + +### `wordpress_list_pages` + +Lister les pages de WordPress.com avec filtres optionnels + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | chaîne | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `perPage` | nombre | Non | Nombre de pages par requête \(par défaut : 10, max : 100\) | +| `page` | nombre | Non | Numéro de page pour la pagination | +| `status` | chaîne | Non | Filtre de statut de page : publish, draft, pending, private | +| `parent` | nombre | Non | Filtrer par ID de page parente | +| `search` | chaîne | Non | Terme de recherche pour filtrer les pages | +| `orderBy` | chaîne | Non | Trier par champ : date, id, title, slug, modified, menu_order | +| `order` | chaîne | Non | Direction de tri : asc ou desc | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `pages` | array | Liste des pages | + +### `wordpress_upload_media` + +Télécharger un fichier média (image, vidéo, document) sur WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `file` | string | Oui | Données du fichier encodées en Base64 ou URL pour récupérer le fichier | +| `filename` | string | Oui | Nom du fichier avec extension \(ex., image.jpg\) | +| `title` | string | Non | Titre du média | +| `caption` | string | Non | Légende du média | +| `altText` | string | Non | Texte alternatif pour l'accessibilité | +| `description` | string | Non | Description du média | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `media` | object | L'élément média téléchargé | + +### `wordpress_get_media` + +Obtenir un élément média unique de WordPress.com par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `mediaId` | number | Oui | L'ID de l'élément média à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `media` | object | L'élément média récupéré | + +### `wordpress_list_media` + +Lister les éléments multimédias de la bibliothèque multimédia WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | chaîne | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `perPage` | nombre | Non | Nombre d'éléments multimédias par requête \(par défaut : 10, max : 100\) | +| `page` | nombre | Non | Numéro de page pour la pagination | +| `search` | chaîne | Non | Terme de recherche pour filtrer les médias | +| `mediaType` | chaîne | Non | Filtrer par type de média : image, vidéo, audio, application | +| `mimeType` | chaîne | Non | Filtrer par type MIME spécifique \(ex., image/jpeg\) | +| `orderBy` | chaîne | Non | Trier par champ : date, id, titre, slug | +| `order` | chaîne | Non | Direction du tri : asc ou desc | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `media` | tableau | Liste des éléments multimédias | + +### `wordpress_delete_media` + +Supprimer un élément multimédia de WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | chaîne | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `mediaId` | nombre | Oui | L'ID de l'élément multimédia à supprimer | +| `force` | booléen | Non | Forcer la suppression \(les médias n'ont pas de corbeille, donc la suppression est permanente\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `deleted` | boolean | Indique si le média a été supprimé | +| `media` | object | L'élément média supprimé | + +### `wordpress_create_comment` + +Créer un nouveau commentaire sur un article WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `postId` | number | Oui | L'ID de l'article à commenter | +| `content` | string | Oui | Contenu du commentaire | +| `parent` | number | Non | ID du commentaire parent pour les réponses | +| `authorName` | string | Non | Nom d'affichage de l'auteur du commentaire | +| `authorEmail` | string | Non | Email de l'auteur du commentaire | +| `authorUrl` | string | Non | URL de l'auteur du commentaire | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `comment` | object | Le commentaire créé | + +### `wordpress_list_comments` + +Lister les commentaires de WordPress.com avec filtres optionnels + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `perPage` | number | Non | Nombre de commentaires par requête \(par défaut : 10, max : 100\) | +| `page` | number | Non | Numéro de page pour la pagination | +| `postId` | number | Non | Filtrer par ID d'article | +| `status` | string | Non | Filtrer par statut de commentaire : approved, hold, spam, trash | +| `search` | string | Non | Terme de recherche pour filtrer les commentaires | +| `orderBy` | string | Non | Trier par champ : date, id, parent | +| `order` | string | Non | Direction du tri : asc ou desc | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `comments` | array | Liste des commentaires | + +### `wordpress_update_comment` + +Mettre à jour un commentaire dans WordPress.com (contenu ou statut) + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `commentId` | number | Oui | L'ID du commentaire à mettre à jour | +| `content` | string | Non | Contenu mis à jour du commentaire | +| `status` | string | Non | Statut du commentaire : approved, hold, spam, trash | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `comment` | object | Le commentaire mis à jour | + +### `wordpress_delete_comment` + +Supprimer un commentaire de WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `commentId` | number | Oui | L'ID du commentaire à supprimer | +| `force` | boolean | Non | Contourner la corbeille et forcer la suppression définitive | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `deleted` | boolean | Indique si le commentaire a été supprimé | +| `comment` | object | Le commentaire supprimé | + +### `wordpress_create_category` + +Créer une nouvelle catégorie dans WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine (par ex., 12345678 ou monsite.wordpress.com) | +| `name` | string | Oui | Nom de la catégorie | +| `description` | string | Non | Description de la catégorie | +| `parent` | number | Non | ID de la catégorie parente pour les catégories hiérarchiques | +| `slug` | string | Non | Slug URL pour la catégorie | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `category` | object | La catégorie créée | + +### `wordpress_list_categories` + +Lister les catégories de WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine (par ex., 12345678 ou monsite.wordpress.com) | +| `perPage` | number | Non | Nombre de catégories par requête (par défaut : 10, max : 100) | +| `page` | number | Non | Numéro de page pour la pagination | +| `search` | string | Non | Terme de recherche pour filtrer les catégories | +| `order` | string | Non | Direction de tri : asc ou desc | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `categories` | array | Liste des catégories | + +### `wordpress_create_tag` + +Créer un nouveau tag dans WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine (par ex., 12345678 ou monsite.wordpress.com) | +| `name` | string | Oui | Nom du tag | +| `description` | string | Non | Description du tag | +| `slug` | string | Non | Slug URL pour le tag | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `tag` | object | Le tag créé | + +### `wordpress_list_tags` + +Lister les tags de WordPress.com + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `perPage` | number | Non | Nombre de tags par requête \(par défaut : 10, max : 100\) | +| `page` | number | Non | Numéro de page pour la pagination | +| `search` | string | Non | Terme de recherche pour filtrer les tags | +| `order` | string | Non | Direction de tri : asc ou desc | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `tags` | array | Liste des tags | + +### `wordpress_get_current_user` + +Obtenir des informations sur l'utilisateur WordPress.com actuellement authentifié + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `user` | object | L'utilisateur actuel | + +### `wordpress_list_users` + +Lister les utilisateurs de WordPress.com (nécessite des privilèges d'administrateur) + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `perPage` | number | Non | Nombre d'utilisateurs par requête \(par défaut : 10, max : 100\) | +| `page` | number | Non | Numéro de page pour la pagination | +| `search` | string | Non | Terme de recherche pour filtrer les utilisateurs | +| `roles` | string | Non | Noms de rôles séparés par des virgules pour filtrer | +| `order` | string | Non | Direction de tri : asc ou desc | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `users` | array | Liste des utilisateurs | + +### `wordpress_get_user` + +Obtenir un utilisateur spécifique de WordPress.com par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `userId` | number | Oui | L'ID de l'utilisateur à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `user` | object | L'utilisateur récupéré | + +### `wordpress_search_content` + +Rechercher dans tous les types de contenu sur WordPress.com (articles, pages, médias) + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | Oui | ID du site WordPress.com ou domaine \(ex., 12345678 ou monsite.wordpress.com\) | +| `query` | string | Oui | Requête de recherche | +| `perPage` | number | Non | Nombre de résultats par requête \(par défaut : 10, max : 100\) | +| `page` | number | Non | Numéro de page pour la pagination | +| `type` | string | Non | Filtrer par type de contenu : post, page, attachment | +| `subtype` | string | Non | Filtrer par slug de type de publication \(ex., post, page\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `results` | array | Résultats de recherche | + +## Notes + +- Catégorie : `tools` +- Type : `wordpress` diff --git a/apps/docs/content/docs/fr/tools/zendesk.mdx b/apps/docs/content/docs/fr/tools/zendesk.mdx index f516ef45d..683ee826f 100644 --- a/apps/docs/content/docs/fr/tools/zendesk.mdx +++ b/apps/docs/content/docs/fr/tools/zendesk.mdx @@ -108,13 +108,16 @@ Créer un nouveau ticket dans Zendesk avec prise en charge des champs personnali | `email` | string | Oui | Votre adresse e-mail Zendesk | | `apiToken` | string | Oui | Jeton API Zendesk | | `subdomain` | string | Oui | Votre sous-domaine Zendesk | -| `subject` | string | Non | Objet du ticket \(facultatif - sera généré automatiquement si non fourni\) | +| `subject` | string | Non | Sujet du ticket \(facultatif - sera généré automatiquement si non fourni\) | | `description` | string | Oui | Description du ticket \(premier commentaire\) | -| `priority` | string | Non | Priorité \(faible, normale, élevée, urgente\) | -| `status` | string | Non | Statut \(nouveau, ouvert, en attente, en suspens, résolu, fermé\) | -| `type` | string | Non | Type \(problème, incident, question, tâche\) | +| `priority` | string | Non | Priorité \(low, normal, high, urgent\) | +| `status` | string | Non | Statut \(new, open, pending, hold, solved, closed\) | +| `type` | string | Non | Type \(problem, incident, question, task\) | | `tags` | string | Non | Tags séparés par des virgules | | `assigneeId` | string | Non | ID de l'utilisateur assigné | +| `groupId` | string | Non | ID du groupe | +| `requesterId` | string | Non | ID de l'utilisateur demandeur | +| `customFields` | string | Non | Champs personnalisés sous forme d'objet JSON \(ex., \{"field_id": "value"\}\) | #### Sortie diff --git a/apps/docs/content/docs/fr/tools/zoom.mdx b/apps/docs/content/docs/fr/tools/zoom.mdx new file mode 100644 index 000000000..a546b3944 --- /dev/null +++ b/apps/docs/content/docs/fr/tools/zoom.mdx @@ -0,0 +1,250 @@ +--- +title: Zoom +description: Créer et gérer des réunions et enregistrements Zoom +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Zoom](https://zoom.us/) est une plateforme de communication cloud de premier plan pour les réunions vidéo, les webinaires et la collaboration en ligne. Elle permet aux utilisateurs et aux organisations de planifier, d'héberger et de gérer facilement des réunions, en fournissant des outils pour le partage d'écran, le chat, les enregistrements, et plus encore. + +Avec Zoom, vous pouvez : + +- **Planifier et gérer des réunions** : Créer des réunions instantanées ou programmées, y compris des événements récurrents +- **Configurer les options de réunion** : Définir des mots de passe pour les réunions, activer les salles d'attente et contrôler la vidéo/l'audio des participants +- **Envoyer des invitations et partager des détails** : Récupérer les invitations et les informations de réunion pour un partage facile +- **Obtenir et mettre à jour les données de réunion** : Accéder aux détails des réunions, modifier les réunions existantes et gérer les paramètres par programmation + +Dans Sim, l'intégration Zoom permet à vos agents d'automatiser la planification et la gestion des réunions. Utilisez les actions d'outils pour : + +- Créer par programmation de nouvelles réunions avec des paramètres personnalisés +- Lister toutes les réunions pour un utilisateur spécifique (ou vous-même) +- Récupérer les détails ou les invitations pour n'importe quelle réunion +- Mettre à jour ou supprimer des réunions existantes directement depuis vos automatisations + +Ces capacités vous permettent de rationaliser la collaboration à distance, d'automatiser les sessions vidéo récurrentes et de gérer l'environnement Zoom de votre organisation, le tout dans le cadre de vos flux de travail. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez Zoom dans les flux de travail. Créez, listez, mettez à jour et supprimez des réunions Zoom. Obtenez les détails des réunions, les invitations, les enregistrements et les participants. Gérez les enregistrements cloud par programmation. + +## Outils + +### `zoom_create_meeting` + +Créer une nouvelle réunion Zoom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `userId` | string | Oui | L'ID utilisateur ou l'adresse e-mail. Utilisez "me" pour l'utilisateur authentifié. | +| `topic` | string | Oui | Sujet de la réunion | +| `type` | number | Non | Type de réunion : 1=instantanée, 2=programmée, 3=récurrente sans heure fixe, 8=récurrente à heure fixe | +| `startTime` | string | Non | Heure de début de la réunion au format ISO 8601 \(ex., 2025-06-03T10:00:00Z\) | +| `duration` | number | Non | Durée de la réunion en minutes | +| `timezone` | string | Non | Fuseau horaire pour la réunion \(ex., America/Los_Angeles\) | +| `password` | string | Non | Mot de passe de la réunion | +| `agenda` | string | Non | Ordre du jour de la réunion | +| `hostVideo` | boolean | Non | Démarrer avec la vidéo de l'hôte activée | +| `participantVideo` | boolean | Non | Démarrer avec la vidéo des participants activée | +| `joinBeforeHost` | boolean | Non | Autoriser les participants à rejoindre avant l'hôte | +| `muteUponEntry` | boolean | Non | Mettre les participants en sourdine à l'entrée | +| `waitingRoom` | boolean | Non | Activer la salle d'attente | +| `autoRecording` | string | Non | Paramètre d'enregistrement automatique : local, cloud ou none | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `meeting` | object | La réunion créée avec toutes ses propriétés | + +### `zoom_list_meetings` + +Lister toutes les réunions pour un utilisateur Zoom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `userId` | string | Oui | L'ID utilisateur ou l'adresse e-mail. Utilisez "me" pour l'utilisateur authentifié. | +| `type` | string | Non | Filtre de type de réunion : scheduled, live, upcoming, upcoming_meetings, ou previous_meetings | +| `pageSize` | number | Non | Nombre d'enregistrements par page \(max 300\) | +| `nextPageToken` | string | Non | Jeton pour la pagination afin d'obtenir la page suivante des résultats | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `meetings` | array | Liste des réunions | +| `pageInfo` | object | Informations de pagination | + +### `zoom_get_meeting` + +Obtenir les détails d'une réunion Zoom spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `meetingId` | string | Oui | L'ID de la réunion | +| `occurrenceId` | string | Non | ID d'occurrence pour les réunions récurrentes | +| `showPreviousOccurrences` | boolean | Non | Afficher les occurrences précédentes pour les réunions récurrentes | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `meeting` | object | Les détails de la réunion | + +### `zoom_update_meeting` + +Mettre à jour une réunion Zoom existante + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Oui | L'ID de la réunion à mettre à jour | +| `topic` | string | Non | Sujet de la réunion | +| `type` | number | Non | Type de réunion : 1=instantanée, 2=programmée, 3=récurrente sans horaire fixe, 8=récurrente avec horaire fixe | +| `startTime` | string | Non | Heure de début de la réunion au format ISO 8601 \(ex., 2025-06-03T10:00:00Z\) | +| `duration` | number | Non | Durée de la réunion en minutes | +| `timezone` | string | Non | Fuseau horaire pour la réunion \(ex., America/Los_Angeles\) | +| `password` | string | Non | Mot de passe de la réunion | +| `agenda` | string | Non | Ordre du jour de la réunion | +| `hostVideo` | boolean | Non | Démarrer avec la vidéo de l'hôte activée | +| `participantVideo` | boolean | Non | Démarrer avec la vidéo des participants activée | +| `joinBeforeHost` | boolean | Non | Autoriser les participants à rejoindre avant l'hôte | +| `muteUponEntry` | boolean | Non | Mettre les participants en sourdine à l'entrée | +| `waitingRoom` | boolean | Non | Activer la salle d'attente | +| `autoRecording` | string | Non | Paramètre d'enregistrement automatique : local, cloud ou none | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Indique si la réunion a été mise à jour avec succès | + +### `zoom_delete_meeting` + +Supprimer ou annuler une réunion Zoom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Oui | L'ID de la réunion à supprimer | +| `occurrenceId` | string | Non | ID d'occurrence pour supprimer une occurrence spécifique d'une réunion récurrente | +| `scheduleForReminder` | boolean | Non | Envoyer un e-mail de rappel d'annulation aux inscrits | +| `cancelMeetingReminder` | boolean | Non | Envoyer un e-mail d'annulation aux inscrits et aux hôtes alternatifs | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Indique si la réunion a été supprimée avec succès | + +### `zoom_get_meeting_invitation` + +Obtenir le texte d'invitation pour une réunion Zoom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Oui | L'identifiant de la réunion | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `invitation` | string | Le texte d'invitation à la réunion | + +### `zoom_list_recordings` + +Lister tous les enregistrements cloud pour un utilisateur Zoom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `userId` | string | Oui | L'identifiant ou l'adresse e-mail de l'utilisateur. Utilisez "me" pour l'utilisateur authentifié. | +| `from` | string | Non | Date de début au format aaaa-mm-jj \(dans les 6 derniers mois\) | +| `to` | string | Non | Date de fin au format aaaa-mm-jj | +| `pageSize` | number | Non | Nombre d'enregistrements par page \(max 300\) | +| `nextPageToken` | string | Non | Jeton pour la pagination afin d'obtenir la page suivante des résultats | +| `trash` | boolean | Non | Définir sur true pour lister les enregistrements de la corbeille | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `recordings` | array | Liste des enregistrements | +| `pageInfo` | object | Informations de pagination | + +### `zoom_get_meeting_recordings` + +Obtenir tous les enregistrements pour une réunion Zoom spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Oui | L'ID de la réunion ou l'UUID de la réunion | +| `includeFolderItems` | boolean | Non | Inclure les éléments dans un dossier | +| `ttl` | number | Non | Durée de vie des URL de téléchargement en secondes \(max 604800\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `recording` | object | L'enregistrement de la réunion avec tous les fichiers | + +### `zoom_delete_recording` + +Supprimer les enregistrements cloud d'une réunion Zoom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Oui | L'ID de la réunion ou l'UUID de la réunion | +| `recordingId` | string | Non | ID de fichier d'enregistrement spécifique à supprimer. Si non fourni, supprime tous les enregistrements. | +| `action` | string | Non | Action de suppression : "trash" \(déplacer vers la corbeille\) ou "delete" \(supprimer définitivement\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Si l'enregistrement a été supprimé avec succès | + +### `zoom_list_past_participants` + +Lister les participants d'une réunion Zoom passée + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | Oui | L'ID ou l'UUID de la réunion passée | +| `pageSize` | number | Non | Nombre d'enregistrements par page \(max 300\) | +| `nextPageToken` | string | Non | Jeton pour la pagination pour obtenir la page suivante de résultats | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `participants` | array | Liste des participants à la réunion | +| `pageInfo` | object | Informations de pagination | + +## Notes + +- Catégorie : `tools` +- Type : `zoom` diff --git a/apps/docs/content/docs/ja/tools/ahrefs.mdx b/apps/docs/content/docs/ja/tools/ahrefs.mdx new file mode 100644 index 000000000..dd262839c --- /dev/null +++ b/apps/docs/content/docs/ja/tools/ahrefs.mdx @@ -0,0 +1,199 @@ +--- +title: Ahrefs +description: Ahrefsを使ったSEO分析 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Ahrefs](https://ahrefs.com/)は、ウェブサイトの分析、ランキングの追跡、バックリンクのモニタリング、キーワードリサーチを行うための主要なSEOツールセットです。自社のウェブサイトや競合他社に関する詳細な洞察を提供し、検索での可視性を向上させるためのデータ駆動型の意思決定をサポートします。 + +SimでのAhrefs統合により、以下のことが可能になります： + +- **ドメインレーティングと権威性の分析**：任意のウェブサイトのドメインレーティング（DR）とAhrefsランクを即座にチェックして、その権威性を評価できます。 +- **バックリンクの取得**：サイトまたは特定のURLを指すバックリンクのリストを、アンカーテキスト、参照ページのDRなどの詳細情報とともに取得できます。 +- **バックリンク統計の取得**：ドメインまたはURLのバックリンクタイプ（dofollow、nofollow、テキスト、画像、リダイレクトなど）に関するメトリクスにアクセスできます。 +- **オーガニックキーワードの探索** *(計画中)*：ドメインがランク付けされているキーワードとGoogle検索結果での位置を表示します。 +- **トップページの発見** *(計画中)*：オーガニックトラフィックとリンクによって最も成果の高いページを特定します。 + +これらのツールにより、エージェントはSEOリサーチの自動化、競合他社のモニタリング、レポートの生成をワークフロー自動化の一部として実行できます。Ahrefs統合を使用するには、API アクセス付きのAhrefs Enterpriseサブスクリプションが必要です。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +AhrefsのSEOツールをワークフローに統合します。ドメインレーティング、バックリンク、オーガニックキーワード、トップページなどを分析できます。APIアクセス付きのAhrefs Enterpriseプランが必要です。 + +## ツール + +### `ahrefs_domain_rating` + +ターゲットドメインのドメインレーティング（DR）とAhrefsランクを取得します。ドメインレーティングはウェブサイトの強さを示します + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `target` | string | はい | 分析対象のドメイン（例：example.com） | +| `date` | string | いいえ | 過去データの日付（YYYY-MM-DD形式、デフォルトは今日） | +| `apiKey` | string | はい | Ahrefs APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `domainRating` | number | ドメインレーティングスコア（0-100） | +| `ahrefsRank` | number | Ahrefs ランク - バックリンクプロファイルの強さに基づくグローバルランキング | + +### `ahrefs_backlinks` + +ターゲットドメインまたはURLを指すバックリンクのリストを取得します。各バックリンクについて、ソースURL、アンカーテキスト、ドメインレーティングなどの詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `target` | string | はい | 分析対象のドメインまたはURL | +| `mode` | string | いいえ | 分析モード：domain（ドメイン全体）、prefix（URLプレフィックス）、subdomains（すべてのサブドメインを含む）、exact（完全なURL一致） | +| `date` | string | いいえ | 過去データの日付（YYYY-MM-DD形式、デフォルトは今日） | +| `limit` | number | いいえ | 返す結果の最大数（デフォルト：100） | +| `offset` | number | いいえ | ページネーション用にスキップする結果の数 | +| `apiKey` | string | はい | Ahrefs APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `backlinks` | array | ターゲットを指すバックリンクのリスト | + +### `ahrefs_backlinks_stats` + +ターゲットドメインまたはURLのバックリンク統計を取得します。dofollow、nofollow、テキスト、画像、リダイレクトリンクなど、異なるバックリンクタイプの合計を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `target` | string | はい | 分析するターゲットドメインまたはURL | +| `mode` | string | いいえ | 分析モード: domain \(ドメイン全体\)、prefix \(URL接頭辞\)、subdomains \(すべてのサブドメインを含む\)、exact \(完全なURLマッチ\) | +| `date` | string | いいえ | 履歴データの日付（YYYY-MM-DD形式）\(デフォルトは今日\) | +| `apiKey` | string | はい | Ahrefs APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `stats` | object | バックリンク統計の概要 | + +### `ahrefs_referring_domains` + +ターゲットドメインまたはURLにリンクしているドメインのリストを取得します。ドメインレーティング、バックリンク数、発見日を含む一意の参照ドメインを返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `target` | string | はい | 分析するターゲットドメインまたはURL | +| `mode` | string | いいえ | 分析モード: domain \(ドメイン全体\)、prefix \(URL接頭辞\)、subdomains \(すべてのサブドメインを含む\)、exact \(完全なURLマッチ\) | +| `date` | string | いいえ | 履歴データの日付（YYYY-MM-DD形式）\(デフォルトは今日\) | +| `limit` | number | いいえ | 返す結果の最大数 \(デフォルト: 100\) | +| `offset` | number | いいえ | ページネーションのためにスキップする結果の数 | +| `apiKey` | string | はい | Ahrefs APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `referringDomains` | array | ターゲットにリンクしているドメインのリスト | + +### `ahrefs_organic_keywords` + +ターゲットドメインまたはURLがGoogle検索結果でランク付けされているオーガニックキーワードを取得します。検索ボリューム、ランキングポジション、推定トラフィックなどのキーワードの詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `target` | string | はい | 分析対象のドメインまたはURL | +| `country` | string | いいえ | 検索結果の国コード（例：us、gb、de）。デフォルト：us | +| `mode` | string | いいえ | 分析モード：domain（ドメイン全体）、prefix（URLプレフィックス）、subdomains（すべてのサブドメインを含む）、exact（完全なURL一致） | +| `date` | string | いいえ | 履歴データの日付（YYYY-MM-DD形式、デフォルトは今日） | +| `limit` | number | いいえ | 返す結果の最大数（デフォルト：100） | +| `offset` | number | いいえ | ページネーション用にスキップする結果の数 | +| `apiKey` | string | はい | Ahrefs APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `keywords` | array | ターゲットがランク付けされているオーガニックキーワードのリスト | + +### `ahrefs_top_pages` + +オーガニックトラフィック順にソートされたターゲットドメインのトップページを取得します。ページURLとそのトラフィック、キーワード数、推定トラフィック価値を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `target` | string | はい | 分析対象のドメイン | +| `country` | string | いいえ | トラフィックデータの国コード（例：us、gb、de）。デフォルト：us | +| `mode` | string | いいえ | 分析モード：domain（ドメイン全体）、prefix（URL接頭辞）、subdomains（すべてのサブドメインを含む） | +| `date` | string | いいえ | 過去データの日付（YYYY-MM-DD形式）（デフォルト：今日） | +| `limit` | number | いいえ | 返す結果の最大数（デフォルト：100） | +| `offset` | number | いいえ | ページネーション用にスキップする結果の数 | +| `apiKey` | string | はい | Ahrefs APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `pages` | array | オーガニックトラフィック別のトップページリスト | + +### `ahrefs_keyword_overview` + +検索ボリューム、キーワード難易度、CPC、クリック数、トラフィックポテンシャルなどを含むキーワードの詳細指標を取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `keyword` | string | はい | 分析するキーワード | +| `country` | string | いいえ | キーワードデータの国コード（例：us、gb、de）。デフォルト：us | +| `apiKey` | string | はい | Ahrefs APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `overview` | object | キーワード指標の概要 | + +### `ahrefs_broken_backlinks` + +ターゲットドメインまたはURLを指すリンク切れのバックリンクのリストを取得します。リンク再取得の機会を特定するのに役立ちます。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `target` | string | はい | 分析対象のターゲットドメインまたはURL | +| `mode` | string | いいえ | 分析モード: domain（ドメイン全体）、prefix（URL接頭辞）、subdomains（すべてのサブドメインを含む）、exact（完全なURL一致） | +| `date` | string | いいえ | YYYY-MM-DD形式の履歴データの日付（デフォルトは今日） | +| `limit` | number | いいえ | 返す結果の最大数（デフォルト: 100） | +| `offset` | number | いいえ | ページネーション用にスキップする結果の数 | +| `apiKey` | string | はい | Ahrefs APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `brokenBacklinks` | array | リンク切れのバックリンクのリスト | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `ahrefs` diff --git a/apps/docs/content/docs/ja/tools/datadog.mdx b/apps/docs/content/docs/ja/tools/datadog.mdx new file mode 100644 index 000000000..d302b7db9 --- /dev/null +++ b/apps/docs/content/docs/ja/tools/datadog.mdx @@ -0,0 +1,302 @@ +--- +title: Datadog +description: Datadogでインフラストラクチャ、アプリケーション、ログを監視 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Datadog](https://datadoghq.com/)は、インフラストラクチャ、アプリケーション、ログなどを包括的に監視・分析するプラットフォームです。組織がシステムの健全性とパフォーマンスをリアルタイムで可視化し、異常を検出し、インシデント対応を自動化することを可能にします。 + +Datadogでは以下のことができます： + +- **メトリクスの監視**: サーバー、クラウドサービス、カスタムアプリケーションからメトリクスを収集、視覚化、分析。 +- **時系列データのクエリ**: トレンド分析とレポート作成のためにパフォーマンスメトリクスに対して高度なクエリを実行。 +- **モニターとイベントの管理**: 問題を検出し、アラートをトリガーし、可観測性のためのイベントを作成するモニターを設定。 +- **ダウンタイムの処理**: メンテナンス中にアラートを抑制するための計画的なダウンタイムをスケジュールし、プログラムで管理。 +- **ログとトレースの分析** *(Datadogで追加設定が必要)*: より深いトラブルシューティングのためにログや分散トレースを一元化して検査。 + +SimのDatadog統合により、エージェントはこれらの操作を自動化し、Datadogアカウントとプログラム的に対話することができます。カスタムメトリクスの送信、時系列データのクエリ、モニターの管理、イベントの作成、Sim自動化内で直接監視ワークフローを効率化するために使用できます。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +ワークフローにDatadog監視を統合します。メトリクスの送信、モニターの管理、ログのクエリ、イベントの作成、ダウンタイムの処理などが可能です。 + +## ツール + +### `datadog_submit_metrics` + +カスタムメトリクスをDatadogに送信します。アプリケーションのパフォーマンス、ビジネスメトリクス、またはカスタム監視データの追跡に使用します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `series` | string | はい | 送信するメトリクスシリーズのJSON配列。各シリーズにはメトリクス名、タイプ\(gauge/rate/count\)、ポイント\(タイムスタンプ/値のペア\)、およびオプションのタグを含める必要があります。 | +| `apiKey` | string | はい | Datadog APIキー | +| `site` | string | いいえ | Datadogサイト/リージョン\(デフォルト: datadoghq.com\) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | メトリクスが正常に送信されたかどうか | +| `errors` | array | 送信中に発生したエラー | + +### `datadog_query_timeseries` + +Datadogからメトリクスの時系列データをクエリします。トレンド分析、レポート作成、またはメトリクス値の取得に使用します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `query` | string | はい | Datadogメトリクスクエリ（例："avg:system.cpu.user\{*\}"） | +| `from` | number | はい | 開始時間（Unix秒タイムスタンプ） | +| `to` | number | はい | 終了時間（Unix秒タイムスタンプ） | +| `apiKey` | string | はい | Datadog APIキー | +| `applicationKey` | string | はい | Datadog アプリケーションキー | +| `site` | string | いいえ | Datadogサイト/リージョン（デフォルト: datadoghq.com） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `series` | array | メトリクス名、タグ、データポイントを含む時系列データの配列 | +| `status` | string | クエリステータス | + +### `datadog_create_event` + +Datadogイベントストリームにイベントを投稿します。デプロイ通知、アラート、または重要な出来事に使用します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `title` | string | はい | イベントタイトル | +| `text` | string | はい | イベント本文/説明。マークダウンをサポート。 | +| `alertType` | string | いいえ | アラートタイプ: error、warning、info、success、user_update、recommendation、またはsnapshot | +| `priority` | string | いいえ | イベント優先度: normalまたはlow | +| `host` | string | いいえ | このイベントに関連付けるホスト名 | +| `tags` | string | いいえ | カンマ区切りのタグリスト（例："env:production,service:api"） | +| `aggregationKey` | string | いいえ | イベントをまとめるためのキー | +| `sourceTypeName` | string | いいえ | イベントのソースタイプ名 | +| `dateHappened` | number | いいえ | イベントが発生したUnixタイムスタンプ（デフォルトは現在時刻） | +| `apiKey` | string | はい | Datadog APIキー | +| `site` | string | いいえ | Datadogサイト/リージョン（デフォルト: datadoghq.com） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `event` | object | 作成されたイベントの詳細 | + +### `datadog_create_monitor` + +Datadogで新しいモニター/アラートを作成します。モニターはメトリクス、サービスチェック、イベントなどを追跡できます。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `name` | string | はい | モニター名 | +| `type` | string | はい | モニタータイプ: metric alert、service check、event alert、process alert、log alert、query alert、composite、synthetics alert、slo alert | +| `query` | string | はい | モニタークエリ（例："avg\(last_5m\):avg:system.cpu.idle\{*\} < 20"） | +| `message` | string | いいえ | 通知に含めるメッセージ。@メンションやマークダウンを含めることができます。 | +| `tags` | string | いいえ | カンマ区切りのタグリスト | +| `priority` | number | いいえ | モニターの優先度（1-5、1が最高）| +| `options` | string | いいえ | モニターオプションのJSON文字列（しきい値、notify_no_data、renotify_intervalなど） | +| `apiKey` | string | はい | Datadog APIキー | +| `applicationKey` | string | はい | Datadog アプリケーションキー | +| `site` | string | いいえ | Datadogサイト/リージョン（デフォルト: datadoghq.com） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `monitor` | object | 作成されたモニターの詳細 | + +### `datadog_get_monitor` + +IDで特定のモニターの詳細を取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `monitorId` | string | はい | 取得するモニターのID | +| `groupStates` | string | いいえ | 含めるグループ状態のカンマ区切りリスト: alert、warn、no data、ok | +| `withDowntimes` | boolean | いいえ | モニターとともにダウンタイムデータを含める | +| `apiKey` | string | はい | Datadog APIキー | +| `applicationKey` | string | はい | Datadog アプリケーションキー | +| `site` | string | いいえ | Datadogサイト/リージョン（デフォルト: datadoghq.com） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `monitor` | object | モニターの詳細 | + +### `datadog_list_monitors` + +Datadogのすべてのモニターを、名前、タグ、または状態によるオプションのフィルタリングと共に一覧表示します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `groupStates` | string | いいえ | フィルタリングするグループ状態のカンマ区切りリスト: alert, warn, no data, ok | +| `name` | string | いいえ | 名前でモニターをフィルタリング（部分一致） | +| `tags` | string | いいえ | フィルタリングするタグのカンマ区切りリスト | +| `monitorTags` | string | いいえ | フィルタリングするモニタータグのカンマ区切りリスト | +| `withDowntimes` | boolean | いいえ | モニターとともにダウンタイムデータを含める | +| `page` | number | いいえ | ページネーションのページ番号（0から始まる） | +| `pageSize` | number | いいえ | 1ページあたりのモニター数（最大1000） | +| `apiKey` | string | はい | Datadog APIキー | +| `applicationKey` | string | はい | Datadog アプリケーションキー | +| `site` | string | いいえ | Datadogサイト/リージョン（デフォルト: datadoghq.com） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `monitors` | array | モニターのリスト | + +### `datadog_mute_monitor` + +通知を一時的に抑制するためにモニターをミュートします。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `monitorId` | string | はい | ミュートするモニターのID | +| `scope` | string | いいえ | ミュートするスコープ（例: "host:myhost"）。指定しない場合、すべてのスコープをミュートします。 | +| `end` | number | いいえ | ミュートを終了するUnixタイムスタンプ。指定しない場合、無期限にミュートします。 | +| `apiKey` | string | はい | Datadog APIキー | +| `applicationKey` | string | はい | Datadog アプリケーションキー | +| `site` | string | いいえ | Datadogサイト/リージョン（デフォルト: datadoghq.com） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | モニターが正常にミュートされたかどうか | + +### `datadog_query_logs` + +Datadogからログを検索して取得します。トラブルシューティング、分析、またはモニタリングに使用します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `query` | string | はい | ログ検索クエリ（例："service:web-app status:error"） | +| `from` | string | はい | ISO-8601形式または相対形式の開始時間（例："now-1h"） | +| `to` | string | はい | ISO-8601形式または相対形式の終了時間（例："now"） | +| `limit` | number | いいえ | 返すログの最大数（デフォルト：50、最大：1000） | +| `sort` | string | いいえ | ソート順：timestamp（古い順）または-timestamp（新しい順） | +| `indexes` | string | いいえ | 検索するログインデックスのカンマ区切りリスト | +| `apiKey` | string | はい | Datadog APIキー | +| `applicationKey` | string | はい | Datadog アプリケーションキー | +| `site` | string | いいえ | Datadogサイト/リージョン（デフォルト：datadoghq.com） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `logs` | array | ログエントリのリスト | + +### `datadog_send_logs` + +集中ログ記録と分析のために、ログエントリをDatadogに送信します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `logs` | string | はい | ログエントリのJSON配列。各エントリにはmessageが必要で、オプションでddsource、ddtags、hostname、serviceを含めることができます。 | +| `apiKey` | string | はい | Datadog APIキー | +| `site` | string | いいえ | Datadogサイト/リージョン（デフォルト：datadoghq.com） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | ログが正常に送信されたかどうか | + +### `datadog_create_downtime` + +メンテナンス期間中にモニター通知を抑制するためのダウンタイムをスケジュールします。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `scope` | string | はい | ダウンタイムを適用する範囲（例："host:myhost"、"env:production"、または全てに対して"*"） | +| `message` | string | いいえ | ダウンタイム中に表示するメッセージ | +| `start` | number | いいえ | ダウンタイム開始のUnixタイムスタンプ（デフォルトは現在時刻） | +| `end` | number | いいえ | ダウンタイム終了のUnixタイムスタンプ | +| `timezone` | string | いいえ | ダウンタイムのタイムゾーン（例："America/New_York"） | +| `monitorId` | string | いいえ | ミュートする特定のモニターID | +| `monitorTags` | string | いいえ | 一致させるモニタータグ（カンマ区切り、例："team:backend,priority:high"） | +| `muteFirstRecoveryNotification` | boolean | いいえ | 最初の復旧通知をミュートする | +| `apiKey` | string | はい | Datadog APIキー | +| `applicationKey` | string | はい | Datadog アプリケーションキー | +| `site` | string | いいえ | Datadogサイト/リージョン（デフォルト: datadoghq.com） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `downtime` | object | 作成されたダウンタイムの詳細 | + +### `datadog_list_downtimes` + +Datadogでスケジュールされたすべてのダウンタイムを一覧表示します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `currentOnly` | boolean | いいえ | 現在アクティブなダウンタイムのみを返す | +| `monitorId` | string | いいえ | モニターIDでフィルタリング | +| `apiKey` | string | はい | Datadog APIキー | +| `applicationKey` | string | はい | Datadog アプリケーションキー | +| `site` | string | いいえ | Datadogサイト/リージョン（デフォルト: datadoghq.com） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `downtimes` | array | ダウンタイムのリスト | + +### `datadog_cancel_downtime` + +スケジュールされたダウンタイムをキャンセルします。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `downtimeId` | string | はい | キャンセルするダウンタイムのID | +| `apiKey` | string | はい | Datadog APIキー | +| `applicationKey` | string | はい | Datadog アプリケーションキー | +| `site` | string | いいえ | Datadogサイト/リージョン \(デフォルト: datadoghq.com\) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | ダウンタイムが正常にキャンセルされたかどうか | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `datadog` diff --git a/apps/docs/content/docs/ja/tools/dropbox.mdx b/apps/docs/content/docs/ja/tools/dropbox.mdx new file mode 100644 index 000000000..a3163c026 --- /dev/null +++ b/apps/docs/content/docs/ja/tools/dropbox.mdx @@ -0,0 +1,219 @@ +--- +title: Dropbox +description: Dropboxでファイルのアップロード、ダウンロード、共有、管理を行う +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Dropbox](https://dropbox.com/)は、個人やチームがどこからでも安全にファイルを保存、アクセス、共有できる人気のクラウドストレージおよびコラボレーションプラットフォームです。Dropboxは、一人で作業する場合でもグループで作業する場合でも、簡単なファイル管理、同期、強力なコラボレーションのために設計されています。 + +SimでDropboxを使用すると、次のことができます： + +- **ファイルのアップロードとダウンロード**：あらゆるファイルをDropboxにシームレスにアップロードしたり、必要に応じてコンテンツを取得したりできます +- **フォルダの内容を一覧表示**：任意のDropboxディレクトリ内のファイルとフォルダを閲覧できます +- **新しいフォルダの作成**：プログラムでDropbox内に新しいフォルダを作成してファイルを整理できます +- **ファイルとフォルダの検索**：名前やコンテンツでドキュメント、画像、その他のアイテムを検索できます +- **共有リンクの生成**：ファイルやフォルダの公開または非公開の共有リンクを素早く作成できます +- **ファイルの管理**：自動化されたワークフローの一部としてファイルやフォルダの移動、削除、名前の変更ができます + +これらの機能により、Simエージェントは重要なファイルのバックアップからコンテンツの配布、整理されたフォルダの維持まで、ワークフロー内で直接Dropbox操作を自動化できます。Dropboxをファイルのソースと保存先の両方として使用することで、ビジネスプロセスの一部としてシームレスなクラウドストレージ管理が可能になります。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +ファイル管理、共有、コラボレーションのためにDropboxをワークフローに統合します。ファイルのアップロード、コンテンツのダウンロード、フォルダの作成、共有リンクの管理などが可能です。 + +## ツール + +### `dropbox_upload` + +Dropboxにファイルをアップロードする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `path` | string | はい | ファイルを保存するDropbox内のパス（例：/folder/document.pdf） | +| `fileContent` | string | はい | アップロードするファイルのbase64エンコードされたコンテンツ | +| `fileName` | string | いいえ | オプションのファイル名（パスがフォルダの場合に使用） | +| `mode` | string | いいえ | 書き込みモード：add（デフォルト）またはoverwrite | +| `autorename` | boolean | いいえ | trueの場合、競合がある場合にファイル名を変更します | +| `mute` | boolean | いいえ | trueの場合、このアップロードについてユーザーに通知しません | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `file` | object | アップロードされたファイルのメタデータ | + +### `dropbox_download` + +Dropboxからファイルをダウンロードして一時リンクを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `path` | string | はい | ダウンロードするファイルのパス（例：/folder/document.pdf） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `file` | object | ファイルのメタデータ | + +### `dropbox_list_folder` + +Dropbox内のフォルダの内容を一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `path` | string | はい | 一覧表示するフォルダのパス（ルートの場合は""を使用） | +| `recursive` | boolean | いいえ | trueの場合、内容を再帰的に一覧表示 | +| `includeDeleted` | boolean | いいえ | trueの場合、削除されたファイル/フォルダを含める | +| `includeMediaInfo` | boolean | いいえ | trueの場合、写真/動画のメディア情報を含める | +| `limit` | number | いいえ | 返す結果の最大数（デフォルト：500） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `entries` | array | ディレクトリ内のファイルとフォルダのリスト | + +### `dropbox_create_folder` + +Dropboxに新しいフォルダを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `path` | string | はい | フォルダを作成する場所のパス（例：/new-folder） | +| `autorename` | boolean | いいえ | trueの場合、競合があればフォルダの名前を変更する | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `folder` | object | 作成されたフォルダのメタデータ | + +### `dropbox_delete` + +Dropbox内のファイルまたはフォルダを削除する（ゴミ箱に移動） + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `path` | string | はい | 削除するファイルまたはフォルダのパス | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `metadata` | object | 削除されたアイテムのメタデータ | + +### `dropbox_copy` + +Dropbox内のファイルまたはフォルダをコピーする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `fromPath` | string | はい | コピーするファイルまたはフォルダのソースパス | +| `toPath` | string | はい | コピーされたファイルまたはフォルダの宛先パス | +| `autorename` | boolean | いいえ | trueの場合、宛先で競合があればファイル名を変更する | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `metadata` | object | コピーされたアイテムのメタデータ | + +### `dropbox_move` + +Dropbox内のファイルまたはフォルダを移動または名前変更する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `fromPath` | string | はい | 移動するファイルまたはフォルダのソースパス | +| `toPath` | string | はい | 移動されたファイルまたはフォルダの宛先パス | +| `autorename` | boolean | いいえ | trueの場合、宛先で競合があればファイル名を変更する | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `metadata` | object | 移動したアイテムのメタデータ | + +### `dropbox_get_metadata` + +Dropbox内のファイルまたはフォルダのメタデータを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `path` | string | はい | メタデータを取得するファイルまたはフォルダのパス | +| `includeMediaInfo` | boolean | いいえ | trueの場合、写真/動画のメディア情報を含める | +| `includeDeleted` | boolean | いいえ | trueの場合、結果に削除されたファイルを含める | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `metadata` | object | ファイルまたはフォルダのメタデータ | + +### `dropbox_create_shared_link` + +Dropbox内のファイルまたはフォルダの共有可能なリンクを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `path` | string | はい | 共有するファイルまたはフォルダのパス | +| `requestedVisibility` | string | いいえ | 可視性：public、team_only、またはpassword | +| `linkPassword` | string | いいえ | 共有リンクのパスワード（可視性がpasswordの場合のみ） | +| `expires` | string | いいえ | ISO 8601形式の有効期限（例：2025-12-31T23:59:59Z） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `sharedLink` | object | 作成された共有リンク | + +### `dropbox_search` + +Dropbox内のファイルとフォルダを検索 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `query` | string | はい | 検索クエリ | +| `path` | string | いいえ | 特定のフォルダパスに検索を制限 | +| `fileExtensions` | string | いいえ | フィルタリングするファイル拡張子のカンマ区切りリスト（例：pdf,xlsx） | +| `maxResults` | number | いいえ | 返す結果の最大数（デフォルト：100） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `matches` | array | 検索結果 | + +## 注意事項 + +- カテゴリ: `tools` +- タイプ: `dropbox` diff --git a/apps/docs/content/docs/ja/tools/elasticsearch.mdx b/apps/docs/content/docs/ja/tools/elasticsearch.mdx new file mode 100644 index 000000000..7d9cfefaf --- /dev/null +++ b/apps/docs/content/docs/ja/tools/elasticsearch.mdx @@ -0,0 +1,365 @@ +--- +title: Elasticsearch +description: Elasticsearchでデータの検索、インデックス作成、管理を行う +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Elasticsearch](https://www.elastic.co/elasticsearch/)は、大量のデータをリアルタイムでインデックス作成、検索、分析できる強力な分散型検索・分析エンジンです。検索機能、ログやイベントデータの分析、可観測性など、幅広い用途に利用されています。 + +SimのElasticsearchを使用すると、以下のような主要なElasticsearch機能にプログラムからアクセスできます： + +- **ドキュメント検索**: Query DSLを使用して構造化または非構造化テキストの高度な検索を実行し、ソート、ページネーション、フィールド選択をサポートします。 +- **ドキュメントのインデックス作成**: 新しいドキュメントを追加したり、任意のElasticsearchインデックス内の既存のドキュメントを更新したりして、即時に取得・分析できます。 +- **ドキュメントの取得、更新、削除**: IDによって特定のドキュメントを取得、変更、または削除します。 +- **一括操作**: 高スループットのデータ処理のために、単一のリクエストで複数のインデックス作成または更新アクションを実行します。 +- **インデックス管理**: ワークフロー自動化の一部として、インデックスの作成、削除、または詳細の取得を行います。 +- **クラスターモニタリング**: Elasticsearchデプロイメントの健全性と統計を確認します。 + +SimのElasticsearchツールは、セルフホスト型とElastic Cloudの両方の環境で動作します。Elasticsearchをエージェントワークフローに統合することで、データ取り込みの自動化、膨大なデータセットの検索、レポートの実行、検索機能を備えたカスタムアプリケーションの構築など、すべて手動介入なしで実行できます。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +強力な検索、インデックス作成、データ管理のためにElasticsearchをワークフローに統合します。ドキュメントのCRUD操作、高度な検索クエリ、一括操作、インデックス管理、クラスターモニタリングをサポートします。セルフホスト型とElastic Cloudの両方のデプロイメントで動作します。 + +## ツール + +### `elasticsearch_search` + +Query DSLを使用してElasticsearchでドキュメントを検索します。スコアとメタデータを含む一致するドキュメントを返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | はい | デプロイメントタイプ: self_hosted または cloud | +| `host` | string | いいえ | Elasticsearch ホストURL（self-hosted用） | +| `cloudId` | string | いいえ | Elastic Cloud ID（cloudデプロイメント用） | +| `authMethod` | string | はい | 認証方法: api_key または basic_auth | +| `apiKey` | string | いいえ | Elasticsearch APIキー | +| `username` | string | いいえ | 基本認証のユーザー名 | +| `password` | string | いいえ | 基本認証のパスワード | +| `index` | string | はい | 検索するインデックス名 | +| `query` | string | いいえ | JSON文字列としてのQuery DSL | +| `from` | number | いいえ | ページネーションの開始オフセット（デフォルト: 0） | +| `size` | number | いいえ | 返す結果の数（デフォルト: 10） | +| `sort` | string | いいえ | JSON文字列としてのソート指定 | +| `sourceIncludes` | string | いいえ | _sourceに含めるフィールドのカンマ区切りリスト | +| `sourceExcludes` | string | いいえ | _sourceから除外するフィールドのカンマ区切りリスト | +| `trackTotalHits` | boolean | いいえ | 正確なヒット数をカウントするかどうか（デフォルト: true） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `took` | number | 検索にかかった時間（ミリ秒） | +| `timed_out` | boolean | 検索がタイムアウトしたかどうか | +| `hits` | object | 合計カウントと一致するドキュメントを含む検索結果 | +| `aggregations` | json | 集計結果（ある場合） | + +### `elasticsearch_index_document` + +Elasticsearchにドキュメントをインデックス（作成または更新）します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | はい | デプロイメントタイプ: self_hosted または cloud | +| `host` | string | いいえ | Elasticsearch ホスト URL （self-hosted の場合） | +| `cloudId` | string | いいえ | Elastic Cloud ID （cloud デプロイメントの場合） | +| `authMethod` | string | はい | 認証方法: api_key または basic_auth | +| `apiKey` | string | いいえ | Elasticsearch API キー | +| `username` | string | いいえ | 基本認証のユーザー名 | +| `password` | string | いいえ | 基本認証のパスワード | +| `index` | string | はい | 対象インデックス名 | +| `documentId` | string | いいえ | ドキュメント ID （指定しない場合は自動生成） | +| `document` | string | はい | JSON 文字列としてのドキュメント本文 | +| `refresh` | string | いいえ | リフレッシュポリシー: true, false, または wait_for | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `_index` | string | ドキュメントが保存されたインデックス | +| `_id` | string | ドキュメント ID | +| `_version` | number | ドキュメントバージョン | +| `result` | string | 操作結果 （created または updated） | + +### `elasticsearch_get_document` + +Elasticsearchから ID によりドキュメントを取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | はい | デプロイメントタイプ: self_hosted または cloud | +| `host` | string | いいえ | Elasticsearch ホスト URL （self-hosted の場合） | +| `cloudId` | string | いいえ | Elastic Cloud ID （cloud デプロイメントの場合） | +| `authMethod` | string | はい | 認証方法: api_key または basic_auth | +| `apiKey` | string | いいえ | Elasticsearch API キー | +| `username` | string | いいえ | 基本認証のユーザー名 | +| `password` | string | いいえ | 基本認証のパスワード | +| `index` | string | はい | インデックス名 | +| `documentId` | string | はい | 取得するドキュメント ID | +| `sourceIncludes` | string | いいえ | 含めるフィールドのカンマ区切りリスト | +| `sourceExcludes` | string | いいえ | 除外するフィールドのカンマ区切りリスト | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `_index` | string | インデックス名 | +| `_id` | string | ドキュメントID | +| `_version` | number | ドキュメントバージョン | +| `found` | boolean | ドキュメントが見つかったかどうか | +| `_source` | json | ドキュメントの内容 | + +### `elasticsearch_update_document` + +docマージを使用してElasticsearchのドキュメントを部分的に更新します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | はい | デプロイメントタイプ: self_hosted または cloud | +| `host` | string | いいえ | Elasticsearch ホストURL（self_hosted用） | +| `cloudId` | string | いいえ | Elastic Cloud ID（cloudデプロイメント用） | +| `authMethod` | string | はい | 認証方法: api_key または basic_auth | +| `apiKey` | string | いいえ | Elasticsearch APIキー | +| `username` | string | いいえ | 基本認証のユーザー名 | +| `password` | string | いいえ | 基本認証のパスワード | +| `index` | string | はい | インデックス名 | +| `documentId` | string | はい | 更新するドキュメントID | +| `document` | string | はい | マージする部分的なドキュメント（JSON文字列形式） | +| `retryOnConflict` | number | いいえ | バージョン競合時の再試行回数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `_index` | string | インデックス名 | +| `_id` | string | ドキュメントID | +| `_version` | number | 新しいドキュメントバージョン | +| `result` | string | 操作結果（updated または noop） | + +### `elasticsearch_delete_document` + +IDによってElasticsearchからドキュメントを削除します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | はい | デプロイメントタイプ: self_hosted または cloud | +| `host` | string | いいえ | Elasticsearch ホスト URL （self-hosted の場合） | +| `cloudId` | string | いいえ | Elastic Cloud ID （cloud デプロイメントの場合） | +| `authMethod` | string | はい | 認証方法: api_key または basic_auth | +| `apiKey` | string | いいえ | Elasticsearch API キー | +| `username` | string | いいえ | 基本認証のユーザー名 | +| `password` | string | いいえ | 基本認証のパスワード | +| `index` | string | はい | インデックス名 | +| `documentId` | string | はい | 削除するドキュメントID | +| `refresh` | string | いいえ | リフレッシュポリシー: true、false、または wait_for | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `_index` | string | インデックス名 | +| `_id` | string | ドキュメントID | +| `_version` | number | ドキュメントバージョン | +| `result` | string | 操作結果（deleted または not_found） | + +### `elasticsearch_bulk` + +高パフォーマンスのために、複数のインデックス作成、削除、または更新操作を1つのリクエストで実行します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | はい | デプロイメントタイプ: self_hosted または cloud | +| `host` | string | いいえ | Elasticsearch ホスト URL （self-hosted の場合） | +| `cloudId` | string | いいえ | Elastic Cloud ID （cloud デプロイメントの場合） | +| `authMethod` | string | はい | 認証方法: api_key または basic_auth | +| `apiKey` | string | いいえ | Elasticsearch API キー | +| `username` | string | いいえ | 基本認証のユーザー名 | +| `password` | string | いいえ | 基本認証のパスワード | +| `index` | string | いいえ | インデックスを指定しない操作のデフォルトインデックス | +| `operations` | string | はい | NDJSON文字列（改行区切りJSON）としての一括操作 | +| `refresh` | string | いいえ | リフレッシュポリシー: true、false、または wait_for | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `took` | number | 一括操作にかかった時間（ミリ秒） | +| `errors` | boolean | いずれかの操作でエラーが発生したかどうか | +| `items` | array | 各操作の結果 | + +### `elasticsearch_count` + +Elasticsearchでクエリに一致するドキュメント数をカウントします。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | はい | デプロイメントタイプ: self_hosted または cloud | +| `host` | string | いいえ | Elasticsearch ホスト URL（self_hosted の場合） | +| `cloudId` | string | いいえ | Elastic Cloud ID（cloud デプロイメントの場合） | +| `authMethod` | string | はい | 認証方法: api_key または basic_auth | +| `apiKey` | string | いいえ | Elasticsearch API キー | +| `username` | string | いいえ | 基本認証のユーザー名 | +| `password` | string | いいえ | 基本認証のパスワード | +| `index` | string | はい | ドキュメントをカウントするインデックス名 | +| `query` | string | いいえ | ドキュメントをフィルタリングするオプションクエリ（JSON文字列） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `count` | number | クエリに一致するドキュメント数 | +| `_shards` | object | シャード統計 | + +### `elasticsearch_create_index` + +オプションの設定とマッピングを使用して新しいインデックスを作成します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | はい | デプロイメントタイプ: self_hosted または cloud | +| `host` | string | いいえ | Elasticsearch ホスト URL（self_hosted の場合） | +| `cloudId` | string | いいえ | Elastic Cloud ID（cloud デプロイメントの場合） | +| `authMethod` | string | はい | 認証方法: api_key または basic_auth | +| `apiKey` | string | いいえ | Elasticsearch API キー | +| `username` | string | いいえ | 基本認証のユーザー名 | +| `password` | string | いいえ | 基本認証のパスワード | +| `index` | string | はい | 作成するインデックス名 | +| `settings` | string | いいえ | JSON文字列としてのインデックス設定 | +| `mappings` | string | いいえ | JSON文字列としてのインデックスマッピング | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `acknowledged` | boolean | リクエストが承認されたかどうか | +| `shards_acknowledged` | boolean | シャードが承認されたかどうか | +| `index` | string | 作成されたインデックス名 | + +### `elasticsearch_delete_index` + +インデックスとそのすべてのドキュメントを削除します。この操作は元に戻せません。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | はい | デプロイメントタイプ: self_hosted または cloud | +| `host` | string | いいえ | Elasticsearch ホスト URL （self-hosted の場合） | +| `cloudId` | string | いいえ | Elastic Cloud ID （cloud デプロイメントの場合） | +| `authMethod` | string | はい | 認証方法: api_key または basic_auth | +| `apiKey` | string | いいえ | Elasticsearch API キー | +| `username` | string | いいえ | 基本認証のユーザー名 | +| `password` | string | いいえ | 基本認証のパスワード | +| `index` | string | はい | 削除するインデックス名 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `acknowledged` | boolean | 削除が承認されたかどうか | + +### `elasticsearch_get_index` + +設定、マッピング、エイリアスを含むインデックス情報を取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | はい | デプロイメントタイプ: self_hosted または cloud | +| `host` | string | いいえ | Elasticsearch ホスト URL （self-hosted の場合） | +| `cloudId` | string | いいえ | Elastic Cloud ID （cloud デプロイメントの場合） | +| `authMethod` | string | はい | 認証方法: api_key または basic_auth | +| `apiKey` | string | いいえ | Elasticsearch API キー | +| `username` | string | いいえ | 基本認証のユーザー名 | +| `password` | string | いいえ | 基本認証のパスワード | +| `index` | string | はい | 情報を取得するインデックス名 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `index` | json | エイリアス、マッピング、設定を含むインデックス情報 | + +### `elasticsearch_cluster_health` + +Elasticsearchクラスターの健全性ステータスを取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | はい | デプロイメントタイプ: self_hosted または cloud | +| `host` | string | いいえ | Elasticsearch ホスト URL \(self_hosted の場合\) | +| `cloudId` | string | いいえ | Elastic Cloud ID \(cloud デプロイメントの場合\) | +| `authMethod` | string | はい | 認証方法: api_key または basic_auth | +| `apiKey` | string | いいえ | Elasticsearch API キー | +| `username` | string | いいえ | 基本認証のユーザー名 | +| `password` | string | いいえ | 基本認証のパスワード | +| `waitForStatus` | string | いいえ | クラスターがこのステータスに達するまで待機: green、yellow、または red | +| `timeout` | string | いいえ | 待機操作のタイムアウト \(例: 30s、1m\) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `cluster_name` | string | クラスターの名前 | +| `status` | string | クラスターの健全性ステータス: green、yellow、または red | +| `number_of_nodes` | number | クラスター内のノードの総数 | +| `number_of_data_nodes` | number | データノードの数 | +| `active_shards` | number | アクティブなシャードの数 | +| `unassigned_shards` | number | 未割り当てのシャードの数 | + +### `elasticsearch_cluster_stats` + +Elasticsearchクラスターに関する包括的な統計情報を取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | はい | デプロイメントタイプ: self_hosted または cloud | +| `host` | string | いいえ | Elasticsearch ホスト URL （self-hosted の場合） | +| `cloudId` | string | いいえ | Elastic Cloud ID （cloud デプロイメントの場合） | +| `authMethod` | string | はい | 認証方法: api_key または basic_auth | +| `apiKey` | string | いいえ | Elasticsearch API キー | +| `username` | string | いいえ | 基本認証のユーザー名 | +| `password` | string | いいえ | 基本認証のパスワード | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `cluster_name` | string | クラスターの名前 | +| `status` | string | クラスターの健全性ステータス | +| `nodes` | object | ノード数とバージョンを含むノード統計 | +| `indices` | object | ドキュメント数とストアサイズを含むインデックス統計 | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `elasticsearch` diff --git a/apps/docs/content/docs/ja/tools/gitlab.mdx b/apps/docs/content/docs/ja/tools/gitlab.mdx new file mode 100644 index 000000000..de56510a9 --- /dev/null +++ b/apps/docs/content/docs/ja/tools/gitlab.mdx @@ -0,0 +1,429 @@ +--- +title: GitLab +description: GitLabのプロジェクト、課題、マージリクエスト、パイプラインとやり取りする +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[GitLab](https://gitlab.com/)は、チームがソフトウェア開発ライフサイクルを管理、共同作業、自動化できる包括的なDevOpsプラットフォームです。GitLabを使用すると、ソースコード管理、CI/CD、レビュー、コラボレーションを単一のアプリケーションで簡単に処理できます。 + +SimでGitLabを使用すると、以下のことができます： + +- **プロジェクトとリポジトリの管理**：GitLabプロジェクトの一覧表示と取得、詳細へのアクセス、リポジトリの整理 +- **課題の操作**：作業を追跡し効果的に共同作業するための課題の一覧表示、作成、コメント +- **マージリクエストの処理**：コード変更とピアレビューのためのマージリクエストのレビュー、作成、管理 +- **CI/CDパイプラインの自動化**：自動化フローの一部としてGitLabパイプラインのトリガー、監視、操作 +- **コメントによる共同作業**：チーム内の効率的なコミュニケーションのために課題やマージリクエストにコメントを追加 + +SimのGitLab統合を使用すると、エージェントはプログラムでGitLabプロジェクトとやり取りできます。プロジェクト管理、課題追跡、コードレビュー、パイプライン操作をワークフローでシームレスに自動化し、ソフトウェア開発プロセスを最適化し、チーム全体のコラボレーションを強化します。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +GitLabをワークフローに統合します。プロジェクト、課題、マージリクエスト、パイプライン、コメントを管理できます。GitLabのすべての主要なDevOps操作をサポートしています。 + +## ツール + +### `gitlab_list_projects` + +認証されたユーザーがアクセスできるGitLabプロジェクトを一覧表示 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `owned` | boolean | いいえ | 現在のユーザーが所有するプロジェクトに限定 | +| `membership` | boolean | いいえ | 現在のユーザーがメンバーであるプロジェクトに限定 | +| `search` | string | いいえ | 名前でプロジェクトを検索 | +| `visibility` | string | いいえ | 可視性でフィルタリング（public、internal、private） | +| `orderBy` | string | いいえ | フィールドで並べ替え（id、name、path、created_at、updated_at、last_activity_at） | +| `sort` | string | いいえ | 並べ替え方向（asc、desc） | +| `perPage` | number | いいえ | ページあたりの結果数（デフォルト20、最大100） | +| `page` | number | いいえ | ページネーションのページ番号 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `projects` | array | GitLabプロジェクトのリスト | +| `total` | number | プロジェクトの総数 | + +### `gitlab_get_project` + +特定のGitLabプロジェクトの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス（例："namespace/project"） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `project` | object | GitLabプロジェクトの詳細 | + +### `gitlab_list_issues` + +GitLabプロジェクト内の課題を一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `state` | string | いいえ | 状態によるフィルタリング（opened、closed、all） | +| `labels` | string | いいえ | カンマ区切りのラベル名リスト | +| `assigneeId` | number | いいえ | 担当者ユーザーIDによるフィルタリング | +| `milestoneTitle` | string | いいえ | マイルストーンタイトルによるフィルタリング | +| `search` | string | いいえ | タイトルと説明で課題を検索 | +| `orderBy` | string | いいえ | フィールドによる並べ替え（created_at、updated_at） | +| `sort` | string | いいえ | 並べ替え方向（asc、desc） | +| `perPage` | number | いいえ | ページあたりの結果数（デフォルト20、最大100） | +| `page` | number | いいえ | ページネーションのページ番号 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `issues` | array | GitLab課題のリスト | +| `total` | number | 課題の総数 | + +### `gitlab_get_issue` + +特定のGitLab課題の詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `issueIid` | number | はい | プロジェクト内の課題番号（GitLab UIに表示される#） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `issue` | object | GitLab課題の詳細 | + +### `gitlab_create_issue` + +GitLabプロジェクトに新しい課題を作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `title` | string | はい | 課題のタイトル | +| `description` | string | いいえ | 課題の説明（Markdown対応） | +| `labels` | string | いいえ | カンマ区切りのラベル名リスト | +| `assigneeIds` | array | いいえ | 割り当てるユーザーIDの配列 | +| `milestoneId` | number | いいえ | 割り当てるマイルストーンID | +| `dueDate` | string | いいえ | YYYY-MM-DD形式の期限日 | +| `confidential` | boolean | いいえ | 課題が機密扱いかどうか | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `issue` | object | 作成されたGitLab課題 | + +### `gitlab_update_issue` + +GitLabプロジェクト内の既存の課題を更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `issueIid` | number | はい | 課題内部ID（IID） | +| `title` | string | いいえ | 新しい課題のタイトル | +| `description` | string | いいえ | 新しい課題の説明（Markdown対応） | +| `stateEvent` | string | いいえ | 状態イベント（closeまたはreopen） | +| `labels` | string | いいえ | カンマ区切りのラベル名リスト | +| `assigneeIds` | array | いいえ | 割り当てるユーザーIDの配列 | +| `milestoneId` | number | いいえ | 割り当てるマイルストーンID | +| `dueDate` | string | いいえ | YYYY-MM-DD形式の期限日 | +| `confidential` | boolean | いいえ | 課題が機密扱いかどうか | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `issue` | object | 更新されたGitLab課題 | + +### `gitlab_delete_issue` + +GitLabプロジェクトから課題を削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `issueIid` | number | はい | 課題内部ID（IID） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 課題が正常に削除されたかどうか | + +### `gitlab_create_issue_note` + +GitLab課題にコメントを追加する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `issueIid` | number | はい | 課題の内部ID（IID） | +| `body` | string | はい | コメント本文（Markdown対応） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `note` | object | 作成されたコメント | + +### `gitlab_list_merge_requests` + +GitLabプロジェクトのマージリクエスト一覧を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `state` | string | いいえ | 状態によるフィルタリング（opened、closed、merged、all） | +| `labels` | string | いいえ | カンマ区切りのラベル名リスト | +| `sourceBranch` | string | いいえ | ソースブランチによるフィルタリング | +| `targetBranch` | string | いいえ | ターゲットブランチによるフィルタリング | +| `orderBy` | string | いいえ | 並べ替えフィールド（created_at、updated_at） | +| `sort` | string | いいえ | 並べ替え方向（asc、desc） | +| `perPage` | number | いいえ | ページあたりの結果数（デフォルト20、最大100） | +| `page` | number | いいえ | ページネーションのページ番号 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `mergeRequests` | array | GitLabマージリクエストのリスト | +| `total` | number | マージリクエストの総数 | + +### `gitlab_get_merge_request` + +特定のGitLabマージリクエストの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `mergeRequestIid` | number | はい | マージリクエスト内部ID（IID） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `mergeRequest` | object | GitLabマージリクエストの詳細 | + +### `gitlab_create_merge_request` + +GitLabプロジェクトに新しいマージリクエストを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `sourceBranch` | string | はい | ソースブランチ名 | +| `targetBranch` | string | はい | ターゲットブランチ名 | +| `title` | string | はい | マージリクエストのタイトル | +| `description` | string | いいえ | マージリクエストの説明（Markdown対応） | +| `labels` | string | いいえ | カンマ区切りのラベル名リスト | +| `assigneeIds` | array | いいえ | 割り当てるユーザーIDの配列 | +| `milestoneId` | number | いいえ | 割り当てるマイルストーンID | +| `removeSourceBranch` | boolean | いいえ | マージ後にソースブランチを削除する | +| `squash` | boolean | いいえ | マージ時にコミットをスカッシュする | +| `draft` | boolean | いいえ | 下書き（作業中）としてマークする | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `mergeRequest` | object | 作成されたGitLabマージリクエスト | + +### `gitlab_update_merge_request` + +GitLabプロジェクトの既存のマージリクエストを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `mergeRequestIid` | number | はい | マージリクエスト内部ID（IID） | +| `title` | string | いいえ | 新しいマージリクエストのタイトル | +| `description` | string | いいえ | 新しいマージリクエストの説明 | +| `stateEvent` | string | いいえ | 状態イベント（closeまたはreopen） | +| `labels` | string | いいえ | カンマ区切りのラベル名リスト | +| `assigneeIds` | array | いいえ | 割り当てるユーザーIDの配列 | +| `milestoneId` | number | いいえ | 割り当てるマイルストーンID | +| `targetBranch` | string | いいえ | 新しいターゲットブランチ | +| `removeSourceBranch` | boolean | いいえ | マージ後にソースブランチを削除する | +| `squash` | boolean | いいえ | マージ時にコミットをスカッシュする | +| `draft` | boolean | いいえ | 下書き（作業中）としてマークする | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `mergeRequest` | object | 更新されたGitLabマージリクエスト | + +### `gitlab_merge_merge_request` + +GitLabプロジェクトでマージリクエストをマージする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `mergeRequestIid` | number | はい | マージリクエスト内部ID（IID） | +| `mergeCommitMessage` | string | いいえ | カスタムマージコミットメッセージ | +| `squashCommitMessage` | string | いいえ | カスタムスカッシュコミットメッセージ | +| `squash` | boolean | いいえ | マージ前にコミットをスカッシュする | +| `shouldRemoveSourceBranch` | boolean | いいえ | マージ後にソースブランチを削除する | +| `mergeWhenPipelineSucceeds` | boolean | いいえ | パイプラインが成功したらマージする | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `mergeRequest` | object | マージされたGitLabマージリクエスト | + +### `gitlab_create_merge_request_note` + +GitLabマージリクエストにコメントを追加する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `mergeRequestIid` | number | はい | マージリクエスト内部ID（IID） | +| `body` | string | はい | コメント本文（Markdown対応） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `note` | object | 作成されたコメント | + +### `gitlab_list_pipelines` + +GitLabプロジェクト内のパイプラインを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `ref` | string | いいえ | ref（ブランチまたはタグ）でフィルタリング | +| `status` | string | いいえ | ステータスでフィルタリング（created, waiting_for_resource, preparing, pending, running, success, failed, canceled, skipped, manual, scheduled） | +| `orderBy` | string | いいえ | フィールドで並べ替え（id, status, ref, updated_at, user_id） | +| `sort` | string | いいえ | 並べ替え方向（asc, desc） | +| `perPage` | number | いいえ | ページあたりの結果数（デフォルト20、最大100） | +| `page` | number | いいえ | ページネーションのページ番号 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `pipelines` | array | GitLabパイプラインのリスト | +| `total` | number | パイプラインの総数 | + +### `gitlab_get_pipeline` + +特定のGitLabパイプラインの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `pipelineId` | number | はい | パイプラインID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `pipeline` | object | GitLabパイプラインの詳細 | + +### `gitlab_create_pipeline` + +GitLabプロジェクトで新しいパイプラインをトリガーする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `ref` | string | はい | パイプラインを実行するブランチまたはタグ | +| `variables` | array | いいえ | パイプラインの変数の配列（各変数はkey、value、およびオプションのvariable_typeを持つ） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `pipeline` | object | 作成されたGitLabパイプライン | + +### `gitlab_retry_pipeline` + +失敗したGitLabパイプラインを再試行する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `pipelineId` | number | はい | パイプラインID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `pipeline` | object | 再試行されたGitLabパイプライン | + +### `gitlab_cancel_pipeline` + +実行中のGitLabパイプラインをキャンセルする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス | +| `pipelineId` | number | はい | パイプラインID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `pipeline` | object | キャンセルされたGitLabパイプライン | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `gitlab` diff --git a/apps/docs/content/docs/ja/tools/grafana.mdx b/apps/docs/content/docs/ja/tools/grafana.mdx new file mode 100644 index 000000000..50b253141 --- /dev/null +++ b/apps/docs/content/docs/ja/tools/grafana.mdx @@ -0,0 +1,494 @@ +--- +title: Grafana +description: Grafanaダッシュボード、アラート、アノテーションを操作する +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Grafana](https://grafana.com/)は、モニタリング、可観測性、視覚化のための主要なオープンソースプラットフォームです。さまざまなソースからのデータのクエリ、視覚化、アラート、分析を可能にし、インフラストラクチャとアプリケーションのモニタリングに不可欠なツールとなっています。 + +Grafanaでは以下のことができます： + +- **データの視覚化**：メトリクス、ログ、トレースをリアルタイムで表示するためのダッシュボードを構築・カスタマイズ +- **健全性とステータスの監視**：Grafanaインスタンスと接続されたデータソースの健全性をチェック +- **アラートとアノテーションの管理**：アラートルールの設定、通知の管理、重要なイベントでダッシュボードにアノテーションを付ける +- **コンテンツの整理**：より良いアクセス管理のためにダッシュボードとデータソースをフォルダに整理 + +Simでは、Grafana統合によりエージェントがAPI経由でGrafanaインスタンスと直接やり取りできるようになり、以下のようなアクションが可能になります： + +- Grafanaサーバー、データベース、データソースの健全性ステータスの確認 +- ダッシュボード、アラートルール、アノテーション、データソース、フォルダの取得、一覧表示、管理 +- Grafanaデータとアラートをワークフロー自動化に統合することによるインフラストラクチャのモニタリングの自動化 + +これらの機能により、Simエージェントはシステムを監視し、アラートに積極的に対応し、自動化されたワークフローの一部として、サービスの信頼性と可視性を確保するのに役立ちます。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +Grafanaをワークフローに統合します。ダッシュボード、アラート、アノテーション、データソース、フォルダを管理し、健全性ステータスを監視します。 + +## ツール + +### `grafana_get_dashboard` + +UIDでダッシュボードを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンスの組織ID | +| `dashboardUid` | string | はい | 取得するダッシュボードのUID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `dashboard` | json | 完全なダッシュボードJSONオブジェクト | +| `meta` | json | ダッシュボードのメタデータ（バージョン、権限など） | + +### `grafana_list_dashboards` + +すべてのダッシュボードを検索およびリスト表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | +| `query` | string | いいえ | タイトルでダッシュボードをフィルタリングする検索クエリ | +| `tag` | string | いいえ | タグでフィルタリング（複数のタグはカンマ区切り） | +| `folderIds` | string | いいえ | フォルダIDでフィルタリング（カンマ区切り） | +| `starred` | boolean | いいえ | スター付きダッシュボードのみを返す | +| `limit` | number | いいえ | 返すダッシュボードの最大数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `dashboards` | array | ダッシュボード検索結果のリスト | + +### `grafana_create_dashboard` + +新しいダッシュボードを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | +| `title` | string | はい | 新しいダッシュボードのタイトル | +| `folderUid` | string | いいえ | ダッシュボードを作成するフォルダのUID | +| `tags` | string | いいえ | カンマ区切りのタグリスト | +| `timezone` | string | いいえ | ダッシュボードのタイムゾーン（例：browser、utc） | +| `refresh` | string | いいえ | 自動更新間隔（例：5s、1m、5m） | +| `panels` | string | いいえ | パネル設定のJSON配列 | +| `overwrite` | boolean | いいえ | 同じタイトルの既存ダッシュボードを上書きする | +| `message` | string | いいえ | ダッシュボードバージョンのコミットメッセージ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | number | 作成されたダッシュボードの数値ID | +| `uid` | string | 作成されたダッシュボードのUID | +| `url` | string | ダッシュボードへのURLパス | +| `status` | string | 操作のステータス（success） | +| `version` | number | ダッシュボードのバージョン番号 | +| `slug` | string | ダッシュボードのURL用スラッグ | + +### `grafana_update_dashboard` + +既存のダッシュボードを更新します。現在のダッシュボードを取得し、変更内容をマージします。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスのURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | +| `dashboardUid` | string | はい | 更新するダッシュボードのUID | +| `title` | string | いいえ | ダッシュボードの新しいタイトル | +| `folderUid` | string | いいえ | ダッシュボードを移動する新しいフォルダのUID | +| `tags` | string | いいえ | 新しいタグのカンマ区切りリスト | +| `timezone` | string | いいえ | ダッシュボードのタイムゾーン（例：browser、utc） | +| `refresh` | string | いいえ | 自動更新間隔（例：5s、1m、5m） | +| `panels` | string | いいえ | パネル設定のJSON配列 | +| `overwrite` | boolean | いいえ | バージョンの競合があっても上書きする | +| `message` | string | いいえ | このバージョンのコミットメッセージ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | number | 更新されたダッシュボードの数値ID | +| `uid` | string | 更新されたダッシュボードのUID | +| `url` | string | ダッシュボードへのURLパス | +| `status` | string | 操作のステータス（success） | +| `version` | number | ダッシュボードの新しいバージョン番号 | +| `slug` | string | ダッシュボードのURL用スラッグ | + +### `grafana_delete_dashboard` + +UIDでダッシュボードを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | +| `dashboardUid` | string | はい | 削除するダッシュボードのUID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `title` | string | 削除されたダッシュボードのタイトル | +| `message` | string | 確認メッセージ | +| `id` | number | 削除されたダッシュボードのID | + +### `grafana_list_alert_rules` + +Grafanaインスタンス内のすべてのアラートルールを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `rules` | array | アラートルールのリスト | + +### `grafana_get_alert_rule` + +UIDによって特定のアラートルールを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | +| `alertRuleUid` | string | はい | 取得するアラートルールのUID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `uid` | string | アラートルールUID | +| `title` | string | アラートルールタイトル | +| `condition` | string | アラート条件 | +| `data` | json | アラートルールクエリデータ | +| `folderUID` | string | 親フォルダUID | +| `ruleGroup` | string | ルールグループ名 | +| `noDataState` | string | データが返されない場合の状態 | +| `execErrState` | string | 実行エラー時の状態 | +| `annotations` | json | アラート注釈 | +| `labels` | json | アラートラベル | + +### `grafana_create_alert_rule` + +新しいアラートルールを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | +| `title` | string | はい | アラートルールのタイトル | +| `folderUid` | string | はい | アラートを作成するフォルダのUID | +| `ruleGroup` | string | はい | ルールグループの名前 | +| `condition` | string | はい | アラート条件として使用するクエリまたは式のrefId | +| `data` | string | はい | クエリ/式データオブジェクトのJSON配列 | +| `forDuration` | string | いいえ | 発火前の待機時間（例：5m、1h） | +| `noDataState` | string | いいえ | データが返されない場合の状態（NoData、Alerting、OK） | +| `execErrState` | string | いいえ | 実行エラー時の状態（Alerting、OK） | +| `annotations` | string | いいえ | 注釈のJSONオブジェクト | +| `labels` | string | いいえ | ラベルのJSONオブジェクト | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `uid` | string | 作成されたアラートルールのUID | +| `title` | string | アラートルールのタイトル | +| `folderUID` | string | 親フォルダのUID | +| `ruleGroup` | string | ルールグループ名 | + +### `grafana_update_alert_rule` + +既存のアラートルールを更新します。現在のルールを取得し、変更内容をマージします。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスのURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンスの組織ID | +| `alertRuleUid` | string | はい | 更新するアラートルールのUID | +| `title` | string | いいえ | アラートルールの新しいタイトル | +| `folderUid` | string | いいえ | アラートを移動する新しいフォルダのUID | +| `ruleGroup` | string | いいえ | 新しいルールグループ名 | +| `condition` | string | いいえ | 新しい条件のrefId | +| `data` | string | いいえ | クエリ/式データオブジェクトの新しいJSON配列 | +| `forDuration` | string | いいえ | アラートを発生させるまでの待機時間（例：5m、1h） | +| `noDataState` | string | いいえ | データが返されない場合の状態（NoData、Alerting、OK） | +| `execErrState` | string | いいえ | 実行エラー時の状態（Alerting、OK） | +| `annotations` | string | いいえ | アノテーションのJSONオブジェクト | +| `labels` | string | いいえ | ラベルのJSONオブジェクト | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `uid` | string | 更新されたアラートルールのUID | +| `title` | string | アラートルールのタイトル | +| `folderUID` | string | 親フォルダのUID | +| `ruleGroup` | string | ルールグループ名 | + +### `grafana_delete_alert_rule` + +UIDによるアラートルールの削除 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンスの組織ID | +| `alertRuleUid` | string | はい | 削除するアラートルールのUID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `message` | string | 確認メッセージ | + +### `grafana_list_contact_points` + +すべてのアラート通知コンタクトポイントの一覧表示 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンスの組織ID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `contactPoints` | array | コンタクトポイントのリスト | + +### `grafana_create_annotation` + +ダッシュボード上または全体的なアノテーションとしてアノテーションを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | +| `text` | string | はい | アノテーションのテキスト内容 | +| `tags` | string | いいえ | カンマ区切りのタグリスト | +| `dashboardUid` | string | いいえ | アノテーションを追加するダッシュボードのUID（全体的なアノテーションの場合はオプション） | +| `panelId` | number | いいえ | アノテーションを追加するパネルのID | +| `time` | number | いいえ | エポックミリ秒での開始時間（デフォルトは現在） | +| `timeEnd` | number | いいえ | エポックミリ秒での終了時間（範囲アノテーション用） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | number | 作成されたアノテーションのID | +| `message` | string | 確認メッセージ | + +### `grafana_list_annotations` + +時間範囲、ダッシュボード、またはタグでアノテーションを検索する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | +| `from` | number | いいえ | エポックミリ秒での開始時間 | +| `to` | number | いいえ | エポックミリ秒での終了時間 | +| `dashboardUid` | string | いいえ | ダッシュボードUIDでフィルタリング | +| `panelId` | number | いいえ | パネルIDでフィルタリング | +| `tags` | string | いいえ | フィルタリングするタグのカンマ区切りリスト | +| `type` | string | いいえ | タイプでフィルタリング（アラートまたはアノテーション） | +| `limit` | number | いいえ | 返すアノテーションの最大数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `annotations` | array | アノテーションのリスト | + +### `grafana_update_annotation` + +既存のアノテーションを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | +| `annotationId` | number | はい | 更新するアノテーションのID | +| `text` | string | はい | アノテーションの新しいテキスト内容 | +| `tags` | string | いいえ | 新しいタグのカンマ区切りリスト | +| `time` | number | いいえ | エポックミリ秒での新しい開始時間 | +| `timeEnd` | number | いいえ | エポックミリ秒での新しい終了時間 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | number | 更新されたアノテーションのID | +| `message` | string | 確認メッセージ | + +### `grafana_delete_annotation` + +IDでアノテーションを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | +| `annotationId` | number | はい | 削除するアノテーションのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `message` | string | 確認メッセージ | + +### `grafana_list_data_sources` + +Grafanaで設定されているすべてのデータソースを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `dataSources` | array | データソースのリスト | + +### `grafana_get_data_source` + +IDまたはUIDでデータソースを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | +| `dataSourceId` | string | はい | 取得するデータソースのIDまたはUID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | number | データソースID | +| `uid` | string | データソースUID | +| `name` | string | データソース名 | +| `type` | string | データソースタイプ | +| `url` | string | データソース接続URL | +| `database` | string | データベース名（該当する場合） | +| `isDefault` | boolean | これがデフォルトのデータソースかどうか | +| `jsonData` | json | 追加のデータソース設定 | + +### `grafana_list_folders` + +Grafanaのすべてのフォルダを一覧表示 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | +| `limit` | number | いいえ | 返すフォルダの最大数 | +| `page` | number | いいえ | ページネーション用のページ番号 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `folders` | array | フォルダのリスト | + +### `grafana_create_folder` + +Grafanaに新しいフォルダを作成 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Grafanaサービスアカウントトークン | +| `baseUrl` | string | はい | GrafanaインスタンスURL（例：https://your-grafana.com） | +| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID | +| `title` | string | はい | 新しいフォルダのタイトル | +| `uid` | string | いいえ | フォルダのオプションUID（提供されない場合は自動生成） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | number | 作成されたフォルダの数値ID | +| `uid` | string | 作成されたフォルダのUID | +| `title` | string | 作成されたフォルダのタイトル | +| `url` | string | フォルダへのURLパス | + +## メモ + +- カテゴリー: `tools` +- タイプ: `grafana` diff --git a/apps/docs/content/docs/ja/tools/kalshi.mdx b/apps/docs/content/docs/ja/tools/kalshi.mdx new file mode 100644 index 000000000..5048fc9a6 --- /dev/null +++ b/apps/docs/content/docs/ja/tools/kalshi.mdx @@ -0,0 +1,295 @@ +--- +title: Kalshi +description: Kalshiの予測市場データにアクセス +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Kalshi](https://kalshi.com)は連邦政府の規制を受けた取引所で、ユーザーは将来のイベントの結果に直接取引できる予測市場です。KalshiのロバストなAPIとSimの統合により、エージェントやワークフローがプラットフォームのあらゆる側面にプログラム的にアクセスでき、調査や分析から自動取引や監視まで、すべてをサポートします。 + +SimにおけるKalshiの統合により、以下のことが可能になります： + +- **市場とイベントデータ：** 市場やイベントのリアルタイムおよび過去のデータを検索、フィルタリング、取得。市場の状態、シリーズ、イベントグループなどの詳細情報を取得。 +- **アカウントと残高管理：** アカウント残高、利用可能な資金へのアクセス、リアルタイムのオープンポジションの監視。 +- **注文と取引管理：** 新規注文の発注、既存注文のキャンセル、オープン注文の表示、リアルタイムの注文板の取得、完全な取引履歴へのアクセス。 +- **実行分析：** 最近の取引、過去の約定、バックテストや市場構造研究のためのローソク足データの取得。 +- **監視：** 取引所全体またはシリーズレベルのステータスの確認、市場の変化や取引停止に関するリアルタイム更新の受信、自動応答の設定。 +- **自動化対応：** 実世界のイベント確率を消費、分析、取引する完全自動化されたエージェントやダッシュボードの構築。 + +これらの統合されたツールとエンドポイントを使用することで、Kalshiの予測市場、リアルタイム取引機能、詳細なイベントデータをAIを活用したアプリケーション、ダッシュボード、ワークフローにシームレスに組み込むことができ、実世界の結果に結びついた高度な自動意思決定を可能にします。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +Kalshi予測市場をワークフローに統合します。市場一覧、特定の市場、イベント一覧、特定のイベント、残高、ポジション、注文、注文板、取引、ローソク足チャート、約定、シリーズ、取引所のステータスを取得できます。 + +## ツール + +### `kalshi_get_markets` + +オプションのフィルタリングを使用してKalshiから予測市場のリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `status` | string | いいえ | ステータスでフィルタリング（unopened、open、closed、settled） | +| `seriesTicker` | string | いいえ | シリーズティッカーでフィルタリング | +| `eventTicker` | string | いいえ | イベントティッカーでフィルタリング | +| `limit` | string | いいえ | 結果の数（1-1000、デフォルト：100） | +| `cursor` | string | いいえ | 次のページのページネーションカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 市場データとメタデータ | + +### `kalshi_get_market` + +ティッカーで特定の予測市場の詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `ticker` | string | はい | 市場ティッカー（例："KXBTC-24DEC31"） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 市場データとメタデータ | + +### `kalshi_get_events` + +オプションのフィルタリングを使用してKalshiからイベントのリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `status` | string | いいえ | ステータスでフィルタリング（open、closed、settled） | +| `seriesTicker` | string | いいえ | シリーズティッカーでフィルタリング | +| `withNestedMarkets` | string | いいえ | レスポンスにネストされた市場を含める（true/false） | +| `limit` | string | いいえ | 結果の数（1-200、デフォルト：200） | +| `cursor` | string | いいえ | 次のページのページネーションカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | イベントデータとメタデータ | + +### `kalshi_get_event` + +ティッカーで特定のイベントの詳細を取得 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `eventTicker` | string | はい | イベントティッカー | +| `withNestedMarkets` | string | いいえ | レスポンスにネストされたマーケットを含める（true/false） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | イベントデータとメタデータ | + +### `kalshi_get_balance` + +Kalshiからアカウント残高とポートフォリオ価値を取得 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | はい | あなたのKalshi APIキーID | +| `privateKey` | string | はい | あなたのRSA秘密鍵（PEM形式） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 残高データとメタデータ | + +### `kalshi_get_positions` + +Kalshiからオープンポジションを取得 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | はい | あなたのKalshi APIキーID | +| `privateKey` | string | はい | あなたのRSA秘密鍵（PEM形式） | +| `ticker` | string | いいえ | マーケットティッカーでフィルタリング | +| `eventTicker` | string | いいえ | イベントティッカーでフィルタリング（最大10個のカンマ区切り） | +| `settlementStatus` | string | いいえ | 決済ステータスでフィルタリング（all、unsettled、settled）。デフォルト：unsettled | +| `limit` | string | いいえ | 結果の数（1-1000、デフォルト：100） | +| `cursor` | string | いいえ | 次ページのページネーションカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | ポジションデータとメタデータ | + +### `kalshi_get_orders` + +オプションのフィルタリングを使用してKalshiから注文を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | はい | あなたのKalshi APIキーID | +| `privateKey` | string | はい | あなたのRSA秘密鍵（PEM形式） | +| `ticker` | string | いいえ | マーケットティッカーでフィルタリング | +| `eventTicker` | string | いいえ | イベントティッカーでフィルタリング（最大10個のカンマ区切り） | +| `status` | string | いいえ | ステータスでフィルタリング（resting、canceled、executed） | +| `limit` | string | いいえ | 結果の数（1-200、デフォルト：100） | +| `cursor` | string | いいえ | 次ページのページネーションカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 注文データとメタデータ | + +### `kalshi_get_orderbook` + +特定のマーケットの注文板（買い注文と売り注文）を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `ticker` | string | はい | マーケットティッカー（例：KXBTC-24DEC31） | +| `depth` | number | いいえ | 各サイドで返す価格レベルの数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | オーダーブックデータとメタデータ | + +### `kalshi_get_trades` + +すべての市場または特定の市場における最近の取引を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `ticker` | string | いいえ | 市場ティッカーでフィルタリング | +| `minTs` | number | いいえ | 最小タイムスタンプ（Unixミリ秒） | +| `maxTs` | number | いいえ | 最大タイムスタンプ（Unixミリ秒） | +| `limit` | string | いいえ | 結果数（1-1000、デフォルト：100） | +| `cursor` | string | いいえ | 次ページのページネーションカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 取引データとメタデータ | + +### `kalshi_get_candlesticks` + +特定の市場のOHLCローソク足データを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `seriesTicker` | string | はい | シリーズティッカー | +| `ticker` | string | はい | 市場ティッカー（例：KXBTC-24DEC31） | +| `startTs` | number | いいえ | 開始タイムスタンプ（Unixミリ秒） | +| `endTs` | number | いいえ | 終了タイムスタンプ（Unixミリ秒） | +| `periodInterval` | number | いいえ | 期間間隔：1（1分）、60（1時間）、または1440（1日） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | ローソク足データとメタデータ | + +### `kalshi_get_fills` + +ポートフォリオを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | はい | Kalshi API キーID | +| `privateKey` | string | はい | RSA秘密鍵（PEM形式） | +| `ticker` | string | いいえ | マーケットティッカーでフィルタリング | +| `orderId` | string | いいえ | 注文IDでフィルタリング | +| `minTs` | number | いいえ | 最小タイムスタンプ（Unixミリ秒） | +| `maxTs` | number | いいえ | 最大タイムスタンプ（Unixミリ秒） | +| `limit` | string | いいえ | 結果数（1-1000、デフォルト：100） | +| `cursor` | string | いいえ | 次ページのページネーションカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 約定データとメタデータ | + +### `kalshi_get_series_by_ticker` + +ティッカーで特定のマーケットシリーズの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `seriesTicker` | string | はい | シリーズティッカー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | シリーズデータとメタデータ | + +### `kalshi_get_exchange_status` + +Kalshi取引所の現在のステータス（取引と取引所のアクティビティ）を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 取引所ステータスデータとメタデータ | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `kalshi` diff --git a/apps/docs/content/docs/ja/tools/polymarket.mdx b/apps/docs/content/docs/ja/tools/polymarket.mdx new file mode 100644 index 000000000..89c2d99ca --- /dev/null +++ b/apps/docs/content/docs/ja/tools/polymarket.mdx @@ -0,0 +1,352 @@ +--- +title: Polymarket +description: Polymarketの予測市場データにアクセス +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Polymarket](https://polymarket.com)は、ユーザーがブロックチェーン技術を使用して将来のイベントの結果に取引できる分散型予測市場プラットフォームです。Polymarketは包括的なAPIを提供し、開発者やエージェントがライブ市場データ、イベントリスト、価格情報、注文台帳の統計にアクセスして、データ駆動型ワークフローやAI自動化を強化することができます。 + +PolymarketのAPIとSimの統合により、エージェントがプログラムで予測市場情報を取得し、オープン市場と関連イベントを探索し、過去の価格データを分析し、注文台帳と市場の中間点にアクセスすることができます。これにより、市場価格から導き出されるリアルタイムのイベント確率に反応する研究、自動分析、インテリジェントエージェントの開発に新たな可能性が生まれます。 + +Polymarket統合の主な機能には以下が含まれます： + +- **市場リスト化とフィルタリング：** 現在または過去のすべての予測市場をリスト化し、タグでフィルタリングし、ソートし、結果をページ分けします。 +- **市場詳細：** 市場IDまたはスラグによる単一市場の詳細を取得し、その結果と状態を含みます。 +- **イベントリスト：** Polymarketイベントのリストと詳細なイベント情報にアクセスします。 +- **注文台帳と価格データ：** 注文台帳を分析し、最新の市場価格を取得し、中間点を表示するか、任意の市場の過去の価格情報を取得します。 +- **自動化対応：** 市場の発展、変化するオッズ、または特定のイベント結果にプログラムで反応するエージェントやツールを構築します。 + +これらの文書化されたAPIエンドポイントを使用することで、Polymarketの豊富なオンチェーン予測市場データをあなた自身のAIワークフロー、ダッシュボード、研究ツール、取引自動化にシームレスに統合することができます。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +Polymarket予測市場をワークフローに統合します。市場一覧、特定の市場、イベント一覧、特定のイベント、タグ、シリーズ、注文台帳、価格、中間値、価格履歴、最終取引価格、スプレッド、ティックサイズ、ポジション、取引、および検索が可能です。 + +## ツール + +### `polymarket_get_markets` + +Polymarketから予測市場のリストをオプションのフィルタリングで取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `closed` | string | いいえ | クローズ状態でフィルタリング（true/false）。アクティブな市場のみの場合はfalseを使用。 | +| `order` | string | いいえ | ソートフィールド（例：id、volume、liquidity） | +| `ascending` | string | いいえ | ソート方向（昇順の場合はtrue、降順の場合はfalse） | +| `tagId` | string | いいえ | タグIDでフィルタリング | +| `limit` | string | いいえ | ページあたりの結果数（推奨：25-50） | +| `offset` | string | いいえ | ページネーションオフセット（この数の結果をスキップ） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 市場データとメタデータ | + +### `polymarket_get_market` + +IDまたはスラグで特定の予測市場の詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `marketId` | string | いいえ | 市場ID。slugが提供されていない場合は必須。 | +| `slug` | string | いいえ | 市場スラグ（例："will-trump-win"）。marketIdが提供されていない場合は必須。 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 市場データとメタデータ | + +### `polymarket_get_events` + +Polymarketからイベントのリストを取得し、オプションでフィルタリングできます + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `closed` | string | いいえ | クローズ状態でフィルタリング（true/false）。アクティブなイベントのみの場合はfalseを使用。 | +| `order` | string | いいえ | ソートフィールド（例：id、volume） | +| `ascending` | string | いいえ | ソート方向（昇順の場合はtrue、降順の場合はfalse） | +| `tagId` | string | いいえ | タグIDでフィルタリング | +| `limit` | string | いいえ | ページあたりの結果数（推奨：25-50） | +| `offset` | string | いいえ | ページネーションオフセット（この数の結果をスキップ） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | イベントデータとメタデータ | + +### `polymarket_get_event` + +IDまたはスラグで特定のイベントの詳細を取得 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `eventId` | string | いいえ | イベントID。slugが提供されていない場合は必須。 | +| `slug` | string | いいえ | イベントスラグ（例："2024-presidential-election"）。eventIdが提供されていない場合は必須。 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | イベントデータとメタデータ | + +### `polymarket_get_tags` + +Polymarketからマーケットのフィルタリング用の利用可能なタグを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `limit` | string | いいえ | ページあたりの結果数（推奨：25-50） | +| `offset` | string | いいえ | ページネーションオフセット（この数の結果をスキップ） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | タグデータとメタデータ | + +### `polymarket_search` + +Polymarketでマーケット、イベント、プロフィールを検索する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `query` | string | はい | 検索クエリ用語 | +| `limit` | string | いいえ | ページあたりの結果数（推奨：25-50） | +| `offset` | string | いいえ | ページネーションオフセット（この数の結果をスキップ） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 検索結果とメタデータ | + +### `polymarket_get_series` + +Polymarketからシリーズ（関連するマーケットグループ）を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `limit` | string | いいえ | ページあたりの結果数（推奨：25-50） | +| `offset` | string | いいえ | ページネーションオフセット（この数の結果をスキップ） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | シリーズデータとメタデータ | + +### `polymarket_get_series_by_id` + +PolymarketからIDで特定のシリーズ（関連する市場グループ）を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `seriesId` | string | はい | シリーズID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | シリーズデータとメタデータ | + +### `polymarket_get_orderbook` + +特定のトークンのオーダーブック概要を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | はい | CLOBトークンID（市場のclobTokenIdsから） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | オーダーブックデータとメタデータ | + +### `polymarket_get_price` + +特定のトークンとサイドの市場価格を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | はい | CLOBトークンID（市場のclobTokenIdsから） | +| `side` | string | はい | 注文サイド：buyまたはsell | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 価格データとメタデータ | + +### `polymarket_get_midpoint` + +特定のトークンの中間価格を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | はい | CLOBトークンID（市場のclobTokenIdsから） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 中間価格データとメタデータ | + +### `polymarket_get_price_history` + +特定の市場トークンの過去の価格データを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | はい | CLOBトークンID（市場のclobTokenIdsから） | +| `interval` | string | いいえ | 現在時刻で終了する期間（1m、1h、6h、1d、1w、max）。startTs/endTsと相互に排他的。 | +| `fidelity` | number | いいえ | データの解像度（分単位、例：60で1時間ごと） | +| `startTs` | number | いいえ | 開始タイムスタンプ（Unixの秒数、UTC） | +| `endTs` | number | いいえ | 終了タイムスタンプ（Unixの秒数、UTC） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 価格履歴データとメタデータ | + +### `polymarket_get_last_trade_price` + +特定のトークンの最終取引価格を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | はい | CLOBトークンID（市場のclobTokenIdsから） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 最終取引価格とメタデータ | + +### `polymarket_get_spread` + +特定のトークンのビッドアスクスプレッドを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | はい | CLOBトークンID（市場のclobTokenIdsから） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | スプレッドデータとメタデータ | + +### `polymarket_get_tick_size` + +特定のトークンの最小ティックサイズを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | はい | CLOBトークンID（市場のclobTokenIdsから） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | ティックサイズとメタデータ | + +### `polymarket_get_positions` + +Polymarketからユーザーポジションを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `user` | string | はい | ユーザーウォレットアドレス | +| `market` | string | いいえ | ポジションをフィルタリングするためのオプションのマーケットID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | ポジションデータとメタデータ | + +### `polymarket_get_trades` + +Polymarketから取引履歴を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `user` | string | いいえ | 取引をフィルタリングするユーザーウォレットアドレス | +| `market` | string | いいえ | 取引をフィルタリングするマーケットID | +| `limit` | string | いいえ | ページあたりの結果数（推奨：25-50） | +| `offset` | string | いいえ | ページネーションオフセット（この数の結果をスキップ） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 取引データとメタデータ | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `polymarket` diff --git a/apps/docs/content/docs/ja/tools/pylon.mdx b/apps/docs/content/docs/ja/tools/pylon.mdx index 7ff3ce4a7..c587d1956 100644 --- a/apps/docs/content/docs/ja/tools/pylon.mdx +++ b/apps/docs/content/docs/ja/tools/pylon.mdx @@ -82,10 +82,17 @@ Pylonをワークフローに統合します。問題（一覧表示、作成、 | パラメータ | 型 | 必須 | 説明 | | --------- | ---- | -------- | ----------- | | `apiToken` | string | はい | Pylon APIトークン | -| `title` | string | はい | 問題のタイトル | -| `bodyHtml` | string | はい | HTML形式の問題本文 | -| `accountId` | string | いいえ | 問題に関連付けるアカウントID | -| `assigneeId` | string | いいえ | 問題を割り当てるユーザーID | +| `title` | string | はい | 課題のタイトル | +| `bodyHtml` | string | はい | HTML形式の課題本文 | +| `accountId` | string | いいえ | 課題に関連付けるアカウントID | +| `assigneeId` | string | いいえ | 課題を割り当てるユーザーID | +| `teamId` | string | いいえ | 課題を割り当てるチームID | +| `requesterId` | string | いいえ | 要求者ユーザーID（requester_emailの代替） | +| `requesterEmail` | string | いいえ | 要求者のメールアドレス（requester_idの代替） | +| `priority` | string | いいえ | 課題の優先度 | +| `tags` | string | いいえ | カンマ区切りのタグID | +| `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド | +| `attachmentUrls` | string | いいえ | カンマ区切りの添付ファイルURL | #### 出力 @@ -127,6 +134,9 @@ IDで特定の課題を取得する | `teamId` | string | いいえ | 課題を割り当てるチームID | | `tags` | string | いいえ | カンマ区切りのタグID | | `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド | +| `customerPortalVisible` | boolean | いいえ | 課題がカスタマーポータルで表示されるかどうか | +| `requesterId` | string | いいえ | 要求者ユーザーID | +| `accountId` | string | いいえ | 課題に関連付けるアカウントID | #### 出力 diff --git a/apps/docs/content/docs/ja/tools/shopify.mdx b/apps/docs/content/docs/ja/tools/shopify.mdx new file mode 100644 index 000000000..b1518780d --- /dev/null +++ b/apps/docs/content/docs/ja/tools/shopify.mdx @@ -0,0 +1,444 @@ +--- +title: Shopify +description: Shopifyストアで商品、注文、顧客、在庫を管理する +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Shopify](https://www.shopify.com/)は、商人がオンラインストアを構築、運営、成長させるのを支援するために設計された主要なeコマースプラットフォームです。Shopifyを使えば、商品や在庫から注文や顧客まで、ストアのあらゆる側面を簡単に管理できます。 + +SimでShopifyを使用すると、エージェントは以下のことができます： + +- **商品の作成と管理**：新しい商品の追加、商品詳細の更新、ストアからの商品の削除。 +- **注文の一覧表示と取得**：フィルタリングや注文管理を含む、顧客注文に関する情報の取得。 +- **顧客の管理**：顧客詳細へのアクセスと更新、またはストアへの新規顧客の追加。 +- **在庫レベルの調整**：商品の在庫レベルをプログラムで変更し、在庫を正確に保つ。 + +SimのShopify統合を使用して、在庫の同期、注文の履行、リスティングの管理などの一般的なストア管理ワークフローを自動化から直接自動化します。エージェントがシンプルでプログラム的なツールを使用して、すべてのストアデータにアクセス、更新、整理できるようにします。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +Shopifyをワークフローに統合します。商品、注文、顧客、在庫を管理します。商品の作成、読み取り、更新、削除を行います。注文の一覧表示と管理。顧客データの処理と在庫レベルの調整。 + +## ツール + +### `shopify_create_product` + +Shopifyストアに新しい商品を作成する + +#### 入力 + +| パラメータ | 種類 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `title` | string | はい | 商品タイトル | +| `descriptionHtml` | string | いいえ | 商品説明（HTML） | +| `vendor` | string | いいえ | 商品ベンダー/ブランド | +| `productType` | string | いいえ | 商品タイプ/カテゴリー | +| `tags` | array | いいえ | 商品タグ | +| `status` | string | いいえ | 商品ステータス（ACTIVE、DRAFT、ARCHIVED） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `product` | object | 作成された商品 | + +### `shopify_get_product` + +IDを使用してShopifyストアから単一の商品を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `productId` | string | はい | 商品ID（gid://shopify/Product/123456789） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `product` | object | 商品の詳細 | + +### `shopify_list_products` + +オプションのフィルタリングを使用してShopifyストアから商品リストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `first` | number | いいえ | 返す商品数（デフォルト：50、最大：250） | +| `query` | string | いいえ | 商品をフィルタリングする検索クエリ（例："title:shirt"または"vendor:Nike"または"status:active"） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `products` | array | 商品リスト | +| `pageInfo` | object | ページネーション情報 | + +### `shopify_update_product` + +Shopifyストアの既存の商品を更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `productId` | string | はい | 更新する商品ID（gid://shopify/Product/123456789） | +| `title` | string | いいえ | 新しい商品タイトル | +| `descriptionHtml` | string | いいえ | 新しい商品説明（HTML） | +| `vendor` | string | いいえ | 新しい商品ベンダー/ブランド | +| `productType` | string | いいえ | 新しい商品タイプ/カテゴリー | +| `tags` | array | いいえ | 新しい商品タグ | +| `status` | string | いいえ | 新しい商品ステータス（ACTIVE、DRAFT、ARCHIVED） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `product` | object | 更新された商品 | + +### `shopify_delete_product` + +Shopifyストアから商品を削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `productId` | string | はい | 削除する商品ID（gid://shopify/Product/123456789） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `deletedId` | string | 削除された商品のID | + +### `shopify_get_order` + +IDを指定してShopifyストアから単一の注文を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `orderId` | string | はい | 注文ID（gid://shopify/Order/123456789） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `order` | object | 注文の詳細 | + +### `shopify_list_orders` + +オプションのフィルタリングを使用してShopifyストアから注文一覧を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `first` | number | いいえ | 返す注文数（デフォルト：50、最大：250） | +| `status` | string | いいえ | 注文ステータスでフィルタリング（open、closed、cancelled、any） | +| `query` | string | いいえ | 注文をフィルタリングする検索クエリ（例："financial_status:paid"または"fulfillment_status:unfulfilled"または"email:customer@example.com"） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `orders` | array | 注文のリスト | +| `pageInfo` | object | ページネーション情報 | + +### `shopify_update_order` + +Shopifyストアの既存の注文を更新します（メモ、タグ、メール） + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン \(例：mystore.myshopify.com\) | +| `orderId` | string | はい | 更新する注文ID \(gid://shopify/Order/123456789\) | +| `note` | string | いいえ | 新しい注文メモ | +| `tags` | array | いいえ | 新しい注文タグ | +| `email` | string | いいえ | 注文の新しい顧客メール | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `order` | object | 更新された注文 | + +### `shopify_cancel_order` + +Shopifyストアの注文をキャンセルします + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン \(例：mystore.myshopify.com\) | +| `orderId` | string | はい | キャンセルする注文ID \(gid://shopify/Order/123456789\) | +| `reason` | string | はい | キャンセル理由 \(CUSTOMER, DECLINED, FRAUD, INVENTORY, STAFF, OTHER\) | +| `notifyCustomer` | boolean | いいえ | キャンセルについて顧客に通知するかどうか | +| `refund` | boolean | いいえ | 注文を返金するかどうか | +| `restock` | boolean | いいえ | 在庫を補充するかどうか | +| `staffNote` | string | いいえ | スタッフ参照用のキャンセルに関するメモ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `order` | object | キャンセル結果 | + +### `shopify_create_customer` + +Shopifyストアに新しい顧客を作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `email` | string | いいえ | 顧客のメールアドレス | +| `firstName` | string | いいえ | 顧客の名 | +| `lastName` | string | いいえ | 顧客の姓 | +| `phone` | string | いいえ | 顧客の電話番号 | +| `note` | string | いいえ | 顧客に関するメモ | +| `tags` | array | いいえ | 顧客タグ | +| `addresses` | array | いいえ | 顧客の住所 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `customer` | object | 作成された顧客 | + +### `shopify_get_customer` + +IDからShopifyストアの単一顧客を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `customerId` | string | はい | 顧客ID（gid://shopify/Customer/123456789） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `customer` | object | 顧客の詳細 | + +### `shopify_list_customers` + +オプションのフィルタリングを使用してShopifyストアから顧客をリストアップする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | あなたのShopifyストアドメイン（例：mystore.myshopify.com） | +| `first` | number | いいえ | 返す顧客の数（デフォルト：50、最大：250） | +| `query` | string | いいえ | 顧客をフィルタリングする検索クエリ（例："first_name:John"または"last_name:Smith"または"email:*@gmail.com"または"tag:vip"） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `customers` | array | 顧客のリスト | +| `pageInfo` | object | ページネーション情報 | + +### `shopify_update_customer` + +Shopifyストアの既存の顧客を更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | あなたのShopifyストアドメイン（例：mystore.myshopify.com） | +| `customerId` | string | はい | 更新する顧客ID（gid://shopify/Customer/123456789） | +| `email` | string | いいえ | 新しい顧客のメールアドレス | +| `firstName` | string | いいえ | 新しい顧客の名 | +| `lastName` | string | いいえ | 新しい顧客の姓 | +| `phone` | string | いいえ | 新しい顧客の電話番号 | +| `note` | string | いいえ | 顧客に関する新しいメモ | +| `tags` | array | いいえ | 新しい顧客タグ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `customer` | object | 更新された顧客 | + +### `shopify_delete_customer` + +Shopifyストアから顧客を削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `customerId` | string | はい | 削除する顧客ID（gid://shopify/Customer/123456789） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `deletedId` | string | 削除された顧客のID | + +### `shopify_list_inventory_items` + +Shopifyストアから在庫アイテムを一覧表示します。SKUで在庫アイテムIDを検索する際に使用します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `first` | number | いいえ | 返す在庫アイテム数（デフォルト：50、最大：250） | +| `query` | string | いいえ | 在庫アイテムをフィルタリングする検索クエリ（例："sku:ABC123"） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `inventoryItems` | array | ID、SKU、在庫レベルを含む在庫アイテムのリスト | +| `pageInfo` | object | ページネーション情報 | + +### `shopify_get_inventory_level` + +特定の場所での商品バリアントの在庫レベルを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `inventoryItemId` | string | はい | 在庫アイテムID（gid://shopify/InventoryItem/123456789） | +| `locationId` | string | いいえ | フィルタリングする場所ID（オプション） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `inventoryLevel` | object | 在庫レベルの詳細 | + +### `shopify_adjust_inventory` + +特定の場所で商品バリアントの在庫数量を調整する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `inventoryItemId` | string | はい | 在庫アイテムID（gid://shopify/InventoryItem/123456789） | +| `locationId` | string | はい | ロケーションID（gid://shopify/Location/123456789） | +| `delta` | number | はい | 調整する量（増加は正の値、減少は負の値） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `inventoryLevel` | object | 在庫調整の結果 | + +### `shopify_list_locations` + +Shopifyストアから在庫ロケーションを一覧表示します。在庫操作に必要なロケーションIDを見つけるために使用します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | Shopifyストアドメイン（例：mystore.myshopify.com） | +| `first` | number | いいえ | 返すロケーションの数（デフォルト：50、最大：250） | +| `includeInactive` | boolean | いいえ | 非アクティブ化されたロケーションを含めるかどうか（デフォルト：false） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `locations` | array | ID、名前、住所を含むロケーションのリスト | +| `pageInfo` | object | ページネーション情報 | + +### `shopify_create_fulfillment` + +注文商品を発送済みとしてマークするためのフルフィルメントを作成します。フルフィルメント注文ID（注文詳細から取得）が必要です。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | あなたのShopifyストアドメイン（例：mystore.myshopify.com） | +| `fulfillmentOrderId` | string | はい | フルフィルメント注文ID（例：gid://shopify/FulfillmentOrder/123456789） | +| `trackingNumber` | string | いいえ | 配送の追跡番号 | +| `trackingCompany` | string | いいえ | 配送業者名（例：UPS、FedEx、USPS、DHL） | +| `trackingUrl` | string | いいえ | 配送を追跡するためのURL | +| `notifyCustomer` | boolean | いいえ | 顧客に発送確認メールを送信するかどうか（デフォルト：true） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `fulfillment` | object | 追跡情報とフルフィルメントされた商品を含む作成されたフルフィルメント | + +### `shopify_list_collections` + +Shopifyストアから商品コレクションを一覧表示します。タイトル、タイプ（カスタム/スマート）、またはハンドルでフィルタリングできます。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | あなたのShopifyストアドメイン（例：mystore.myshopify.com） | +| `first` | number | いいえ | 返すコレクションの数（デフォルト：50、最大：250） | +| `query` | string | いいえ | コレクションをフィルタリングする検索クエリ（例："title:Summer"または"collection_type:smart"） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `collections` | array | ID、タイトル、商品数を含むコレクションのリスト | +| `pageInfo` | object | ページネーション情報 | + +### `shopify_get_collection` + +IDで特定のコレクションを取得し、その製品も含めます。これを使用してコレクション内の製品を取得できます。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | はい | あなたのShopifyストアドメイン（例：mystore.myshopify.com） | +| `collectionId` | string | はい | コレクションID（例：gid://shopify/Collection/123456789） | +| `productsFirst` | number | いいえ | このコレクションから返す製品の数（デフォルト：50、最大：250） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `collection` | object | 製品を含むコレクションの詳細 | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `shopify` diff --git a/apps/docs/content/docs/ja/tools/ssh.mdx b/apps/docs/content/docs/ja/tools/ssh.mdx new file mode 100644 index 000000000..e8928d056 --- /dev/null +++ b/apps/docs/content/docs/ja/tools/ssh.mdx @@ -0,0 +1,394 @@ +--- +title: SSH +description: SSHを介してリモートサーバーに接続する +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[SSH（Secure Shell）](https://en.wikipedia.org/wiki/Secure_Shell)は、リモートサーバーに安全に接続するための広く使用されているプロトコルで、暗号化されたチャネルを通じてコマンドの実行、ファイル転送、システム管理を行うことができます。 + +SimのSSHサポートにより、エージェントは以下のことが可能になります： + +- **リモートコマンドの実行**: SSHでアクセス可能な任意のサーバーでシェルコマンドを実行 +- **スクリプトのアップロードと実行**: 高度な自動化のための複数行スクリプトを簡単に転送して実行 +- **ファイルの安全な転送**: ワークフローの一部としてファイルのアップロードとダウンロード（近日公開予定またはコマンド経由） +- **サーバー管理の自動化**: 更新、メンテナンス、監視、デプロイメント、設定タスクをプログラムで実行 +- **柔軟な認証の使用**: パスワードまたは秘密鍵認証で接続、暗号化された鍵のサポートを含む + +以下のSim SSHツールにより、エージェントはより大きな自動化の一部としてサーバーと対話することができます： + +- `ssh_execute_command`: 任意の単一シェルコマンドをリモートで実行し、出力、ステータス、エラーを取得します。 +- `ssh_execute_script`: 完全な複数行スクリプトをリモートシステムにアップロードして実行します。 +-（ファイル転送などの追加ツールが近日公開予定） + +SSHをエージェントワークフローに統合することで、安全なアクセス、リモート操作、サーバーオーケストレーションを自動化し、DevOps、IT自動化、カスタムリモート管理をすべてSim内からスムーズに行うことができます。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +SSHを介してコマンドの実行、ファイル転送、リモートサーバーの管理を行います。安全なサーバーアクセスのためのパスワードと秘密鍵認証をサポートしています。 + +## ツール + +### `ssh_execute_command` + +リモートSSHサーバーでシェルコマンドを実行する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `host` | string | はい | SSHサーバーのホスト名またはIPアドレス | +| `port` | number | はい | SSHサーバーポート（デフォルト：22） | +| `username` | string | はい | SSHユーザー名 | +| `password` | string | いいえ | 認証用パスワード（秘密鍵を使用しない場合） | +| `privateKey` | string | いいえ | 認証用秘密鍵（OpenSSH形式） | +| `passphrase` | string | いいえ | 暗号化された秘密鍵のパスフレーズ | +| `command` | string | はい | リモートサーバーで実行するシェルコマンド | +| `workingDirectory` | string | いいえ | コマンド実行のための作業ディレクトリ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `stdout` | string | コマンドからの標準出力 | +| `stderr` | string | 標準エラー出力 | +| `exitCode` | number | コマンド終了コード | +| `success` | boolean | コマンドが成功したかどうか（終了コード0） | +| `message` | string | 操作ステータスメッセージ | + +### `ssh_execute_script` + +リモートSSHサーバーに複数行スクリプトをアップロードして実行する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `host` | string | はい | SSHサーバーのホスト名またはIPアドレス | +| `port` | number | はい | SSHサーバーポート（デフォルト：22） | +| `username` | string | はい | SSHユーザー名 | +| `password` | string | いいえ | 認証用パスワード（秘密鍵を使用しない場合） | +| `privateKey` | string | いいえ | 認証用秘密鍵（OpenSSH形式） | +| `passphrase` | string | いいえ | 暗号化された秘密鍵のパスフレーズ | +| `script` | string | はい | 実行するスクリプト内容（bash、pythonなど） | +| `interpreter` | string | いいえ | スクリプトインタープリター（デフォルト：/bin/bash） | +| `workingDirectory` | string | いいえ | スクリプト実行用作業ディレクトリ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `stdout` | string | スクリプトからの標準出力 | +| `stderr` | string | 標準エラー出力 | +| `exitCode` | number | スクリプト終了コード | +| `success` | boolean | スクリプトが成功したかどうか（終了コード0） | +| `scriptPath` | string | スクリプトがアップロードされた一時パス | +| `message` | string | 操作ステータスメッセージ | + +### `ssh_check_command_exists` + +リモートSSHサーバー上でコマンド/プログラムが存在するかを確認する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `host` | string | はい | SSHサーバーのホスト名またはIPアドレス | +| `port` | number | はい | SSHサーバーのポート（デフォルト：22） | +| `username` | string | はい | SSHユーザー名 | +| `password` | string | いいえ | 認証用パスワード（秘密鍵を使用しない場合） | +| `privateKey` | string | いいえ | 認証用秘密鍵（OpenSSH形式） | +| `passphrase` | string | いいえ | 暗号化された秘密鍵のパスフレーズ | +| `commandName` | string | はい | 確認するコマンド名（例：docker、git、python3） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `commandExists` | boolean | コマンドが存在するかどうか | +| `commandPath` | string | コマンドへのフルパス（見つかった場合） | +| `version` | string | コマンドのバージョン出力（該当する場合） | +| `message` | string | 操作ステータスメッセージ | + +### `ssh_upload_file` + +リモートSSHサーバーにファイルをアップロードする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `host` | string | はい | SSHサーバーのホスト名またはIPアドレス | +| `port` | number | はい | SSHサーバーのポート（デフォルト：22） | +| `username` | string | はい | SSHユーザー名 | +| `password` | string | いいえ | 認証用パスワード（秘密鍵を使用しない場合） | +| `privateKey` | string | いいえ | 認証用秘密鍵（OpenSSH形式） | +| `passphrase` | string | いいえ | 暗号化された秘密鍵のパスフレーズ | +| `fileContent` | string | はい | アップロードするファイルの内容（バイナリファイルの場合はbase64エンコード） | +| `fileName` | string | はい | アップロードするファイルの名前 | +| `remotePath` | string | はい | リモートサーバー上の保存先パス | +| `permissions` | string | いいえ | ファイルのパーミッション（例：0644） | +| `overwrite` | boolean | いいえ | 既存のファイルを上書きするかどうか（デフォルト：true） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `uploaded` | boolean | ファイルが正常にアップロードされたかどうか | +| `remotePath` | string | リモートサーバー上の最終パス | +| `size` | number | ファイルサイズ（バイト単位） | +| `message` | string | 操作ステータスメッセージ | + +### `ssh_download_file` + +リモートSSHサーバーからファイルをダウンロードする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `host` | string | はい | SSHサーバーのホスト名またはIPアドレス | +| `port` | number | はい | SSHサーバーポート（デフォルト：22） | +| `username` | string | はい | SSHユーザー名 | +| `password` | string | いいえ | 認証用パスワード（秘密鍵を使用しない場合） | +| `privateKey` | string | いいえ | 認証用秘密鍵（OpenSSH形式） | +| `passphrase` | string | いいえ | 暗号化された秘密鍵のパスフレーズ | +| `remotePath` | string | はい | リモートサーバー上のファイルパス | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `downloaded` | boolean | ファイルが正常にダウンロードされたかどうか | +| `fileContent` | string | ファイルコンテンツ（バイナリファイルの場合はbase64エンコード） | +| `fileName` | string | ダウンロードしたファイルの名前 | +| `remotePath` | string | リモートサーバー上のソースパス | +| `size` | number | ファイルサイズ（バイト単位） | +| `message` | string | 操作ステータスメッセージ | + +### `ssh_list_directory` + +リモートディレクトリ内のファイルとディレクトリを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `host` | string | はい | SSHサーバーのホスト名またはIPアドレス | +| `port` | number | はい | SSHサーバーのポート（デフォルト：22） | +| `username` | string | はい | SSHユーザー名 | +| `password` | string | いいえ | 認証用パスワード（秘密鍵を使用しない場合） | +| `privateKey` | string | いいえ | 認証用秘密鍵（OpenSSH形式） | +| `passphrase` | string | いいえ | 暗号化された秘密鍵のパスフレーズ | +| `path` | string | はい | 一覧表示するリモートディレクトリのパス | +| `detailed` | boolean | いいえ | ファイルの詳細を含める（サイズ、権限、更新日） | +| `recursive` | boolean | いいえ | サブディレクトリを再帰的に一覧表示する（デフォルト：false） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `entries` | array | ファイルとディレクトリエントリの配列 | + +### `ssh_check_file_exists` + +リモートSSHサーバー上にファイルまたはディレクトリが存在するかを確認する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `host` | string | はい | SSHサーバーのホスト名またはIPアドレス | +| `port` | number | はい | SSHサーバーのポート（デフォルト：22） | +| `username` | string | はい | SSHユーザー名 | +| `password` | string | いいえ | 認証用パスワード（秘密鍵を使用しない場合） | +| `privateKey` | string | いいえ | 認証用秘密鍵（OpenSSH形式） | +| `passphrase` | string | いいえ | 暗号化された秘密鍵のパスフレーズ | +| `path` | string | はい | 確認するリモートファイルまたはディレクトリのパス | +| `type` | string | いいえ | 期待されるタイプ：file、directory、またはany（デフォルト：any） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `exists` | boolean | パスが存在するかどうか | +| `type` | string | パスの種類（ファイル、ディレクトリ、シンボリックリンク、見つからない） | +| `size` | number | ファイルの場合のファイルサイズ | +| `permissions` | string | ファイルのパーミッション（例：0755） | +| `modified` | string | 最終更新タイムスタンプ | +| `message` | string | 操作ステータスメッセージ | + +### `ssh_create_directory` + +リモートSSHサーバーにディレクトリを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `host` | string | はい | SSHサーバーのホスト名またはIPアドレス | +| `port` | number | はい | SSHサーバーポート（デフォルト：22） | +| `username` | string | はい | SSHユーザー名 | +| `password` | string | いいえ | 認証用パスワード（秘密鍵を使用しない場合） | +| `privateKey` | string | いいえ | 認証用秘密鍵（OpenSSH形式） | +| `passphrase` | string | いいえ | 暗号化された秘密鍵のパスフレーズ | +| `path` | string | はい | 作成するディレクトリパス | +| `recursive` | boolean | いいえ | 親ディレクトリが存在しない場合に作成する（デフォルト：true） | +| `permissions` | string | いいえ | ディレクトリのパーミッション（デフォルト：0755） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `created` | boolean | ディレクトリが正常に作成されたかどうか | +| `remotePath` | string | 作成されたディレクトリパス | +| `alreadyExists` | boolean | ディレクトリがすでに存在していたかどうか | +| `message` | string | 操作ステータスメッセージ | + +### `ssh_delete_file` + +リモートSSHサーバーからファイルまたはディレクトリを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `host` | string | はい | SSHサーバーのホスト名またはIPアドレス | +| `port` | number | はい | SSHサーバーのポート（デフォルト：22） | +| `username` | string | はい | SSHユーザー名 | +| `password` | string | いいえ | 認証用パスワード（秘密鍵を使用しない場合） | +| `privateKey` | string | いいえ | 認証用秘密鍵（OpenSSH形式） | +| `passphrase` | string | いいえ | 暗号化された秘密鍵のパスフレーズ | +| `path` | string | はい | 削除するパス | +| `recursive` | boolean | いいえ | ディレクトリを再帰的に削除する（デフォルト：false） | +| `force` | boolean | いいえ | 確認なしで強制削除する（デフォルト：false） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `deleted` | boolean | パスが正常に削除されたかどうか | +| `remotePath` | string | 削除されたパス | +| `message` | string | 操作のステータスメッセージ | + +### `ssh_move_rename` + +リモートSSHサーバー上のファイルまたはディレクトリを移動または名前変更する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `host` | string | はい | SSHサーバーのホスト名またはIPアドレス | +| `port` | number | はい | SSHサーバーのポート（デフォルト：22） | +| `username` | string | はい | SSHユーザー名 | +| `password` | string | いいえ | 認証用パスワード（秘密鍵を使用しない場合） | +| `privateKey` | string | いいえ | 認証用秘密鍵（OpenSSH形式） | +| `passphrase` | string | いいえ | 暗号化された秘密鍵のパスフレーズ | +| `sourcePath` | string | はい | ファイルまたはディレクトリの現在のパス | +| `destinationPath` | string | はい | ファイルまたはディレクトリの新しいパス | +| `overwrite` | boolean | いいえ | 宛先が存在する場合に上書きする（デフォルト：false） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `moved` | boolean | 操作が成功したかどうか | +| `sourcePath` | string | 元のパス | +| `destinationPath` | string | 新しいパス | +| `message` | string | 操作のステータスメッセージ | + +### `ssh_get_system_info` + +リモートSSHサーバーからシステム情報を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `host` | string | はい | SSHサーバーのホスト名またはIPアドレス | +| `port` | number | はい | SSHサーバーのポート（デフォルト：22） | +| `username` | string | はい | SSHユーザー名 | +| `password` | string | いいえ | 認証用パスワード（秘密鍵を使用しない場合） | +| `privateKey` | string | いいえ | 認証用秘密鍵（OpenSSH形式） | +| `passphrase` | string | いいえ | 暗号化された秘密鍵のパスフレーズ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `hostname` | string | サーバーのホスト名 | +| `os` | string | オペレーティングシステム（例：Linux、Darwin） | +| `architecture` | string | CPUアーキテクチャ（例：x64、arm64） | +| `uptime` | number | システムの稼働時間（秒） | +| `memory` | json | メモリ情報（合計、空き、使用中） | +| `diskSpace` | json | ディスク容量情報（合計、空き、使用中） | +| `message` | string | 操作のステータスメッセージ | + +### `ssh_read_file_content` + +リモートファイルの内容を読み取る + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `host` | string | はい | SSHサーバーのホスト名またはIPアドレス | +| `port` | number | はい | SSHサーバーのポート（デフォルト：22） | +| `username` | string | はい | SSHユーザー名 | +| `password` | string | いいえ | 認証用パスワード（秘密鍵を使用しない場合） | +| `privateKey` | string | いいえ | 認証用秘密鍵（OpenSSH形式） | +| `passphrase` | string | いいえ | 暗号化された秘密鍵のパスフレーズ | +| `path` | string | はい | 読み取るリモートファイルのパス | +| `encoding` | string | いいえ | ファイルエンコーディング（デフォルト：utf-8） | +| `maxSize` | number | いいえ | 読み取る最大ファイルサイズ（MB単位、デフォルト：10） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `content` | string | 文字列としてのファイル内容 | +| `size` | number | バイト単位のファイルサイズ | +| `lines` | number | ファイル内の行数 | +| `remotePath` | string | リモートファイルパス | +| `message` | string | 操作ステータスメッセージ | + +### `ssh_write_file_content` + +リモートファイルに内容を書き込むまたは追加する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `host` | string | はい | SSHサーバーのホスト名またはIPアドレス | +| `port` | number | はい | SSHサーバーのポート（デフォルト：22） | +| `username` | string | はい | SSHユーザー名 | +| `password` | string | いいえ | 認証用パスワード（秘密鍵を使用しない場合） | +| `privateKey` | string | いいえ | 認証用秘密鍵（OpenSSH形式） | +| `passphrase` | string | いいえ | 暗号化された秘密鍵のパスフレーズ | +| `path` | string | はい | 書き込み先のリモートファイルパス | +| `content` | string | はい | ファイルに書き込む内容 | +| `mode` | string | いいえ | 書き込みモード：上書き、追加、または作成（デフォルト：上書き） | +| `permissions` | string | いいえ | ファイルのパーミッション（例：0644） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `written` | boolean | ファイルが正常に書き込まれたかどうか | +| `remotePath` | string | ファイルパス | +| `size` | number | 最終的なファイルサイズ（バイト単位） | +| `message` | string | 操作ステータスメッセージ | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `ssh` diff --git a/apps/docs/content/docs/ja/tools/wordpress.mdx b/apps/docs/content/docs/ja/tools/wordpress.mdx new file mode 100644 index 000000000..125f96715 --- /dev/null +++ b/apps/docs/content/docs/ja/tools/wordpress.mdx @@ -0,0 +1,566 @@ +--- +title: WordPress +description: WordPressコンテンツを管理する +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[WordPress](https://wordpress.org/)は、世界をリードするオープンソースのコンテンツ管理システムで、ウェブサイト、ブログ、あらゆる種類のオンラインコンテンツの公開と管理を容易にします。WordPressを使用すると、投稿やページの作成と更新、カテゴリーやタグによるコンテンツの整理、メディアファイルの管理、コメントの調整、ユーザーアカウントの処理が可能になり、個人ブログから複雑なビジネスサイトまであらゆるものを運営できます。 + +SimとWordPressの統合により、エージェントは重要なウェブサイトのタスクを自動化できます。特定のタイトル、コンテンツ、カテゴリー、タグ、アイキャッチ画像を含む新しいブログ投稿をプログラムで作成できます。既存の投稿の更新（コンテンツ、タイトル、公開ステータスの変更など）も簡単です。また、コンテンツの公開や下書き保存、静的ページの管理、メディアのアップロード、コメントの監視、関連する分類法へのコンテンツの割り当ても可能です。 + +WordPressを自動化に接続することで、Simはエージェントがコンテンツの公開、編集ワークフロー、日常的なサイト管理を効率化できるようにし、手動での作業なしにウェブサイトを新鮮で整理され、安全に保つのに役立ちます。 +{/* MANUAL-CONTENT-END */} + +## 使用手順 + +WordPressと統合して、投稿、ページ、メディア、コメント、カテゴリー、タグ、ユーザーの作成、更新、管理を行います。OAuth経由のWordPress.comサイトとアプリケーションパスワード認証を使用した自己ホスト型WordPressサイトをサポートしています。 + +## ツール + +### `wordpress_create_post` + +WordPress.comに新しいブログ投稿を作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `title` | string | はい | 投稿タイトル | +| `content` | string | いいえ | 投稿コンテンツ（HTMLまたはプレーンテキスト） | +| `status` | string | いいえ | 投稿ステータス：publish、draft、pending、private、またはfuture | +| `excerpt` | string | いいえ | 投稿の抜粋 | +| `categories` | string | いいえ | カンマ区切りのカテゴリーID | +| `tags` | string | いいえ | カンマ区切りのタグID | +| `featuredMedia` | number | いいえ | アイキャッチ画像のメディアID | +| `slug` | string | いいえ | 投稿のURLスラッグ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `post` | object | 作成された投稿 | + +### `wordpress_update_post` + +WordPress.comの既存のブログ投稿を更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `postId` | number | はい | 更新する投稿のID | +| `title` | string | いいえ | 投稿タイトル | +| `content` | string | いいえ | 投稿内容（HTMLまたはプレーンテキスト） | +| `status` | string | いいえ | 投稿ステータス：publish、draft、pending、private、またはfuture | +| `excerpt` | string | いいえ | 投稿の抜粋 | +| `categories` | string | いいえ | カンマ区切りのカテゴリーID | +| `tags` | string | いいえ | カンマ区切りのタグID | +| `featuredMedia` | number | いいえ | アイキャッチ画像のメディアID | +| `slug` | string | いいえ | 投稿のURLスラッグ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `post` | object | 更新された投稿 | + +### `wordpress_delete_post` + +WordPress.comからブログ投稿を削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `postId` | number | はい | 削除する投稿のID | +| `force` | boolean | いいえ | ゴミ箱をバイパスして強制的に完全に削除する | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `deleted` | boolean | 投稿が削除されたかどうか | +| `post` | object | 削除された投稿 | + +### `wordpress_get_post` + +IDによってWordPress.comから単一のブログ投稿を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `postId` | number | はい | 取得する投稿のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `post` | object | 取得された投稿 | + +### `wordpress_list_posts` + +オプションのフィルターを使用してWordPress.comからブログ投稿を一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `perPage` | number | いいえ | ページあたりの投稿数（デフォルト：10、最大：100） | +| `page` | number | いいえ | ページネーションのページ番号 | +| `status` | string | いいえ | 投稿ステータスフィルター：publish、draft、pending、private | +| `author` | number | いいえ | 著者IDでフィルタリング | +| `categories` | string | いいえ | フィルタリングするカテゴリIDのカンマ区切りリスト | +| `tags` | string | いいえ | フィルタリングするタグIDのカンマ区切りリスト | +| `search` | string | いいえ | 投稿をフィルタリングする検索語 | +| `orderBy` | string | いいえ | 並べ替えフィールド：date、id、title、slug、modified | +| `order` | string | いいえ | 並べ替え方向：ascまたはdesc | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `posts` | array | 投稿のリスト | + +### `wordpress_create_page` + +WordPress.comで新しいページを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `title` | string | はい | ページタイトル | +| `content` | string | いいえ | ページコンテンツ（HTMLまたはプレーンテキスト） | +| `status` | string | いいえ | ページステータス：publish、draft、pending、private | +| `excerpt` | string | いいえ | ページの抜粋 | +| `parent` | number | いいえ | 階層ページの親ページID | +| `menuOrder` | number | いいえ | ページメニューでの順序 | +| `featuredMedia` | number | いいえ | アイキャッチ画像のメディアID | +| `slug` | string | いいえ | ページのURLスラッグ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `page` | object | 作成されたページ | + +### `wordpress_update_page` + +WordPress.comの既存ページを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `pageId` | number | はい | 更新するページのID | +| `title` | string | いいえ | ページタイトル | +| `content` | string | いいえ | ページコンテンツ（HTMLまたはプレーンテキスト） | +| `status` | string | いいえ | ページステータス：publish、draft、pending、private | +| `excerpt` | string | いいえ | ページの抜粋 | +| `parent` | number | いいえ | 階層ページの親ページID | +| `menuOrder` | number | いいえ | ページメニューでの順序 | +| `featuredMedia` | number | いいえ | アイキャッチ画像のメディアID | +| `slug` | string | いいえ | ページのURLスラッグ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `page` | object | 更新されたページ | + +### `wordpress_delete_page` + +WordPress.comからページを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `pageId` | number | はい | 削除するページのID | +| `force` | boolean | いいえ | ゴミ箱をバイパスして強制的に完全に削除する | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `deleted` | boolean | ページが削除されたかどうか | +| `page` | object | 削除されたページ | + +### `wordpress_get_page` + +IDによってWordPress.comから単一のページを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `pageId` | number | はい | 取得するページのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `page` | object | 取得したページ | + +### `wordpress_list_pages` + +オプションのフィルターを使用してWordPress.comからページを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `perPage` | number | いいえ | リクエストごとのページ数（デフォルト：10、最大：100） | +| `page` | number | いいえ | ページネーションのためのページ番号 | +| `status` | string | いいえ | ページステータスフィルター：publish、draft、pending、private | +| `parent` | number | いいえ | 親ページIDでフィルタリング | +| `search` | string | いいえ | ページをフィルタリングする検索語 | +| `orderBy` | string | いいえ | フィールドで並べ替え：date、id、title、slug、modified、menu_order | +| `order` | string | いいえ | 並べ替え方向：ascまたはdesc | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `pages` | array | ページのリスト | + +### `wordpress_upload_media` + +メディアファイル（画像、動画、ドキュメント）をWordPress.comにアップロードする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン \(例：12345678またはmysite.wordpress.com\) | +| `file` | string | はい | Base64エンコードされたファイルデータまたはファイルを取得するURL | +| `filename` | string | はい | 拡張子付きのファイル名 \(例：image.jpg\) | +| `title` | string | いいえ | メディアのタイトル | +| `caption` | string | いいえ | メディアのキャプション | +| `altText` | string | いいえ | アクセシビリティのための代替テキスト | +| `description` | string | いいえ | メディアの説明 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `media` | object | アップロードされたメディアアイテム | + +### `wordpress_get_media` + +IDによってWordPress.comから単一のメディアアイテムを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン \(例：12345678またはmysite.wordpress.com\) | +| `mediaId` | number | はい | 取得するメディアアイテムのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `media` | object | 取得されたメディアアイテム | + +### `wordpress_list_media` + +WordPress.comメディアライブラリからメディアアイテムを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `perPage` | number | いいえ | リクエストごとのメディアアイテム数（デフォルト：10、最大：100） | +| `page` | number | いいえ | ページネーション用のページ番号 | +| `search` | string | いいえ | メディアをフィルタリングする検索語 | +| `mediaType` | string | いいえ | メディアタイプでフィルタリング：image、video、audio、application | +| `mimeType` | string | いいえ | 特定のMIMEタイプでフィルタリング（例：image/jpeg） | +| `orderBy` | string | いいえ | フィールドで並べ替え：date、id、title、slug | +| `order` | string | いいえ | 並べ替え方向：ascまたはdesc | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `media` | array | メディアアイテムのリスト | + +### `wordpress_delete_media` + +WordPress.comからメディアアイテムを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `mediaId` | number | はい | 削除するメディアアイテムのID | +| `force` | boolean | いいえ | 強制削除（メディアにはゴミ箱がないため、削除は永続的です） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `deleted` | boolean | メディアが削除されたかどうか | +| `media` | object | 削除されたメディアアイテム | + +### `wordpress_create_comment` + +WordPress.comの投稿に新しいコメントを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `postId` | number | はい | コメントする投稿のID | +| `content` | string | はい | コメント内容 | +| `parent` | number | いいえ | 返信の場合の親コメントID | +| `authorName` | string | いいえ | コメント投稿者の表示名 | +| `authorEmail` | string | いいえ | コメント投稿者のメールアドレス | +| `authorUrl` | string | いいえ | コメント投稿者のURL | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `comment` | object | 作成されたコメント | + +### `wordpress_list_comments` + +オプションのフィルターを使用してWordPress.comからコメントを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `perPage` | number | いいえ | リクエストごとのコメント数（デフォルト：10、最大：100） | +| `page` | number | いいえ | ページネーションのページ番号 | +| `postId` | number | いいえ | 投稿IDでフィルタリング | +| `status` | string | いいえ | コメントステータスでフィルタリング：approved、hold、spam、trash | +| `search` | string | いいえ | コメントをフィルタリングする検索語 | +| `orderBy` | string | いいえ | フィールドで並べ替え：date、id、parent | +| `order` | string | いいえ | 並べ替え方向：ascまたはdesc | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `comments` | array | コメントのリスト | + +### `wordpress_update_comment` + +WordPress.comのコメントを更新します（内容またはステータス） + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン \(例: 12345678 または mysite.wordpress.com\) | +| `commentId` | number | はい | 更新するコメントのID | +| `content` | string | いいえ | 更新されたコメント内容 | +| `status` | string | いいえ | コメントステータス: approved（承認済み）、hold（保留中）、spam（スパム）、trash（ゴミ箱） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `comment` | object | 更新されたコメント | + +### `wordpress_delete_comment` + +WordPress.comからコメントを削除します + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン \(例: 12345678 または mysite.wordpress.com\) | +| `commentId` | number | はい | 削除するコメントのID | +| `force` | boolean | いいえ | ゴミ箱をバイパスして強制的に完全に削除する | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `deleted` | boolean | コメントが削除されたかどうか | +| `comment` | object | 削除されたコメント | + +### `wordpress_create_category` + +WordPress.comに新しいカテゴリを作成します + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `name` | string | はい | カテゴリ名 | +| `description` | string | いいえ | カテゴリの説明 | +| `parent` | number | いいえ | 階層カテゴリの親カテゴリID | +| `slug` | string | いいえ | カテゴリのURLスラッグ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `category` | object | 作成されたカテゴリ | + +### `wordpress_list_categories` + +WordPress.comからカテゴリを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `perPage` | number | いいえ | リクエストごとのカテゴリ数（デフォルト：10、最大：100） | +| `page` | number | いいえ | ページネーションのページ番号 | +| `search` | string | いいえ | カテゴリをフィルタリングする検索語 | +| `order` | string | いいえ | 並び順の方向：ascまたはdesc | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `categories` | array | カテゴリのリスト | + +### `wordpress_create_tag` + +WordPress.comに新しいタグを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン（例：12345678またはmysite.wordpress.com） | +| `name` | string | はい | タグ名 | +| `description` | string | いいえ | タグの説明 | +| `slug` | string | いいえ | タグのURLスラッグ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `tag` | object | 作成されたタグ | + +### `wordpress_list_tags` + +WordPress.comからタグを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン \(例: 12345678またはmysite.wordpress.com\) | +| `perPage` | number | いいえ | リクエストごとのタグ数 \(デフォルト: 10、最大: 100\) | +| `page` | number | いいえ | ページネーション用のページ番号 | +| `search` | string | いいえ | タグをフィルタリングする検索語 | +| `order` | string | いいえ | 並び順の方向: ascまたはdesc | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `tags` | array | タグのリスト | + +### `wordpress_get_current_user` + +現在認証されているWordPress.comユーザーに関する情報を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン \(例: 12345678またはmysite.wordpress.com\) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `user` | object | 現在のユーザー | + +### `wordpress_list_users` + +WordPress.comからユーザーを一覧表示する（管理者権限が必要） + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン \(例: 12345678またはmysite.wordpress.com\) | +| `perPage` | number | いいえ | リクエストごとのユーザー数 \(デフォルト: 10、最大: 100\) | +| `page` | number | いいえ | ページネーション用のページ番号 | +| `search` | string | いいえ | ユーザーをフィルタリングする検索語 | +| `roles` | string | いいえ | フィルタリングするロール名（カンマ区切り） | +| `order` | string | いいえ | 並び順の方向: ascまたはdesc | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `users` | array | ユーザーのリスト | + +### `wordpress_get_user` + +IDによってWordPress.comから特定のユーザーを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン \(例：12345678またはmysite.wordpress.com\) | +| `userId` | number | はい | 取得するユーザーのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `user` | object | 取得したユーザー | + +### `wordpress_search_content` + +WordPress.comのすべてのコンテンツタイプ（投稿、ページ、メディア）を検索する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | はい | WordPress.comのサイトIDまたはドメイン \(例：12345678またはmysite.wordpress.com\) | +| `query` | string | はい | 検索クエリ | +| `perPage` | number | いいえ | リクエストごとの結果数 \(デフォルト：10、最大：100\) | +| `page` | number | いいえ | ページネーションのためのページ番号 | +| `type` | string | いいえ | コンテンツタイプによるフィルタリング：post、page、attachment | +| `subtype` | string | いいえ | 投稿タイプスラッグによるフィルタリング \(例：post、page\) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `results` | array | 検索結果 | + +## メモ + +- カテゴリー: `tools` +- タイプ: `wordpress` diff --git a/apps/docs/content/docs/ja/tools/zendesk.mdx b/apps/docs/content/docs/ja/tools/zendesk.mdx index 739717bc4..1da6c1011 100644 --- a/apps/docs/content/docs/ja/tools/zendesk.mdx +++ b/apps/docs/content/docs/ja/tools/zendesk.mdx @@ -107,13 +107,16 @@ IDによってZendeskから単一のチケットを取得 | `email` | string | はい | あなたのZendeskメールアドレス | | `apiToken` | string | はい | Zendesk APIトークン | | `subdomain` | string | はい | あなたのZendeskサブドメイン | -| `subject` | string | いいえ | チケットの件名（オプション - 提供されない場合は自動生成されます） | +| `subject` | string | いいえ | チケットの件名（任意 - 提供されない場合は自動生成されます） | | `description` | string | はい | チケットの説明（最初のコメント） | | `priority` | string | いいえ | 優先度（low、normal、high、urgent） | | `status` | string | いいえ | ステータス（new、open、pending、hold、solved、closed） | | `type` | string | いいえ | タイプ（problem、incident、question、task） | | `tags` | string | いいえ | カンマ区切りのタグ | | `assigneeId` | string | いいえ | 担当者ユーザーID | +| `groupId` | string | いいえ | グループID | +| `requesterId` | string | いいえ | 要求者ユーザーID | +| `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド（例：\{"field_id": "value"\}） | #### 出力 diff --git a/apps/docs/content/docs/ja/tools/zoom.mdx b/apps/docs/content/docs/ja/tools/zoom.mdx new file mode 100644 index 000000000..574198b3b --- /dev/null +++ b/apps/docs/content/docs/ja/tools/zoom.mdx @@ -0,0 +1,250 @@ +--- +title: Zoom +description: Zoomミーティングと録画の作成と管理 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Zoom](https://zoom.us/)は、ビデオ会議、ウェビナー、オンラインコラボレーションのための主要なクラウドベースのコミュニケーションプラットフォームです。ユーザーや組織が簡単に会議のスケジュール設定、ホスト、管理ができ、画面共有、チャット、録画などのツールを提供しています。 + +Zoomでは、以下のことができます： + +- **会議のスケジュール設定と管理**：即時または定期的なイベントを含む予定会議の作成 +- **会議オプションの設定**：会議パスワードの設定、待機室の有効化、参加者のビデオ/音声の制御 +- **招待状の送信と詳細の共有**：会議の招待状や情報を取得して簡単に共有 +- **会議データの取得と更新**：会議の詳細へのアクセス、既存の会議の変更、プログラムによる設定の管理 + +Simでは、Zoom統合によりエージェントがスケジュール設定と会議管理を自動化できます。ツールアクションを使用して： + +- カスタム設定で新しい会議をプログラムで作成 +- 特定のユーザー（またはあなた自身）のすべての会議をリスト表示 +- 任意の会議の詳細や招待状を取得 +- 自動化から直接既存の会議を更新または削除 + +これらの機能により、リモートコラボレーションの効率化、定期的なビデオセッションの自動化、ワークフローの一部として組織のZoom環境を管理することができます。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +Zoomをワークフローに統合します。Zoomミーティングの作成、一覧表示、更新、削除ができます。ミーティングの詳細、招待状、録画、参加者を取得します。クラウド録画をプログラムで管理します。 + +## ツール + +### `zoom_create_meeting` + +新しいZoomミーティングを作成する + +#### 入力 + +| パラメータ | 種類 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `userId` | string | はい | ユーザーIDまたはメールアドレス。認証済みユーザーの場合は「me」を使用。 | +| `topic` | string | はい | ミーティングのトピック | +| `type` | number | いいえ | ミーティングタイプ: 1=即時、2=予定、3=固定時間なしの定期的、8=固定時間の定期的 | +| `startTime` | string | いいえ | ISO 8601形式のミーティング開始時間（例：2025-06-03T10:00:00Z） | +| `duration` | number | いいえ | ミーティング時間（分） | +| `timezone` | string | いいえ | ミーティングのタイムゾーン（例：America/Los_Angeles） | +| `password` | string | いいえ | ミーティングパスワード | +| `agenda` | string | いいえ | ミーティングの議題 | +| `hostVideo` | boolean | いいえ | ホストのビデオをオンにして開始 | +| `participantVideo` | boolean | いいえ | 参加者のビデオをオンにして開始 | +| `joinBeforeHost` | boolean | いいえ | ホスト前の参加者の入室を許可 | +| `muteUponEntry` | boolean | いいえ | 入室時に参加者をミュート | +| `waitingRoom` | boolean | いいえ | 待機室を有効化 | +| `autoRecording` | string | いいえ | 自動録画設定：local、cloud、またはnone | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `meeting` | object | すべてのプロパティを含む作成されたミーティング | + +### `zoom_list_meetings` + +Zoomユーザーのすべてのミーティングを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `userId` | string | はい | ユーザーIDまたはメールアドレス。認証済みユーザーの場合は「me」を使用。 | +| `type` | string | いいえ | ミーティングタイプフィルター: scheduled、live、upcoming、upcoming_meetings、または previous_meetings | +| `pageSize` | number | いいえ | ページあたりのレコード数（最大300） | +| `nextPageToken` | string | いいえ | 次のページの結果を取得するためのページネーショントークン | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `meetings` | array | ミーティングのリスト | +| `pageInfo` | object | ページネーション情報 | + +### `zoom_get_meeting` + +特定のZoomミーティングの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | はい | ミーティングID | +| `occurrenceId` | string | いいえ | 定期的なミーティングの開催ID | +| `showPreviousOccurrences` | boolean | いいえ | 定期的なミーティングの過去の開催を表示 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `meeting` | object | ミーティングの詳細 | + +### `zoom_update_meeting` + +既存のZoomミーティングを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | はい | 更新するミーティングID | +| `topic` | string | いいえ | ミーティングのトピック | +| `type` | number | いいえ | ミーティングタイプ: 1=インスタント、2=予定済み、3=定期的（固定時間なし）、8=定期的（固定時間） | +| `startTime` | string | いいえ | ISO 8601形式のミーティング開始時間（例：2025-06-03T10:00:00Z） | +| `duration` | number | いいえ | ミーティング時間（分） | +| `timezone` | string | いいえ | ミーティングのタイムゾーン（例：America/Los_Angeles） | +| `password` | string | いいえ | ミーティングパスワード | +| `agenda` | string | いいえ | ミーティングの議題 | +| `hostVideo` | boolean | いいえ | ホストのビデオをオンにして開始 | +| `participantVideo` | boolean | いいえ | 参加者のビデオをオンにして開始 | +| `joinBeforeHost` | boolean | いいえ | ホストより前の参加者の入室を許可 | +| `muteUponEntry` | boolean | いいえ | 入室時に参加者をミュート | +| `waitingRoom` | boolean | いいえ | 待機室を有効にする | +| `autoRecording` | string | いいえ | 自動録画設定：ローカル、クラウド、または無し | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | ミーティングが正常に更新されたかどうか | + +### `zoom_delete_meeting` + +Zoomミーティングを削除またはキャンセルする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | はい | 削除するミーティングID | +| `occurrenceId` | string | いいえ | 定期的なミーティングの特定の回を削除するための発生ID | +| `scheduleForReminder` | boolean | いいえ | 登録者にキャンセルリマインダーメールを送信 | +| `cancelMeetingReminder` | boolean | いいえ | 登録者と代替ホストにキャンセルメールを送信 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | ミーティングが正常に削除されたかどうか | + +### `zoom_get_meeting_invitation` + +Zoomミーティングの招待テキストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | はい | ミーティングID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `invitation` | string | ミーティング招待テキスト | + +### `zoom_list_recordings` + +Zoomユーザーのすべてのクラウド録画をリスト表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `userId` | string | はい | ユーザーIDまたはメールアドレス。認証済みユーザーの場合は「me」を使用。 | +| `from` | string | いいえ | 開始日（yyyy-mm-dd形式）\(過去6ヶ月以内\) | +| `to` | string | いいえ | 終了日（yyyy-mm-dd形式） | +| `pageSize` | number | いいえ | ページあたりのレコード数（最大300） | +| `nextPageToken` | string | いいえ | 次のページの結果を取得するためのページネーショントークン | +| `trash` | boolean | いいえ | ゴミ箱から録画をリスト表示するにはtrueに設定 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `recordings` | array | 録画のリスト | +| `pageInfo` | object | ページネーション情報 | + +### `zoom_get_meeting_recordings` + +特定のZoomミーティングの全ての録画を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | はい | ミーティングIDまたはミーティングUUID | +| `includeFolderItems` | boolean | いいえ | フォルダ内のアイテムを含める | +| `ttl` | number | いいえ | ダウンロードURLの有効期間（秒）（最大604800） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `recording` | object | すべてのファイルを含むミーティング録画 | + +### `zoom_delete_recording` + +Zoomミーティングのクラウド録画を削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | はい | ミーティングIDまたはミーティングUUID | +| `recordingId` | string | いいえ | 削除する特定の録画ファイルID。指定しない場合、すべての録画を削除します。 | +| `action` | string | いいえ | 削除アクション：「trash」（ゴミ箱に移動）または「delete」（完全に削除） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 録画が正常に削除されたかどうか | + +### `zoom_list_past_participants` + +過去のZoomミーティングの参加者を一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | はい | 過去のミーティングIDまたはUUID | +| `pageSize` | number | いいえ | ページあたりのレコード数（最大300） | +| `nextPageToken` | string | いいえ | 結果の次のページを取得するためのページネーショントークン | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `participants` | array | 会議参加者のリスト | +| `pageInfo` | object | ページネーション情報 | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `zoom` diff --git a/apps/docs/content/docs/zh/tools/ahrefs.mdx b/apps/docs/content/docs/zh/tools/ahrefs.mdx new file mode 100644 index 000000000..83b302aa6 --- /dev/null +++ b/apps/docs/content/docs/zh/tools/ahrefs.mdx @@ -0,0 +1,199 @@ +--- +title: Ahrefs +description: 使用 Ahrefs 进行 SEO 分析 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Ahrefs](https://ahrefs.com/) 是一个领先的 SEO 工具集，用于分析网站、跟踪排名、监控反向链接以及研究关键词。它提供了关于您自己网站以及竞争对手的详细见解，帮助您做出数据驱动的决策以提升搜索可见性。 + +在 Sim 中集成 Ahrefs 后，您可以： + +- **分析域名评分和权威性**：即时检查任何网站的域名评分 (DR) 和 Ahrefs 排名，以评估其权威性。 +- **获取反向链接**：检索指向某个网站或特定 URL 的反向链接列表，包括锚文本、引用页面 DR 等详细信息。 +- **获取反向链接统计**：访问关于反向链接类型（dofollow、nofollow、文本、图片、重定向等）的指标，适用于域名或 URL。 +- **探索自然关键词** *(计划中)*：查看某个域名排名的关键词及其在 Google 搜索结果中的位置。 +- **发现热门页面** *(计划中)*：识别通过自然流量和链接表现最好的页面。 + +这些工具让您的代理可以自动化 SEO 研究、监控竞争对手并生成报告——所有这些都可以作为您的工作流程自动化的一部分。要使用 Ahrefs 集成，您需要拥有带有 API 访问权限的 Ahrefs 企业订阅。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Ahrefs SEO 工具集成到您的工作流程中。分析域名评分、反向链接、自然关键词、热门页面等。需要 Ahrefs 企业计划和 API 访问权限。 + +## 工具 + +### `ahrefs_domain_rating` + +获取目标域名的域名评分 (DR) 和 Ahrefs 排名。域名评分显示网站的强度。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `target` | string | 是 | 要分析的目标域名 \(例如：example.com\) | +| `date` | string | 否 | 历史数据的日期，格式为 YYYY-MM-DD \(默认为今天\) | +| `apiKey` | string | 是 | Ahrefs API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `domainRating` | number | 域名评分 \(0-100\) | +| `ahrefsRank` | number | Ahrefs 排名 - 基于反向链接配置文件强度的全球排名 | + +### `ahrefs_backlinks` + +获取指向目标域名或 URL 的反向链接列表。返回每个反向链接的详细信息，包括来源 URL、锚文本和域名评分。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `target` | string | 是 | 要分析的目标域名或 URL | +| `mode` | string | 否 | 分析模式：domain \(整个域名\)、prefix \(URL 前缀\)、subdomains \(包含所有子域名\)、exact \(精确 URL 匹配\) | +| `date` | string | 否 | 历史数据的日期，格式为 YYYY-MM-DD \(默认为今天\) | +| `limit` | number | 否 | 返回结果的最大数量 \(默认值：100\) | +| `offset` | number | 否 | 分页时要跳过的结果数量 | +| `apiKey` | string | 是 | Ahrefs API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `backlinks` | 数组 | 指向目标的反向链接列表 | + +### `ahrefs_backlinks_stats` + +获取目标域名或 URL 的反向链接统计信息。返回包括 dofollow、nofollow、文本、图片和重定向链接在内的不同反向链接类型的总数。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `target` | 字符串 | 是 | 要分析的目标域名或 URL | +| `mode` | 字符串 | 否 | 分析模式：domain（整个域名）、prefix（URL 前缀）、subdomains（包含所有子域名）、exact（精确 URL 匹配） | +| `date` | 字符串 | 否 | 历史数据的日期，格式为 YYYY-MM-DD（默认为今天） | +| `apiKey` | 字符串 | 是 | Ahrefs API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `stats` | 对象 | 反向链接统计摘要 | + +### `ahrefs_referring_domains` + +获取链接到目标域名或 URL 的域名列表。返回具有其域名评分、反向链接计数和发现日期的唯一引用域名。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `target` | 字符串 | 是 | 要分析的目标域名或 URL | +| `mode` | 字符串 | 否 | 分析模式：domain（整个域名）、prefix（URL 前缀）、subdomains（包含所有子域名）、exact（精确 URL 匹配） | +| `date` | 字符串 | 否 | 历史数据的日期，格式为 YYYY-MM-DD（默认为今天） | +| `limit` | 数字 | 否 | 返回的最大结果数（默认值：100） | +| `offset` | 数字 | 否 | 分页时要跳过的结果数 | +| `apiKey` | 字符串 | 是 | Ahrefs API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `referringDomains` | 数组 | 链接到目标的域名列表 | + +### `ahrefs_organic_keywords` + +获取目标域名或 URL 在 Google 搜索结果中排名的自然关键词。返回的关键词详情包括搜索量、排名位置和预估流量。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `target` | 字符串 | 是 | 要分析的目标域名或 URL | +| `country` | 字符串 | 否 | 搜索结果的国家代码 \(例如：us, gb, de\)。默认值：us | +| `mode` | 字符串 | 否 | 分析模式：domain \(整个域名\), prefix \(URL 前缀\), subdomains \(包含所有子域名\), exact \(精确 URL 匹配\) | +| `date` | 字符串 | 否 | 历史数据的日期，格式为 YYYY-MM-DD \(默认为今天\) | +| `limit` | 数字 | 否 | 返回结果的最大数量 \(默认值：100\) | +| `offset` | 数字 | 否 | 分页时跳过的结果数量 | +| `apiKey` | 字符串 | 是 | Ahrefs API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `keywords` | 数组 | 目标排名的自然关键词列表 | + +### `ahrefs_top_pages` + +获取按自然流量排序的目标域名的顶级页面。返回页面 URL 及其流量、关键词数量和预估流量价值。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `target` | string | 是 | 要分析的目标域名 | +| `country` | string | 否 | 流量数据的国家代码 \(例如：us, gb, de\)。默认值：us | +| `mode` | string | 否 | 分析模式：domain \(整个域名\), prefix \(URL 前缀\), subdomains \(包含所有子域名\) | +| `date` | string | 否 | 历史数据的日期，格式为 YYYY-MM-DD \(默认为今天\) | +| `limit` | number | 否 | 返回结果的最大数量 \(默认值：100\) | +| `offset` | number | 否 | 分页时跳过的结果数量 | +| `apiKey` | string | 是 | Ahrefs API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `pages` | array | 按自然流量排序的顶级页面列表 | + +### `ahrefs_keyword_overview` + +获取关键字的详细指标，包括搜索量、关键字难度、CPC、点击量和流量潜力。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `keyword` | string | 是 | 要分析的关键字 | +| `country` | string | 否 | 关键字数据的国家代码 \(例如：us, gb, de\)。默认值：us | +| `apiKey` | string | 是 | Ahrefs API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `overview` | object | 关键字指标概览 | + +### `ahrefs_broken_backlinks` + +获取指向目标域名或 URL 的损坏反向链接列表。这对于识别链接恢复机会非常有用。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `target` | string | 是 | 要分析的目标域名或 URL | +| `mode` | string | 否 | 分析模式：domain（整个域名）、prefix（URL 前缀）、subdomains（包括所有子域名）、exact（精确 URL 匹配） | +| `date` | string | 否 | 历史数据的日期，格式为 YYYY-MM-DD（默认为今天） | +| `limit` | number | 否 | 要返回的最大结果数（默认值：100） | +| `offset` | number | 否 | 分页时要跳过的结果数 | +| `apiKey` | string | 是 | Ahrefs API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `brokenBacklinks` | array | 损坏反向链接列表 | + +## 注意事项 + +- 类别：`tools` +- 类型：`ahrefs` diff --git a/apps/docs/content/docs/zh/tools/datadog.mdx b/apps/docs/content/docs/zh/tools/datadog.mdx new file mode 100644 index 000000000..32ae5794c --- /dev/null +++ b/apps/docs/content/docs/zh/tools/datadog.mdx @@ -0,0 +1,302 @@ +--- +title: Datadog +description: 使用 Datadog 监控基础设施、应用程序和日志 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Datadog](https://datadoghq.com/) 是一个全面的监控和分析平台，用于基础设施、应用程序、日志等。它使组织能够实时了解系统的健康状况和性能，检测异常，并自动化事件响应。 + +使用 Datadog，您可以： + +- **监控指标**：收集、可视化和分析来自服务器、云服务和自定义应用程序的指标。 +- **查询时间序列数据**：对性能指标运行高级查询，用于趋势分析和报告。 +- **管理监控和事件**：设置监控以检测问题、触发警报并创建可观察性的事件。 +- **处理停机时间**：计划和以编程方式管理计划的停机时间，在维护期间抑制警报。 +- **分析日志和跟踪**（需要在 Datadog 中进行额外设置）：集中检查日志或分布式跟踪以进行更深入的故障排除。 + +Sim 的 Datadog 集成让您的代理能够自动化这些操作，并以编程方式与您的 Datadog 账户交互。使用它提交自定义指标、查询时间序列数据、管理监控、创建事件，并直接在 Sim 自动化中简化您的监控工作流程。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Datadog 监控集成到工作流程中。提交指标、管理监控、查询日志、创建事件、处理停机时间等。 + +## 工具 + +### `datadog_submit_metrics` + +向 Datadog 提交自定义指标。用于跟踪应用程序性能、业务指标或自定义监控数据。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `series` | string | 是 | 要提交的指标系列的 JSON 数组。每个系列应包括指标名称、类型（gauge/rate/count）、点（时间戳/值对）以及可选标签。 | +| `apiKey` | string | 是 | Datadog API 密钥 | +| `site` | string | 否 | Datadog 站点/区域（默认：datadoghq.com） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | 布尔值 | 指标是否成功提交 | +| `errors` | 数组 | 提交过程中发生的任何错误 | + +### `datadog_query_timeseries` + +从 Datadog 查询指标时间序列数据。用于分析趋势、创建报告或检索指标值。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `query` | 字符串 | 是 | Datadog 指标查询 \(例如："avg:system.cpu.user\{*\}"\) | +| `from` | 数字 | 是 | 起始时间，单位为秒的 Unix 时间戳 | +| `to` | 数字 | 是 | 结束时间，单位为秒的 Unix 时间戳 | +| `apiKey` | 字符串 | 是 | Datadog API 密钥 | +| `applicationKey` | 字符串 | 是 | Datadog 应用密钥 | +| `site` | 字符串 | 否 | Datadog 站点/区域 \(默认：datadoghq.com\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `series` | 数组 | 包含指标名称、标签和数据点的时间序列数据数组 | +| `status` | 字符串 | 查询状态 | + +### `datadog_create_event` + +向 Datadog 事件流发布事件。用于部署通知、警报或任何重要事件。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `title` | 字符串 | 是 | 事件标题 | +| `text` | 字符串 | 是 | 事件正文/描述。支持 markdown。 | +| `alertType` | 字符串 | 否 | 警报类型：error、warning、info、success、user_update、recommendation 或 snapshot | +| `priority` | 字符串 | 否 | 事件优先级：normal 或 low | +| `host` | 字符串 | 否 | 与此事件关联的主机名 | +| `tags` | 字符串 | 否 | 逗号分隔的标签列表 \(例如："env:production,service:api"\) | +| `aggregationKey` | 字符串 | 否 | 用于将事件聚合在一起的键 | +| `sourceTypeName` | 字符串 | 否 | 事件的来源类型名称 | +| `dateHappened` | 数字 | 否 | 事件发生的 Unix 时间戳 \(默认为当前时间\) | +| `apiKey` | 字符串 | 是 | Datadog API 密钥 | +| `site` | 字符串 | 否 | Datadog 站点/区域 \(默认：datadoghq.com\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `event` | object | 创建的事件详情 | + +### `datadog_create_monitor` + +在 Datadog 中创建一个新的监控/警报。监控可以跟踪指标、服务检查、事件等。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `name` | string | 是 | 监控名称 | +| `type` | string | 是 | 监控类型：指标警报、服务检查、事件警报、进程警报、日志警报、查询警报、复合警报、合成警报、SLO 警报 | +| `query` | string | 是 | 监控查询 \(例如："avg\(last_5m\):avg:system.cpu.idle\{*\} < 20"\) | +| `message` | string | 否 | 通知中包含的消息。可以包含 @ 提及和 markdown。 | +| `tags` | string | 否 | 逗号分隔的标签列表 | +| `priority` | number | 否 | 监控优先级 \(1-5，其中 1 为最高\) | +| `options` | string | 否 | 监控选项的 JSON 字符串 \(阈值、notify_no_data、renotify_interval 等\) | +| `apiKey` | string | 是 | Datadog API 密钥 | +| `applicationKey` | string | 是 | Datadog 应用程序密钥 | +| `site` | string | 否 | Datadog 站点/区域 \(默认：datadoghq.com\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `monitor` | object | 创建的监控详情 | + +### `datadog_get_monitor` + +通过 ID 检索特定监控的详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `monitorId` | string | 是 | 要检索的监控 ID | +| `groupStates` | string | 否 | 要包含的逗号分隔的组状态：alert、warn、no data、ok | +| `withDowntimes` | boolean | 否 | 包含监控的停机数据 | +| `apiKey` | string | 是 | Datadog API 密钥 | +| `applicationKey` | string | 是 | Datadog 应用程序密钥 | +| `site` | string | 否 | Datadog 站点/区域 \(默认：datadoghq.com\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `monitor` | object | 监控详情 | + +### `datadog_list_monitors` + +列出 Datadog 中的所有监控，并可选择按名称、标签或状态进行筛选。 + +#### 输入 + +| 参数 | 类型 | 是否必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `groupStates` | string | 否 | 用逗号分隔的组状态进行筛选：alert、warn、no data、ok | +| `name` | string | 否 | 按名称筛选监控（部分匹配） | +| `tags` | string | 否 | 用逗号分隔的标签列表进行筛选 | +| `monitorTags` | string | 否 | 用逗号分隔的监控标签列表进行筛选 | +| `withDowntimes` | boolean | 否 | 包括监控的停机时间数据 | +| `page` | number | 否 | 分页的页码（从 0 开始） | +| `pageSize` | number | 否 | 每页的监控数量（最大 1000） | +| `apiKey` | string | 是 | Datadog API 密钥 | +| `applicationKey` | string | 是 | Datadog 应用密钥 | +| `site` | string | 否 | Datadog 站点/区域（默认：datadoghq.com） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `monitors` | array | 监控列表 | + +### `datadog_mute_monitor` + +静音监控以暂时抑制通知。 + +#### 输入 + +| 参数 | 类型 | 是否必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `monitorId` | string | 是 | 要静音的监控 ID | +| `scope` | string | 否 | 静音范围（例如："host:myhost"）。如果未指定，则静音所有范围。 | +| `end` | number | 否 | 静音结束的 Unix 时间戳。如果未指定，则无限期静音。 | +| `apiKey` | string | 是 | Datadog API 密钥 | +| `applicationKey` | string | 是 | Datadog 应用密钥 | +| `site` | string | 否 | Datadog 站点/区域（默认：datadoghq.com） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | 布尔值 | 监控是否成功静音 | + +### `datadog_query_logs` + +搜索并检索 Datadog 的日志。用于故障排除、分析或监控。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `query` | 字符串 | 是 | 日志搜索查询 \(例如："service:web-app status:error"\) | +| `from` | 字符串 | 是 | ISO-8601 格式的开始时间或相对时间 \(例如："now-1h"\) | +| `to` | 字符串 | 是 | ISO-8601 格式的结束时间或相对时间 \(例如："now"\) | +| `limit` | 数字 | 否 | 返回的最大日志数量 \(默认：50，最大：1000\) | +| `sort` | 字符串 | 否 | 排序顺序：时间戳 \(最早优先\) 或 -时间戳 \(最新优先\) | +| `indexes` | 字符串 | 否 | 要搜索的日志索引的逗号分隔列表 | +| `apiKey` | 字符串 | 是 | Datadog API 密钥 | +| `applicationKey` | 字符串 | 是 | Datadog 应用程序密钥 | +| `site` | 字符串 | 否 | Datadog 站点/区域 \(默认：datadoghq.com\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `logs` | 数组 | 日志条目列表 | + +### `datadog_send_logs` + +将日志条目发送到 Datadog 进行集中式日志记录和分析。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `logs` | 字符串 | 是 | JSON 格式的日志条目数组。每个条目应包含消息，并可选包含 ddsource、ddtags、hostname、service。 | +| `apiKey` | 字符串 | 是 | Datadog API 密钥 | +| `site` | 字符串 | 否 | Datadog 站点/区域 \(默认：datadoghq.com\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | 布尔值 | 日志是否成功发送 | + +### `datadog_create_downtime` + +安排停机时间以在维护窗口期间抑制监控通知。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `scope` | 字符串 | 是 | 应用停机的范围 \(例如："host:myhost"、"env:production" 或 "*" 表示全部\) | +| `message` | 字符串 | 否 | 停机期间显示的消息 | +| `start` | 数字 | 否 | 停机开始的 Unix 时间戳 \(默认为当前时间\) | +| `end` | 数字 | 否 | 停机结束的 Unix 时间戳 | +| `timezone` | 字符串 | 否 | 停机的时区 \(例如："America/New_York"\) | +| `monitorId` | 字符串 | 否 | 要静音的特定监控 ID | +| `monitorTags` | 字符串 | 否 | 用逗号分隔的监控标签以匹配 \(例如："team:backend,priority:high"\) | +| `muteFirstRecoveryNotification` | 布尔值 | 否 | 静音首次恢复通知 | +| `apiKey` | 字符串 | 是 | Datadog API 密钥 | +| `applicationKey` | 字符串 | 是 | Datadog 应用程序密钥 | +| `site` | 字符串 | 否 | Datadog 站点/区域 \(默认：datadoghq.com\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `downtime` | 对象 | 创建的停机详细信息 | + +### `datadog_list_downtimes` + +列出 Datadog 中所有已安排的停机时间。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `currentOnly` | 布尔值 | 否 | 仅返回当前活动的停机时间 | +| `monitorId` | 字符串 | 否 | 按监控 ID 过滤 | +| `apiKey` | 字符串 | 是 | Datadog API 密钥 | +| `applicationKey` | 字符串 | 是 | Datadog 应用程序密钥 | +| `site` | 字符串 | 否 | Datadog 站点/区域 \(默认：datadoghq.com\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `downtimes` | 数组 | 停机时间列表 | + +### `datadog_cancel_downtime` + +取消已计划的停机时间。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `downtimeId` | 字符串 | 是 | 要取消的停机时间的 ID | +| `apiKey` | 字符串 | 是 | Datadog API 密钥 | +| `applicationKey` | 字符串 | 是 | Datadog 应用程序密钥 | +| `site` | 字符串 | 否 | Datadog 站点/区域（默认值：datadoghq.com） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | 布尔值 | 停机时间是否成功取消 | + +## 注意事项 + +- 类别：`tools` +- 类型：`datadog` diff --git a/apps/docs/content/docs/zh/tools/dropbox.mdx b/apps/docs/content/docs/zh/tools/dropbox.mdx new file mode 100644 index 000000000..aa34b8795 --- /dev/null +++ b/apps/docs/content/docs/zh/tools/dropbox.mdx @@ -0,0 +1,219 @@ +--- +title: Dropbox +description: 在 Dropbox 中上传、下载、分享和管理文件 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Dropbox](https://dropbox.com/) 是一个流行的云存储和协作平台，能够让个人和团队安全地存储、访问和分享文件，无论身在何处。Dropbox 专为便捷的文件管理、同步和强大的协作而设计，无论您是单独工作还是与团队合作。 + +在 Sim 中使用 Dropbox，您可以： + +- **上传和下载文件**：无缝上传任何文件到您的 Dropbox 或按需检索内容 +- **列出文件夹内容**：浏览任何 Dropbox 目录中的文件和文件夹 +- **创建新文件夹**：通过编程方式在您的 Dropbox 中创建新文件夹以组织文件 +- **搜索文件和文件夹**：通过名称或内容定位文档、图片或其他项目 +- **生成共享链接**：快速为文件和文件夹创建可分享的公共或私人链接 +- **管理文件**：在自动化工作流中移动、删除或重命名文件和文件夹 + +这些功能使您的 Sim 代理能够直接在工作流中自动化 Dropbox 操作——从备份重要文件到分发内容以及维护有序的文件夹。将 Dropbox 用作文件的来源和目的地，使云存储管理成为您业务流程的一部分。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Dropbox 集成到您的工作流中，用于文件管理、分享和协作。上传文件、下载内容、创建文件夹、管理共享链接等。 + +## 工具 + +### `dropbox_upload` + +上传文件到 Dropbox + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `path` | string | 是 | 文件应保存到 Dropbox 的路径 \(例如：/folder/document.pdf\) | +| `fileContent` | string | 是 | 要上传文件的 base64 编码内容 | +| `fileName` | string | 否 | 可选文件名 \(如果路径是文件夹时使用\) | +| `mode` | string | 否 | 写入模式：add \(默认\) 或 overwrite | +| `autorename` | boolean | 否 | 如果为 true，在发生冲突时重命名文件 | +| `mute` | boolean | 否 | 如果为 true，不通知用户此上传 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `file` | object | 上传文件的元数据 | + +### `dropbox_download` + +从 Dropbox 下载文件并获取临时链接 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `path` | string | 是 | 要下载文件的路径 \(例如：/folder/document.pdf\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `file` | object | 文件的元数据 | + +### `dropbox_list_folder` + +列出 Dropbox 文件夹的内容 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `path` | string | 是 | 要列出内容的文件夹路径 \(根目录使用 ""\) | +| `recursive` | boolean | 否 | 如果为 true，则递归列出内容 | +| `includeDeleted` | boolean | 否 | 如果为 true，则包括已删除的文件/文件夹 | +| `includeMediaInfo` | boolean | 否 | 如果为 true，则包括照片/视频的媒体信息 | +| `limit` | number | 否 | 要返回的最大结果数 \(默认值：500\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `entries` | array | 目录中的文件和文件夹列表 | + +### `dropbox_create_folder` + +在 Dropbox 中创建一个新文件夹 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `path` | string | 是 | 创建文件夹的路径 \(例如：/new-folder\) | +| `autorename` | boolean | 否 | 如果有冲突，是否重命名文件夹 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `folder` | object | 创建的文件夹元数据 | + +### `dropbox_delete` + +删除 Dropbox 中的文件或文件夹（移至回收站） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `path` | string | 是 | 要删除的文件或文件夹的路径 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `metadata` | object | 已删除项目的元数据 | + +### `dropbox_copy` + +复制 Dropbox 中的文件或文件夹 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `fromPath` | string | 是 | 要复制的文件或文件夹的源路径 | +| `toPath` | string | 是 | 复制文件或文件夹的目标路径 | +| `autorename` | boolean | 否 | 如果为 true，则在目标位置存在冲突时重命名文件 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `metadata` | object | 已复制项目的元数据 | + +### `dropbox_move` + +移动或重命名 Dropbox 中的文件或文件夹 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `fromPath` | string | 是 | 要移动的文件或文件夹的源路径 | +| `toPath` | string | 是 | 移动文件或文件夹的目标路径 | +| `autorename` | boolean | 否 | 如果为 true，则在目标位置存在冲突时重命名文件 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `metadata` | object | 已移动项目的元数据 | + +### `dropbox_get_metadata` + +获取 Dropbox 中文件或文件夹的元数据 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `path` | string | 是 | 要获取元数据的文件或文件夹路径 | +| `includeMediaInfo` | boolean | 否 | 如果为 true，则包含照片/视频的媒体信息 | +| `includeDeleted` | boolean | 否 | 如果为 true，则在结果中包含已删除的文件 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `metadata` | object | 文件或文件夹的元数据 | + +### `dropbox_create_shared_link` + +为 Dropbox 中的文件或文件夹创建可共享链接 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `path` | string | 是 | 要共享的文件或文件夹路径 | +| `requestedVisibility` | string | 否 | 可见性：public、team_only 或 password | +| `linkPassword` | string | 否 | 共享链接的密码（仅当可见性为 password 时） | +| `expires` | string | 否 | ISO 8601 格式的过期日期（例如：2025-12-31T23:59:59Z） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `sharedLink` | object | 创建的共享链接 | + +### `dropbox_search` + +在 Dropbox 中搜索文件和文件夹 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `query` | string | 是 | 搜索查询 | +| `path` | string | 否 | 将搜索限制在特定文件夹路径内 | +| `fileExtensions` | string | 否 | 用逗号分隔的文件扩展名列表进行过滤（例如：pdf,xlsx） | +| `maxResults` | number | 否 | 返回的最大结果数（默认值：100） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `matches` | array | 搜索结果 | + +## 注意 + +- 类别：`tools` +- 类型：`dropbox` diff --git a/apps/docs/content/docs/zh/tools/elasticsearch.mdx b/apps/docs/content/docs/zh/tools/elasticsearch.mdx new file mode 100644 index 000000000..2057c48da --- /dev/null +++ b/apps/docs/content/docs/zh/tools/elasticsearch.mdx @@ -0,0 +1,365 @@ +--- +title: Elasticsearch +description: 在 Elasticsearch 中搜索、索引和管理数据 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Elasticsearch](https://www.elastic.co/elasticsearch/) 是一个功能强大的分布式搜索和分析引擎，可以让您实时索引、搜索和分析海量数据。它被广泛用于支持搜索功能、日志和事件数据分析、可观测性等。 + +在 Sim 中使用 Elasticsearch，您可以以编程方式访问 Elasticsearch 的核心功能，包括： + +- **搜索文档**：使用 Query DSL 对结构化或非结构化文本执行高级搜索，支持排序、分页和字段选择。 +- **索引文档**：在任何 Elasticsearch 索引中添加新文档或更新现有文档，以便即时检索和分析。 +- **获取、更新或删除文档**：通过 ID 检索、修改或删除特定文档。 +- **批量操作**：在单个请求中执行多个索引或更新操作，以实现高吞吐量的数据处理。 +- **管理索引**：在工作流自动化中创建、删除或获取索引的详细信息。 +- **集群监控**：检查 Elasticsearch 部署的健康状况和统计信息。 + +Sim 的 Elasticsearch 工具支持自托管和 Elastic Cloud 环境。将 Elasticsearch 集成到您的代理工作流中，以自动化数据摄取、跨大型数据集搜索、运行报告或构建自定义搜索驱动的应用程序——无需人工干预。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Elasticsearch 集成到工作流中，实现强大的搜索、索引和数据管理。支持文档的 CRUD 操作、高级搜索查询、批量操作、索引管理和集群监控。适用于自托管和 Elastic Cloud 部署。 + +## 工具 + +### `elasticsearch_search` + +使用 Query DSL 在 Elasticsearch 中搜索文档。返回匹配的文档及其分数和元数据。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | 是 | 部署类型：self_hosted 或 cloud | +| `host` | string | 否 | Elasticsearch 主机 URL（适用于自托管） | +| `cloudId` | string | 否 | Elastic Cloud ID（适用于云部署） | +| `authMethod` | string | 是 | 认证方法：api_key 或 basic_auth | +| `apiKey` | string | 否 | Elasticsearch API 密钥 | +| `username` | string | 否 | 基本认证的用户名 | +| `password` | string | 否 | 基本认证的密码 | +| `index` | string | 是 | 要搜索的索引名称 | +| `query` | string | 否 | 作为 JSON 字符串的 Query DSL | +| `from` | number | 否 | 分页的起始偏移量（默认值：0） | +| `size` | number | 否 | 返回结果的数量（默认值：10） | +| `sort` | string | 否 | 作为 JSON 字符串的排序规范 | +| `sourceIncludes` | string | 否 | 逗号分隔的字段列表以包含在 _source 中 | +| `sourceExcludes` | string | 否 | 逗号分隔的字段列表以从 _source 中排除 | +| `trackTotalHits` | boolean | 否 | 跟踪准确的总命中计数（默认值：true） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `took` | number | 搜索所花费的时间（以毫秒为单位） | +| `timed_out` | boolean | 搜索是否超时 | +| `hits` | object | 包含总数和匹配文档的搜索结果 | +| `aggregations` | json | 聚合结果（如果有） | + +### `elasticsearch_index_document` + +在 Elasticsearch 中索引（创建或更新）文档。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | 是 | 部署类型：self_hosted 或 cloud | +| `host` | string | 否 | Elasticsearch 主机 URL（适用于自托管）| +| `cloudId` | string | 否 | Elastic Cloud ID（适用于云部署）| +| `authMethod` | string | 是 | 认证方法：api_key 或 basic_auth | +| `apiKey` | string | 否 | Elasticsearch API 密钥 | +| `username` | string | 否 | 基本认证的用户名 | +| `password` | string | 否 | 基本认证的密码 | +| `index` | string | 是 | 目标索引名称 | +| `documentId` | string | 否 | 文档 ID（如果未提供则自动生成）| +| `document` | string | 是 | 文档正文，格式为 JSON 字符串 | +| `refresh` | string | 否 | 刷新策略：true、false 或 wait_for | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `_index` | string | 文档存储的索引 | +| `_id` | string | 文档 ID | +| `_version` | number | 文档版本 | +| `result` | string | 操作结果（创建或更新）| + +### `elasticsearch_get_document` + +通过 ID 从 Elasticsearch 检索文档。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | 是 | 部署类型：self_hosted 或 cloud | +| `host` | string | 否 | Elasticsearch 主机 URL（适用于自托管）| +| `cloudId` | string | 否 | Elastic Cloud ID（适用于云部署）| +| `authMethod` | string | 是 | 认证方法：api_key 或 basic_auth | +| `apiKey` | string | 否 | Elasticsearch API 密钥 | +| `username` | string | 否 | 基本认证的用户名 | +| `password` | string | 否 | 基本认证的密码 | +| `index` | string | 是 | 索引名称 | +| `documentId` | string | 是 | 要检索的文档 ID | +| `sourceIncludes` | string | 否 | 要包含的字段的逗号分隔列表 | +| `sourceExcludes` | string | 否 | 要排除的字段的逗号分隔列表 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `_index` | string | 索引名称 | +| `_id` | string | 文档 ID | +| `_version` | number | 文档版本 | +| `found` | boolean | 文档是否被找到 | +| `_source` | json | 文档内容 | + +### `elasticsearch_update_document` + +使用 doc merge 部分更新 Elasticsearch 中的文档。 + +#### 输入 + +| 参数 | 类型 | 是否必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | 是 | 部署类型：self_hosted 或 cloud | +| `host` | string | 否 | Elasticsearch 主机 URL（适用于自托管） | +| `cloudId` | string | 否 | Elastic Cloud ID（适用于云部署） | +| `authMethod` | string | 是 | 认证方法：api_key 或 basic_auth | +| `apiKey` | string | 否 | Elasticsearch API 密钥 | +| `username` | string | 否 | 基本认证的用户名 | +| `password` | string | 否 | 基本认证的密码 | +| `index` | string | 是 | 索引名称 | +| `documentId` | string | 是 | 要更新的文档 ID | +| `document` | string | 是 | 要合并的部分文档（JSON 字符串） | +| `retryOnConflict` | number | 否 | 版本冲突时的重试次数 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `_index` | string | 索引名称 | +| `_id` | string | 文档 ID | +| `_version` | number | 新的文档版本 | +| `result` | string | 操作结果（updated 或 noop） | + +### `elasticsearch_delete_document` + +通过 ID 从 Elasticsearch 中删除文档。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | 是 | 部署类型：self_hosted 或 cloud | +| `host` | string | 否 | Elasticsearch 主机 URL（适用于自托管）| +| `cloudId` | string | 否 | Elastic Cloud ID（适用于云部署）| +| `authMethod` | string | 是 | 认证方法：api_key 或 basic_auth | +| `apiKey` | string | 否 | Elasticsearch API 密钥 | +| `username` | string | 否 | 基本认证的用户名 | +| `password` | string | 否 | 基本认证的密码 | +| `index` | string | 是 | 索引名称 | +| `documentId` | string | 是 | 要删除的文档 ID | +| `refresh` | string | 否 | 刷新策略：true、false 或 wait_for | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `_index` | string | 索引名称 | +| `_id` | string | 文档 ID | +| `_version` | number | 文档版本 | +| `result` | string | 操作结果（deleted 或 not_found）| + +### `elasticsearch_bulk` + +在单个请求中执行多个索引、创建、删除或更新操作以实现高性能。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | 是 | 部署类型：self_hosted 或 cloud | +| `host` | string | 否 | Elasticsearch 主机 URL（适用于自托管）| +| `cloudId` | string | 否 | Elastic Cloud ID（适用于云部署）| +| `authMethod` | string | 是 | 认证方法：api_key 或 basic_auth | +| `apiKey` | string | 否 | Elasticsearch API 密钥 | +| `username` | string | 否 | 基本认证的用户名 | +| `password` | string | 否 | 基本认证的密码 | +| `index` | string | 否 | 未指定索引时的默认索引 | +| `operations` | string | 是 | 批量操作的 NDJSON 字符串（换行分隔的 JSON）| +| `refresh` | string | 否 | 刷新策略：true、false 或 wait_for | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `took` | number | 批量操作所花费的时间（以毫秒为单位） | +| `errors` | boolean | 是否有任何操作出现错误 | +| `items` | array | 每个操作的结果 | + +### `elasticsearch_count` + +统计 Elasticsearch 中符合查询条件的文档数量。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | 是 | 部署类型：self_hosted 或 cloud | +| `host` | string | 否 | Elasticsearch 主机 URL（适用于自托管） | +| `cloudId` | string | 否 | Elastic Cloud ID（适用于云部署） | +| `authMethod` | string | 是 | 认证方法：api_key 或 basic_auth | +| `apiKey` | string | 否 | Elasticsearch API 密钥 | +| `username` | string | 否 | 基本认证的用户名 | +| `password` | string | 否 | 基本认证的密码 | +| `index` | string | 是 | 要统计文档数量的索引名称 | +| `query` | string | 否 | 用于过滤文档的可选查询（JSON 字符串） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `count` | number | 符合查询条件的文档数量 | +| `_shards` | object | 分片统计信息 | + +### `elasticsearch_create_index` + +创建一个具有可选设置和映射的新索引。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | 是 | 部署类型：self_hosted 或 cloud | +| `host` | string | 否 | Elasticsearch 主机 URL（适用于自托管） | +| `cloudId` | string | 否 | Elastic Cloud ID（适用于云部署） | +| `authMethod` | string | 是 | 认证方法：api_key 或 basic_auth | +| `apiKey` | string | 否 | Elasticsearch API 密钥 | +| `username` | string | 否 | 基本认证的用户名 | +| `password` | string | 否 | 基本认证的密码 | +| `index` | string | 是 | 要创建的索引名称 | +| `settings` | string | 否 | 索引设置（JSON 字符串） | +| `mappings` | string | 否 | 索引映射（JSON 字符串） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `acknowledged` | boolean | 请求是否被确认 | +| `shards_acknowledged` | boolean | 分片是否被确认 | +| `index` | string | 创建的索引名称 | + +### `elasticsearch_delete_index` + +删除一个索引及其所有文档。此操作不可逆。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | 是 | 部署类型：self_hosted 或 cloud | +| `host` | string | 否 | Elasticsearch 主机 URL（适用于自托管）| +| `cloudId` | string | 否 | Elastic Cloud ID（适用于云部署）| +| `authMethod` | string | 是 | 认证方法：api_key 或 basic_auth | +| `apiKey` | string | 否 | Elasticsearch API 密钥 | +| `username` | string | 否 | 基本认证的用户名 | +| `password` | string | 否 | 基本认证的密码 | +| `index` | string | 是 | 要删除的索引名称 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `acknowledged` | boolean | 删除是否被确认 | + +### `elasticsearch_get_index` + +检索索引信息，包括设置、映射和别名。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | 是 | 部署类型：self_hosted 或 cloud | +| `host` | string | 否 | Elasticsearch 主机 URL（适用于自托管）| +| `cloudId` | string | 否 | Elastic Cloud ID（适用于云部署）| +| `authMethod` | string | 是 | 认证方法：api_key 或 basic_auth | +| `apiKey` | string | 否 | Elasticsearch API 密钥 | +| `username` | string | 否 | 基本认证的用户名 | +| `password` | string | 否 | 基本认证的密码 | +| `index` | string | 是 | 要检索信息的索引名称 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `index` | json | 包括别名、映射和设置的索引信息 | + +### `elasticsearch_cluster_health` + +获取 Elasticsearch 集群的健康状态。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | 是 | 部署类型：self_hosted 或 cloud | +| `host` | string | 否 | Elasticsearch 主机 URL（适用于自托管）| +| `cloudId` | string | 否 | Elastic Cloud ID（适用于云部署）| +| `authMethod` | string | 是 | 认证方法：api_key 或 basic_auth | +| `apiKey` | string | 否 | Elasticsearch API 密钥 | +| `username` | string | 否 | 基本认证的用户名 | +| `password` | string | 否 | 基本认证的密码 | +| `waitForStatus` | string | 否 | 等待集群达到此状态：green、yellow 或 red | +| `timeout` | string | 否 | 等待操作的超时时间（例如，30s，1m）| + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `cluster_name` | string | 集群名称 | +| `status` | string | 集群健康状态：green、yellow 或 red | +| `number_of_nodes` | number | 集群中的节点总数 | +| `number_of_data_nodes` | number | 数据节点的数量 | +| `active_shards` | number | 活跃分片的数量 | +| `unassigned_shards` | number | 未分配分片的数量 | + +### `elasticsearch_cluster_stats` + +获取有关 Elasticsearch 集群的综合统计信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `deploymentType` | string | 是 | 部署类型：self_hosted 或 cloud | +| `host` | string | 否 | Elasticsearch 主机 URL（适用于自托管） | +| `cloudId` | string | 否 | Elastic Cloud ID（适用于云部署） | +| `authMethod` | string | 是 | 认证方法：api_key 或 basic_auth | +| `apiKey` | string | 否 | Elasticsearch API 密钥 | +| `username` | string | 否 | 基本认证的用户名 | +| `password` | string | 否 | 基本认证的密码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `cluster_name` | string | 集群名称 | +| `status` | string | 集群健康状态 | +| `nodes` | object | 节点统计信息，包括数量和版本 | +| `indices` | object | 索引统计信息，包括文档数量和存储大小 | + +## 注意 + +- 类别：`tools` +- 类型：`elasticsearch` diff --git a/apps/docs/content/docs/zh/tools/gitlab.mdx b/apps/docs/content/docs/zh/tools/gitlab.mdx new file mode 100644 index 000000000..405cdd93d --- /dev/null +++ b/apps/docs/content/docs/zh/tools/gitlab.mdx @@ -0,0 +1,429 @@ +--- +title: GitLab +description: 与 GitLab 项目、问题、合并请求和流水线进行交互 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[GitLab](https://gitlab.com/) 是一个全面的 DevOps 平台，允许团队管理、协作并自动化其软件开发生命周期。通过 GitLab，您可以轻松处理源代码管理、CI/CD、评审和协作，全部集中在一个应用程序中。 + +在 Sim 中使用 GitLab，您可以： + +- **管理项目和存储库**：列出并检索您的 GitLab 项目，访问详细信息并组织您的存储库 +- **处理问题**：列出、创建并评论问题，以跟踪工作并有效协作 +- **管理合并请求**：审查、创建并管理代码更改和同行评审的合并请求 +- **自动化 CI/CD 流水线**：触发、监控并与 GitLab 流水线交互，作为自动化流程的一部分 +- **通过评论协作**：为问题或合并请求添加评论，以提高团队内部的高效沟通 + +通过 Sim 的 GitLab 集成，您的代理可以以编程方式与您的 GitLab 项目交互。无缝自动化项目管理、问题跟踪、代码评审和流水线操作，在您的工作流程中优化软件开发过程，并增强团队协作。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 GitLab 集成到工作流程中。可以管理项目、问题、合并请求、流水线并添加评论。支持所有核心 GitLab DevOps 操作。 + +## 工具 + +### `gitlab_list_projects` + +列出经过身份验证的用户可访问的 GitLab 项目 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `owned` | boolean | 否 | 限制为当前用户拥有的项目 | +| `membership` | boolean | 否 | 限制为当前用户是成员的项目 | +| `search` | string | 否 | 按名称搜索项目 | +| `visibility` | string | 否 | 按可见性筛选 \(public, internal, private\) | +| `orderBy` | string | 否 | 按字段排序 \(id, name, path, created_at, updated_at, last_activity_at\) | +| `sort` | string | 否 | 排序方向 \(asc, desc\) | +| `perPage` | number | 否 | 每页结果数量 \(默认 20, 最大 100\) | +| `page` | number | 否 | 分页的页码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `projects` | array | GitLab 项目列表 | +| `total` | number | 项目总数 | + +### `gitlab_get_project` + +获取特定 GitLab 项目的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 \(例如："namespace/project"\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `project` | object | GitLab 项目详情 | + +### `gitlab_list_issues` + +列出 GitLab 项目中的问题 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `state` | string | 否 | 按状态过滤 \(opened, closed, all\) | +| `labels` | string | 否 | 以逗号分隔的标签名称列表 | +| `assigneeId` | number | 否 | 按分配的用户 ID 过滤 | +| `milestoneTitle` | string | 否 | 按里程碑标题过滤 | +| `search` | string | 否 | 按标题和描述搜索问题 | +| `orderBy` | string | 否 | 按字段排序 \(created_at, updated_at\) | +| `sort` | string | 否 | 排序方向 \(asc, desc\) | +| `perPage` | number | 否 | 每页结果数量 \(默认 20，最大 100\) | +| `page` | number | 否 | 分页页码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `issues` | array | GitLab 问题的列表 | +| `total` | number | 问题的总数 | + +### `gitlab_get_issue` + +获取特定 GitLab 问题的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `issueIid` | number | 是 | 项目中的问题编号 \(在 GitLab 界面中显示的 #\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `issue` | object | GitLab 问题的详细信息 | + +### `gitlab_create_issue` + +在 GitLab 项目中创建一个新问题 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `title` | string | 是 | 问题标题 | +| `description` | string | 否 | 问题描述 \(支持 Markdown\) | +| `labels` | string | 否 | 逗号分隔的标签名称列表 | +| `assigneeIds` | array | 否 | 分配的用户 ID 数组 | +| `milestoneId` | number | 否 | 分配的里程碑 ID | +| `dueDate` | string | 否 | YYYY-MM-DD 格式的截止日期 | +| `confidential` | boolean | 否 | 问题是否为机密 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `issue` | object | 创建的 GitLab 问题 | + +### `gitlab_update_issue` + +更新 GitLab 项目中的现有问题 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `issueIid` | number | 是 | 问题内部 ID \(IID\) | +| `title` | string | 否 | 新问题标题 | +| `description` | string | 否 | 新问题描述 \(支持 Markdown\) | +| `stateEvent` | string | 否 | 状态事件 \(关闭或重新打开\) | +| `labels` | string | 否 | 逗号分隔的标签名称列表 | +| `assigneeIds` | array | 否 | 分配的用户 ID 数组 | +| `milestoneId` | number | 否 | 分配的里程碑 ID | +| `dueDate` | string | 否 | YYYY-MM-DD 格式的截止日期 | +| `confidential` | boolean | 否 | 问题是否为机密 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `issue` | object | 更新的 GitLab 问题 | + +### `gitlab_delete_issue` + +从 GitLab 项目中删除问题 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `issueIid` | number | 是 | 问题内部 ID \(IID\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | 布尔值 | 问题是否成功删除 | + +### `gitlab_create_issue_note` + +向 GitLab 问题添加评论 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | 字符串 | 是 | 项目 ID 或 URL 编码路径 | +| `issueIid` | 数字 | 是 | 问题内部 ID \(IID\) | +| `body` | 字符串 | 是 | 评论正文 \(支持 Markdown\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `note` | 对象 | 创建的评论 | + +### `gitlab_list_merge_requests` + +列出 GitLab 项目中的合并请求 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | 字符串 | 是 | 项目 ID 或 URL 编码路径 | +| `state` | 字符串 | 否 | 按状态筛选 \(opened, closed, merged, all\) | +| `labels` | 字符串 | 否 | 逗号分隔的标签名称列表 | +| `sourceBranch` | 字符串 | 否 | 按源分支筛选 | +| `targetBranch` | 字符串 | 否 | 按目标分支筛选 | +| `orderBy` | 字符串 | 否 | 按字段排序 \(created_at, updated_at\) | +| `sort` | 字符串 | 否 | 排序方向 \(asc, desc\) | +| `perPage` | 数字 | 否 | 每页结果数量 \(默认 20，最大 100\) | +| `page` | 数字 | 否 | 分页页码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `mergeRequests` | array | GitLab 合并请求列表 | +| `total` | number | 合并请求的总数 | + +### `gitlab_get_merge_request` + +获取特定 GitLab 合并请求的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `mergeRequestIid` | number | 是 | 合并请求的内部 ID \(IID\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `mergeRequest` | object | GitLab 合并请求的详细信息 | + +### `gitlab_create_merge_request` + +在 GitLab 项目中创建新的合并请求 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `sourceBranch` | string | 是 | 源分支名称 | +| `targetBranch` | string | 是 | 目标分支名称 | +| `title` | string | 是 | 合并请求标题 | +| `description` | string | 否 | 合并请求描述 \(支持 Markdown\) | +| `labels` | string | 否 | 逗号分隔的标签名称列表 | +| `assigneeIds` | array | 否 | 分配的用户 ID 数组 | +| `milestoneId` | number | 否 | 分配的里程碑 ID | +| `removeSourceBranch` | boolean | 否 | 合并后删除源分支 | +| `squash` | boolean | 否 | 合并时压缩提交 | +| `draft` | boolean | 否 | 标记为草稿 \(进行中\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `mergeRequest` | object | 创建的 GitLab 合并请求 | + +### `gitlab_update_merge_request` + +更新 GitLab 项目中的现有合并请求 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `mergeRequestIid` | number | 是 | 合并请求内部 ID \(IID\) | +| `title` | string | 否 | 新的合并请求标题 | +| `description` | string | 否 | 新的合并请求描述 | +| `stateEvent` | string | 否 | 状态事件 \(关闭或重新打开\) | +| `labels` | string | 否 | 逗号分隔的标签名称列表 | +| `assigneeIds` | array | 否 | 分配的用户 ID 数组 | +| `milestoneId` | number | 否 | 分配的里程碑 ID | +| `targetBranch` | string | 否 | 新的目标分支 | +| `removeSourceBranch` | boolean | 否 | 合并后删除源分支 | +| `squash` | boolean | 否 | 合并时压缩提交 | +| `draft` | boolean | 否 | 标记为草稿 \(进行中\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `mergeRequest` | object | 更新的 GitLab 合并请求 | + +### `gitlab_merge_merge_request` + +在 GitLab 项目中合并合并请求 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `mergeRequestIid` | number | 是 | 合并请求内部 ID \(IID\) | +| `mergeCommitMessage` | string | 否 | 自定义合并提交消息 | +| `squashCommitMessage` | string | 否 | 自定义压缩提交消息 | +| `squash` | boolean | 否 | 合并前压缩提交 | +| `shouldRemoveSourceBranch` | boolean | 否 | 合并后删除源分支 | +| `mergeWhenPipelineSucceeds` | boolean | 否 | 在流水线成功时合并 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `mergeRequest` | object | 合并的 GitLab 合并请求 | + +### `gitlab_create_merge_request_note` + +向 GitLab 合并请求添加评论 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `mergeRequestIid` | number | 是 | 合并请求内部 ID \(IID\) | +| `body` | string | 是 | 评论正文 \(支持 Markdown\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `note` | object | 创建的评论 | + +### `gitlab_list_pipelines` + +列出 GitLab 项目中的流水线 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `ref` | string | 否 | 按 ref 过滤 \(分支或标签\) | +| `status` | string | 否 | 按状态过滤 \(created, waiting_for_resource, preparing, pending, running, success, failed, canceled, skipped, manual, scheduled\) | +| `orderBy` | string | 否 | 按字段排序 \(id, status, ref, updated_at, user_id\) | +| `sort` | string | 否 | 排序方向 \(asc, desc\) | +| `perPage` | number | 否 | 每页结果数量 \(默认 20，最大 100\) | +| `page` | number | 否 | 分页页码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `pipelines` | array | GitLab 流水线列表 | +| `total` | number | 流水线总数 | + +### `gitlab_get_pipeline` + +获取特定 GitLab 流水线的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `pipelineId` | number | 是 | 流水线 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `pipeline` | object | GitLab 流水线详情 | + +### `gitlab_create_pipeline` + +在 GitLab 项目中触发新的流水线 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `ref` | string | 是 | 要运行流水线的分支或标签 | +| `variables` | array | 否 | 流水线的变量数组（每个包含 key、value 和可选的 variable_type） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `pipeline` | object | 创建的 GitLab 流水线 | + +### `gitlab_retry_pipeline` + +重试失败的 GitLab 流水线 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `pipelineId` | number | 是 | 流水线 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `pipeline` | object | 重试的 GitLab 流水线 | + +### `gitlab_cancel_pipeline` + +取消正在运行的 GitLab 流水线 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID 或 URL 编码路径 | +| `pipelineId` | number | 是 | 流水线 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `pipeline` | object | 已取消的 GitLab 流水线 | + +## 注意 + +- 类别: `tools` +- 类型: `gitlab` diff --git a/apps/docs/content/docs/zh/tools/grafana.mdx b/apps/docs/content/docs/zh/tools/grafana.mdx new file mode 100644 index 000000000..ada49f548 --- /dev/null +++ b/apps/docs/content/docs/zh/tools/grafana.mdx @@ -0,0 +1,494 @@ +--- +title: Grafana +description: 与 Grafana 仪表板、警报和注释交互 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Grafana](https://grafana.com/) 是一个领先的开源平台，用于监控、可观测性和可视化。它允许用户从各种数据源查询、可视化、警报和分析数据，是基础设施和应用程序监控的重要工具。 + +使用 Grafana，您可以： + +- **可视化数据**：构建和自定义仪表板，以实时显示指标、日志和跟踪 +- **监控健康和状态**：检查 Grafana 实例和连接的数据源的健康状况 +- **管理警报和注释**：设置警报规则，管理通知，并使用重要事件注释仪表板 +- **组织内容**：将仪表板和数据源组织到文件夹中，以便更好地进行访问管理 + +在 Sim 中，Grafana 集成使您的代理能够通过 API 直接与您的 Grafana 实例交互，实现以下操作： + +- 检查 Grafana 服务器、数据库和数据源的健康状态 +- 检索、列出和管理仪表板、警报规则、注释、数据源和文件夹 +- 通过将 Grafana 数据和警报集成到您的工作流自动化中，实现基础设施监控的自动化 + +这些功能使 Sim 代理能够监控系统，主动响应警报，并帮助确保服务的可靠性和可见性——所有这些都作为您自动化工作流的一部分。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Grafana 集成到工作流中。管理仪表板、警报、注释、数据源、文件夹，并监控健康状态。 + +## 工具 + +### `grafana_get_dashboard` + +通过其 UID 获取仪表板 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `dashboardUid` | string | 是 | 要检索的仪表板的 UID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `dashboard` | json | 完整的仪表板 JSON 对象 | +| `meta` | json | 仪表板元数据（版本、权限等） | + +### `grafana_list_dashboards` + +搜索并列出所有仪表板 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL（例如：https://your-grafana.com） | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `query` | string | 否 | 按标题过滤仪表板的搜索查询 | +| `tag` | string | 否 | 按标签过滤（多个标签用逗号分隔） | +| `folderIds` | string | 否 | 按文件夹 ID 过滤（用逗号分隔） | +| `starred` | boolean | 否 | 仅返回加星标的仪表板 | +| `limit` | number | 否 | 返回的仪表板最大数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `dashboards` | array | 仪表板搜索结果列表 | + +### `grafana_create_dashboard` + +创建新仪表板 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL（例如：https://your-grafana.com） | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `title` | string | 是 | 新仪表板的标题 | +| `folderUid` | string | 否 | 创建仪表板的文件夹 UID | +| `tags` | string | 否 | 逗号分隔的标签列表 | +| `timezone` | string | 否 | 仪表板时区（例如：browser, utc） | +| `refresh` | string | 否 | 自动刷新间隔（例如：5s, 1m, 5m） | +| `panels` | string | 否 | 面板配置的 JSON 数组 | +| `overwrite` | boolean | 否 | 覆盖具有相同标题的现有仪表板 | +| `message` | string | 否 | 仪表板版本的提交消息 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | number | 创建的仪表板的数字 ID | +| `uid` | string | 创建的仪表板的 UID | +| `url` | string | 仪表板的 URL 路径 | +| `status` | string | 操作状态 \(成功\) | +| `version` | number | 仪表板的版本号 | +| `slug` | string | 仪表板的 URL 友好型 slug | + +### `grafana_update_dashboard` + +更新现有的仪表板。获取当前仪表板并合并您的更改。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `dashboardUid` | string | 是 | 要更新的仪表板的 UID | +| `title` | string | 否 | 仪表板的新标题 | +| `folderUid` | string | 否 | 要移动仪表板的新文件夹 UID | +| `tags` | string | 否 | 新标签的逗号分隔列表 | +| `timezone` | string | 否 | 仪表板时区 \(例如：browser, utc\) | +| `refresh` | string | 否 | 自动刷新间隔 \(例如：5s, 1m, 5m\) | +| `panels` | string | 否 | 面板配置的 JSON 数组 | +| `overwrite` | boolean | 否 | 即使存在版本冲突也覆盖 | +| `message` | string | 否 | 此版本的提交消息 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | number | 更新后的仪表盘的数字 ID | +| `uid` | string | 更新后的仪表盘的 UID | +| `url` | string | 仪表盘的 URL 路径 | +| `status` | string | 操作状态 \(成功\) | +| `version` | number | 仪表盘的新版本号 | +| `slug` | string | 仪表盘的 URL 友好型 slug | + +### `grafana_delete_dashboard` + +通过其 UID 删除仪表盘 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `dashboardUid` | string | 是 | 要删除的仪表盘的 UID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `title` | string | 已删除仪表盘的标题 | +| `message` | string | 确认消息 | +| `id` | number | 已删除仪表盘的 ID | + +### `grafana_list_alert_rules` + +列出 Grafana 实例中的所有警报规则 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `rules` | 数组 | 警报规则列表 | + +### `grafana_get_alert_rule` + +通过其 UID 获取特定的警报规则 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | 字符串 | 是 | Grafana 服务账户令牌 | +| `baseUrl` | 字符串 | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | 字符串 | 否 | 多组织 Grafana 实例的组织 ID | +| `alertRuleUid` | 字符串 | 是 | 要检索的警报规则的 UID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `uid` | 字符串 | 警报规则 UID | +| `title` | 字符串 | 警报规则标题 | +| `condition` | 字符串 | 警报条件 | +| `data` | JSON | 警报规则查询数据 | +| `folderUID` | 字符串 | 父文件夹 UID | +| `ruleGroup` | 字符串 | 规则组名称 | +| `noDataState` | 字符串 | 无数据返回时的状态 | +| `execErrState` | 字符串 | 执行错误时的状态 | +| `annotations` | JSON | 警报注释 | +| `labels` | JSON | 警报标签 | + +### `grafana_create_alert_rule` + +创建新的警报规则 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | 字符串 | 是 | Grafana 服务账户令牌 | +| `baseUrl` | 字符串 | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | 字符串 | 否 | 多组织 Grafana 实例的组织 ID | +| `title` | 字符串 | 是 | 警报规则的标题 | +| `folderUid` | 字符串 | 是 | 创建警报的文件夹 UID | +| `ruleGroup` | 字符串 | 是 | 规则组名称 | +| `condition` | 字符串 | 是 | 用作警报条件的查询或表达式的 refId | +| `data` | 字符串 | 是 | 查询/表达式数据对象的 JSON 数组 | +| `forDuration` | 字符串 | 否 | 触发前的等待时间 \(例如：5m, 1h\) | +| `noDataState` | 字符串 | 否 | 无数据返回时的状态 \(NoData, Alerting, OK\) | +| `execErrState` | 字符串 | 否 | 执行错误时的状态 \(Alerting, OK\) | +| `annotations` | 字符串 | 否 | 注释的 JSON 对象 | +| `labels` | 字符串 | 否 | 标签的 JSON 对象 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `uid` | string | 创建的警报规则的 UID | +| `title` | string | 警报规则标题 | +| `folderUID` | string | 父文件夹 UID | +| `ruleGroup` | string | 规则组名称 | + +### `grafana_update_alert_rule` + +更新现有的警报规则。获取当前规则并合并您的更改。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `alertRuleUid` | string | 是 | 要更新的警报规则的 UID | +| `title` | string | 否 | 警报规则的新标题 | +| `folderUid` | string | 否 | 移动警报到的新文件夹 UID | +| `ruleGroup` | string | 否 | 新规则组名称 | +| `condition` | string | 否 | 新条件 refId | +| `data` | string | 否 | 查询/表达式数据对象的新 JSON 数组 | +| `forDuration` | string | 否 | 触发前的等待时长 \(例如：5m, 1h\) | +| `noDataState` | string | 否 | 无数据返回时的状态 \(NoData, Alerting, OK\) | +| `execErrState` | string | 否 | 执行错误时的状态 \(Alerting, OK\) | +| `annotations` | string | 否 | 注释的 JSON 对象 | +| `labels` | string | 否 | 标签的 JSON 对象 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `uid` | string | 更新的警报规则的 UID | +| `title` | string | 警报规则标题 | +| `folderUID` | string | 父文件夹 UID | +| `ruleGroup` | string | 规则组名称 | + +### `grafana_delete_alert_rule` + +通过其 UID 删除警报规则 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `alertRuleUid` | string | 是 | 要删除的警报规则的 UID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `message` | string | 确认消息 | + +### `grafana_list_contact_points` + +列出所有警报通知联系点 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `contactPoints` | array | 联系点列表 | + +### `grafana_create_annotation` + +在仪表板上或作为全局注释创建注释 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `text` | string | 是 | 注释的文本内容 | +| `tags` | string | 否 | 以逗号分隔的标签列表 | +| `dashboardUid` | string | 否 | 要添加注释的仪表板 UID \(全局注释可选\) | +| `panelId` | number | 否 | 要添加注释的面板 ID | +| `time` | number | 否 | 起始时间（以 epoch 毫秒为单位，默认为当前时间） | +| `timeEnd` | number | 否 | 结束时间（以 epoch 毫秒为单位，用于范围注释） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | number | 创建的注释的 ID | +| `message` | string | 确认消息 | + +### `grafana_list_annotations` + +按时间范围、仪表板或标签查询注释 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| ---INLINE-CODE-PLACEHOLDER-42355e89d407292dbef683bcc5a4fc3e--- | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `from` | number | 否 | 起始时间（以 epoch 毫秒为单位） | +| `to` | number | 否 | 结束时间（以 epoch 毫秒为单位） | +| `dashboardUid` | string | 否 | 按仪表板 UID 过滤 | +| `panelId` | number | 否 | 按面板 ID 过滤 | +| `tags` | string | 否 | 按逗号分隔的标签列表过滤 | +| `type` | string | 否 | 按类型过滤 \(警报或注释\) | +| `limit` | number | 否 | 返回的最大注释数 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `annotations` | array | 注释列表 | + +### `grafana_update_annotation` + +更新现有注释 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `annotationId` | number | 是 | 要更新的注释 ID | +| `text` | string | 是 | 注释的新文本内容 | +| `tags` | string | 否 | 以逗号分隔的新标签列表 | +| `time` | number | 否 | 新的开始时间（以纪元毫秒为单位） | +| `timeEnd` | number | 否 | 新的结束时间（以纪元毫秒为单位） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | number | 更新后的注释 ID | +| `message` | string | 确认消息 | + +### `grafana_delete_annotation` + +通过 ID 删除注释 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `annotationId` | number | 是 | 要删除的注释 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `message` | string | 确认消息 | + +### `grafana_list_data_sources` + +列出 Grafana 中配置的所有数据源 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `dataSources` | array | 数据源列表 | + +### `grafana_get_data_source` + +通过其 ID 或 UID 获取数据源 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `dataSourceId` | string | 是 | 要检索的数据源的 ID 或 UID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | number | 数据源 ID | +| `uid` | string | 数据源 UID | +| `name` | string | 数据源名称 | +| `type` | string | 数据源类型 | +| `url` | string | 数据源连接 URL | +| `database` | string | 数据库名称 \(如果适用\) | +| `isDefault` | boolean | 是否为默认数据源 | +| `jsonData` | json | 其他数据源配置 | + +### `grafana_list_folders` + +列出 Grafana 中的所有文件夹 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `limit` | number | 否 | 要返回的最大文件夹数量 | +| `page` | number | 否 | 分页的页码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `folders` | array | 文件夹列表 | + +### `grafana_create_folder` + +在 Grafana 中创建一个新文件夹 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Grafana 服务账户令牌 | +| `baseUrl` | string | 是 | Grafana 实例 URL \(例如：https://your-grafana.com\) | +| `organizationId` | string | 否 | 多组织 Grafana 实例的组织 ID | +| `title` | string | 是 | 新文件夹的标题 | +| `uid` | string | 否 | 文件夹的可选 UID \(如果未提供，将自动生成\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | number | 创建的文件夹的数字 ID | +| `uid` | string | 创建的文件夹的 UID | +| `title` | string | 创建的文件夹的标题 | +| `url` | string | 文件夹的 URL 路径 | + +## 注意事项 + +- 类别：`tools` +- 类型：`grafana` diff --git a/apps/docs/content/docs/zh/tools/kalshi.mdx b/apps/docs/content/docs/zh/tools/kalshi.mdx new file mode 100644 index 000000000..60b934f9e --- /dev/null +++ b/apps/docs/content/docs/zh/tools/kalshi.mdx @@ -0,0 +1,295 @@ +--- +title: Kalshi +description: 访问 Kalshi 的预测市场数据 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Kalshi](https://kalshi.com) 是一个联邦监管的交易所，用户可以直接交易未来事件结果的预测市场。Kalshi 强大的 API 和 Sim 集成使代理和工作流能够以编程方式访问平台的各个方面，支持从研究和分析到自动化交易和监控的所有内容。 + +通过 Kalshi 在 Sim 中的集成，您可以： + +- **市场和事件数据：** 搜索、筛选并检索市场和事件的实时和历史数据；获取市场状态、系列、事件分组等的详细信息。 +- **账户和余额管理：** 访问账户余额、可用资金，并监控实时未平仓头寸。 +- **订单和交易管理：** 下新订单、取消现有订单、查看未完成订单、检索实时订单簿，并访问完整的交易历史。 +- **执行分析：** 获取最近的交易、历史成交和 K 线数据，用于回测或市场结构研究。 +- **监控：** 检查全交易所或系列级别的状态，接收有关市场变化或交易暂停的实时更新，并自动化响应。 +- **自动化准备：** 构建端到端的自动化代理和仪表板，消费、分析并交易基于真实世界事件概率的数据。 + +通过使用这些统一的工具和端点，您可以将 Kalshi 的预测市场、实时交易功能和深度事件数据无缝集成到您的 AI 驱动应用程序、仪表板和工作流中，从而实现与真实世界结果相关的复杂自动化决策。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Kalshi 预测市场集成到工作流中。可以获取市场、单个市场、事件、单个事件、余额、头寸、订单、订单簿、交易、K 线、成交、系列和交易所状态。 + +## 工具 + +### `kalshi_get_markets` + +从 Kalshi 检索预测市场列表，并可选择进行筛选 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `status` | string | 否 | 按状态筛选 \(未开放、开放、关闭、已结算\) | +| `seriesTicker` | string | 否 | 按系列代码筛选 | +| `eventTicker` | string | 否 | 按事件代码筛选 | +| `limit` | string | 否 | 结果数量 \(1-1000，默认值：100\) | +| `cursor` | string | 否 | 下一页的分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 市场数据和元数据 | + +### `kalshi_get_market` + +通过代码检索特定预测市场的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `ticker` | string | 是 | 市场代码 \(例如："KXBTC-24DEC31"\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 市场数据和元数据 | + +### `kalshi_get_events` + +从 Kalshi 检索事件列表，并可选择进行筛选 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `status` | string | 否 | 按状态筛选 \(开放、关闭、已结算\) | +| `seriesTicker` | string | 否 | 按系列代码筛选 | +| `withNestedMarkets` | string | 否 | 在响应中包含嵌套市场 \(true/false\) | +| `limit` | string | 否 | 结果数量 \(1-200，默认值：200\) | +| `cursor` | string | 否 | 下一页的分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 事件数据和元数据 | + +### `kalshi_get_event` + +通过代码检索特定事件的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `eventTicker` | string | 是 | 事件代码 | +| `withNestedMarkets` | string | 否 | 在响应中包含嵌套市场 \(true/false\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 事件数据和元数据 | + +### `kalshi_get_balance` + +从 Kalshi 检索您的账户余额和投资组合价值 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | 是 | 您的 Kalshi API 密钥 ID | +| `privateKey` | string | 是 | 您的 RSA 私钥 \(PEM 格式\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 余额数据和元数据 | + +### `kalshi_get_positions` + +从 Kalshi 检索您的未平仓头寸 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | 是 | 您的 Kalshi API 密钥 ID | +| `privateKey` | string | 是 | 您的 RSA 私钥 \(PEM 格式\) | +| `ticker` | string | 否 | 按市场代码筛选 | +| `eventTicker` | string | 否 | 按事件代码筛选 \(最多 10 个逗号分隔\) | +| `settlementStatus` | string | 否 | 按结算状态筛选 \(all, unsettled, settled\)。默认值：unsettled | +| `limit` | string | 否 | 结果数量 \(1-1000，默认值：100\) | +| `cursor` | string | 否 | 下一页的分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 位置数据和元数据 | + +### `kalshi_get_orders` + +通过可选过滤从 Kalshi 检索您的订单 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | 是 | 您的 Kalshi API 密钥 ID | +| `privateKey` | string | 是 | 您的 RSA 私钥 \(PEM 格式\) | +| `ticker` | string | 否 | 按市场代码过滤 | +| `eventTicker` | string | 否 | 按事件代码过滤 \(最多 10 个逗号分隔\) | +| `status` | string | 否 | 按状态过滤 \(resting, canceled, executed\) | +| `limit` | string | 否 | 结果数量 \(1-200，默认值：100\) | +| `cursor` | string | 否 | 下一页的分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 订单数据和元数据 | + +### `kalshi_get_orderbook` + +检索特定市场的订单簿（买入和卖出） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `ticker` | string | 是 | 市场代码 \(例如，KXBTC-24DEC31\) | +| `depth` | number | 否 | 每侧返回的价格级别数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 订单簿数据和元数据 | + +### `kalshi_get_trades` + +获取所有市场或特定市场的最近交易记录 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `ticker` | string | 否 | 按市场代码过滤 | +| `minTs` | number | 否 | 最小时间戳 \(Unix 毫秒\) | +| `maxTs` | number | 否 | 最大时间戳 \(Unix 毫秒\) | +| `limit` | string | 否 | 结果数量 \(1-1000，默认值：100\) | +| `cursor` | string | 否 | 下一页的分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 交易数据和元数据 | + +### `kalshi_get_candlesticks` + +获取特定市场的 OHLC 蜡烛图数据 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `seriesTicker` | string | 是 | 系列代码 | +| `ticker` | string | 是 | 市场代码 \(例如：KXBTC-24DEC31\) | +| `startTs` | number | 否 | 开始时间戳 \(Unix 毫秒\) | +| `endTs` | number | 否 | 结束时间戳 \(Unix 毫秒\) | +| `periodInterval` | number | 否 | 时间间隔：1 \(1分钟\)，60 \(1小时\)，或 1440 \(1天\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | K线数据和元数据 | + +### `kalshi_get_fills` + +检索您的投资组合 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `keyId` | string | 是 | 您的 Kalshi API 密钥 ID | +| `privateKey` | string | 是 | 您的 RSA 私钥（PEM 格式）| +| `ticker` | string | 否 | 按市场代码筛选 | +| `orderId` | string | 否 | 按订单 ID 筛选 | +| `minTs` | number | 否 | 最小时间戳（Unix 毫秒）| +| `maxTs` | number | 否 | 最大时间戳（Unix 毫秒）| +| `limit` | string | 否 | 结果数量（1-1000，默认值：100）| +| `cursor` | string | 否 | 下一页的分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 成交数据和元数据 | + +### `kalshi_get_series_by_ticker` + +通过代码检索特定市场系列的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `seriesTicker` | string | 是 | 系列代码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 系列数据和元数据 | + +### `kalshi_get_exchange_status` + +检索 Kalshi 交易所的当前状态（交易和交易活动） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 交易所状态数据和元数据 | + +## 注意 + +- 类别: `tools` +- 类型: `kalshi` diff --git a/apps/docs/content/docs/zh/tools/polymarket.mdx b/apps/docs/content/docs/zh/tools/polymarket.mdx new file mode 100644 index 000000000..4dd9ac0bb --- /dev/null +++ b/apps/docs/content/docs/zh/tools/polymarket.mdx @@ -0,0 +1,352 @@ +--- +title: Polymarket +description: 访问 Polymarket 的预测市场数据 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Polymarket](https://polymarket.com) 是一个去中心化的预测市场平台，用户可以利用区块链技术交易未来事件的结果。Polymarket 提供了一个全面的 API，使开发者和代理能够访问实时市场数据、事件列表、价格信息和订单簿统计数据，以支持数据驱动的工作流和 AI 自动化。 + +通过 Polymarket 的 API 和 Sim 集成，您可以让代理以编程方式检索预测市场信息，探索开放市场及相关事件，分析历史价格数据，并访问订单簿和市场中点。这为研究、自动化分析以及开发能够根据市场价格得出的实时事件概率做出反应的智能代理创造了新的可能性。 + +Polymarket 集成的主要功能包括： + +- **市场列表与筛选：** 列出所有当前或历史预测市场，可按标签筛选、排序并分页查看结果。 +- **市场详情：** 通过市场 ID 或 slug 检索单个市场的详细信息，包括其结果和状态。 +- **事件列表：** 访问 Polymarket 事件列表及详细事件信息。 +- **订单簿与价格数据：** 分析订单簿，获取最新市场价格，查看中点，或获取任何市场的历史价格信息。 +- **自动化准备：** 构建能够以编程方式对市场动态、赔率变化或特定事件结果做出反应的代理或工具。 + +通过使用这些文档化的 API 端点，您可以将 Polymarket 丰富的链上预测市场数据无缝集成到您自己的 AI 工作流、仪表盘、研究工具和交易自动化中。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Polymarket 预测市场集成到工作流程中。可以获取市场、单个市场、事件、单个事件、标签、系列、订单簿、价格、中点、价格历史、最后交易价格、价差、最小变动单位、持仓、交易以及搜索功能。 + +## 工具 + +### `polymarket_get_markets` + +从 Polymarket 检索预测市场列表，并可选择进行筛选 + +#### 输入 + +| 参数 | 类型 | 是否必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `closed` | 字符串 | 否 | 按关闭状态筛选 \(true/false\)。使用 false 仅显示活跃市场。 | +| `order` | 字符串 | 否 | 排序字段 \(例如，id、volume、liquidity\) | +| `ascending` | 字符串 | 否 | 排序方向 \(true 表示升序，false 表示降序\) | +| `tagId` | 字符串 | 否 | 按标签 ID 筛选 | +| `limit` | 字符串 | 否 | 每页结果数量 \(建议：25-50\) | +| `offset` | 字符串 | 否 | 分页偏移量 \(跳过此数量的结果\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | 布尔值 | 操作成功状态 | +| `output` | 对象 | 市场数据和元数据 | + +### `polymarket_get_market` + +通过 ID 或 slug 检索特定预测市场的详细信息 + +#### 输入 + +| 参数 | 类型 | 是否必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `marketId` | 字符串 | 否 | 市场 ID。如果未提供 slug，则必需。 | +| `slug` | 字符串 | 否 | 市场 slug \(例如，"will-trump-win"\)。如果未提供 marketId，则必需。 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 市场数据和元数据 | + +### `polymarket_get_events` + +从 Polymarket 检索事件列表，可选过滤 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `closed` | string | 否 | 按关闭状态过滤 \(true/false\)。使用 false 仅显示活跃事件。 | +| `order` | string | 否 | 排序字段 \(例如，id, volume\) | +| `ascending` | string | 否 | 排序方向 \(true 为升序，false 为降序\) | +| `tagId` | string | 否 | 按标签 ID 过滤 | +| `limit` | string | 否 | 每页结果数量 \(推荐：25-50\) | +| `offset` | string | 否 | 分页偏移量 \(跳过此数量的结果\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 事件数据和元数据 | + +### `polymarket_get_event` + +通过 ID 或 slug 检索特定事件的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `eventId` | string | 否 | 事件 ID。如果未提供 slug，则必需。 | +| `slug` | string | 否 | 事件 slug \(例如，"2024-presidential-election"\)。如果未提供 eventId，则必需。 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 事件数据和元数据 | + +### `polymarket_get_tags` + +从 Polymarket 获取用于筛选市场的可用标签 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `limit` | string | 否 | 每页结果数量 \(推荐：25-50\) | +| `offset` | string | 否 | 分页偏移量 \(跳过此数量的结果\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 标签数据和元数据 | + +### `polymarket_search` + +在 Polymarket 上搜索市场、事件和个人资料 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `query` | string | 是 | 搜索查询词 | +| `limit` | string | 否 | 每页结果数量 \(推荐：25-50\) | +| `offset` | string | 否 | 分页偏移量 \(跳过此数量的结果\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 搜索结果和元数据 | + +### `polymarket_get_series` + +从 Polymarket 获取系列（相关市场组） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `limit` | string | 否 | 每页结果数量 \(推荐：25-50\) | +| `offset` | string | 否 | 分页偏移量 \(跳过此数量的结果\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 系列数据和元数据 | + +### `polymarket_get_series_by_id` + +通过 ID 从 Polymarket 检索特定系列（相关市场组） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `seriesId` | string | 是 | 系列 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 系列数据和元数据 | + +### `polymarket_get_orderbook` + +检索特定代币的订单簿摘要 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 订单簿数据和元数据 | + +### `polymarket_get_price` + +检索特定代币和方向的市场价格 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) | +| `side` | string | 是 | 订单方向：买或卖 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 价格数据和元数据 | + +### `polymarket_get_midpoint` + +检索特定代币的中间价 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 中间价格数据和元数据 | + +### `polymarket_get_price_history` + +检索特定市场代币的历史价格数据 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) | +| `interval` | string | 否 | 截止到当前时间的持续时间 \(1m, 1h, 6h, 1d, 1w, max\)。与 startTs/endTs 互斥。 | +| `fidelity` | number | 否 | 数据分辨率（以分钟为单位）\(例如，60 表示每小时\) | +| `startTs` | number | 否 | 开始时间戳 \(Unix 秒 UTC\) | +| `endTs` | number | 否 | 结束时间戳 \(Unix 秒 UTC\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 价格历史数据和元数据 | + +### `polymarket_get_last_trade_price` + +检索特定代币的最新交易价格 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 最新交易价格和元数据 | + +### `polymarket_get_spread` + +检索特定代币的买卖价差 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 价差数据和元数据 | + +### `polymarket_get_tick_size` + +检索特定代币的最小跳动单位 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 跳动单位和元数据 | + +### `polymarket_get_positions` + +从 Polymarket 检索用户持仓 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `user` | string | 是 | 用户钱包地址 | +| `market` | string | 否 | 可选的市场 ID，用于筛选持仓 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 持仓数据和元数据 | + +### `polymarket_get_trades` + +从 Polymarket 获取交易历史 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `user` | string | 否 | 用户钱包地址，用于筛选交易 | +| `market` | string | 否 | 市场 ID，用于筛选交易 | +| `limit` | string | 否 | 每页结果数量（推荐：25-50） | +| `offset` | string | 否 | 分页偏移量（跳过此数量的结果） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 交易数据和元数据 | + +## 注意事项 + +- 类别: `tools` +- 类型: `polymarket` diff --git a/apps/docs/content/docs/zh/tools/pylon.mdx b/apps/docs/content/docs/zh/tools/pylon.mdx index c3a287ce7..d39431c3b 100644 --- a/apps/docs/content/docs/zh/tools/pylon.mdx +++ b/apps/docs/content/docs/zh/tools/pylon.mdx @@ -84,8 +84,15 @@ Pylon 的端点提供了对客户问题和关系全生命周期管理的精细 | `apiToken` | string | 是 | Pylon API 令牌 | | `title` | string | 是 | 问题标题 | | `bodyHtml` | string | 是 | HTML 格式的问题正文 | -| `accountId` | string | 否 | 要与问题关联的账户 ID | -| `assigneeId` | string | 否 | 要分配问题的用户 ID | +| `accountId` | string | 否 | 与问题关联的账户 ID | +| `assigneeId` | string | 否 | 分配问题的用户 ID | +| `teamId` | string | 否 | 分配问题的团队 ID | +| `requesterId` | string | 否 | 请求者用户 ID（请求者邮箱的替代选项） | +| `requesterEmail` | string | 否 | 请求者邮箱地址（请求者 ID 的替代选项） | +| `priority` | string | 否 | 问题优先级 | +| `tags` | string | 否 | 逗号分隔的标签 ID | +| `customFields` | string | 否 | 作为 JSON 对象的自定义字段 | +| `attachmentUrls` | string | 否 | 逗号分隔的附件 URL | #### 输出 @@ -127,6 +134,9 @@ Pylon 的端点提供了对客户问题和关系全生命周期管理的精细 | `teamId` | string | 否 | 分配问题的团队 ID | | `tags` | string | 否 | 逗号分隔的标签 ID | | `customFields` | string | 否 | 作为 JSON 对象的自定义字段 | +| `customerPortalVisible` | boolean | 否 | 问题是否在客户门户中可见 | +| `requesterId` | string | 否 | 请求者用户 ID | +| `accountId` | string | 否 | 与问题关联的账户 ID | #### 输出 diff --git a/apps/docs/content/docs/zh/tools/shopify.mdx b/apps/docs/content/docs/zh/tools/shopify.mdx new file mode 100644 index 000000000..0a5cbdaf1 --- /dev/null +++ b/apps/docs/content/docs/zh/tools/shopify.mdx @@ -0,0 +1,444 @@ +--- +title: Shopify +description: 在您的 Shopify 商店中管理产品、订单、客户和库存 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Shopify](https://www.shopify.com/) 是一个领先的电子商务平台，旨在帮助商家构建、运营和发展他们的在线商店。Shopify 让您可以轻松管理商店的各个方面，从产品和库存到订单和客户。 + +在 Sim 中使用 Shopify，您的代理可以： + +- **创建和管理产品**：添加新产品、更新产品详情以及从商店中移除产品。 +- **列出和检索订单**：获取客户订单信息，包括筛选和订单管理。 +- **管理客户**：访问和更新客户详情，或将新客户添加到您的商店。 +- **调整库存水平**：以编程方式更改产品库存水平，确保库存准确无误。 + +使用 Sim 的 Shopify 集成，直接从您的自动化流程中自动化常见的商店管理工作流，例如同步库存、履行订单或管理商品列表。通过简单的编程工具，赋能您的代理访问、更新和组织所有商店数据。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Shopify 集成到您的工作流程中。管理产品、订单、客户和库存。创建、读取、更新和删除产品。列出和管理订单。处理客户数据并调整库存水平。 + +## 工具 + +### `shopify_create_product` + +在您的 Shopify 商店中创建一个新产品 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `title` | string | 是 | 产品标题 | +| `descriptionHtml` | string | 否 | 产品描述 \(HTML\) | +| `vendor` | string | 否 | 产品供应商/品牌 | +| `productType` | string | 否 | 产品类型/类别 | +| `tags` | array | 否 | 产品标签 | +| `status` | string | 否 | 产品状态 \(ACTIVE, DRAFT, ARCHIVED\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `product` | object | 创建的产品 | + +### `shopify_get_product` + +通过 ID 从您的 Shopify 商店获取单个产品 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `productId` | string | 是 | 产品 ID \(gid://shopify/Product/123456789\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `product` | object | 产品详情 | + +### `shopify_list_products` + +从您的 Shopify 商店列出产品并可选进行筛选 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `first` | number | 否 | 返回的产品数量 \(默认：50，最大：250\) | +| `query` | string | 否 | 用于筛选产品的搜索查询 \(例如："title:shirt" 或 "vendor:Nike" 或 "status:active"\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `products` | array | 产品列表 | +| `pageInfo` | object | 分页信息 | + +### `shopify_update_product` + +更新您 Shopify 商店中的现有产品 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `productId` | string | 是 | 要更新的产品 ID \(gid://shopify/Product/123456789\) | +| `title` | string | 否 | 新的产品标题 | +| `descriptionHtml` | string | 否 | 新的产品描述 \(HTML\) | +| `vendor` | string | 否 | 新的产品供应商/品牌 | +| `productType` | string | 否 | 新的产品类型/类别 | +| `tags` | array | 否 | 新的产品标签 | +| `status` | string | 否 | 新的产品状态 \(ACTIVE, DRAFT, ARCHIVED\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `product` | object | 更新后的产品 | + +### `shopify_delete_product` + +从您的 Shopify 商店中删除产品 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `productId` | string | 是 | 要删除的产品 ID \(gid://shopify/Product/123456789\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `deletedId` | string | 已删除产品的 ID | + +### `shopify_get_order` + +通过 ID 从您的 Shopify 商店获取单个订单 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `orderId` | string | 是 | 订单 ID \(gid://shopify/Order/123456789\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `order` | object | 订单详情 | + +### `shopify_list_orders` + +从您的 Shopify 商店列出订单并可选择过滤 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `first` | number | 否 | 要返回的订单数量 \(默认值：50，最大值：250\) | +| `status` | string | 否 | 按订单状态过滤 \(open, closed, cancelled, any\) | +| `query` | string | 否 | 用于过滤订单的搜索查询 \(例如："financial_status:paid" 或 "fulfillment_status:unfulfilled" 或 "email:customer@example.com"\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `orders` | array | 订单列表 | +| `pageInfo` | object | 分页信息 | + +### `shopify_update_order` + +更新 Shopify 商店中的现有订单（备注、标签、电子邮件） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `orderId` | string | 是 | 要更新的订单 ID \(gid://shopify/Order/123456789\) | +| `note` | string | 否 | 新的订单备注 | +| `tags` | array | 否 | 新的订单标签 | +| `email` | string | 否 | 订单的新客户电子邮件 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `order` | object | 更新后的订单 | + +### `shopify_cancel_order` + +取消 Shopify 商店中的订单 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `orderId` | string | 是 | 要取消的订单 ID \(gid://shopify/Order/123456789\) | +| `reason` | string | 是 | 取消原因 \(CUSTOMER, DECLINED, FRAUD, INVENTORY, STAFF, OTHER\) | +| `notifyCustomer` | boolean | 否 | 是否通知客户取消订单 | +| `refund` | boolean | 否 | 是否退款 | +| `restock` | boolean | 否 | 是否补充库存 | +| `staffNote` | string | 否 | 关于取消的员工备注 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `order` | object | 取消结果 | + +### `shopify_create_customer` + +在您的 Shopify 商店中创建一个新客户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `email` | string | 否 | 客户电子邮件地址 | +| `firstName` | string | 否 | 客户名字 | +| `lastName` | string | 否 | 客户姓氏 | +| `phone` | string | 否 | 客户电话号码 | +| `note` | string | 否 | 关于客户的备注 | +| `tags` | array | 否 | 客户标签 | +| `addresses` | array | 否 | 客户地址 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `customer` | object | 创建的客户 | + +### `shopify_get_customer` + +通过 ID 从您的 Shopify 商店获取单个客户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `customerId` | string | 是 | 客户 ID \(gid://shopify/Customer/123456789\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `customer` | object | 客户详情 | + +### `shopify_list_customers` + +列出 Shopify 商店中的客户，并支持可选筛选 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `first` | number | 否 | 要返回的客户数量 \(默认：50，最大：250\) | +| `query` | string | 否 | 用于筛选客户的搜索查询 \(例如："first_name:John" 或 "last_name:Smith" 或 "email:*@gmail.com" 或 "tag:vip"\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `customers` | array | 客户列表 | +| `pageInfo` | object | 分页信息 | + +### `shopify_update_customer` + +更新 Shopify 商店中的现有客户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `customerId` | string | 是 | 要更新的客户 ID \(gid://shopify/Customer/123456789\) | +| `email` | string | 否 | 新的客户电子邮件地址 | +| `firstName` | string | 否 | 新的客户名字 | +| `lastName` | string | 否 | 新的客户姓氏 | +| `phone` | string | 否 | 新的客户电话号码 | +| `note` | string | 否 | 关于客户的新备注 | +| `tags` | array | 否 | 新的客户标签 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `customer` | object | 更新后的客户 | + +### `shopify_delete_customer` + +从您的 Shopify 商店中删除客户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `customerId` | string | 是 | 要删除的客户 ID \(gid://shopify/Customer/123456789\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `deletedId` | string | 已删除客户的 ID | + +### `shopify_list_inventory_items` + +列出您的 Shopify 商店中的库存商品。使用此功能通过 SKU 查找库存商品 ID。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `first` | number | 否 | 要返回的库存商品数量 \(默认值：50，最大值：250\) | +| `query` | string | 否 | 用于筛选库存商品的搜索查询 \(例如："sku:ABC123"\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `inventoryItems` | array | 包含其 ID、SKU 和库存水平的库存商品列表 | +| `pageInfo` | object | 分页信息 | + +### `shopify_get_inventory_level` + +获取特定位置的产品变体的库存水平 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `inventoryItemId` | string | 是 | 库存商品 ID \(gid://shopify/InventoryItem/123456789\) | +| `locationId` | string | 否 | 用于筛选的地点 ID \(可选\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `inventoryLevel` | object | 库存级别详情 | + +### `shopify_adjust_inventory` + +调整特定位置的产品变体库存数量 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `inventoryItemId` | string | 是 | 库存项 ID \(gid://shopify/InventoryItem/123456789\) | +| `locationId` | string | 是 | 位置 ID \(gid://shopify/Location/123456789\) | +| `delta` | number | 是 | 调整数量 \(正数表示增加，负数表示减少\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `inventoryLevel` | object | 库存调整结果 | + +### `shopify_list_locations` + +列出您的 Shopify 商店中的库存位置。使用此功能查找库存操作所需的位置 ID。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `first` | number | 否 | 返回的位置数量 \(默认值：50，最大值：250\) | +| `includeInactive` | boolean | 否 | 是否包含已停用的位置 \(默认值：false\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `locations` | array | 包含位置 ID、名称和地址的位置列表 | +| `pageInfo` | object | 分页信息 | + +### `shopify_create_fulfillment` + +创建一个履行记录以将订单商品标记为已发货。需要一个履行订单 ID（可从订单详情中获取）。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名（例如：mystore.myshopify.com） | +| `fulfillmentOrderId` | string | 是 | 履行订单 ID（例如：gid://shopify/FulfillmentOrder/123456789） | +| `trackingNumber` | string | 否 | 发货的追踪号码 | +| `trackingCompany` | string | 否 | 运输承运商名称（例如：UPS、FedEx、USPS、DHL） | +| `trackingUrl` | string | 否 | 用于追踪发货的 URL | +| `notifyCustomer` | boolean | 否 | 是否向客户发送发货确认邮件（默认值：true） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `fulfillment` | object | 包含追踪信息和已履行商品的创建履行记录 | + +### `shopify_list_collections` + +列出 Shopify 商店中的商品集合。可按标题、类型（自定义/智能）或句柄进行筛选。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名（例如：mystore.myshopify.com） | +| `first` | number | 否 | 要返回的集合数量（默认值：50，最大值：250） | +| `query` | string | 否 | 用于筛选集合的搜索查询（例如：“title:Summer” 或 “collection_type:smart”） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `collections` | array | 包含集合的 ID、标题和商品数量的列表 | +| `pageInfo` | object | 分页信息 | + +### `shopify_get_collection` + +通过 ID 获取特定集合，包括其产品。使用此功能可以检索集合中的产品。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `shopDomain` | string | 是 | 您的 Shopify 商店域名 \(例如：mystore.myshopify.com\) | +| `collectionId` | string | 是 | 集合 ID \(例如：gid://shopify/Collection/123456789\) | +| `productsFirst` | number | 否 | 要从此集合返回的产品数量 \(默认：50，最大：250\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `collection` | object | 包括其产品的集合详情 | + +## 注意 + +- 类别：`tools` +- 类型：`shopify` diff --git a/apps/docs/content/docs/zh/tools/ssh.mdx b/apps/docs/content/docs/zh/tools/ssh.mdx new file mode 100644 index 000000000..3c91fb35c --- /dev/null +++ b/apps/docs/content/docs/zh/tools/ssh.mdx @@ -0,0 +1,394 @@ +--- +title: SSH +description: 通过 SSH 连接到远程服务器 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[SSH（安全外壳协议）](https://en.wikipedia.org/wiki/Secure_Shell) 是一种广泛使用的协议，用于安全地连接到远程服务器，允许您通过加密通道执行命令、传输文件和管理系统。 + +在 Sim 中支持 SSH 后，您的代理可以： + +- **执行远程命令**：在任何可通过 SSH 访问的服务器上运行 shell 命令 +- **上传并运行脚本**：轻松传输和执行多行脚本以实现高级自动化 +- **安全传输文件**：作为工作流的一部分上传和下载文件（即将推出或通过命令实现） +- **自动化服务器管理**：以编程方式执行更新、维护、监控、部署和配置任务 +- **使用灵活的身份验证**：通过密码或私钥身份验证连接，包括对加密密钥的支持 + +以下 Sim SSH 工具使您的代理能够作为更大自动化的一部分与服务器交互： + +- `ssh_execute_command`：远程运行任何单个 shell 命令并捕获输出、状态和错误。 +- `ssh_execute_script`：在远程系统上上传并执行完整的多行脚本。 +- （即将推出其他工具，例如文件传输。） + +通过将 SSH 集成到您的代理工作流中，您可以自动化安全访问、远程操作和服务器编排——简化 DevOps、IT 自动化和自定义远程管理，所有操作均可在 Sim 中完成。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +通过 SSH 执行命令、传输文件和管理远程服务器。支持密码和私钥身份验证以实现安全的服务器访问。 + +## 工具 + +### `ssh_execute_command` + +在远程 SSH 服务器上执行 shell 命令 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `host` | string | 是 | SSH 服务器主机名或 IP 地址 | +| `port` | number | 是 | SSH 服务器端口 \(默认：22\) | +| `username` | string | 是 | SSH 用户名 | +| `password` | string | 否 | 用于身份验证的密码 \(如果未使用私钥\) | +| `privateKey` | string | 否 | 用于身份验证的私钥 \(OpenSSH 格式\) | +| `passphrase` | string | 否 | 加密私钥的密码短语 | +| `command` | string | 是 | 要在远程服务器上执行的 shell 命令 | +| `workingDirectory` | string | 否 | 命令执行的工作目录 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `stdout` | string | 命令的标准输出 | +| `stderr` | string | 标准错误输出 | +| `exitCode` | number | 命令退出代码 | +| `success` | boolean | 命令是否成功 \(退出代码为 0\) | +| `message` | string | 操作状态消息 | + +### `ssh_execute_script` + +在远程 SSH 服务器上上传并执行多行脚本 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `host` | string | 是 | SSH 服务器主机名或 IP 地址 | +| `port` | number | 是 | SSH 服务器端口 \(默认值: 22\) | +| `username` | string | 是 | SSH 用户名 | +| `password` | string | 否 | 用于身份验证的密码 \(如果未使用私钥\) | +| `privateKey` | string | 否 | 用于身份验证的私钥 \(OpenSSH 格式\) | +| `passphrase` | string | 否 | 加密私钥的密码短语 | +| `script` | string | 是 | 要执行的脚本内容 \(bash、python 等\) | +| `interpreter` | string | 否 | 脚本解释器 \(默认值: /bin/bash\) | +| `workingDirectory` | string | 否 | 脚本执行的工作目录 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `stdout` | string | 脚本的标准输出 | +| `stderr` | string | 标准错误输出 | +| `exitCode` | number | 脚本退出代码 | +| `success` | boolean | 脚本是否成功 \(退出代码为 0\) | +| `scriptPath` | string | 脚本上传的临时路径 | +| `message` | string | 操作状态消息 | + +### `ssh_check_command_exists` + +检查远程 SSH 服务器上是否存在命令/程序 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `host` | string | 是 | SSH 服务器主机名或 IP 地址 | +| `port` | number | 是 | SSH 服务器端口 \(默认值: 22\) | +| `username` | string | 是 | SSH 用户名 | +| `password` | string | 否 | 用于身份验证的密码 \(如果未使用私钥\) | +| `privateKey` | string | 否 | 用于身份验证的私钥 \(OpenSSH 格式\) | +| `passphrase` | string | 否 | 加密私钥的密码短语 | +| `commandName` | string | 是 | 要检查的命令名称 \(例如：docker, git, python3\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `commandExists` | boolean | 命令是否存在 | +| `commandPath` | string | 命令的完整路径 \(如果找到\) | +| `version` | string | 命令版本输出 \(如果适用\) | +| `message` | string | 操作状态消息 | + +### `ssh_upload_file` + +上传文件到远程 SSH 服务器 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `host` | string | 是 | SSH 服务器主机名或 IP 地址 | +| `port` | number | 是 | SSH 服务器端口 \(默认值: 22\) | +| `username` | string | 是 | SSH 用户名 | +| `password` | string | 否 | 用于身份验证的密码 \(如果未使用私钥\) | +| `privateKey` | string | 否 | 用于身份验证的私钥 \(OpenSSH 格式\) | +| `passphrase` | string | 否 | 加密私钥的密码短语 | +| `fileContent` | string | 是 | 要上传的文件内容 \(二进制文件需进行 base64 编码\) | +| `fileName` | string | 是 | 上传文件的名称 | +| `remotePath` | string | 是 | 远程服务器上的目标路径 | +| `permissions` | string | 否 | 文件权限 \(例如：0644\) | +| `overwrite` | boolean | 否 | 是否覆盖现有文件 \(默认值: true\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `uploaded` | boolean | 文件是否成功上传 | +| `remotePath` | string | 远程服务器上的最终路径 | +| `size` | number | 文件大小（以字节为单位） | +| `message` | string | 操作状态消息 | + +### `ssh_download_file` + +从远程 SSH 服务器下载文件 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `host` | string | 是 | SSH 服务器主机名或 IP 地址 | +| `port` | number | 是 | SSH 服务器端口 \(默认值: 22\) | +| `username` | string | 是 | SSH 用户名 | +| `password` | string | 否 | 用于身份验证的密码 \(如果未使用私钥\) | +| `privateKey` | string | 否 | 用于身份验证的私钥 \(OpenSSH 格式\) | +| `passphrase` | string | 否 | 加密私钥的密码短语 | +| `remotePath` | string | 是 | 远程服务器上文件的路径 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `downloaded` | boolean | 文件是否成功下载 | +| `fileContent` | string | 文件内容 \(二进制文件为 base64 编码\) | +| `fileName` | string | 下载的文件名 | +| `remotePath` | string | 远程服务器上的源路径 | +| `size` | number | 文件大小（以字节为单位） | +| `message` | string | 操作状态消息 | + +### `ssh_list_directory` + +列出远程目录中的文件和目录 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `host` | string | 是 | SSH 服务器主机名或 IP 地址 | +| `port` | number | 是 | SSH 服务器端口（默认值：22） | +| `username` | string | 是 | SSH 用户名 | +| `password` | string | 否 | 用于身份验证的密码（如果未使用私钥） | +| `privateKey` | string | 否 | 用于身份验证的私钥（OpenSSH 格式） | +| `passphrase` | string | 否 | 加密私钥的密码短语 | +| `path` | string | 是 | 要列出的远程目录路径 | +| `detailed` | boolean | 否 | 包括文件详细信息（大小、权限、修改日期） | +| `recursive` | boolean | 否 | 递归列出子目录（默认值：false） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `entries` | array | 文件和目录条目的数组 | + +### `ssh_check_file_exists` + +检查远程 SSH 服务器上的文件或目录是否存在 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `host` | string | 是 | SSH 服务器主机名或 IP 地址 | +| `port` | number | 是 | SSH 服务器端口（默认值：22） | +| `username` | string | 是 | SSH 用户名 | +| `password` | string | 否 | 用于身份验证的密码（如果未使用私钥） | +| `privateKey` | string | 否 | 用于身份验证的私钥（OpenSSH 格式） | +| `passphrase` | string | 否 | 加密私钥的密码短语 | +| `path` | string | 是 | 要检查的远程文件或目录路径 | +| `type` | string | 否 | 预期类型：文件、目录或任意（默认值：任意） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `exists` | boolean | 路径是否存在 | +| `type` | string | 路径类型 \(文件、目录、符号链接、未找到\) | +| `size` | number | 如果是文件，则为文件大小 | +| `permissions` | string | 文件权限 \(例如：0755\) | +| `modified` | string | 最后修改的时间戳 | +| `message` | string | 操作状态消息 | + +### `ssh_create_directory` + +在远程 SSH 服务器上创建一个目录 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `host` | string | 是 | SSH 服务器主机名或 IP 地址 | +| `port` | number | 是 | SSH 服务器端口 \(默认：22\) | +| `username` | string | 是 | SSH 用户名 | +| `password` | string | 否 | 用于身份验证的密码 \(如果未使用私钥\) | +| `privateKey` | string | 否 | 用于身份验证的私钥 \(OpenSSH 格式\) | +| `passphrase` | string | 否 | 加密私钥的密码短语 | +| `path` | string | 是 | 要创建的目录路径 | +| `recursive` | boolean | 否 | 如果父目录不存在，则创建父目录 \(默认：true\) | +| `permissions` | string | 否 | 目录权限 \(默认：0755\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `created` | boolean | 目录是否成功创建 | +| `remotePath` | string | 创建的目录路径 | +| `alreadyExists` | boolean | 目录是否已存在 | +| `message` | string | 操作状态消息 | + +### `ssh_delete_file` + +从远程 SSH 服务器删除文件或目录 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `host` | string | 是 | SSH 服务器主机名或 IP 地址 | +| `port` | number | 是 | SSH 服务器端口 \(默认: 22\) | +| `username` | string | 是 | SSH 用户名 | +| `password` | string | 否 | 用于身份验证的密码 \(如果未使用私钥\) | +| `privateKey` | string | 否 | 用于身份验证的私钥 \(OpenSSH 格式\) | +| `passphrase` | string | 否 | 加密私钥的密码短语 | +| `path` | string | 是 | 要删除的路径 | +| `recursive` | boolean | 否 | 递归删除目录 \(默认: false\) | +| `force` | boolean | 否 | 强制删除而无需确认 \(默认: false\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `deleted` | boolean | 路径是否成功删除 | +| `remotePath` | string | 已删除的路径 | +| `message` | string | 操作状态消息 | + +### `ssh_move_rename` + +在远程 SSH 服务器上移动或重命名文件或目录 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `host` | string | 是 | SSH 服务器主机名或 IP 地址 | +| `port` | number | 是 | SSH 服务器端口 \(默认: 22\) | +| `username` | string | 是 | SSH 用户名 | +| `password` | string | 否 | 用于身份验证的密码 \(如果未使用私钥\) | +| `privateKey` | string | 否 | 用于身份验证的私钥 \(OpenSSH 格式\) | +| `passphrase` | string | 否 | 加密私钥的密码短语 | +| `sourcePath` | string | 是 | 文件或目录的当前路径 | +| `destinationPath` | string | 是 | 文件或目录的新路径 | +| `overwrite` | boolean | 否 | 如果目标存在则覆盖 \(默认: false\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `moved` | 布尔值 | 操作是否成功 | +| `sourcePath` | 字符串 | 原始路径 | +| `destinationPath` | 字符串 | 新路径 | +| `message` | 字符串 | 操作状态消息 | + +### `ssh_get_system_info` + +从远程 SSH 服务器检索系统信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `host` | 字符串 | 是 | SSH 服务器主机名或 IP 地址 | +| `port` | 数字 | 是 | SSH 服务器端口 \(默认值: 22\) | +| `username` | 字符串 | 是 | SSH 用户名 | +| `password` | 字符串 | 否 | 用于身份验证的密码 \(如果未使用私钥\) | +| `privateKey` | 字符串 | 否 | 用于身份验证的私钥 \(OpenSSH 格式\) | +| `passphrase` | 字符串 | 否 | 加密私钥的密码短语 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `hostname` | 字符串 | 服务器主机名 | +| `os` | 字符串 | 操作系统 \(例如: Linux, Darwin\) | +| `architecture` | 字符串 | CPU 架构 \(例如: x64, arm64\) | +| `uptime` | 数字 | 系统运行时间（以秒为单位） | +| `memory` | JSON | 内存信息 \(总量, 空闲, 已用\) | +| `diskSpace` | JSON | 磁盘空间信息 \(总量, 空闲, 已用\) | +| `message` | 字符串 | 操作状态消息 | + +### `ssh_read_file_content` + +读取远程文件的内容 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `host` | string | 是 | SSH 服务器主机名或 IP 地址 | +| `port` | number | 是 | SSH 服务器端口 \(默认值: 22\) | +| `username` | string | 是 | SSH 用户名 | +| `password` | string | 否 | 用于身份验证的密码 \(如果未使用私钥\) | +| `privateKey` | string | 否 | 用于身份验证的私钥 \(OpenSSH 格式\) | +| `passphrase` | string | 否 | 加密私钥的密码短语 | +| `path` | string | 是 | 要读取的远程文件路径 | +| `encoding` | string | 否 | 文件编码 \(默认值: utf-8\) | +| `maxSize` | number | 否 | 要读取的最大文件大小（以 MB 为单位）\(默认值: 10\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `content` | string | 文件内容（字符串形式） | +| `size` | number | 文件大小（以字节为单位） | +| `lines` | number | 文件中的行数 | +| `remotePath` | string | 远程文件路径 | +| `message` | string | 操作状态消息 | + +### `ssh_write_file_content` + +写入或追加内容到远程文件 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `host` | string | 是 | SSH 服务器主机名或 IP 地址 | +| `port` | number | 是 | SSH 服务器端口 \(默认值: 22\) | +| `username` | string | 是 | SSH 用户名 | +| `password` | string | 否 | 用于身份验证的密码 \(如果未使用私钥\) | +| `privateKey` | string | 否 | 用于身份验证的私钥 \(OpenSSH 格式\) | +| `passphrase` | string | 否 | 加密私钥的密码短语 | +| `path` | string | 是 | 要写入的远程文件路径 | +| `content` | string | 是 | 要写入文件的内容 | +| `mode` | string | 否 | 写入模式：覆盖、追加或创建 \(默认值: 覆盖\) | +| `permissions` | string | 否 | 文件权限 \(例如: 0644\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `written` | boolean | 文件是否成功写入 | +| `remotePath` | string | 文件路径 | +| `size` | number | 最终文件大小（以字节为单位） | +| `message` | string | 操作状态消息 | + +## 注意 + +- 类别: `tools` +- 类型: `ssh` diff --git a/apps/docs/content/docs/zh/tools/wordpress.mdx b/apps/docs/content/docs/zh/tools/wordpress.mdx new file mode 100644 index 000000000..2555cf69f --- /dev/null +++ b/apps/docs/content/docs/zh/tools/wordpress.mdx @@ -0,0 +1,566 @@ +--- +title: WordPress +description: 管理 WordPress 内容 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[WordPress](https://wordpress.org/) 是全球领先的开源内容管理系统，使发布和管理网站、博客以及各种在线内容变得简单。通过 WordPress，您可以创建和更新文章或页面，使用分类和标签组织内容，管理媒体文件，审核评论，以及处理用户账户——从个人博客到复杂的企业网站都可以轻松运行。 + +Sim 与 WordPress 的集成让您的代理可以自动化处理重要的网站任务。您可以通过编程方式创建具有特定标题、内容、分类、标签和特色图片的新博客文章。更新现有文章（例如更改其内容、标题或发布状态）也非常简单。您还可以发布或保存内容为草稿，管理静态页面，处理媒体上传，监督评论，并将内容分配到相关的组织分类中。 + +通过将 WordPress 连接到您的自动化流程，Sim 使您的代理能够简化内容发布、编辑工作流程和日常网站管理——帮助您无需手动操作即可保持网站的新鲜、有序和安全。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +集成 WordPress 以创建、更新和管理文章、页面、媒体、评论、分类、标签和用户。支持通过 OAuth 认证的 WordPress.com 网站以及使用应用密码认证的自托管 WordPress 网站。 + +## 工具 + +### `wordpress_create_post` + +在 WordPress.com 中创建一篇新博客文章 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 网站 ID 或域名 \(例如，12345678 或 mysite.wordpress.com\) | +| `title` | string | 是 | 文章标题 | +| `content` | string | 否 | 文章内容 \(HTML 或纯文本\) | +| `status` | string | 否 | 文章状态：publish, draft, pending, private, 或 future | +| `excerpt` | string | 否 | 文章摘要 | +| `categories` | string | 否 | 逗号分隔的分类 ID | +| `tags` | string | 否 | 逗号分隔的标签 ID | +| `featuredMedia` | number | 否 | 特色图片媒体 ID | +| `slug` | string | 否 | 文章的 URL slug | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `post` | object | 创建的文章 | + +### `wordpress_update_post` + +更新 WordPress.com 中的现有博客文章 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `postId` | number | 是 | 要更新的文章 ID | +| `title` | string | 否 | 文章标题 | +| `content` | string | 否 | 文章内容 \(HTML 或纯文本\) | +| `status` | string | 否 | 文章状态：发布、草稿、待审核、私密或未来 | +| `excerpt` | string | 否 | 文章摘要 | +| `categories` | string | 否 | 逗号分隔的分类 ID | +| `tags` | string | 否 | 逗号分隔的标签 ID | +| `featuredMedia` | number | 否 | 特色图片媒体 ID | +| `slug` | string | 否 | 文章的 URL slug | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `post` | object | 更新的文章 | + +### `wordpress_delete_post` + +从 WordPress.com 删除博客文章 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `postId` | number | 是 | 要删除的文章 ID | +| `force` | boolean | 否 | 跳过回收站并永久删除 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `deleted` | boolean | 帖子是否已被删除 | +| `post` | object | 已删除的帖子 | + +### `wordpress_get_post` + +通过 ID 从 WordPress.com 获取单个博客帖子 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `postId` | number | 是 | 要检索的帖子 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `post` | object | 检索到的帖子 | + +### `wordpress_list_posts` + +从 WordPress.com 列出博客帖子并可选添加筛选条件 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `perPage` | number | 否 | 每页帖子数量 \(默认值：10，最大值：100\) | +| `page` | number | 否 | 分页的页码 | +| `status` | string | 否 | 帖子状态筛选：publish, draft, pending, private | +| `author` | number | 否 | 按作者 ID 筛选 | +| `categories` | string | 否 | 按逗号分隔的分类 ID 筛选 | +| `tags` | string | 否 | 按逗号分隔的标签 ID 筛选 | +| `search` | string | 否 | 用搜索词筛选帖子 | +| `orderBy` | string | 否 | 按字段排序：date, id, title, slug, modified | +| `order` | string | 否 | 排序方向：asc 或 desc | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `posts` | 数组 | 帖子列表 | + +### `wordpress_create_page` + +在 WordPress.com 中创建新页面 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | 字符串 | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `title` | 字符串 | 是 | 页面标题 | +| `content` | 字符串 | 否 | 页面内容 \(HTML 或纯文本\) | +| `status` | 字符串 | 否 | 页面状态：发布、草稿、待定、私密 | +| `excerpt` | 字符串 | 否 | 页面摘要 | +| `parent` | 数字 | 否 | 分层页面的父页面 ID | +| `menuOrder` | 数字 | 否 | 页面菜单中的顺序 | +| `featuredMedia` | 数字 | 否 | 特色图片媒体 ID | +| `slug` | 字符串 | 否 | 页面 URL slug | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `page` | 对象 | 创建的页面 | + +### `wordpress_update_page` + +更新 WordPress.com 中的现有页面 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | 字符串 | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `pageId` | 数字 | 是 | 要更新页面的 ID | +| `title` | 字符串 | 否 | 页面标题 | +| `content` | 字符串 | 否 | 页面内容 \(HTML 或纯文本\) | +| `status` | 字符串 | 否 | 页面状态：发布、草稿、待定、私密 | +| `excerpt` | 字符串 | 否 | 页面摘要 | +| `parent` | 数字 | 否 | 分层页面的父页面 ID | +| `menuOrder` | 数字 | 否 | 页面菜单中的顺序 | +| `featuredMedia` | 数字 | 否 | 特色图片媒体 ID | +| `slug` | 字符串 | 否 | 页面 URL slug | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `page` | object | 更新后的页面 | + +### `wordpress_delete_page` + +从 WordPress.com 删除页面 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `pageId` | number | 是 | 要删除的页面 ID | +| `force` | boolean | 否 | 跳过回收站并永久删除 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `deleted` | boolean | 页面是否已删除 | +| `page` | object | 已删除的页面 | + +### `wordpress_get_page` + +通过 ID 从 WordPress.com 获取单个页面 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `pageId` | number | 是 | 要检索的页面 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `page` | object | 检索到的页面 | + +### `wordpress_list_pages` + +从 WordPress.com 列出页面并可选添加筛选条件 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `perPage` | number | 否 | 每次请求的页面数量 \(默认值：10，最大值：100\) | +| `page` | number | 否 | 分页的页码 | +| `status` | string | 否 | 页面状态筛选：publish, draft, pending, private | +| `parent` | number | 否 | 按父页面 ID 筛选 | +| `search` | string | 否 | 用于筛选页面的搜索词 | +| `orderBy` | string | 否 | 按字段排序：date, id, title, slug, modified, menu_order | +| `order` | string | 否 | 排序方向：asc 或 desc | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `pages` | 数组 | 页面列表 | + +### `wordpress_upload_media` + +上传媒体文件（图片、视频、文档）到 WordPress.com + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | 字符串 | 是 | WordPress.com 站点 ID 或域名（例如：12345678 或 mysite.wordpress.com） | +| `file` | 字符串 | 是 | Base64 编码的文件数据或用于获取文件的 URL | +| `filename` | 字符串 | 是 | 带扩展名的文件名（例如：image.jpg） | +| `title` | 字符串 | 否 | 媒体标题 | +| `caption` | 字符串 | 否 | 媒体说明 | +| `altText` | 字符串 | 否 | 用于无障碍的替代文本 | +| `description` | 字符串 | 否 | 媒体描述 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `media` | 对象 | 上传的媒体项 | + +### `wordpress_get_media` + +通过 ID 从 WordPress.com 获取单个媒体项 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | 字符串 | 是 | WordPress.com 站点 ID 或域名（例如：12345678 或 mysite.wordpress.com） | +| `mediaId` | 数字 | 是 | 要检索的媒体项 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `media` | 对象 | 检索到的媒体项 | + +### `wordpress_list_media` + +列出 WordPress.com 媒体库中的媒体项目 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名（例如：12345678 或 mysite.wordpress.com） | +| `perPage` | number | 否 | 每次请求的媒体项目数量（默认：10，最大值：100） | +| `page` | number | 否 | 分页的页码 | +| `search` | string | 否 | 用于筛选媒体的搜索词 | +| `mediaType` | string | 否 | 按媒体类型筛选：image, video, audio, application | +| `mimeType` | string | 否 | 按特定 MIME 类型筛选（例如：image/jpeg） | +| `orderBy` | string | 否 | 按字段排序：date, id, title, slug | +| `order` | string | 否 | 排序方向：asc 或 desc | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `media` | array | 媒体项目列表 | + +### `wordpress_delete_media` + +从 WordPress.com 删除媒体项目 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名（例如：12345678 或 mysite.wordpress.com） | +| `mediaId` | number | 是 | 要删除的媒体项目 ID | +| `force` | boolean | 否 | 强制删除（媒体没有回收站，因此删除是永久性的） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `deleted` | 布尔值 | 媒体是否已被删除 | +| `media` | 对象 | 被删除的媒体项 | + +### `wordpress_create_comment` + +在 WordPress.com 的文章上创建新评论 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | 字符串 | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `postId` | 数字 | 是 | 要评论的文章 ID | +| `content` | 字符串 | 是 | 评论内容 | +| `parent` | 数字 | 否 | 回复的父评论 ID | +| `authorName` | 字符串 | 否 | 评论作者显示名称 | +| `authorEmail` | 字符串 | 否 | 评论作者邮箱 | +| `authorUrl` | 字符串 | 否 | 评论作者 URL | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `comment` | 对象 | 创建的评论 | + +### `wordpress_list_comments` + +从 WordPress.com 列出评论并可选添加筛选条件 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | 字符串 | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `perPage` | 数字 | 否 | 每次请求的评论数量 \(默认：10，最大：100\) | +| `page` | 数字 | 否 | 分页的页码 | +| `postId` | 数字 | 否 | 按文章 ID 筛选 | +| `status` | 字符串 | 否 | 按评论状态筛选：approved, hold, spam, trash | +| `search` | 字符串 | 否 | 筛选评论的搜索词 | +| `orderBy` | 字符串 | 否 | 按字段排序：date, id, parent | +| `order` | 字符串 | 否 | 排序方向：asc 或 desc | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `comments` | array | 评论列表 | + +### `wordpress_update_comment` + +更新 WordPress.com 中的评论（内容或状态） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `commentId` | number | 是 | 要更新的评论 ID | +| `content` | string | 否 | 更新后的评论内容 | +| `status` | string | 否 | 评论状态：approved, hold, spam, trash | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `comment` | object | 更新后的评论 | + +### `wordpress_delete_comment` + +从 WordPress.com 删除评论 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `commentId` | number | 是 | 要删除的评论 ID | +| `force` | boolean | 否 | 跳过回收站并永久删除 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `deleted` | boolean | 评论是否已删除 | +| `comment` | object | 已删除的评论 | + +### `wordpress_create_category` + +在 WordPress.com 中创建新分类 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `name` | string | 是 | 分类名称 | +| `description` | string | 否 | 分类描述 | +| `parent` | number | 否 | 层级分类的父分类 ID | +| `slug` | string | 否 | 分类的 URL slug | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `category` | object | 创建的分类 | + +### `wordpress_list_categories` + +从 WordPress.com 列出分类 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `perPage` | number | 否 | 每次请求的分类数量 \(默认：10，最大：100\) | +| `page` | number | 否 | 分页的页码 | +| `search` | string | 否 | 用于筛选分类的搜索词 | +| `order` | string | 否 | 排序方向：asc 或 desc | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `categories` | array | 分类列表 | + +### `wordpress_create_tag` + +在 WordPress.com 中创建新标签 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `name` | string | 是 | 标签名称 | +| `description` | string | 否 | 标签描述 | +| `slug` | string | 否 | 标签的 URL slug | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `tag` | object | 创建的标签 | + +### `wordpress_list_tags` + +从 WordPress.com 列出标签 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `perPage` | number | 否 | 每次请求的标签数量 \(默认：10，最大：100\) | +| `page` | number | 否 | 分页的页码 | +| `search` | string | 否 | 用于筛选标签的搜索词 | +| `order` | string | 否 | 排序方向：asc 或 desc | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `tags` | array | 标签列表 | + +### `wordpress_get_current_user` + +获取当前已认证的 WordPress.com 用户信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `user` | object | 当前用户 | + +### `wordpress_list_users` + +从 WordPress.com 列出用户（需要管理员权限） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | string | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `perPage` | number | 否 | 每次请求的用户数量 \(默认：10，最大：100\) | +| `page` | number | 否 | 分页的页码 | +| `search` | string | 否 | 用于筛选用户的搜索词 | +| `roles` | string | 否 | 用于筛选的逗号分隔角色名称 | +| `order` | string | 否 | 排序方向：asc 或 desc | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `users` | 数组 | 用户列表 | + +### `wordpress_get_user` + +通过 ID 从 WordPress.com 获取特定用户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | 字符串 | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `userId` | 数字 | 是 | 要检索的用户 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `user` | 对象 | 检索到的用户 | + +### `wordpress_search_content` + +在 WordPress.com 中搜索所有内容类型（文章、页面、媒体） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `siteId` | 字符串 | 是 | WordPress.com 站点 ID 或域名 \(例如：12345678 或 mysite.wordpress.com\) | +| `query` | 字符串 | 是 | 搜索查询 | +| `perPage` | 数字 | 否 | 每次请求的结果数量 \(默认值：10，最大值：100\) | +| `page` | 数字 | 否 | 分页的页码 | +| `type` | 字符串 | 否 | 按内容类型过滤：post、page、attachment | +| `subtype` | 字符串 | 否 | 按文章类型 slug 过滤 \(例如：post、page\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `results` | 数组 | 搜索结果 | + +## 注意事项 + +- 类别：`tools` +- 类型：`wordpress` diff --git a/apps/docs/content/docs/zh/tools/zendesk.mdx b/apps/docs/content/docs/zh/tools/zendesk.mdx index e8027e96e..bf014b096 100644 --- a/apps/docs/content/docs/zh/tools/zendesk.mdx +++ b/apps/docs/content/docs/zh/tools/zendesk.mdx @@ -109,11 +109,14 @@ import { BlockInfoCard } from "@/components/ui/block-info-card" | `subdomain` | string | 是 | 您的 Zendesk 子域名 | | `subject` | string | 否 | 工单主题（可选 - 如果未提供，将自动生成） | | `description` | string | 是 | 工单描述（第一条评论） | -| `priority` | string | 否 | 优先级（低、普通、高、紧急） | +| `priority` | string | 否 | 优先级（低、正常、高、紧急） | | `status` | string | 否 | 状态（新建、打开、待处理、挂起、已解决、已关闭） | | `type` | string | 否 | 类型（问题、事件、问题、任务） | | `tags` | string | 否 | 逗号分隔的标签 | | `assigneeId` | string | 否 | 分配的用户 ID | +| `groupId` | string | 否 | 组 ID | +| `requesterId` | string | 否 | 请求者用户 ID | +| `customFields` | string | 否 | 自定义字段作为 JSON 对象（例如：\{"field_id": "value"\}） | #### 输出 diff --git a/apps/docs/content/docs/zh/tools/zoom.mdx b/apps/docs/content/docs/zh/tools/zoom.mdx new file mode 100644 index 000000000..432e61e75 --- /dev/null +++ b/apps/docs/content/docs/zh/tools/zoom.mdx @@ -0,0 +1,250 @@ +--- +title: Zoom +description: 创建和管理 Zoom 会议及录制内容 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Zoom](https://zoom.us/) 是一个领先的基于云的通信平台，提供视频会议、网络研讨会和在线协作功能。它让用户和组织可以轻松安排、主持和管理会议，并提供屏幕共享、聊天、录制等工具。 + +使用 Zoom，您可以： + +- **安排和管理会议**：创建即时或计划会议，包括定期活动 +- **配置会议选项**：设置会议密码、启用等候室以及控制参与者的视频/音频 +- **发送邀请和共享详情**：获取会议邀请和信息，便于分享 +- **获取和更新会议数据**：访问会议详情、修改现有会议并以编程方式管理设置 + +在 Sim 中，Zoom 集成使您的代理能够自动化安排和会议管理。使用工具操作可以： + +- 以编程方式创建具有自定义设置的新会议 +- 列出特定用户（或您自己）的所有会议 +- 检索任何会议的详情或邀请 +- 直接从您的自动化中更新或删除现有会议 + +这些功能使您能够简化远程协作、自动化定期视频会议，并将您的组织 Zoom 环境管理整合到工作流程中。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Zoom 集成到工作流程中。创建、列出、更新和删除 Zoom 会议。获取会议详情、邀请、录制内容和参与者信息。以编程方式管理云录制内容。 + +## 工具 + +### `zoom_create_meeting` + +创建一个新的 Zoom 会议 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `userId` | string | 是 | 用户 ID 或电子邮件地址。使用 "me" 表示已认证用户。 | +| `topic` | string | 是 | 会议主题 | +| `type` | number | 否 | 会议类型：1=即时，2=计划，3=无固定时间的定期会议，8=有固定时间的定期会议 | +| `startTime` | string | 否 | ISO 8601 格式的会议开始时间 \(例如：2025-06-03T10:00:00Z\) | +| `duration` | number | 否 | 会议时长（分钟） | +| `timezone` | string | 否 | 会议的时区 \(例如：America/Los_Angeles\) | +| `password` | string | 否 | 会议密码 | +| `agenda` | string | 否 | 会议议程 | +| `hostVideo` | boolean | 否 | 主持人视频开启时开始 | +| `participantVideo` | boolean | 否 | 参与者视频开启时开始 | +| `joinBeforeHost` | boolean | 否 | 允许参与者在主持人之前加入 | +| `muteUponEntry` | boolean | 否 | 参与者进入时静音 | +| `waitingRoom` | boolean | 否 | 启用等候室 | +| `autoRecording` | string | 否 | 自动录制设置：本地、云或无 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `meeting` | object | 创建的会议及其所有属性 | + +### `zoom_list_meetings` + +列出 Zoom 用户的所有会议 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `userId` | string | 是 | 用户 ID 或电子邮件地址。使用 "me" 表示已认证用户。 | +| `type` | string | 否 | 会议类型过滤器：scheduled, live, upcoming, upcoming_meetings, 或 previous_meetings | +| `pageSize` | number | 否 | 每页记录数（最大 300） | +| `nextPageToken` | string | 否 | 分页令牌，用于获取下一页结果 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `meetings` | array | 会议列表 | +| `pageInfo` | object | 分页信息 | + +### `zoom_get_meeting` + +获取特定 Zoom 会议的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | 是 | 会议 ID | +| `occurrenceId` | string | 否 | 循环会议的发生 ID | +| `showPreviousOccurrences` | boolean | 否 | 显示循环会议的先前发生记录 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `meeting` | object | 会议详情 | + +### `zoom_update_meeting` + +更新现有的 Zoom 会议 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | 是 | 要更新的会议 ID | +| `topic` | string | 否 | 会议主题 | +| `type` | number | 否 | 会议类型：1=即时会议，2=预定会议，3=无固定时间的循环会议，8=固定时间的循环会议 | +| `startTime` | string | 否 | ISO 8601 格式的会议开始时间 \(例如：2025-06-03T10:00:00Z\) | +| `duration` | number | 否 | 会议时长（分钟） | +| `timezone` | string | 否 | 会议的时区 \(例如：America/Los_Angeles\) | +| `password` | string | 否 | 会议密码 | +| `agenda` | string | 否 | 会议议程 | +| `hostVideo` | boolean | 否 | 主持人视频开启时开始 | +| `participantVideo` | boolean | 否 | 参与者视频开启时开始 | +| `joinBeforeHost` | boolean | 否 | 允许参与者在主持人之前加入 | +| `muteUponEntry` | boolean | 否 | 参与者进入时静音 | +| `waitingRoom` | boolean | 否 | 启用等候室 | +| `autoRecording` | string | 否 | 自动录制设置：本地、云端或无 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 会议是否成功更新 | + +### `zoom_delete_meeting` + +删除或取消 Zoom 会议 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | 是 | 要删除的会议 ID | +| `occurrenceId` | string | 否 | 删除循环会议中特定场次的场次 ID | +| `scheduleForReminder` | boolean | 否 | 向注册者发送取消提醒邮件 | +| `cancelMeetingReminder` | boolean | 否 | 向注册者和替代主持人发送取消邮件 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 会议是否成功删除 | + +### `zoom_get_meeting_invitation` + +获取 Zoom 会议的邀请文本 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | 是 | 会议 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `invitation` | string | 会议邀请文本 | + +### `zoom_list_recordings` + +列出 Zoom 用户的所有云录制 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `userId` | string | 是 | 用户 ID 或电子邮件地址。对于已认证用户，请使用 "me"。 | +| `from` | string | 否 | 开始日期，格式为 yyyy-mm-dd（最近 6 个月内） | +| `to` | string | 否 | 结束日期，格式为 yyyy-mm-dd | +| `pageSize` | number | 否 | 每页记录数（最大 300） | +| `nextPageToken` | string | 否 | 分页令牌，用于获取下一页结果 | +| `trash` | boolean | 否 | 设置为 true 以列出回收站中的录制 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `recordings` | array | 录制列表 | +| `pageInfo` | object | 分页信息 | + +### `zoom_get_meeting_recordings` + +获取特定 Zoom 会议的所有录制内容 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | 是 | 会议 ID 或会议 UUID | +| `includeFolderItems` | boolean | 否 | 包括文件夹内的项目 | +| `ttl` | number | 否 | 下载 URL 的有效时间（秒）\(最大值 604800\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `recording` | object | 包含所有文件的会议录制内容 | + +### `zoom_delete_recording` + +删除 Zoom 会议的云录制内容 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | 是 | 会议 ID 或会议 UUID | +| `recordingId` | string | 否 | 要删除的特定录制文件 ID。如果未提供，则删除所有录制内容。 | +| `action` | string | 否 | 删除操作："trash" \(移至回收站\) 或 "delete" \(永久删除\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 录制内容是否成功删除 | + +### `zoom_list_past_participants` + +列出过去 Zoom 会议的参与者 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `meetingId` | string | 是 | 过去会议的 ID 或 UUID | +| `pageSize` | number | 否 | 每页记录数 \(最大值 300\) | +| `nextPageToken` | string | 否 | 分页令牌，用于获取下一页结果 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `participants` | 数组 | 会议参与者列表 | +| `pageInfo` | 对象 | 分页信息 | + +## 注意事项 + +- 类别：`tools` +- 类型：`zoom` diff --git a/apps/docs/i18n.lock b/apps/docs/i18n.lock index 423253da9..992429541 100644 --- a/apps/docs/i18n.lock +++ b/apps/docs/i18n.lock @@ -46161,7 +46161,7 @@ checksums: content/24: 2e0c17af85edfb251596a7774ebc148f content/25: f062fa5ca051bc3f3d208c8932508fc0 content/26: 371d0e46b4bd2c23f559b8bc112f6955 - content/27: 5d6598ff7fad859902693a7ba046c398 + content/27: 43a06769b0b005d1e7d9028fc4e53665 content/28: bcadfc362b69078beee0088e5936c98b content/29: 573530e346d195727862b03b380f40fc content/30: 720be6a9405a4d31e16d25dc262eddb6 @@ -46331,7 +46331,7 @@ checksums: content/21: 0d0df11141026dfb1e4de53843499579 content/22: 4b96be5b5d22cece48b4cd78f4e5c829 content/23: 371d0e46b4bd2c23f559b8bc112f6955 - content/24: 723d2e113be25d3cd980e6186c572258 + content/24: 74ee08e9e68d84b96d8759509badb9b1 content/25: bcadfc362b69078beee0088e5936c98b content/26: 67456b133656d4f8bb370bed904a2443 content/27: 1f6f2a97ec42a3875f835d4d36287076 @@ -46343,7 +46343,7 @@ checksums: content/33: 13eab4fb9f71b4e0504c6a4e56c2aee8 content/34: e1f4031b7fb28e6162c1f686b8ab1eda content/35: 371d0e46b4bd2c23f559b8bc112f6955 - content/36: 4452a0db67acf3cdb7106048d0c13f49 + content/36: aa82628dc64ce63078e84c965c202c35 content/37: bcadfc362b69078beee0088e5936c98b content/38: 3c7a9d68ac7ba4512bb6f323985b52b1 content/39: 1056675c0ea860117db432bc79c720f4 @@ -47484,3 +47484,1257 @@ checksums: content/46: 1696af7fda8206f857591de089cea25c content/47: b3f310d5ef115bea5a8b75bf25d7ea9a content/48: 076d05c494cf5c494ed98e011b27b289 + ca97a470914fbaac55705ca8cd30f39b: + meta/title: 1029e5d2d8697381dc767ce4090aace0 + meta/description: 0699faa3ae6d78dfd0510ff7c19f5004 + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: e15e8845cccae59630a84183e9262583 + content/2: 9f2f9254955cdd0df257c28ed00d71db + content/3: 0bf893a1208d14b1cb770383956e4ab0 + content/4: 0f0165c7e21355d8f8e332c2252100db + content/5: 11289606ffb19f4564a7f0a867a39a55 + content/6: 05eb6fe6951b12bcddd3ae36aacc7bb3 + content/7: 715b7f8ee32c3d0dcd20cc0a57a9367b + content/8: 821e6394b0a953e2b0842b04ae8f3105 + content/9: e5f8dc06b6db9aeef348d8af9617c787 + content/10: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/11: 0ec27ddd5601764fadfc363811376d88 + content/12: 18e3253cead6514fe5e939d98b64d8fb + content/13: 371d0e46b4bd2c23f559b8bc112f6955 + content/14: 676120936020f1a25faea0d5608b7958 + content/15: bcadfc362b69078beee0088e5936c98b + content/16: ecad0614a5ec681a43fea86034a30905 + content/17: 8eb606aad3db305e12679efb6fe7363e + content/18: 7d9ab020b8312987af94a42c7797a6bc + content/19: 371d0e46b4bd2c23f559b8bc112f6955 + content/20: 6854dad4e5e5419803d3b0a387bf36c1 + content/21: bcadfc362b69078beee0088e5936c98b + content/22: 051e39427d40ab7c4b5ebbbf65c7910f + content/23: 9c42c50fa5ce2db382867e2da5bca90d + content/24: 7bc9a20018bc365ecf55a54a53ad1013 + content/25: 371d0e46b4bd2c23f559b8bc112f6955 + content/26: 299dce7368070dd19957ba06efef836b + content/27: bcadfc362b69078beee0088e5936c98b + content/28: d9a5be31d4296b81660b38dcb4c695cc + content/29: d732fd0df847a742d6dabfc5110ba31d + content/30: 9782a621e6d591e72b7ce5e27face7af + content/31: 371d0e46b4bd2c23f559b8bc112f6955 + content/32: 2d7dd3ac552ff837d614c510033646ba + content/33: bcadfc362b69078beee0088e5936c98b + content/34: 37d84e8cc60979a8d3f1e48483d23113 + content/35: 90bc3ad5e30e5d579f48787e7d8181ae + content/36: 7db1faa939033f49aad8ef462e630c26 + content/37: 371d0e46b4bd2c23f559b8bc112f6955 + content/38: 5e289bbda737273fa75101e276358ec8 + content/39: bcadfc362b69078beee0088e5936c98b + content/40: 805d1a06016797ba04f3cb840ac59e44 + content/41: 88260e555a61ba6886e56f3bc06512dc + content/42: 80c4006b7d25c461c18e9a8a35cfac72 + content/43: 371d0e46b4bd2c23f559b8bc112f6955 + content/44: 645735bd919e64e034c03b98cc75d5be + content/45: bcadfc362b69078beee0088e5936c98b + content/46: 842462f8cd7a897eda330bba54d297df + content/47: 96d58ab5053c5f5db3f15f82442eb3dd + content/48: 148c8f5f3872aa6e9944e221c35bc9a0 + content/49: 371d0e46b4bd2c23f559b8bc112f6955 + content/50: 7a449b1878a28cff4b713a104581ec63 + content/51: bcadfc362b69078beee0088e5936c98b + content/52: 502548c4b9d6be040f73fc431c3c8fd6 + content/53: 1304212656a10261692509a67cfae220 + content/54: 042eb9071c13eb10ee5fd0bfd4e00c8a + content/55: 371d0e46b4bd2c23f559b8bc112f6955 + content/56: 4263559dc306f5edcdfa1bf758adffdf + content/57: bcadfc362b69078beee0088e5936c98b + content/58: 984b85e501fbd9993b7fe38898e5d445 + content/59: 12f6776606adce02255b1db24cd58d29 + content/60: fc53b00cfedd65f5fd906daebd9c04df + content/61: 371d0e46b4bd2c23f559b8bc112f6955 + content/62: 242a47e9aaf5c07859e2a472bed6d3ac + content/63: bcadfc362b69078beee0088e5936c98b + content/64: 2823402034702ff5ca56b9cad3572c4d + content/65: 8ddcef9d1d32bff76ac8e6c5a0e0dca5 + content/66: 94a960dd84bd71825b58d2219b98dd74 + content/67: 371d0e46b4bd2c23f559b8bc112f6955 + content/68: e7777f90d25d134aa0a3cae9cdfc6563 + content/69: bcadfc362b69078beee0088e5936c98b + content/70: affc25ff3d47510647c984a1d59b0a0e + content/71: b3f310d5ef115bea5a8b75bf25d7ea9a + content/72: 2d9d3b6969330e7b2d8e1169cfcf0031 + 1db887f91df2e066fc769749f3b2a930: + meta/title: b4c01a60ed020f21556b4a8ef3f24cae + meta/description: b2f402630c2605cff14c3d7ad2c52d16 + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: 215f8ef1e9aa2bfc2c4566099af0988a + content/2: b2660c88ea5310f5c9c1cce5b76fc228 + content/3: 638dcd3f049adad0b2ca47e7d81d881c + content/4: a3ca812984d65fd8b57765b48b08f85f + content/5: 821e6394b0a953e2b0842b04ae8f3105 + content/6: 65478b264c95c3b3304d2e0728fa18c2 + content/7: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/8: a453c99cb0f4d9a1bd06136592369e8a + content/9: dc3a894985d9126871cb74d71da63bf5 + content/10: 371d0e46b4bd2c23f559b8bc112f6955 + content/11: 3248f40c2006883975f9bd444db1f8b4 + content/12: bcadfc362b69078beee0088e5936c98b + content/13: a9624f93c315061a878099dad4e9159f + content/14: 7eae9ae281bc892bd709e9f652378162 + content/15: 3dd3178602495c94c7e5852ff3fc0654 + content/16: 371d0e46b4bd2c23f559b8bc112f6955 + content/17: 5c3fea67e1a3b9d88c3fcdee1d1f806a + content/18: bcadfc362b69078beee0088e5936c98b + content/19: 0caed5e314c7169f877206b1962ff096 + content/20: 17bca7f3002347d5fe856bd2dafa546f + content/21: 484e55f02d9335e9c86a79b09b4fa60f + content/22: 371d0e46b4bd2c23f559b8bc112f6955 + content/23: 1b9aa3ede6557187a20b616b28f33c9a + content/24: bcadfc362b69078beee0088e5936c98b + content/25: f2347b7b0efb70eca34e0c970f2cf0ea + content/26: 9ced4c73d4dfd13247968ac1fe8acd47 + content/27: 03f52f5e4787f4d1259b7ba0d5aaa822 + content/28: 371d0e46b4bd2c23f559b8bc112f6955 + content/29: 4425953d46c3c7f83f1977845c9ddded + content/30: bcadfc362b69078beee0088e5936c98b + content/31: a5fb231372023729ddf29bc3522a4138 + content/32: 9facf73ab7221d9f8a8c64b57a20d3af + content/33: 484e835ab774d3a00ec5dc40ec085c6e + content/34: 371d0e46b4bd2c23f559b8bc112f6955 + content/35: cb866d6f55249ded50ed9fd7c35cbcb5 + content/36: bcadfc362b69078beee0088e5936c98b + content/37: b65800c93740d5abdc157130e35ab783 + content/38: d0e3e368b296985a2a4d5c48eace68cd + content/39: cd6fbcd829a22f8c96ec8aa805e286a5 + content/40: 371d0e46b4bd2c23f559b8bc112f6955 + content/41: 7f215e9b8f44babd4be7cfa276a004a3 + content/42: bcadfc362b69078beee0088e5936c98b + content/43: f71a334901f7d12acee8e20f85a42ca0 + content/44: 59c38f31041089fa27b4c31c4876ef9f + content/45: 4d489b7a92e59300fa5c9de1a588a758 + content/46: 371d0e46b4bd2c23f559b8bc112f6955 + content/47: 0ac67d1658e506e36f0d6af57f1444e6 + content/48: bcadfc362b69078beee0088e5936c98b + content/49: 5982f5329f2d54e9ec479b6e1fca4b47 + content/50: 9ef2913b69571f3aa2d1fa74a072a787 + content/51: f824c1eddcc0a7ac863b68b17c34edc0 + content/52: 371d0e46b4bd2c23f559b8bc112f6955 + content/53: d50adddbde390ae3d67b5132658fc607 + content/54: bcadfc362b69078beee0088e5936c98b + content/55: cf16d309ef69f3b2e8648096130e4c0b + content/56: 4dd589766d5c0c3dd40f89be6a030d83 + content/57: e7b1035f5a84eb9bbb03656234ac755d + content/58: 371d0e46b4bd2c23f559b8bc112f6955 + content/59: f47eb2dd59d158d3d741ad4b736632ce + content/60: bcadfc362b69078beee0088e5936c98b + content/61: f2ae0765f3863a95761fbc60a690cf4f + content/62: 8d4f7e88fc331449cbe3babdfc7efc9a + content/63: 9e9acdccdabbaafffd9faff3dd284127 + content/64: 371d0e46b4bd2c23f559b8bc112f6955 + content/65: d7300d3b4919992a2478ec988dc4ef38 + content/66: bcadfc362b69078beee0088e5936c98b + content/67: dcb0b5eba4815ad70f4c81ab18d92d52 + content/68: ada572e729e01d615e2bed27d33796cb + content/69: b45b536bf6f2547c9058fca134946283 + content/70: 371d0e46b4bd2c23f559b8bc112f6955 + content/71: a7ca3f5cb26e88ffcbb6972d13b8e0ab + content/72: bcadfc362b69078beee0088e5936c98b + content/73: 820449909a823294cef60f274eb7dd70 + content/74: d676ef2d8dca4c76ca28bac77c6e83cb + content/75: 2806ed48d56a5645235ceec73c0f6597 + content/76: 371d0e46b4bd2c23f559b8bc112f6955 + content/77: d79bafaaa7b61020d8802c169bbc9bf8 + content/78: bcadfc362b69078beee0088e5936c98b + content/79: f7c891dc3b78ca26f2bb54f8fe505c51 + content/80: fef60e449dd315eee67df7e7987faa65 + content/81: d32bf39442c204afcab28834130d0a69 + content/82: 371d0e46b4bd2c23f559b8bc112f6955 + content/83: 2976b6abf5e348e476bd1fc2e5274772 + content/84: bcadfc362b69078beee0088e5936c98b + content/85: 2539fc032a2400f6c0eb0bd01c0606a7 + content/86: 55d79eeac9bd9eaafd407c3f1523e38a + content/87: 9fccf917b2164d395487a6b4e6632ddb + content/88: 371d0e46b4bd2c23f559b8bc112f6955 + content/89: de04b058dd110c15513b1c771eb28720 + content/90: bcadfc362b69078beee0088e5936c98b + content/91: daeaca84eb6b56269fb77af9b4af806c + content/92: 36b32f1a19b9e59d4fe1b21612acbadb + content/93: 2199a29e4055092280b24a7c0a745c8e + content/94: 371d0e46b4bd2c23f559b8bc112f6955 + content/95: cba943ca742cef40994bd6c4d324dd80 + content/96: bcadfc362b69078beee0088e5936c98b + content/97: c4c8d6a5474f666aead38a98a419deb9 + content/98: 92e363140055be190fc1386248df4219 + content/99: 8813b85ff37d76db8453fb334d0f7c36 + content/100: 371d0e46b4bd2c23f559b8bc112f6955 + content/101: 5e7ddd59ef9be8d1b6a2c1848e05d7ce + content/102: bcadfc362b69078beee0088e5936c98b + content/103: 43c9cc151b303e0a94bcb1c8e38c1396 + content/104: 8ec24cbf06bee117b373a832eb009330 + content/105: 07de6aa9e8c4b353e195001c2af316ff + content/106: 371d0e46b4bd2c23f559b8bc112f6955 + content/107: 462de189d27ddfb3883aeec18fbb8cef + content/108: bcadfc362b69078beee0088e5936c98b + content/109: 3f738270799daa8b08c67b1e1a8fc6ce + content/110: e190160579c8c62539a15d155faa00c5 + content/111: 684c489dda8117e981581b3d1e3c38ad + content/112: 371d0e46b4bd2c23f559b8bc112f6955 + content/113: a9db97d3c60b2e54828dbff336211c55 + content/114: bcadfc362b69078beee0088e5936c98b + content/115: 6a6a8a80d42a71786febd28cb0e34dce + content/116: d9706769faa38d42e1b78105989d1fca + content/117: 25b75a36a53418443b1b8c111e956483 + content/118: 371d0e46b4bd2c23f559b8bc112f6955 + content/119: 58c5a3ee27493453eb60e36a77ec0298 + content/120: bcadfc362b69078beee0088e5936c98b + content/121: e8c277f87beeb7c6728e0235c3358fce + content/122: 3139e2d84a90f971a2166a0705170f2c + content/123: 5c8654f3a42c839c6ee3520319077164 + content/124: 371d0e46b4bd2c23f559b8bc112f6955 + content/125: c37b979751a390081e0350365f1764ce + content/126: bcadfc362b69078beee0088e5936c98b + content/127: dec9f81f6670caef49c8b881a10ad7cd + content/128: aab2872e54672497f02c1cce3e08b756 + content/129: 23ffa614a35e2410035b171056f0de65 + content/130: 371d0e46b4bd2c23f559b8bc112f6955 + content/131: bbc42b1934ce53a9ee80de21ef257e6d + content/132: bcadfc362b69078beee0088e5936c98b + content/133: 2fc0ecd831d95a7fade5518374bd16b1 + content/134: 60b2fbcdcb3b30c11959703fd414e538 + content/135: 944618912cf90050530907df61c97fbd + content/136: 371d0e46b4bd2c23f559b8bc112f6955 + content/137: 73acbaa74e83785f8a89d9db2593e029 + content/138: bcadfc362b69078beee0088e5936c98b + content/139: b70f356f1969e4ad878eb007e85910f7 + content/140: acbf4f43624e6c06fd29ac5110c31b5f + content/141: fa42f5222bad94360895ab10b0ed09d6 + content/142: 371d0e46b4bd2c23f559b8bc112f6955 + content/143: 28fb08ecdd9e852f9e4f8ee2ffa531de + content/144: bcadfc362b69078beee0088e5936c98b + content/145: 1ddb3cf76f2cf91b54d3887c847625ca + content/146: 34593291ec05325846ee4cd0a3d89ee5 + content/147: 1d597e5e16fa6fdbf4cad6dfac6af451 + content/148: 371d0e46b4bd2c23f559b8bc112f6955 + content/149: c207d5a59fcf37234168a96f50dc8d7e + content/150: bcadfc362b69078beee0088e5936c98b + content/151: 4eb7a6b882dc526dbbd30f3994461a7e + content/152: 9f3b9015bc5a995bbe63f5f1be5857c3 + content/153: c70d2cfa3766cb673e04f18b3debeb55 + content/154: 371d0e46b4bd2c23f559b8bc112f6955 + content/155: ef1f3d8d02993442b7ed296e476b9895 + content/156: bcadfc362b69078beee0088e5936c98b + content/157: 7a1d019e29e989d2ba9784147ab088e8 + content/158: 0d30e56bc81304a0a9ff85c821fbc2bb + content/159: d665d7ede64b617a4d22f31bbc2c2113 + content/160: 371d0e46b4bd2c23f559b8bc112f6955 + content/161: 866f885792ac14cb1ae62b8d449832bd + content/162: bcadfc362b69078beee0088e5936c98b + content/163: 051e69c1a55d941b0518571aab231e0e + content/164: b3f310d5ef115bea5a8b75bf25d7ea9a + content/165: 9246dcbff599f1a78b2573396786f4b4 + 7544e6bbec0b6f608fa7e70253854896: + meta/title: 29bdf8e30085e5c82dddb251bdc64636 + meta/description: 0cd65770177e3bf19a9898261091ea0a + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: 93fe36d949a363dc1046973e5e88f88b + content/2: a84444b9fe582c299a7124a9264cbd90 + content/3: 52fa2046e39209a89d9989bf8ee186a1 + content/4: 121f0d6ab8245069801522a16a205ffe + content/5: 83595d1187940c43712bfdaae0a896bc + content/6: cdff16db07123fc02a01528aaf628b2e + content/7: cab5747e1067d58a75dae651b264370d + content/8: 821e6394b0a953e2b0842b04ae8f3105 + content/9: 2ee2553e48e0a18cf3bfc255397e1726 + content/10: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/11: 12974df6047f226f2f29e83999d5198a + content/12: aafdff3dd5376916ce1229b4030fc43c + content/13: 371d0e46b4bd2c23f559b8bc112f6955 + content/14: 3b16c9a96432e95971471ec764710ba2 + content/15: bcadfc362b69078beee0088e5936c98b + content/16: b83be867d45ff597374a957827c68ae0 + content/17: c468c2541984b516e473ce370a7d1861 + content/18: 89222582a67991d0a049b3d2085f0f0b + content/19: 371d0e46b4bd2c23f559b8bc112f6955 + content/20: 6ec2cd58498f84ea0d1c2bf1333bbb98 + content/21: bcadfc362b69078beee0088e5936c98b + content/22: 0fa5720b10b5f03e090950e048cf5db4 + content/23: dd3fab91b18e051a668fa88a664803e3 + content/24: 8952423efabee6b7bde6bc6a7ac03d66 + content/25: 371d0e46b4bd2c23f559b8bc112f6955 + content/26: b5f612ad790b286989d32bc12c1ae0e4 + content/27: bcadfc362b69078beee0088e5936c98b + content/28: 1bb6d690740794a0f4d978967432514a + content/29: 62939e5b9d7ce774e27e5c70366f77bc + content/30: 9fa3ca8bbcf54e36204693863fd63e1b + content/31: 371d0e46b4bd2c23f559b8bc112f6955 + content/32: 5f8f779b060eee1d7c33aea5c82c85e6 + content/33: bcadfc362b69078beee0088e5936c98b + content/34: 0bcf1f24d1132b101ca84953050ea643 + content/35: 65e9febb562cd2b29ecb821cbeeccaba + content/36: 61bf5a686af076c2d99bb640e9c9bf3c + content/37: 371d0e46b4bd2c23f559b8bc112f6955 + content/38: 65326a00336b14330ecce18f9e0c85fe + content/39: bcadfc362b69078beee0088e5936c98b + content/40: ba5ca63ac5e28f91ab778b4dca97a268 + content/41: 41963707e05ec8975f7a300b034a5587 + content/42: 0c923188287c45a2122c5035cc4c3e65 + content/43: 371d0e46b4bd2c23f559b8bc112f6955 + content/44: aa2e17cae3816f3ed8c569296e8b8915 + content/45: bcadfc362b69078beee0088e5936c98b + content/46: c6502143361d54065e60a919cf44ae68 + content/47: bd7e08258935ba4233cf329836d82930 + content/48: b88bb61c8d40601652493904224d3e9b + content/49: 371d0e46b4bd2c23f559b8bc112f6955 + content/50: 4797a675af281f25279998309537df07 + content/51: bcadfc362b69078beee0088e5936c98b + content/52: 2073a831a5b87343236dad9fa5e9b634 + content/53: eb82983a2a19726e6a4517332d3a08c9 + content/54: 0d2abd8cb35f1e97dd0c7a3db73abe6f + content/55: 371d0e46b4bd2c23f559b8bc112f6955 + content/56: 1f3aeef3036f9faedff6199bf3cf51fa + content/57: bcadfc362b69078beee0088e5936c98b + content/58: 36575005c9ee76db19040d97cab1a58a + content/59: 7801e2cbc526c8738dc33524a8624dc3 + content/60: 621d8142c04a0631cee9245dc62d9293 + content/61: 371d0e46b4bd2c23f559b8bc112f6955 + content/62: 307f25b4258e0f3d9c7faccd6638d4c4 + content/63: bcadfc362b69078beee0088e5936c98b + content/64: 3dd1e22ce5c88a06d67dcbecc7245ecf + content/65: 6b4e2953d59f6c4922a6a21b6f435bf9 + content/66: 0195fe64640560f26b1646b0dab198cd + content/67: 371d0e46b4bd2c23f559b8bc112f6955 + content/68: 216755dd8a96a21841d834627de1bc43 + content/69: bcadfc362b69078beee0088e5936c98b + content/70: 2e2038fca5771e681ec70c64dde92b9c + content/71: dba4094f535380800cb88cfade31997e + content/72: 3ec69014549503fbd9fa6d8d6eb76096 + content/73: 371d0e46b4bd2c23f559b8bc112f6955 + content/74: 29ac8bd05aff50383eab751be54b9b9f + content/75: bcadfc362b69078beee0088e5936c98b + content/76: f867d5fd97f52ddccd74d189b8d2b151 + content/77: a3abab12daf52d3b940d4868a72b7fa0 + content/78: 6943aa7c3ead590d4c07fe075a6ba9ae + content/79: 371d0e46b4bd2c23f559b8bc112f6955 + content/80: f5da00c986a936f91e635d9f82d0f9c3 + content/81: bcadfc362b69078beee0088e5936c98b + content/82: 3487e9e701f80e3d3215d4275872fbc4 + content/83: f24e748b279e7a9da3722e08792ed8dc + content/84: ed0fd5356d4b1926657e91120bdd08fa + content/85: 371d0e46b4bd2c23f559b8bc112f6955 + content/86: 4e45d4e9d7bb15f2027cb7338d043ca1 + content/87: bcadfc362b69078beee0088e5936c98b + content/88: 72b447407848cd26aa8107d1f81ab0b8 + content/89: b3f310d5ef115bea5a8b75bf25d7ea9a + content/90: 0fd2634925021c2c3571d66fcc5f4a70 + 239836bdcc69c7b6d6e74fb0b9749d76: + meta/title: 9539cd396a04e8b27e71e79c21baf3ad + meta/description: 5cc6f7989e16d3fede37f4d93d397a83 + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: 1a0339003a1a01db85c1105bf88c516a + content/2: a8a4652697fe2140b9584e22032bb608 + content/3: 14378c732af862f70e6af248e3b6b3a1 + content/4: c390d0c7603fcd37b80ef183017fbc34 + content/5: 241adca5c53a0304ecb27f2bac9ef702 + content/6: 821e6394b0a953e2b0842b04ae8f3105 + content/7: d4db874559cb9c7afc55b7819c9bb169 + content/8: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/9: f9d997faf7eee255ef1b03b5e26a57ac + content/10: c7de75897563dbdedabe08d39957fa26 + content/11: 371d0e46b4bd2c23f559b8bc112f6955 + content/12: 632673509e32e8bae1e996eaebbd4e7d + content/13: bcadfc362b69078beee0088e5936c98b + content/14: 0a3015819dfe626c33e2e037fb113f74 + content/15: 64151a7f5f3ba942f6cffb7e24c41f7f + content/16: 7bd9fc4c061623c9aa47e031e47a22c8 + content/17: 371d0e46b4bd2c23f559b8bc112f6955 + content/18: f2926ee1875b902bb574844c5eb60ef5 + content/19: bcadfc362b69078beee0088e5936c98b + content/20: a7e2ceaede990842f6907b2c9373cd8b + content/21: 464ab92eddb38b07d365b69c07f5797c + content/22: 71f213c2f82f42ba6490cb1e01e0cb23 + content/23: 371d0e46b4bd2c23f559b8bc112f6955 + content/24: fd99efc58bd4719fbe7714d537209fd0 + content/25: bcadfc362b69078beee0088e5936c98b + content/26: ccdd5c2be7df6e975979dc97c48036b9 + content/27: 6183d107f62b88b818103e8800dbbf50 + content/28: ea545c120582c3184fc04c07d471aca7 + content/29: 371d0e46b4bd2c23f559b8bc112f6955 + content/30: 62ed907264e61e9cb4d9bdd23b07ac8a + content/31: bcadfc362b69078beee0088e5936c98b + content/32: c96204b052904bddb476442ac84dc447 + content/33: cf760a57c55c045653724e43dab94b88 + content/34: 738dc54ff88a391e0d0506d9702ab201 + content/35: 371d0e46b4bd2c23f559b8bc112f6955 + content/36: f18d0b4a6a531ea8ffecd16db57d5b22 + content/37: bcadfc362b69078beee0088e5936c98b + content/38: cf7f52b9a8376386ffd8f09b3cb91e3e + content/39: be9359fe1ab32cead4a29b27f1764aab + content/40: d17d8ca48cd6c5333779e5b3dde09161 + content/41: 371d0e46b4bd2c23f559b8bc112f6955 + content/42: d8b7b3fffdc221e9dc65abd21744edd3 + content/43: bcadfc362b69078beee0088e5936c98b + content/44: 6b18bc3a604dc83cfeb06fd3917a5a24 + content/45: b00bc76ce0684072733ac181bd7a0743 + content/46: 929237f687a8c1af6f3cafc49bd07c71 + content/47: 371d0e46b4bd2c23f559b8bc112f6955 + content/48: 10f4b39a3c40bfe43213015a11c05758 + content/49: bcadfc362b69078beee0088e5936c98b + content/50: 2465ed841299becfe683aab4f0be5779 + content/51: 2c1f7d9a16016a1c598c6c3ccfc6b57b + content/52: 7683651c52364dd315720773562ef657 + content/53: 371d0e46b4bd2c23f559b8bc112f6955 + content/54: 7c22e8829fe16021181511bd671f8bc2 + content/55: bcadfc362b69078beee0088e5936c98b + content/56: 53795c5faf5404d36f8de5e62ba22620 + content/57: 7f1bfd072de58afb9298d0aa37068a8c + content/58: 3eb2b71f3df9076a30df3fd7e58840e1 + content/59: 371d0e46b4bd2c23f559b8bc112f6955 + content/60: c1d92e0da2200ab3f1b3cc897fba28ce + content/61: bcadfc362b69078beee0088e5936c98b + content/62: 45661eb2f213320a4a1370f735d30a2e + content/63: 0eb38a652935f7c6bd28ffd41306a235 + content/64: 73aaf9c52b212caf5c9a9d29d21ad6ae + content/65: 371d0e46b4bd2c23f559b8bc112f6955 + content/66: f2fd86ba964fe8a58f33750c96ec6039 + content/67: bcadfc362b69078beee0088e5936c98b + content/68: 8131550b75025541bb316ea8126aab66 + content/69: 619633254b3dbb6b66e403cd91a44049 + content/70: 87fde8b43a3d1e2c87522e19d5babd3b + content/71: 371d0e46b4bd2c23f559b8bc112f6955 + content/72: 2dde7d9fb68ae3d996cc6902416308c5 + content/73: bcadfc362b69078beee0088e5936c98b + content/74: 65237335bb0835731efc33baec032a8e + content/75: ff06d023eac46239f90ce82be429af9f + content/76: 9d22a9b5296c6196b4709175dd3f93df + content/77: 371d0e46b4bd2c23f559b8bc112f6955 + content/78: f4d688eb9e8df50e09d505d1e39dc91e + content/79: bcadfc362b69078beee0088e5936c98b + content/80: d64d7bc913b8f6c6a50327453502fa86 + content/81: c8bb5ddc0fe9de99dfc68398e35cb89f + content/82: 55ebb0d6091f5ebe2a502f915c9d0c6b + content/83: 371d0e46b4bd2c23f559b8bc112f6955 + content/84: be0c2aa82c1929aca2e6bed22c0d5c95 + content/85: bcadfc362b69078beee0088e5936c98b + content/86: 663fa06f84d9723dc0dc1bd4d229cb2b + content/87: 40968232788f3cc8811154772dde4b24 + content/88: 38feb4f674fc5d037819077a724ef6bf + content/89: 371d0e46b4bd2c23f559b8bc112f6955 + content/90: 6b636795164fb206816077f824dc342d + content/91: bcadfc362b69078beee0088e5936c98b + content/92: 7a643a961362dc8155a228098442b3a3 + content/93: 38fd38eb8b093f92edc1528979332aad + content/94: 6a64e1fbc00b39d6284e3806ecb19d79 + content/95: 371d0e46b4bd2c23f559b8bc112f6955 + content/96: 8a95a49f899dbf860a324ae4612f7c4a + content/97: bcadfc362b69078beee0088e5936c98b + content/98: f7f9b35a7cd0da444729003ec5b5a025 + content/99: 0d1332e69f7082e3207cb6a244163fc2 + content/100: 4be0313648d3a58b60c2e51a3a01e492 + content/101: 371d0e46b4bd2c23f559b8bc112f6955 + content/102: 6cde437d17f33457d7fcf761a0e3fcc7 + content/103: bcadfc362b69078beee0088e5936c98b + content/104: 2cac7cabb9566da5b06f105f97af2c1a + content/105: 91021bb3079720a96ea1c3627223b97f + content/106: 9b86b562b91a09215bc48b64d829bc0d + content/107: 371d0e46b4bd2c23f559b8bc112f6955 + content/108: 853f9c781165bf1b6e9baaf49d0de0f4 + content/109: bcadfc362b69078beee0088e5936c98b + content/110: 701d477460507f06290a5b45214c2602 + content/111: 491a3c33e217e5a1a9ef6c139f27a291 + content/112: c24a800fcfa8ba91b1298333b4c07c7a + content/113: 371d0e46b4bd2c23f559b8bc112f6955 + content/114: 22954c60750199e71ed4c41b5158056e + content/115: bcadfc362b69078beee0088e5936c98b + content/116: eab1665b6cdf2a564dc756c9924a55be + content/117: fe9cacbf37e427d86c5f4163bd1fb81d + content/118: a090679a987117b59a9eada7804995b7 + content/119: 371d0e46b4bd2c23f559b8bc112f6955 + content/120: c9ef9ff0fa38910b0c65e103418e07e2 + content/121: bcadfc362b69078beee0088e5936c98b + content/122: 04a8c91a711c2d3710c03de236f3967d + content/123: 9fdda1d6011245d397a5701170f9afb1 + content/124: a8374b1089d42bd9e5ce1c92b2042618 + content/125: 371d0e46b4bd2c23f559b8bc112f6955 + content/126: cf4248a53e111589b42cfd59f925f36c + content/127: bcadfc362b69078beee0088e5936c98b + content/128: e258fae2b01bbc41af7eb30da391d427 + content/129: 392016b8a87dfefdf90527863794f474 + content/130: 0b5147c4fa4bf48fb936c43338f2c931 + content/131: 371d0e46b4bd2c23f559b8bc112f6955 + content/132: 12e4a8c121ada8e3e1f9cf24c8076241 + content/133: bcadfc362b69078beee0088e5936c98b + content/134: 49a3737e6806890b80b71c979b246793 + content/135: b3f310d5ef115bea5a8b75bf25d7ea9a + content/136: ad9075f0b7b2eb7080465a1ab32536f4 + cbea29244e7adfcc2acbf63a860d85c7: + meta/title: a6fb14c7759e9ad51e6967f4a0efa81f + meta/description: e7319be3fa12f8f53f6cd1b599209327 + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: b7237e071263f11730b5f65edb605d09 + content/2: 9853a907b5e626d674c57a7dd0ba6061 + content/3: f258a2ef5db1a967f50ef2becfbf1ecc + content/4: 0ec2160584f88973e9779d791137f2fe + content/5: 47448babd13ad67b7669de0c82f219e2 + content/6: 1dc26173cce4b90bc74b8ab5dde8ffd0 + content/7: 821e6394b0a953e2b0842b04ae8f3105 + content/8: 51e9a78cd7141cf0f4a5a399ff876384 + content/9: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/10: bb5d0521074c58da3f6b997faef887ae + content/11: 147f49b8a7a56cb60c881117480a71fb + content/12: 371d0e46b4bd2c23f559b8bc112f6955 + content/13: d88f3b55a0e0c21884b1666d3d431d06 + content/14: bcadfc362b69078beee0088e5936c98b + content/15: 7311861512fa50f2c937d080692151e8 + content/16: fbb677a4902291738c3a1f8b9303fd4a + content/17: 840eb13be6ecb8f1cf652ae9ea3f3dc8 + content/18: 371d0e46b4bd2c23f559b8bc112f6955 + content/19: 3dca9d793f1cf0619733a4aef965f385 + content/20: bcadfc362b69078beee0088e5936c98b + content/21: 4634d3f690b2b1977d4555b2d4eee739 + content/22: 25e7fef7953155abe4219e03058c2f94 + content/23: 1ba7d90c16ff260798c13836a74aad6a + content/24: 371d0e46b4bd2c23f559b8bc112f6955 + content/25: 937261561e7fbca25bfa59e1761a77be + content/26: bcadfc362b69078beee0088e5936c98b + content/27: a88bd6e0708b4c3017be42eabc480947 + content/28: 528f164231d5bf39fcd8849734efebde + content/29: 6f779ec439c0e4b8e42370a6d3db4a5e + content/30: 371d0e46b4bd2c23f559b8bc112f6955 + content/31: dee5cd45e0dcd6d19acf9081d0c8c805 + content/32: bcadfc362b69078beee0088e5936c98b + content/33: b6656b4d0cb132b838d73e758850e3f9 + content/34: 78c6c8168c1295ea5aaab803874a6795 + content/35: 566a0073bd48010fdaeac9388c100042 + content/36: 371d0e46b4bd2c23f559b8bc112f6955 + content/37: 13677e745575edf438b603aa13bac889 + content/38: bcadfc362b69078beee0088e5936c98b + content/39: edb564cb480f1375dbc22c1553b1abe4 + content/40: 887cc3ce330dc18a3cf13692f28a4ade + content/41: c9b49024bd518a859dc76fb30eb46f94 + content/42: 371d0e46b4bd2c23f559b8bc112f6955 + content/43: 6c107c32338f118f6849c576107480f4 + content/44: bcadfc362b69078beee0088e5936c98b + content/45: fb073b94e2c2ca29212d093d5b103b87 + content/46: 5f54ceacaf53a1db8bda5399ae205831 + content/47: 3401fea610db18780a989ea02d8841aa + content/48: 371d0e46b4bd2c23f559b8bc112f6955 + content/49: 13677e745575edf438b603aa13bac889 + content/50: bcadfc362b69078beee0088e5936c98b + content/51: 08aaa5e1b8c8e8c146f68228e6d53792 + content/52: 19a1b9442970caf8758d0ffc7f179574 + content/53: 10a83dde0830cd58d4cb19dd8a0c3649 + content/54: 371d0e46b4bd2c23f559b8bc112f6955 + content/55: c0d2832eacdb9bd8c8d9156019956cf7 + content/56: bcadfc362b69078beee0088e5936c98b + content/57: 08aaa5e1b8c8e8c146f68228e6d53792 + content/58: 17afc458eef6484867c139fd212d90d9 + content/59: da1f2733213d33e0509dc557bc6c80a8 + content/60: 371d0e46b4bd2c23f559b8bc112f6955 + content/61: 42c3b4d062ae50f6ebaf9a7460a6fc5e + content/62: bcadfc362b69078beee0088e5936c98b + content/63: d6ec19129a153bc0667e76edb9c2953d + content/64: cc46a76f9ce04f5557e34fca2d6562c1 + content/65: 7c3b126537de352cabfc495892892c1c + content/66: 371d0e46b4bd2c23f559b8bc112f6955 + content/67: 954008ba49a8401ae8a22f7092e6ca23 + content/68: bcadfc362b69078beee0088e5936c98b + content/69: b3764199e9c88e86cd0fe6935e539a25 + content/70: c635592e55ceed2da66ad0aa9c5f0ee5 + content/71: 90bf1835ccec7f5ee9b7d5ffb3965654 + content/72: 371d0e46b4bd2c23f559b8bc112f6955 + content/73: 42c3b4d062ae50f6ebaf9a7460a6fc5e + content/74: bcadfc362b69078beee0088e5936c98b + content/75: 27eb346aea67fe81ed94fee3fa0e8bdf + content/76: a020f0e3fe6a3496a735851f230bce15 + content/77: ca39beca950791eb4a75a8da900114bf + content/78: 371d0e46b4bd2c23f559b8bc112f6955 + content/79: 2f5b4e0859d5314f6bf40be3ac13f641 + content/80: bcadfc362b69078beee0088e5936c98b + content/81: bc8fff0a53b034c9383de92b55143450 + content/82: 67b79204dbe622e540a879638ef27f02 + content/83: aed07dcfb7bcbcb4f8e1297276888f04 + content/84: 371d0e46b4bd2c23f559b8bc112f6955 + content/85: 42c3b4d062ae50f6ebaf9a7460a6fc5e + content/86: bcadfc362b69078beee0088e5936c98b + content/87: 4e1b6f9d3f1d760834a31d8b49faa01e + content/88: e0e21aa31b6b03674fb8e6a9167d809d + content/89: 6d55eb60d0264d211cd8e027885738fa + content/90: 371d0e46b4bd2c23f559b8bc112f6955 + content/91: 42c3b4d062ae50f6ebaf9a7460a6fc5e + content/92: bcadfc362b69078beee0088e5936c98b + content/93: a31e86b6e03b7df7b9bd013f5c5b3d20 + content/94: 8629b9c6f2ecbbacb248f9a65938555e + content/95: f69ca030edb0f0c9970a51250fbe1699 + content/96: 371d0e46b4bd2c23f559b8bc112f6955 + content/97: 42c3b4d062ae50f6ebaf9a7460a6fc5e + content/98: bcadfc362b69078beee0088e5936c98b + content/99: e2fc3018c16f1ae4f3e907fc33548d46 + content/100: e5d8665486fab89d1c60b9ab6cfe1c2e + content/101: 62c4501130fb887500df574e0c09c20d + content/102: 371d0e46b4bd2c23f559b8bc112f6955 + content/103: 7e048124d93bb4cdcd6effb9b0c4b414 + content/104: bcadfc362b69078beee0088e5936c98b + content/105: c463989e1754b17b2cc1a7b9fff68cb6 + content/106: 0b68d1e5df6bd6d9ea8be971c4f8bbbf + content/107: 13876fa5c17849a15f6d54647feb6ae5 + content/108: 371d0e46b4bd2c23f559b8bc112f6955 + content/109: 77a4b3016c40c377897e029411f1b8fd + content/110: bcadfc362b69078beee0088e5936c98b + content/111: 77916aef5f86264c96b85ab874c3c447 + content/112: b3f310d5ef115bea5a8b75bf25d7ea9a + content/113: 29208f859f7c25898a8bb435d3e744d0 + 54ec89df9800159df913e0955d2775e1: + meta/title: 6e51f3ea638199ea7733ea81e4512317 + meta/description: 5084d459d228b33203d57521e97a15aa + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: 367fa4b034d02d9123dca3dc0dcfdadf + content/2: 9eb85e9cb9e915facdce6a4c626757a2 + content/3: eb0a9ee99ade94d76ae36288595f2280 + content/4: 5cc47b6bd553ef5ae4e6f2a5fba3a4b1 + content/5: df92c120b414bd5409e0b2f5d12fa191 + content/6: 821e6394b0a953e2b0842b04ae8f3105 + content/7: a9d3e8e671a399b716a03dbac5747dd3 + content/8: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/9: 1249d97c2c2c96fb0dc483cdf764c103 + content/10: 14e0d19fa4c092a2db93edcc870dcf67 + content/11: 371d0e46b4bd2c23f559b8bc112f6955 + content/12: 78b6dd9f0a02aecf0d26bb37cd9a6854 + content/13: bcadfc362b69078beee0088e5936c98b + content/14: 7311861512fa50f2c937d080692151e8 + content/15: a29e8f758eeb0adc9d14cb3ecc9a3572 + content/16: 3bb1094fb4f6bbacf4503db791290728 + content/17: 371d0e46b4bd2c23f559b8bc112f6955 + content/18: d185d2b7ceafeacce0f677a4649cb308 + content/19: bcadfc362b69078beee0088e5936c98b + content/20: 4634d3f690b2b1977d4555b2d4eee739 + content/21: dd173220664de67767b3f0aad2808436 + content/22: 059484693528bd0f6324763d7f32abeb + content/23: 371d0e46b4bd2c23f559b8bc112f6955 + content/24: dfb2c2a7b6f5ddb86f9104defb6e8b5d + content/25: bcadfc362b69078beee0088e5936c98b + content/26: a88bd6e0708b4c3017be42eabc480947 + content/27: 49e6762a44cc519ca70217ba8d90fbf7 + content/28: 77451909a80759c6ebb246a526e6fd7b + content/29: 371d0e46b4bd2c23f559b8bc112f6955 + content/30: 6edd84776ad45703537015af58f492cb + content/31: bcadfc362b69078beee0088e5936c98b + content/32: b6656b4d0cb132b838d73e758850e3f9 + content/33: a04ec00949bbb0a7c99bff8fd232e820 + content/34: 3b42cf913c5f403544540b6244dc8e2e + content/35: 371d0e46b4bd2c23f559b8bc112f6955 + content/36: bddd30707802c07aac61620721bfaf16 + content/37: bcadfc362b69078beee0088e5936c98b + content/38: b622395040bf1aef193558d10a38c128 + content/39: 65de097e276f762b71d59fa7f9b0a207 + content/40: 013f52c249b5919fdb6d96700b25f379 + content/41: 371d0e46b4bd2c23f559b8bc112f6955 + content/42: 8c33b1b3f984f011679b36b77801b936 + content/43: bcadfc362b69078beee0088e5936c98b + content/44: c463989e1754b17b2cc1a7b9fff68cb6 + content/45: 353bd4e36dd70f288ff051157c0bbadb + content/46: 9ee4b0cc8813aeea6b991dabb05c0b2b + content/47: 371d0e46b4bd2c23f559b8bc112f6955 + content/48: 93c01d42da765b2862a1c90e5c207f3a + content/49: bcadfc362b69078beee0088e5936c98b + content/50: cb25800f3f5e9a5688769ba1f1d101fb + content/51: 0c321044b21a59eec7b04f91d6ad521f + content/52: e98e73fb76f28bb6c2fbc2d1aaab21f8 + content/53: 371d0e46b4bd2c23f559b8bc112f6955 + content/54: f130069ac3fcde2a745a1cca5dbb54b5 + content/55: bcadfc362b69078beee0088e5936c98b + content/56: d6ec19129a153bc0667e76edb9c2953d + content/57: ce48c0560ca3ddaad402f2bdd9d459f3 + content/58: b6c9dbaa63995d6b3ee642321e1a9144 + content/59: 371d0e46b4bd2c23f559b8bc112f6955 + content/60: 0eedad01ffe39ef19b5e6728aed5d2f4 + content/61: bcadfc362b69078beee0088e5936c98b + content/62: 77916aef5f86264c96b85ab874c3c447 + content/63: 85eba1d62b7cdd083d0a4991169d7162 + content/64: d4dd284c2b688770d5c732a7e6dff3f0 + content/65: 371d0e46b4bd2c23f559b8bc112f6955 + content/66: a76f4df74674266dabf365775e462623 + content/67: bcadfc362b69078beee0088e5936c98b + content/68: 3f6664c231057ceadd9ac8cba5332b3e + content/69: 4936debbcf6ba547fa7c9265f7dcf40f + content/70: 17a43ca41485e2f78ef7987c78a52e8b + content/71: 371d0e46b4bd2c23f559b8bc112f6955 + content/72: b87a8359c3277447f29050ef280f4ceb + content/73: bcadfc362b69078beee0088e5936c98b + content/74: be30e8adfbab208f4b7b6fedc0559c19 + content/75: 72de310caecaf16e8e74ff37a7fa46b0 + content/76: 4738fdcfd44aa60f5bfd7f484be36360 + content/77: 371d0e46b4bd2c23f559b8bc112f6955 + content/78: 3ff5cc143dcf2514e730b4f68757a6cb + content/79: bcadfc362b69078beee0088e5936c98b + content/80: 08aaa5e1b8c8e8c146f68228e6d53792 + content/81: a72a19e1aff8ea71d24df98f312d9ada + content/82: 0a0fecc6d1a70497410160ee0ea9e757 + content/83: 371d0e46b4bd2c23f559b8bc112f6955 + content/84: d71b6bb8e2dd6ce98101aec6a1dd77f2 + content/85: bcadfc362b69078beee0088e5936c98b + content/86: 2e1b6ed9ba71ee98540f582bf5decd41 + content/87: b3f310d5ef115bea5a8b75bf25d7ea9a + content/88: cbeffb4f92b38461ac320bc6fe7f7ef0 + d58d2e8b125a994bcfb20ff98cfef0ad: + meta/title: 4dd6404ecdca5a70a577f481171c67d6 + meta/description: 13a0731523233bca340f1e28be2d11b3 + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: 275d79792dc068504bf99fac7417d7cc + content/2: 4e44c8b7033b1e0fdfa71b24b6c43542 + content/3: c8512cf179ac45890c402239698840b5 + content/4: 86d8f7580324dfdee18e6a6f64a038d9 + content/5: 8f418c50fb758bb539a0c35e53465bc3 + content/6: 14e4616a88666ab31aa93d7050520563 + content/7: cba8acb89a1c34cd8ebf2aadae2ddcc3 + content/8: 821e6394b0a953e2b0842b04ae8f3105 + content/9: 73bead74a778b1524e03a6716e8261f0 + content/10: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/11: fa81fee089e2b0311409450fc56c66e9 + content/12: 3f0b914292935f6da9c79cd730d6dd71 + content/13: 371d0e46b4bd2c23f559b8bc112f6955 + content/14: ab95a070b13d683fbaeecb6c63e903c9 + content/15: bcadfc362b69078beee0088e5936c98b + content/16: a612cf026717cebb8ed754511ad68256 + content/17: bdf81120a1b36be0589f50576389cf56 + content/18: 86e309cc5fe44f107ada2e20f57fec91 + content/19: 371d0e46b4bd2c23f559b8bc112f6955 + content/20: d5979cd0ef4f18f3d2deaffd0b55a132 + content/21: bcadfc362b69078beee0088e5936c98b + content/22: 6f4e0dd7614d2911355c4c1c92b23606 + content/23: 6dfa5141fa0d6835566054a061587266 + content/24: bd86af20fe0fa5d94c529d79888e1154 + content/25: 371d0e46b4bd2c23f559b8bc112f6955 + content/26: 189a0750661743195ba56d831f13d708 + content/27: bcadfc362b69078beee0088e5936c98b + content/28: 8d36c5a5ef3c73f5c9357db3f51e0fb6 + content/29: e5eba55cc0f249fc6df32e48641dd8ad + content/30: d6d40b83e25d872bce62ee007b3433bd + content/31: 371d0e46b4bd2c23f559b8bc112f6955 + content/32: b69d329e116eaeaf3bfb699fc8eafe70 + content/33: bcadfc362b69078beee0088e5936c98b + content/34: bdd9600f42f4364520ea788300c7b3d3 + content/35: 42042807254e98c43128abcdeb428c5a + content/36: e4a4a8543eacabad494dd500f088ed9f + content/37: 371d0e46b4bd2c23f559b8bc112f6955 + content/38: d20312e96f7dd9d2a9c581291185703d + content/39: bcadfc362b69078beee0088e5936c98b + content/40: d2057bf13fe18f3832a0dced19e23aef + content/41: ad14f1b35f410c75dec802ba2fd04b75 + content/42: edaba7300f7f4ae0dd11624a781c7dec + content/43: 371d0e46b4bd2c23f559b8bc112f6955 + content/44: 9136b3f85e6ebeb286305b351e077799 + content/45: bcadfc362b69078beee0088e5936c98b + content/46: cead73d9f8e186f9f4f56476c22c256a + content/47: 6d35bdbd52eb824aeac324acbff507b4 + content/48: dcf0ff832b87526edca21307b618e164 + content/49: 371d0e46b4bd2c23f559b8bc112f6955 + content/50: f2e9125ce1b0dd851ec7f386f8ad23be + content/51: bcadfc362b69078beee0088e5936c98b + content/52: ee5de6f69a741291feb638c42483d28e + content/53: 3bae9b0c68d2dbaa7e52fa0b24e7281d + content/54: 91656a1745b88892255d213ca4411a0e + content/55: 371d0e46b4bd2c23f559b8bc112f6955 + content/56: 4f790c94fa2be1530baa4a9832e86b51 + content/57: bcadfc362b69078beee0088e5936c98b + content/58: 01ab9284764880216c5b51538dbe5373 + content/59: 3b4c425d163dd834deda3598cfb101cf + content/60: c96a153cd2be25fbf1ce1b15dc54013d + content/61: 371d0e46b4bd2c23f559b8bc112f6955 + content/62: 9b38eca2e9eb86ee3411d5db1cb6a652 + content/63: bcadfc362b69078beee0088e5936c98b + content/64: 63f5acb31e118e414d75af8a99e53be7 + content/65: 5c039063005e77dfd6089c232a6a8321 + content/66: fe6f816ccf87957c0156d4f85401b3cd + content/67: 371d0e46b4bd2c23f559b8bc112f6955 + content/68: 21c557b25a3cf31282d66933fff5ee4d + content/69: bcadfc362b69078beee0088e5936c98b + content/70: ea9173168a8e714993a92b029123a3ea + content/71: 9a533fd0cb6041e3dcef55f6ab1b3d89 + content/72: 551ef24f52c1644ede08140b348281db + content/73: 371d0e46b4bd2c23f559b8bc112f6955 + content/74: 9136b3f85e6ebeb286305b351e077799 + content/75: bcadfc362b69078beee0088e5936c98b + content/76: 4ae599b31e76068c68b2c18eef601730 + content/77: 1168e89ec2162f8b1c0f4437e79d683b + content/78: 1175fa4d6a946de24b5fb57d016f68c1 + content/79: 371d0e46b4bd2c23f559b8bc112f6955 + content/80: 502dd72a174138e7888c41a31a445bc9 + content/81: bcadfc362b69078beee0088e5936c98b + content/82: f194ced69b293f9f8d49d752f44caadb + content/83: 90a2342ab1d3182265f81c9c7b94e800 + content/84: a44f8a4284da46f9e6eea1418e4053d5 + content/85: 371d0e46b4bd2c23f559b8bc112f6955 + content/86: f0be34514306abc1a6f2d43bba7c4743 + content/87: bcadfc362b69078beee0088e5936c98b + content/88: 907a7c72c1cb1bbaa476500208058e61 + content/89: 77b4c49ac2abbf3177723a26027f4b20 + content/90: ade60c2af6d27ec98bc82e382aa9afbd + content/91: 371d0e46b4bd2c23f559b8bc112f6955 + content/92: 3378750de128937713909e2c9b598156 + content/93: bcadfc362b69078beee0088e5936c98b + content/94: 734474507d2d61283c2b25a8e2bca302 + content/95: 5e21388104b28622b8256ab14828092b + content/96: 8f9f595c7d2615f88ed6b0af0949fc5a + content/97: 371d0e46b4bd2c23f559b8bc112f6955 + content/98: 237c85fc48c2098605c25afd75ae17c3 + content/99: bcadfc362b69078beee0088e5936c98b + content/100: ea9173168a8e714993a92b029123a3ea + content/101: dfe1ed829ca4a988dabe554e7b711b05 + content/102: 1602cc36ba6da0eaf29eaf33afdfe7c9 + content/103: 371d0e46b4bd2c23f559b8bc112f6955 + content/104: 9136b3f85e6ebeb286305b351e077799 + content/105: bcadfc362b69078beee0088e5936c98b + content/106: 7b3efd4fcfba86989e7b252488a3125a + content/107: 3c6d6e5a4238bcb5549c07076a22ba64 + content/108: acbb343f433c960d77c9fdf5c48220c4 + content/109: 371d0e46b4bd2c23f559b8bc112f6955 + content/110: 2217c42909bd17c6c2bd992f14a2da03 + content/111: bcadfc362b69078beee0088e5936c98b + content/112: 6cfa3ccb1a16a5f78c9772c2ee33164d + content/113: c7dda898b808614de056bc900176b13b + content/114: c1b18e4198700eba589d21ebb2ffecff + content/115: 371d0e46b4bd2c23f559b8bc112f6955 + content/116: bcef95c4a93d46b5d4bedbd97196e773 + content/117: bcadfc362b69078beee0088e5936c98b + content/118: a2ef5bb663f55045839af07e4732fb9d + content/119: 7505fc7969bfda1f217c0a22bd2cffa5 + content/120: 337c1711c18f07ea5bd4c1aafb2b70ca + content/121: 371d0e46b4bd2c23f559b8bc112f6955 + content/122: de3c6dc828985e7145637e03d3749170 + content/123: bcadfc362b69078beee0088e5936c98b + content/124: f5157d6ea024ed45c55f8bed7516220a + content/125: b3f310d5ef115bea5a8b75bf25d7ea9a + content/126: a7a0477ca54d01f3c0d815d727c47143 + 6bf4a002144862f19cec5ad8c2151fa3: + meta/title: 9d0a6c5a2da773a3f552e554b0d3b46d + meta/description: b1eebde78a10e20c2508b0b0bf526f6a + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: fcb3f7a7db86533bfc1abcbe979e4841 + content/2: 0a7eea393136b48cd5085cbbb9a91ac3 + content/3: 3608f0d78b915b575e1cb720dd5aeb0c + content/4: b880e75e1b7eeba32594cacdb50fddf8 + content/5: 0c26edaebaf335833a6d5dcaf23c30fe + content/6: 821e6394b0a953e2b0842b04ae8f3105 + content/7: 3a53f2c7efd5dc32fe58f82e400aec50 + content/8: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/9: 84e69e43d9a73b00963d34c54ddbbdd4 + content/10: 641f07ff7156bb7d5e9fc9f1b47498c1 + content/11: 371d0e46b4bd2c23f559b8bc112f6955 + content/12: df8b2203fa87b91193b58ca1fa9e7291 + content/13: bcadfc362b69078beee0088e5936c98b + content/14: 62661508d316eaa66bb591fe6b242f6f + content/15: 42018312e5004788c808e448524260a5 + content/16: fab9b94f42164f8e9d068c1f22292433 + content/17: 371d0e46b4bd2c23f559b8bc112f6955 + content/18: d26953fc82f82f1243503fd7d3e36c5f + content/19: bcadfc362b69078beee0088e5936c98b + content/20: 6258beee2f46d8ac18b91265a446ff8d + content/21: 8b836fcc56750c1bd46357179d5916a2 + content/22: 976bf0fbf9eb1869df35697aafa229cf + content/23: 371d0e46b4bd2c23f559b8bc112f6955 + content/24: 84417e1c8f747398c881ef3db4e44eaf + content/25: bcadfc362b69078beee0088e5936c98b + content/26: d9de1754b1953e1196a29bcd9389b54d + content/27: d630759908d13e735c02cc46b75bfb15 + content/28: 9bb251681341f0d1604e704a44e71fa7 + content/29: 371d0e46b4bd2c23f559b8bc112f6955 + content/30: c8556f32bcf874cb3fd93027e15b8733 + content/31: bcadfc362b69078beee0088e5936c98b + content/32: 17c2c31169f311d42508e7f842d860a8 + content/33: d1b4f52ec617fa2a733737a33acef22e + content/34: dbd31d515c16e977156d1449fc6b1c33 + content/35: 371d0e46b4bd2c23f559b8bc112f6955 + content/36: 883fe84e62f6392848a78a59857c7c67 + content/37: bcadfc362b69078beee0088e5936c98b + content/38: 5ea46f1482acd39d2455708b246bb0dd + content/39: e3ad6d2338c442e55d1f8322a91771e9 + content/40: 3d756ad177099dea61d463f47270da8e + content/41: 371d0e46b4bd2c23f559b8bc112f6955 + content/42: 639eb0a0d5ad681d9cd5111d533b75ce + content/43: bcadfc362b69078beee0088e5936c98b + content/44: 31159e7d3d870089389c1c4854d54b41 + content/45: 42bbe759e01e582bc1589aac61ba69f2 + content/46: fb8b1f73f2ca8e530e70b92873a9e043 + content/47: 371d0e46b4bd2c23f559b8bc112f6955 + content/48: d82df91011cf4b6fc546c9fa538cc964 + content/49: bcadfc362b69078beee0088e5936c98b + content/50: 3079cafac7647d1594771e6cfa609861 + content/51: 287cb73e7228b15db3d4eede063f8317 + content/52: bb0c3ab8e5dd275074d45807144796d5 + content/53: 371d0e46b4bd2c23f559b8bc112f6955 + content/54: 193c1ac07f41026d9b66dbb666b425bb + content/55: bcadfc362b69078beee0088e5936c98b + content/56: a80a01e12ef69e2c0a85bec4ca5f2b40 + content/57: 508085708ee846ca9d51a9e9cb48afe1 + content/58: 95120a1e225cfe344ffbe8a7cf7b73c2 + content/59: 371d0e46b4bd2c23f559b8bc112f6955 + content/60: 73f3e754fa21d6518187eb81c17bf344 + content/61: bcadfc362b69078beee0088e5936c98b + content/62: 8f3fb31cd03cbf59d8df5deabb2f92ba + content/63: d28cdd4ec7019aa756e0d7be83faae6e + content/64: 0ad45a85353bf92ebefbd951247d8469 + content/65: 371d0e46b4bd2c23f559b8bc112f6955 + content/66: 5b0891a52c7392a1ca77c0fa54ed1311 + content/67: bcadfc362b69078beee0088e5936c98b + content/68: b6285cbd3781c2339257f1d9d9dbecb8 + content/69: c0f9a6bf99f0ecf3d5afa86cfb76fd54 + content/70: e23f4dd55cf0831b4cf3b3380f47f128 + content/71: 371d0e46b4bd2c23f559b8bc112f6955 + content/72: 1ef96156abe22c66cc017d70163f5a9f + content/73: bcadfc362b69078beee0088e5936c98b + content/74: c3ab74f584075d16b9b093ac5b26deb5 + content/75: 42940db05236f9ef60f3b233e3afaba5 + content/76: ab7545d6f9da831f705bb2c5e9d6c8c0 + content/77: 371d0e46b4bd2c23f559b8bc112f6955 + content/78: 028cde385a21a47d30baceb1f8dda83e + content/79: bcadfc362b69078beee0088e5936c98b + content/80: f936f5bbab9e493968290a5a27022093 + content/81: 1c0a866d8d15a718dd55def07e9125dc + content/82: 9dfbd91fcff532e6e604bbc26c30d347 + content/83: 371d0e46b4bd2c23f559b8bc112f6955 + content/84: b67cfc9b90f650b30051a5c2e2996a83 + content/85: bcadfc362b69078beee0088e5936c98b + content/86: 9e21b795a4090461d73eac132fb980d3 + content/87: f34df3dbaf4171deee04a0a65d517921 + content/88: b4d37a3152d038ec8c38f67462625d61 + content/89: 371d0e46b4bd2c23f559b8bc112f6955 + content/90: a5e8970607f9046b68455ef0261eee3b + content/91: bcadfc362b69078beee0088e5936c98b + content/92: a80a01e12ef69e2c0a85bec4ca5f2b40 + content/93: 0d4a837b39faa922e4178288109e3556 + content/94: 97e5febc1a4eed0b6000e96ece809422 + content/95: 371d0e46b4bd2c23f559b8bc112f6955 + content/96: 2b7ec589b39668ff5ab59c6f6d33d666 + content/97: bcadfc362b69078beee0088e5936c98b + content/98: 7982f79405ac1051c71870c79e6758ec + content/99: 685bf9199080801a9557327e8bac890b + content/100: b6d22c240ea53b23de3e6ae3e1fab3d0 + content/101: 371d0e46b4bd2c23f559b8bc112f6955 + content/102: 810a7d7f168fd8f5185b990102107624 + content/103: bcadfc362b69078beee0088e5936c98b + content/104: 9b9617cfc7501f2058928f202a85934c + content/105: 5e3d4393c5ba2e6830fd4ffdefa2720e + content/106: 4d31047860a63dd3bac826c1d1d5c725 + content/107: 371d0e46b4bd2c23f559b8bc112f6955 + content/108: d094677b4b82ec37d62b57797d4454e3 + content/109: bcadfc362b69078beee0088e5936c98b + content/110: 9c2bf982858b686b8de8096ce9484e50 + content/111: b3bc0d95ffb0d7723f549a6106fdcf6c + content/112: 016492eb181cb85f0e753ed5fec0e5e9 + content/113: 371d0e46b4bd2c23f559b8bc112f6955 + content/114: 810a7d7f168fd8f5185b990102107624 + content/115: bcadfc362b69078beee0088e5936c98b + content/116: 835ca915303032676e2a2926422140e3 + content/117: 9042efd616d56512f8693e91349df482 + content/118: a7dd29803e7c4a11d018ed83dad25368 + content/119: 371d0e46b4bd2c23f559b8bc112f6955 + content/120: 810a7d7f168fd8f5185b990102107624 + content/121: bcadfc362b69078beee0088e5936c98b + content/122: 4c35548fbcf89c8623707ab00e93a3ef + content/123: b3f310d5ef115bea5a8b75bf25d7ea9a + content/124: c4991ec66d5feb4d7b988ae3b460bdaf + 7ebc527b6578d18b32adf4c31890d2b8: + meta/title: 546f5553ffad01366a0069f862d6a7db + meta/description: 19264142c6db4205e0ca010c496396d8 + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: a85db31ac5d360eb359c91a073da7a9e + content/2: 56988258c7e1ff8c4c3dcec44b9df257 + content/3: 0ddb40e554d998d3827c55a855bc67df + content/4: 304a03f1434d2a73c38cb258d8d98050 + content/5: 830d64a81ffac3afa9e9af1705dc1389 + content/6: 821e6394b0a953e2b0842b04ae8f3105 + content/7: 9d767cc21470e6bb253a505f0c52f973 + content/8: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/9: 94dfd5529594e50621cede9c82d85021 + content/10: 9f9ecd4fa348015c0efe98ce19b1708a + content/11: 371d0e46b4bd2c23f559b8bc112f6955 + content/12: a78d7f9414bfef2e39ea97beef656517 + content/13: bcadfc362b69078beee0088e5936c98b + content/14: f7429a88bf6a47fba25cf4dcd2c54b80 + content/15: 8ee4f42e7fa9916154bd805e35a8d5c3 + content/16: b035b73f163b4eb7eec16feb04cf3e35 + content/17: 371d0e46b4bd2c23f559b8bc112f6955 + content/18: f3b602a3dac31783118969c1e5ffb42a + content/19: bcadfc362b69078beee0088e5936c98b + content/20: f5d13109985b72734cbab6d9fb0385e8 + content/21: 35b06d85046b21dbc39c8610e819d6c5 + content/22: ad6c0071490d7c9f22679bfebc7a0e14 + content/23: 371d0e46b4bd2c23f559b8bc112f6955 + content/24: 60a384f0c40d35e233db2cc86e202c5f + content/25: bcadfc362b69078beee0088e5936c98b + content/26: a009d5af270d7645b071f1b91b545e6a + content/27: ddd1a8c61e08021ca2e0338a57e4c12f + content/28: 545f9e6db6c9d3bf1881e0b1fc36e361 + content/29: 371d0e46b4bd2c23f559b8bc112f6955 + content/30: b463860382cd0565fd069fc6c2582a51 + content/31: bcadfc362b69078beee0088e5936c98b + content/32: 1fe7556ce0ee8e3c5548cf0bf28f5866 + content/33: a5b63d5fe58aa4ee4a553815504d4c6c + content/34: 6e5636df5a466dab0dfaee1ff851b816 + content/35: 371d0e46b4bd2c23f559b8bc112f6955 + content/36: 751ebee034f10b4baad975a0ebeac198 + content/37: bcadfc362b69078beee0088e5936c98b + content/38: a156edf244d04da4364080add6634ff4 + content/39: 8aa7963013960769275d53db8ccbf747 + content/40: 5319790642a4f6d39dea65545ee4e306 + content/41: 371d0e46b4bd2c23f559b8bc112f6955 + content/42: 1f02d483e254e505279aec8c7fee3103 + content/43: bcadfc362b69078beee0088e5936c98b + content/44: eac240f1cc2cc4330ca2c5c30a052db8 + content/45: 82a986cffe31fb87da3e51c183906477 + content/46: 228746ac412c7c017cfcfde1af7af1fd + content/47: 371d0e46b4bd2c23f559b8bc112f6955 + content/48: 363dc26c5780a6a34b231f7de01ec97e + content/49: bcadfc362b69078beee0088e5936c98b + content/50: 7d74f50464e2bf2f8053e2dea048d636 + content/51: 5909dea632a883a8cc5d27772b65ec84 + content/52: 54e3943f1c8095bd04fd94508027f147 + content/53: 371d0e46b4bd2c23f559b8bc112f6955 + content/54: 2252c2e01457f05b2a43fbcdae3365ba + content/55: bcadfc362b69078beee0088e5936c98b + content/56: a067923304e2816b6b804c302886e8cf + content/57: 13493d7bcf0db6a843da566932059089 + content/58: b7f9e3d2d37f7ce143ee72ddc1f12079 + content/59: 371d0e46b4bd2c23f559b8bc112f6955 + content/60: 2dd92be3b8278752ca16c22c31f81ae9 + content/61: bcadfc362b69078beee0088e5936c98b + content/62: b607aae4abb63e741e70778371a85692 + content/63: 23c1639677452c318aa847f6fd96c255 + content/64: 247b480de629949d090c65773666721c + content/65: 371d0e46b4bd2c23f559b8bc112f6955 + content/66: bd5ef804f58e414523d9648806b57e50 + content/67: bcadfc362b69078beee0088e5936c98b + content/68: 56667723584abb1569cb2306884b8b0c + content/69: 879105f518d41738ba875aeaa21467e1 + content/70: 8540c4c348239f04cf3849deafdd334f + content/71: 371d0e46b4bd2c23f559b8bc112f6955 + content/72: ffa604b428cece7e080e15a3b07ee021 + content/73: bcadfc362b69078beee0088e5936c98b + content/74: e25b6cc6b5b0ee5c44684e1d1fd3c0ec + content/75: 685b2e48d432c6f044d18417863089dd + content/76: d9eeb212fdb9376c76f8fd308a3a91d6 + content/77: 371d0e46b4bd2c23f559b8bc112f6955 + content/78: d460d83a18e4c3af51b8d0189b35f78a + content/79: bcadfc362b69078beee0088e5936c98b + content/80: 5c9a8fe6e9a0eaec0952c2981b1f0bf6 + content/81: b3f310d5ef115bea5a8b75bf25d7ea9a + content/82: a6c5d917607e8a9408a3aa7a198cb895 + 9b7823f0914ae80709c21a84a7180c94: + meta/title: de9f02c2da156534cea2663ca8d8331a + meta/description: 71bbe1ad491b4999c4461e39e6749c67 + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: 54a5dcd5262d9fe1d777c14657efb61c + content/2: 9c3664a036227904fd3a926b9b0c35a2 + content/3: c1b3efbd2211f2dd632a52a8e047a956 + content/4: 7a1204b58c41433976633e6c9740d509 + content/5: c0adaa938979fe8578796ca2e877009a + content/6: 821e6394b0a953e2b0842b04ae8f3105 + content/7: 919ce66743f0f7262fdf899a9858ffe7 + content/8: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/9: 03e28ebf2ba3b7cc0d150dbc6effff0c + content/10: 4b6812254a01f453011fa082751ef505 + content/11: 371d0e46b4bd2c23f559b8bc112f6955 + content/12: 80bf36370f8324b8c5ff4f5de68f5007 + content/13: bcadfc362b69078beee0088e5936c98b + content/14: e86dbcd04c869c4f06ecd1ead0ff605d + content/15: 82b8826d36cefcf1b32b278fbf99c6cb + content/16: 00da9bdb7ac04c0b1e4722a2d03f1257 + content/17: 371d0e46b4bd2c23f559b8bc112f6955 + content/18: dd076047737646919052fd7f3c2b2008 + content/19: bcadfc362b69078beee0088e5936c98b + content/20: a24f563f00b2d00a293a8749c3a88e3e + content/21: d29a6528bfc434205f9d5f9cb32a5683 + content/22: 8305db69af9976d5c859fb9d4e562511 + content/23: 371d0e46b4bd2c23f559b8bc112f6955 + content/24: e5c6985f8919eecf8ac2b1925414d08e + content/25: bcadfc362b69078beee0088e5936c98b + content/26: 3e54e53dfe8e2bd688a58c1ec055206f + content/27: 1871aa004a5500e4dc8f39b553ba4f9a + content/28: 70f6f9c45607dcbae0e1960ff13bafcb + content/29: 371d0e46b4bd2c23f559b8bc112f6955 + content/30: 9b6c328554083ae54b38cf988ee69cc7 + content/31: bcadfc362b69078beee0088e5936c98b + content/32: 4be0b21490a302e7813bf40b4dd8483e + content/33: 1b59fb396e871bd34ba3fe460bda4955 + content/34: 300ffdeb29dcb8982eff033789f723d3 + content/35: 371d0e46b4bd2c23f559b8bc112f6955 + content/36: 6daa7787bd6cabac6362d47975020f98 + content/37: bcadfc362b69078beee0088e5936c98b + content/38: 280e7cef2a7a94b98cb549e063de6efa + content/39: 02a338316893c2bb9163505d64bcd543 + content/40: fb97a54e291b7b033bb865249f97b555 + content/41: 371d0e46b4bd2c23f559b8bc112f6955 + content/42: 1c53ff70dc56c14487eaa5acd41160d2 + content/43: bcadfc362b69078beee0088e5936c98b + content/44: f75b144d0602f604f5a7f00a0300576d + content/45: 52f9a76577972f904483c270df07ebb3 + content/46: a3af123994615f5d1d8b0b8b67a4acdb + content/47: 371d0e46b4bd2c23f559b8bc112f6955 + content/48: 8fb56b37c55c1316769e9519e4d1489f + content/49: bcadfc362b69078beee0088e5936c98b + content/50: 1f8639ef42bb93d631da94142d798c03 + content/51: 6362b9634055fd1a7fecc5a063663fb3 + content/52: 0c916dd65caad4ede6b257d15aa38d70 + content/53: 371d0e46b4bd2c23f559b8bc112f6955 + content/54: 37884ed3615838e896a3a3e04c77768b + content/55: bcadfc362b69078beee0088e5936c98b + content/56: c9246b1f5641d16565e2ea9e3c490014 + content/57: ab04073c0d77d7c7d0c2306ea353e034 + content/58: 29fa2e46dacdc57abc835915016436b3 + content/59: 371d0e46b4bd2c23f559b8bc112f6955 + content/60: 08f9c436b1f32d2a9d2711124b6da738 + content/61: bcadfc362b69078beee0088e5936c98b + content/62: 2d74712a18d79f5f6e3edfdcff113499 + content/63: 02bc2f6ae646931313f7b576999ffff5 + content/64: 4e4b751292c9cb43c6c65d12d10d0cff + content/65: 371d0e46b4bd2c23f559b8bc112f6955 + content/66: 5bd3cb79d8866dabc6193737fd78df8f + content/67: bcadfc362b69078beee0088e5936c98b + content/68: 2b7ad4b17f529c80a8c8060efcbe358a + content/69: b3f310d5ef115bea5a8b75bf25d7ea9a + content/70: 89ee671040c32acb7984cd5b088a2dde + 5680833cdae6f33d5469dba8c9362e92: + meta/title: ff8ce9403b78abb64421109aed9996ec + meta/description: b5fc6ccdd52906dd74bf12cd0a98c33b + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: be5f2930565233a962ada722db4cb1a0 + content/2: 1ecf33d8023101e292331c6b589c4c4e + content/3: 6b29e4949f94eb1fbb91cead39c36f4f + content/4: 8a44ee4b4c64313598a41736a14ab04a + content/5: ad809d2a3b9c528d5be4566aab5e47da + content/6: 821e6394b0a953e2b0842b04ae8f3105 + content/7: 02a5ee7f1f291ff4526850f9e5dbb910 + content/8: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/9: fa12bf7481b964e3d17d831c3d32f823 + content/10: bef9bd48a65474c861a7f8af268d68ca + content/11: 371d0e46b4bd2c23f559b8bc112f6955 + content/12: c1b796cd57e41cbf5479a46926047e00 + content/13: bcadfc362b69078beee0088e5936c98b + content/14: 0e6032d72e02114020c36f79938a171c + content/15: 4fa4947fa84dc77ecefafb71d1cb7801 + content/16: 40bb4a20395037d6c27f0b033d429715 + content/17: 371d0e46b4bd2c23f559b8bc112f6955 + content/18: b33478d1e60927a3c7b120e31f2cbdc1 + content/19: bcadfc362b69078beee0088e5936c98b + content/20: 972e3cc2bd0c93886ecec2b0cabe6a67 + content/21: 1f3f722e35a5a5163e2ac7936901d5fa + content/22: 82ed5260f4c6b434aa5d3e272272b75d + content/23: 371d0e46b4bd2c23f559b8bc112f6955 + content/24: b2ac1894cd7152e111d508b7fa2a8e02 + content/25: bcadfc362b69078beee0088e5936c98b + content/26: 354f878e7be477add79e801791a13499 + content/27: ae079b5274074f02754cbc81cb554eee + content/28: 6d2789d80af34e650e00453b6d4803fc + content/29: 371d0e46b4bd2c23f559b8bc112f6955 + content/30: 507dc14a15bc7d9fc6e8e8f7d6e96612 + content/31: bcadfc362b69078beee0088e5936c98b + content/32: 1f7ed153c00931b1d45a4fe3cd6ae2b2 + content/33: 0580a1d5f8d5e833ce809af31ae6fac9 + content/34: b2651c56baa85642b793a527c8225a38 + content/35: 371d0e46b4bd2c23f559b8bc112f6955 + content/36: a4dea291b8d69fd1dd7df161e3eb784c + content/37: bcadfc362b69078beee0088e5936c98b + content/38: 0b69c1cd3b8f90ddc4a8d824bf82af27 + content/39: 1bfcf7a5c2282853e166cfaf79a7a6df + content/40: a0c3158f011805174ebea069b9a61387 + content/41: 371d0e46b4bd2c23f559b8bc112f6955 + content/42: ca82a03cc2ad734d9e6d3bc7dca05d1a + content/43: bcadfc362b69078beee0088e5936c98b + content/44: 9af36b71c244e6a94d3487cc793c295b + content/45: a6b2d01acbae0be9867e7f62db910b04 + content/46: a55eb580f427ff224969949f1ecab0fc + content/47: 371d0e46b4bd2c23f559b8bc112f6955 + content/48: af71120210e99ec2743d8ad3e47d8e7f + content/49: bcadfc362b69078beee0088e5936c98b + content/50: 7117abad481e56769aa12f2cb881736c + content/51: d8e7d805c62114565c11f6edf7033823 + content/52: c859b5e59b8cd820e11ab9c9ddbe03a2 + content/53: 371d0e46b4bd2c23f559b8bc112f6955 + content/54: 6f0d85ffa8c5eb2d495b2a3c2e601e6e + content/55: bcadfc362b69078beee0088e5936c98b + content/56: a36ad3e50e096a57ece3074b67c27a99 + content/57: 1b2f64f1aa8d375243bc9fd85d72a2a3 + content/58: af3ef0863b8a195cee88bfc007228ec6 + content/59: 371d0e46b4bd2c23f559b8bc112f6955 + content/60: 1481ec3b233029af8979fb8d07a2aa70 + content/61: bcadfc362b69078beee0088e5936c98b + content/62: ae3315ddf2d96550bdb7e2fa4b656b5f + content/63: f9703267e532da6ff61c82ac0b30aa45 + content/64: 6b0da9b5041f4f95cfe1deb6579380e4 + content/65: 371d0e46b4bd2c23f559b8bc112f6955 + content/66: 5fd3a1d21ffd64fd7677adea5bbe5cfc + content/67: bcadfc362b69078beee0088e5936c98b + content/68: c57c83308fc427dbdd5d5c5534ec95a9 + content/69: 39846363e0a94bd6c412a7db73c8fe93 + content/70: 4c61661c5e1f29fa5bd9823899c47bae + content/71: 371d0e46b4bd2c23f559b8bc112f6955 + content/72: b3bea4dde975454098f976d51cc6c027 + content/73: bcadfc362b69078beee0088e5936c98b + content/74: 8b05a4b2e6d66a829e721c53e3b37c2f + content/75: 1c68001f3bc074d3f1dd8e18e4843007 + content/76: 2c90d74ec51ff7fc4f894c1c04493b92 + content/77: 371d0e46b4bd2c23f559b8bc112f6955 + content/78: dc5db2ca4aeaf2c4c565a5c3da59539d + content/79: bcadfc362b69078beee0088e5936c98b + content/80: b07243cd60f14257d2764cff9f6052b9 + content/81: b3f310d5ef115bea5a8b75bf25d7ea9a + content/82: b788b3a14a93374cb7dd088f7c6efa67 + 4ebd1ac662b80e2a24f94f60a780f0b1: + meta/title: a129db42ef2b8b2fa8fbbab9c3bc1f68 + meta/description: 6886bd9cb1159767b31dfed7ebd27b5a + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: 6bbc038ab5fe7436954b95e0296a9c7a + content/2: 2a7f67ffd623799a77eb3e362374ea6f + content/3: 162746fa148b97c0047d889d1cebcd23 + content/4: c3d05459d937f2579fe9d4192118f939 + content/5: e9b1adcea6597da65ad39577bced8307 + content/6: 821e6394b0a953e2b0842b04ae8f3105 + content/7: b96d7173e30e15b74bb9ef4829a7c15f + content/8: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/9: 8935dc88e3eb73cf0060d10de793bc6e + content/10: 918505a01595913f8618620372c9dcbf + content/11: 371d0e46b4bd2c23f559b8bc112f6955 + content/12: 8fbf1234adc8ecfcc070463ac417718d + content/13: bcadfc362b69078beee0088e5936c98b + content/14: 9255271feee943eab7c7955516e22c97 + content/15: 2dfc5759fefb6f6d634737488ab53d1e + content/16: e872a945ee7167f360eb818b3a753fd9 + content/17: 371d0e46b4bd2c23f559b8bc112f6955 + content/18: 330b28555033ab7818c28f0135ced2c9 + content/19: bcadfc362b69078beee0088e5936c98b + content/20: 612364c9b62033cd6a2852e5e5e4b789 + content/21: 3b8df1a8e4040e381d6f3990b65cd48d + content/22: eaf08802c1ad125db7477da8aac596d9 + content/23: 371d0e46b4bd2c23f559b8bc112f6955 + content/24: 98266b2486137c5c66dffed4b3a8e74b + content/25: bcadfc362b69078beee0088e5936c98b + content/26: 6ed0ab5f7c5f9aff3fd6ccf68fcd1968 + content/27: 6a00f110fda976b7c4876a6ed736cde9 + content/28: 4adc4a9d1f6e1304beccaad3fbc82505 + content/29: 371d0e46b4bd2c23f559b8bc112f6955 + content/30: 330b28555033ab7818c28f0135ced2c9 + content/31: bcadfc362b69078beee0088e5936c98b + content/32: d30d3f45b437677ecaf28b532505e380 + content/33: 3f8914ba493d122fb89cbd71f3601287 + content/34: d1abe10dd3e8184be9eb94a7b377a212 + content/35: 371d0e46b4bd2c23f559b8bc112f6955 + content/36: 1d50f9d01cc41d8fa6bc3f88cbc7708e + content/37: bcadfc362b69078beee0088e5936c98b + content/38: 1f93f5fe7a14edabb33da99b7f930623 + content/39: 671fd4e9cf20bbe08cfb3732c8b57f4c + content/40: 74f3efc50333dc5d828aa7ae69f5c4e5 + content/41: 371d0e46b4bd2c23f559b8bc112f6955 + content/42: bb049223fb68bf44717cee08a563f292 + content/43: bcadfc362b69078beee0088e5936c98b + content/44: 4ff8530d52904479669c897bce94c95f + content/45: 7520d0a12665f8095be14087d2161e8c + content/46: 12c20c1cd70585fb0d4a6f75686a929e + content/47: 371d0e46b4bd2c23f559b8bc112f6955 + content/48: 431e1e71ef4ecd51efbd6e48047925bf + content/49: bcadfc362b69078beee0088e5936c98b + content/50: 55e2e4e6a709843a4ca759df2bc9d60f + content/51: 3480ccc360645e54b54e1b94ddcafcb4 + content/52: fa8729133f4b766b719d1bce24fe9ec7 + content/53: 371d0e46b4bd2c23f559b8bc112f6955 + content/54: 330b28555033ab7818c28f0135ced2c9 + content/55: bcadfc362b69078beee0088e5936c98b + content/56: eafb7339fb5be61d3984c611d4a42e0d + content/57: b3f310d5ef115bea5a8b75bf25d7ea9a + content/58: 50d2e01e0d0b0baac560a1329e628da0 diff --git a/apps/docs/next.config.ts b/apps/docs/next.config.ts index fbaa560eb..8bbfde24e 100644 --- a/apps/docs/next.config.ts +++ b/apps/docs/next.config.ts @@ -5,6 +5,10 @@ const withMDX = createMDX() /** @type {import('next').NextConfig} */ const config = { reactStrictMode: true, + experimental: { + webpackMemoryOptimizations: true, + webpackBuildWorker: true, + }, async redirects() { return [ { diff --git a/apps/docs/package.json b/apps/docs/package.json index e5aa2f92f..c8d5cdfb4 100644 --- a/apps/docs/package.json +++ b/apps/docs/package.json @@ -5,7 +5,7 @@ "license": "Apache-2.0", "scripts": { "dev": "next dev --port 3001", - "build": "next build", + "build": "NODE_OPTIONS='--max-old-space-size=8192' next build", "start": "next start", "postinstall": "fumadocs-mdx", "type-check": "tsc --noEmit" diff --git a/bun.lock b/bun.lock index 9ae8476ad..5573c7d25 100644 --- a/bun.lock +++ b/bun.lock @@ -607,6 +607,8 @@ "@formatjs/intl-localematcher": ["@formatjs/intl-localematcher@0.6.1", "", { "dependencies": { "tslib": "^2.8.0" } }, "sha512-ePEgLgVCqi2BBFnTMWPfIghu6FkbZnnBVhO2sSxvLfrdFw7wCHAHiDoM2h4NRgjbaY7+B7HgOLZGkK187pZTZg=="], + "@fumadocs/mdx-remote": ["@fumadocs/mdx-remote@1.4.3", "", { "dependencies": { "@mdx-js/mdx": "^3.1.1", "gray-matter": "^4.0.3", "zod": "^4.1.12" }, "peerDependencies": { "@types/react": "*", "fumadocs-core": "^15.0.0 || ^16.0.0", "react": "18.x.x || 19.x.x" }, "optionalPeers": ["@types/react"] }, "sha512-3idm86CegIoDCEygZNmBM8Ekoa0la7pxLA50qvLlzkAyPEkmm7zTMUV/cDaMW0s/uiIHa62rcxVuThc87O8sSg=="], + "@google-cloud/precise-date": ["@google-cloud/precise-date@4.0.0", "", {}, "sha512-1TUx3KdaU3cN7nfCdNf+UVqA/PSX29Cjcox3fZZBtINlRrXVTmUkQnCKv2MbBUbCopbK4olAT1IHl76uZyCiVA=="], "@google/genai": ["@google/genai@0.8.0", "", { "dependencies": { "google-auth-library": "^9.14.2", "ws": "^8.18.0" } }, "sha512-Zs+OGyZKyMbFofGJTR9/jTQSv8kITh735N3tEuIZj4VlMQXTC0soCFahysJ9NaeenRlD7xGb6fyqmX+FwrpU6Q=="], @@ -3501,6 +3503,8 @@ "@esbuild-kit/core-utils/esbuild": ["esbuild@0.18.20", "", { "optionalDependencies": { "@esbuild/android-arm": "0.18.20", "@esbuild/android-arm64": "0.18.20", "@esbuild/android-x64": "0.18.20", "@esbuild/darwin-arm64": "0.18.20", "@esbuild/darwin-x64": "0.18.20", "@esbuild/freebsd-arm64": "0.18.20", "@esbuild/freebsd-x64": "0.18.20", "@esbuild/linux-arm": "0.18.20", "@esbuild/linux-arm64": "0.18.20", "@esbuild/linux-ia32": "0.18.20", "@esbuild/linux-loong64": "0.18.20", "@esbuild/linux-mips64el": "0.18.20", "@esbuild/linux-ppc64": "0.18.20", "@esbuild/linux-riscv64": "0.18.20", "@esbuild/linux-s390x": "0.18.20", "@esbuild/linux-x64": "0.18.20", "@esbuild/netbsd-x64": "0.18.20", "@esbuild/openbsd-x64": "0.18.20", "@esbuild/sunos-x64": "0.18.20", "@esbuild/win32-arm64": "0.18.20", "@esbuild/win32-ia32": "0.18.20", "@esbuild/win32-x64": "0.18.20" }, "bin": { "esbuild": "bin/esbuild" } }, "sha512-ceqxoedUrcayh7Y7ZX6NdbbDzGROiyVBgC4PriJThBKSVPWnnFHZAkfI1lJT8QFkOwH4qOS2SJkS4wvpGl8BpA=="], + "@fumadocs/mdx-remote/zod": ["zod@4.1.13", "", {}, "sha512-AvvthqfqrAhNH9dnfmrfKzX5upOdjUVJYFqNSlkmGf64gRaTzlPwz99IHYnVs28qYAybvAlBV+H7pn0saFY4Ig=="], + "@inquirer/external-editor/iconv-lite": ["iconv-lite@0.7.0", "", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3.0.0" } }, "sha512-cf6L2Ds3h57VVmkZe+Pn+5APsT7FpqJtEhhieDCvrE2MK5Qk9MyffgQyuxQTm6BChfeZNtcOLHp9IcWRVcIcBQ=="], "@isaacs/cliui/string-width": ["string-width@5.1.2", "", { "dependencies": { "eastasianwidth": "^0.2.0", "emoji-regex": "^9.2.2", "strip-ansi": "^7.0.1" } }, "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA=="],