Compare commits

...

38 Commits

Author SHA1 Message Date
Waleed
31874939ee v0.5.17: modals, billing fixes, bun update, zoom, dropbox, kalshi, polymarket, datadog, ahrefs, gitlab, shopify, ssh, wordpress integrations 2025-12-04 13:29:46 -08:00
Waleed
b54ca604b6 fix(chat): fix download & clear popover staying open after pressing in floating chat (#2192) 2025-12-04 13:03:12 -08:00
Waleed
e581608472 fix(copilot): fix code viewer in copilot user inp (#2191) 2025-12-04 12:50:11 -08:00
Emir Karabeg
a4d4dfaa32 fix: tooltip on env settings (#2190) 2025-12-04 12:39:37 -08:00
Waleed
099e86e3c1 fix(settings): fixed sso form validation (#2189) 2025-12-04 12:34:28 -08:00
Emir Karabeg
042de6a944 fix: modals, settings, panel (#2187) 2025-12-04 12:01:36 -08:00
Waleed
f44e7e34ec fix(input): allow test value if no real value provided for inputs in deployed executions (#2186)
* fix(input): allow test value if no real value provided for inputs in deployed executions

* ack PR comments
2025-12-04 11:41:08 -08:00
Waleed
6bfb643ef8 fix(polling): fixed gmail and outlook polling to respect disabled status (#2185) 2025-12-04 11:31:33 -08:00
Siddharth Ganesan
cd5d1c0958 fix(executor): nested error activation (#2184) 2025-12-04 10:55:26 -08:00
Waleed
9df87d9b88 fix(mcp): remove client-side cache and reduce server cache from 5m to 30s (#2182)
* fix(mcp): remove client-side cache and reduce server cache from 5m to 30s

* ack PR comments
2025-12-04 08:51:06 -08:00
Waleed
c864d17991 chore(deps): upgrade to bun v1.3 (#2181)
* chore(deps): upgrade to bun v1.3

* ack PR comments
2025-12-04 00:43:01 -08:00
Emir Karabeg
36c91f4ca9 feat: terminal serach; fix: delete-modal (#2176) 2025-12-04 00:41:38 -08:00
Waleed
6d4ba6d5cf chore(deps): upgrade from nextjs 15.4.1 to 15.4.8 and upgrade turborepo (#2180) 2025-12-04 00:20:50 -08:00
Waleed
5d791cd55f feat(i18n): update translations (#2178)
* feat(i18n): update translations

* memory optimizations

---------

Co-authored-by: waleedlatif1 <waleedlatif1@users.noreply.github.com>
2025-12-04 00:18:21 -08:00
Waleed
5630e133fd feat(tools): added zoom, elasticsearch, dropbox, kalshi, polymarket, datadog, ahrefs, gitlab, shopify, ssh, wordpress (#2175)
* feat(tools): added zoom, elasticsearch, dropbox, box, datadog, ahrefs, gitlab, shopify, ssh, wordpress

* added polymarket & kalshi, fixed ssh

* fix search modal bg instead of bgColor, added polymarket and kalshi new endpoints

* split up grafana

* update docs script & docs

* added more zoom endpoints

* remove unused box creds

* finished wordpress, shopify, kalshi

* cleanup

* revert envvar dropdown changes

* updated grafana endpoints
2025-12-03 20:09:27 -08:00
Emir Karabeg
08a11935af fix: commented out light mode (#2173) 2025-12-03 16:52:35 -08:00
Emir Karabeg
3158b62da8 feat: light, emcn, modals (#2104)
* feat: aligned current unassigned hex to old globals

* feat: emcn modal, help-modal; improvement(ui): emcn textarea, emcn combobox, messages-input

* improvement(modal): ui, transition

* improvement: terminal expand, variables styling; refactor(float): hooks

* improvement(invite-modal): emcn aligned

* feat(terminal): height memory

* improvement(invite-modal): skeleton ui

* improvement(invite-modal): badges UI

* feat: deploy-modal, emcn

* refactor: deleted duplicate dark styles

* feat: emcn, settings, light

* improvement: emcn, settings

* improvement: settings-modal, emcn

* improvement: SSO, light-mode

* improvement: EMCN, light

* fix issues, run lint

* fix: reverted mock data
2025-12-03 16:31:27 -08:00
Waleed
e157ce5fbc v0.5.16: MCP fixes, code refactors, jira fixes, new mistral models 2025-12-02 22:02:11 -08:00
Vikhyath Mondreti
7de721e090 fix(logs): logging with error issues for model costs (#2169)
* fix(async-execution): restore async executions

* fix schedules trace span collection'

* fix execution trace spans for schedules + cost tracking when workflow errors
2025-12-02 20:54:17 -08:00
Waleed
3e83fb398c fix(trace-spans): fix input/output token count in trace spans (#2168) 2025-12-02 20:36:16 -08:00
Waleed
a6e3c92c10 fix(jira): fixed incorrect dependsOn for jira project/issue subblcks (#2167) 2025-12-02 20:18:01 -08:00
Vikhyath Mondreti
9670d96eca fix(templates-page): loading issue due to loading extensive workflow block in preview for all listings (#2166)
* fix(templates-page): loading issue due to loading extensive workflow block in preview for all listings

* add more properties
2025-12-02 19:47:48 -08:00
Waleed
eb0d4cbd57 fix(templates): fixed verified creator status displaying & tooltip on templates (#2165) 2025-12-02 19:23:35 -08:00
Waleed
ffd12e1da4 fix(subblocks): update guardrails pii selector component to use emcn (#2164) 2025-12-02 18:36:34 -08:00
Waleed
84c2335a37 feat(i18n): update translations (#2163)
Co-authored-by: waleedlatif1 <waleedlatif1@users.noreply.github.com>
2025-12-02 16:37:30 -08:00
Waleed
2ab8cec8c3 fix(icons): fix mailgun, restore tts and smtp blocks (#2162)
* fix(icons): fix mailgun

* register smtp block that was missing
2025-12-02 16:21:43 -08:00
Waleed
bf54c88ae4 feat(models): added xai models and updated gemini pricing (#2161) 2025-12-02 14:31:23 -08:00
Waleed
41c068c023 improvement(lib): refactored lib/ to be more aligned with queries and api directory (#2160)
* fix(lib): consolidate into core dir in lib/

* refactored lib/
2025-12-02 14:17:41 -08:00
Waleed
6fda9bd72e feat(models): added latest mistral models (#2159) 2025-12-02 13:46:00 -08:00
Waleed
3b4f227e43 fix(mcp): reuse sessionID for consecutive MCP tool calls, fix dynamic args clearing, fix refreshing tools on save (#2158)
* fix(mcp): reuse sessionID for consecutive MCP tool calls, fix dynamic args clearing, fix refreshing tools on save

* prevent defaults

* fix subblock text area

* added placeholders in tool-inp for mcp dynamic args

* ack PR comments
2025-12-02 12:37:59 -08:00
Siddharth Ganesan
0ae7eb197a improvement(agent): switch default model to claude 4.5 sonnet (#2156)
* Switch default model to claude 4.5 sonnet

* Fix defaults

* Switch back to medium
2025-12-01 18:34:46 -08:00
Waleed
304b5d9c7e feat(i18n): update translations (#2153)
* feat(i18n): update translations

* fix build

---------

Co-authored-by: waleedlatif1 <waleedlatif1@users.noreply.github.com>
2025-12-01 15:15:13 -08:00
Waleed
ee3e1e8cf9 fix(docs): update docs to background instead of backgroundColor (#2154) 2025-12-01 14:16:23 -08:00
Vikhyath Mondreti
774e5d585c v0.5.15: add tools, revert subblock prop change 2025-12-01 13:52:12 -08:00
Vikhyath Mondreti
ede41af674 fix(selector): remove subblock state prop for subblock component (#2151) 2025-12-01 13:46:32 -08:00
Waleed
cb0c55c6f6 feat(tools): added rds, dynamodb, background color gradient (#2150)
* feat(tools): added rds tools/block

* feat(tools): added rds, dynamodb, background color gradient

* changed conditions for WHERE condition to be json conditions instead of raw string
2025-12-01 13:42:05 -08:00
Vikhyath Mondreti
54cc93743f v0.5.14: fix issue with teams, google selectors + cleanup code 2025-12-01 12:39:39 -08:00
Vikhyath Mondreti
d22b21c8d1 improvement(selectors): make serviceId sole source of truth (#2128)
* improvement(serviceId): make serviceId sole source of truth

* incorrect gmail service id

* fix teams selectors

* fix linkedin
2025-12-01 12:33:26 -08:00
1278 changed files with 85996 additions and 13392 deletions

View File

@@ -8,7 +8,7 @@ ENSURE that you use the logger.info and logger.warn and logger.error instead of
## Comments
You must use TSDOC for comments. Do not use ==== for comments to separate sections.
You must use TSDOC for comments. Do not use ==== for comments to separate sections. Do not leave any comments that are not TSDOC.
## Globals styles

View File

@@ -1,4 +1,4 @@
FROM oven/bun:1.2.22-alpine
FROM oven/bun:1.3.3-alpine
# Install necessary packages for development
RUN apk add --no-cache \

View File

@@ -17,7 +17,7 @@ jobs:
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
bun-version: 1.2.22
bun-version: 1.3.3
- name: Setup Node
uses: actions/setup-node@v4

View File

@@ -26,7 +26,7 @@ jobs:
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
bun-version: 1.2.22
bun-version: 1.3.3
- name: Cache Bun dependencies
uses: actions/cache@v4
@@ -126,7 +126,7 @@ jobs:
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
bun-version: 1.2.22
bun-version: 1.3.3
- name: Cache Bun dependencies
uses: actions/cache@v4

View File

@@ -16,7 +16,7 @@ jobs:
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
bun-version: 1.2.22
bun-version: 1.3.3
- name: Cache Bun dependencies
uses: actions/cache@v4

View File

@@ -16,7 +16,7 @@ jobs:
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
bun-version: 1.2.22
bun-version: 1.3.3
- name: Setup Node.js for npm publishing
uses: actions/setup-node@v4

View File

@@ -16,7 +16,7 @@ jobs:
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
bun-version: 1.2.22
bun-version: 1.3.3
- name: Setup Node.js for npm publishing
uses: actions/setup-node@v4

View File

@@ -16,7 +16,7 @@ jobs:
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
bun-version: 1.2.22
bun-version: 1.3.3
- name: Setup Node
uses: actions/setup-node@v4

File diff suppressed because one or more lines are too long

View File

@@ -24,7 +24,7 @@ export function BlockInfoCard({
<div className='flex items-center justify-center p-6'>
<div
className='flex h-20 w-20 items-center justify-center rounded-lg'
style={{ backgroundColor: color }}
style={{ background: color }}
>
{ResolvedIcon ? (
<ResolvedIcon className='h-10 w-10 text-white' />

View File

@@ -4,6 +4,7 @@
import type { ComponentType, SVGProps } from 'react'
import {
AhrefsIcon,
AirtableIcon,
ApifyIcon,
ApolloIcon,
@@ -14,13 +15,18 @@ import {
CalendlyIcon,
ClayIcon,
ConfluenceIcon,
DatadogIcon,
DiscordIcon,
DocumentIcon,
DropboxIcon,
DynamoDBIcon,
ElasticsearchIcon,
ElevenLabsIcon,
ExaAIIcon,
EyeIcon,
FirecrawlIcon,
GithubIcon,
GitLabIcon,
GmailIcon,
GoogleCalendarIcon,
GoogleDocsIcon,
@@ -29,6 +35,7 @@ import {
GoogleIcon,
GoogleSheetsIcon,
GoogleVaultIcon,
GrafanaIcon,
HubspotIcon,
HuggingFaceIcon,
HunterIOIcon,
@@ -37,6 +44,7 @@ import {
IntercomIcon,
JinaAIIcon,
JiraIcon,
KalshiIcon,
LinearIcon,
LinkedInIcon,
LinkupIcon,
@@ -60,10 +68,12 @@ import {
PerplexityIcon,
PineconeIcon,
PipedriveIcon,
PolymarketIcon,
PostgresIcon,
PosthogIcon,
PylonIcon,
QdrantIcon,
RDSIcon,
RedditIcon,
ResendIcon,
S3Icon,
@@ -72,8 +82,10 @@ import {
SendgridIcon,
SentryIcon,
SerperIcon,
ShopifyIcon,
SlackIcon,
SmtpIcon,
SshIcon,
STTIcon,
StagehandIcon,
StripeIcon,
@@ -90,19 +102,23 @@ import {
WebflowIcon,
WhatsAppIcon,
WikipediaIcon,
WordpressIcon,
xIcon,
YouTubeIcon,
ZendeskIcon,
ZepIcon,
ZoomIcon,
} from '@/components/icons'
type IconComponent = ComponentType<SVGProps<SVGSVGElement>>
export const blockTypeToIconMap: Record<string, IconComponent> = {
zoom: ZoomIcon,
zep: ZepIcon,
zendesk: ZendeskIcon,
youtube: YouTubeIcon,
x: xIcon,
wordpress: WordpressIcon,
wikipedia: WikipediaIcon,
whatsapp: WhatsAppIcon,
webflow: WebflowIcon,
@@ -123,8 +139,10 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
stripe: StripeIcon,
stagehand_agent: StagehandIcon,
stagehand: StagehandIcon,
ssh: SshIcon,
smtp: SmtpIcon,
slack: SlackIcon,
shopify: ShopifyIcon,
sharepoint: MicrosoftSharepointIcon,
serper: SerperIcon,
sentry: SentryIcon,
@@ -134,10 +152,12 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
s3: S3Icon,
resend: ResendIcon,
reddit: RedditIcon,
rds: RDSIcon,
qdrant: QdrantIcon,
pylon: PylonIcon,
posthog: PosthogIcon,
postgresql: PostgresIcon,
polymarket: PolymarketIcon,
pipedrive: PipedriveIcon,
pinecone: PineconeIcon,
perplexity: PerplexityIcon,
@@ -161,6 +181,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
linkedin: LinkedInIcon,
linear: LinearIcon,
knowledge: PackageSearchIcon,
kalshi: KalshiIcon,
jira: JiraIcon,
jina: JinaAIIcon,
intercom: IntercomIcon,
@@ -169,6 +190,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
hunter: HunterIOIcon,
huggingface: HuggingFaceIcon,
hubspot: HubspotIcon,
grafana: GrafanaIcon,
google_vault: GoogleVaultIcon,
google_sheets: GoogleSheetsIcon,
google_forms: GoogleFormsIcon,
@@ -177,12 +199,17 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
google_calendar: GoogleCalendarIcon,
google_search: GoogleIcon,
gmail: GmailIcon,
gitlab: GitLabIcon,
github: GithubIcon,
firecrawl: FirecrawlIcon,
file: DocumentIcon,
exa: ExaAIIcon,
elevenlabs: ElevenLabsIcon,
elasticsearch: ElasticsearchIcon,
dynamodb: DynamoDBIcon,
dropbox: DropboxIcon,
discord: DiscordIcon,
datadog: DatadogIcon,
confluence: ConfluenceIcon,
clay: ClayIcon,
calendly: CalendlyIcon,
@@ -192,4 +219,5 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
apollo: ApolloIcon,
apify: ApifyIcon,
airtable: AirtableIcon,
ahrefs: AhrefsIcon,
}

View File

@@ -0,0 +1,199 @@
---
title: Ahrefs
description: SEO-Analyse mit Ahrefs
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="ahrefs"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -0,0 +1,302 @@
---
title: Datadog
description: Überwachen Sie Infrastruktur, Anwendungen und Logs mit Datadog
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="datadog"
color="#632CA6"
/>
{/* 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`

View File

@@ -0,0 +1,219 @@
---
title: Dropbox
description: Dateien in Dropbox hochladen, herunterladen, teilen und verwalten
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="dropbox"
color="#0061FF"
/>
{/* 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`

View File

@@ -0,0 +1,188 @@
---
title: Amazon DynamoDB
description: Verbindung zu Amazon DynamoDB
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="dynamodb"
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}
[Amazon DynamoDB](https://aws.amazon.com/dynamodb/) ist ein vollständig verwalteter NoSQL-Datenbankdienst von AWS, der schnelle und vorhersehbare Leistung mit nahtloser Skalierbarkeit bietet. Mit DynamoDB können Sie beliebige Datenmengen speichern und abrufen und jede Art von Anforderungsverkehr bedienen, ohne dass Sie Hardware oder Infrastruktur verwalten müssen.
Mit DynamoDB können Sie:
- **Elemente abrufen**: Elemente in Ihren Tabellen mithilfe von Primärschlüsseln nachschlagen
- **Elemente einfügen**: Elemente in Ihren Tabellen hinzufügen oder ersetzen
- **Elemente abfragen**: Mehrere Elemente mithilfe von Abfragen über Indizes abrufen
- **Tabellen scannen**: Alle oder einen Teil der Daten in einer Tabelle lesen
- **Elemente aktualisieren**: Bestimmte Attribute vorhandener Elemente ändern
- **Elemente löschen**: Datensätze aus Ihren Tabellen entfernen
In Sim ermöglicht die DynamoDB-Integration Ihren Agenten den sicheren Zugriff auf DynamoDB-Tabellen und deren Manipulation mithilfe von AWS-Anmeldeinformationen. Zu den unterstützten Operationen gehören:
- **Get**: Ein Element anhand seines Schlüssels abrufen
- **Put**: Elemente einfügen oder überschreiben
- **Query**: Abfragen mit Schlüsselbedingungen und Filtern ausführen
- **Scan**: Mehrere Elemente durch Scannen der Tabelle oder des Index lesen
- **Update**: Bestimmte Attribute eines oder mehrerer Elemente ändern
- **Delete**: Ein Element aus einer Tabelle entfernen
Diese Integration ermöglicht es Sim-Agenten, Datenverwaltungsaufgaben innerhalb Ihrer DynamoDB-Tabellen programmatisch zu automatisieren, sodass Sie Workflows erstellen können, die skalierbare NoSQL-Daten ohne manuellen Aufwand oder Serververwaltung verwalten, ändern und abrufen.
{/* MANUAL-CONTENT-END */}
## Nutzungsanweisungen
Integrieren Sie Amazon DynamoDB in Workflows. Unterstützt Get-, Put-, Query-, Scan-, Update- und Delete-Operationen auf DynamoDB-Tabellen.
## Tools
### `dynamodb_get`
Ein Element aus einer DynamoDB-Tabelle anhand des Primärschlüssels abrufen
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
| `tableName` | string | Ja | DynamoDB-Tabellenname |
| `key` | object | Ja | Primärschlüssel des abzurufenden Elements |
| `consistentRead` | boolean | Nein | Stark konsistentes Lesen verwenden |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `item` | object | Abgerufenes Element |
### `dynamodb_put`
Ein Element in eine DynamoDB-Tabelle einfügen
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
| `tableName` | string | Ja | DynamoDB-Tabellenname |
| `item` | object | Ja | Element, das in die Tabelle eingefügt werden soll |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `item` | object | Erstelltes Element |
### `dynamodb_query`
Abfrage von Elementen aus einer DynamoDB-Tabelle mit Schlüsselbedingungen
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
| `tableName` | string | Ja | DynamoDB-Tabellenname |
| `keyConditionExpression` | string | Ja | Schlüsselbedingungsausdruck (z.B. "pk = :pk") |
| `filterExpression` | string | Nein | Filterausdruck für Ergebnisse |
| `expressionAttributeNames` | object | Nein | Attributnamenzuordnungen für reservierte Wörter |
| `expressionAttributeValues` | object | Nein | Ausdrucksattributwerte |
| `indexName` | string | Nein | Name des sekundären Index für die Abfrage |
| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Elemente |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `items` | array | Array der zurückgegebenen Elemente |
| `count` | number | Anzahl der zurückgegebenen Elemente |
### `dynamodb_scan`
Alle Elemente in einer DynamoDB-Tabelle scannen
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
| `tableName` | string | Ja | DynamoDB-Tabellenname |
| `filterExpression` | string | Nein | Filterausdruck für Ergebnisse |
| `projectionExpression` | string | Nein | Abzurufende Attribute |
| `expressionAttributeNames` | object | Nein | Attributnamenzuordnungen für reservierte Wörter |
| `expressionAttributeValues` | object | Nein | Ausdrucksattributwerte |
| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Elemente |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `items` | array | Array der zurückgegebenen Elemente |
| `count` | number | Anzahl der zurückgegebenen Elemente |
### `dynamodb_update`
Ein Element in einer DynamoDB-Tabelle aktualisieren
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
| `tableName` | string | Ja | Name der DynamoDB-Tabelle |
| `key` | object | Ja | Primärschlüssel des zu aktualisierenden Elements |
| `updateExpression` | string | Ja | Aktualisierungsausdruck (z.B. "SET #name = :name") |
| `expressionAttributeNames` | object | Nein | Attributnamenzuordnungen für reservierte Wörter |
| `expressionAttributeValues` | object | Nein | Ausdrucksattributwerte |
| `conditionExpression` | string | Nein | Bedingung, die erfüllt sein muss, damit die Aktualisierung erfolgreich ist |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `item` | object | Aktualisiertes Element |
### `dynamodb_delete`
Ein Element aus einer DynamoDB-Tabelle löschen
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
| `tableName` | string | Ja | Name der DynamoDB-Tabelle |
| `key` | object | Ja | Primärschlüssel des zu löschenden Elements |
| `conditionExpression` | string | Nein | Bedingung, die erfüllt sein muss, damit das Löschen erfolgreich ist |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
## Hinweise
- Kategorie: `tools`
- Typ: `dynamodb`

View File

@@ -0,0 +1,365 @@
---
title: Elasticsearch
description: Suchen, indexieren und verwalten Sie Daten in Elasticsearch
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="elasticsearch"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -0,0 +1,429 @@
---
title: GitLab
description: Interagiere mit GitLab-Projekten, Issues, Merge Requests und Pipelines
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="gitlab"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -0,0 +1,494 @@
---
title: Grafana
description: Interagiere mit Grafana-Dashboards, Alarmen und Anmerkungen
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="grafana"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -0,0 +1,295 @@
---
title: Kalshi
description: Zugriff auf Prognosemarktdaten von Kalshi
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="kalshi"
color="#09C285"
/>
{/* 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`

View File

@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="mailgun"
color="#F06248"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}

View File

@@ -0,0 +1,352 @@
---
title: Polymarket
description: Zugriff auf Prognosemarktdaten von Polymarket
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="polymarket"
color="#4C82FB"
/>
{/* 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`

View File

@@ -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

View File

@@ -0,0 +1,168 @@
---
title: Amazon RDS
description: Verbindung zu Amazon RDS über Data API
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="rds"
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}
[Amazon RDS Aurora Serverless](https://aws.amazon.com/rds/aurora/serverless/) ist eine vollständig verwaltete relationale Datenbank, die automatisch startet, herunterfährt und ihre Kapazität basierend auf den Anforderungen Ihrer Anwendung skaliert. Sie ermöglicht es Ihnen, SQL-Datenbanken in der Cloud zu betreiben, ohne Datenbankserver verwalten zu müssen.
Mit RDS Aurora Serverless können Sie:
- **Daten abfragen**: Flexible SQL-Abfragen über Ihre Tabellen ausführen
- **Neue Datensätze einfügen**: Automatisch Daten zu Ihrer Datenbank hinzufügen
- **Bestehende Datensätze aktualisieren**: Daten in Ihren Tabellen mit benutzerdefinierten Filtern ändern
- **Datensätze löschen**: Unerwünschte Daten mit präzisen Kriterien entfernen
- **Raw-SQL ausführen**: Jeden gültigen SQL-Befehl ausführen, der von Aurora unterstützt wird
In Sim ermöglicht die RDS-Integration Ihren Agenten, sicher und programmatisch mit Amazon Aurora Serverless-Datenbanken zu arbeiten. Zu den unterstützten Operationen gehören:
- **Abfrage**: SELECT und andere SQL-Abfragen ausführen, um Zeilen aus Ihrer Datenbank abzurufen
- **Einfügen**: Neue Datensätze mit strukturierten Daten in Tabellen einfügen
- **Aktualisieren**: Daten in Zeilen ändern, die Ihren angegebenen Bedingungen entsprechen
- **Löschen**: Datensätze aus einer Tabelle nach benutzerdefinierten Filtern oder Kriterien entfernen
- **Ausführen**: Raw-SQL für fortgeschrittene Szenarien ausführen
Diese Integration ermöglicht es Ihren Agenten, eine breite Palette von Datenbankoperationen ohne manuelle Eingriffe zu automatisieren. Durch die Verbindung von Sim mit Amazon RDS können Sie Agenten erstellen, die relationale Daten innerhalb Ihrer Workflows verwalten, aktualisieren und abrufen alles ohne Datenbankinfrastruktur oder -verbindungen zu verwalten.
{/* MANUAL-CONTENT-END */}
## Nutzungsanweisungen
Integrieren Sie Amazon RDS Aurora Serverless in den Workflow mit der Data API. Kann Daten abfragen, einfügen, aktualisieren, löschen und Raw-SQL ausführen, ohne Datenbankverbindungen verwalten zu müssen.
## Tools
### `rds_query`
Führen Sie eine SELECT-Abfrage auf Amazon RDS mit der Data API aus
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
| `resourceArn` | string | Ja | ARN des Aurora-DB-Clusters |
| `secretArn` | string | Ja | ARN des Secrets Manager-Geheimnisses mit DB-Anmeldedaten |
| `database` | string | Nein | Datenbankname (optional) |
| `query` | string | Ja | SQL-SELECT-Abfrage zur Ausführung |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `rows` | array | Array der zurückgegebenen Zeilen aus der Abfrage |
| `rowCount` | number | Anzahl der zurückgegebenen Zeilen |
### `rds_insert`
Daten in eine Amazon RDS-Tabelle mit der Data API einfügen
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
| `resourceArn` | string | Ja | ARN des Aurora-DB-Clusters |
| `secretArn` | string | Ja | ARN des Secrets Manager-Geheimnisses mit DB-Anmeldedaten |
| `database` | string | Nein | Datenbankname (optional) |
| `table` | string | Ja | Tabellenname zum Einfügen |
| `data` | object | Ja | Einzufügende Daten als Schlüssel-Wert-Paare |
#### Output
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `rows` | array | Array der eingefügten Zeilen |
| `rowCount` | number | Anzahl der eingefügten Zeilen |
### `rds_update`
Daten in einer Amazon RDS-Tabelle über die Data API aktualisieren
#### Input
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
| `resourceArn` | string | Ja | ARN des Aurora-DB-Clusters |
| `secretArn` | string | Ja | ARN des Secrets Manager-Geheimnisses mit DB-Anmeldedaten |
| `database` | string | Nein | Datenbankname (optional) |
| `table` | string | Ja | Name der zu aktualisierenden Tabelle |
| `data` | object | Ja | Zu aktualisierende Daten als Schlüssel-Wert-Paare |
| `conditions` | object | Ja | Bedingungen für die Aktualisierung (z.B. `{"id": 1}`) |
#### Output
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `rows` | array | Array der aktualisierten Zeilen |
| `rowCount` | number | Anzahl der aktualisierten Zeilen |
### `rds_delete`
Daten aus einer Amazon RDS-Tabelle über die Data API löschen
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
| `secretAccessKey` | string | Ja | AWS geheimer Zugriffsschlüssel |
| `resourceArn` | string | Ja | ARN des Aurora-DB-Clusters |
| `secretArn` | string | Ja | ARN des Secrets Manager-Geheimnisses mit DB-Anmeldedaten |
| `database` | string | Nein | Datenbankname (optional) |
| `table` | string | Ja | Tabellenname, aus dem gelöscht werden soll |
| `conditions` | object | Ja | Bedingungen für das Löschen (z.B. `{"id": 1}`) |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `rows` | array | Array der gelöschten Zeilen |
| `rowCount` | number | Anzahl der gelöschten Zeilen |
### `rds_execute`
Rohes SQL auf Amazon RDS über die Data API ausführen
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
| `secretAccessKey` | string | Ja | AWS geheimer Zugriffsschlüssel |
| `resourceArn` | string | Ja | ARN des Aurora-DB-Clusters |
| `secretArn` | string | Ja | ARN des Secrets Manager-Geheimnisses mit DB-Anmeldedaten |
| `database` | string | Nein | Datenbankname (optional) |
| `query` | string | Ja | Rohe SQL-Abfrage zur Ausführung |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `rows` | array | Array der zurückgegebenen oder betroffenen Zeilen |
| `rowCount` | number | Anzahl der betroffenen Zeilen |
## Hinweise
- Kategorie: `tools`
- Typ: `rds`

View File

@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="s3"
color="#E0E0E0"
color="linear-gradient(45deg, #1B660F 0%, #6CAE3E 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}

View File

@@ -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"
<BlockInfoCard
type="shopify"
color="#FFFFFF"
/>
{/* 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`

View File

@@ -0,0 +1,394 @@
---
title: SSH
description: Verbindung zu Remote-Servern über SSH herstellen
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="ssh"
color="#000000"
/>
{/* 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`

View File

@@ -0,0 +1,566 @@
---
title: WordPress
description: WordPress-Inhalte verwalten
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="wordpress"
color="#21759B"
/>
{/* 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`

View File

@@ -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

View File

@@ -0,0 +1,250 @@
---
title: Zoom
description: Zoom-Meetings und -Aufzeichnungen erstellen und verwalten
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="zoom"
color="#2D8CFF"
/>
{/* 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`

View File

@@ -0,0 +1,204 @@
---
title: Ahrefs
description: SEO analysis with Ahrefs
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="ahrefs"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
[Ahrefs](https://ahrefs.com/) is a leading SEO toolset for analyzing websites, tracking rankings, monitoring backlinks, and researching keywords. It provides detailed insights into your own website as well as your competitors, helping you make data-driven decisions to improve your search visibility.
With the Ahrefs integration in Sim, you can:
- **Analyze Domain Rating & Authority**: Instantly check the Domain Rating (DR) and Ahrefs Rank of any website to gauge its authority.
- **Fetch Backlinks**: Retrieve a list of backlinks pointing to a site or specific URL, with details like anchor text, referring page DR, and more.
- **Get Backlink Statistics**: Access metrics on backlink types (dofollow, nofollow, text, image, redirect, etc.) for a domain or URL.
- **Explore Organic Keywords** *(planned)*: View keywords a domain ranks for and their positions in Google search results.
- **Discover Top Pages** *(planned)*: Identify the highest-performing pages by organic traffic and links.
These tools let your agents automate SEO research, monitor competitors, and generate reports—all as part of your workflow automations. To use the Ahrefs integration, youll need an Ahrefs Enterprise subscription with API access.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Ahrefs SEO tools into your workflow. Analyze domain ratings, backlinks, organic keywords, top pages, and more. Requires an Ahrefs Enterprise plan with API access.
## Tools
### `ahrefs_domain_rating`
Get the Domain Rating (DR) and Ahrefs Rank for a target domain. Domain Rating shows the strength of a website
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `target` | string | Yes | The target domain to analyze \(e.g., example.com\) |
| `date` | string | No | Date for historical data in YYYY-MM-DD format \(defaults to today\) |
| `apiKey` | string | Yes | Ahrefs API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `domainRating` | number | Domain Rating score \(0-100\) |
| `ahrefsRank` | number | Ahrefs Rank - global ranking based on backlink profile strength |
### `ahrefs_backlinks`
Get a list of backlinks pointing to a target domain or URL. Returns details about each backlink including source URL, anchor text, and domain rating.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `target` | string | Yes | The target domain or URL to analyze |
| `mode` | string | No | Analysis mode: domain \(entire domain\), prefix \(URL prefix\), subdomains \(include all subdomains\), exact \(exact URL match\) |
| `date` | string | No | Date for historical data in YYYY-MM-DD format \(defaults to today\) |
| `limit` | number | No | Maximum number of results to return \(default: 100\) |
| `offset` | number | No | Number of results to skip for pagination |
| `apiKey` | string | Yes | Ahrefs API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `backlinks` | array | List of backlinks pointing to the target |
### `ahrefs_backlinks_stats`
Get backlink statistics for a target domain or URL. Returns totals for different backlink types including dofollow, nofollow, text, image, and redirect links.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `target` | string | Yes | The target domain or URL to analyze |
| `mode` | string | No | Analysis mode: domain \(entire domain\), prefix \(URL prefix\), subdomains \(include all subdomains\), exact \(exact URL match\) |
| `date` | string | No | Date for historical data in YYYY-MM-DD format \(defaults to today\) |
| `apiKey` | string | Yes | Ahrefs API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `stats` | object | Backlink statistics summary |
### `ahrefs_referring_domains`
Get a list of domains that link to a target domain or URL. Returns unique referring domains with their domain rating, backlink counts, and discovery dates.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `target` | string | Yes | The target domain or URL to analyze |
| `mode` | string | No | Analysis mode: domain \(entire domain\), prefix \(URL prefix\), subdomains \(include all subdomains\), exact \(exact URL match\) |
| `date` | string | No | Date for historical data in YYYY-MM-DD format \(defaults to today\) |
| `limit` | number | No | Maximum number of results to return \(default: 100\) |
| `offset` | number | No | Number of results to skip for pagination |
| `apiKey` | string | Yes | Ahrefs API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `referringDomains` | array | List of domains linking to the target |
### `ahrefs_organic_keywords`
Get organic keywords that a target domain or URL ranks for in Google search results. Returns keyword details including search volume, ranking position, and estimated traffic.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `target` | string | Yes | The target domain or URL to analyze |
| `country` | string | No | Country code for search results \(e.g., us, gb, de\). Default: us |
| `mode` | string | No | Analysis mode: domain \(entire domain\), prefix \(URL prefix\), subdomains \(include all subdomains\), exact \(exact URL match\) |
| `date` | string | No | Date for historical data in YYYY-MM-DD format \(defaults to today\) |
| `limit` | number | No | Maximum number of results to return \(default: 100\) |
| `offset` | number | No | Number of results to skip for pagination |
| `apiKey` | string | Yes | Ahrefs API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `keywords` | array | List of organic keywords the target ranks for |
### `ahrefs_top_pages`
Get the top pages of a target domain sorted by organic traffic. Returns page URLs with their traffic, keyword counts, and estimated traffic value.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `target` | string | Yes | The target domain to analyze |
| `country` | string | No | Country code for traffic data \(e.g., us, gb, de\). Default: us |
| `mode` | string | No | Analysis mode: domain \(entire domain\), prefix \(URL prefix\), subdomains \(include all subdomains\) |
| `date` | string | No | Date for historical data in YYYY-MM-DD format \(defaults to today\) |
| `limit` | number | No | Maximum number of results to return \(default: 100\) |
| `offset` | number | No | Number of results to skip for pagination |
| `apiKey` | string | Yes | Ahrefs API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `pages` | array | List of top pages by organic traffic |
### `ahrefs_keyword_overview`
Get detailed metrics for a keyword including search volume, keyword difficulty, CPC, clicks, and traffic potential.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `keyword` | string | Yes | The keyword to analyze |
| `country` | string | No | Country code for keyword data \(e.g., us, gb, de\). Default: us |
| `apiKey` | string | Yes | Ahrefs API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `overview` | object | Keyword metrics overview |
### `ahrefs_broken_backlinks`
Get a list of broken backlinks pointing to a target domain or URL. Useful for identifying link reclamation opportunities.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `target` | string | Yes | The target domain or URL to analyze |
| `mode` | string | No | Analysis mode: domain \(entire domain\), prefix \(URL prefix\), subdomains \(include all subdomains\), exact \(exact URL match\) |
| `date` | string | No | Date for historical data in YYYY-MM-DD format \(defaults to today\) |
| `limit` | number | No | Maximum number of results to return \(default: 100\) |
| `offset` | number | No | Number of results to skip for pagination |
| `apiKey` | string | Yes | Ahrefs API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `brokenBacklinks` | array | List of broken backlinks |
## Notes
- Category: `tools`
- Type: `ahrefs`

View File

@@ -0,0 +1,307 @@
---
title: Datadog
description: Monitor infrastructure, applications, and logs with Datadog
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="datadog"
color="#632CA6"
/>
{/* MANUAL-CONTENT-START:intro */}
[Datadog](https://datadoghq.com/) is a comprehensive monitoring and analytics platform for infrastructure, applications, logs, and more. It enables organizations to gain real-time visibility into the health and performance of systems, detect anomalies, and automate incident response.
With Datadog, you can:
- **Monitor metrics**: Collect, visualize, and analyze metrics from servers, cloud services, and custom applications.
- **Query time series data**: Run advanced queries on performance metrics for trend analysis and reporting.
- **Manage monitors and events**: Set up monitors to detect issues, trigger alerts, and create events for observability.
- **Handle downtimes**: Schedule and programmatically manage planned downtimes to suppress alerts during maintenance.
- **Analyze logs and traces** *(with additional setup in Datadog)*: Centralize and inspect logs or distributed traces for deeper troubleshooting.
Sims Datadog integration lets your agents automate these operations and interact with your Datadog account programmatically. Use it to submit custom metrics, query timeseries data, manage monitors, create events, and streamline your monitoring workflows directly within Sim automations.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Datadog monitoring into workflows. Submit metrics, manage monitors, query logs, create events, handle downtimes, and more.
## Tools
### `datadog_submit_metrics`
Submit custom metrics to Datadog. Use for tracking application performance, business metrics, or custom monitoring data.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `series` | string | Yes | JSON array of metric series to submit. Each series should include metric name, type \(gauge/rate/count\), points \(timestamp/value pairs\), and optional tags. |
| `apiKey` | string | Yes | Datadog API key |
| `site` | string | No | Datadog site/region \(default: datadoghq.com\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Whether the metrics were submitted successfully |
| `errors` | array | Any errors that occurred during submission |
### `datadog_query_timeseries`
Query metric timeseries data from Datadog. Use for analyzing trends, creating reports, or retrieving metric values.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `query` | string | Yes | Datadog metrics query \(e.g., "avg:system.cpu.user\{*\}"\) |
| `from` | number | Yes | Start time as Unix timestamp in seconds |
| `to` | number | Yes | End time as Unix timestamp in seconds |
| `apiKey` | string | Yes | Datadog API key |
| `applicationKey` | string | Yes | Datadog Application key |
| `site` | string | No | Datadog site/region \(default: datadoghq.com\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `series` | array | Array of timeseries data with metric name, tags, and data points |
| `status` | string | Query status |
### `datadog_create_event`
Post an event to the Datadog event stream. Use for deployment notifications, alerts, or any significant occurrences.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `title` | string | Yes | Event title |
| `text` | string | Yes | Event body/description. Supports markdown. |
| `alertType` | string | No | Alert type: error, warning, info, success, user_update, recommendation, or snapshot |
| `priority` | string | No | Event priority: normal or low |
| `host` | string | No | Host name to associate with this event |
| `tags` | string | No | Comma-separated list of tags \(e.g., "env:production,service:api"\) |
| `aggregationKey` | string | No | Key to aggregate events together |
| `sourceTypeName` | string | No | Source type name for the event |
| `dateHappened` | number | No | Unix timestamp when the event occurred \(defaults to now\) |
| `apiKey` | string | Yes | Datadog API key |
| `site` | string | No | Datadog site/region \(default: datadoghq.com\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `event` | object | The created event details |
### `datadog_create_monitor`
Create a new monitor/alert in Datadog. Monitors can track metrics, service checks, events, and more.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `name` | string | Yes | Monitor name |
| `type` | string | Yes | Monitor type: metric alert, service check, event alert, process alert, log alert, query alert, composite, synthetics alert, slo alert |
| `query` | string | Yes | Monitor query \(e.g., "avg\(last_5m\):avg:system.cpu.idle\{*\} &lt; 20"\) |
| `message` | string | No | Message to include with notifications. Can include @-mentions and markdown. |
| `tags` | string | No | Comma-separated list of tags |
| `priority` | number | No | Monitor priority \(1-5, where 1 is highest\) |
| `options` | string | No | JSON string of monitor options \(thresholds, notify_no_data, renotify_interval, etc.\) |
| `apiKey` | string | Yes | Datadog API key |
| `applicationKey` | string | Yes | Datadog Application key |
| `site` | string | No | Datadog site/region \(default: datadoghq.com\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `monitor` | object | The created monitor details |
### `datadog_get_monitor`
Retrieve details of a specific monitor by ID.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `monitorId` | string | Yes | The ID of the monitor to retrieve |
| `groupStates` | string | No | Comma-separated group states to include: alert, warn, no data, ok |
| `withDowntimes` | boolean | No | Include downtime data with the monitor |
| `apiKey` | string | Yes | Datadog API key |
| `applicationKey` | string | Yes | Datadog Application key |
| `site` | string | No | Datadog site/region \(default: datadoghq.com\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `monitor` | object | The monitor details |
### `datadog_list_monitors`
List all monitors in Datadog with optional filtering by name, tags, or state.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `groupStates` | string | No | Comma-separated group states to filter by: alert, warn, no data, ok |
| `name` | string | No | Filter monitors by name \(partial match\) |
| `tags` | string | No | Comma-separated list of tags to filter by |
| `monitorTags` | string | No | Comma-separated list of monitor tags to filter by |
| `withDowntimes` | boolean | No | Include downtime data with monitors |
| `page` | number | No | Page number for pagination \(0-indexed\) |
| `pageSize` | number | No | Number of monitors per page \(max 1000\) |
| `apiKey` | string | Yes | Datadog API key |
| `applicationKey` | string | Yes | Datadog Application key |
| `site` | string | No | Datadog site/region \(default: datadoghq.com\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `monitors` | array | List of monitors |
### `datadog_mute_monitor`
Mute a monitor to temporarily suppress notifications.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `monitorId` | string | Yes | The ID of the monitor to mute |
| `scope` | string | No | Scope to mute \(e.g., "host:myhost"\). If not specified, mutes all scopes. |
| `end` | number | No | Unix timestamp when the mute should end. If not specified, mutes indefinitely. |
| `apiKey` | string | Yes | Datadog API key |
| `applicationKey` | string | Yes | Datadog Application key |
| `site` | string | No | Datadog site/region \(default: datadoghq.com\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Whether the monitor was successfully muted |
### `datadog_query_logs`
Search and retrieve logs from Datadog. Use for troubleshooting, analysis, or monitoring.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `query` | string | Yes | Log search query \(e.g., "service:web-app status:error"\) |
| `from` | string | Yes | Start time in ISO-8601 format or relative \(e.g., "now-1h"\) |
| `to` | string | Yes | End time in ISO-8601 format or relative \(e.g., "now"\) |
| `limit` | number | No | Maximum number of logs to return \(default: 50, max: 1000\) |
| `sort` | string | No | Sort order: timestamp \(oldest first\) or -timestamp \(newest first\) |
| `indexes` | string | No | Comma-separated list of log indexes to search |
| `apiKey` | string | Yes | Datadog API key |
| `applicationKey` | string | Yes | Datadog Application key |
| `site` | string | No | Datadog site/region \(default: datadoghq.com\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `logs` | array | List of log entries |
### `datadog_send_logs`
Send log entries to Datadog for centralized logging and analysis.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `logs` | string | Yes | JSON array of log entries. Each entry should have message and optionally ddsource, ddtags, hostname, service. |
| `apiKey` | string | Yes | Datadog API key |
| `site` | string | No | Datadog site/region \(default: datadoghq.com\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Whether the logs were sent successfully |
### `datadog_create_downtime`
Schedule a downtime to suppress monitor notifications during maintenance windows.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `scope` | string | Yes | Scope to apply downtime to \(e.g., "host:myhost", "env:production", or "*" for all\) |
| `message` | string | No | Message to display during downtime |
| `start` | number | No | Unix timestamp for downtime start \(defaults to now\) |
| `end` | number | No | Unix timestamp for downtime end |
| `timezone` | string | No | Timezone for the downtime \(e.g., "America/New_York"\) |
| `monitorId` | string | No | Specific monitor ID to mute |
| `monitorTags` | string | No | Comma-separated monitor tags to match \(e.g., "team:backend,priority:high"\) |
| `muteFirstRecoveryNotification` | boolean | No | Mute the first recovery notification |
| `apiKey` | string | Yes | Datadog API key |
| `applicationKey` | string | Yes | Datadog Application key |
| `site` | string | No | Datadog site/region \(default: datadoghq.com\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `downtime` | object | The created downtime details |
### `datadog_list_downtimes`
List all scheduled downtimes in Datadog.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `currentOnly` | boolean | No | Only return currently active downtimes |
| `monitorId` | string | No | Filter by monitor ID |
| `apiKey` | string | Yes | Datadog API key |
| `applicationKey` | string | Yes | Datadog Application key |
| `site` | string | No | Datadog site/region \(default: datadoghq.com\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `downtimes` | array | List of downtimes |
### `datadog_cancel_downtime`
Cancel a scheduled downtime.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `downtimeId` | string | Yes | The ID of the downtime to cancel |
| `apiKey` | string | Yes | Datadog API key |
| `applicationKey` | string | Yes | Datadog Application key |
| `site` | string | No | Datadog site/region \(default: datadoghq.com\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Whether the downtime was successfully canceled |
## Notes
- Category: `tools`
- Type: `datadog`

View File

@@ -0,0 +1,224 @@
---
title: Dropbox
description: Upload, download, share, and manage files in Dropbox
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="dropbox"
color="#0061FF"
/>
{/* MANUAL-CONTENT-START:intro */}
[Dropbox](https://dropbox.com/) is a popular cloud storage and collaboration platform that enables individuals and teams to securely store, access, and share files from anywhere. Dropbox is designed for easy file management, syncing, and powerful collaboration, whether you're working solo or with a group.
With Dropbox in Sim, you can:
- **Upload and download files**: Seamlessly upload any file to your Dropbox or retrieve content on demand
- **List folder contents**: Browse the files and folders within any Dropbox directory
- **Create new folders**: Organize your files by programmatically creating new folders in your Dropbox
- **Search files and folders**: Locate documents, images, or other items by name or content
- **Generate shared links**: Quickly create shareable public or private links for files and folders
- **Manage files**: Move, delete, or rename files and folders as part of automated workflows
These capabilities allow your Sim agents to automate Dropbox operations directly within your workflows — from backing up important files to distributing content and maintaining organized folders. Use Dropbox as both a source and destination for files, enabling seamless cloud storage management as part of your business processes.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Dropbox into your workflow for file management, sharing, and collaboration. Upload files, download content, create folders, manage shared links, and more.
## Tools
### `dropbox_upload`
Upload a file to Dropbox
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `path` | string | Yes | The path in Dropbox where the file should be saved \(e.g., /folder/document.pdf\) |
| `fileContent` | string | Yes | The base64 encoded content of the file to upload |
| `fileName` | string | No | Optional filename \(used if path is a folder\) |
| `mode` | string | No | Write mode: add \(default\) or overwrite |
| `autorename` | boolean | No | If true, rename the file if there is a conflict |
| `mute` | boolean | No | If true, don't notify the user about this upload |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `file` | object | The uploaded file metadata |
### `dropbox_download`
Download a file from Dropbox and get a temporary link
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `path` | string | Yes | The path of the file to download \(e.g., /folder/document.pdf\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `file` | object | The file metadata |
### `dropbox_list_folder`
List the contents of a folder in Dropbox
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `path` | string | Yes | The path of the folder to list \(use "" for root\) |
| `recursive` | boolean | No | If true, list contents recursively |
| `includeDeleted` | boolean | No | If true, include deleted files/folders |
| `includeMediaInfo` | boolean | No | If true, include media info for photos/videos |
| `limit` | number | No | Maximum number of results to return \(default: 500\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `entries` | array | List of files and folders in the directory |
### `dropbox_create_folder`
Create a new folder in Dropbox
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `path` | string | Yes | The path where the folder should be created \(e.g., /new-folder\) |
| `autorename` | boolean | No | If true, rename the folder if there is a conflict |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `folder` | object | The created folder metadata |
### `dropbox_delete`
Delete a file or folder in Dropbox (moves to trash)
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `path` | string | Yes | The path of the file or folder to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `metadata` | object | Metadata of the deleted item |
### `dropbox_copy`
Copy a file or folder in Dropbox
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `fromPath` | string | Yes | The source path of the file or folder to copy |
| `toPath` | string | Yes | The destination path for the copied file or folder |
| `autorename` | boolean | No | If true, rename the file if there is a conflict at destination |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `metadata` | object | Metadata of the copied item |
### `dropbox_move`
Move or rename a file or folder in Dropbox
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `fromPath` | string | Yes | The source path of the file or folder to move |
| `toPath` | string | Yes | The destination path for the moved file or folder |
| `autorename` | boolean | No | If true, rename the file if there is a conflict at destination |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `metadata` | object | Metadata of the moved item |
### `dropbox_get_metadata`
Get metadata for a file or folder in Dropbox
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `path` | string | Yes | The path of the file or folder to get metadata for |
| `includeMediaInfo` | boolean | No | If true, include media info for photos/videos |
| `includeDeleted` | boolean | No | If true, include deleted files in results |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `metadata` | object | Metadata for the file or folder |
### `dropbox_create_shared_link`
Create a shareable link for a file or folder in Dropbox
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `path` | string | Yes | The path of the file or folder to share |
| `requestedVisibility` | string | No | Visibility: public, team_only, or password |
| `linkPassword` | string | No | Password for the shared link \(only if visibility is password\) |
| `expires` | string | No | Expiration date in ISO 8601 format \(e.g., 2025-12-31T23:59:59Z\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `sharedLink` | object | The created shared link |
### `dropbox_search`
Search for files and folders in Dropbox
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `query` | string | Yes | The search query |
| `path` | string | No | Limit search to a specific folder path |
| `fileExtensions` | string | No | Comma-separated list of file extensions to filter by \(e.g., pdf,xlsx\) |
| `maxResults` | number | No | Maximum number of results to return \(default: 100\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `matches` | array | Search results |
## Notes
- Category: `tools`
- Type: `dropbox`

View File

@@ -0,0 +1,193 @@
---
title: Amazon DynamoDB
description: Connect to Amazon DynamoDB
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="dynamodb"
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}
[Amazon DynamoDB](https://aws.amazon.com/dynamodb/) is a fully managed NoSQL database service offered by AWS that provides fast and predictable performance with seamless scalability. DynamoDB lets you store and retrieve any amount of data and serves any level of request traffic, without the need for you to manage hardware or infrastructure.
With DynamoDB, you can:
- **Get items**: Look up items in your tables using primary keys
- **Put items**: Add or replace items in your tables
- **Query items**: Retrieve multiple items using queries across indexes
- **Scan tables**: Read all or part of the data in a table
- **Update items**: Modify specific attributes of existing items
- **Delete items**: Remove records from your tables
In Sim, the DynamoDB integration enables your agents to securely access and manipulate DynamoDB tables using AWS credentials. Supported operations include:
- **Get**: Retrieve an item by its key
- **Put**: Insert or overwrite items
- **Query**: Run queries using key conditions and filters
- **Scan**: Read multiple items by scanning the table or index
- **Update**: Change specific attributes of one or more items
- **Delete**: Remove an item from a table
This integration empowers Sim agents to automate data management tasks within your DynamoDB tables programmatically, so you can build workflows that manage, modify, and retrieve scalable NoSQL data without manual effort or server management.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Amazon DynamoDB into workflows. Supports Get, Put, Query, Scan, Update, and Delete operations on DynamoDB tables.
## Tools
### `dynamodb_get`
Get an item from a DynamoDB table by primary key
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
| `accessKeyId` | string | Yes | AWS access key ID |
| `secretAccessKey` | string | Yes | AWS secret access key |
| `tableName` | string | Yes | DynamoDB table name |
| `key` | object | Yes | Primary key of the item to retrieve |
| `consistentRead` | boolean | No | Use strongly consistent read |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Operation status message |
| `item` | object | Retrieved item |
### `dynamodb_put`
Put an item into a DynamoDB table
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
| `accessKeyId` | string | Yes | AWS access key ID |
| `secretAccessKey` | string | Yes | AWS secret access key |
| `tableName` | string | Yes | DynamoDB table name |
| `item` | object | Yes | Item to put into the table |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Operation status message |
| `item` | object | Created item |
### `dynamodb_query`
Query items from a DynamoDB table using key conditions
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
| `accessKeyId` | string | Yes | AWS access key ID |
| `secretAccessKey` | string | Yes | AWS secret access key |
| `tableName` | string | Yes | DynamoDB table name |
| `keyConditionExpression` | string | Yes | Key condition expression \(e.g., "pk = :pk"\) |
| `filterExpression` | string | No | Filter expression for results |
| `expressionAttributeNames` | object | No | Attribute name mappings for reserved words |
| `expressionAttributeValues` | object | No | Expression attribute values |
| `indexName` | string | No | Secondary index name to query |
| `limit` | number | No | Maximum number of items to return |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Operation status message |
| `items` | array | Array of items returned |
| `count` | number | Number of items returned |
### `dynamodb_scan`
Scan all items in a DynamoDB table
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
| `accessKeyId` | string | Yes | AWS access key ID |
| `secretAccessKey` | string | Yes | AWS secret access key |
| `tableName` | string | Yes | DynamoDB table name |
| `filterExpression` | string | No | Filter expression for results |
| `projectionExpression` | string | No | Attributes to retrieve |
| `expressionAttributeNames` | object | No | Attribute name mappings for reserved words |
| `expressionAttributeValues` | object | No | Expression attribute values |
| `limit` | number | No | Maximum number of items to return |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Operation status message |
| `items` | array | Array of items returned |
| `count` | number | Number of items returned |
### `dynamodb_update`
Update an item in a DynamoDB table
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
| `accessKeyId` | string | Yes | AWS access key ID |
| `secretAccessKey` | string | Yes | AWS secret access key |
| `tableName` | string | Yes | DynamoDB table name |
| `key` | object | Yes | Primary key of the item to update |
| `updateExpression` | string | Yes | Update expression \(e.g., "SET #name = :name"\) |
| `expressionAttributeNames` | object | No | Attribute name mappings for reserved words |
| `expressionAttributeValues` | object | No | Expression attribute values |
| `conditionExpression` | string | No | Condition that must be met for the update to succeed |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Operation status message |
| `item` | object | Updated item |
### `dynamodb_delete`
Delete an item from a DynamoDB table
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
| `accessKeyId` | string | Yes | AWS access key ID |
| `secretAccessKey` | string | Yes | AWS secret access key |
| `tableName` | string | Yes | DynamoDB table name |
| `key` | object | Yes | Primary key of the item to delete |
| `conditionExpression` | string | No | Condition that must be met for the delete to succeed |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Operation status message |
## Notes
- Category: `tools`
- Type: `dynamodb`

View File

@@ -0,0 +1,370 @@
---
title: Elasticsearch
description: Search, index, and manage data in Elasticsearch
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="elasticsearch"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
[Elasticsearch](https://www.elastic.co/elasticsearch/) is a powerful distributed search and analytics engine that enables you to index, search, and analyze large volumes of data in real time. Its widely used for powering search features, log and event data analytics, observability, and more.
With Elasticsearch in Sim, you gain programmatic access to core Elasticsearch capabilities, including:
- **Search documents**: Perform advanced searches on structured or unstructured text using Query DSL, with support for sorting, pagination, and field selection.
- **Index documents**: Add new documents or update existing ones in any Elasticsearch index for immediate retrieval and analysis.
- **Get, update, or delete documents**: Retrieve, modify, or remove specific documents by ID.
- **Bulk operations**: Execute multiple indexing or update actions in a single request for high-throughput data processing.
- **Manage indexes**: Create, delete, or get details about indexes as part of your workflow automation.
- **Cluster monitoring**: Check the health and stats of your Elasticsearch deployment.
Sim's Elasticsearch tools work with both self-hosted and Elastic Cloud environments. Integrate Elasticsearch into your agent workflows to automate data ingestion, search across vast datasets, run reporting, or build custom search-powered applications all without manual intervention.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Elasticsearch into workflows for powerful search, indexing, and data management. Supports document CRUD operations, advanced search queries, bulk operations, index management, and cluster monitoring. Works with both self-hosted and Elastic Cloud deployments.
## Tools
### `elasticsearch_search`
Search documents in Elasticsearch using Query DSL. Returns matching documents with scores and metadata.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `deploymentType` | string | Yes | Deployment type: self_hosted or cloud |
| `host` | string | No | Elasticsearch host URL \(for self-hosted\) |
| `cloudId` | string | No | Elastic Cloud ID \(for cloud deployments\) |
| `authMethod` | string | Yes | Authentication method: api_key or basic_auth |
| `apiKey` | string | No | Elasticsearch API key |
| `username` | string | No | Username for basic auth |
| `password` | string | No | Password for basic auth |
| `index` | string | Yes | Index name to search |
| `query` | string | No | Query DSL as JSON string |
| `from` | number | No | Starting offset for pagination \(default: 0\) |
| `size` | number | No | Number of results to return \(default: 10\) |
| `sort` | string | No | Sort specification as JSON string |
| `sourceIncludes` | string | No | Comma-separated list of fields to include in _source |
| `sourceExcludes` | string | No | Comma-separated list of fields to exclude from _source |
| `trackTotalHits` | boolean | No | Track accurate total hit count \(default: true\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `took` | number | Time in milliseconds the search took |
| `timed_out` | boolean | Whether the search timed out |
| `hits` | object | Search results with total count and matching documents |
| `aggregations` | json | Aggregation results if any |
### `elasticsearch_index_document`
Index (create or update) a document in Elasticsearch.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `deploymentType` | string | Yes | Deployment type: self_hosted or cloud |
| `host` | string | No | Elasticsearch host URL \(for self-hosted\) |
| `cloudId` | string | No | Elastic Cloud ID \(for cloud deployments\) |
| `authMethod` | string | Yes | Authentication method: api_key or basic_auth |
| `apiKey` | string | No | Elasticsearch API key |
| `username` | string | No | Username for basic auth |
| `password` | string | No | Password for basic auth |
| `index` | string | Yes | Target index name |
| `documentId` | string | No | Document ID \(auto-generated if not provided\) |
| `document` | string | Yes | Document body as JSON string |
| `refresh` | string | No | Refresh policy: true, false, or wait_for |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `_index` | string | Index where the document was stored |
| `_id` | string | Document ID |
| `_version` | number | Document version |
| `result` | string | Operation result \(created or updated\) |
### `elasticsearch_get_document`
Retrieve a document by ID from Elasticsearch.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `deploymentType` | string | Yes | Deployment type: self_hosted or cloud |
| `host` | string | No | Elasticsearch host URL \(for self-hosted\) |
| `cloudId` | string | No | Elastic Cloud ID \(for cloud deployments\) |
| `authMethod` | string | Yes | Authentication method: api_key or basic_auth |
| `apiKey` | string | No | Elasticsearch API key |
| `username` | string | No | Username for basic auth |
| `password` | string | No | Password for basic auth |
| `index` | string | Yes | Index name |
| `documentId` | string | Yes | Document ID to retrieve |
| `sourceIncludes` | string | No | Comma-separated list of fields to include |
| `sourceExcludes` | string | No | Comma-separated list of fields to exclude |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `_index` | string | Index name |
| `_id` | string | Document ID |
| `_version` | number | Document version |
| `found` | boolean | Whether the document was found |
| `_source` | json | Document content |
### `elasticsearch_update_document`
Partially update a document in Elasticsearch using doc merge.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `deploymentType` | string | Yes | Deployment type: self_hosted or cloud |
| `host` | string | No | Elasticsearch host URL \(for self-hosted\) |
| `cloudId` | string | No | Elastic Cloud ID \(for cloud deployments\) |
| `authMethod` | string | Yes | Authentication method: api_key or basic_auth |
| `apiKey` | string | No | Elasticsearch API key |
| `username` | string | No | Username for basic auth |
| `password` | string | No | Password for basic auth |
| `index` | string | Yes | Index name |
| `documentId` | string | Yes | Document ID to update |
| `document` | string | Yes | Partial document to merge as JSON string |
| `retryOnConflict` | number | No | Number of retries on version conflict |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `_index` | string | Index name |
| `_id` | string | Document ID |
| `_version` | number | New document version |
| `result` | string | Operation result \(updated or noop\) |
### `elasticsearch_delete_document`
Delete a document from Elasticsearch by ID.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `deploymentType` | string | Yes | Deployment type: self_hosted or cloud |
| `host` | string | No | Elasticsearch host URL \(for self-hosted\) |
| `cloudId` | string | No | Elastic Cloud ID \(for cloud deployments\) |
| `authMethod` | string | Yes | Authentication method: api_key or basic_auth |
| `apiKey` | string | No | Elasticsearch API key |
| `username` | string | No | Username for basic auth |
| `password` | string | No | Password for basic auth |
| `index` | string | Yes | Index name |
| `documentId` | string | Yes | Document ID to delete |
| `refresh` | string | No | Refresh policy: true, false, or wait_for |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `_index` | string | Index name |
| `_id` | string | Document ID |
| `_version` | number | Document version |
| `result` | string | Operation result \(deleted or not_found\) |
### `elasticsearch_bulk`
Perform multiple index, create, delete, or update operations in a single request for high performance.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `deploymentType` | string | Yes | Deployment type: self_hosted or cloud |
| `host` | string | No | Elasticsearch host URL \(for self-hosted\) |
| `cloudId` | string | No | Elastic Cloud ID \(for cloud deployments\) |
| `authMethod` | string | Yes | Authentication method: api_key or basic_auth |
| `apiKey` | string | No | Elasticsearch API key |
| `username` | string | No | Username for basic auth |
| `password` | string | No | Password for basic auth |
| `index` | string | No | Default index for operations that do not specify one |
| `operations` | string | Yes | Bulk operations as NDJSON string \(newline-delimited JSON\) |
| `refresh` | string | No | Refresh policy: true, false, or wait_for |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `took` | number | Time in milliseconds the bulk operation took |
| `errors` | boolean | Whether any operation had an error |
| `items` | array | Results for each operation |
### `elasticsearch_count`
Count documents matching a query in Elasticsearch.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `deploymentType` | string | Yes | Deployment type: self_hosted or cloud |
| `host` | string | No | Elasticsearch host URL \(for self-hosted\) |
| `cloudId` | string | No | Elastic Cloud ID \(for cloud deployments\) |
| `authMethod` | string | Yes | Authentication method: api_key or basic_auth |
| `apiKey` | string | No | Elasticsearch API key |
| `username` | string | No | Username for basic auth |
| `password` | string | No | Password for basic auth |
| `index` | string | Yes | Index name to count documents in |
| `query` | string | No | Optional query to filter documents \(JSON string\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `count` | number | Number of documents matching the query |
| `_shards` | object | Shard statistics |
### `elasticsearch_create_index`
Create a new index with optional settings and mappings.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `deploymentType` | string | Yes | Deployment type: self_hosted or cloud |
| `host` | string | No | Elasticsearch host URL \(for self-hosted\) |
| `cloudId` | string | No | Elastic Cloud ID \(for cloud deployments\) |
| `authMethod` | string | Yes | Authentication method: api_key or basic_auth |
| `apiKey` | string | No | Elasticsearch API key |
| `username` | string | No | Username for basic auth |
| `password` | string | No | Password for basic auth |
| `index` | string | Yes | Index name to create |
| `settings` | string | No | Index settings as JSON string |
| `mappings` | string | No | Index mappings as JSON string |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `acknowledged` | boolean | Whether the request was acknowledged |
| `shards_acknowledged` | boolean | Whether the shards were acknowledged |
| `index` | string | Created index name |
### `elasticsearch_delete_index`
Delete an index and all its documents. This operation is irreversible.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `deploymentType` | string | Yes | Deployment type: self_hosted or cloud |
| `host` | string | No | Elasticsearch host URL \(for self-hosted\) |
| `cloudId` | string | No | Elastic Cloud ID \(for cloud deployments\) |
| `authMethod` | string | Yes | Authentication method: api_key or basic_auth |
| `apiKey` | string | No | Elasticsearch API key |
| `username` | string | No | Username for basic auth |
| `password` | string | No | Password for basic auth |
| `index` | string | Yes | Index name to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `acknowledged` | boolean | Whether the deletion was acknowledged |
### `elasticsearch_get_index`
Retrieve index information including settings, mappings, and aliases.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `deploymentType` | string | Yes | Deployment type: self_hosted or cloud |
| `host` | string | No | Elasticsearch host URL \(for self-hosted\) |
| `cloudId` | string | No | Elastic Cloud ID \(for cloud deployments\) |
| `authMethod` | string | Yes | Authentication method: api_key or basic_auth |
| `apiKey` | string | No | Elasticsearch API key |
| `username` | string | No | Username for basic auth |
| `password` | string | No | Password for basic auth |
| `index` | string | Yes | Index name to retrieve info for |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `index` | json | Index information including aliases, mappings, and settings |
### `elasticsearch_cluster_health`
Get the health status of the Elasticsearch cluster.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `deploymentType` | string | Yes | Deployment type: self_hosted or cloud |
| `host` | string | No | Elasticsearch host URL \(for self-hosted\) |
| `cloudId` | string | No | Elastic Cloud ID \(for cloud deployments\) |
| `authMethod` | string | Yes | Authentication method: api_key or basic_auth |
| `apiKey` | string | No | Elasticsearch API key |
| `username` | string | No | Username for basic auth |
| `password` | string | No | Password for basic auth |
| `waitForStatus` | string | No | Wait until cluster reaches this status: green, yellow, or red |
| `timeout` | string | No | Timeout for the wait operation \(e.g., 30s, 1m\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `cluster_name` | string | Name of the cluster |
| `status` | string | Cluster health status: green, yellow, or red |
| `number_of_nodes` | number | Total number of nodes in the cluster |
| `number_of_data_nodes` | number | Number of data nodes |
| `active_shards` | number | Number of active shards |
| `unassigned_shards` | number | Number of unassigned shards |
### `elasticsearch_cluster_stats`
Get comprehensive statistics about the Elasticsearch cluster.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `deploymentType` | string | Yes | Deployment type: self_hosted or cloud |
| `host` | string | No | Elasticsearch host URL \(for self-hosted\) |
| `cloudId` | string | No | Elastic Cloud ID \(for cloud deployments\) |
| `authMethod` | string | Yes | Authentication method: api_key or basic_auth |
| `apiKey` | string | No | Elasticsearch API key |
| `username` | string | No | Username for basic auth |
| `password` | string | No | Password for basic auth |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `cluster_name` | string | Name of the cluster |
| `status` | string | Cluster health status |
| `nodes` | object | Node statistics including count and versions |
| `indices` | object | Index statistics including document count and store size |
## Notes
- Category: `tools`
- Type: `elasticsearch`

View File

@@ -0,0 +1,434 @@
---
title: GitLab
description: Interact with GitLab projects, issues, merge requests, and pipelines
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="gitlab"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
[GitLab](https://gitlab.com/) is a comprehensive DevOps platform that allows teams to manage, collaborate on, and automate their software development lifecycle. With GitLab, you can effortlessly handle source code management, CI/CD, reviews, and collaboration in a single application.
With GitLab in Sim, you can:
- **Manage projects and repositories**: List and retrieve your GitLab projects, access details, and organize your repositories
- **Work with issues**: List, create, and comment on issues to track work and collaborate effectively
- **Handle merge requests**: Review, create, and manage merge requests for code changes and peer reviews
- **Automate CI/CD pipelines**: Trigger, monitor, and interact with GitLab pipelines as part of your automation flows
- **Collaborate with comments**: Add comments to issues or merge requests for efficient communication within your team
Using Sims GitLab integration, your agents can programmatically interact with your GitLab projects. Automate project management, issue tracking, code reviews, and pipeline operations seamlessly in your workflows, optimizing your software development process and enhancing collaboration across your team.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate GitLab into the workflow. Can manage projects, issues, merge requests, pipelines, and add comments. Supports all core GitLab DevOps operations.
## Tools
### `gitlab_list_projects`
List GitLab projects accessible to the authenticated user
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `owned` | boolean | No | Limit to projects owned by the current user |
| `membership` | boolean | No | Limit to projects the current user is a member of |
| `search` | string | No | Search projects by name |
| `visibility` | string | No | Filter by visibility \(public, internal, private\) |
| `orderBy` | string | No | Order by field \(id, name, path, created_at, updated_at, last_activity_at\) |
| `sort` | string | No | Sort direction \(asc, desc\) |
| `perPage` | number | No | Number of results per page \(default 20, max 100\) |
| `page` | number | No | Page number for pagination |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `projects` | array | List of GitLab projects |
| `total` | number | Total number of projects |
### `gitlab_get_project`
Get details of a specific GitLab project
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path \(e.g., "namespace/project"\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `project` | object | The GitLab project details |
### `gitlab_list_issues`
List issues in a GitLab project
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `state` | string | No | Filter by state \(opened, closed, all\) |
| `labels` | string | No | Comma-separated list of label names |
| `assigneeId` | number | No | Filter by assignee user ID |
| `milestoneTitle` | string | No | Filter by milestone title |
| `search` | string | No | Search issues by title and description |
| `orderBy` | string | No | Order by field \(created_at, updated_at\) |
| `sort` | string | No | Sort direction \(asc, desc\) |
| `perPage` | number | No | Number of results per page \(default 20, max 100\) |
| `page` | number | No | Page number for pagination |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `issues` | array | List of GitLab issues |
| `total` | number | Total number of issues |
### `gitlab_get_issue`
Get details of a specific GitLab issue
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `issueIid` | number | Yes | Issue number within the project \(the # shown in GitLab UI\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `issue` | object | The GitLab issue details |
### `gitlab_create_issue`
Create a new issue in a GitLab project
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `title` | string | Yes | Issue title |
| `description` | string | No | Issue description \(Markdown supported\) |
| `labels` | string | No | Comma-separated list of label names |
| `assigneeIds` | array | No | Array of user IDs to assign |
| `milestoneId` | number | No | Milestone ID to assign |
| `dueDate` | string | No | Due date in YYYY-MM-DD format |
| `confidential` | boolean | No | Whether the issue is confidential |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `issue` | object | The created GitLab issue |
### `gitlab_update_issue`
Update an existing issue in a GitLab project
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `issueIid` | number | Yes | Issue internal ID \(IID\) |
| `title` | string | No | New issue title |
| `description` | string | No | New issue description \(Markdown supported\) |
| `stateEvent` | string | No | State event \(close or reopen\) |
| `labels` | string | No | Comma-separated list of label names |
| `assigneeIds` | array | No | Array of user IDs to assign |
| `milestoneId` | number | No | Milestone ID to assign |
| `dueDate` | string | No | Due date in YYYY-MM-DD format |
| `confidential` | boolean | No | Whether the issue is confidential |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `issue` | object | The updated GitLab issue |
### `gitlab_delete_issue`
Delete an issue from a GitLab project
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `issueIid` | number | Yes | Issue internal ID \(IID\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Whether the issue was deleted successfully |
### `gitlab_create_issue_note`
Add a comment to a GitLab issue
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `issueIid` | number | Yes | Issue internal ID \(IID\) |
| `body` | string | Yes | Comment body \(Markdown supported\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `note` | object | The created comment |
### `gitlab_list_merge_requests`
List merge requests in a GitLab project
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `state` | string | No | Filter by state \(opened, closed, merged, all\) |
| `labels` | string | No | Comma-separated list of label names |
| `sourceBranch` | string | No | Filter by source branch |
| `targetBranch` | string | No | Filter by target branch |
| `orderBy` | string | No | Order by field \(created_at, updated_at\) |
| `sort` | string | No | Sort direction \(asc, desc\) |
| `perPage` | number | No | Number of results per page \(default 20, max 100\) |
| `page` | number | No | Page number for pagination |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `mergeRequests` | array | List of GitLab merge requests |
| `total` | number | Total number of merge requests |
### `gitlab_get_merge_request`
Get details of a specific GitLab merge request
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `mergeRequestIid` | number | Yes | Merge request internal ID \(IID\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `mergeRequest` | object | The GitLab merge request details |
### `gitlab_create_merge_request`
Create a new merge request in a GitLab project
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `sourceBranch` | string | Yes | Source branch name |
| `targetBranch` | string | Yes | Target branch name |
| `title` | string | Yes | Merge request title |
| `description` | string | No | Merge request description \(Markdown supported\) |
| `labels` | string | No | Comma-separated list of label names |
| `assigneeIds` | array | No | Array of user IDs to assign |
| `milestoneId` | number | No | Milestone ID to assign |
| `removeSourceBranch` | boolean | No | Delete source branch after merge |
| `squash` | boolean | No | Squash commits on merge |
| `draft` | boolean | No | Mark as draft \(work in progress\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `mergeRequest` | object | The created GitLab merge request |
### `gitlab_update_merge_request`
Update an existing merge request in a GitLab project
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `mergeRequestIid` | number | Yes | Merge request internal ID \(IID\) |
| `title` | string | No | New merge request title |
| `description` | string | No | New merge request description |
| `stateEvent` | string | No | State event \(close or reopen\) |
| `labels` | string | No | Comma-separated list of label names |
| `assigneeIds` | array | No | Array of user IDs to assign |
| `milestoneId` | number | No | Milestone ID to assign |
| `targetBranch` | string | No | New target branch |
| `removeSourceBranch` | boolean | No | Delete source branch after merge |
| `squash` | boolean | No | Squash commits on merge |
| `draft` | boolean | No | Mark as draft \(work in progress\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `mergeRequest` | object | The updated GitLab merge request |
### `gitlab_merge_merge_request`
Merge a merge request in a GitLab project
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `mergeRequestIid` | number | Yes | Merge request internal ID \(IID\) |
| `mergeCommitMessage` | string | No | Custom merge commit message |
| `squashCommitMessage` | string | No | Custom squash commit message |
| `squash` | boolean | No | Squash commits before merging |
| `shouldRemoveSourceBranch` | boolean | No | Delete source branch after merge |
| `mergeWhenPipelineSucceeds` | boolean | No | Merge when pipeline succeeds |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `mergeRequest` | object | The merged GitLab merge request |
### `gitlab_create_merge_request_note`
Add a comment to a GitLab merge request
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `mergeRequestIid` | number | Yes | Merge request internal ID \(IID\) |
| `body` | string | Yes | Comment body \(Markdown supported\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `note` | object | The created comment |
### `gitlab_list_pipelines`
List pipelines in a GitLab project
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `ref` | string | No | Filter by ref \(branch or tag\) |
| `status` | string | No | Filter by status \(created, waiting_for_resource, preparing, pending, running, success, failed, canceled, skipped, manual, scheduled\) |
| `orderBy` | string | No | Order by field \(id, status, ref, updated_at, user_id\) |
| `sort` | string | No | Sort direction \(asc, desc\) |
| `perPage` | number | No | Number of results per page \(default 20, max 100\) |
| `page` | number | No | Page number for pagination |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `pipelines` | array | List of GitLab pipelines |
| `total` | number | Total number of pipelines |
### `gitlab_get_pipeline`
Get details of a specific GitLab pipeline
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `pipelineId` | number | Yes | Pipeline ID |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `pipeline` | object | The GitLab pipeline details |
### `gitlab_create_pipeline`
Trigger a new pipeline in a GitLab project
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `ref` | string | Yes | Branch or tag to run the pipeline on |
| `variables` | array | No | Array of variables for the pipeline \(each with key, value, and optional variable_type\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `pipeline` | object | The created GitLab pipeline |
### `gitlab_retry_pipeline`
Retry a failed GitLab pipeline
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `pipelineId` | number | Yes | Pipeline ID |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `pipeline` | object | The retried GitLab pipeline |
### `gitlab_cancel_pipeline`
Cancel a running GitLab pipeline
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Yes | Project ID or URL-encoded path |
| `pipelineId` | number | Yes | Pipeline ID |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `pipeline` | object | The cancelled GitLab pipeline |
## Notes
- Category: `tools`
- Type: `gitlab`

View File

@@ -0,0 +1,499 @@
---
title: Grafana
description: Interact with Grafana dashboards, alerts, and annotations
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="grafana"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
[Grafana](https://grafana.com/) is a leading open-source platform for monitoring, observability, and visualization. It allows users to query, visualize, alert on, and analyze data from a variety of sources, making it an essential tool for infrastructure and application monitoring.
With Grafana, you can:
- **Visualize data**: Build and customize dashboards to display metrics, logs, and traces in real time
- **Monitor health and status**: Check the health of your Grafana instance and connected data sources
- **Manage alerts and annotations**: Set up alert rules, manage notifications, and annotate dashboards with important events
- **Organize content**: Organize dashboards and data sources into folders for better access management
In Sim, the Grafana integration empowers your agents to interact directly with your Grafana instance via API, enabling actions such as:
- Checking the Grafana server, database, and data source health status
- Retrieving, listing, and managing dashboards, alert rules, annotations, data sources, and folders
- Automating the monitoring of your infrastructure by integrating Grafana data and alerts into your workflow automations
These capabilities enable Sim agents to monitor systems, proactively respond to alerts, and help ensure the reliability and visibility of your services — all as part of your automated workflows.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Grafana into workflows. Manage dashboards, alerts, annotations, data sources, folders, and monitor health status.
## Tools
### `grafana_get_dashboard`
Get a dashboard by its UID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `dashboardUid` | string | Yes | The UID of the dashboard to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `dashboard` | json | The full dashboard JSON object |
| `meta` | json | Dashboard metadata \(version, permissions, etc.\) |
### `grafana_list_dashboards`
Search and list all dashboards
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `query` | string | No | Search query to filter dashboards by title |
| `tag` | string | No | Filter by tag \(comma-separated for multiple tags\) |
| `folderIds` | string | No | Filter by folder IDs \(comma-separated\) |
| `starred` | boolean | No | Only return starred dashboards |
| `limit` | number | No | Maximum number of dashboards to return |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `dashboards` | array | List of dashboard search results |
### `grafana_create_dashboard`
Create a new dashboard
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `title` | string | Yes | The title of the new dashboard |
| `folderUid` | string | No | The UID of the folder to create the dashboard in |
| `tags` | string | No | Comma-separated list of tags |
| `timezone` | string | No | Dashboard timezone \(e.g., browser, utc\) |
| `refresh` | string | No | Auto-refresh interval \(e.g., 5s, 1m, 5m\) |
| `panels` | string | No | JSON array of panel configurations |
| `overwrite` | boolean | No | Overwrite existing dashboard with same title |
| `message` | string | No | Commit message for the dashboard version |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `id` | number | The numeric ID of the created dashboard |
| `uid` | string | The UID of the created dashboard |
| `url` | string | The URL path to the dashboard |
| `status` | string | Status of the operation \(success\) |
| `version` | number | The version number of the dashboard |
| `slug` | string | URL-friendly slug of the dashboard |
### `grafana_update_dashboard`
Update an existing dashboard. Fetches the current dashboard and merges your changes.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `dashboardUid` | string | Yes | The UID of the dashboard to update |
| `title` | string | No | New title for the dashboard |
| `folderUid` | string | No | New folder UID to move the dashboard to |
| `tags` | string | No | Comma-separated list of new tags |
| `timezone` | string | No | Dashboard timezone \(e.g., browser, utc\) |
| `refresh` | string | No | Auto-refresh interval \(e.g., 5s, 1m, 5m\) |
| `panels` | string | No | JSON array of panel configurations |
| `overwrite` | boolean | No | Overwrite even if there is a version conflict |
| `message` | string | No | Commit message for this version |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `id` | number | The numeric ID of the updated dashboard |
| `uid` | string | The UID of the updated dashboard |
| `url` | string | The URL path to the dashboard |
| `status` | string | Status of the operation \(success\) |
| `version` | number | The new version number of the dashboard |
| `slug` | string | URL-friendly slug of the dashboard |
### `grafana_delete_dashboard`
Delete a dashboard by its UID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `dashboardUid` | string | Yes | The UID of the dashboard to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `title` | string | The title of the deleted dashboard |
| `message` | string | Confirmation message |
| `id` | number | The ID of the deleted dashboard |
### `grafana_list_alert_rules`
List all alert rules in the Grafana instance
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `rules` | array | List of alert rules |
### `grafana_get_alert_rule`
Get a specific alert rule by its UID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `alertRuleUid` | string | Yes | The UID of the alert rule to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `uid` | string | Alert rule UID |
| `title` | string | Alert rule title |
| `condition` | string | Alert condition |
| `data` | json | Alert rule query data |
| `folderUID` | string | Parent folder UID |
| `ruleGroup` | string | Rule group name |
| `noDataState` | string | State when no data is returned |
| `execErrState` | string | State on execution error |
| `annotations` | json | Alert annotations |
| `labels` | json | Alert labels |
### `grafana_create_alert_rule`
Create a new alert rule
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `title` | string | Yes | The title of the alert rule |
| `folderUid` | string | Yes | The UID of the folder to create the alert in |
| `ruleGroup` | string | Yes | The name of the rule group |
| `condition` | string | Yes | The refId of the query or expression to use as the alert condition |
| `data` | string | Yes | JSON array of query/expression data objects |
| `forDuration` | string | No | Duration to wait before firing \(e.g., 5m, 1h\) |
| `noDataState` | string | No | State when no data is returned \(NoData, Alerting, OK\) |
| `execErrState` | string | No | State on execution error \(Alerting, OK\) |
| `annotations` | string | No | JSON object of annotations |
| `labels` | string | No | JSON object of labels |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `uid` | string | The UID of the created alert rule |
| `title` | string | Alert rule title |
| `folderUID` | string | Parent folder UID |
| `ruleGroup` | string | Rule group name |
### `grafana_update_alert_rule`
Update an existing alert rule. Fetches the current rule and merges your changes.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `alertRuleUid` | string | Yes | The UID of the alert rule to update |
| `title` | string | No | New title for the alert rule |
| `folderUid` | string | No | New folder UID to move the alert to |
| `ruleGroup` | string | No | New rule group name |
| `condition` | string | No | New condition refId |
| `data` | string | No | New JSON array of query/expression data objects |
| `forDuration` | string | No | Duration to wait before firing \(e.g., 5m, 1h\) |
| `noDataState` | string | No | State when no data is returned \(NoData, Alerting, OK\) |
| `execErrState` | string | No | State on execution error \(Alerting, OK\) |
| `annotations` | string | No | JSON object of annotations |
| `labels` | string | No | JSON object of labels |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `uid` | string | The UID of the updated alert rule |
| `title` | string | Alert rule title |
| `folderUID` | string | Parent folder UID |
| `ruleGroup` | string | Rule group name |
### `grafana_delete_alert_rule`
Delete an alert rule by its UID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `alertRuleUid` | string | Yes | The UID of the alert rule to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Confirmation message |
### `grafana_list_contact_points`
List all alert notification contact points
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `contactPoints` | array | List of contact points |
### `grafana_create_annotation`
Create an annotation on a dashboard or as a global annotation
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `text` | string | Yes | The text content of the annotation |
| `tags` | string | No | Comma-separated list of tags |
| `dashboardUid` | string | No | UID of the dashboard to add the annotation to \(optional for global annotations\) |
| `panelId` | number | No | ID of the panel to add the annotation to |
| `time` | number | No | Start time in epoch milliseconds \(defaults to now\) |
| `timeEnd` | number | No | End time in epoch milliseconds \(for range annotations\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `id` | number | The ID of the created annotation |
| `message` | string | Confirmation message |
### `grafana_list_annotations`
Query annotations by time range, dashboard, or tags
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `from` | number | No | Start time in epoch milliseconds |
| `to` | number | No | End time in epoch milliseconds |
| `dashboardUid` | string | No | Filter by dashboard UID |
| `panelId` | number | No | Filter by panel ID |
| `tags` | string | No | Comma-separated list of tags to filter by |
| `type` | string | No | Filter by type \(alert or annotation\) |
| `limit` | number | No | Maximum number of annotations to return |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `annotations` | array | List of annotations |
### `grafana_update_annotation`
Update an existing annotation
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `annotationId` | number | Yes | The ID of the annotation to update |
| `text` | string | Yes | New text content for the annotation |
| `tags` | string | No | Comma-separated list of new tags |
| `time` | number | No | New start time in epoch milliseconds |
| `timeEnd` | number | No | New end time in epoch milliseconds |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `id` | number | The ID of the updated annotation |
| `message` | string | Confirmation message |
### `grafana_delete_annotation`
Delete an annotation by its ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `annotationId` | number | Yes | The ID of the annotation to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Confirmation message |
### `grafana_list_data_sources`
List all data sources configured in Grafana
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `dataSources` | array | List of data sources |
### `grafana_get_data_source`
Get a data source by its ID or UID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `dataSourceId` | string | Yes | The ID or UID of the data source to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `id` | number | Data source ID |
| `uid` | string | Data source UID |
| `name` | string | Data source name |
| `type` | string | Data source type |
| `url` | string | Data source connection URL |
| `database` | string | Database name \(if applicable\) |
| `isDefault` | boolean | Whether this is the default data source |
| `jsonData` | json | Additional data source configuration |
### `grafana_list_folders`
List all folders in Grafana
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `limit` | number | No | Maximum number of folders to return |
| `page` | number | No | Page number for pagination |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `folders` | array | List of folders |
### `grafana_create_folder`
Create a new folder in Grafana
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Grafana Service Account Token |
| `baseUrl` | string | Yes | Grafana instance URL \(e.g., https://your-grafana.com\) |
| `organizationId` | string | No | Organization ID for multi-org Grafana instances |
| `title` | string | Yes | The title of the new folder |
| `uid` | string | No | Optional UID for the folder \(auto-generated if not provided\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `id` | number | The numeric ID of the created folder |
| `uid` | string | The UID of the created folder |
| `title` | string | The title of the created folder |
| `url` | string | The URL path to the folder |
## Notes
- Category: `tools`
- Type: `grafana`

View File

@@ -0,0 +1,300 @@
---
title: Kalshi
description: Access prediction markets data from Kalshi
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="kalshi"
color="#09C285"
/>
{/* MANUAL-CONTENT-START:intro */}
[Kalshi](https://kalshi.com) is a federally regulated exchange where users can trade directly on the outcomes of future events—prediction markets. Kalshis robust API and Sim integration enable agents and workflows to programmatically access all aspects of the platform, supporting everything from research and analytics to automated trading and monitoring.
With Kalshis integration in Sim, you can:
- **Market & Event Data:** Search, filter, and retrieve real-time and historical data for markets and events; fetch granular details on market status, series, event groupings, and more.
- **Account & Balance Management:** Access account balances, available funds, and monitor real-time open positions.
- **Order & Trade Management:** Place new orders, cancel existing ones, view open orders, retrieve a live orderbook, and access complete trade histories.
- **Execution Analysis:** Fetch recent trades, historical fills, and candlestick data for backtesting or market structure research.
- **Monitoring:** Check exchange-wide or series-level status, receive real-time updates about market changes or trading halts, and automate responses.
- **Automation Ready:** Build end-to-end automated agents and dashboards that consume, analyze, and trade on real-world event probabilities.
By using these unified tools and endpoints, you can seamlessly incorporate Kalshis prediction markets, live trading capabilities, and deep event data into your AI-powered applications, dashboards, and workflows—enabling sophisticated, automated decision-making tied to real-world outcomes.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Kalshi prediction markets into the workflow. Can get markets, market, events, event, balance, positions, orders, orderbook, trades, candlesticks, fills, series, and exchange status.
## Tools
### `kalshi_get_markets`
Retrieve a list of prediction markets from Kalshi with optional filtering
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `status` | string | No | Filter by status \(unopened, open, closed, settled\) |
| `seriesTicker` | string | No | Filter by series ticker |
| `eventTicker` | string | No | Filter by event ticker |
| `limit` | string | No | Number of results \(1-1000, default: 100\) |
| `cursor` | string | No | Pagination cursor for next page |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Markets data and metadata |
### `kalshi_get_market`
Retrieve details of a specific prediction market by ticker
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `ticker` | string | Yes | The market ticker \(e.g., "KXBTC-24DEC31"\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Market data and metadata |
### `kalshi_get_events`
Retrieve a list of events from Kalshi with optional filtering
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `status` | string | No | Filter by status \(open, closed, settled\) |
| `seriesTicker` | string | No | Filter by series ticker |
| `withNestedMarkets` | string | No | Include nested markets in response \(true/false\) |
| `limit` | string | No | Number of results \(1-200, default: 200\) |
| `cursor` | string | No | Pagination cursor for next page |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Events data and metadata |
### `kalshi_get_event`
Retrieve details of a specific event by ticker
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `eventTicker` | string | Yes | The event ticker |
| `withNestedMarkets` | string | No | Include nested markets in response \(true/false\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Event data and metadata |
### `kalshi_get_balance`
Retrieve your account balance and portfolio value from Kalshi
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `keyId` | string | Yes | Your Kalshi API Key ID |
| `privateKey` | string | Yes | Your RSA Private Key \(PEM format\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Balance data and metadata |
### `kalshi_get_positions`
Retrieve your open positions from Kalshi
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `keyId` | string | Yes | Your Kalshi API Key ID |
| `privateKey` | string | Yes | Your RSA Private Key \(PEM format\) |
| `ticker` | string | No | Filter by market ticker |
| `eventTicker` | string | No | Filter by event ticker \(max 10 comma-separated\) |
| `settlementStatus` | string | No | Filter by settlement status \(all, unsettled, settled\). Default: unsettled |
| `limit` | string | No | Number of results \(1-1000, default: 100\) |
| `cursor` | string | No | Pagination cursor for next page |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Positions data and metadata |
### `kalshi_get_orders`
Retrieve your orders from Kalshi with optional filtering
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `keyId` | string | Yes | Your Kalshi API Key ID |
| `privateKey` | string | Yes | Your RSA Private Key \(PEM format\) |
| `ticker` | string | No | Filter by market ticker |
| `eventTicker` | string | No | Filter by event ticker \(max 10 comma-separated\) |
| `status` | string | No | Filter by status \(resting, canceled, executed\) |
| `limit` | string | No | Number of results \(1-200, default: 100\) |
| `cursor` | string | No | Pagination cursor for next page |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Orders data and metadata |
### `kalshi_get_orderbook`
Retrieve the orderbook (bids and asks) for a specific market
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `ticker` | string | Yes | Market ticker \(e.g., KXBTC-24DEC31\) |
| `depth` | number | No | Number of price levels to return per side |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Orderbook data and metadata |
### `kalshi_get_trades`
Retrieve recent trades across all markets or for a specific market
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `ticker` | string | No | Filter by market ticker |
| `minTs` | number | No | Minimum timestamp \(Unix milliseconds\) |
| `maxTs` | number | No | Maximum timestamp \(Unix milliseconds\) |
| `limit` | string | No | Number of results \(1-1000, default: 100\) |
| `cursor` | string | No | Pagination cursor for next page |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Trades data and metadata |
### `kalshi_get_candlesticks`
Retrieve OHLC candlestick data for a specific market
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `seriesTicker` | string | Yes | Series ticker |
| `ticker` | string | Yes | Market ticker \(e.g., KXBTC-24DEC31\) |
| `startTs` | number | No | Start timestamp \(Unix milliseconds\) |
| `endTs` | number | No | End timestamp \(Unix milliseconds\) |
| `periodInterval` | number | No | Period interval: 1 \(1min\), 60 \(1hour\), or 1440 \(1day\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Candlestick data and metadata |
### `kalshi_get_fills`
Retrieve your portfolio
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `keyId` | string | Yes | Your Kalshi API Key ID |
| `privateKey` | string | Yes | Your RSA Private Key \(PEM format\) |
| `ticker` | string | No | Filter by market ticker |
| `orderId` | string | No | Filter by order ID |
| `minTs` | number | No | Minimum timestamp \(Unix milliseconds\) |
| `maxTs` | number | No | Maximum timestamp \(Unix milliseconds\) |
| `limit` | string | No | Number of results \(1-1000, default: 100\) |
| `cursor` | string | No | Pagination cursor for next page |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Fills data and metadata |
### `kalshi_get_series_by_ticker`
Retrieve details of a specific market series by ticker
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `seriesTicker` | string | Yes | Series ticker |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Series data and metadata |
### `kalshi_get_exchange_status`
Retrieve the current status of the Kalshi exchange (trading and exchange activity)
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Exchange status data and metadata |
## Notes
- Category: `tools`
- Type: `kalshi`

View File

@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="mailgun"
color="#F06248"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}

View File

@@ -1,6 +1,7 @@
{
"pages": [
"index",
"ahrefs",
"airtable",
"apify",
"apollo",
@@ -10,12 +11,17 @@
"calendly",
"clay",
"confluence",
"datadog",
"discord",
"dropbox",
"dynamodb",
"elasticsearch",
"elevenlabs",
"exa",
"file",
"firecrawl",
"github",
"gitlab",
"gmail",
"google_calendar",
"google_docs",
@@ -24,6 +30,7 @@
"google_search",
"google_sheets",
"google_vault",
"grafana",
"hubspot",
"huggingface",
"hunter",
@@ -32,6 +39,7 @@
"intercom",
"jina",
"jira",
"kalshi",
"knowledge",
"linear",
"linkedin",
@@ -55,10 +63,12 @@
"perplexity",
"pinecone",
"pipedrive",
"polymarket",
"postgresql",
"posthog",
"pylon",
"qdrant",
"rds",
"reddit",
"resend",
"s3",
@@ -68,8 +78,10 @@
"sentry",
"serper",
"sharepoint",
"shopify",
"slack",
"smtp",
"ssh",
"stagehand",
"stagehand_agent",
"stripe",
@@ -90,9 +102,11 @@
"webflow",
"whatsapp",
"wikipedia",
"wordpress",
"x",
"youtube",
"zendesk",
"zep"
"zep",
"zoom"
]
}

View File

@@ -0,0 +1,357 @@
---
title: Polymarket
description: Access prediction markets data from Polymarket
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="polymarket"
color="#4C82FB"
/>
{/* MANUAL-CONTENT-START:intro */}
[Polymarket](https://polymarket.com) is a decentralized prediction markets platform where users can trade on the outcome of future events using blockchain technology. Polymarket provides a comprehensive API, enabling developers and agents to access live market data, event listings, price information, and orderbook statistics to power data-driven workflows and AI automations.
With Polymarkets API and Sim integration, you can enable agents to programmatically retrieve prediction market information, explore open markets and associated events, analyze historical price data, and access orderbooks and market midpoints. This creates new possibilities for research, automated analysis, and developing intelligent agents that react to real-time event probabilities derived from market prices.
Key features of the Polymarket integration include:
- **Market Listing & Filtering:** List all current or historical prediction markets, filter by tag, sort, and paginate through results.
- **Market Detail:** Retrieve details for a single market by market ID or slug, including its outcomes and status.
- **Event Listings:** Access lists of Polymarket events and detailed event information.
- **Orderbook & Price Data:** Analyze the orderbook, get the latest market prices, view the midpoint, or obtain historical price information for any market.
- **Automation Ready:** Build agents or tools that react programmatically to market developments, changing odds, or specific event outcomes.
By using these documented API endpoints, you can seamlessly integrate Polymarkets rich on-chain prediction market data into your own AI workflows, dashboards, research tools, and trading automations.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Polymarket prediction markets into the workflow. Can get markets, market, events, event, tags, series, orderbook, price, midpoint, price history, last trade price, spread, tick size, positions, trades, and search.
## Tools
### `polymarket_get_markets`
Retrieve a list of prediction markets from Polymarket with optional filtering
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `closed` | string | No | Filter by closed status \(true/false\). Use false for active markets only. |
| `order` | string | No | Sort field \(e.g., id, volume, liquidity\) |
| `ascending` | string | No | Sort direction \(true for ascending, false for descending\) |
| `tagId` | string | No | Filter by tag ID |
| `limit` | string | No | Number of results per page \(recommended: 25-50\) |
| `offset` | string | No | Pagination offset \(skip this many results\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Markets data and metadata |
### `polymarket_get_market`
Retrieve details of a specific prediction market by ID or slug
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `marketId` | string | No | The market ID. Required if slug is not provided. |
| `slug` | string | No | The market slug \(e.g., "will-trump-win"\). Required if marketId is not provided. |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Market data and metadata |
### `polymarket_get_events`
Retrieve a list of events from Polymarket with optional filtering
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `closed` | string | No | Filter by closed status \(true/false\). Use false for active events only. |
| `order` | string | No | Sort field \(e.g., id, volume\) |
| `ascending` | string | No | Sort direction \(true for ascending, false for descending\) |
| `tagId` | string | No | Filter by tag ID |
| `limit` | string | No | Number of results per page \(recommended: 25-50\) |
| `offset` | string | No | Pagination offset \(skip this many results\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Events data and metadata |
### `polymarket_get_event`
Retrieve details of a specific event by ID or slug
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `eventId` | string | No | The event ID. Required if slug is not provided. |
| `slug` | string | No | The event slug \(e.g., "2024-presidential-election"\). Required if eventId is not provided. |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Event data and metadata |
### `polymarket_get_tags`
Retrieve available tags for filtering markets from Polymarket
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `limit` | string | No | Number of results per page \(recommended: 25-50\) |
| `offset` | string | No | Pagination offset \(skip this many results\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Tags data and metadata |
### `polymarket_search`
Search for markets, events, and profiles on Polymarket
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `query` | string | Yes | Search query term |
| `limit` | string | No | Number of results per page \(recommended: 25-50\) |
| `offset` | string | No | Pagination offset \(skip this many results\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Search results and metadata |
### `polymarket_get_series`
Retrieve series (related market groups) from Polymarket
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `limit` | string | No | Number of results per page \(recommended: 25-50\) |
| `offset` | string | No | Pagination offset \(skip this many results\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Series data and metadata |
### `polymarket_get_series_by_id`
Retrieve a specific series (related market group) by ID from Polymarket
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `seriesId` | string | Yes | The series ID |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Series data and metadata |
### `polymarket_get_orderbook`
Retrieve the order book summary for a specific token
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Yes | The CLOB token ID \(from market clobTokenIds\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Orderbook data and metadata |
### `polymarket_get_price`
Retrieve the market price for a specific token and side
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Yes | The CLOB token ID \(from market clobTokenIds\) |
| `side` | string | Yes | Order side: buy or sell |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Price data and metadata |
### `polymarket_get_midpoint`
Retrieve the midpoint price for a specific token
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Yes | The CLOB token ID \(from market clobTokenIds\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Midpoint price data and metadata |
### `polymarket_get_price_history`
Retrieve historical price data for a specific market token
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Yes | The CLOB token ID \(from market clobTokenIds\) |
| `interval` | string | No | Duration ending at current time \(1m, 1h, 6h, 1d, 1w, max\). Mutually exclusive with startTs/endTs. |
| `fidelity` | number | No | Data resolution in minutes \(e.g., 60 for hourly\) |
| `startTs` | number | No | Start timestamp \(Unix seconds UTC\) |
| `endTs` | number | No | End timestamp \(Unix seconds UTC\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Price history data and metadata |
### `polymarket_get_last_trade_price`
Retrieve the last trade price for a specific token
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Yes | The CLOB token ID \(from market clobTokenIds\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Last trade price and metadata |
### `polymarket_get_spread`
Retrieve the bid-ask spread for a specific token
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Yes | The CLOB token ID \(from market clobTokenIds\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Spread data and metadata |
### `polymarket_get_tick_size`
Retrieve the minimum tick size for a specific token
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Yes | The CLOB token ID \(from market clobTokenIds\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Tick size and metadata |
### `polymarket_get_positions`
Retrieve user positions from Polymarket
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `user` | string | Yes | User wallet address |
| `market` | string | No | Optional market ID to filter positions |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Positions data and metadata |
### `polymarket_get_trades`
Retrieve trade history from Polymarket
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `user` | string | No | User wallet address to filter trades |
| `market` | string | No | Market ID to filter trades |
| `limit` | string | No | Number of results per page \(recommended: 25-50\) |
| `offset` | string | No | Pagination offset \(skip this many results\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Trades data and metadata |
## Notes
- Category: `tools`
- Type: `polymarket`

View File

@@ -89,6 +89,13 @@ Create a new issue with specified properties
| `bodyHtml` | string | Yes | Issue body in HTML format |
| `accountId` | string | No | Account ID to associate with issue |
| `assigneeId` | string | No | User ID to assign issue to |
| `teamId` | string | No | Team ID to assign issue to |
| `requesterId` | string | No | Requester user ID \(alternative to requester_email\) |
| `requesterEmail` | string | No | Requester email address \(alternative to requester_id\) |
| `priority` | string | No | Issue priority |
| `tags` | string | No | Comma-separated tag IDs |
| `customFields` | string | No | Custom fields as JSON object |
| `attachmentUrls` | string | No | Comma-separated attachment URLs |
#### Output
@@ -130,6 +137,9 @@ Update an existing issue
| `teamId` | string | No | Team ID to assign issue to |
| `tags` | string | No | Comma-separated tag IDs |
| `customFields` | string | No | Custom fields as JSON object |
| `customerPortalVisible` | boolean | No | Whether issue is visible in customer portal |
| `requesterId` | string | No | Requester user ID |
| `accountId` | string | No | Account ID to associate with issue |
#### Output

View File

@@ -0,0 +1,173 @@
---
title: Amazon RDS
description: Connect to Amazon RDS via Data API
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="rds"
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}
[Amazon RDS Aurora Serverless](https://aws.amazon.com/rds/aurora/serverless/) is a fully managed relational database that automatically starts up, shuts down, and scales capacity based on your application's needs. It allows you to run SQL databases in the cloud without managing database servers.
With RDS Aurora Serverless, you can:
- **Query data**: Run flexible SQL queries across your tables
- **Insert new records**: Add data to your database automatically
- **Update existing records**: Modify data in your tables using custom filters
- **Delete records**: Remove unwanted data using precise criteria
- **Execute raw SQL**: Run any valid SQL command supported by Aurora
In Sim, the RDS integration enables your agents to work with Amazon Aurora Serverless databases securely and programmatically. Supported operations include:
- **Query**: Run SELECT and other SQL queries to fetch rows from your database
- **Insert**: Insert new records into tables with structured data
- **Update**: Change data in rows that match your specified conditions
- **Delete**: Remove records from a table by custom filters or criteria
- **Execute**: Run raw SQL for advanced scenarios
This integration allows your agents to automate a wide range of database operations without manual intervention. By connecting Sim with Amazon RDS, you can build agents that manage, update, and retrieve relational data within your workflows—all without handling database infrastructure or connections.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Amazon RDS Aurora Serverless into the workflow using the Data API. Can query, insert, update, delete, and execute raw SQL without managing database connections.
## Tools
### `rds_query`
Execute a SELECT query on Amazon RDS using the Data API
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
| `accessKeyId` | string | Yes | AWS access key ID |
| `secretAccessKey` | string | Yes | AWS secret access key |
| `resourceArn` | string | Yes | ARN of the Aurora DB cluster |
| `secretArn` | string | Yes | ARN of the Secrets Manager secret containing DB credentials |
| `database` | string | No | Database name \(optional\) |
| `query` | string | Yes | SQL SELECT query to execute |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Operation status message |
| `rows` | array | Array of rows returned from the query |
| `rowCount` | number | Number of rows returned |
### `rds_insert`
Insert data into an Amazon RDS table using the Data API
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
| `accessKeyId` | string | Yes | AWS access key ID |
| `secretAccessKey` | string | Yes | AWS secret access key |
| `resourceArn` | string | Yes | ARN of the Aurora DB cluster |
| `secretArn` | string | Yes | ARN of the Secrets Manager secret containing DB credentials |
| `database` | string | No | Database name \(optional\) |
| `table` | string | Yes | Table name to insert into |
| `data` | object | Yes | Data to insert as key-value pairs |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Operation status message |
| `rows` | array | Array of inserted rows |
| `rowCount` | number | Number of rows inserted |
### `rds_update`
Update data in an Amazon RDS table using the Data API
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
| `accessKeyId` | string | Yes | AWS access key ID |
| `secretAccessKey` | string | Yes | AWS secret access key |
| `resourceArn` | string | Yes | ARN of the Aurora DB cluster |
| `secretArn` | string | Yes | ARN of the Secrets Manager secret containing DB credentials |
| `database` | string | No | Database name \(optional\) |
| `table` | string | Yes | Table name to update |
| `data` | object | Yes | Data to update as key-value pairs |
| `conditions` | object | Yes | Conditions for the update \(e.g., \{"id": 1\}\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Operation status message |
| `rows` | array | Array of updated rows |
| `rowCount` | number | Number of rows updated |
### `rds_delete`
Delete data from an Amazon RDS table using the Data API
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
| `accessKeyId` | string | Yes | AWS access key ID |
| `secretAccessKey` | string | Yes | AWS secret access key |
| `resourceArn` | string | Yes | ARN of the Aurora DB cluster |
| `secretArn` | string | Yes | ARN of the Secrets Manager secret containing DB credentials |
| `database` | string | No | Database name \(optional\) |
| `table` | string | Yes | Table name to delete from |
| `conditions` | object | Yes | Conditions for the delete \(e.g., \{"id": 1\}\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Operation status message |
| `rows` | array | Array of deleted rows |
| `rowCount` | number | Number of rows deleted |
### `rds_execute`
Execute raw SQL on Amazon RDS using the Data API
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Yes | AWS region \(e.g., us-east-1\) |
| `accessKeyId` | string | Yes | AWS access key ID |
| `secretAccessKey` | string | Yes | AWS secret access key |
| `resourceArn` | string | Yes | ARN of the Aurora DB cluster |
| `secretArn` | string | Yes | ARN of the Secrets Manager secret containing DB credentials |
| `database` | string | No | Database name \(optional\) |
| `query` | string | Yes | Raw SQL query to execute |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Operation status message |
| `rows` | array | Array of rows returned or affected |
| `rowCount` | number | Number of rows affected |
## Notes
- Category: `tools`
- Type: `rds`

View File

@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="s3"
color="#E0E0E0"
color="linear-gradient(45deg, #1B660F 0%, #6CAE3E 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}

View File

@@ -0,0 +1,449 @@
---
title: Shopify
description: Manage products, orders, customers, and inventory in your Shopify store
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="shopify"
color="#FFFFFF"
/>
{/* MANUAL-CONTENT-START:intro */}
[Shopify](https://www.shopify.com/) is a leading e-commerce platform designed to help merchants build, run, and grow their online stores. Shopify makes it easy to manage every aspect of your store, from products and inventory to orders and customers.
With Shopify in Sim, your agents can:
- **Create and manage products**: Add new products, update product details, and remove products from your store.
- **List and retrieve orders**: Get information about customer orders, including filtering and order management.
- **Manage customers**: Access and update customer details, or add new customers to your store.
- **Adjust inventory levels**: Programmatically change product stock levels to keep your inventory accurate.
Use Sim's Shopify integration to automate common store management workflows—such as syncing inventory, fulfilling orders, or managing listings—directly from your automations. Empower your agents to access, update, and organize all your store data using simple, programmatic tools.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Shopify into your workflow. Manage products, orders, customers, and inventory. Create, read, update, and delete products. List and manage orders. Handle customer data and adjust inventory levels.
## Tools
### `shopify_create_product`
Create a new product in your Shopify store
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `title` | string | Yes | Product title |
| `descriptionHtml` | string | No | Product description \(HTML\) |
| `vendor` | string | No | Product vendor/brand |
| `productType` | string | No | Product type/category |
| `tags` | array | No | Product tags |
| `status` | string | No | Product status \(ACTIVE, DRAFT, ARCHIVED\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `product` | object | The created product |
### `shopify_get_product`
Get a single product by ID from your Shopify store
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `productId` | string | Yes | Product ID \(gid://shopify/Product/123456789\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `product` | object | The product details |
### `shopify_list_products`
List products from your Shopify store with optional filtering
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `first` | number | No | Number of products to return \(default: 50, max: 250\) |
| `query` | string | No | Search query to filter products \(e.g., "title:shirt" or "vendor:Nike" or "status:active"\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `products` | array | List of products |
| `pageInfo` | object | Pagination information |
### `shopify_update_product`
Update an existing product in your Shopify store
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `productId` | string | Yes | Product ID to update \(gid://shopify/Product/123456789\) |
| `title` | string | No | New product title |
| `descriptionHtml` | string | No | New product description \(HTML\) |
| `vendor` | string | No | New product vendor/brand |
| `productType` | string | No | New product type/category |
| `tags` | array | No | New product tags |
| `status` | string | No | New product status \(ACTIVE, DRAFT, ARCHIVED\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `product` | object | The updated product |
### `shopify_delete_product`
Delete a product from your Shopify store
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `productId` | string | Yes | Product ID to delete \(gid://shopify/Product/123456789\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `deletedId` | string | The ID of the deleted product |
### `shopify_get_order`
Get a single order by ID from your Shopify store
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `orderId` | string | Yes | Order ID \(gid://shopify/Order/123456789\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `order` | object | The order details |
### `shopify_list_orders`
List orders from your Shopify store with optional filtering
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `first` | number | No | Number of orders to return \(default: 50, max: 250\) |
| `status` | string | No | Filter by order status \(open, closed, cancelled, any\) |
| `query` | string | No | Search query to filter orders \(e.g., "financial_status:paid" or "fulfillment_status:unfulfilled" or "email:customer@example.com"\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `orders` | array | List of orders |
| `pageInfo` | object | Pagination information |
### `shopify_update_order`
Update an existing order in your Shopify store (note, tags, email)
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `orderId` | string | Yes | Order ID to update \(gid://shopify/Order/123456789\) |
| `note` | string | No | New order note |
| `tags` | array | No | New order tags |
| `email` | string | No | New customer email for the order |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `order` | object | The updated order |
### `shopify_cancel_order`
Cancel an order in your Shopify store
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `orderId` | string | Yes | Order ID to cancel \(gid://shopify/Order/123456789\) |
| `reason` | string | Yes | Cancellation reason \(CUSTOMER, DECLINED, FRAUD, INVENTORY, STAFF, OTHER\) |
| `notifyCustomer` | boolean | No | Whether to notify the customer about the cancellation |
| `refund` | boolean | No | Whether to refund the order |
| `restock` | boolean | No | Whether to restock the inventory |
| `staffNote` | string | No | A note about the cancellation for staff reference |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `order` | object | The cancellation result |
### `shopify_create_customer`
Create a new customer in your Shopify store
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `email` | string | No | Customer email address |
| `firstName` | string | No | Customer first name |
| `lastName` | string | No | Customer last name |
| `phone` | string | No | Customer phone number |
| `note` | string | No | Note about the customer |
| `tags` | array | No | Customer tags |
| `addresses` | array | No | Customer addresses |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `customer` | object | The created customer |
### `shopify_get_customer`
Get a single customer by ID from your Shopify store
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `customerId` | string | Yes | Customer ID \(gid://shopify/Customer/123456789\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `customer` | object | The customer details |
### `shopify_list_customers`
List customers from your Shopify store with optional filtering
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `first` | number | No | Number of customers to return \(default: 50, max: 250\) |
| `query` | string | No | Search query to filter customers \(e.g., "first_name:John" or "last_name:Smith" or "email:*@gmail.com" or "tag:vip"\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `customers` | array | List of customers |
| `pageInfo` | object | Pagination information |
### `shopify_update_customer`
Update an existing customer in your Shopify store
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `customerId` | string | Yes | Customer ID to update \(gid://shopify/Customer/123456789\) |
| `email` | string | No | New customer email address |
| `firstName` | string | No | New customer first name |
| `lastName` | string | No | New customer last name |
| `phone` | string | No | New customer phone number |
| `note` | string | No | New note about the customer |
| `tags` | array | No | New customer tags |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `customer` | object | The updated customer |
### `shopify_delete_customer`
Delete a customer from your Shopify store
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `customerId` | string | Yes | Customer ID to delete \(gid://shopify/Customer/123456789\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `deletedId` | string | The ID of the deleted customer |
### `shopify_list_inventory_items`
List inventory items from your Shopify store. Use this to find inventory item IDs by SKU.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `first` | number | No | Number of inventory items to return \(default: 50, max: 250\) |
| `query` | string | No | Search query to filter inventory items \(e.g., "sku:ABC123"\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `inventoryItems` | array | List of inventory items with their IDs, SKUs, and stock levels |
| `pageInfo` | object | Pagination information |
### `shopify_get_inventory_level`
Get inventory level for a product variant at a specific location
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `inventoryItemId` | string | Yes | Inventory item ID \(gid://shopify/InventoryItem/123456789\) |
| `locationId` | string | No | Location ID to filter by \(optional\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `inventoryLevel` | object | The inventory level details |
### `shopify_adjust_inventory`
Adjust inventory quantity for a product variant at a specific location
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `inventoryItemId` | string | Yes | Inventory item ID \(gid://shopify/InventoryItem/123456789\) |
| `locationId` | string | Yes | Location ID \(gid://shopify/Location/123456789\) |
| `delta` | number | Yes | Amount to adjust \(positive to increase, negative to decrease\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `inventoryLevel` | object | The inventory adjustment result |
### `shopify_list_locations`
List inventory locations from your Shopify store. Use this to find location IDs needed for inventory operations.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `first` | number | No | Number of locations to return \(default: 50, max: 250\) |
| `includeInactive` | boolean | No | Whether to include deactivated locations \(default: false\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `locations` | array | List of locations with their IDs, names, and addresses |
| `pageInfo` | object | Pagination information |
### `shopify_create_fulfillment`
Create a fulfillment to mark order items as shipped. Requires a fulfillment order ID (get this from the order details).
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `fulfillmentOrderId` | string | Yes | The fulfillment order ID \(e.g., gid://shopify/FulfillmentOrder/123456789\) |
| `trackingNumber` | string | No | Tracking number for the shipment |
| `trackingCompany` | string | No | Shipping carrier name \(e.g., UPS, FedEx, USPS, DHL\) |
| `trackingUrl` | string | No | URL to track the shipment |
| `notifyCustomer` | boolean | No | Whether to send a shipping confirmation email to the customer \(default: true\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `fulfillment` | object | The created fulfillment with tracking info and fulfilled items |
### `shopify_list_collections`
List product collections from your Shopify store. Filter by title, type (custom/smart), or handle.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `first` | number | No | Number of collections to return \(default: 50, max: 250\) |
| `query` | string | No | Search query to filter collections \(e.g., "title:Summer" or "collection_type:smart"\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `collections` | array | List of collections with their IDs, titles, and product counts |
| `pageInfo` | object | Pagination information |
### `shopify_get_collection`
Get a specific collection by ID, including its products. Use this to retrieve products within a collection.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | Yes | Your Shopify store domain \(e.g., mystore.myshopify.com\) |
| `collectionId` | string | Yes | The collection ID \(e.g., gid://shopify/Collection/123456789\) |
| `productsFirst` | number | No | Number of products to return from this collection \(default: 50, max: 250\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `collection` | object | The collection details including its products |
## Notes
- Category: `tools`
- Type: `shopify`

View File

@@ -0,0 +1,399 @@
---
title: SSH
description: Connect to remote servers via SSH
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="ssh"
color="#000000"
/>
{/* MANUAL-CONTENT-START:intro */}
[SSH (Secure Shell)](https://en.wikipedia.org/wiki/Secure_Shell) is a widely-used protocol for securely connecting to remote servers, allowing you to execute commands, transfer files, and manage systems over encrypted channels.
With SSH support in Sim, your agents can:
- **Execute remote commands**: Run shell commands on any SSH-accessible server
- **Upload and run scripts**: Easily transfer and execute multi-line scripts for advanced automation
- **Transfer files securely**: Upload and download files as part of your workflows (coming soon or via command)
- **Automate server management**: Perform updates, maintenance, monitoring, deployments, and configuration tasks programmatically
- **Use flexible authentication**: Connect with password or private key authentication, including support for encrypted keys
The following Sim SSH tools enable your agents to interact with servers as part of larger automations:
- `ssh_execute_command`: Run any single shell command remotely and capture output, status, and errors.
- `ssh_execute_script`: Upload and execute a full multi-line script on the remote system.
- (Additional tools coming soon, such as file transfer.)
By integrating SSH into your agent workflows, you can automate secure access, remote operations, and server orchestration—streamlining DevOps, IT automation, and custom remote management, all from within Sim.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Execute commands, transfer files, and manage remote servers via SSH. Supports password and private key authentication for secure server access.
## Tools
### `ssh_execute_command`
Execute a shell command on a remote SSH server
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | SSH server hostname or IP address |
| `port` | number | Yes | SSH server port \(default: 22\) |
| `username` | string | Yes | SSH username |
| `password` | string | No | Password for authentication \(if not using private key\) |
| `privateKey` | string | No | Private key for authentication \(OpenSSH format\) |
| `passphrase` | string | No | Passphrase for encrypted private key |
| `command` | string | Yes | Shell command to execute on the remote server |
| `workingDirectory` | string | No | Working directory for command execution |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `stdout` | string | Standard output from command |
| `stderr` | string | Standard error output |
| `exitCode` | number | Command exit code |
| `success` | boolean | Whether command succeeded \(exit code 0\) |
| `message` | string | Operation status message |
### `ssh_execute_script`
Upload and execute a multi-line script on a remote SSH server
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | SSH server hostname or IP address |
| `port` | number | Yes | SSH server port \(default: 22\) |
| `username` | string | Yes | SSH username |
| `password` | string | No | Password for authentication \(if not using private key\) |
| `privateKey` | string | No | Private key for authentication \(OpenSSH format\) |
| `passphrase` | string | No | Passphrase for encrypted private key |
| `script` | string | Yes | Script content to execute \(bash, python, etc.\) |
| `interpreter` | string | No | Script interpreter \(default: /bin/bash\) |
| `workingDirectory` | string | No | Working directory for script execution |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `stdout` | string | Standard output from script |
| `stderr` | string | Standard error output |
| `exitCode` | number | Script exit code |
| `success` | boolean | Whether script succeeded \(exit code 0\) |
| `scriptPath` | string | Temporary path where script was uploaded |
| `message` | string | Operation status message |
### `ssh_check_command_exists`
Check if a command/program exists on the remote SSH server
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | SSH server hostname or IP address |
| `port` | number | Yes | SSH server port \(default: 22\) |
| `username` | string | Yes | SSH username |
| `password` | string | No | Password for authentication \(if not using private key\) |
| `privateKey` | string | No | Private key for authentication \(OpenSSH format\) |
| `passphrase` | string | No | Passphrase for encrypted private key |
| `commandName` | string | Yes | Command name to check \(e.g., docker, git, python3\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `commandExists` | boolean | Whether the command exists |
| `commandPath` | string | Full path to the command \(if found\) |
| `version` | string | Command version output \(if applicable\) |
| `message` | string | Operation status message |
### `ssh_upload_file`
Upload a file to a remote SSH server
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | SSH server hostname or IP address |
| `port` | number | Yes | SSH server port \(default: 22\) |
| `username` | string | Yes | SSH username |
| `password` | string | No | Password for authentication \(if not using private key\) |
| `privateKey` | string | No | Private key for authentication \(OpenSSH format\) |
| `passphrase` | string | No | Passphrase for encrypted private key |
| `fileContent` | string | Yes | File content to upload \(base64 encoded for binary files\) |
| `fileName` | string | Yes | Name of the file being uploaded |
| `remotePath` | string | Yes | Destination path on the remote server |
| `permissions` | string | No | File permissions \(e.g., 0644\) |
| `overwrite` | boolean | No | Whether to overwrite existing files \(default: true\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `uploaded` | boolean | Whether the file was uploaded successfully |
| `remotePath` | string | Final path on the remote server |
| `size` | number | File size in bytes |
| `message` | string | Operation status message |
### `ssh_download_file`
Download a file from a remote SSH server
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | SSH server hostname or IP address |
| `port` | number | Yes | SSH server port \(default: 22\) |
| `username` | string | Yes | SSH username |
| `password` | string | No | Password for authentication \(if not using private key\) |
| `privateKey` | string | No | Private key for authentication \(OpenSSH format\) |
| `passphrase` | string | No | Passphrase for encrypted private key |
| `remotePath` | string | Yes | Path of the file on the remote server |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `downloaded` | boolean | Whether the file was downloaded successfully |
| `fileContent` | string | File content \(base64 encoded for binary files\) |
| `fileName` | string | Name of the downloaded file |
| `remotePath` | string | Source path on the remote server |
| `size` | number | File size in bytes |
| `message` | string | Operation status message |
### `ssh_list_directory`
List files and directories in a remote directory
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | SSH server hostname or IP address |
| `port` | number | Yes | SSH server port \(default: 22\) |
| `username` | string | Yes | SSH username |
| `password` | string | No | Password for authentication \(if not using private key\) |
| `privateKey` | string | No | Private key for authentication \(OpenSSH format\) |
| `passphrase` | string | No | Passphrase for encrypted private key |
| `path` | string | Yes | Remote directory path to list |
| `detailed` | boolean | No | Include file details \(size, permissions, modified date\) |
| `recursive` | boolean | No | List subdirectories recursively \(default: false\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `entries` | array | Array of file and directory entries |
### `ssh_check_file_exists`
Check if a file or directory exists on the remote SSH server
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | SSH server hostname or IP address |
| `port` | number | Yes | SSH server port \(default: 22\) |
| `username` | string | Yes | SSH username |
| `password` | string | No | Password for authentication \(if not using private key\) |
| `privateKey` | string | No | Private key for authentication \(OpenSSH format\) |
| `passphrase` | string | No | Passphrase for encrypted private key |
| `path` | string | Yes | Remote file or directory path to check |
| `type` | string | No | Expected type: file, directory, or any \(default: any\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `exists` | boolean | Whether the path exists |
| `type` | string | Type of path \(file, directory, symlink, not_found\) |
| `size` | number | File size if it is a file |
| `permissions` | string | File permissions \(e.g., 0755\) |
| `modified` | string | Last modified timestamp |
| `message` | string | Operation status message |
### `ssh_create_directory`
Create a directory on the remote SSH server
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | SSH server hostname or IP address |
| `port` | number | Yes | SSH server port \(default: 22\) |
| `username` | string | Yes | SSH username |
| `password` | string | No | Password for authentication \(if not using private key\) |
| `privateKey` | string | No | Private key for authentication \(OpenSSH format\) |
| `passphrase` | string | No | Passphrase for encrypted private key |
| `path` | string | Yes | Directory path to create |
| `recursive` | boolean | No | Create parent directories if they do not exist \(default: true\) |
| `permissions` | string | No | Directory permissions \(default: 0755\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `created` | boolean | Whether the directory was created successfully |
| `remotePath` | string | Created directory path |
| `alreadyExists` | boolean | Whether the directory already existed |
| `message` | string | Operation status message |
### `ssh_delete_file`
Delete a file or directory from the remote SSH server
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | SSH server hostname or IP address |
| `port` | number | Yes | SSH server port \(default: 22\) |
| `username` | string | Yes | SSH username |
| `password` | string | No | Password for authentication \(if not using private key\) |
| `privateKey` | string | No | Private key for authentication \(OpenSSH format\) |
| `passphrase` | string | No | Passphrase for encrypted private key |
| `path` | string | Yes | Path to delete |
| `recursive` | boolean | No | Recursively delete directories \(default: false\) |
| `force` | boolean | No | Force deletion without confirmation \(default: false\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `deleted` | boolean | Whether the path was deleted successfully |
| `remotePath` | string | Deleted path |
| `message` | string | Operation status message |
### `ssh_move_rename`
Move or rename a file or directory on the remote SSH server
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | SSH server hostname or IP address |
| `port` | number | Yes | SSH server port \(default: 22\) |
| `username` | string | Yes | SSH username |
| `password` | string | No | Password for authentication \(if not using private key\) |
| `privateKey` | string | No | Private key for authentication \(OpenSSH format\) |
| `passphrase` | string | No | Passphrase for encrypted private key |
| `sourcePath` | string | Yes | Current path of the file or directory |
| `destinationPath` | string | Yes | New path for the file or directory |
| `overwrite` | boolean | No | Overwrite destination if it exists \(default: false\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `moved` | boolean | Whether the operation was successful |
| `sourcePath` | string | Original path |
| `destinationPath` | string | New path |
| `message` | string | Operation status message |
### `ssh_get_system_info`
Retrieve system information from the remote SSH server
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | SSH server hostname or IP address |
| `port` | number | Yes | SSH server port \(default: 22\) |
| `username` | string | Yes | SSH username |
| `password` | string | No | Password for authentication \(if not using private key\) |
| `privateKey` | string | No | Private key for authentication \(OpenSSH format\) |
| `passphrase` | string | No | Passphrase for encrypted private key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `hostname` | string | Server hostname |
| `os` | string | Operating system \(e.g., Linux, Darwin\) |
| `architecture` | string | CPU architecture \(e.g., x64, arm64\) |
| `uptime` | number | System uptime in seconds |
| `memory` | json | Memory information \(total, free, used\) |
| `diskSpace` | json | Disk space information \(total, free, used\) |
| `message` | string | Operation status message |
### `ssh_read_file_content`
Read the contents of a remote file
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | SSH server hostname or IP address |
| `port` | number | Yes | SSH server port \(default: 22\) |
| `username` | string | Yes | SSH username |
| `password` | string | No | Password for authentication \(if not using private key\) |
| `privateKey` | string | No | Private key for authentication \(OpenSSH format\) |
| `passphrase` | string | No | Passphrase for encrypted private key |
| `path` | string | Yes | Remote file path to read |
| `encoding` | string | No | File encoding \(default: utf-8\) |
| `maxSize` | number | No | Maximum file size to read in MB \(default: 10\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | File content as string |
| `size` | number | File size in bytes |
| `lines` | number | Number of lines in file |
| `remotePath` | string | Remote file path |
| `message` | string | Operation status message |
### `ssh_write_file_content`
Write or append content to a remote file
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | SSH server hostname or IP address |
| `port` | number | Yes | SSH server port \(default: 22\) |
| `username` | string | Yes | SSH username |
| `password` | string | No | Password for authentication \(if not using private key\) |
| `privateKey` | string | No | Private key for authentication \(OpenSSH format\) |
| `passphrase` | string | No | Passphrase for encrypted private key |
| `path` | string | Yes | Remote file path to write to |
| `content` | string | Yes | Content to write to the file |
| `mode` | string | No | Write mode: overwrite, append, or create \(default: overwrite\) |
| `permissions` | string | No | File permissions \(e.g., 0644\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `written` | boolean | Whether the file was written successfully |
| `remotePath` | string | File path |
| `size` | number | Final file size in bytes |
| `message` | string | Operation status message |
## Notes
- Category: `tools`
- Type: `ssh`

View File

@@ -0,0 +1,571 @@
---
title: WordPress
description: Manage WordPress content
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="wordpress"
color="#21759B"
/>
{/* MANUAL-CONTENT-START:intro */}
[WordPress](https://wordpress.org/) is the worlds leading open-source content management system, making it easy to publish and manage websites, blogs, and all types of online content. With WordPress, you can create and update posts or pages, organize your content with categories and tags, manage media files, moderate comments, and handle user accounts—allowing you to run everything from personal blogs to complex business sites.
Sims integration with WordPress lets your agents automate essential website tasks. You can programmatically create new blog posts with specific titles, content, categories, tags, and featured images. Updating existing posts—such as changing their content, title, or publishing status—is straightforward. You can also publish or save content as drafts, manage static pages, work with media uploads, oversee comments, and assign content to relevant organizational taxonomies.
By connecting WordPress to your automations, Sim empowers your agents to streamline content publishing, editorial workflows, and everyday site management—helping you keep your website fresh, organized, and secure without manual effort.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate with WordPress to create, update, and manage posts, pages, media, comments, categories, tags, and users. Supports WordPress.com sites via OAuth and self-hosted WordPress sites using Application Passwords authentication.
## Tools
### `wordpress_create_post`
Create a new blog post in WordPress.com
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `title` | string | Yes | Post title |
| `content` | string | No | Post content \(HTML or plain text\) |
| `status` | string | No | Post status: publish, draft, pending, private, or future |
| `excerpt` | string | No | Post excerpt |
| `categories` | string | No | Comma-separated category IDs |
| `tags` | string | No | Comma-separated tag IDs |
| `featuredMedia` | number | No | Featured image media ID |
| `slug` | string | No | URL slug for the post |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `post` | object | The created post |
### `wordpress_update_post`
Update an existing blog post in WordPress.com
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `postId` | number | Yes | The ID of the post to update |
| `title` | string | No | Post title |
| `content` | string | No | Post content \(HTML or plain text\) |
| `status` | string | No | Post status: publish, draft, pending, private, or future |
| `excerpt` | string | No | Post excerpt |
| `categories` | string | No | Comma-separated category IDs |
| `tags` | string | No | Comma-separated tag IDs |
| `featuredMedia` | number | No | Featured image media ID |
| `slug` | string | No | URL slug for the post |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `post` | object | The updated post |
### `wordpress_delete_post`
Delete a blog post from WordPress.com
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `postId` | number | Yes | The ID of the post to delete |
| `force` | boolean | No | Bypass trash and force delete permanently |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `deleted` | boolean | Whether the post was deleted |
| `post` | object | The deleted post |
### `wordpress_get_post`
Get a single blog post from WordPress.com by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `postId` | number | Yes | The ID of the post to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `post` | object | The retrieved post |
### `wordpress_list_posts`
List blog posts from WordPress.com with optional filters
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `perPage` | number | No | Number of posts per page \(default: 10, max: 100\) |
| `page` | number | No | Page number for pagination |
| `status` | string | No | Post status filter: publish, draft, pending, private |
| `author` | number | No | Filter by author ID |
| `categories` | string | No | Comma-separated category IDs to filter by |
| `tags` | string | No | Comma-separated tag IDs to filter by |
| `search` | string | No | Search term to filter posts |
| `orderBy` | string | No | Order by field: date, id, title, slug, modified |
| `order` | string | No | Order direction: asc or desc |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `posts` | array | List of posts |
### `wordpress_create_page`
Create a new page in WordPress.com
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `title` | string | Yes | Page title |
| `content` | string | No | Page content \(HTML or plain text\) |
| `status` | string | No | Page status: publish, draft, pending, private |
| `excerpt` | string | No | Page excerpt |
| `parent` | number | No | Parent page ID for hierarchical pages |
| `menuOrder` | number | No | Order in page menu |
| `featuredMedia` | number | No | Featured image media ID |
| `slug` | string | No | URL slug for the page |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `page` | object | The created page |
### `wordpress_update_page`
Update an existing page in WordPress.com
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `pageId` | number | Yes | The ID of the page to update |
| `title` | string | No | Page title |
| `content` | string | No | Page content \(HTML or plain text\) |
| `status` | string | No | Page status: publish, draft, pending, private |
| `excerpt` | string | No | Page excerpt |
| `parent` | number | No | Parent page ID for hierarchical pages |
| `menuOrder` | number | No | Order in page menu |
| `featuredMedia` | number | No | Featured image media ID |
| `slug` | string | No | URL slug for the page |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `page` | object | The updated page |
### `wordpress_delete_page`
Delete a page from WordPress.com
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `pageId` | number | Yes | The ID of the page to delete |
| `force` | boolean | No | Bypass trash and force delete permanently |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `deleted` | boolean | Whether the page was deleted |
| `page` | object | The deleted page |
### `wordpress_get_page`
Get a single page from WordPress.com by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `pageId` | number | Yes | The ID of the page to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `page` | object | The retrieved page |
### `wordpress_list_pages`
List pages from WordPress.com with optional filters
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `perPage` | number | No | Number of pages per request \(default: 10, max: 100\) |
| `page` | number | No | Page number for pagination |
| `status` | string | No | Page status filter: publish, draft, pending, private |
| `parent` | number | No | Filter by parent page ID |
| `search` | string | No | Search term to filter pages |
| `orderBy` | string | No | Order by field: date, id, title, slug, modified, menu_order |
| `order` | string | No | Order direction: asc or desc |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `pages` | array | List of pages |
### `wordpress_upload_media`
Upload a media file (image, video, document) to WordPress.com
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `file` | string | Yes | Base64 encoded file data or URL to fetch file from |
| `filename` | string | Yes | Filename with extension \(e.g., image.jpg\) |
| `title` | string | No | Media title |
| `caption` | string | No | Media caption |
| `altText` | string | No | Alternative text for accessibility |
| `description` | string | No | Media description |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `media` | object | The uploaded media item |
### `wordpress_get_media`
Get a single media item from WordPress.com by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `mediaId` | number | Yes | The ID of the media item to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `media` | object | The retrieved media item |
### `wordpress_list_media`
List media items from the WordPress.com media library
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `perPage` | number | No | Number of media items per request \(default: 10, max: 100\) |
| `page` | number | No | Page number for pagination |
| `search` | string | No | Search term to filter media |
| `mediaType` | string | No | Filter by media type: image, video, audio, application |
| `mimeType` | string | No | Filter by specific MIME type \(e.g., image/jpeg\) |
| `orderBy` | string | No | Order by field: date, id, title, slug |
| `order` | string | No | Order direction: asc or desc |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `media` | array | List of media items |
### `wordpress_delete_media`
Delete a media item from WordPress.com
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `mediaId` | number | Yes | The ID of the media item to delete |
| `force` | boolean | No | Force delete \(media has no trash, so deletion is permanent\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `deleted` | boolean | Whether the media was deleted |
| `media` | object | The deleted media item |
### `wordpress_create_comment`
Create a new comment on a WordPress.com post
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `postId` | number | Yes | The ID of the post to comment on |
| `content` | string | Yes | Comment content |
| `parent` | number | No | Parent comment ID for replies |
| `authorName` | string | No | Comment author display name |
| `authorEmail` | string | No | Comment author email |
| `authorUrl` | string | No | Comment author URL |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `comment` | object | The created comment |
### `wordpress_list_comments`
List comments from WordPress.com with optional filters
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `perPage` | number | No | Number of comments per request \(default: 10, max: 100\) |
| `page` | number | No | Page number for pagination |
| `postId` | number | No | Filter by post ID |
| `status` | string | No | Filter by comment status: approved, hold, spam, trash |
| `search` | string | No | Search term to filter comments |
| `orderBy` | string | No | Order by field: date, id, parent |
| `order` | string | No | Order direction: asc or desc |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `comments` | array | List of comments |
### `wordpress_update_comment`
Update a comment in WordPress.com (content or status)
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `commentId` | number | Yes | The ID of the comment to update |
| `content` | string | No | Updated comment content |
| `status` | string | No | Comment status: approved, hold, spam, trash |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `comment` | object | The updated comment |
### `wordpress_delete_comment`
Delete a comment from WordPress.com
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `commentId` | number | Yes | The ID of the comment to delete |
| `force` | boolean | No | Bypass trash and force delete permanently |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `deleted` | boolean | Whether the comment was deleted |
| `comment` | object | The deleted comment |
### `wordpress_create_category`
Create a new category in WordPress.com
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `name` | string | Yes | Category name |
| `description` | string | No | Category description |
| `parent` | number | No | Parent category ID for hierarchical categories |
| `slug` | string | No | URL slug for the category |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `category` | object | The created category |
### `wordpress_list_categories`
List categories from WordPress.com
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `perPage` | number | No | Number of categories per request \(default: 10, max: 100\) |
| `page` | number | No | Page number for pagination |
| `search` | string | No | Search term to filter categories |
| `order` | string | No | Order direction: asc or desc |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `categories` | array | List of categories |
### `wordpress_create_tag`
Create a new tag in WordPress.com
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `name` | string | Yes | Tag name |
| `description` | string | No | Tag description |
| `slug` | string | No | URL slug for the tag |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `tag` | object | The created tag |
### `wordpress_list_tags`
List tags from WordPress.com
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `perPage` | number | No | Number of tags per request \(default: 10, max: 100\) |
| `page` | number | No | Page number for pagination |
| `search` | string | No | Search term to filter tags |
| `order` | string | No | Order direction: asc or desc |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `tags` | array | List of tags |
### `wordpress_get_current_user`
Get information about the currently authenticated WordPress.com user
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `user` | object | The current user |
### `wordpress_list_users`
List users from WordPress.com (requires admin privileges)
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `perPage` | number | No | Number of users per request \(default: 10, max: 100\) |
| `page` | number | No | Page number for pagination |
| `search` | string | No | Search term to filter users |
| `roles` | string | No | Comma-separated role names to filter by |
| `order` | string | No | Order direction: asc or desc |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `users` | array | List of users |
### `wordpress_get_user`
Get a specific user from WordPress.com by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `userId` | number | Yes | The ID of the user to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `user` | object | The retrieved user |
### `wordpress_search_content`
Search across all content types in WordPress.com (posts, pages, media)
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `siteId` | string | Yes | WordPress.com site ID or domain \(e.g., 12345678 or mysite.wordpress.com\) |
| `query` | string | Yes | Search query |
| `perPage` | number | No | Number of results per request \(default: 10, max: 100\) |
| `page` | number | No | Page number for pagination |
| `type` | string | No | Filter by content type: post, page, attachment |
| `subtype` | string | No | Filter by post type slug \(e.g., post, page\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `results` | array | Search results |
## Notes
- Category: `tools`
- Type: `wordpress`

View File

@@ -117,6 +117,9 @@ Create a new ticket in Zendesk with support for custom fields
| `type` | string | No | Type \(problem, incident, question, task\) |
| `tags` | string | No | Comma-separated tags |
| `assigneeId` | string | No | Assignee user ID |
| `groupId` | string | No | Group ID |
| `requesterId` | string | No | Requester user ID |
| `customFields` | string | No | Custom fields as JSON object \(e.g., \{"field_id": "value"\}\) |
#### Output

View File

@@ -0,0 +1,255 @@
---
title: Zoom
description: Create and manage Zoom meetings and recordings
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="zoom"
color="#2D8CFF"
/>
{/* MANUAL-CONTENT-START:intro */}
[Zoom](https://zoom.us/) is a leading cloud-based communications platform for video meetings, webinars, and online collaboration. It allows users and organizations to easily schedule, host, and manage meetings, providing tools for screen sharing, chat, recordings, and more.
With Zoom, you can:
- **Schedule and manage meetings**: Create instant or scheduled meetings, including recurring events
- **Configure meeting options**: Set meeting passwords, enable waiting rooms, and control participant video/audio
- **Send invitations and share details**: Retrieve meeting invitations and information for easy sharing
- **Get and update meeting data**: Access meeting details, modify existing meetings, and manage settings programmatically
In Sim, the Zoom integration empowers your agents to automate scheduling and meeting management. Use tool actions to:
- Programmatically create new meetings with custom settings
- List all meetings for a specific user (or yourself)
- Retrieve details or invitations for any meeting
- Update or delete existing meetings directly from your automations
These capabilities let you streamline remote collaboration, automate recurring video sessions, and manage your organization's Zoom environment all as part of your workflows.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Zoom into workflows. Create, list, update, and delete Zoom meetings. Get meeting details, invitations, recordings, and participants. Manage cloud recordings programmatically.
## Tools
### `zoom_create_meeting`
Create a new Zoom meeting
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `userId` | string | Yes | The user ID or email address. Use "me" for the authenticated user. |
| `topic` | string | Yes | Meeting topic |
| `type` | number | No | Meeting type: 1=instant, 2=scheduled, 3=recurring no fixed time, 8=recurring fixed time |
| `startTime` | string | No | Meeting start time in ISO 8601 format \(e.g., 2025-06-03T10:00:00Z\) |
| `duration` | number | No | Meeting duration in minutes |
| `timezone` | string | No | Timezone for the meeting \(e.g., America/Los_Angeles\) |
| `password` | string | No | Meeting password |
| `agenda` | string | No | Meeting agenda |
| `hostVideo` | boolean | No | Start with host video on |
| `participantVideo` | boolean | No | Start with participant video on |
| `joinBeforeHost` | boolean | No | Allow participants to join before host |
| `muteUponEntry` | boolean | No | Mute participants upon entry |
| `waitingRoom` | boolean | No | Enable waiting room |
| `autoRecording` | string | No | Auto recording setting: local, cloud, or none |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `meeting` | object | The created meeting with all its properties |
### `zoom_list_meetings`
List all meetings for a Zoom user
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `userId` | string | Yes | The user ID or email address. Use "me" for the authenticated user. |
| `type` | string | No | Meeting type filter: scheduled, live, upcoming, upcoming_meetings, or previous_meetings |
| `pageSize` | number | No | Number of records per page \(max 300\) |
| `nextPageToken` | string | No | Token for pagination to get next page of results |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `meetings` | array | List of meetings |
| `pageInfo` | object | Pagination information |
### `zoom_get_meeting`
Get details of a specific Zoom meeting
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `meetingId` | string | Yes | The meeting ID |
| `occurrenceId` | string | No | Occurrence ID for recurring meetings |
| `showPreviousOccurrences` | boolean | No | Show previous occurrences for recurring meetings |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `meeting` | object | The meeting details |
### `zoom_update_meeting`
Update an existing Zoom meeting
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `meetingId` | string | Yes | The meeting ID to update |
| `topic` | string | No | Meeting topic |
| `type` | number | No | Meeting type: 1=instant, 2=scheduled, 3=recurring no fixed time, 8=recurring fixed time |
| `startTime` | string | No | Meeting start time in ISO 8601 format \(e.g., 2025-06-03T10:00:00Z\) |
| `duration` | number | No | Meeting duration in minutes |
| `timezone` | string | No | Timezone for the meeting \(e.g., America/Los_Angeles\) |
| `password` | string | No | Meeting password |
| `agenda` | string | No | Meeting agenda |
| `hostVideo` | boolean | No | Start with host video on |
| `participantVideo` | boolean | No | Start with participant video on |
| `joinBeforeHost` | boolean | No | Allow participants to join before host |
| `muteUponEntry` | boolean | No | Mute participants upon entry |
| `waitingRoom` | boolean | No | Enable waiting room |
| `autoRecording` | string | No | Auto recording setting: local, cloud, or none |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Whether the meeting was updated successfully |
### `zoom_delete_meeting`
Delete or cancel a Zoom meeting
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `meetingId` | string | Yes | The meeting ID to delete |
| `occurrenceId` | string | No | Occurrence ID for deleting a specific occurrence of a recurring meeting |
| `scheduleForReminder` | boolean | No | Send cancellation reminder email to registrants |
| `cancelMeetingReminder` | boolean | No | Send cancellation email to registrants and alternative hosts |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Whether the meeting was deleted successfully |
### `zoom_get_meeting_invitation`
Get the meeting invitation text for a Zoom meeting
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `meetingId` | string | Yes | The meeting ID |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `invitation` | string | The meeting invitation text |
### `zoom_list_recordings`
List all cloud recordings for a Zoom user
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `userId` | string | Yes | The user ID or email address. Use "me" for the authenticated user. |
| `from` | string | No | Start date in yyyy-mm-dd format \(within last 6 months\) |
| `to` | string | No | End date in yyyy-mm-dd format |
| `pageSize` | number | No | Number of records per page \(max 300\) |
| `nextPageToken` | string | No | Token for pagination to get next page of results |
| `trash` | boolean | No | Set to true to list recordings from trash |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `recordings` | array | List of recordings |
| `pageInfo` | object | Pagination information |
### `zoom_get_meeting_recordings`
Get all recordings for a specific Zoom meeting
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `meetingId` | string | Yes | The meeting ID or meeting UUID |
| `includeFolderItems` | boolean | No | Include items within a folder |
| `ttl` | number | No | Time to live for download URLs in seconds \(max 604800\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `recording` | object | The meeting recording with all files |
### `zoom_delete_recording`
Delete cloud recordings for a Zoom meeting
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `meetingId` | string | Yes | The meeting ID or meeting UUID |
| `recordingId` | string | No | Specific recording file ID to delete. If not provided, deletes all recordings. |
| `action` | string | No | Delete action: "trash" \(move to trash\) or "delete" \(permanently delete\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Whether the recording was deleted successfully |
### `zoom_list_past_participants`
List participants from a past Zoom meeting
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `meetingId` | string | Yes | The past meeting ID or UUID |
| `pageSize` | number | No | Number of records per page \(max 300\) |
| `nextPageToken` | string | No | Token for pagination to get next page of results |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `participants` | array | List of meeting participants |
| `pageInfo` | object | Pagination information |
## Notes
- Category: `tools`
- Type: `zoom`

View File

@@ -0,0 +1,199 @@
---
title: Ahrefs
description: Análisis SEO con Ahrefs
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="ahrefs"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -0,0 +1,302 @@
---
title: Datadog
description: Monitorea infraestructura, aplicaciones y registros con Datadog
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="datadog"
color="#632CA6"
/>
{/* 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\{*\} &lt; 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`

View File

@@ -0,0 +1,219 @@
---
title: Dropbox
description: Sube, descarga, comparte y gestiona archivos en Dropbox
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="dropbox"
color="#0061FF"
/>
{/* 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`

View File

@@ -0,0 +1,188 @@
---
title: Amazon DynamoDB
description: Conectar a Amazon DynamoDB
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="dynamodb"
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}
[Amazon DynamoDB](https://aws.amazon.com/dynamodb/) es un servicio de base de datos NoSQL completamente administrado ofrecido por AWS que proporciona un rendimiento rápido y predecible con escalabilidad perfecta. DynamoDB te permite almacenar y recuperar cualquier cantidad de datos y atender cualquier nivel de tráfico de solicitudes, sin necesidad de administrar hardware o infraestructura.
Con DynamoDB, puedes:
- **Obtener elementos**: Buscar elementos en tus tablas usando claves primarias
- **Poner elementos**: Añadir o reemplazar elementos en tus tablas
- **Consultar elementos**: Recuperar múltiples elementos usando consultas a través de índices
- **Escanear tablas**: Leer todos o parte de los datos en una tabla
- **Actualizar elementos**: Modificar atributos específicos de elementos existentes
- **Eliminar elementos**: Eliminar registros de tus tablas
En Sim, la integración con DynamoDB permite a tus agentes acceder y manipular de forma segura las tablas de DynamoDB utilizando credenciales de AWS. Las operaciones compatibles incluyen:
- **Get**: Recuperar un elemento por su clave
- **Put**: Insertar o sobrescribir elementos
- **Query**: Ejecutar consultas utilizando condiciones de clave y filtros
- **Scan**: Leer múltiples elementos escaneando la tabla o índice
- **Update**: Cambiar atributos específicos de uno o más elementos
- **Delete**: Eliminar un elemento de una tabla
Esta integración permite a los agentes de Sim automatizar tareas de gestión de datos dentro de tus tablas de DynamoDB de forma programática, para que puedas crear flujos de trabajo que gestionen, modifiquen y recuperen datos NoSQL escalables sin esfuerzo manual ni gestión de servidores.
{/* MANUAL-CONTENT-END */}
## Instrucciones de uso
Integra Amazon DynamoDB en flujos de trabajo. Compatible con operaciones Get, Put, Query, Scan, Update y Delete en tablas de DynamoDB.
## Herramientas
### `dynamodb_get`
Obtener un elemento de una tabla DynamoDB mediante clave primaria
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `region` | string | Sí | Región de AWS \(p. ej., us-east-1\) |
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
| `tableName` | string | Sí | Nombre de la tabla DynamoDB |
| `key` | object | Sí | Clave primaria del elemento a recuperar |
| `consistentRead` | boolean | No | Usar lectura fuertemente consistente |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `item` | object | Elemento recuperado |
### `dynamodb_put`
Poner un elemento en una tabla DynamoDB
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `region` | string | Sí | Región de AWS \(p. ej., us-east-1\) |
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
| `tableName` | string | Sí | Nombre de la tabla DynamoDB |
| `item` | object | Sí | Elemento a poner en la tabla |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `item` | object | Elemento creado |
### `dynamodb_query`
Consultar elementos de una tabla DynamoDB usando condiciones de clave
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `region` | string | Sí | Región de AWS \(p. ej., us-east-1\) |
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
| `tableName` | string | Sí | Nombre de la tabla DynamoDB |
| `keyConditionExpression` | string | Sí | Expresión de condición de clave \(p. ej., "pk = :pk"\) |
| `filterExpression` | string | No | Expresión de filtro para resultados |
| `expressionAttributeNames` | object | No | Mapeos de nombres de atributos para palabras reservadas |
| `expressionAttributeValues` | object | No | Valores de atributos de expresión |
| `indexName` | string | No | Nombre del índice secundario para consultar |
| `limit` | number | No | Número máximo de elementos a devolver |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `items` | array | Array de elementos devueltos |
| `count` | number | Número de elementos devueltos |
### `dynamodb_scan`
Escanear todos los elementos en una tabla DynamoDB
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `region` | string | Sí | Región de AWS \(p. ej., us-east-1\) |
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
| `tableName` | string | Sí | Nombre de la tabla DynamoDB |
| `filterExpression` | string | No | Expresión de filtro para resultados |
| `projectionExpression` | string | No | Atributos a recuperar |
| `expressionAttributeNames` | object | No | Mapeos de nombres de atributos para palabras reservadas |
| `expressionAttributeValues` | object | No | Valores de atributos de expresión |
| `limit` | number | No | Número máximo de elementos a devolver |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `items` | array | Array de elementos devueltos |
| `count` | number | Número de elementos devueltos |
### `dynamodb_update`
Actualizar un elemento en una tabla de DynamoDB
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `region` | string | Sí | Región de AWS \(p. ej., us-east-1\) |
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
| `tableName` | string | Sí | Nombre de la tabla de DynamoDB |
| `key` | object | Sí | Clave primaria del elemento a actualizar |
| `updateExpression` | string | Sí | Expresión de actualización \(p. ej., "SET #name = :name"\) |
| `expressionAttributeNames` | object | No | Mapeos de nombres de atributos para palabras reservadas |
| `expressionAttributeValues` | object | No | Valores de atributos de expresión |
| `conditionExpression` | string | No | Condición que debe cumplirse para que la actualización tenga éxito |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `item` | object | Elemento actualizado |
### `dynamodb_delete`
Eliminar un elemento de una tabla de DynamoDB
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `region` | string | Sí | Región de AWS \(p. ej., us-east-1\) |
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
| `tableName` | string | Sí | Nombre de la tabla de DynamoDB |
| `key` | object | Sí | Clave primaria del elemento a eliminar |
| `conditionExpression` | string | No | Condición que debe cumplirse para que la eliminación tenga éxito |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
## Notas
- Categoría: `tools`
- Tipo: `dynamodb`

View File

@@ -0,0 +1,365 @@
---
title: Elasticsearch
description: Busca, indexa y gestiona datos en Elasticsearch
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="elasticsearch"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -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"
<BlockInfoCard
type="gitlab"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -0,0 +1,494 @@
---
title: Grafana
description: Interactúa con paneles, alertas y anotaciones de Grafana
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="grafana"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -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"
<BlockInfoCard
type="kalshi"
color="#09C285"
/>
{/* 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`

View File

@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="mailgun"
color="#F06248"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}

View File

@@ -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"
<BlockInfoCard
type="polymarket"
color="#4C82FB"
/>
{/* 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`

View File

@@ -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

View File

@@ -0,0 +1,168 @@
---
title: Amazon RDS
description: Conéctate a Amazon RDS a través de Data API
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="rds"
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}
[Amazon RDS Aurora Serverless](https://aws.amazon.com/rds/aurora/serverless/) es una base de datos relacional completamente administrada que se inicia, se apaga y escala automáticamente según las necesidades de tu aplicación. Te permite ejecutar bases de datos SQL en la nube sin tener que administrar servidores de bases de datos.
Con RDS Aurora Serverless, puedes:
- **Consultar datos**: Ejecutar consultas SQL flexibles en tus tablas
- **Insertar nuevos registros**: Añadir datos a tu base de datos automáticamente
- **Actualizar registros existentes**: Modificar datos en tus tablas usando filtros personalizados
- **Eliminar registros**: Quitar datos no deseados utilizando criterios precisos
- **Ejecutar SQL puro**: Ejecutar cualquier comando SQL válido compatible con Aurora
En Sim, la integración con RDS permite a tus agentes trabajar con bases de datos Amazon Aurora Serverless de forma segura y programática. Las operaciones compatibles incluyen:
- **Consulta**: Ejecutar SELECT y otras consultas SQL para obtener filas de tu base de datos
- **Inserción**: Insertar nuevos registros en tablas con datos estructurados
- **Actualización**: Cambiar datos en filas que coincidan con tus condiciones especificadas
- **Eliminación**: Eliminar registros de una tabla mediante filtros o criterios personalizados
- **Ejecución**: Ejecutar SQL puro para escenarios avanzados
Esta integración permite a tus agentes automatizar una amplia gama de operaciones de bases de datos sin intervención manual. Al conectar Sim con Amazon RDS, puedes crear agentes que gestionen, actualicen y recuperen datos relacionales dentro de tus flujos de trabajo, todo sin tener que manejar infraestructura o conexiones de bases de datos.
{/* MANUAL-CONTENT-END */}
## Instrucciones de uso
Integra Amazon RDS Aurora Serverless en el flujo de trabajo utilizando la Data API. Puede consultar, insertar, actualizar, eliminar y ejecutar SQL puro sin administrar conexiones de base de datos.
## Herramientas
### `rds_query`
Ejecutar una consulta SELECT en Amazon RDS utilizando la API de datos
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `region` | string | Sí | Región de AWS (p. ej., us-east-1) |
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
| `resourceArn` | string | Sí | ARN del clúster de Aurora DB |
| `secretArn` | string | Sí | ARN del secreto de Secrets Manager que contiene las credenciales de la base de datos |
| `database` | string | No | Nombre de la base de datos (opcional) |
| `query` | string | Sí | Consulta SQL SELECT para ejecutar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `rows` | array | Array de filas devueltas por la consulta |
| `rowCount` | number | Número de filas devueltas |
### `rds_insert`
Insertar datos en una tabla de Amazon RDS utilizando la API de datos
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `region` | string | Sí | Región de AWS (p. ej., us-east-1) |
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
| `resourceArn` | string | Sí | ARN del clúster de Aurora DB |
| `secretArn` | string | Sí | ARN del secreto de Secrets Manager que contiene las credenciales de la base de datos |
| `database` | string | No | Nombre de la base de datos (opcional) |
| `table` | string | Sí | Nombre de la tabla donde insertar |
| `data` | object | Sí | Datos a insertar como pares clave-valor |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `rows` | array | Array de filas insertadas |
| `rowCount` | number | Número de filas insertadas |
### `rds_update`
Actualizar datos en una tabla de Amazon RDS utilizando la API de datos
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `region` | string | Sí | Región de AWS (p. ej., us-east-1) |
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
| `resourceArn` | string | Sí | ARN del clúster de Aurora DB |
| `secretArn` | string | Sí | ARN del secreto de Secrets Manager que contiene las credenciales de la base de datos |
| `database` | string | No | Nombre de la base de datos (opcional) |
| `table` | string | Sí | Nombre de la tabla a actualizar |
| `data` | object | Sí | Datos a actualizar como pares clave-valor |
| `conditions` | object | Sí | Condiciones para la actualización (p. ej., `{"id": 1}`) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `rows` | array | Array de filas actualizadas |
| `rowCount` | number | Número de filas actualizadas |
### `rds_delete`
Eliminar datos de una tabla de Amazon RDS utilizando la API de datos
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `region` | string | Sí | Región de AWS (p. ej., us-east-1) |
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
| `resourceArn` | string | Sí | ARN del clúster de Aurora DB |
| `secretArn` | string | Sí | ARN del secreto de Secrets Manager que contiene las credenciales de la base de datos |
| `database` | string | No | Nombre de la base de datos (opcional) |
| `table` | string | Sí | Nombre de la tabla de la que eliminar |
| `conditions` | object | Sí | Condiciones para la eliminación (p. ej., `{"id": 1}`) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `rows` | array | Array de filas eliminadas |
| `rowCount` | number | Número de filas eliminadas |
### `rds_execute`
Ejecutar SQL sin procesar en Amazon RDS usando la API de datos
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `region` | string | Sí | Región de AWS (p. ej., us-east-1) |
| `accessKeyId` | string | Sí | ID de clave de acceso de AWS |
| `secretAccessKey` | string | Sí | Clave de acceso secreta de AWS |
| `resourceArn` | string | Sí | ARN del clúster de Aurora DB |
| `secretArn` | string | Sí | ARN del secreto de Secrets Manager que contiene las credenciales de la base de datos |
| `database` | string | No | Nombre de la base de datos (opcional) |
| `query` | string | Sí | Consulta SQL sin procesar para ejecutar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `rows` | array | Array de filas devueltas o afectadas |
| `rowCount` | number | Número de filas afectadas |
## Notas
- Categoría: `tools`
- Tipo: `rds`

View File

@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="s3"
color="#E0E0E0"
color="linear-gradient(45deg, #1B660F 0%, #6CAE3E 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}

View File

@@ -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"
<BlockInfoCard
type="shopify"
color="#FFFFFF"
/>
{/* 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`

View File

@@ -0,0 +1,394 @@
---
title: SSH
description: Conéctate a servidores remotos vía SSH
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="ssh"
color="#000000"
/>
{/* 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`

View File

@@ -0,0 +1,566 @@
---
title: WordPress
description: Gestionar contenido de WordPress
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="wordpress"
color="#21759B"
/>
{/* 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`

View File

@@ -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

View File

@@ -0,0 +1,250 @@
---
title: Zoom
description: Crea y gestiona reuniones y grabaciones de Zoom
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="zoom"
color="#2D8CFF"
/>
{/* 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`

View File

@@ -0,0 +1,199 @@
---
title: Ahrefs
description: Analyse SEO avec Ahrefs
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="ahrefs"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -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"
<BlockInfoCard
type="datadog"
color="#632CA6"
/>
{/* 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\{*\} &lt; 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`

View File

@@ -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"
<BlockInfoCard
type="dropbox"
color="#0061FF"
/>
{/* 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`

View File

@@ -0,0 +1,188 @@
---
title: Amazon DynamoDB
description: Connexion à Amazon DynamoDB
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="dynamodb"
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}
[Amazon DynamoDB](https://aws.amazon.com/dynamodb/) est un service de base de données NoSQL entièrement géré proposé par AWS qui offre des performances rapides et prévisibles avec une évolutivité transparente. DynamoDB vous permet de stocker et de récupérer n'importe quelle quantité de données et gère n'importe quel niveau de trafic de requêtes, sans que vous ayez à gérer le matériel ou l'infrastructure.
Avec DynamoDB, vous pouvez :
- **Obtenir des éléments** : rechercher des éléments dans vos tables à l'aide de clés primaires
- **Mettre des éléments** : ajouter ou remplacer des éléments dans vos tables
- **Interroger des éléments** : récupérer plusieurs éléments à l'aide de requêtes sur les index
- **Scanner des tables** : lire tout ou partie des données d'une table
- **Mettre à jour des éléments** : modifier des attributs spécifiques d'éléments existants
- **Supprimer des éléments** : supprimer des enregistrements de vos tables
Dans Sim, l'intégration DynamoDB permet à vos agents d'accéder en toute sécurité aux tables DynamoDB et de les manipuler à l'aide des identifiants AWS. Les opérations prises en charge comprennent :
- **Get** : récupérer un élément par sa clé
- **Put** : insérer ou écraser des éléments
- **Query** : exécuter des requêtes à l'aide de conditions de clé et de filtres
- **Scan** : lire plusieurs éléments en scannant la table ou l'index
- **Update** : modifier des attributs spécifiques d'un ou plusieurs éléments
- **Delete** : supprimer un élément d'une table
Cette intégration permet aux agents Sim d'automatiser les tâches de gestion de données au sein de vos tables DynamoDB de manière programmatique, afin que vous puissiez créer des flux de travail qui gèrent, modifient et récupèrent des données NoSQL évolutives sans effort manuel ni gestion de serveur.
{/* MANUAL-CONTENT-END */}
## Instructions d'utilisation
Intégrez Amazon DynamoDB dans les flux de travail. Prend en charge les opérations Get, Put, Query, Scan, Update et Delete sur les tables DynamoDB.
## Outils
### `dynamodb_get`
Récupérer un élément d'une table DynamoDB par clé primaire
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
| `tableName` | chaîne | Oui | Nom de la table DynamoDB |
| `key` | objet | Oui | Clé primaire de l'élément à récupérer |
| `consistentRead` | booléen | Non | Utiliser une lecture fortement cohérente |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | chaîne | Message d'état de l'opération |
| `item` | objet | Élément récupéré |
### `dynamodb_put`
Mettre un élément dans une table DynamoDB
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
| `tableName` | chaîne | Oui | Nom de la table DynamoDB |
| `item` | objet | Oui | Élément à mettre dans la table |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | chaîne | Message d'état de l'opération |
| `item` | objet | Élément créé |
### `dynamodb_query`
Interroger les éléments d'une table DynamoDB à l'aide de conditions de clé
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
| `tableName` | chaîne | Oui | Nom de la table DynamoDB |
| `keyConditionExpression` | chaîne | Oui | Expression de condition de clé (par ex., "pk = :pk") |
| `filterExpression` | chaîne | Non | Expression de filtre pour les résultats |
| `expressionAttributeNames` | objet | Non | Mappages de noms d'attributs pour les mots réservés |
| `expressionAttributeValues` | objet | Non | Valeurs d'attributs d'expression |
| `indexName` | chaîne | Non | Nom de l'index secondaire à interroger |
| `limit` | nombre | Non | Nombre maximum d'éléments à retourner |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | chaîne | Message d'état de l'opération |
| `items` | tableau | Tableau des éléments retournés |
| `count` | nombre | Nombre d'éléments retournés |
### `dynamodb_scan`
Scanner tous les éléments d'une table DynamoDB
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
| `tableName` | chaîne | Oui | Nom de la table DynamoDB |
| `filterExpression` | chaîne | Non | Expression de filtre pour les résultats |
| `projectionExpression` | chaîne | Non | Attributs à récupérer |
| `expressionAttributeNames` | objet | Non | Mappages de noms d'attributs pour les mots réservés |
| `expressionAttributeValues` | objet | Non | Valeurs d'attributs d'expression |
| `limit` | nombre | Non | Nombre maximum d'éléments à retourner |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Message d'état de l'opération |
| `items` | array | Tableau des éléments retournés |
| `count` | number | Nombre d'éléments retournés |
### `dynamodb_update`
Mettre à jour un élément dans une table DynamoDB
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Oui | Région AWS (par ex., us-east-1) |
| `accessKeyId` | string | Oui | ID de clé d'accès AWS |
| `secretAccessKey` | string | Oui | Clé d'accès secrète AWS |
| `tableName` | string | Oui | Nom de la table DynamoDB |
| `key` | object | Oui | Clé primaire de l'élément à mettre à jour |
| `updateExpression` | string | Oui | Expression de mise à jour (par ex., "SET #name = :name") |
| `expressionAttributeNames` | object | Non | Mappages de noms d'attributs pour les mots réservés |
| `expressionAttributeValues` | object | Non | Valeurs d'attributs d'expression |
| `conditionExpression` | string | Non | Condition qui doit être remplie pour que la mise à jour réussisse |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Message d'état de l'opération |
| `item` | object | Élément mis à jour |
### `dynamodb_delete`
Supprimer un élément d'une table DynamoDB
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Oui | Région AWS (par ex., us-east-1) |
| `accessKeyId` | string | Oui | ID de clé d'accès AWS |
| `secretAccessKey` | string | Oui | Clé d'accès secrète AWS |
| `tableName` | string | Oui | Nom de la table DynamoDB |
| `key` | object | Oui | Clé primaire de l'élément à supprimer |
| `conditionExpression` | string | Non | Condition qui doit être remplie pour que la suppression réussisse |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Message d'état de l'opération |
## Notes
- Catégorie : `tools`
- Type : `dynamodb`

View File

@@ -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"
<BlockInfoCard
type="elasticsearch"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -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"
<BlockInfoCard
type="gitlab"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -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"
<BlockInfoCard
type="grafana"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -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"
<BlockInfoCard
type="kalshi"
color="#09C285"
/>
{/* 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`

View File

@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="mailgun"
color="#F06248"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}

View File

@@ -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"
<BlockInfoCard
type="polymarket"
color="#4C82FB"
/>
{/* 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`

View File

@@ -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

View File

@@ -0,0 +1,168 @@
---
title: Amazon RDS
description: Connexion à Amazon RDS via l'API Data
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="rds"
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}
[Amazon RDS Aurora Serverless](https://aws.amazon.com/rds/aurora/serverless/) est une base de données relationnelle entièrement gérée qui démarre, s'arrête et adapte automatiquement sa capacité en fonction des besoins de votre application. Elle vous permet d'exécuter des bases de données SQL dans le cloud sans avoir à gérer des serveurs de base de données.
Avec RDS Aurora Serverless, vous pouvez :
- **Interroger des données** : exécuter des requêtes SQL flexibles sur vos tables
- **Insérer de nouveaux enregistrements** : ajouter automatiquement des données à votre base de données
- **Mettre à jour des enregistrements existants** : modifier des données dans vos tables à l'aide de filtres personnalisés
- **Supprimer des enregistrements** : éliminer les données indésirables en utilisant des critères précis
- **Exécuter du SQL brut** : lancer toute commande SQL valide prise en charge par Aurora
Dans Sim, l'intégration RDS permet à vos agents de travailler avec les bases de données Amazon Aurora Serverless de manière sécurisée et programmatique. Les opérations prises en charge comprennent :
- **Requête** : exécuter des requêtes SELECT et autres requêtes SQL pour récupérer des lignes de votre base de données
- **Insertion** : insérer de nouveaux enregistrements dans les tables avec des données structurées
- **Mise à jour** : modifier les données dans les lignes qui correspondent à vos conditions spécifiées
- **Suppression** : supprimer des enregistrements d'une table par filtres ou critères personnalisés
- **Exécution** : exécuter du SQL brut pour des scénarios avancés
Cette intégration permet à vos agents d'automatiser un large éventail d'opérations de base de données sans intervention manuelle. En connectant Sim avec Amazon RDS, vous pouvez créer des agents qui gèrent, mettent à jour et récupèrent des données relationnelles dans vos flux de travail, le tout sans avoir à gérer l'infrastructure ou les connexions de base de données.
{/* MANUAL-CONTENT-END */}
## Instructions d'utilisation
Intégrez Amazon RDS Aurora Serverless dans le flux de travail en utilisant l'API Data. Possibilité d'interroger, d'insérer, de mettre à jour, de supprimer et d'exécuter du SQL brut sans gérer les connexions à la base de données.
## Outils
### `rds_query`
Exécuter une requête SELECT sur Amazon RDS en utilisant l'API Data
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `region` | chaîne | Oui | Région AWS \(ex., us-east-1\) |
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
| `resourceArn` | chaîne | Oui | ARN du cluster Aurora DB |
| `secretArn` | chaîne | Oui | ARN du secret Secrets Manager contenant les identifiants de la base de données |
| `database` | chaîne | Non | Nom de la base de données \(facultatif\) |
| `query` | chaîne | Oui | Requête SQL SELECT à exécuter |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | chaîne | Message d'état de l'opération |
| `rows` | tableau | Tableau des lignes retournées par la requête |
| `rowCount` | nombre | Nombre de lignes retournées |
### `rds_insert`
Insérer des données dans une table Amazon RDS en utilisant l'API Data
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `region` | chaîne | Oui | Région AWS \(ex., us-east-1\) |
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
| `resourceArn` | chaîne | Oui | ARN du cluster Aurora DB |
| `secretArn` | chaîne | Oui | ARN du secret Secrets Manager contenant les identifiants de la base de données |
| `database` | chaîne | Non | Nom de la base de données \(facultatif\) |
| `table` | chaîne | Oui | Nom de la table dans laquelle insérer |
| `data` | objet | Oui | Données à insérer sous forme de paires clé-valeur |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Message d'état de l'opération |
| `rows` | array | Tableau des lignes insérées |
| `rowCount` | number | Nombre de lignes insérées |
### `rds_update`
Mettre à jour des données dans une table Amazon RDS en utilisant l'API Data
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `region` | string | Oui | Région AWS (par ex., us-east-1) |
| `accessKeyId` | string | Oui | ID de clé d'accès AWS |
| `secretAccessKey` | string | Oui | Clé d'accès secrète AWS |
| `resourceArn` | string | Oui | ARN du cluster de base de données Aurora |
| `secretArn` | string | Oui | ARN du secret Secrets Manager contenant les identifiants de la base de données |
| `database` | string | Non | Nom de la base de données (facultatif) |
| `table` | string | Oui | Nom de la table à mettre à jour |
| `data` | object | Oui | Données à mettre à jour sous forme de paires clé-valeur |
| `conditions` | object | Oui | Conditions pour la mise à jour (par ex., `{"id": 1}`) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Message d'état de l'opération |
| `rows` | array | Tableau des lignes mises à jour |
| `rowCount` | number | Nombre de lignes mises à jour |
### `rds_delete`
Supprimer des données d'une table Amazon RDS en utilisant l'API Data
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
| `resourceArn` | chaîne | Oui | ARN du cluster de base de données Aurora |
| `secretArn` | chaîne | Oui | ARN du secret Secrets Manager contenant les identifiants de la base de données |
| `database` | chaîne | Non | Nom de la base de données (facultatif) |
| `table` | chaîne | Oui | Nom de la table à supprimer |
| `conditions` | objet | Oui | Conditions pour la suppression (par ex., `{"id": 1}`) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | chaîne | Message d'état de l'opération |
| `rows` | tableau | Tableau des lignes supprimées |
| `rowCount` | nombre | Nombre de lignes supprimées |
### `rds_execute`
Exécuter du SQL brut sur Amazon RDS en utilisant l'API Data
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
| `accessKeyId` | chaîne | Oui | ID de clé d'accès AWS |
| `secretAccessKey` | chaîne | Oui | Clé d'accès secrète AWS |
| `resourceArn` | chaîne | Oui | ARN du cluster de base de données Aurora |
| `secretArn` | chaîne | Oui | ARN du secret Secrets Manager contenant les identifiants de la base de données |
| `database` | chaîne | Non | Nom de la base de données (facultatif) |
| `query` | chaîne | Oui | Requête SQL brute à exécuter |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Message d'état de l'opération |
| `rows` | array | Tableau des lignes retournées ou affectées |
| `rowCount` | number | Nombre de lignes affectées |
## Notes
- Catégorie : `tools`
- Type : `rds`

View File

@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="s3"
color="#E0E0E0"
color="linear-gradient(45deg, #1B660F 0%, #6CAE3E 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}

View File

@@ -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"
<BlockInfoCard
type="shopify"
color="#FFFFFF"
/>
{/* 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`

View File

@@ -0,0 +1,394 @@
---
title: SSH
description: Connectez-vous aux serveurs distants via SSH
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="ssh"
color="#000000"
/>
{/* 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`

View File

@@ -0,0 +1,566 @@
---
title: WordPress
description: Gérer le contenu WordPress
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="wordpress"
color="#21759B"
/>
{/* 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`

View File

@@ -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

View File

@@ -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"
<BlockInfoCard
type="zoom"
color="#2D8CFF"
/>
{/* 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`

View File

@@ -0,0 +1,199 @@
---
title: Ahrefs
description: Ahrefsを使ったSEO分析
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="ahrefs"
color="#E0E0E0"
/>
{/* 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ドメイン全体、prefixURLプレフィックス、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ドメイン全体、prefixURLプレフィックス、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ドメイン全体、prefixURL接頭辞、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ドメイン全体、prefixURL接頭辞、subdomainsすべてのサブドメインを含む、exact完全なURL一致 |
| `date` | string | いいえ | YYYY-MM-DD形式の履歴データの日付デフォルトは今日 |
| `limit` | number | いいえ | 返す結果の最大数(デフォルト: 100 |
| `offset` | number | いいえ | ページネーション用にスキップする結果の数 |
| `apiKey` | string | はい | Ahrefs APIキー |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `brokenBacklinks` | array | リンク切れのバックリンクのリスト |
## 注意事項
- カテゴリー: `tools`
- タイプ: `ahrefs`

View File

@@ -0,0 +1,302 @@
---
title: Datadog
description: Datadogでインフラストラクチャ、アプリケーション、ログを監視
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="datadog"
color="#632CA6"
/>
{/* 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\{*\} &lt; 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`

View File

@@ -0,0 +1,219 @@
---
title: Dropbox
description: Dropboxでファイルのアップロード、ダウンロード、共有、管理を行う
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="dropbox"
color="#0061FF"
/>
{/* 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`

View File

@@ -0,0 +1,188 @@
---
title: Amazon DynamoDB
description: Amazon DynamoDBに接続する
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="dynamodb"
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}
[Amazon DynamoDB](https://aws.amazon.com/dynamodb/)はAWSが提供する完全マネージド型のNoSQLデータベースサービスで、シームレスなスケーラビリティを備えた高速で予測可能なパフォーマンスを提供します。DynamoDBを使用すると、ハードウェアやインフラストラクチャを管理する必要なく、任意の量のデータを保存および取得し、あらゆるレベルのリクエストトラフィックに対応できます。
DynamoDBでは、以下のことが可能です
- **アイテムの取得**:プライマリキーを使用してテーブル内のアイテムを検索
- **アイテムの配置**:テーブルにアイテムを追加または置換
- **アイテムのクエリ**:インデックス全体でクエリを使用して複数のアイテムを取得
- **テーブルのスキャン**:テーブル内のデータの全部または一部を読み取り
- **アイテムの更新**:既存のアイテムの特定の属性を変更
- **アイテムの削除**:テーブルからレコードを削除
Simでは、DynamoDB統合により、エージェントがAWS認証情報を使用してDynamoDBテーブルに安全にアクセスし操作することができます。サポートされている操作には以下が含まれます
- **Get**:キーによるアイテムの取得
- **Put**:アイテムの挿入または上書き
- **Query**:キー条件とフィルターを使用したクエリの実行
- **Scan**:テーブルまたはインデックスをスキャンして複数のアイテムを読み取り
- **Update**1つ以上のアイテムの特定の属性を変更
- **Delete**:テーブルからアイテムを削除
この統合により、SimエージェントはプログラムによってDynamoDBテーブル内のデータ管理タスクを自動化できるようになり、手動の作業やサーバー管理なしでスケーラブルなNoSQLデータを管理、変更、取得するワークフローを構築できます。
{/* MANUAL-CONTENT-END */}
## 使用方法
Amazon DynamoDBをワークフローに統合します。DynamoDBテーブルに対するGet、Put、Query、Scan、Update、Delete操作をサポートしています。
## ツール
### `dynamodb_get`
プライマリキーを使用してDynamoDBテーブルからアイテムを取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `region` | string | はい | AWSリージョンus-east-1 |
| `accessKeyId` | string | はい | AWSアクセスキーID |
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
| `tableName` | string | はい | DynamoDBテーブル名 |
| `key` | object | はい | 取得するアイテムのプライマリキー |
| `consistentRead` | boolean | いいえ | 強力な整合性のある読み取りを使用する |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 操作ステータスメッセージ |
| `item` | object | 取得したアイテム |
### `dynamodb_put`
DynamoDBテーブルにアイテムを追加する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `region` | string | はい | AWSリージョンus-east-1 |
| `accessKeyId` | string | はい | AWSアクセスキーID |
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
| `tableName` | string | はい | DynamoDBテーブル名 |
| `item` | object | はい | テーブルに追加するアイテム |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 操作ステータスメッセージ |
| `item` | object | 作成されたアイテム |
### `dynamodb_query`
キー条件を使用してDynamoDBテーブルからアイテムをクエリする
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `region` | string | はい | AWSリージョンus-east-1 |
| `accessKeyId` | string | はい | AWSアクセスキーID |
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
| `tableName` | string | はい | DynamoDBテーブル名 |
| `keyConditionExpression` | string | はい | キー条件式(例:"pk = :pk" |
| `filterExpression` | string | いいえ | 結果のフィルター式 |
| `expressionAttributeNames` | object | いいえ | 予約語の属性名マッピング |
| `expressionAttributeValues` | object | いいえ | 式の属性値 |
| `indexName` | string | いいえ | クエリするセカンダリインデックス名 |
| `limit` | number | いいえ | 返すアイテムの最大数 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 操作ステータスメッセージ |
| `items` | array | 返されたアイテムの配列 |
| `count` | number | 返されたアイテムの数 |
### `dynamodb_scan`
DynamoDBテーブル内のすべてのアイテムをスキャンする
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `region` | string | はい | AWSリージョンus-east-1 |
| `accessKeyId` | string | はい | AWSアクセスキーID |
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
| `tableName` | string | はい | DynamoDBテーブル名 |
| `filterExpression` | string | いいえ | 結果のフィルター式 |
| `projectionExpression` | string | いいえ | 取得する属性 |
| `expressionAttributeNames` | object | いいえ | 予約語の属性名マッピング |
| `expressionAttributeValues` | object | いいえ | 式の属性値 |
| `limit` | number | いいえ | 返すアイテムの最大数 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 操作ステータスメッセージ |
| `items` | array | 返されたアイテムの配列 |
| `count` | number | 返されたアイテム数 |
### `dynamodb_update`
DynamoDBテーブル内のアイテムを更新する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `region` | string | はい | AWSリージョンus-east-1 |
| `accessKeyId` | string | はい | AWSアクセスキーID |
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
| `tableName` | string | はい | DynamoDBテーブル名 |
| `key` | object | はい | 更新するアイテムのプライマリキー |
| `updateExpression` | string | はい | 更新式(例:"SET #name = :name" |
| `expressionAttributeNames` | object | いいえ | 予約語の属性名マッピング |
| `expressionAttributeValues` | object | いいえ | 式の属性値 |
| `conditionExpression` | string | いいえ | 更新が成功するために満たす必要がある条件 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 操作ステータスメッセージ |
| `item` | object | 更新されたアイテム |
### `dynamodb_delete`
DynamoDBテーブルからアイテムを削除する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `region` | string | はい | AWSリージョンus-east-1 |
| `accessKeyId` | string | はい | AWSアクセスキーID |
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
| `tableName` | string | はい | DynamoDBテーブル名 |
| `key` | object | はい | 削除するアイテムのプライマリキー |
| `conditionExpression` | string | いいえ | 削除が成功するために満たす必要がある条件 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 操作ステータスメッセージ |
## 注意事項
- カテゴリー: `tools`
- タイプ: `dynamodb`

View File

@@ -0,0 +1,365 @@
---
title: Elasticsearch
description: Elasticsearchでデータの検索、インデックス作成、管理を行う
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="elasticsearch"
color="#E0E0E0"
/>
{/* 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 ホストURLself-hosted用 |
| `cloudId` | string | いいえ | Elastic Cloud IDcloudデプロイメント用 |
| `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 ホストURLself_hosted用 |
| `cloudId` | string | いいえ | Elastic Cloud IDcloudデプロイメント用 |
| `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 ホスト URLself_hosted の場合) |
| `cloudId` | string | いいえ | Elastic Cloud IDcloud デプロイメントの場合) |
| `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 ホスト URLself_hosted の場合) |
| `cloudId` | string | いいえ | Elastic Cloud IDcloud デプロイメントの場合) |
| `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`

View File

@@ -0,0 +1,429 @@
---
title: GitLab
description: GitLabのプロジェクト、課題、マージリクエスト、パイプラインとやり取りする
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="gitlab"
color="#E0E0E0"
/>
{/* 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 | はい | 課題内部IDIID |
| `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 | はい | 課題内部IDIID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 課題が正常に削除されたかどうか |
### `gitlab_create_issue_note`
GitLab課題にコメントを追加する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | はい | プロジェクトIDまたはURLエンコードされたパス |
| `issueIid` | number | はい | 課題の内部IDIID |
| `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 | はい | マージリクエスト内部IDIID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `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 | はい | マージリクエスト内部IDIID |
| `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 | はい | マージリクエスト内部IDIID |
| `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 | はい | マージリクエスト内部IDIID |
| `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`

View File

@@ -0,0 +1,494 @@
---
title: Grafana
description: Grafanaダッシュボード、アラート、アテーションを操作する
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="grafana"
color="#E0E0E0"
/>
{/* 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インスタンスURLhttps://your-grafana.com |
| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンスの組織ID |
| `dashboardUid` | string | はい | 取得するダッシュボードのUID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `dashboard` | json | 完全なダッシュボードJSONオブジェクト |
| `meta` | json | ダッシュボードのメタデータ(バージョン、権限など) |
### `grafana_list_dashboards`
すべてのダッシュボードを検索およびリスト表示する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Grafanaサービスアカウントトークン |
| `baseUrl` | string | はい | GrafanaインスタンスURLhttps://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インスタンスURLhttps://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インスタンスのURLhttps://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インスタンスURLhttps://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インスタンスURLhttps://your-grafana.com |
| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `rules` | array | アラートルールのリスト |
### `grafana_get_alert_rule`
UIDによって特定のアラートルールを取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Grafanaサービスアカウントトークン |
| `baseUrl` | string | はい | GrafanaインスタンスURLhttps://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インスタンスURLhttps://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インスタンスのURLhttps://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インスタンスURLhttps://your-grafana.com |
| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンスの組織ID |
| `alertRuleUid` | string | はい | 削除するアラートルールのUID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 確認メッセージ |
### `grafana_list_contact_points`
すべてのアラート通知コンタクトポイントの一覧表示
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Grafanaサービスアカウントトークン |
| `baseUrl` | string | はい | GrafanaインスタンスURLhttps://your-grafana.com |
| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンスの組織ID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `contactPoints` | array | コンタクトポイントのリスト |
### `grafana_create_annotation`
ダッシュボード上または全体的なアノテーションとしてアノテーションを作成する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Grafanaサービスアカウントトークン |
| `baseUrl` | string | はい | GrafanaインスタンスURLhttps://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インスタンスURLhttps://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インスタンスURLhttps://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インスタンスURLhttps://your-grafana.com |
| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID |
| `annotationId` | number | はい | 削除するアテーションのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 確認メッセージ |
### `grafana_list_data_sources`
Grafanaで設定されているすべてのデータソースを一覧表示する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Grafanaサービスアカウントトークン |
| `baseUrl` | string | はい | GrafanaインスタンスURLhttps://your-grafana.com |
| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `dataSources` | array | データソースのリスト |
### `grafana_get_data_source`
IDまたはUIDでデータソースを取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Grafanaサービスアカウントトークン |
| `baseUrl` | string | はい | GrafanaインスタンスURLhttps://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インスタンスURLhttps://your-grafana.com |
| `organizationId` | string | いいえ | マルチ組織Grafanaインスタンス用の組織ID |
| `limit` | number | いいえ | 返すフォルダの最大数 |
| `page` | number | いいえ | ページネーション用のページ番号 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `folders` | array | フォルダのリスト |
### `grafana_create_folder`
Grafanaに新しいフォルダを作成
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Grafanaサービスアカウントトークン |
| `baseUrl` | string | はい | GrafanaインスタンスURLhttps://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`

View File

@@ -0,0 +1,295 @@
---
title: Kalshi
description: Kalshiの予測市場データにアクセス
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="kalshi"
color="#09C285"
/>
{/* 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 | いいえ | 期間間隔11分、601時間、または14401日 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `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`

View File

@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="mailgun"
color="#F06248"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}

View File

@@ -0,0 +1,352 @@
---
title: Polymarket
description: Polymarketの予測市場データにアクセス
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="polymarket"
color="#4C82FB"
/>
{/* 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`

View File

@@ -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 | いいえ | 要求者ユーザーIDrequester_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 |
#### 出力

View File

@@ -0,0 +1,168 @@
---
title: Amazon RDS
description: Data APIを通じてAmazon RDSに接続
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="rds"
color="linear-gradient(45deg, #2E27AD 0%, #527FFF 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}
[Amazon RDS Aurora Serverless](https://aws.amazon.com/rds/aurora/serverless/)は、アプリケーションのニーズに基づいて自動的に起動、シャットダウン、容量のスケーリングを行う完全マネージド型のリレーショナルデータベースです。データベースサーバーを管理することなく、クラウドでSQLデータベースを実行できます。
RDS Aurora Serverlessでは、以下のことが可能です
- **データのクエリ**: テーブル間で柔軟なSQLクエリを実行
- **新しいレコードの挿入**: データベースに自動的にデータを追加
- **既存レコードの更新**: カスタムフィルターを使用してテーブル内のデータを変更
- **レコードの削除**: 正確な条件を使用して不要なデータを削除
- **生のSQLの実行**: Auroraでサポートされている有効なSQLコマンドを実行
Simでは、RDS統合により、エージェントがAmazon Aurora Serverlessデータベースを安全かつプログラム的に操作できるようになります。サポートされている操作には以下が含まれます
- **クエリ**: SELECTやその他のSQLクエリを実行してデータベースから行を取得
- **挿入**: 構造化データを使用してテーブルに新しいレコードを挿入
- **更新**: 指定した条件に一致する行のデータを変更
- **削除**: カスタムフィルターや条件によってテーブルからレコードを削除
- **実行**: 高度なシナリオ向けに生のSQLを実行
この統合により、エージェントは手動介入なしに幅広いデータベース操作を自動化できます。SimとAmazon RDSを接続することで、ワークフロー内でリレーショナルデータを管理、更新、取得するエージェントを構築できます—すべてデータベースインフラストラクチャや接続を扱うことなく実現できます。
{/* MANUAL-CONTENT-END */}
## 使用手順
Data APIを使用してAmazon RDS Aurora Serverlessをワークフローに統合します。データベース接続を管理することなく、クエリ、挿入、更新、削除、生のSQLの実行が可能です。
## ツール
### `rds_query`
Data APIを使用してAmazon RDSでSELECTクエリを実行する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `region` | string | はい | AWSリージョンus-east-1 |
| `accessKeyId` | string | はい | AWSアクセスキーID |
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
| `resourceArn` | string | はい | Aurora DBクラスターのARN |
| `secretArn` | string | はい | DB認証情報を含むSecrets ManagerシークレットのARN |
| `database` | string | いいえ | データベース名(オプション) |
| `query` | string | はい | 実行するSQL SELECTクエリ |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 操作ステータスメッセージ |
| `rows` | array | クエリから返された行の配列 |
| `rowCount` | number | 返された行数 |
### `rds_insert`
Data APIを使用してAmazon RDSテーブルにデータを挿入する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `region` | string | はい | AWSリージョンus-east-1 |
| `accessKeyId` | string | はい | AWSアクセスキーID |
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
| `resourceArn` | string | はい | Aurora DBクラスターのARN |
| `secretArn` | string | はい | DB認証情報を含むSecrets ManagerシークレットのARN |
| `database` | string | いいえ | データベース名(オプション) |
| `table` | string | はい | 挿入先のテーブル名 |
| `data` | object | はい | キーと値のペアとして挿入するデータ |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 操作ステータスメッセージ |
| `rows` | array | 挿入された行の配列 |
| `rowCount` | number | 挿入された行数 |
### `rds_update`
Data APIを使用してAmazon RDSテーブルのデータを更新する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `region` | string | はい | AWSリージョンus-east-1 |
| `accessKeyId` | string | はい | AWSアクセスキーID |
| `secretAccessKey` | string | はい | AWSシークレットアクセスキー |
| `resourceArn` | string | はい | Aurora DBクラスターのARN |
| `secretArn` | string | はい | DB認証情報を含むSecrets ManagerシークレットのARN |
| `database` | string | いいえ | データベース名(オプション) |
| `table` | string | はい | 更新するテーブル名 |
| `data` | object | はい | キーと値のペアとして更新するデータ |
| `conditions` | object | はい | 更新の条件(例:`{"id": 1}`) |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 操作ステータスメッセージ |
| `rows` | array | 更新された行の配列 |
| `rowCount` | number | 更新された行数 |
### `rds_delete`
Data APIを使用してAmazon RDSテーブルからデータを削除する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `region` | string | はい | AWS リージョンus-east-1 |
| `accessKeyId` | string | はい | AWS アクセスキーID |
| `secretAccessKey` | string | はい | AWS シークレットアクセスキー |
| `resourceArn` | string | はい | Aurora DBクラスターのARN |
| `secretArn` | string | はい | DB認証情報を含むSecrets ManagerシークレットのARN |
| `database` | string | いいえ | データベース名(オプション) |
| `table` | string | はい | 削除対象のテーブル名 |
| `conditions` | object | はい | 削除条件(例:`{"id": 1}`) |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 操作ステータスメッセージ |
| `rows` | array | 削除された行の配列 |
| `rowCount` | number | 削除された行数 |
### `rds_execute`
Data APIを使用してAmazon RDSで生のSQLを実行する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `region` | string | はい | AWS リージョンus-east-1 |
| `accessKeyId` | string | はい | AWS アクセスキーID |
| `secretAccessKey` | string | はい | AWS シークレットアクセスキー |
| `resourceArn` | string | はい | Aurora DBクラスターのARN |
| `secretArn` | string | はい | DB認証情報を含むSecrets ManagerシークレットのARN |
| `database` | string | いいえ | データベース名(オプション) |
| `query` | string | はい | 実行する生のSQLクエリ |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 操作ステータスメッセージ |
| `rows` | array | 返却または影響を受けた行の配列 |
| `rowCount` | number | 影響を受けた行数 |
## 注意事項
- カテゴリー: `tools`
- タイプ: `rds`

View File

@@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="s3"
color="#E0E0E0"
color="linear-gradient(45deg, #1B660F 0%, #6CAE3E 100%)"
/>
{/* MANUAL-CONTENT-START:intro */}

View File

@@ -0,0 +1,444 @@
---
title: Shopify
description: Shopifyストアで商品、注文、顧客、在庫を管理する
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="shopify"
color="#FFFFFF"
/>
{/* 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 | はい | 商品IDgid://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 | はい | 更新する商品IDgid://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 | はい | 削除する商品IDgid://shopify/Product/123456789 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `deletedId` | string | 削除された商品のID |
### `shopify_get_order`
IDを指定してShopifyストアから単一の注文を取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | はい | Shopifyストアドメインmystore.myshopify.com |
| `orderId` | string | はい | 注文IDgid://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 | はい | 顧客IDgid://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 | はい | 更新する顧客IDgid://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 | はい | 削除する顧客IDgid://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 | はい | 在庫アイテムIDgid://shopify/InventoryItem/123456789 |
| `locationId` | string | いいえ | フィルタリングする場所IDオプション |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `inventoryLevel` | object | 在庫レベルの詳細 |
### `shopify_adjust_inventory`
特定の場所で商品バリアントの在庫数量を調整する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `shopDomain` | string | はい | Shopifyストアドメインmystore.myshopify.com |
| `inventoryItemId` | string | はい | 在庫アイテムIDgid://shopify/InventoryItem/123456789 |
| `locationId` | string | はい | ロケーションIDgid://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 | はい | フルフィルメント注文IDgid://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 | はい | コレクションIDgid://shopify/Collection/123456789 |
| `productsFirst` | number | いいえ | このコレクションから返す製品の数デフォルト50、最大250 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `collection` | object | 製品を含むコレクションの詳細 |
## 注意事項
- カテゴリー: `tools`
- タイプ: `shopify`

View File

@@ -0,0 +1,394 @@
---
title: SSH
description: SSHを介してリモートサーバーに接続する
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="ssh"
color="#000000"
/>
{/* MANUAL-CONTENT-START:intro */}
[SSHSecure 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`

View File

@@ -0,0 +1,566 @@
---
title: WordPress
description: WordPressコンテンツを管理する
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="wordpress"
color="#21759B"
/>
{/* 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`

Some files were not shown because too many files have changed in this diff Show More