diff --git a/apps/docs/content/docs/de/blocks/agent.mdx b/apps/docs/content/docs/de/blocks/agent.mdx index 3db5a5e957..b44d9a7d0b 100644 --- a/apps/docs/content/docs/de/blocks/agent.mdx +++ b/apps/docs/content/docs/de/blocks/agent.mdx @@ -46,7 +46,7 @@ Der Agent-Block unterstützt mehrere LLM-Anbieter über eine einheitliche Infere - **Anthropic**: Claude 4.5 Sonnet, Claude Opus 4.1 - **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash - **Andere Anbieter**: Groq, Cerebras, xAI, Azure OpenAI, OpenRouter -- **Lokale Modelle**: Ollama-kompatible Modelle +- **Lokale Modelle**: Ollama oder VLLM-kompatible Modelle ### Temperatur diff --git a/apps/docs/content/docs/de/blocks/evaluator.mdx b/apps/docs/content/docs/de/blocks/evaluator.mdx index 195040ab77..ed6e3766cd 100644 --- a/apps/docs/content/docs/de/blocks/evaluator.mdx +++ b/apps/docs/content/docs/de/blocks/evaluator.mdx @@ -52,7 +52,7 @@ Wählen Sie ein KI-Modell für die Durchführung der Bewertung: - **Anthropic**: Claude 3.7 Sonnet - **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash - **Andere Anbieter**: Groq, Cerebras, xAI, DeepSeek -- **Lokale Modelle**: Ollama-kompatible Modelle +- **Lokale Modelle**: Ollama oder VLLM-kompatible Modelle Verwenden Sie Modelle mit starken Argumentationsfähigkeiten wie GPT-4o oder Claude 3.7 Sonnet für beste Ergebnisse. diff --git a/apps/docs/content/docs/de/blocks/guardrails.mdx b/apps/docs/content/docs/de/blocks/guardrails.mdx index e910afa3a0..78c1f39d8e 100644 --- a/apps/docs/content/docs/de/blocks/guardrails.mdx +++ b/apps/docs/content/docs/de/blocks/guardrails.mdx @@ -63,10 +63,10 @@ Verwendet Retrieval-Augmented Generation (RAG) mit LLM-Bewertung, um zu erkennen 4. Validierung besteht, wenn der Wert ≥ Schwellenwert ist (Standard: 3) **Konfiguration:** -- **Wissensdatenbank**: Auswahl aus Ihren vorhandenen Wissensdatenbanken -- **Modell**: Wahl des LLM für die Bewertung (erfordert starkes Reasoning - GPT-4o, Claude 3.7 Sonnet empfohlen) -- **API-Schlüssel**: Authentifizierung für den ausgewählten LLM-Anbieter (automatisch ausgeblendet für gehostete/Ollama-Modelle) -- **Konfidenz-Schwellenwert**: Mindestwert zum Bestehen (0-10, Standard: 3) +- **Wissensdatenbank**: Wählen Sie aus Ihren vorhandenen Wissensdatenbanken +- **Modell**: Wählen Sie LLM für die Bewertung (erfordert starkes Denkvermögen - GPT-4o, Claude 3.7 Sonnet empfohlen) +- **API-Schlüssel**: Authentifizierung für den ausgewählten LLM-Anbieter (automatisch ausgeblendet für gehostete/Ollama oder VLLM-kompatible Modelle) +- **Vertrauensschwelle**: Mindestpunktzahl zum Bestehen (0-10, Standard: 3) - **Top K** (Erweitert): Anzahl der abzurufenden Wissensdatenbank-Chunks (Standard: 10) **Ausgabe:** diff --git a/apps/docs/content/docs/de/blocks/router.mdx b/apps/docs/content/docs/de/blocks/router.mdx index aef47540ed..43d3faae24 100644 --- a/apps/docs/content/docs/de/blocks/router.mdx +++ b/apps/docs/content/docs/de/blocks/router.mdx @@ -56,7 +56,7 @@ Wähle ein KI-Modell für die Weiterleitungsentscheidung: - **Anthropic**: Claude 3.7 Sonnet - **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash - **Andere Anbieter**: Groq, Cerebras, xAI, DeepSeek -- **Lokale Modelle**: Ollama-kompatible Modelle +- **Lokale Modelle**: Ollama oder VLLM-kompatible Modelle Verwende Modelle mit starken Argumentationsfähigkeiten wie GPT-4o oder Claude 3.7 Sonnet für beste Ergebnisse. diff --git a/apps/docs/content/docs/de/execution/costs.mdx b/apps/docs/content/docs/de/execution/costs.mdx index 08e3c8199c..3b5ae58343 100644 --- a/apps/docs/content/docs/de/execution/costs.mdx +++ b/apps/docs/content/docs/de/execution/costs.mdx @@ -47,33 +47,34 @@ Die Modellaufschlüsselung zeigt: ## Preisoptionen - + - **Gehostete Modelle** - Sim stellt API-Schlüssel mit einem 2,5-fachen Preismultiplikator bereit: + **Hosted Models** - Sim stellt API-Schlüssel mit einem 2,5-fachen Preismultiplikator bereit: - | Modell | Basispreis (Eingabe/Ausgabe) | Gehosteter Preis (Eingabe/Ausgabe) | + | Modell | Basispreis (Input/Output) | Hosted-Preis (Input/Output) | |-------|---------------------------|----------------------------| - | GPT-4o | 2,50 $ / 10,00 $ | 6,25 $ / 25,00 $ | - | GPT-4.1 | 2,00 $ / 8,00 $ | 5,00 $ / 20,00 $ | - | o1 | 15,00 $ / 60,00 $ | 37,50 $ / 150,00 $ | - | o3 | 2,00 $ / 8,00 $ | 5,00 $ / 20,00 $ | - | Claude 3.5 Sonnet | 3,00 $ / 15,00 $ | 7,50 $ / 37,50 $ | - | Claude Opus 4.0 | 15,00 $ / 75,00 $ | 37,50 $ / 187,50 $ | + | GPT-4o | $2,50 / $10,00 | $6,25 / $25,00 | + | GPT-4.1 | $2,00 / $8,00 | $5,00 / $20,00 | + | o1 | $15,00 / $60,00 | $37,50 / $150,00 | + | o3 | $2,00 / $8,00 | $5,00 / $20,00 | + | Claude 3.5 Sonnet | $3,00 / $15,00 | $7,50 / $37,50 | + | Claude Opus 4.0 | $15,00 / $75,00 | $37,50 / $187,50 | *Der 2,5-fache Multiplikator deckt Infrastruktur- und API-Verwaltungskosten ab.* - **Ihre eigenen API-Schlüssel** - Nutzen Sie jedes Modell zum Basispreis: + **Eigene API-Schlüssel** - Nutzen Sie jedes Modell zum Basispreis: - | Anbieter | Modelle | Eingabe / Ausgabe | + | Anbieter | Modelle | Input / Output | |----------|---------|----------------| - | Google | Gemini 2.5 | 0,15 $ / 0,60 $ | - | Deepseek | V3, R1 | 0,75 $ / 1,00 $ | - | xAI | Grok 4, Grok 3 | 5,00 $ / 25,00 $ | - | Groq | Llama 4 Scout | 0,40 $ / 0,60 $ | - | Cerebras | Llama 3.3 70B | 0,94 $ / 0,94 $ | + | Google | Gemini 2.5 | $0,15 / $0,60 | + | Deepseek | V3, R1 | $0,75 / $1,00 | + | xAI | Grok 4, Grok 3 | $5,00 / $25,00 | + | Groq | Llama 4 Scout | $0,40 / $0,60 | + | Cerebras | Llama 3.3 70B | $0,94 / $0,94 | | Ollama | Lokale Modelle | Kostenlos | + | VLLM | Lokale Modelle | Kostenlos | *Bezahlen Sie Anbieter direkt ohne Aufschlag* @@ -85,11 +86,11 @@ Die Modellaufschlüsselung zeigt: ## Kostenoptimierungsstrategien -- **Modellauswahl**: Wähle Modelle basierend auf der Komplexität der Aufgabe. Einfache Aufgaben können mit GPT-4.1-nano erledigt werden, während komplexes Denken möglicherweise o1 oder Claude Opus erfordert. +- **Modellauswahl**: Wählen Sie Modelle basierend auf der Komplexität der Aufgabe. Einfache Aufgaben können GPT-4.1-nano verwenden, während komplexes Denken möglicherweise o1 oder Claude Opus erfordert. - **Prompt-Engineering**: Gut strukturierte, präzise Prompts reduzieren den Token-Verbrauch ohne Qualitätseinbußen. -- **Lokale Modelle**: Nutze Ollama für unkritische Aufgaben, um API-Kosten vollständig zu eliminieren. -- **Caching und Wiederverwendung**: Speichere häufig verwendete Ergebnisse in Variablen oder Dateien, um wiederholte KI-Modellaufrufe zu vermeiden. -- **Batch-Verarbeitung**: Verarbeite mehrere Elemente in einer einzigen KI-Anfrage anstatt einzelne Aufrufe zu tätigen. +- **Lokale Modelle**: Verwenden Sie Ollama oder VLLM für unkritische Aufgaben, um API-Kosten vollständig zu eliminieren. +- **Caching und Wiederverwendung**: Speichern Sie häufig verwendete Ergebnisse in Variablen oder Dateien, um wiederholte AI-Modellaufrufe zu vermeiden. +- **Batch-Verarbeitung**: Verarbeiten Sie mehrere Elemente in einer einzigen AI-Anfrage anstatt einzelne Aufrufe zu tätigen. ## Nutzungsüberwachung diff --git a/apps/docs/content/docs/de/introduction/index.mdx b/apps/docs/content/docs/de/introduction/index.mdx index 4a20360b76..5cc6003211 100644 --- a/apps/docs/content/docs/de/introduction/index.mdx +++ b/apps/docs/content/docs/de/introduction/index.mdx @@ -59,7 +59,7 @@ Ermöglichen Sie Ihrem Team, gemeinsam zu arbeiten. Mehrere Benutzer können Wor Sim bietet native Integrationen mit über 80 Diensten in verschiedenen Kategorien: -- **KI-Modelle**: OpenAI, Anthropic, Google Gemini, Groq, Cerebras, lokale Modelle über Ollama +- **KI-Modelle**: OpenAI, Anthropic, Google Gemini, Groq, Cerebras, lokale Modelle über Ollama oder VLLM - **Kommunikation**: Gmail, Slack, Microsoft Teams, Telegram, WhatsApp - **Produktivität**: Notion, Google Workspace, Airtable, Monday.com - **Entwicklung**: GitHub, Jira, Linear, automatisierte Browser-Tests diff --git a/apps/docs/content/docs/de/tools/incidentio.mdx b/apps/docs/content/docs/de/tools/incidentio.mdx new file mode 100644 index 0000000000..877fc8c9b6 --- /dev/null +++ b/apps/docs/content/docs/de/tools/incidentio.mdx @@ -0,0 +1,841 @@ +--- +title: incidentio +description: Verwalte Vorfälle mit incident.io +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +Verbessere dein Vorfallmanagement mit [incident.io](https://incident.io) – der führenden Plattform für die Orchestrierung von Vorfällen, die Optimierung von Reaktionsprozessen und die Nachverfolgung von Maßnahmen an einem Ort. Integriere incident.io nahtlos in deine automatisierten Arbeitsabläufe, um die Kontrolle über die Erstellung von Vorfällen, Echtzeit-Zusammenarbeit, Nachverfolgungen, Terminplanung, Eskalationen und vieles mehr zu übernehmen. + +Mit dem incident.io-Tool kannst du: + +- **Vorfälle auflisten und durchsuchen**: Rufe schnell eine Liste laufender oder historischer Vorfälle ab, komplett mit Metadaten wie Schweregrad, Status und Zeitstempeln, mit `incidentio_incidents_list`. +- **Neue Vorfälle erstellen**: Löse die Erstellung neuer Vorfälle programmatisch über `incidentio_incidents_create` aus, wobei du Schweregrad, Name, Typ und benutzerdefinierte Details angeben kannst, um sicherzustellen, dass nichts deine Reaktion verlangsamt. +- **Automatisiere Vorfallnachverfolgungen**: Nutze die leistungsstarke Automatisierung von incident.io, um sicherzustellen, dass wichtige Maßnahmen und Erkenntnisse nicht übersehen werden, was Teams hilft, Probleme zu lösen und Prozesse zu verbessern. +- **Arbeitsabläufe anpassen**: Integriere maßgeschneiderte Vorfalltypen, Schweregrade und benutzerdefinierte Felder, die auf die Bedürfnisse deiner Organisation zugeschnitten sind. +- **Bewährte Praktiken mit Zeitplänen & Eskalationen durchsetzen**: Optimiere Bereitschaftsdienste und Vorfallmanagement durch automatische Zuweisung, Benachrichtigung und Eskalation, wenn sich Situationen entwickeln. + +incident.io befähigt moderne Organisationen, schneller zu reagieren, Teams zu koordinieren und Erkenntnisse für kontinuierliche Verbesserung zu erfassen. Ob du SRE-, DevOps-, Sicherheits- oder IT-Vorfälle verwaltest, incident.io bringt zentralisierte, erstklassige Vorfallreaktion programmatisch in deine Agent-Workflows. + +**Verfügbare Schlüsseloperationen**: +- `incidentio_incidents_list`: Liste, paginiere und filtere Vorfälle mit vollständigen Details. +- `incidentio_incidents_create`: Eröffne programmatisch neue Vorfälle mit benutzerdefinierten Attributen und Kontrolle über Duplizierung (Idempotenz). +- ...und mehr in Zukunft! + +Verbessere deine Zuverlässigkeit, Verantwortlichkeit und betriebliche Exzellenz, indem du incident.io noch heute in deine Workflow-Automatisierungen integrierst. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanweisungen + +Integrieren Sie incident.io in den Workflow. Verwalten Sie Vorfälle, Maßnahmen, Nachverfolgungen, Workflows, Zeitpläne, Eskalationen, benutzerdefinierte Felder und mehr. + +## Tools + +### `incidentio_incidents_list` + +Listet Vorfälle von incident.io auf. Gibt eine Liste von Vorfällen mit ihren Details zurück, einschließlich Schweregrad, Status und Zeitstempeln. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `page_size` | number | Nein | Anzahl der Vorfälle, die pro Seite zurückgegeben werden sollen \(Standard: 25\) | +| `after` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `incidents` | array | Liste der Vorfälle | + +### `incidentio_incidents_create` + +Erstellt einen neuen Vorfall in incident.io. Erfordert idempotency_key, severity_id und visibility. Akzeptiert optional name, summary, type und status. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `idempotency_key` | string | Ja | Eindeutiger Identifikator zur Vermeidung doppelter Vorfallserstellung. Verwenden Sie eine UUID oder einen eindeutigen String. | +| `name` | string | Nein | Name des Vorfalls \(optional\) | +| `summary` | string | Nein | Kurze Zusammenfassung des Vorfalls | +| `severity_id` | string | Ja | ID des Schweregrads \(erforderlich\) | +| `incident_type_id` | string | Nein | ID des Vorfalltyps | +| `incident_status_id` | string | Nein | ID des anfänglichen Vorfallstatus | +| `visibility` | string | Ja | Sichtbarkeit des Vorfalls: "public" oder "private" \(erforderlich\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `incident` | object | Das erstellte Vorfall-Objekt | + +### `incidentio_incidents_show` + +Ruft detaillierte Informationen über einen bestimmten Vorfall von incident.io anhand seiner ID ab. Gibt vollständige Vorfalldetails zurück, einschließlich benutzerdefinierter Felder und Rollenzuweisungen. + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | ID des abzurufenden Vorfalls | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `incident` | object | Detaillierte Vorfallsinformationen | + +### `incidentio_incidents_update` + +Aktualisiert einen bestehenden Vorfall in incident.io. Kann Name, Zusammenfassung, Schweregrad, Status oder Typ aktualisieren. + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | ID des zu aktualisierenden Vorfalls | +| `name` | string | Nein | Aktualisierter Name des Vorfalls | +| `summary` | string | Nein | Aktualisierte Zusammenfassung des Vorfalls | +| `severity_id` | string | Nein | Aktualisierte Schweregrad-ID für den Vorfall | +| `incident_status_id` | string | Nein | Aktualisierte Status-ID für den Vorfall | +| `incident_type_id` | string | Nein | Aktualisierte Vorfalltyp-ID | +| `notify_incident_channel` | boolean | Ja | Ob der Vorfallkanal über diese Aktualisierung benachrichtigt werden soll | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `incident` | object | Das aktualisierte Vorfall-Objekt | + +### `incidentio_actions_list` + +Listet Aktionen von incident.io auf. Optional nach Vorfall-ID filtern. + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `incident_id` | string | Nein | Aktionen nach Vorfall-ID filtern | +| `page_size` | number | Nein | Anzahl der Aktionen, die pro Seite zurückgegeben werden sollen | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `actions` | array | Liste der Aktionen | + +### `incidentio_actions_show` + +Ruft detaillierte Informationen über eine bestimmte Aktion von incident.io ab. + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Aktions-ID | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `action` | object | Aktionsdetails | + +### `incidentio_follow_ups_list` + +Listet Follow-ups von incident.io auf. Optional nach Vorfall-ID filtern. + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `incident_id` | string | Nein | Follow-ups nach Vorfall-ID filtern | +| `page_size` | number | Nein | Anzahl der Follow-ups, die pro Seite zurückgegeben werden sollen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `follow_ups` | array | Liste der Follow-ups | + +### `incidentio_follow_ups_show` + +Erhalte detaillierte Informationen über ein bestimmtes Follow-up von incident.io. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Follow-up ID | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `follow_up` | object | Follow-up Details | + +### `incidentio_users_list` + +Liste alle Benutzer in deinem Incident.io Workspace auf. Gibt Benutzerdetails zurück, einschließlich ID, Name, E-Mail und Rolle. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Incident.io API-Schlüssel | +| `page_size` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard: 25\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `users` | array | Liste der Benutzer im Workspace | + +### `incidentio_users_show` + +Erhalte detaillierte Informationen über einen bestimmten Benutzer in deinem Incident.io Workspace anhand seiner ID. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Incident.io API-Schlüssel | +| `id` | string | Ja | Die eindeutige Kennung des abzurufenden Benutzers | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `user` | object | Details des angeforderten Benutzers | + +### `incidentio_workflows_list` + +Liste alle Workflows in deinem incident.io Workspace auf. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `page_size` | number | Nein | Anzahl der Workflows, die pro Seite zurückgegeben werden sollen | +| `after` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `workflows` | array | Liste der Workflows | + +### `incidentio_workflows_show` + +Rufe Details eines bestimmten Workflows in incident.io ab. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID des abzurufenden Workflows | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `workflow` | object | Die Workflow-Details | + +### `incidentio_workflows_update` + +Aktualisiere einen vorhandenen Workflow in incident.io. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID des zu aktualisierenden Workflows | +| `name` | string | Nein | Neuer Name für den Workflow | +| `state` | string | Nein | Neuer Status für den Workflow \(active, draft oder disabled\) | +| `folder` | string | Nein | Neuer Ordner für den Workflow | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `workflow` | object | Der aktualisierte Workflow | + +### `incidentio_workflows_delete` + +Löscht einen Workflow in incident.io. + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID des zu löschenden Workflows | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `message` | string | Erfolgsmeldung | + +### `incidentio_schedules_list` + +Listet alle Zeitpläne in incident.io auf + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `page_size` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard: 25\) | +| `after` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `schedules` | array | Liste der Zeitpläne | + +### `incidentio_schedules_create` + +Erstellt einen neuen Zeitplan in incident.io + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `name` | string | Ja | Name des Zeitplans | +| `timezone` | string | Ja | Zeitzone für den Zeitplan \(z.B. America/New_York\) | +| `config` | string | Ja | Zeitplankonfiguration als JSON-String mit Rotationen. Beispiel: \{"rotations": \[\{"name": "Primary", "users": \[\{"id": "user_id"\}\], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": \[\{"interval": 1, "interval_type": "weekly"\}\]\}\]\} | +| `Example` | string | Nein | Keine Beschreibung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `schedule` | object | Der erstellte Zeitplan | + +### `incidentio_schedules_show` + +Details zu einem bestimmten Zeitplan in incident.io abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID des Zeitplans | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `schedule` | object | Die Zeitplandetails | + +### `incidentio_schedules_update` + +Einen bestehenden Zeitplan in incident.io aktualisieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID des zu aktualisierenden Zeitplans | +| `name` | string | Nein | Neuer Name für den Zeitplan | +| `timezone` | string | Nein | Neue Zeitzone für den Zeitplan \(z.B. America/New_York\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `schedule` | object | Der aktualisierte Zeitplan | + +### `incidentio_schedules_delete` + +Einen Zeitplan in incident.io löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID des zu löschenden Zeitplans | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `message` | string | Erfolgsmeldung | + +### `incidentio_escalations_list` + +Alle Eskalationsrichtlinien in incident.io auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `page_size` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard: 25\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `escalations` | array | Liste der Eskalationsrichtlinien | + +### `incidentio_escalations_create` + +Eine neue Eskalationsrichtlinie in incident.io erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `idempotency_key` | string | Ja | Eindeutiger Identifikator zur Vermeidung doppelter Eskalationserstellung. Verwenden Sie eine UUID oder eindeutige Zeichenfolge. | +| `title` | string | Ja | Titel der Eskalation | +| `escalation_path_id` | string | Nein | ID des zu verwendenden Eskalationspfads \(erforderlich, wenn user_ids nicht angegeben wird\) | +| `user_ids` | string | Nein | Kommagetrennte Liste von Benutzer-IDs, die benachrichtigt werden sollen \(erforderlich, wenn escalation_path_id nicht angegeben wird\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `escalation` | object | Die erstellte Eskalationsrichtlinie | + +### `incidentio_escalations_show` + +Details zu einer bestimmten Eskalationsrichtlinie in incident.io abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID der Eskalationsrichtlinie | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `escalation` | object | Die Details der Eskalationsrichtlinie | + +### `incidentio_custom_fields_list` + +Listet alle benutzerdefinierten Felder von incident.io auf. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `custom_fields` | array | Liste der benutzerdefinierten Felder | + +### `incidentio_custom_fields_create` + +Erstellt ein neues benutzerdefiniertes Feld in incident.io. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `name` | string | Ja | Name des benutzerdefinierten Feldes | +| `description` | string | Ja | Beschreibung des benutzerdefinierten Feldes \(erforderlich\) | +| `field_type` | string | Ja | Typ des benutzerdefinierten Feldes \(z.B. text, single_select, multi_select, numeric, datetime, link, user, team\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `custom_field` | object | Erstelltes benutzerdefiniertes Feld | + +### `incidentio_custom_fields_show` + +Erhalten Sie detaillierte Informationen über ein bestimmtes benutzerdefiniertes Feld von incident.io. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Benutzerdefinierte Feld-ID | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `custom_field` | object | Details des benutzerdefinierten Feldes | + +### `incidentio_custom_fields_update` + +Aktualisieren Sie ein bestehendes benutzerdefiniertes Feld in incident.io. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Benutzerdefinierte Feld-ID | +| `name` | string | Ja | Neuer Name für das benutzerdefinierte Feld \(erforderlich\) | +| `description` | string | Ja | Neue Beschreibung für das benutzerdefinierte Feld \(erforderlich\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `custom_field` | object | Aktualisiertes benutzerdefiniertes Feld | + +### `incidentio_custom_fields_delete` + +Löschen Sie ein benutzerdefiniertes Feld von incident.io. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Benutzerdefinierte Feld-ID | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `message` | string | Erfolgsmeldung | + +### `incidentio_severities_list` + +Liste alle konfigurierten Schweregrade in deinem Incident.io Workspace auf. Gibt Schweregrad-Details zurück, einschließlich ID, Name, Beschreibung und Rang. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Incident.io API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `severities` | array | Liste der Schweregrade | + +### `incidentio_incident_statuses_list` + +Liste alle konfigurierten Vorfallstatus in deinem Incident.io Workspace auf. Gibt Status-Details zurück, einschließlich ID, Name, Beschreibung und Kategorie. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Incident.io API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `incident_statuses` | array | Liste der Vorfallstatus | + +### `incidentio_incident_types_list` + +Liste alle konfigurierten Vorfalltypen in deinem Incident.io Workspace auf. Gibt Typ-Details zurück, einschließlich ID, Name, Beschreibung und Standard-Flag. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Incident.io API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `incident_types` | array | Liste der Vorfalltypen | + +### `incidentio_incident_roles_list` + +Liste alle Vorfallrollen in incident.io auf + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `incident_roles` | array | Liste der Vorfallrollen | + +### `incidentio_incident_roles_create` + +Eine neue Vorfallrolle in incident.io erstellen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `name` | string | Ja | Name der Vorfallrolle | +| `description` | string | Ja | Beschreibung der Vorfallrolle | +| `instructions` | string | Ja | Anweisungen für die Vorfallrolle | +| `shortform` | string | Ja | Kurzform-Abkürzung für die Rolle | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `incident_role` | object | Die erstellte Vorfallrolle | + +### `incidentio_incident_roles_show` + +Details zu einer bestimmten Vorfallrolle in incident.io abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID der Vorfallrolle | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `incident_role` | object | Die Details der Vorfallrolle | + +### `incidentio_incident_roles_update` + +Eine bestehende Vorfallrolle in incident.io aktualisieren + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID der zu aktualisierenden Vorfallrolle | +| `name` | string | Ja | Name der Vorfallrolle | +| `description` | string | Ja | Beschreibung der Vorfallrolle | +| `instructions` | string | Ja | Anweisungen für die Vorfallrolle | +| `shortform` | string | Ja | Kurzform-Abkürzung für die Rolle | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `incident_role` | object | Die aktualisierte Vorfallrolle | + +### `incidentio_incident_roles_delete` + +Eine Vorfallrolle in incident.io löschen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID der zu löschenden Vorfallrolle | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `message` | string | Erfolgsmeldung | + +### `incidentio_incident_timestamps_list` + +Alle Vorfallzeitstempel-Definitionen in incident.io auflisten + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `incident_timestamps` | array | Liste der Vorfallzeitstempel-Definitionen | + +### `incidentio_incident_timestamps_show` + +Details einer bestimmten Vorfallzeitstempel-Definition in incident.io abrufen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID des Vorfallzeitstempels | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `incident_timestamp` | object | Die Details des Vorfallzeitstempels | + +### `incidentio_incident_updates_list` + +Alle Updates für einen bestimmten Vorfall in incident.io auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `incident_id` | string | Nein | Die ID des Vorfalls, für den Updates abgerufen werden sollen \(optional - wenn nicht angegeben, werden alle Updates zurückgegeben\) | +| `page_size` | number | Nein | Anzahl der Ergebnisse pro Seite | +| `after` | string | Nein | Cursor für Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `incident_updates` | array | Liste der Vorfallaktualisierungen | + +### `incidentio_schedule_entries_list` + +Alle Einträge für einen bestimmten Zeitplan in incident.io auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `schedule_id` | string | Ja | Die ID des Zeitplans, für den Einträge abgerufen werden sollen | +| `entry_window_start` | string | Nein | Startdatum/-zeit zur Filterung der Einträge \(ISO 8601-Format\) | +| `entry_window_end` | string | Nein | Enddatum/-zeit zur Filterung der Einträge \(ISO 8601-Format\) | +| `page_size` | number | Nein | Anzahl der Ergebnisse pro Seite | +| `after` | string | Nein | Cursor für Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `schedule_entries` | array | Liste der Zeitplaneinträge | + +### `incidentio_schedule_overrides_create` + +Erstellen Sie eine neue Zeitplanüberschreibung in incident.io + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `rotation_id` | string | Ja | Die ID der zu überschreibenden Rotation | +| `schedule_id` | string | Ja | Die ID des Zeitplans | +| `user_id` | string | Nein | Die ID des zuzuweisenden Benutzers \(geben Sie eines an: user_id, user_email oder user_slack_id\) | +| `user_email` | string | Nein | Die E-Mail des zuzuweisenden Benutzers \(geben Sie eines an: user_id, user_email oder user_slack_id\) | +| `user_slack_id` | string | Nein | Die Slack-ID des zuzuweisenden Benutzers \(geben Sie eines an: user_id, user_email oder user_slack_id\) | +| `start_at` | string | Ja | Wann die Überschreibung beginnt \(ISO 8601-Format\) | +| `end_at` | string | Ja | Wann die Überschreibung endet \(ISO 8601-Format\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `override` | object | Die erstellte Zeitplanüberschreibung | + +### `incidentio_escalation_paths_create` + +Erstellen Sie einen neuen Eskalationspfad in incident.io + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `name` | string | Ja | Name des Eskalationspfads | +| `path` | json | Ja | Array von Eskalationsstufen mit Zielen und Bestätigungszeit in Sekunden. Jede Stufe sollte enthalten: targets \(Array von \{id, type, schedule_id?, user_id?, urgency\}\) und time_to_ack_seconds \(Zahl\) | +| `working_hours` | json | Nein | Optionale Konfiguration der Arbeitszeiten. Array von \{weekday, start_time, end_time\} | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `escalation_path` | object | Der erstellte Eskalationspfad | + +### `incidentio_escalation_paths_show` + +Details zu einem bestimmten Eskalationspfad in incident.io abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID des Eskalationspfads | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `escalation_path` | object | Die Details des Eskalationspfads | + +### `incidentio_escalation_paths_update` + +Einen bestehenden Eskalationspfad in incident.io aktualisieren + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID des zu aktualisierenden Eskalationspfads | +| `name` | string | Nein | Neuer Name für den Eskalationspfad | +| `path` | json | Nein | Neue Konfiguration des Eskalationspfads. Array von Eskalationsstufen mit Zielen und time_to_ack_seconds | +| `working_hours` | json | Nein | Neue Konfiguration der Arbeitszeiten. Array von \{weekday, start_time, end_time\} | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `escalation_path` | object | Der aktualisierte Eskalationspfad | + +### `incidentio_escalation_paths_delete` + +Einen Eskalationspfad in incident.io löschen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | incident.io API-Schlüssel | +| `id` | string | Ja | Die ID des zu löschenden Eskalationspfads | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `message` | string | Erfolgsmeldung | + +## Hinweise + +- Kategorie: `tools` +- Typ: `incidentio` diff --git a/apps/docs/content/docs/de/tools/knowledge.mdx b/apps/docs/content/docs/de/tools/knowledge.mdx index 2789ea3d45..7264cb3912 100644 --- a/apps/docs/content/docs/de/tools/knowledge.mdx +++ b/apps/docs/content/docs/de/tools/knowledge.mdx @@ -40,10 +40,14 @@ Suche nach ähnlichen Inhalten in einer Wissensdatenbank mittels Vektorähnlichk | Parameter | Typ | Erforderlich | Beschreibung | | --------- | ---- | -------- | ----------- | -| `knowledgeBaseId` | string | Ja | ID der Wissensdatenbank, in der gesucht werden soll | +| `knowledgeBaseId` | string | Ja | ID der zu durchsuchenden Wissensdatenbank | | `query` | string | Nein | Suchanfragentext \(optional bei Verwendung von Tag-Filtern\) | | `topK` | number | Nein | Anzahl der ähnlichsten Ergebnisse, die zurückgegeben werden sollen \(1-100\) | | `tagFilters` | array | Nein | Array von Tag-Filtern mit tagName- und tagValue-Eigenschaften | +| `items` | object | Nein | Keine Beschreibung | +| `properties` | string | Nein | Keine Beschreibung | +| `tagName` | string | Nein | Keine Beschreibung | +| `tagValue` | string | Nein | Keine Beschreibung | #### Ausgabe @@ -88,6 +92,11 @@ Ein neues Dokument in einer Wissensdatenbank erstellen | `tag6` | string | Nein | Tag 6-Wert für das Dokument | | `tag7` | string | Nein | Tag 7-Wert für das Dokument | | `documentTagsData` | array | Nein | Strukturierte Tag-Daten mit Namen, Typen und Werten | +| `items` | object | Nein | Keine Beschreibung | +| `properties` | string | Nein | Keine Beschreibung | +| `tagName` | string | Nein | Keine Beschreibung | +| `tagValue` | string | Nein | Keine Beschreibung | +| `tagType` | string | Nein | Keine Beschreibung | #### Ausgabe diff --git a/apps/docs/content/docs/de/tools/posthog.mdx b/apps/docs/content/docs/de/tools/posthog.mdx new file mode 100644 index 0000000000..b48d7821b7 --- /dev/null +++ b/apps/docs/content/docs/de/tools/posthog.mdx @@ -0,0 +1,1112 @@ +--- +title: PostHog +description: Produktanalyse und Feature-Management +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +Das [PostHog](https://posthog.com/) Tool integriert leistungsstarke Produktanalysen, Feature-Flag-Management, Experimente und Einblicke in das Nutzerverhalten direkt in Ihre agentischen Workflows. Es wurde für moderne Teams entwickelt und ermöglicht es Ihnen, Nutzerdaten in Echtzeit zu erfassen, zu analysieren und darauf zu reagieren – so können Sie bessere Produkte entwickeln, das Engagement verstehen und Konversionen steigern. + +Mit dem PostHog Tool können Sie: + +- **Events verfolgen und analysieren**: Nutzen Sie die `posthog_capture_event` und `posthog_batch_events` Operationen, um einzelne oder mehrere Nutzeraktionen, Seitenaufrufe oder benutzerdefinierte Events für tiefgehende Analysen aufzuzeichnen. +- **Event-Daten erkunden**: Rufen Sie historische oder Echtzeit-Events mit der `posthog_list_events` Operation ab und listen Sie diese für erweiterte Event-Analysen auf. +- **Nutzer verstehen**: Nutzen Sie die `posthog_list_persons`, `posthog_get_person` und `posthog_delete_person` Operationen, um Nutzerprofile zu verwalten, detaillierte Nutzereinblicke zu erhalten oder sie bei Bedarf zu entfernen. +- **Umsetzbare Produkteinblicke gewinnen**: Visualisieren Sie Nutzerreisen, Feature-Nutzung und Engagement über `posthog_list_insights`, `posthog_get_insight` und `posthog_create_insight` Operationen. +- **Features sicher verwalten und ausrollen**: Schalten Sie Features um und führen Sie A/B- oder multivariate Tests im großen Maßstab durch, mit Operationen wie `posthog_list_feature_flags`, `posthog_get_feature_flag`, `posthog_create_feature_flag`, `posthog_update_feature_flag` und `posthog_delete_feature_flag`. +- **Zielgruppen segmentieren und ansprechen**: Erstellen, listen oder verwalten Sie Kohorten mit `posthog_list_cohorts`, `posthog_get_cohort` und `posthog_create_cohort`. +- **Direktes Feedback sammeln**: Entwerfen, implementieren und analysieren Sie Umfragen durch `posthog_list_surveys`, `posthog_get_survey`, `posthog_create_survey` und `posthog_update_survey`. +- **Nutzererfahrung überwachen**: Greifen Sie auf Sitzungsaufzeichnungen zu und analysieren Sie diese über die `posthog_list_session_recordings` und `posthog_get_session_recording` Operationen. +- **Mit Ihrem Team zusammenarbeiten**: Organisieren Sie Dashboards (`posthog_list_dashboards`, `posthog_get_dashboard`), erstellen und kommentieren Sie Insights und Events und verwalten Sie Projekte und Organisationen innerhalb von PostHog. + +Ob Sie umfassende Produktanalysen implementieren, das Onboarding von Benutzern verbessern, Ihre Produkt-Roadmap verfeinern oder Entscheidungen auf Basis echter Nutzungsdaten automatisieren möchten – das PostHog-Tool stattet Ihre Agenten und Workflows mit fortschrittlichen Analysen und produktinternen Experimenten aus – alles auf einer einheitlichen Plattform. + +Suchen Sie nach echter Produktanalyse mit Datenschutz, Skalierbarkeit und einer Open-Source-Option? PostHog wird von schnell agierenden Teams und Unternehmen weltweit vertraut. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanleitung + +Integrieren Sie PostHog in Ihren Workflow. Verfolgen Sie Ereignisse, verwalten Sie Feature-Flags, analysieren Sie Benutzerverhalten, führen Sie Experimente durch, erstellen Sie Umfragen und greifen Sie auf Sitzungsaufzeichnungen zu. + +## Tools + +### `posthog_capture_event` + +Erfassen Sie ein einzelnes Ereignis in PostHog. Verwenden Sie dies, um Benutzeraktionen, Seitenaufrufe oder benutzerdefinierte Ereignisse zu verfolgen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectApiKey` | string | Ja | PostHog Projekt-API-Schlüssel \(öffentliches Token für die Ereigniserfassung\) | +| `region` | string | Nein | PostHog-Region: us \(Standard\) oder eu | +| `event` | string | Ja | Der Name des zu erfassenden Ereignisses \(z.B. "page_view", "button_clicked"\) | +| `distinctId` | string | Ja | Eindeutige Kennung für den Benutzer oder das Gerät. Kann Benutzer-ID, Geräte-ID oder anonyme ID sein | +| `properties` | string | Nein | JSON-String der Ereigniseigenschaften \(z.B. \{"button_name": "signup", "page": "homepage"\}\) | +| `timestamp` | string | Nein | ISO 8601-Zeitstempel für den Zeitpunkt des Ereignisses. Wenn nicht angegeben, wird die aktuelle Zeit verwendet | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `status` | string | Statusmeldung, die angibt, ob das Ereignis erfolgreich erfasst wurde | + +### `posthog_batch_events` + +Erfassen Sie mehrere Ereignisse auf einmal in PostHog. Verwenden Sie dies für die Massenerfassung von Ereignissen, um die Leistung zu verbessern. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectApiKey` | string | Ja | PostHog Projekt-API-Schlüssel \(öffentliches Token für die Ereigniserfassung\) | +| `region` | string | Nein | PostHog-Region: us \(Standard\) oder eu | +| `batch` | string | Ja | JSON-Array von zu erfassenden Ereignissen. Jedes Ereignis sollte enthalten: event, distinct_id und optionale properties, timestamp. Beispiel: \[\{"event": "page_view", "distinct_id": "user123", "properties": \{"page": "/"\}\}\] | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `status` | string | Statusmeldung, die angibt, ob der Batch erfolgreich erfasst wurde | +| `eventsProcessed` | number | Anzahl der im Batch verarbeiteten Ereignisse | + +### `posthog_list_events` + +Ereignisse in PostHog auflisten. Hinweis: Dieser Endpunkt ist veraltet, wird aber aus Gründen der Abwärtskompatibilität beibehalten. Für den Produktionseinsatz sollten Sie den Query-Endpunkt mit HogQL bevorzugen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Ja | PostHog Persönlicher API-Schlüssel \(für authentifizierten API-Zugriff\) | +| `region` | string | Nein | PostHog-Region: us \(Standard\) oder eu | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `limit` | number | Nein | Anzahl der zurückzugebenden Ereignisse \(Standard: 100, max: 100\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ereignisse für die Paginierung | +| `event` | string | Nein | Nach bestimmtem Ereignisnamen filtern | +| `distinctId` | string | Nein | Nach bestimmter distinct_id filtern | +| `before` | string | Nein | ISO 8601 Zeitstempel - nur Ereignisse vor diesem Zeitpunkt zurückgeben | +| `after` | string | Nein | ISO 8601 Zeitstempel - nur Ereignisse nach diesem Zeitpunkt zurückgeben | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `events` | array | Liste von Ereignissen mit ihren Eigenschaften und Metadaten | + +### `posthog_list_persons` + +Listet Personen (Benutzer) in PostHog auf. Gibt Benutzerprofile mit ihren Eigenschaften und eindeutigen IDs zurück. + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Ja | PostHog persönlicher API-Schlüssel \(für authentifizierten API-Zugriff\) | +| `region` | string | Nein | PostHog-Region: us \(Standard\) oder eu | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `limit` | number | Nein | Anzahl der zurückzugebenden Personen \(Standard: 100, max: 100\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Personen für Paginierung | +| `search` | string | Nein | Personen nach E-Mail, Name oder eindeutiger ID durchsuchen | +| `distinctId` | string | Nein | Nach bestimmter distinct_id filtern | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `persons` | array | Liste von Personen mit ihren Eigenschaften und Kennungen | + +### `posthog_get_person` + +Ruft detaillierte Informationen über eine bestimmte Person in PostHog anhand ihrer ID oder UUID ab. + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Ja | PostHog persönlicher API-Schlüssel \(für authentifizierten API-Zugriff\) | +| `region` | string | Nein | PostHog-Region: us \(Standard\) oder eu | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `personId` | string | Ja | Personen-ID oder UUID, die abgerufen werden soll | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `person` | object | Personendetails einschließlich Eigenschaften und Kennungen | + +### `posthog_delete_person` + +Löscht eine Person aus PostHog. Dies entfernt alle zugehörigen Ereignisse und Daten. Mit Vorsicht verwenden. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Ja | PostHog persönlicher API-Schlüssel \(für authentifizierten API-Zugriff\) | +| `region` | string | Nein | PostHog-Region: us \(Standard\) oder eu | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `personId` | string | Ja | Personen-ID oder UUID zum Löschen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `status` | string | Statusmeldung, die angibt, ob die Person erfolgreich gelöscht wurde | + +### `posthog_query` + +Führt eine HogQL-Abfrage in PostHog aus. HogQL ist PostHog + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Ja | PostHog persönlicher API-Schlüssel \(für authentifizierten API-Zugriff\) | +| `region` | string | Nein | PostHog-Region: us \(Standard\) oder eu | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `query` | string | Ja | HogQL-Abfrage zur Ausführung. Beispiel: \{"kind": "HogQLQuery", "query": "SELECT event, count\(\) FROM events WHERE timestamp > now\(\) - INTERVAL 1 DAY GROUP BY event"\} | +| `Example` | string | Nein | Keine Beschreibung | +| `values` | string | Nein | Optionaler JSON-String mit Parameterwerten für parametrisierte Abfragen. Beispiel: \{"user_id": "123"\} | +| `Example` | string | Nein | Keine Beschreibung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `results` | array | Abfrageergebnisse als Array von Zeilen | + +### `posthog_list_insights` + +Listet alle Insights in einem PostHog-Projekt auf. Gibt Insight-Konfigurationen, Filter und Metadaten zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | PostHog persönlicher API-Schlüssel | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `region` | string | Nein | PostHog Cloud-Region: "us" oder "eu" \(Standard: "us"\) | +| `limit` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard: 100\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für die Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `count` | number | Gesamtanzahl der Insights im Projekt | +| `next` | string | URL für die nächste Ergebnisseite | +| `previous` | string | URL für die vorherige Ergebnisseite | +| `results` | array | Liste der Insights mit ihren Konfigurationen und Metadaten | + +### `posthog_get_insight` + +Ruft einen bestimmten Insight anhand der ID von PostHog ab. Gibt detaillierte Insight-Konfiguration, Filter und Metadaten zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | PostHog persönlicher API-Schlüssel | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `insightId` | string | Ja | Die abzurufende Insight-ID | +| `region` | string | Nein | PostHog Cloud-Region: "us" oder "eu" \(Standard: "us"\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `id` | number | Eindeutige Kennung für die Erkenntnis | +| `name` | string | Name der Erkenntnis | +| `description` | string | Beschreibung der Erkenntnis | +| `filters` | object | Filterkonfiguration für die Erkenntnis | +| `query` | object | Abfragekonfiguration für die Erkenntnis | +| `created_at` | string | ISO-Zeitstempel der Erstellung der Erkenntnis | +| `created_by` | object | Benutzer, der die Erkenntnis erstellt hat | +| `last_modified_at` | string | ISO-Zeitstempel der letzten Änderung der Erkenntnis | +| `last_modified_by` | object | Benutzer, der die Erkenntnis zuletzt geändert hat | +| `saved` | boolean | Ob die Erkenntnis gespeichert ist | +| `dashboards` | array | IDs der Dashboards, auf denen diese Erkenntnis erscheint | +| `tags` | array | Tags, die mit der Erkenntnis verknüpft sind | +| `favorited` | boolean | Ob die Erkenntnis als Favorit markiert ist | + +### `posthog_create_insight` + +Erstellt eine neue Erkenntnis in PostHog. Erfordert den Namen der Erkenntnis und Konfigurationsfilter oder Abfrage. + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | PostHog persönlicher API-Schlüssel | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `region` | string | Nein | PostHog Cloud-Region: "us" oder "eu" \(Standard: "us"\) | +| `name` | string | Nein | Name für die Erkenntnis \(optional - PostHog generiert einen abgeleiteten Namen, wenn keiner angegeben wird\) | +| `description` | string | Nein | Beschreibung der Erkenntnis | +| `filters` | string | Nein | JSON-String der Filterkonfiguration für die Erkenntnis | +| `query` | string | Nein | JSON-String der Abfragekonfiguration für die Erkenntnis | +| `dashboards` | string | Nein | Kommagetrennte Liste von Dashboard-IDs, zu denen diese Erkenntnis hinzugefügt werden soll | +| `tags` | string | Nein | Kommagetrennte Liste von Tags für die Erkenntnis | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `id` | number | Eindeutige Kennung für die erstellte Erkenntnis | +| `name` | string | Name der Erkenntnis | +| `description` | string | Beschreibung der Erkenntnis | +| `filters` | object | Filterkonfiguration für die Erkenntnis | +| `query` | object | Abfragekonfiguration für die Erkenntnis | +| `created_at` | string | ISO-Zeitstempel der Erstellung der Erkenntnis | +| `created_by` | object | Benutzer, der die Erkenntnis erstellt hat | +| `last_modified_at` | string | ISO-Zeitstempel der letzten Änderung der Erkenntnis | +| `saved` | boolean | Ob die Erkenntnis gespeichert ist | +| `dashboards` | array | IDs der Dashboards, auf denen diese Erkenntnis erscheint | +| `tags` | array | Mit der Erkenntnis verknüpfte Tags | + +### `posthog_list_dashboards` + +Listet alle Dashboards in einem PostHog-Projekt auf. Gibt Dashboard-Konfigurationen, Kacheln und Metadaten zurück. + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `region` | string | Nein | PostHog-Cloud-Region: "us" oder "eu" \(Standard: "us"\) | +| `limit` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard: 100\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für die Paginierung | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `count` | number | Gesamtanzahl der Dashboards im Projekt | +| `next` | string | URL für die nächste Ergebnisseite | +| `previous` | string | URL für die vorherige Ergebnisseite | +| `results` | array | Liste der Dashboards mit ihren Konfigurationen und Metadaten | + +### `posthog_get_dashboard` + +Ruft ein bestimmtes Dashboard anhand der ID von PostHog ab. Gibt detaillierte Dashboard-Konfiguration, Kacheln und Metadaten zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | PostHog persönlicher API-Schlüssel | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `dashboardId` | string | Ja | Die abzurufende Dashboard-ID | +| `region` | string | Nein | PostHog Cloud-Region: "us" oder "eu" \(Standard: "us"\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `id` | number | Eindeutige Kennung für das Dashboard | +| `name` | string | Name des Dashboards | +| `description` | string | Beschreibung des Dashboards | +| `pinned` | boolean | Ob das Dashboard angeheftet ist | +| `created_at` | string | ISO-Zeitstempel der Dashboard-Erstellung | +| `created_by` | object | Benutzer, der das Dashboard erstellt hat | +| `last_modified_at` | string | ISO-Zeitstempel der letzten Dashboard-Änderung | +| `last_modified_by` | object | Benutzer, der das Dashboard zuletzt geändert hat | +| `tiles` | array | Kacheln/Widgets auf dem Dashboard mit ihren Konfigurationen | +| `filters` | object | Globale Filter, die auf das Dashboard angewendet werden | +| `tags` | array | Mit dem Dashboard verknüpfte Tags | +| `restriction_level` | number | Zugangsbeschränkungsstufe für das Dashboard | + +### `posthog_list_actions` + +Listet alle Aktionen in einem PostHog-Projekt auf. Gibt Aktionsdefinitionen, Schritte und Metadaten zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog API-Schlüssel | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `region` | string | Nein | PostHog Cloud-Region: "us" oder "eu" \(Standard: "us"\) | +| `limit` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard: 100\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für die Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `count` | number | Gesamtanzahl der Aktionen im Projekt | +| `next` | string | URL für die nächste Ergebnisseite | +| `previous` | string | URL für die vorherige Ergebnisseite | +| `results` | array | Liste der Aktionen mit ihren Definitionen und Metadaten | + +### `posthog_list_cohorts` + +Listet alle Kohorten in einem PostHog-Projekt auf. Gibt Kohortendefinitionen, Filter und Benutzerzahlen zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog API-Schlüssel | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `region` | string | Nein | PostHog Cloud-Region: "us" oder "eu" \(Standard: "us"\) | +| `limit` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard: 100\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für die Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `count` | number | Gesamtanzahl der Kohorten im Projekt | +| `next` | string | URL für die nächste Ergebnisseite | +| `previous` | string | URL für die vorherige Ergebnisseite | +| `results` | array | Liste der Kohorten mit ihren Definitionen und Metadaten | + +### `posthog_get_cohort` + +Ruft eine bestimmte Kohorte anhand der ID von PostHog ab. Gibt detaillierte Kohortendefinition, Filter und Benutzeranzahl zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog API-Schlüssel | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `cohortId` | string | Ja | Die abzurufende Kohorten-ID | +| `region` | string | Nein | PostHog-Cloud-Region: "us" oder "eu" \(Standard: "us"\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `id` | number | Eindeutige Kennung für die Kohorte | +| `name` | string | Name der Kohorte | +| `description` | string | Beschreibung der Kohorte | +| `groups` | array | Gruppen, die die Kohorte definieren | +| `deleted` | boolean | Ob die Kohorte gelöscht wurde | +| `filters` | object | Filterkonfiguration für die Kohorte | +| `query` | object | Abfragekonfiguration für die Kohorte | +| `created_at` | string | ISO-Zeitstempel der Erstellung der Kohorte | +| `created_by` | object | Benutzer, der die Kohorte erstellt hat | +| `is_calculating` | boolean | Ob die Kohorte gerade berechnet wird | +| `last_calculation` | string | ISO-Zeitstempel der letzten Berechnung | +| `errors_calculating` | number | Anzahl der Fehler während der Berechnung | +| `count` | number | Anzahl der Benutzer in der Kohorte | +| `is_static` | boolean | Ob die Kohorte statisch ist | +| `version` | number | Versionsnummer der Kohorte | + +### `posthog_create_cohort` + +Erstelle eine neue Kohorte in PostHog. Erfordert Kohortenname und Filter- oder Abfragekonfiguration. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog API-Schlüssel | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `region` | string | Nein | PostHog Cloud-Region: "us" oder "eu" \(Standard: "us"\) | +| `name` | string | Nein | Name für die Kohorte \(optional - PostHog verwendet "Untitled cohort", wenn nicht angegeben\) | +| `description` | string | Nein | Beschreibung der Kohorte | +| `filters` | string | Nein | JSON-String der Filterkonfiguration für die Kohorte | +| `query` | string | Nein | JSON-String der Abfragekonfiguration für die Kohorte | +| `is_static` | boolean | Nein | Ob die Kohorte statisch ist \(Standard: false\) | +| `groups` | string | Nein | JSON-String der Gruppen, die die Kohorte definieren | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `id` | number | Eindeutige Kennung für die erstellte Kohorte | +| `name` | string | Name der Kohorte | +| `description` | string | Beschreibung der Kohorte | +| `groups` | array | Gruppen, die die Kohorte definieren | +| `deleted` | boolean | Ob die Kohorte gelöscht wurde | +| `filters` | object | Filterkonfiguration für die Kohorte | +| `query` | object | Abfragekonfiguration für die Kohorte | +| `created_at` | string | ISO-Zeitstempel der Erstellung der Kohorte | +| `created_by` | object | Benutzer, der die Kohorte erstellt hat | +| `is_calculating` | boolean | Ob die Kohorte gerade berechnet wird | +| `count` | number | Anzahl der Benutzer in der Kohorte | +| `is_static` | boolean | Ob die Kohorte statisch ist | +| `version` | number | Versionsnummer der Kohorte | + +### `posthog_list_annotations` + +Listet alle Anmerkungen in einem PostHog-Projekt auf. Gibt Anmerkungsinhalte, Zeitstempel und zugehörige Insights zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `region` | string | Nein | PostHog-Cloud-Region: "us" oder "eu" \(Standard: "us"\) | +| `limit` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard: 100\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für die Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `count` | number | Gesamtanzahl der Anmerkungen im Projekt | +| `next` | string | URL für die nächste Ergebnisseite | +| `previous` | string | URL für die vorherige Ergebnisseite | +| `results` | array | Liste der Anmerkungen mit ihren Inhalten und Metadaten | + +### `posthog_create_annotation` + +Erstellt eine neue Anmerkung in PostHog. Markiert wichtige Ereignisse auf Ihren Grafiken mit Datum und Beschreibung. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `region` | string | Nein | PostHog-Cloud-Region: "us" oder "eu" \(Standard: "us"\) | +| `content` | string | Ja | Inhalt/Text der Anmerkung | +| `date_marker` | string | Ja | ISO-Zeitstempel, der angibt, wann die Anmerkung gilt \(z.B. "2024-01-15T10:00:00Z"\) | +| `scope` | string | Nein | Geltungsbereich der Anmerkung: "project" oder "dashboard_item" \(Standard: "project"\) | +| `dashboard_item` | string | Nein | ID des Dashboard-Elements, an das diese Anmerkung angehängt werden soll | +| `insight_short_id` | string | Nein | Kurz-ID des Insights, an das diese Anmerkung angehängt werden soll | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `id` | number | Eindeutige Kennung für die erstellte Anmerkung | +| `content` | string | Inhalt/Text der Anmerkung | +| `date_marker` | string | ISO-Zeitstempel, der angibt, wann die Anmerkung gilt | +| `created_at` | string | ISO-Zeitstempel, wann die Anmerkung erstellt wurde | +| `updated_at` | string | ISO-Zeitstempel, wann die Anmerkung zuletzt aktualisiert wurde | +| `created_by` | object | Benutzer, der die Anmerkung erstellt hat | +| `dashboard_item` | number | ID des Dashboard-Elements, an das diese Anmerkung angehängt ist | +| `insight_short_id` | string | Kurz-ID der Erkenntnis, an die diese Anmerkung angehängt ist | +| `insight_name` | string | Name der Erkenntnis, an die diese Anmerkung angehängt ist | +| `scope` | string | Geltungsbereich der Anmerkung \(Projekt oder Dashboard-Element\) | +| `deleted` | boolean | Ob die Anmerkung gelöscht ist | + +### `posthog_list_feature_flags` + +Alle Feature-Flags in einem PostHog-Projekt auflisten + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `region` | string | Ja | PostHog-Cloud-Region: us oder eu | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | +| `limit` | number | Nein | Anzahl der zurückzugebenden Ergebnisse | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `results` | array | Liste der Feature-Flags | + +### `posthog_get_feature_flag` + +Details zu einem bestimmten Feature-Flag abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `flagId` | string | Ja | Die Feature-Flag-ID | +| `region` | string | Ja | PostHog-Cloud-Region: us oder eu | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `flag` | object | Feature-Flag-Details | + +### `posthog_create_feature_flag` + +Ein neues Feature-Flag in PostHog erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `region` | string | Ja | PostHog-Cloud-Region: us oder eu | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | +| `name` | string | Nein | Feature-Flag-Name (optional - kann leer sein) | +| `key` | string | Ja | Feature-Flag-Schlüssel (eindeutiger Bezeichner) | +| `filters` | string | Nein | Feature-Flag-Filter als JSON-String | +| `active` | boolean | Nein | Ob das Flag aktiv ist (Standard: true) | +| `ensureExperienceContinuity` | boolean | Nein | Ob die Erfahrungskontinuität sichergestellt werden soll (Standard: false) | +| `rolloutPercentage` | number | Nein | Rollout-Prozentsatz (0-100) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `flag` | object | Erstelltes Feature-Flag | + +### `posthog_update_feature_flag` + +Aktualisieren eines vorhandenen Feature-Flags in PostHog + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `flagId` | string | Ja | Die Feature-Flag-ID | +| `region` | string | Ja | PostHog-Cloud-Region: us oder eu | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | +| `name` | string | Nein | Name des Feature-Flags | +| `key` | string | Nein | Feature-Flag-Schlüssel \(eindeutiger Bezeichner\) | +| `filters` | string | Nein | Feature-Flag-Filter als JSON-String | +| `active` | boolean | Nein | Ob das Flag aktiv ist | +| `ensureExperienceContinuity` | boolean | Nein | Ob die Erfahrungskontinuität sichergestellt werden soll | +| `rolloutPercentage` | number | Nein | Rollout-Prozentsatz \(0-100\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `flag` | object | Aktualisiertes Feature-Flag | + +### `posthog_delete_feature_flag` + +Löschen eines Feature-Flags aus PostHog + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `flagId` | string | Ja | Die zu löschende Feature-Flag-ID | +| `region` | string | Ja | PostHog-Cloud-Region: us oder eu | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Ob die Löschung erfolgreich war | +| `message` | string | Bestätigungsnachricht | + +### `posthog_evaluate_flags` + +Feature-Flags für einen bestimmten Benutzer oder eine Gruppe auswerten. Dies ist ein öffentlicher Endpunkt, der den Projekt-API-Schlüssel verwendet. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `region` | string | Ja | PostHog Cloud-Region: us oder eu | +| `projectApiKey` | string | Ja | PostHog Projekt-API-Schlüssel \(kein persönlicher API-Schlüssel\) | +| `distinctId` | string | Ja | Die eindeutige ID des Benutzers, für den Flags ausgewertet werden sollen | +| `groups` | string | Nein | Gruppen als JSON-String \(z.B. \{"company": "company_id_in_your_db"\}\) | +| `personProperties` | string | Nein | Personeneigenschaften als JSON-String | +| `groupProperties` | string | Nein | Gruppeneigenschaften als JSON-String | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `featureFlags` | object | Feature-Flag-Auswertungen \(Schlüssel-Wert-Paare, wobei Werte boolesch oder String-Varianten sind\) | +| `featureFlagPayloads` | object | Zusätzliche Nutzlasten, die an Feature-Flags angehängt sind | +| `errorsWhileComputingFlags` | boolean | Ob es Fehler bei der Berechnung der Flags gab | + +### `posthog_list_experiments` + +Alle Experimente in einem PostHog-Projekt auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `region` | string | Ja | PostHog Cloud-Region: us oder eu | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | +| `limit` | number | Nein | Anzahl der zurückzugebenden Ergebnisse | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `results` | array | Liste der Experimente | + +### `posthog_get_experiment` + +Details zu einem bestimmten Experiment abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `experimentId` | string | Ja | Die Experiment-ID | +| `region` | string | Ja | PostHog-Cloud-Region: us oder eu | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `experiment` | object | Experimentdetails | + +### `posthog_create_experiment` + +Ein neues Experiment in PostHog erstellen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Die PostHog-Projekt-ID | +| `region` | string | Ja | PostHog-Cloud-Region: us oder eu | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | +| `name` | string | Nein | Experimentname (optional) | +| `description` | string | Nein | Experimentbeschreibung | +| `featureFlagKey` | string | Ja | Feature-Flag-Schlüssel für das Experiment | +| `parameters` | string | Nein | Experimentparameter als JSON-String | +| `filters` | string | Nein | Experimentfilter als JSON-String | +| `variants` | string | Nein | Experimentvarianten als JSON-String | +| `startDate` | string | Nein | Startdatum des Experiments (ISO-Format) | +| `endDate` | string | Nein | Enddatum des Experiments (ISO-Format) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `experiment` | object | Erstelltes Experiment | + +### `posthog_list_surveys` + +Liste aller Umfragen in einem PostHog-Projekt. Umfragen ermöglichen es Ihnen, Feedback von Benutzern zu sammeln. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | +| `projectId` | string | Ja | PostHog-Projekt-ID | +| `region` | string | Nein | PostHog-Cloud-Region: us oder eu \(Standard: us\) | +| `limit` | number | Nein | Anzahl der zurückzugebenden Ergebnisse \(Standard: 100\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für die Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `surveys` | array | Liste der Umfragen im Projekt | + +### `posthog_get_survey` + +Details einer bestimmten Umfrage in PostHog anhand der ID abrufen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | +| `projectId` | string | Ja | PostHog-Projekt-ID | +| `surveyId` | string | Ja | Abzurufende Umfrage-ID | +| `region` | string | Nein | PostHog-Cloud-Region: us oder eu \(Standard: us\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `survey` | object | Umfragedetails | + +### `posthog_create_survey` + +Erstelle eine neue Umfrage in PostHog. Unterstützt Fragetypen: Basic (offen), Link, Bewertung und Multiple Choice. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog API-Schlüssel | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `region` | string | Nein | PostHog Cloud-Region: us oder eu \(Standard: us\) | +| `name` | string | Nein | Umfragename \(optional\) | +| `description` | string | Nein | Umfragebeschreibung | +| `type` | string | Nein | Umfragetyp: popover \(in-app\) oder api \(benutzerdefinierte Implementierung\) \(Standard: popover\) | +| `questions` | string | Ja | JSON-String des Umfragefragen-Arrays. Jede Frage muss einen Typ \(open/link/rating/multiple_choice\) und einen Fragetext haben. Bewertungsfragen können eine Skala \(1-10\), lowerBoundLabel, upperBoundLabel haben. Multiple-Choice-Fragen benötigen ein choices-Array. Link-Fragen können buttonText haben. | +| `startDate` | string | Nein | Startdatum der Umfrage im ISO 8601-Format | +| `endDate` | string | Nein | Enddatum der Umfrage im ISO 8601-Format | +| `appearance` | string | Nein | JSON-String der Darstellungskonfiguration \(Farben, Position usw.\) | +| `conditions` | string | Nein | JSON-String der Anzeigebedingungen \(URL-Übereinstimmung usw.\) | +| `targetingFlagFilters` | string | Nein | JSON-String der Feature-Flag-Filter für Targeting | +| `linkedFlagId` | string | Nein | Feature-Flag-ID, die mit dieser Umfrage verknüpft werden soll | +| `responsesLimit` | number | Nein | Maximale Anzahl zu sammelnder Antworten | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `survey` | object | Details der erstellten Umfrage | + +### `posthog_update_survey` + +Aktualisiert eine bestehende Umfrage in PostHog. Kann Fragen, Erscheinungsbild, Bedingungen und andere Einstellungen ändern. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog API-Schlüssel | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `surveyId` | string | Ja | Umfrage-ID zum Aktualisieren | +| `region` | string | Nein | PostHog Cloud-Region: us oder eu \(Standard: us\) | +| `name` | string | Nein | Name der Umfrage | +| `description` | string | Nein | Beschreibung der Umfrage | +| `type` | string | Nein | Umfragetyp: popover oder api | +| `questions` | string | Nein | JSON-String des Umfragefragen-Arrays. Jede Frage muss einen Typ \(open/link/rating/multiple_choice\) und einen Fragetext haben. | +| `startDate` | string | Nein | Startdatum der Umfrage im ISO 8601-Format | +| `endDate` | string | Nein | Enddatum der Umfrage im ISO 8601-Format | +| `appearance` | string | Nein | JSON-String der Erscheinungskonfiguration \(Farben, Position usw.\) | +| `conditions` | string | Nein | JSON-String der Anzeigebedingungen \(URL-Übereinstimmung usw.\) | +| `targetingFlagFilters` | string | Nein | JSON-String der Feature-Flag-Filter für Targeting | +| `linkedFlagId` | string | Nein | Feature-Flag-ID, die mit dieser Umfrage verknüpft werden soll | +| `responsesLimit` | number | Nein | Maximale Anzahl zu sammelnder Antworten | +| `archived` | boolean | Nein | Umfrage archivieren oder Archivierung aufheben | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `survey` | object | Aktualisierte Umfragedetails | + +### `posthog_list_session_recordings` + +Listet Sitzungsaufzeichnungen in einem PostHog-Projekt auf. Sitzungsaufzeichnungen erfassen Benutzerinteraktionen mit Ihrer Anwendung. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | +| `projectId` | string | Ja | PostHog-Projekt-ID | +| `region` | string | Nein | PostHog-Cloud-Region: us oder eu \(Standard: us\) | +| `limit` | number | Nein | Anzahl der zurückzugebenden Ergebnisse \(Standard: 50\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `recordings` | array | Liste der Sitzungsaufzeichnungen | + +### `posthog_get_session_recording` + +Ruft Details einer bestimmten Sitzungsaufzeichnung in PostHog anhand der ID ab. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog-API-Schlüssel | +| `projectId` | string | Ja | PostHog-Projekt-ID | +| `recordingId` | string | Ja | Abzurufende Sitzungsaufzeichnungs-ID | +| `region` | string | Nein | PostHog-Cloud-Region: us oder eu \(Standard: us\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `recording` | object | Details der Sitzungsaufzeichnung | + +### `posthog_list_recording_playlists` + +Auflistung von Session-Recording-Playlists in einem PostHog-Projekt. Playlists ermöglichen es Ihnen, Session-Recordings zu organisieren und zu kuratieren. + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | PostHog persönlicher API-Schlüssel | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `region` | string | Nein | PostHog Cloud-Region: us oder eu \(Standard: us\) | +| `limit` | number | Nein | Anzahl der zurückzugebenden Ergebnisse \(Standard: 100\) | +| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für Paginierung | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `playlists` | array | Liste der Session-Recording-Playlists | + +### `posthog_list_event_definitions` + +Auflistung aller Event-Definitionen in einem PostHog-Projekt. Event-Definitionen repräsentieren verfolgte Ereignisse mit Metadaten wie Beschreibungen, Tags und Nutzungsstatistiken. + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `region` | string | Ja | PostHog Cloud-Region: us oder eu | +| `apiKey` | string | Ja | PostHog persönlicher API-Schlüssel | +| `limit` | number | Nein | Anzahl der pro Seite zurückzugebenden Ergebnisse \(Standard: 100\) | +| `offset` | number | Nein | Der Anfangsindex, ab dem Ergebnisse zurückgegeben werden | +| `search` | string | Nein | Suchbegriff zum Filtern von Event-Definitionen nach Namen | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `count` | number | Gesamtanzahl der Ereignisdefinitionen | +| `next` | string | URL für die nächste Ergebnisseite | +| `previous` | string | URL für die vorherige Ergebnisseite | +| `results` | array | Liste der Ereignisdefinitionen | + +### `posthog_get_event_definition` + +Ruft Details zu einer bestimmten Ereignisdefinition in PostHog ab. Liefert umfassende Informationen über das Ereignis, einschließlich Metadaten, Nutzungsstatistiken und Verifizierungsstatus. + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `eventDefinitionId` | string | Ja | Ereignisdefinitions-ID, die abgerufen werden soll | +| `region` | string | Ja | PostHog Cloud-Region: us oder eu | +| `apiKey` | string | Ja | Persönlicher PostHog API-Schlüssel | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `id` | string | Eindeutige Kennung für die Ereignisdefinition | +| `name` | string | Ereignisname | +| `description` | string | Ereignisbeschreibung | +| `tags` | array | Mit dem Ereignis verknüpfte Tags | +| `volume_30_day` | number | Anzahl der in den letzten 30 Tagen empfangenen Ereignisse | +| `query_usage_30_day` | number | Anzahl der Abfragen dieses Ereignisses in den letzten 30 Tagen | +| `created_at` | string | ISO-Zeitstempel der Ereigniserstellung | +| `last_seen_at` | string | ISO-Zeitstempel, wann das Ereignis zuletzt gesehen wurde | +| `updated_at` | string | ISO-Zeitstempel der letzten Aktualisierung des Ereignisses | +| `updated_by` | object | Benutzer, der das Ereignis zuletzt aktualisiert hat | +| `verified` | boolean | Ob das Ereignis verifiziert wurde | +| `verified_at` | string | ISO-Zeitstempel der Ereignisverifizierung | +| `verified_by` | string | Benutzer, der das Ereignis verifiziert hat | + +### `posthog_update_event_definition` + +Aktualisiert eine Ereignisdefinition in PostHog. Kann Beschreibung, Tags und Verifizierungsstatus ändern, um saubere Ereignisschemata zu pflegen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `eventDefinitionId` | string | Ja | Ereignisdefinitions-ID zum Aktualisieren | +| `region` | string | Ja | PostHog Cloud-Region: us oder eu | +| `apiKey` | string | Ja | PostHog persönlicher API-Schlüssel | +| `description` | string | Nein | Aktualisierte Beschreibung für das Ereignis | +| `tags` | string | Nein | Kommagetrennte Liste von Tags, die dem Ereignis zugeordnet werden sollen | +| `verified` | boolean | Nein | Ob das Ereignis als verifiziert markiert werden soll | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `id` | string | Eindeutige Kennung für die Ereignisdefinition | +| `name` | string | Ereignisname | +| `description` | string | Aktualisierte Ereignisbeschreibung | +| `tags` | array | Aktualisierte Tags, die dem Ereignis zugeordnet sind | +| `volume_30_day` | number | Anzahl der in den letzten 30 Tagen empfangenen Ereignisse | +| `query_usage_30_day` | number | Anzahl der Abfragen dieses Ereignisses in den letzten 30 Tagen | +| `created_at` | string | ISO-Zeitstempel der Erstellung des Ereignisses | +| `last_seen_at` | string | ISO-Zeitstempel, wann das Ereignis zuletzt gesehen wurde | +| `updated_at` | string | ISO-Zeitstempel der Aktualisierung des Ereignisses | +| `updated_by` | object | Benutzer, der das Ereignis zuletzt aktualisiert hat | +| `verified` | boolean | Ob das Ereignis verifiziert wurde | +| `verified_at` | string | ISO-Zeitstempel der Verifizierung des Ereignisses | +| `verified_by` | string | Benutzer, der das Ereignis verifiziert hat | + +### `posthog_list_property_definitions` + +Liste alle Eigenschaftsdefinitionen in einem PostHog-Projekt auf. Eigenschaftsdefinitionen repräsentieren verfolgte Eigenschaften mit Metadaten wie Beschreibungen, Tags, Typen und Nutzungsstatistiken. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `region` | string | Ja | PostHog Cloud-Region: us oder eu | +| `apiKey` | string | Ja | PostHog Persönlicher API-Schlüssel | +| `limit` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard: 100\) | +| `offset` | number | Nein | Der Anfangsindex, ab dem Ergebnisse zurückgegeben werden | +| `search` | string | Nein | Suchbegriff zum Filtern von Eigenschaftsdefinitionen nach Namen | +| `type` | string | Nein | Nach Eigenschaftstyp filtern: event, person oder group | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `count` | number | Gesamtanzahl der Eigenschaftsdefinitionen | +| `next` | string | URL für die nächste Ergebnisseite | +| `previous` | string | URL für die vorherige Ergebnisseite | +| `results` | array | Liste der Eigenschaftsdefinitionen | + +### `posthog_get_property_definition` + +Rufe Details einer bestimmten Eigenschaftsdefinition in PostHog ab. Liefert umfassende Informationen über die Eigenschaft, einschließlich Metadaten, Typ, Nutzungsstatistiken und Verifizierungsstatus. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `propertyDefinitionId` | string | Ja | Eigenschaftsdefinitions-ID, die abgerufen werden soll | +| `region` | string | Ja | PostHog Cloud-Region: us oder eu | +| `apiKey` | string | Ja | PostHog Persönlicher API-Schlüssel | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `id` | string | Eindeutige Kennung für die Eigenschaftsdefinition | +| `name` | string | Eigenschaftsname | +| `description` | string | Eigenschaftsbeschreibung | +| `tags` | array | Mit der Eigenschaft verknüpfte Tags | +| `is_numerical` | boolean | Ob die Eigenschaft numerisch ist | +| `is_seen_on_filtered_events` | boolean | Ob die Eigenschaft bei gefilterten Ereignissen sichtbar ist | +| `property_type` | string | Der Datentyp der Eigenschaft | +| `type` | string | Eigenschaftstyp: event, person oder group | +| `volume_30_day` | number | Anzahl der Male, die die Eigenschaft in den letzten 30 Tagen gesehen wurde | +| `query_usage_30_day` | number | Anzahl der Male, die diese Eigenschaft in den letzten 30 Tagen abgefragt wurde | +| `created_at` | string | ISO-Zeitstempel, wann die Eigenschaft erstellt wurde | +| `updated_at` | string | ISO-Zeitstempel, wann die Eigenschaft aktualisiert wurde | +| `updated_by` | object | Benutzer, der die Eigenschaft zuletzt aktualisiert hat | +| `verified` | boolean | Ob die Eigenschaft verifiziert wurde | +| `verified_at` | string | ISO-Zeitstempel, wann die Eigenschaft verifiziert wurde | +| `verified_by` | string | Benutzer, der die Eigenschaft verifiziert hat | +| `example` | string | Beispielwert für die Eigenschaft | + +### `posthog_update_property_definition` + +Aktualisiert eine Eigenschaftsdefinition in PostHog. Kann Beschreibung, Tags, Eigenschaftstyp und Verifizierungsstatus ändern, um saubere Eigenschaftsschemata zu pflegen. + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | PostHog Projekt-ID | +| `propertyDefinitionId` | string | Ja | Zu aktualisierende Eigenschaftsdefinitions-ID | +| `region` | string | Ja | PostHog Cloud-Region: us oder eu | +| `apiKey` | string | Ja | Persönlicher PostHog API-Schlüssel | +| `description` | string | Nein | Aktualisierte Beschreibung für die Eigenschaft | +| `tags` | string | Nein | Kommagetrennte Liste von Tags, die mit der Eigenschaft verknüpft werden sollen | +| `verified` | boolean | Nein | Ob die Eigenschaft als verifiziert markiert werden soll | +| `property_type` | string | Nein | Der Datentyp der Eigenschaft (z.B. String, Numeric, Boolean, DateTime, usw.) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `id` | string | Eindeutiger Bezeichner für die Eigenschaftsdefinition | +| `name` | string | Eigenschaftsname | +| `description` | string | Aktualisierte Eigenschaftsbeschreibung | +| `tags` | array | Aktualisierte Tags, die mit der Eigenschaft verknüpft sind | +| `is_numerical` | boolean | Ob die Eigenschaft numerisch ist | +| `is_seen_on_filtered_events` | boolean | Ob die Eigenschaft bei gefilterten Ereignissen sichtbar ist | +| `property_type` | string | Der Datentyp der Eigenschaft | +| `type` | string | Eigenschaftstyp: event, person oder group | +| `volume_30_day` | number | Anzahl der Male, die die Eigenschaft in den letzten 30 Tagen gesehen wurde | +| `query_usage_30_day` | number | Anzahl der Male, die diese Eigenschaft in den letzten 30 Tagen abgefragt wurde | +| `created_at` | string | ISO-Zeitstempel, wann die Eigenschaft erstellt wurde | +| `updated_at` | string | ISO-Zeitstempel, wann die Eigenschaft aktualisiert wurde | +| `updated_by` | object | Benutzer, der die Eigenschaft zuletzt aktualisiert hat | +| `verified` | boolean | Ob die Eigenschaft verifiziert wurde | +| `verified_at` | string | ISO-Zeitstempel, wann die Eigenschaft verifiziert wurde | +| `verified_by` | string | Benutzer, der die Eigenschaft verifiziert hat | +| `example` | string | Beispielwert für die Eigenschaft | + +### `posthog_list_projects` + +Listet alle Projekte in der Organisation auf. Gibt Projektdetails zurück, einschließlich IDs, Namen, API-Tokens und Einstellungen. Nützlich, um Projekt-IDs zu erhalten, die von anderen Endpunkten benötigt werden. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog API-Schlüssel | +| `region` | string | Nein | Cloud-Region: us oder eu \(Standard: us\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `projects` | array | Liste der Projekte mit ihrer Konfiguration und Einstellungen | + +### `posthog_get_project` + +Erhalten Sie detaillierte Informationen über ein bestimmtes Projekt anhand der ID. Liefert umfassende Projektkonfiguration, Einstellungen und Feature-Flags. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Ja | Projekt-ID \(numerische ID oder UUID\) | +| `apiKey` | string | Ja | Persönlicher PostHog API-Schlüssel | +| `region` | string | Nein | Cloud-Region: us oder eu \(Standard: us\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `project` | object | Detaillierte Projektinformationen mit allen Konfigurationseinstellungen | + +### `posthog_list_organizations` + +Listet alle Organisationen auf, auf die der Benutzer Zugriff hat. Gibt Organisationsdetails zurück, einschließlich Name, Slug, Mitgliedschaftsebene und verfügbare Produktfunktionen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Persönlicher PostHog API-Schlüssel | +| `region` | string | Nein | Cloud-Region: us oder eu \(Standard: us\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `organizations` | array | Liste der Organisationen mit ihren Einstellungen und Funktionen | + +### `posthog_get_organization` + +Erhalte detaillierte Informationen über eine bestimmte Organisation anhand ihrer ID. Liefert umfassende Organisationseinstellungen, Funktionen, Nutzung und Team-Informationen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `organizationId` | string | Ja | Organisations-ID \(UUID\) | +| `apiKey` | string | Ja | PostHog persönlicher API-Schlüssel | +| `region` | string | Nein | Cloud-Region: us oder eu \(Standard: us\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `organization` | object | Detaillierte Organisationsinformationen mit Einstellungen und Funktionen | + +## Hinweise + +- Kategorie: `tools` +- Typ: `posthog` diff --git a/apps/docs/content/docs/de/tools/sentry.mdx b/apps/docs/content/docs/de/tools/sentry.mdx new file mode 100644 index 0000000000..8ac4ebd24a --- /dev/null +++ b/apps/docs/content/docs/de/tools/sentry.mdx @@ -0,0 +1,305 @@ +--- +title: Sentry +description: Verwalte Sentry-Probleme, Projekte, Ereignisse und Releases +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +Verbessere deine Fehlerüberwachung und Anwendungszuverlässigkeit mit [Sentry](https://sentry.io/) — der branchenführenden Plattform für Echtzeit-Fehlerverfolgung, Leistungsüberwachung und Release-Management. Integriere Sentry nahtlos in deine automatisierten Agent-Workflows, um Probleme einfach zu überwachen, kritische Ereignisse zu verfolgen, Projekte zu verwalten und Releases über all deine Anwendungen und Dienste hinweg zu orchestrieren. + +Mit dem Sentry-Tool kannst du: + +- **Probleme überwachen und priorisieren**: Rufe umfassende Listen von Problemen mit der `sentry_issues_list` Operation ab und erhalte detaillierte Informationen zu einzelnen Fehlern und Bugs über `sentry_issues_get`. Greife sofort auf Metadaten, Tags, Stack-Traces und Statistiken zu, um die mittlere Zeit bis zur Lösung zu reduzieren. +- **Ereignisdaten verfolgen**: Analysiere spezifische Fehler- und Ereignisinstanzen mit `sentry_events_list` und `sentry_events_get`, die tiefe Einblicke in Fehlervorkommen und Benutzerauswirkungen bieten. +- **Projekte und Teams verwalten**: Nutze `sentry_projects_list` und `sentry_project_get`, um alle deine Sentry-Projekte aufzulisten und zu überprüfen, was eine reibungslose Teamzusammenarbeit und zentralisierte Konfiguration gewährleistet. +- **Releases koordinieren**: Automatisiere Versionsverfolgung, Deployment-Gesundheit und Änderungsmanagement in deinem Codebase mit Operationen wie `sentry_releases_list`, `sentry_release_get` und mehr. +- **Leistungsstarke Anwendungseinblicke gewinnen**: Nutze erweiterte Filter und Abfragen, um ungelöste oder hochprioritäre Probleme zu finden, Ereignisstatistiken im Zeitverlauf zu aggregieren und Regressionen zu verfolgen, während sich dein Codebase weiterentwickelt. + +Die Sentry-Integration ermöglicht Engineering- und DevOps-Teams, Probleme frühzeitig zu erkennen, die wichtigsten Bugs zu priorisieren und die Anwendungsgesundheit über verschiedene Entwicklungsstacks hinweg kontinuierlich zu verbessern. Orchestriere programmatisch Workflow-Automatisierung für moderne Beobachtbarkeit, Vorfallreaktion und Release-Lifecycle-Management – reduziere Ausfallzeiten und erhöhe die Benutzerzufriedenheit. + +**Verfügbare Sentry-Operationen**: +- `sentry_issues_list`: Sentry-Probleme für Organisationen und Projekte auflisten, mit leistungsstarker Suche und Filterung. +- `sentry_issues_get`: Detaillierte Informationen zu einem bestimmten Sentry-Problem abrufen. +- `sentry_events_list`: Ereignisse für ein bestimmtes Problem zur Ursachenanalyse auflisten. +- `sentry_events_get`: Vollständige Details zu einem einzelnen Ereignis erhalten, einschließlich Stack-Traces, Kontext und Metadaten. +- `sentry_projects_list`: Alle Sentry-Projekte innerhalb Ihrer Organisation auflisten. +- `sentry_project_get`: Konfiguration und Details für ein bestimmtes Projekt abrufen. +- `sentry_releases_list`: Aktuelle Releases und deren Bereitstellungsstatus auflisten. +- `sentry_release_get`: Detaillierte Release-Informationen abrufen, einschließlich zugehöriger Commits und Probleme. + +Ob Sie proaktiv die App-Gesundheit verwalten, Produktionsfehler beheben oder Release-Workflows automatisieren – Sentry stattet Sie mit erstklassigem Monitoring, handlungsorientierten Warnungen und nahtloser DevOps-Integration aus. Verbessern Sie Ihre Softwarequalität und Suchsichtbarkeit, indem Sie Sentry für Fehlerverfolgung, Beobachtbarkeit und Release-Management nutzen – alles in Ihren agentischen Workflows. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanweisungen + +Integrieren Sie Sentry in den Workflow. Überwachen Sie Probleme, verwalten Sie Projekte, verfolgen Sie Ereignisse und koordinieren Sie Releases über Ihre Anwendungen hinweg. + +## Tools + +### `sentry_issues_list` + +Listet Probleme von Sentry für eine bestimmte Organisation und optional ein bestimmtes Projekt auf. Gibt Problemdetails zurück, einschließlich Status, Fehlerzahlen und Zeitstempel der letzten Sichtung. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Sentry-API-Authentifizierungstoken | +| `organizationSlug` | string | Ja | Der Slug der Organisation | +| `projectSlug` | string | Nein | Filtert Probleme nach einem bestimmten Projekt-Slug \(optional\) | +| `query` | string | Nein | Suchanfrage zum Filtern von Problemen. Unterstützt Sentry-Suchsyntax \(z.B. "is:unresolved", "level:error"\) | +| `statsPeriod` | string | Nein | Zeitraum für Statistiken \(z.B. "24h", "7d", "30d"\). Standardmäßig 24h, wenn nicht angegeben. | +| `cursor` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite | +| `limit` | number | Nein | Anzahl der Probleme, die pro Seite zurückgegeben werden sollen \(Standard: 25, max: 100\) | +| `status` | string | Nein | Nach Problemstatus filtern: unresolved, resolved, ignored oder muted | +| `sort` | string | Nein | Sortierreihenfolge: date, new, freq, priority oder user \(Standard: date\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `issues` | array | Liste der Sentry-Probleme | + +### `sentry_issues_get` + +Ruft detaillierte Informationen zu einem bestimmten Sentry-Problem anhand seiner ID ab. Gibt vollständige Problemdetails einschließlich Metadaten, Tags und Statistiken zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Sentry-API-Authentifizierungstoken | +| `organizationSlug` | string | Ja | Der Slug der Organisation | +| `issueId` | string | Ja | Die eindeutige ID des abzurufenden Problems | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `issue` | object | Detaillierte Informationen zum Sentry-Problem | + +### `sentry_issues_update` + +Aktualisiert ein Sentry-Problem durch Ändern seines Status, seiner Zuweisung, seines Lesezeichen-Status oder anderer Eigenschaften. Gibt die aktualisierten Problemdetails zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Sentry-API-Authentifizierungstoken | +| `organizationSlug` | string | Ja | Der Slug der Organisation | +| `issueId` | string | Ja | Die eindeutige ID des zu aktualisierenden Problems | +| `status` | string | Nein | Neuer Status für das Problem: resolved, unresolved, ignored oder resolvedInNextRelease | +| `assignedTo` | string | Nein | Benutzer-ID oder E-Mail, der das Problem zugewiesen werden soll. Leerer String zum Aufheben der Zuweisung. | +| `isBookmarked` | boolean | Nein | Ob das Problem als Lesezeichen gespeichert werden soll | +| `isSubscribed` | boolean | Nein | Ob Problemaktualisierungen abonniert werden sollen | +| `isPublic` | boolean | Nein | Ob das Problem öffentlich sichtbar sein soll | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `issue` | object | Das aktualisierte Sentry-Problem | + +### `sentry_projects_list` + +Listet alle Projekte in einer Sentry-Organisation auf. Gibt Projektdetails zurück, einschließlich Name, Plattform, Teams und Konfiguration. + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Sentry-API-Authentifizierungstoken | +| `organizationSlug` | string | Ja | Der Slug der Organisation | +| `cursor` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite | +| `limit` | number | Nein | Anzahl der Projekte, die pro Seite zurückgegeben werden sollen \(Standard: 25, max: 100\) | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `projects` | array | Liste der Sentry-Projekte | + +### `sentry_projects_get` + +Ruft detaillierte Informationen über ein bestimmtes Sentry-Projekt anhand seines Slugs ab. Gibt vollständige Projektdetails zurück, einschließlich Teams, Funktionen und Konfiguration. + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Sentry-API-Authentifizierungstoken | +| `organizationSlug` | string | Ja | Der Slug der Organisation | +| `projectSlug` | string | Ja | Die ID oder der Slug des abzurufenden Projekts | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `project` | object | Detaillierte Informationen über das Sentry-Projekt | + +### `sentry_projects_create` + +Erstellt ein neues Sentry-Projekt in einer Organisation. Erfordert ein Team, dem das Projekt zugeordnet wird. Gibt die Details des erstellten Projekts zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken | +| `organizationSlug` | string | Ja | Der Slug der Organisation | +| `name` | string | Ja | Der Name des Projekts | +| `teamSlug` | string | Ja | Der Slug des Teams, das dieses Projekt besitzen wird | +| `slug` | string | Nein | URL-freundliche Projektkennung \(wird automatisch aus dem Namen generiert, wenn nicht angegeben\) | +| `platform` | string | Nein | Plattform/Sprache für das Projekt \(z.B. javascript, python, node, react-native\). Wenn nicht angegeben, wird standardmäßig "other" verwendet | +| `defaultRules` | boolean | Nein | Ob Standardalarmregeln erstellt werden sollen \(Standard: true\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `project` | object | Das neu erstellte Sentry-Projekt | + +### `sentry_projects_update` + +Aktualisiert ein Sentry-Projekt durch Änderung des Namens, Slugs, der Plattform oder anderer Einstellungen. Gibt die aktualisierten Projektdetails zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken | +| `organizationSlug` | string | Ja | Der Slug der Organisation | +| `projectSlug` | string | Ja | Der Slug des zu aktualisierenden Projekts | +| `name` | string | Nein | Neuer Name für das Projekt | +| `slug` | string | Nein | Neue URL-freundliche Projektkennung | +| `platform` | string | Nein | Neue Plattform/Sprache für das Projekt \(z.B. javascript, python, node\) | +| `isBookmarked` | boolean | Nein | Ob das Projekt als Lesezeichen gespeichert werden soll | +| `digestsMinDelay` | number | Nein | Minimale Verzögerung \(in Sekunden\) für Digest-Benachrichtigungen | +| `digestsMaxDelay` | number | Nein | Maximale Verzögerung \(in Sekunden\) für Digest-Benachrichtigungen | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `project` | object | Das aktualisierte Sentry-Projekt | + +### `sentry_events_list` + +Listet Ereignisse aus einem Sentry-Projekt auf. Kann nach Problem-ID, Abfrage oder Zeitraum gefiltert werden. Gibt Ereignisdetails einschließlich Kontext, Tags und Benutzerinformationen zurück. + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken | +| `organizationSlug` | string | Ja | Der Slug der Organisation | +| `projectSlug` | string | Ja | Der Slug des Projekts, aus dem Ereignisse aufgelistet werden sollen | +| `issueId` | string | Nein | Filtert Ereignisse nach einer bestimmten Problem-ID | +| `query` | string | Nein | Suchabfrage zum Filtern von Ereignissen. Unterstützt Sentry-Suchsyntax \(z.B. "user.email:*@example.com"\) | +| `cursor` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite | +| `limit` | number | Nein | Anzahl der Ereignisse, die pro Seite zurückgegeben werden sollen \(Standard: 50, max: 100\) | +| `statsPeriod` | string | Nein | Abfragezeitraum \(z.B. "24h", "7d", "30d"\). Standardmäßig 90d, wenn nicht angegeben. | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `events` | array | Liste der Sentry-Ereignisse | + +### `sentry_events_get` + +Ruft detaillierte Informationen über ein bestimmtes Sentry-Ereignis anhand seiner ID ab. Gibt vollständige Ereignisdetails zurück, einschließlich Stack-Traces, Breadcrumbs, Kontext und Benutzerinformationen. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken | +| `organizationSlug` | string | Ja | Der Slug der Organisation | +| `projectSlug` | string | Ja | Der Slug des Projekts | +| `eventId` | string | Ja | Die eindeutige ID des abzurufenden Ereignisses | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `event` | object | Detaillierte Informationen über das Sentry-Ereignis | + +### `sentry_releases_list` + +Listet Releases für eine Sentry-Organisation oder ein Projekt auf. Gibt Release-Details zurück, einschließlich Version, Commits, Deploy-Informationen und zugehörige Projekte. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken | +| `organizationSlug` | string | Ja | Der Slug der Organisation | +| `projectSlug` | string | Nein | Filtert Releases nach einem bestimmten Projekt-Slug \(optional\) | +| `query` | string | Nein | Suchanfrage zum Filtern von Releases \(z.B. Versionsnamen-Muster\) | +| `cursor` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite | +| `limit` | number | Nein | Anzahl der Releases, die pro Seite zurückgegeben werden sollen \(Standard: 25, max: 100\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `releases` | array | Liste der Sentry-Releases | + +### `sentry_releases_create` + +Erstelle ein neues Release in Sentry. Ein Release ist eine Version deines Codes, die in einer Umgebung bereitgestellt wird. Kann Commit-Informationen und zugehörige Projekte enthalten. Gibt die Details des erstellten Releases zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken | +| `organizationSlug` | string | Ja | Der Slug der Organisation | +| `version` | string | Ja | Versionskennung für das Release \(z.B. "2.0.0", "my-app@1.0.0" oder ein Git-Commit-SHA\) | +| `projects` | string | Ja | Kommagetrennte Liste von Projekt-Slugs, die mit diesem Release verknüpft werden sollen | +| `ref` | string | Nein | Git-Referenz \(Commit-SHA, Tag oder Branch\) für dieses Release | +| `url` | string | Nein | URL, die auf das Release verweist \(z.B. GitHub-Release-Seite\) | +| `dateReleased` | string | Nein | ISO 8601-Zeitstempel für den Zeitpunkt der Bereitstellung des Releases \(standardmäßig aktuelle Zeit\) | +| `commits` | string | Nein | JSON-Array von Commit-Objekten mit id, repository \(optional\) und message \(optional\). Beispiel: \[\{"id":"abc123","message":"Fix bug"\}\] | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `release` | object | Das neu erstellte Sentry-Release | + +### `sentry_releases_deploy` + +Erstelle einen Deploy-Eintrag für ein Sentry-Release in einer bestimmten Umgebung. Deploys verfolgen, wann und wo Releases bereitgestellt werden. Gibt die Details des erstellten Deploys zurück. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken | +| `organizationSlug` | string | Ja | Der Slug der Organisation | +| `version` | string | Ja | Versionskennung des Releases, das bereitgestellt wird | +| `environment` | string | Ja | Name der Umgebung, in der das Release bereitgestellt wird (z.B. "production", "staging") | +| `name` | string | Nein | Optionaler Name für dieses Deployment (z.B. "Deploy v2.0 to Production") | +| `url` | string | Nein | URL, die auf das Deployment verweist (z.B. CI/CD-Pipeline-URL) | +| `dateStarted` | string | Nein | ISO 8601-Zeitstempel für den Beginn des Deployments (standardmäßig aktuelle Zeit) | +| `dateFinished` | string | Nein | ISO 8601-Zeitstempel für den Abschluss des Deployments | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `deploy` | object | Der neu erstellte Deployment-Datensatz | + +## Hinweise + +- Kategorie: `tools` +- Typ: `sentry` diff --git a/apps/docs/content/docs/es/blocks/agent.mdx b/apps/docs/content/docs/es/blocks/agent.mdx index 050fa6f976..12b1ccfbd9 100644 --- a/apps/docs/content/docs/es/blocks/agent.mdx +++ b/apps/docs/content/docs/es/blocks/agent.mdx @@ -46,7 +46,7 @@ El bloque Agente admite múltiples proveedores de LLM a través de una interfaz - **Anthropic**: Claude 4.5 Sonnet, Claude Opus 4.1 - **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash - **Otros proveedores**: Groq, Cerebras, xAI, Azure OpenAI, OpenRouter -- **Modelos locales**: modelos compatibles con Ollama +- **Modelos locales**: modelos compatibles con Ollama o VLLM ### Temperatura diff --git a/apps/docs/content/docs/es/blocks/evaluator.mdx b/apps/docs/content/docs/es/blocks/evaluator.mdx index aeee1881a2..9068b7e1a8 100644 --- a/apps/docs/content/docs/es/blocks/evaluator.mdx +++ b/apps/docs/content/docs/es/blocks/evaluator.mdx @@ -52,7 +52,7 @@ Elige un modelo de IA para realizar la evaluación: - **Anthropic**: Claude 3.7 Sonnet - **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash - **Otros proveedores**: Groq, Cerebras, xAI, DeepSeek -- **Modelos locales**: Modelos compatibles con Ollama +- **Modelos locales**: modelos compatibles con Ollama o VLLM Utiliza modelos con fuertes capacidades de razonamiento como GPT-4o o Claude 3.7 Sonnet para obtener mejores resultados. diff --git a/apps/docs/content/docs/es/blocks/guardrails.mdx b/apps/docs/content/docs/es/blocks/guardrails.mdx index 58f34dd040..fd0697af10 100644 --- a/apps/docs/content/docs/es/blocks/guardrails.mdx +++ b/apps/docs/content/docs/es/blocks/guardrails.mdx @@ -63,11 +63,11 @@ Utiliza Generación Aumentada por Recuperación (RAG) con puntuación LLM para d 4. La validación se aprueba si la puntuación ≥ umbral (predeterminado: 3) **Configuración:** -- **Base de conocimientos**: Selecciona entre tus bases de conocimientos existentes -- **Modelo**: Elige LLM para puntuación (requiere razonamiento sólido - se recomienda GPT-4o, Claude 3.7 Sonnet) -- **Clave API**: Autenticación para el proveedor LLM seleccionado (oculta automáticamente para modelos alojados/Ollama) +- **Base de conocimiento**: Selecciona entre tus bases de conocimiento existentes +- **Modelo**: Elige el LLM para la puntuación (requiere razonamiento sólido - se recomienda GPT-4o, Claude 3.7 Sonnet) +- **Clave API**: Autenticación para el proveedor LLM seleccionado (se oculta automáticamente para modelos alojados/Ollama o compatibles con VLLM) - **Umbral de confianza**: Puntuación mínima para aprobar (0-10, predeterminado: 3) -- **Top K** (Avanzado): Número de fragmentos de la base de conocimientos a recuperar (predeterminado: 10) +- **Top K** (Avanzado): Número de fragmentos de la base de conocimiento a recuperar (predeterminado: 10) **Salida:** - `passed`: `true` si la puntuación de confianza ≥ umbral diff --git a/apps/docs/content/docs/es/blocks/router.mdx b/apps/docs/content/docs/es/blocks/router.mdx index e92af3a31a..18c2287e5e 100644 --- a/apps/docs/content/docs/es/blocks/router.mdx +++ b/apps/docs/content/docs/es/blocks/router.mdx @@ -56,7 +56,7 @@ Elige un modelo de IA para impulsar la decisión de enrutamiento: - **Anthropic**: Claude 3.7 Sonnet - **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash - **Otros proveedores**: Groq, Cerebras, xAI, DeepSeek -- **Modelos locales**: Modelos compatibles con Ollama +- **Modelos locales**: modelos compatibles con Ollama o VLLM Utiliza modelos con fuertes capacidades de razonamiento como GPT-4o o Claude 3.7 Sonnet para obtener mejores resultados. diff --git a/apps/docs/content/docs/es/execution/costs.mdx b/apps/docs/content/docs/es/execution/costs.mdx index 3a7a0cfce3..cbb7c2baf8 100644 --- a/apps/docs/content/docs/es/execution/costs.mdx +++ b/apps/docs/content/docs/es/execution/costs.mdx @@ -47,9 +47,9 @@ El desglose del modelo muestra: ## Opciones de precios - + - **Modelos alojados** - Sim proporciona claves API con un multiplicador de precio de 2,5x: + **Modelos alojados** - Sim proporciona claves API con un multiplicador de precio de 2.5x: | Modelo | Precio base (Entrada/Salida) | Precio alojado (Entrada/Salida) | |-------|---------------------------|----------------------------| @@ -60,7 +60,7 @@ El desglose del modelo muestra: | Claude 3.5 Sonnet | $3.00 / $15.00 | $7.50 / $37.50 | | Claude Opus 4.0 | $15.00 / $75.00 | $37.50 / $187.50 | - *El multiplicador de 2,5x cubre los costos de infraestructura y gestión de API.* + *El multiplicador de 2.5x cubre los costos de infraestructura y gestión de API.* @@ -74,6 +74,7 @@ El desglose del modelo muestra: | Groq | Llama 4 Scout | $0.40 / $0.60 | | Cerebras | Llama 3.3 70B | $0.94 / $0.94 | | Ollama | Modelos locales | Gratis | + | VLLM | Modelos locales | Gratis | *Paga directamente a los proveedores sin recargo* @@ -86,8 +87,8 @@ El desglose del modelo muestra: ## Estrategias de optimización de costos - **Selección de modelo**: Elige modelos según la complejidad de la tarea. Las tareas simples pueden usar GPT-4.1-nano mientras que el razonamiento complejo podría necesitar o1 o Claude Opus. -- **Ingeniería de prompts**: Los prompts bien estructurados y concisos reducen el uso de tokens sin sacrificar la calidad. -- **Modelos locales**: Usa Ollama para tareas no críticas para eliminar por completo los costos de API. +- **Ingeniería de prompts**: Los prompts bien estructurados y concisos reducen el uso de tokens sin sacrificar calidad. +- **Modelos locales**: Usa Ollama o VLLM para tareas no críticas para eliminar completamente los costos de API. - **Almacenamiento en caché y reutilización**: Guarda resultados frecuentemente utilizados en variables o archivos para evitar llamadas repetidas al modelo de IA. - **Procesamiento por lotes**: Procesa múltiples elementos en una sola solicitud de IA en lugar de hacer llamadas individuales. diff --git a/apps/docs/content/docs/es/introduction/index.mdx b/apps/docs/content/docs/es/introduction/index.mdx index 01f4cb9bbb..d44c51520e 100644 --- a/apps/docs/content/docs/es/introduction/index.mdx +++ b/apps/docs/content/docs/es/introduction/index.mdx @@ -59,7 +59,7 @@ Permite que tu equipo construya juntos. Múltiples usuarios pueden editar flujos Sim proporciona integraciones nativas con más de 80 servicios en múltiples categorías: -- **Modelos de IA**: OpenAI, Anthropic, Google Gemini, Groq, Cerebras, modelos locales a través de Ollama +- **Modelos de IA**: OpenAI, Anthropic, Google Gemini, Groq, Cerebras, modelos locales a través de Ollama o VLLM - **Comunicación**: Gmail, Slack, Microsoft Teams, Telegram, WhatsApp - **Productividad**: Notion, Google Workspace, Airtable, Monday.com - **Desarrollo**: GitHub, Jira, Linear, pruebas automatizadas de navegador diff --git a/apps/docs/content/docs/es/tools/incidentio.mdx b/apps/docs/content/docs/es/tools/incidentio.mdx new file mode 100644 index 0000000000..dc4aecb1ed --- /dev/null +++ b/apps/docs/content/docs/es/tools/incidentio.mdx @@ -0,0 +1,841 @@ +--- +title: incidentio +description: Gestiona incidentes con incident.io +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +Potencia tu gestión de incidentes con [incident.io](https://incident.io) – la plataforma líder para orquestar incidentes, agilizar procesos de respuesta y realizar seguimiento de elementos de acción, todo en un solo lugar. Integra incident.io sin problemas en tus flujos de trabajo automatizados para tomar el control de la creación de incidentes, colaboración en tiempo real, seguimientos, programación, escalaciones y mucho más. + +Con la herramienta incident.io, puedes: + +- **Listar y buscar incidentes**: Recupera rápidamente una lista de incidentes en curso o históricos, con metadatos como gravedad, estado y marcas de tiempo, usando `incidentio_incidents_list`. +- **Crear nuevos incidentes**: Activa la creación de nuevos incidentes de forma programática a través de `incidentio_incidents_create`, especificando gravedad, nombre, tipo y detalles personalizados para asegurar que nada ralentice tu respuesta. +- **Automatizar seguimientos de incidentes**: Aprovecha la potente automatización de incident.io para garantizar que no se pasen por alto elementos de acción importantes y aprendizajes, ayudando a los equipos a resolver problemas y mejorar procesos. +- **Personalizar flujos de trabajo**: Integra tipos de incidentes personalizados, niveles de gravedad y campos personalizados adaptados a las necesidades de tu organización. +- **Aplicar mejores prácticas con programaciones y escalaciones**: Agiliza la gestión de guardias e incidentes asignando, notificando y escalando automáticamente a medida que evolucionan las situaciones. + +incident.io permite a las organizaciones modernas responder más rápido, coordinar equipos y capturar aprendizajes para la mejora continua. Ya sea que gestiones incidentes de SRE, DevOps, Seguridad o TI, incident.io ofrece una respuesta a incidentes centralizada y de primera clase de manera programática para tus flujos de trabajo de agente. + +**Operaciones clave disponibles**: +- `incidentio_incidents_list`: Lista, pagina y filtra incidentes con detalles completos. +- `incidentio_incidents_create`: Abre nuevos incidentes de forma programática con atributos personalizados y control sobre la duplicación (idempotencia). +- ...¡y más por venir! + +Mejora tu fiabilidad, responsabilidad y excelencia operativa integrando incident.io con tus automatizaciones de flujo de trabajo hoy mismo. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra incident.io en el flujo de trabajo. Gestiona incidentes, acciones, seguimientos, flujos de trabajo, programaciones, escalaciones, campos personalizados y más. + +## Herramientas + +### `incidentio_incidents_list` + +Lista incidentes de incident.io. Devuelve una lista de incidentes con sus detalles, incluyendo gravedad, estado y marcas de tiempo. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `page_size` | number | No | Número de incidentes a devolver por página \(predeterminado: 25\) | +| `after` | string | No | Cursor de paginación para obtener la siguiente página de resultados | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `incidents` | array | Lista de incidentes | + +### `incidentio_incidents_create` + +Crea un nuevo incidente en incident.io. Requiere idempotency_key, severity_id y visibility. Opcionalmente acepta name, summary, type y status. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `idempotency_key` | string | Sí | Identificador único para prevenir la creación de incidentes duplicados. Usa un UUID o cadena única. | +| `name` | string | No | Nombre del incidente \(opcional\) | +| `summary` | string | No | Resumen breve del incidente | +| `severity_id` | string | Sí | ID del nivel de gravedad \(obligatorio\) | +| `incident_type_id` | string | No | ID del tipo de incidente | +| `incident_status_id` | string | No | ID del estado inicial del incidente | +| `visibility` | string | Sí | Visibilidad del incidente: "public" o "private" \(obligatorio\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `incident` | objeto | El objeto de incidente creado | + +### `incidentio_incidents_show` + +Recupera información detallada sobre un incidente específico de incident.io mediante su ID. Devuelve detalles completos del incidente, incluidos campos personalizados y asignaciones de roles. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | cadena | Sí | Clave API de incident.io | +| `id` | cadena | Sí | ID del incidente a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `incident` | objeto | Información detallada del incidente | + +### `incidentio_incidents_update` + +Actualiza un incidente existente en incident.io. Puede actualizar el nombre, resumen, gravedad, estado o tipo. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | cadena | Sí | Clave API de incident.io | +| `id` | cadena | Sí | ID del incidente a actualizar | +| `name` | cadena | No | Nombre actualizado del incidente | +| `summary` | cadena | No | Resumen actualizado del incidente | +| `severity_id` | cadena | No | ID de gravedad actualizado para el incidente | +| `incident_status_id` | cadena | No | ID de estado actualizado para el incidente | +| `incident_type_id` | cadena | No | ID de tipo de incidente actualizado | +| `notify_incident_channel` | booleano | Sí | Indica si se debe notificar al canal de incidentes sobre esta actualización | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `incident` | objeto | El objeto de incidente actualizado | + +### `incidentio_actions_list` + +Listar acciones de incident.io. Opcionalmente filtrar por ID de incidente. + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | cadena | Sí | Clave API de incident.io | +| `incident_id` | cadena | No | Filtrar acciones por ID de incidente | +| `page_size` | número | No | Número de acciones a devolver por página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `actions` | array | Lista de acciones | + +### `incidentio_actions_show` + +Obtener información detallada sobre una acción específica de incident.io. + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | cadena | Sí | Clave API de incident.io | +| `id` | cadena | Sí | ID de acción | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `action` | objeto | Detalles de la acción | + +### `incidentio_follow_ups_list` + +Listar seguimientos de incident.io. Opcionalmente filtrar por ID de incidente. + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | cadena | Sí | Clave API de incident.io | +| `incident_id` | cadena | No | Filtrar seguimientos por ID de incidente | +| `page_size` | número | No | Número de seguimientos a devolver por página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `follow_ups` | array | Lista de seguimientos | + +### `incidentio_follow_ups_show` + +Obtener información detallada sobre un seguimiento específico de incident.io. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | ID del seguimiento | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `follow_up` | object | Detalles del seguimiento | + +### `incidentio_users_list` + +Listar todos los usuarios en tu espacio de trabajo de Incident.io. Devuelve detalles del usuario incluyendo id, nombre, correo electrónico y rol. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Incident.io | +| `page_size` | number | No | Número de resultados a devolver por página \(predeterminado: 25\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `users` | array | Lista de usuarios en el espacio de trabajo | + +### `incidentio_users_show` + +Obtener información detallada sobre un usuario específico en tu espacio de trabajo de Incident.io mediante su ID. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Incident.io | +| `id` | string | Sí | El identificador único del usuario a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `user` | object | Detalles del usuario solicitado | + +### `incidentio_workflows_list` + +Lista todos los flujos de trabajo en tu espacio de trabajo de incident.io. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `page_size` | number | No | Número de flujos de trabajo a devolver por página | +| `after` | string | No | Cursor de paginación para obtener la siguiente página de resultados | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `workflows` | array | Lista de flujos de trabajo | + +### `incidentio_workflows_show` + +Obtiene detalles de un flujo de trabajo específico en incident.io. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | El ID del flujo de trabajo a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `workflow` | object | Los detalles del flujo de trabajo | + +### `incidentio_workflows_update` + +Actualiza un flujo de trabajo existente en incident.io. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | El ID del flujo de trabajo a actualizar | +| `name` | string | No | Nuevo nombre para el flujo de trabajo | +| `state` | string | No | Nuevo estado para el flujo de trabajo \(active, draft, o disabled\) | +| `folder` | string | No | Nueva carpeta para el flujo de trabajo | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `workflow` | object | El flujo de trabajo actualizado | + +### `incidentio_workflows_delete` + +Eliminar un flujo de trabajo en incident.io. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | El ID del flujo de trabajo a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `message` | string | Mensaje de éxito | + +### `incidentio_schedules_list` + +Listar todos los horarios en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `page_size` | number | No | Número de resultados por página \(predeterminado: 25\) | +| `after` | string | No | Cursor de paginación para obtener la siguiente página de resultados | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `schedules` | array | Lista de horarios | + +### `incidentio_schedules_create` + +Crear un nuevo horario en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `name` | string | Sí | Nombre del horario | +| `timezone` | string | Sí | Zona horaria para el horario \(p. ej., America/New_York\) | +| `config` | string | Sí | Configuración del horario como cadena JSON con rotaciones. Ejemplo: \{"rotations": \[\{"name": "Primary", "users": \[\{"id": "user_id"\}\], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": \[\{"interval": 1, "interval_type": "weekly"\}\]\}\]\} | +| `Example` | string | No | Sin descripción | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `schedule` | objeto | El horario creado | + +### `incidentio_schedules_show` + +Obtener detalles de un horario específico en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | cadena | Sí | Clave API de incident.io | +| `id` | cadena | Sí | El ID del horario | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `schedule` | objeto | Los detalles del horario | + +### `incidentio_schedules_update` + +Actualizar un horario existente en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | cadena | Sí | Clave API de incident.io | +| `id` | cadena | Sí | El ID del horario a actualizar | +| `name` | cadena | No | Nuevo nombre para el horario | +| `timezone` | cadena | No | Nueva zona horaria para el horario \(p. ej., America/New_York\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `schedule` | objeto | El horario actualizado | + +### `incidentio_schedules_delete` + +Eliminar un horario en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | cadena | Sí | Clave API de incident.io | +| `id` | cadena | Sí | El ID del horario a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `message` | string | Mensaje de éxito | + +### `incidentio_escalations_list` + +Listar todas las políticas de escalamiento en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `page_size` | number | No | Número de resultados por página \(predeterminado: 25\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `escalations` | array | Lista de políticas de escalamiento | + +### `incidentio_escalations_create` + +Crear una nueva política de escalamiento en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `idempotency_key` | string | Sí | Identificador único para prevenir la creación de escalamientos duplicados. Utilice un UUID o cadena única. | +| `title` | string | Sí | Título del escalamiento | +| `escalation_path_id` | string | No | ID de la ruta de escalamiento a utilizar \(obligatorio si no se proporcionan user_ids\) | +| `user_ids` | string | No | Lista separada por comas de IDs de usuarios a notificar \(obligatorio si no se proporciona escalation_path_id\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `escalation` | object | La política de escalamiento creada | + +### `incidentio_escalations_show` + +Obtener detalles de una política de escalamiento específica en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | El ID de la política de escalación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `escalation` | object | Los detalles de la política de escalación | + +### `incidentio_custom_fields_list` + +Listar todos los campos personalizados de incident.io. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `custom_fields` | array | Lista de campos personalizados | + +### `incidentio_custom_fields_create` + +Crear un nuevo campo personalizado en incident.io. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `name` | string | Sí | Nombre del campo personalizado | +| `description` | string | Sí | Descripción del campo personalizado \(obligatorio\) | +| `field_type` | string | Sí | Tipo del campo personalizado \(p. ej., text, single_select, multi_select, numeric, datetime, link, user, team\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `custom_field` | object | Campo personalizado creado | + +### `incidentio_custom_fields_show` + +Obtén información detallada sobre un campo personalizado específico de incident.io. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | ID del campo personalizado | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `custom_field` | object | Detalles del campo personalizado | + +### `incidentio_custom_fields_update` + +Actualiza un campo personalizado existente en incident.io. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | ID del campo personalizado | +| `name` | string | Sí | Nuevo nombre para el campo personalizado \(obligatorio\) | +| `description` | string | Sí | Nueva descripción para el campo personalizado \(obligatorio\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `custom_field` | object | Campo personalizado actualizado | + +### `incidentio_custom_fields_delete` + +Elimina un campo personalizado de incident.io. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | ID del campo personalizado | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `message` | string | Mensaje de éxito | + +### `incidentio_severities_list` + +Lista todos los niveles de gravedad configurados en tu espacio de trabajo de Incident.io. Devuelve detalles de gravedad incluyendo id, nombre, descripción y rango. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Incident.io | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `severities` | array | Lista de niveles de gravedad | + +### `incidentio_incident_statuses_list` + +Lista todos los estados de incidentes configurados en tu espacio de trabajo de Incident.io. Devuelve detalles del estado incluyendo id, nombre, descripción y categoría. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Incident.io | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `incident_statuses` | array | Lista de estados de incidentes | + +### `incidentio_incident_types_list` + +Lista todos los tipos de incidentes configurados en tu espacio de trabajo de Incident.io. Devuelve detalles del tipo incluyendo id, nombre, descripción y bandera predeterminada. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Incident.io | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `incident_types` | array | Lista de tipos de incidentes | + +### `incidentio_incident_roles_list` + +Lista todos los roles de incidentes en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `incident_roles` | array | Lista de roles de incidente | + +### `incidentio_incident_roles_create` + +Crear un nuevo rol de incidente en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `name` | string | Sí | Nombre del rol de incidente | +| `description` | string | Sí | Descripción del rol de incidente | +| `instructions` | string | Sí | Instrucciones para el rol de incidente | +| `shortform` | string | Sí | Abreviatura del rol | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `incident_role` | object | El rol de incidente creado | + +### `incidentio_incident_roles_show` + +Obtener detalles de un rol de incidente específico en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | El ID del rol de incidente | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `incident_role` | object | Los detalles del rol de incidente | + +### `incidentio_incident_roles_update` + +Actualizar un rol de incidente existente en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | El ID del rol de incidente a actualizar | +| `name` | string | Sí | Nombre del rol de incidente | +| `description` | string | Sí | Descripción del rol de incidente | +| `instructions` | string | Sí | Instrucciones para el rol de incidente | +| `shortform` | string | Sí | Abreviatura del rol | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `incident_role` | object | El rol de incidente actualizado | + +### `incidentio_incident_roles_delete` + +Eliminar un rol de incidente en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | El ID del rol de incidente a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `message` | string | Mensaje de éxito | + +### `incidentio_incident_timestamps_list` + +Listar todas las definiciones de marca de tiempo de incidentes en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `incident_timestamps` | array | Lista de definiciones de marca de tiempo de incidentes | + +### `incidentio_incident_timestamps_show` + +Obtener detalles de una definición específica de marca de tiempo de incidente en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | El ID de la marca de tiempo del incidente | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `incident_timestamp` | object | Los detalles de la marca de tiempo del incidente | + +### `incidentio_incident_updates_list` + +Listar todas las actualizaciones para un incidente específico en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `incident_id` | string | No | El ID del incidente para obtener actualizaciones \(opcional - si no se proporciona, devuelve todas las actualizaciones\) | +| `page_size` | number | No | Número de resultados a devolver por página | +| `after` | string | No | Cursor para paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `incident_updates` | array | Lista de actualizaciones de incidentes | + +### `incidentio_schedule_entries_list` + +Listar todas las entradas para un horario específico en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `schedule_id` | string | Sí | El ID del horario para obtener entradas | +| `entry_window_start` | string | No | Fecha/hora de inicio para filtrar entradas \(formato ISO 8601\) | +| `entry_window_end` | string | No | Fecha/hora de fin para filtrar entradas \(formato ISO 8601\) | +| `page_size` | number | No | Número de resultados a devolver por página | +| `after` | string | No | Cursor para paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `schedule_entries` | array | Lista de entradas de horario | + +### `incidentio_schedule_overrides_create` + +Crear una nueva anulación de horario en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `rotation_id` | string | Sí | El ID de la rotación a anular | +| `schedule_id` | string | Sí | El ID del horario | +| `user_id` | string | No | El ID del usuario a asignar \(proporcione uno de: user_id, user_email, o user_slack_id\) | +| `user_email` | string | No | El correo electrónico del usuario a asignar \(proporcione uno de: user_id, user_email, o user_slack_id\) | +| `user_slack_id` | string | No | El ID de Slack del usuario a asignar \(proporcione uno de: user_id, user_email, o user_slack_id\) | +| `start_at` | string | Sí | Cuándo comienza la anulación \(formato ISO 8601\) | +| `end_at` | string | Sí | Cuándo termina la anulación \(formato ISO 8601\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `override` | object | La anulación de horario creada | + +### `incidentio_escalation_paths_create` + +Crear una nueva ruta de escalamiento en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `name` | string | Sí | Nombre de la ruta de escalamiento | +| `path` | json | Sí | Array de niveles de escalamiento con objetivos y tiempo para confirmar en segundos. Cada nivel debe tener: targets \(array de \{id, type, schedule_id?, user_id?, urgency\}\) y time_to_ack_seconds \(número\) | +| `working_hours` | json | No | Configuración opcional de horas laborables. Array de \{weekday, start_time, end_time\} | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `escalation_path` | objeto | La ruta de escalado creada | + +### `incidentio_escalation_paths_show` + +Obtener detalles de una ruta de escalado específica en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | El ID de la ruta de escalado | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `escalation_path` | objeto | Los detalles de la ruta de escalado | + +### `incidentio_escalation_paths_update` + +Actualizar una ruta de escalado existente en incident.io + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | El ID de la ruta de escalado a actualizar | +| `name` | string | No | Nuevo nombre para la ruta de escalado | +| `path` | json | No | Nueva configuración de ruta de escalado. Array de niveles de escalado con objetivos y time_to_ack_seconds | +| `working_hours` | json | No | Nueva configuración de horario laboral. Array de \{weekday, start_time, end_time\} | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `escalation_path` | objeto | La ruta de escalado actualizada | + +### `incidentio_escalation_paths_delete` + +Eliminar una ruta de escalado en incident.io + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de incident.io | +| `id` | string | Sí | El ID de la ruta de escalación a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `message` | string | Mensaje de éxito | + +## Notas + +- Categoría: `tools` +- Tipo: `incidentio` diff --git a/apps/docs/content/docs/es/tools/knowledge.mdx b/apps/docs/content/docs/es/tools/knowledge.mdx index 4dd73b3db7..e4805dbb24 100644 --- a/apps/docs/content/docs/es/tools/knowledge.mdx +++ b/apps/docs/content/docs/es/tools/knowledge.mdx @@ -41,9 +41,13 @@ Busca contenido similar en una base de conocimiento utilizando similitud vectori | Parámetro | Tipo | Obligatorio | Descripción | | --------- | ---- | -------- | ----------- | | `knowledgeBaseId` | string | Sí | ID de la base de conocimiento en la que buscar | -| `query` | string | No | Texto de consulta de búsqueda \(opcional cuando se utilizan filtros de etiquetas\) | +| `query` | string | No | Texto de consulta de búsqueda \(opcional cuando se usan filtros de etiquetas\) | | `topK` | number | No | Número de resultados más similares a devolver \(1-100\) | | `tagFilters` | array | No | Array de filtros de etiquetas con propiedades tagName y tagValue | +| `items` | object | No | Sin descripción | +| `properties` | string | No | Sin descripción | +| `tagName` | string | No | Sin descripción | +| `tagValue` | string | No | Sin descripción | #### Salida @@ -88,6 +92,11 @@ Crear un nuevo documento en una base de conocimiento | `tag6` | string | No | Valor de etiqueta 6 para el documento | | `tag7` | string | No | Valor de etiqueta 7 para el documento | | `documentTagsData` | array | No | Datos de etiquetas estructurados con nombres, tipos y valores | +| `items` | object | No | Sin descripción | +| `properties` | string | No | Sin descripción | +| `tagName` | string | No | Sin descripción | +| `tagValue` | string | No | Sin descripción | +| `tagType` | string | No | Sin descripción | #### Salida diff --git a/apps/docs/content/docs/es/tools/posthog.mdx b/apps/docs/content/docs/es/tools/posthog.mdx new file mode 100644 index 0000000000..79feac8c17 --- /dev/null +++ b/apps/docs/content/docs/es/tools/posthog.mdx @@ -0,0 +1,1112 @@ +--- +title: PostHog +description: Análisis de productos y gestión de funcionalidades +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +La herramienta [PostHog](https://posthog.com/) integra análisis de productos potentes, gestión de banderas de funcionalidades, experimentación y perspectivas del comportamiento del usuario directamente en tus flujos de trabajo agénticos. Diseñada para equipos modernos, te permite capturar, analizar y actuar sobre los datos de usuarios en tiempo real — ayudándote a crear mejores productos, entender la participación y aumentar las conversiones. + +Con la herramienta PostHog, puedes: + +- **Seguir y analizar eventos**: Usa las operaciones `posthog_capture_event` y `posthog_batch_events` para registrar acciones individuales o múltiples de usuarios, vistas de página o eventos personalizados para análisis profundos. +- **Explorar datos de eventos**: Recupera y lista eventos históricos o en tiempo real usando la operación `posthog_list_events` para análisis avanzado de eventos. +- **Entender a los usuarios**: Aprovecha las operaciones `posthog_list_persons`, `posthog_get_person` y `posthog_delete_person` para gestionar perfiles de usuario, obtener información detallada de usuarios o eliminarlos según sea necesario. +- **Obtener información procesable sobre productos**: Visualiza recorridos de usuarios, uso de funcionalidades y participación a través de las operaciones `posthog_list_insights`, `posthog_get_insight` y `posthog_create_insight`. +- **Gestionar y lanzar funcionalidades de forma segura**: Alterna funcionalidades y ejecuta pruebas A/B o multivariantes a escala usando operaciones como `posthog_list_feature_flags`, `posthog_get_feature_flag`, `posthog_create_feature_flag`, `posthog_update_feature_flag` y `posthog_delete_feature_flag`. +- **Segmentar y dirigirte a audiencias**: Construye, lista o gestiona cohortes con `posthog_list_cohorts`, `posthog_get_cohort` y `posthog_create_cohort`. +- **Recopilar feedback directo**: Diseña, implementa y analiza encuestas a través de `posthog_list_surveys`, `posthog_get_survey`, `posthog_create_survey` y `posthog_update_survey`. +- **Monitorizar la experiencia del usuario**: Accede y analiza grabaciones de sesiones a través de las operaciones `posthog_list_session_recordings` y `posthog_get_session_recording`. +- **Colaborar con tu equipo**: Organiza paneles (`posthog_list_dashboards`, `posthog_get_dashboard`), crea y anota perspectivas y eventos, y gestiona proyectos y organizaciones dentro de PostHog. + +Ya sea que desees implementar análisis de productos a gran escala, mejorar la incorporación de usuarios, refinar tu hoja de ruta del producto o automatizar decisiones basadas en datos de uso reales, la herramienta PostHog potencia tus agentes y flujos de trabajo con análisis avanzados y experimentación dentro del producto, todo en una plataforma unificada. + +¿Buscas análisis de productos reales con privacidad, escalabilidad y una opción de código abierto? PostHog es la herramienta de confianza para equipos ágiles y empresas en todo el mundo. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra PostHog en tu flujo de trabajo. Realiza seguimiento de eventos, gestiona indicadores de funciones, analiza el comportamiento del usuario, ejecuta experimentos, crea encuestas y accede a grabaciones de sesiones. + +## Herramientas + +### `posthog_capture_event` + +Captura un solo evento en PostHog. Utiliza esto para realizar seguimiento de acciones de usuarios, vistas de página o eventos personalizados. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectApiKey` | string | Sí | Clave API del proyecto PostHog \(token público para ingesta de eventos\) | +| `region` | string | No | Región de PostHog: us \(predeterminado\) o eu | +| `event` | string | Sí | El nombre del evento a capturar \(p. ej., "page_view", "button_clicked"\) | +| `distinctId` | string | Sí | Identificador único para el usuario o dispositivo. Puede ser ID de usuario, ID de dispositivo o ID anónimo | +| `properties` | string | No | Cadena JSON de propiedades del evento \(p. ej., \{"button_name": "signup", "page": "homepage"\}\) | +| `timestamp` | string | No | Marca de tiempo ISO 8601 para cuando ocurrió el evento. Si no se proporciona, usa la hora actual | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `status` | string | Mensaje de estado que indica si el evento se capturó correctamente | + +### `posthog_batch_events` + +Captura múltiples eventos a la vez en PostHog. Utiliza esto para la ingesta masiva de eventos y mejorar el rendimiento. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectApiKey` | string | Sí | Clave API del proyecto PostHog \(token público para ingesta de eventos\) | +| `region` | string | No | Región de PostHog: us \(predeterminado\) o eu | +| `batch` | string | Sí | Array JSON de eventos a capturar. Cada evento debe tener: event, distinct_id, y opcionalmente properties, timestamp. Ejemplo: \[\{"event": "page_view", "distinct_id": "user123", "properties": \{"page": "/"\}\}\] | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `status` | string | Mensaje de estado que indica si el lote fue capturado correctamente | +| `eventsProcessed` | number | Número de eventos procesados en el lote | + +### `posthog_list_events` + +Lista eventos en PostHog. Nota: Este endpoint está obsoleto pero se mantiene por compatibilidad. Para uso en producción, es preferible utilizar el endpoint Query con HogQL. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Sí | Clave API personal de PostHog \(para acceso API autenticado\) | +| `region` | string | No | Región de PostHog: us \(predeterminado\) o eu | +| `projectId` | string | Sí | ID del proyecto PostHog | +| `limit` | number | No | Número de eventos a devolver \(predeterminado: 100, máximo: 100\) | +| `offset` | number | No | Número de eventos a omitir para paginación | +| `event` | string | No | Filtrar por nombre específico de evento | +| `distinctId` | string | No | Filtrar por distinct_id específico | +| `before` | string | No | Marca de tiempo ISO 8601 - solo devuelve eventos anteriores a esta hora | +| `after` | string | No | Marca de tiempo ISO 8601 - solo devuelve eventos posteriores a esta hora | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `events` | array | Lista de eventos con sus propiedades y metadatos | + +### `posthog_list_persons` + +Lista personas (usuarios) en PostHog. Devuelve perfiles de usuario con sus propiedades e identificadores distintos. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Sí | Clave API personal de PostHog \(para acceso API autenticado\) | +| `region` | string | No | Región de PostHog: us \(predeterminado\) o eu | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `limit` | number | No | Número de personas a devolver \(predeterminado: 100, máximo: 100\) | +| `offset` | number | No | Número de personas a omitir para paginación | +| `search` | string | No | Buscar personas por email, nombre o ID distintivo | +| `distinctId` | string | No | Filtrar por distinct_id específico | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `persons` | array | Lista de personas con sus propiedades e identificadores | + +### `posthog_get_person` + +Obtener información detallada sobre una persona específica en PostHog mediante su ID o UUID. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Sí | Clave API personal de PostHog \(para acceso API autenticado\) | +| `region` | string | No | Región de PostHog: us \(predeterminado\) o eu | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `personId` | string | Sí | ID o UUID de la persona a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `person` | object | Detalles de la persona incluyendo propiedades e identificadores | + +### `posthog_delete_person` + +Elimina una persona de PostHog. Esto eliminará todos los eventos y datos asociados. Usar con precaución. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Sí | Clave API personal de PostHog \(para acceso API autenticado\) | +| `region` | string | No | Región de PostHog: us \(predeterminado\) o eu | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `personId` | string | Sí | ID de persona o UUID a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `status` | string | Mensaje de estado que indica si la persona fue eliminada con éxito | + +### `posthog_query` + +Ejecuta una consulta HogQL en PostHog. HogQL es PostHog + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Sí | Clave API personal de PostHog \(para acceso API autenticado\) | +| `region` | string | No | Región de PostHog: us \(predeterminado\) o eu | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `query` | string | Sí | Consulta HogQL a ejecutar. Ejemplo: \{"kind": "HogQLQuery", "query": "SELECT event, count\(\) FROM events WHERE timestamp > now\(\) - INTERVAL 1 DAY GROUP BY event"\} | +| `Example` | string | No | Sin descripción | +| `values` | string | No | Cadena JSON opcional de valores de parámetros para consultas parametrizadas. Ejemplo: \{"user_id": "123"\} | +| `Example` | string | No | Sin descripción | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `results` | array | Resultados de la consulta como un array de filas | + +### `posthog_list_insights` + +Lista todos los insights en un proyecto de PostHog. Devuelve configuraciones de insights, filtros y metadatos. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `region` | string | No | Región en la nube de PostHog: "us" o "eu" \(predeterminado: "us"\) | +| `limit` | number | No | Número de resultados a devolver por página \(predeterminado: 100\) | +| `offset` | number | No | Número de resultados a omitir para la paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `count` | number | Número total de insights en el proyecto | +| `next` | string | URL para la siguiente página de resultados | +| `previous` | string | URL para la página anterior de resultados | +| `results` | array | Lista de insights con sus configuraciones y metadatos | + +### `posthog_get_insight` + +Obtiene un insight específico por ID desde PostHog. Devuelve configuración detallada del insight, filtros y metadatos. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `insightId` | string | Sí | El ID del insight a recuperar | +| `region` | string | No | Región en la nube de PostHog: "us" o "eu" \(predeterminado: "us"\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | number | Identificador único para el insight | +| `name` | string | Nombre del insight | +| `description` | string | Descripción del insight | +| `filters` | object | Configuración de filtros para el insight | +| `query` | object | Configuración de consulta para el insight | +| `created_at` | string | Marca de tiempo ISO cuando se creó el insight | +| `created_by` | object | Usuario que creó el insight | +| `last_modified_at` | string | Marca de tiempo ISO cuando se modificó por última vez el insight | +| `last_modified_by` | object | Usuario que modificó por última vez el insight | +| `saved` | boolean | Si el insight está guardado | +| `dashboards` | array | IDs de los dashboards donde aparece este insight | +| `tags` | array | Etiquetas asociadas con el insight | +| `favorited` | boolean | Si el insight está marcado como favorito | + +### `posthog_create_insight` + +Crea un nuevo insight en PostHog. Requiere nombre del insight y configuración de filtros o consulta. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `region` | string | No | Región en la nube de PostHog: "us" o "eu" \(predeterminado: "us"\) | +| `name` | string | No | Nombre para el insight \(opcional - PostHog generará un nombre derivado si no se proporciona\) | +| `description` | string | No | Descripción del insight | +| `filters` | string | No | Cadena JSON de configuración de filtros para el insight | +| `query` | string | No | Cadena JSON de configuración de consulta para el insight | +| `dashboards` | string | No | Lista separada por comas de IDs de dashboard para añadir este insight | +| `tags` | string | No | Lista separada por comas de etiquetas para el insight | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | number | Identificador único para el insight creado | +| `name` | string | Nombre del insight | +| `description` | string | Descripción del insight | +| `filters` | object | Configuración de filtro para el insight | +| `query` | object | Configuración de consulta para el insight | +| `created_at` | string | Marca de tiempo ISO cuando se creó el insight | +| `created_by` | object | Usuario que creó el insight | +| `last_modified_at` | string | Marca de tiempo ISO cuando se modificó por última vez el insight | +| `saved` | boolean | Si el insight está guardado | +| `dashboards` | array | IDs de los dashboards donde aparece este insight | +| `tags` | array | Etiquetas asociadas con el insight | + +### `posthog_list_dashboards` + +Lista todos los dashboards en un proyecto de PostHog. Devuelve configuraciones de dashboard, mosaicos y metadatos. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `region` | string | No | Región de la nube de PostHog: "us" o "eu" \(predeterminado: "us"\) | +| `limit` | number | No | Número de resultados a devolver por página \(predeterminado: 100\) | +| `offset` | number | No | Número de resultados a omitir para la paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `count` | number | Número total de dashboards en el proyecto | +| `next` | string | URL para la siguiente página de resultados | +| `previous` | string | URL para la página anterior de resultados | +| `results` | array | Lista de dashboards con sus configuraciones y metadatos | + +### `posthog_get_dashboard` + +Obtén un panel específico por ID desde PostHog. Devuelve la configuración detallada del panel, los mosaicos y los metadatos. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `dashboardId` | string | Sí | El ID del panel a recuperar | +| `region` | string | No | Región en la nube de PostHog: "us" o "eu" \(predeterminado: "us"\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | number | Identificador único para el panel | +| `name` | string | Nombre del panel | +| `description` | string | Descripción del panel | +| `pinned` | boolean | Si el panel está fijado | +| `created_at` | string | Marca de tiempo ISO cuando se creó el panel | +| `created_by` | object | Usuario que creó el panel | +| `last_modified_at` | string | Marca de tiempo ISO cuando se modificó por última vez el panel | +| `last_modified_by` | object | Usuario que modificó por última vez el panel | +| `tiles` | array | Mosaicos/widgets en el panel con sus configuraciones | +| `filters` | object | Filtros globales aplicados al panel | +| `tags` | array | Etiquetas asociadas con el panel | +| `restriction_level` | number | Nivel de restricción de acceso para el panel | + +### `posthog_list_actions` + +Lista todas las acciones en un proyecto de PostHog. Devuelve definiciones de acciones, pasos y metadatos. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `region` | string | No | Región en la nube de PostHog: "us" o "eu" \(predeterminado: "us"\) | +| `limit` | number | No | Número de resultados a devolver por página \(predeterminado: 100\) | +| `offset` | number | No | Número de resultados a omitir para la paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `count` | number | Número total de acciones en el proyecto | +| `next` | string | URL para la siguiente página de resultados | +| `previous` | string | URL para la página anterior de resultados | +| `results` | array | Lista de acciones con sus definiciones y metadatos | + +### `posthog_list_cohorts` + +Lista todas las cohortes en un proyecto de PostHog. Devuelve definiciones de cohortes, filtros y recuentos de usuarios. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `region` | string | No | Región en la nube de PostHog: "us" o "eu" \(predeterminado: "us"\) | +| `limit` | number | No | Número de resultados a devolver por página \(predeterminado: 100\) | +| `offset` | number | No | Número de resultados a omitir para la paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `count` | number | Número total de cohortes en el proyecto | +| `next` | string | URL para la siguiente página de resultados | +| `previous` | string | URL para la página anterior de resultados | +| `results` | array | Lista de cohortes con sus definiciones y metadatos | + +### `posthog_get_cohort` + +Obtén una cohorte específica por ID desde PostHog. Devuelve la definición detallada de la cohorte, filtros y recuento de usuarios. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `cohortId` | string | Sí | El ID de la cohorte a recuperar | +| `region` | string | No | Región en la nube de PostHog: "us" o "eu" \(predeterminado: "us"\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | number | Identificador único para la cohorte | +| `name` | string | Nombre de la cohorte | +| `description` | string | Descripción de la cohorte | +| `groups` | array | Grupos que definen la cohorte | +| `deleted` | boolean | Si la cohorte está eliminada | +| `filters` | object | Configuración de filtro para la cohorte | +| `query` | object | Configuración de consulta para la cohorte | +| `created_at` | string | Marca de tiempo ISO cuando se creó la cohorte | +| `created_by` | object | Usuario que creó la cohorte | +| `is_calculating` | boolean | Si la cohorte está siendo calculada | +| `last_calculation` | string | Marca de tiempo ISO del último cálculo | +| `errors_calculating` | number | Número de errores durante el cálculo | +| `count` | number | Número de usuarios en la cohorte | +| `is_static` | boolean | Si la cohorte es estática | +| `version` | number | Número de versión de la cohorte | + +### `posthog_create_cohort` + +Crea una nueva cohorte en PostHog. Requiere nombre de cohorte y configuración de filtro o consulta. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `region` | string | No | Región en la nube de PostHog: "us" o "eu" \(predeterminado: "us"\) | +| `name` | string | No | Nombre para la cohorte \(opcional - PostHog usará "Untitled cohort" si no se proporciona\) | +| `description` | string | No | Descripción de la cohorte | +| `filters` | string | No | Cadena JSON de configuración de filtro para la cohorte | +| `query` | string | No | Cadena JSON de configuración de consulta para la cohorte | +| `is_static` | boolean | No | Si la cohorte es estática \(predeterminado: false\) | +| `groups` | string | No | Cadena JSON de grupos que definen la cohorte | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | number | Identificador único para la cohorte creada | +| `name` | string | Nombre de la cohorte | +| `description` | string | Descripción de la cohorte | +| `groups` | array | Grupos que definen la cohorte | +| `deleted` | boolean | Si la cohorte está eliminada | +| `filters` | object | Configuración de filtro para la cohorte | +| `query` | object | Configuración de consulta para la cohorte | +| `created_at` | string | Marca de tiempo ISO cuando se creó la cohorte | +| `created_by` | object | Usuario que creó la cohorte | +| `is_calculating` | boolean | Si la cohorte está siendo calculada | +| `count` | number | Número de usuarios en la cohorte | +| `is_static` | boolean | Si la cohorte es estática | +| `version` | number | Número de versión de la cohorte | + +### `posthog_list_annotations` + +Lista todas las anotaciones en un proyecto de PostHog. Devuelve el contenido de las anotaciones, marcas de tiempo e insights asociados. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `region` | string | No | Región en la nube de PostHog: "us" o "eu" \(predeterminado: "us"\) | +| `limit` | number | No | Número de resultados a devolver por página \(predeterminado: 100\) | +| `offset` | number | No | Número de resultados a omitir para la paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `count` | number | Número total de anotaciones en el proyecto | +| `next` | string | URL para la siguiente página de resultados | +| `previous` | string | URL para la página anterior de resultados | +| `results` | array | Lista de anotaciones con su contenido y metadatos | + +### `posthog_create_annotation` + +Crea una nueva anotación en PostHog. Marca eventos importantes en tus gráficos con fecha y descripción. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `region` | string | No | Región en la nube de PostHog: "us" o "eu" \(predeterminado: "us"\) | +| `content` | string | Sí | Contenido/texto de la anotación | +| `date_marker` | string | Sí | Marca de tiempo ISO que indica cuándo se aplica la anotación \(p. ej., "2024-01-15T10:00:00Z"\) | +| `scope` | string | No | Alcance de la anotación: "project" o "dashboard_item" \(predeterminado: "project"\) | +| `dashboard_item` | string | No | ID del elemento del panel para adjuntar esta anotación | +| `insight_short_id` | string | No | ID corto del insight para adjuntar esta anotación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | number | Identificador único para la anotación creada | +| `content` | string | Contenido/texto de la anotación | +| `date_marker` | string | Marca de tiempo ISO que indica cuándo se aplica la anotación | +| `created_at` | string | Marca de tiempo ISO cuando se creó la anotación | +| `updated_at` | string | Marca de tiempo ISO cuando se actualizó por última vez la anotación | +| `created_by` | object | Usuario que creó la anotación | +| `dashboard_item` | number | ID del elemento del panel al que está adjunta esta anotación | +| `insight_short_id` | string | ID corto del insight al que está adjunta esta anotación | +| `insight_name` | string | Nombre del insight al que está adjunta esta anotación | +| `scope` | string | Ámbito de la anotación \(proyecto o elemento_del_panel\) | +| `deleted` | boolean | Si la anotación está eliminada | + +### `posthog_list_feature_flags` + +Listar todas las feature flags en un proyecto de PostHog + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `region` | string | Sí | Región de la nube de PostHog: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `limit` | number | No | Número de resultados a devolver | +| `offset` | number | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `results` | array | Lista de feature flags | + +### `posthog_get_feature_flag` + +Obtener detalles de un feature flag específico + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `flagId` | string | Sí | El ID del feature flag | +| `region` | string | Sí | Región de la nube de PostHog: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `flag` | object | Detalles del feature flag | + +### `posthog_create_feature_flag` + +Crear un nuevo feature flag en PostHog + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `region` | string | Sí | Región de la nube de PostHog: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `name` | string | No | Nombre del feature flag \(opcional - puede estar vacío\) | +| `key` | string | Sí | Clave del feature flag \(identificador único\) | +| `filters` | string | No | Filtros del feature flag como cadena JSON | +| `active` | boolean | No | Si el flag está activo \(predeterminado: true\) | +| `ensureExperienceContinuity` | boolean | No | Si se debe asegurar la continuidad de la experiencia \(predeterminado: false\) | +| `rolloutPercentage` | number | No | Porcentaje de despliegue \(0-100\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `flag` | object | Bandera de característica creada | + +### `posthog_update_feature_flag` + +Actualizar una bandera de característica existente en PostHog + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `flagId` | string | Sí | El ID de la bandera de característica | +| `region` | string | Sí | Región de la nube de PostHog: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `name` | string | No | Nombre de la bandera de característica | +| `key` | string | No | Clave de la bandera de característica \(identificador único\) | +| `filters` | string | No | Filtros de la bandera de característica como cadena JSON | +| `active` | boolean | No | Si la bandera está activa | +| `ensureExperienceContinuity` | boolean | No | Si se debe asegurar la continuidad de la experiencia | +| `rolloutPercentage` | number | No | Porcentaje de despliegue \(0-100\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `flag` | object | Bandera de característica actualizada | + +### `posthog_delete_feature_flag` + +Eliminar una bandera de característica de PostHog + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | El ID del proyecto de PostHog | +| `flagId` | string | Sí | El ID de la bandera de característica a eliminar | +| `region` | string | Sí | Región de la nube de PostHog: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Si la eliminación fue exitosa | +| `message` | string | Mensaje de confirmación | + +### `posthog_evaluate_flags` + +Evalúa las feature flags para un usuario o grupo específico. Este es un endpoint público que utiliza la clave API del proyecto. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `region` | string | Sí | Región de PostHog cloud: us o eu | +| `projectApiKey` | string | Sí | Clave API del proyecto PostHog (no clave API personal) | +| `distinctId` | string | Sí | El ID distintivo del usuario para el que se evaluarán las flags | +| `groups` | string | No | Grupos como cadena JSON (p. ej., \{"company": "company_id_in_your_db"\}) | +| `personProperties` | string | No | Propiedades de persona como cadena JSON | +| `groupProperties` | string | No | Propiedades de grupo como cadena JSON | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `featureFlags` | object | Evaluaciones de feature flag (pares clave-valor donde los valores son booleanos o variantes de cadena) | +| `featureFlagPayloads` | object | Cargas adicionales adjuntas a las feature flags | +| `errorsWhileComputingFlags` | boolean | Si hubo errores al calcular las flags | + +### `posthog_list_experiments` + +Lista todos los experimentos en un proyecto de PostHog + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | El ID del proyecto PostHog | +| `region` | string | Sí | Región de PostHog cloud: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `limit` | number | No | Número de resultados a devolver | +| `offset` | number | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `results` | array | Lista de experimentos | + +### `posthog_get_experiment` + +Obtener detalles de un experimento específico + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | El ID del proyecto PostHog | +| `experimentId` | string | Sí | El ID del experimento | +| `region` | string | Sí | Región en la nube de PostHog: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `experiment` | object | Detalles del experimento | + +### `posthog_create_experiment` + +Crear un nuevo experimento en PostHog + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | El ID del proyecto PostHog | +| `region` | string | Sí | Región en la nube de PostHog: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `name` | string | No | Nombre del experimento \(opcional\) | +| `description` | string | No | Descripción del experimento | +| `featureFlagKey` | string | Sí | Clave de feature flag para usar en el experimento | +| `parameters` | string | No | Parámetros del experimento como cadena JSON | +| `filters` | string | No | Filtros del experimento como cadena JSON | +| `variants` | string | No | Variantes del experimento como cadena JSON | +| `startDate` | string | No | Fecha de inicio del experimento \(formato ISO\) | +| `endDate` | string | No | Fecha de finalización del experimento \(formato ISO\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `experiment` | objeto | Experimento creado | + +### `posthog_list_surveys` + +Lista todas las encuestas en un proyecto de PostHog. Las encuestas te permiten recopilar comentarios de los usuarios. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `region` | string | No | Región en la nube de PostHog: us o eu \(predeterminado: us\) | +| `limit` | number | No | Número de resultados a devolver \(predeterminado: 100\) | +| `offset` | number | No | Número de resultados a omitir para la paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `surveys` | array | Lista de encuestas en el proyecto | + +### `posthog_get_survey` + +Obtiene detalles de una encuesta específica en PostHog por ID. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `surveyId` | string | Sí | ID de la encuesta a recuperar | +| `region` | string | No | Región en la nube de PostHog: us o eu \(predeterminado: us\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `survey` | objeto | Detalles de la encuesta | + +### `posthog_create_survey` + +Crea una nueva encuesta en PostHog. Admite tipos de preguntas: Básica (abierta), Enlace, Valoración y Opción múltiple. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `region` | string | No | Región de la nube de PostHog: us o eu \(predeterminado: us\) | +| `name` | string | No | Nombre de la encuesta \(opcional\) | +| `description` | string | No | Descripción de la encuesta | +| `type` | string | No | Tipo de encuesta: popover \(en la aplicación\) o api \(implementación personalizada\) \(predeterminado: popover\) | +| `questions` | string | Sí | Cadena JSON del array de preguntas de la encuesta. Cada pregunta debe tener tipo \(open/link/rating/multiple_choice\) y texto de la pregunta. Las preguntas de valoración pueden tener escala \(1-10\), lowerBoundLabel, upperBoundLabel. Las preguntas de opción múltiple necesitan un array de opciones. Las preguntas de enlace pueden tener buttonText. | +| `startDate` | string | No | Fecha de inicio de la encuesta en formato ISO 8601 | +| `endDate` | string | No | Fecha de finalización de la encuesta en formato ISO 8601 | +| `appearance` | string | No | Cadena JSON de configuración de apariencia \(colores, posición, etc.\) | +| `conditions` | string | No | Cadena JSON de condiciones de visualización \(coincidencia de URL, etc.\) | +| `targetingFlagFilters` | string | No | Cadena JSON de filtros de feature flag para segmentación | +| `linkedFlagId` | string | No | ID de feature flag para vincular a esta encuesta | +| `responsesLimit` | number | No | Número máximo de respuestas a recopilar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `survey` | objeto | Detalles de la encuesta creada | + +### `posthog_update_survey` + +Actualiza una encuesta existente en PostHog. Puede modificar preguntas, apariencia, condiciones y otros ajustes. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `surveyId` | string | Sí | ID de la encuesta a actualizar | +| `region` | string | No | Región en la nube de PostHog: us o eu \(predeterminado: us\) | +| `name` | string | No | Nombre de la encuesta | +| `description` | string | No | Descripción de la encuesta | +| `type` | string | No | Tipo de encuesta: popover o api | +| `questions` | string | No | Cadena JSON del array de preguntas de la encuesta. Cada pregunta debe tener tipo \(open/link/rating/multiple_choice\) y texto de la pregunta. | +| `startDate` | string | No | Fecha de inicio de la encuesta en formato ISO 8601 | +| `endDate` | string | No | Fecha de finalización de la encuesta en formato ISO 8601 | +| `appearance` | string | No | Cadena JSON de configuración de apariencia \(colores, posición, etc.\) | +| `conditions` | string | No | Cadena JSON de condiciones de visualización \(coincidencia de URL, etc.\) | +| `targetingFlagFilters` | string | No | Cadena JSON de filtros de feature flag para segmentación | +| `linkedFlagId` | string | No | ID de feature flag para vincular a esta encuesta | +| `responsesLimit` | number | No | Número máximo de respuestas a recopilar | +| `archived` | boolean | No | Archivar o desarchivar la encuesta | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `survey` | objeto | Detalles actualizados de la encuesta | + +### `posthog_list_session_recordings` + +Listar grabaciones de sesión en un proyecto de PostHog. Las grabaciones de sesión capturan las interacciones del usuario con tu aplicación. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `region` | string | No | Región en la nube de PostHog: us o eu \(predeterminado: us\) | +| `limit` | number | No | Número de resultados a devolver \(predeterminado: 50\) | +| `offset` | number | No | Número de resultados a omitir para la paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `recordings` | array | Lista de grabaciones de sesión | + +### `posthog_get_session_recording` + +Obtener detalles de una grabación de sesión específica en PostHog por ID. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `recordingId` | string | Sí | ID de la grabación de sesión a recuperar | +| `region` | string | No | Región en la nube de PostHog: us o eu \(predeterminado: us\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `recording` | objeto | Detalles de la grabación de sesión | + +### `posthog_list_recording_playlists` + +Lista las listas de reproducción de grabaciones de sesión en un proyecto de PostHog. Las listas de reproducción te permiten organizar y seleccionar grabaciones de sesión. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `region` | string | No | Región en la nube de PostHog: us o eu \(predeterminado: us\) | +| `limit` | number | No | Número de resultados a devolver \(predeterminado: 100\) | +| `offset` | number | No | Número de resultados a omitir para la paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `playlists` | array | Lista de listas de reproducción de grabaciones de sesión | + +### `posthog_list_event_definitions` + +Lista todas las definiciones de eventos en un proyecto de PostHog. Las definiciones de eventos representan eventos rastreados con metadatos como descripciones, etiquetas y estadísticas de uso. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `region` | string | Sí | Región en la nube de PostHog: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `limit` | number | No | Número de resultados a devolver por página \(predeterminado: 100\) | +| `offset` | number | No | El índice inicial desde el cual devolver resultados | +| `search` | string | No | Término de búsqueda para filtrar definiciones de eventos por nombre | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `count` | number | Número total de definiciones de eventos | +| `next` | string | URL para la siguiente página de resultados | +| `previous` | string | URL para la página anterior de resultados | +| `results` | array | Lista de definiciones de eventos | + +### `posthog_get_event_definition` + +Obtén detalles de una definición de evento específica en PostHog. Devuelve información completa sobre el evento, incluyendo metadatos, estadísticas de uso y estado de verificación. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto PostHog | +| `eventDefinitionId` | string | Sí | ID de la definición de evento a recuperar | +| `region` | string | Sí | Región de la nube PostHog: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | string | Identificador único para la definición de evento | +| `name` | string | Nombre del evento | +| `description` | string | Descripción del evento | +| `tags` | array | Etiquetas asociadas con el evento | +| `volume_30_day` | number | Número de eventos recibidos en los últimos 30 días | +| `query_usage_30_day` | number | Número de veces que este evento fue consultado en los últimos 30 días | +| `created_at` | string | Marca de tiempo ISO cuando se creó el evento | +| `last_seen_at` | string | Marca de tiempo ISO cuando se vio el evento por última vez | +| `updated_at` | string | Marca de tiempo ISO cuando se actualizó el evento | +| `updated_by` | object | Usuario que actualizó el evento por última vez | +| `verified` | boolean | Si el evento ha sido verificado | +| `verified_at` | string | Marca de tiempo ISO cuando se verificó el evento | +| `verified_by` | string | Usuario que verificó el evento | + +### `posthog_update_event_definition` + +Actualiza una definición de evento en PostHog. Puede modificar la descripción, etiquetas y estado de verificación para mantener esquemas de eventos limpios. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `eventDefinitionId` | string | Sí | ID de la definición de evento a actualizar | +| `region` | string | Sí | Región de la nube de PostHog: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `description` | string | No | Descripción actualizada para el evento | +| `tags` | string | No | Lista de etiquetas separadas por comas para asociar con el evento | +| `verified` | boolean | No | Si se debe marcar el evento como verificado | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | string | Identificador único para la definición del evento | +| `name` | string | Nombre del evento | +| `description` | string | Descripción actualizada del evento | +| `tags` | array | Etiquetas actualizadas asociadas con el evento | +| `volume_30_day` | number | Número de eventos recibidos en los últimos 30 días | +| `query_usage_30_day` | number | Número de veces que este evento fue consultado en los últimos 30 días | +| `created_at` | string | Marca de tiempo ISO cuando se creó el evento | +| `last_seen_at` | string | Marca de tiempo ISO cuando se vio el evento por última vez | +| `updated_at` | string | Marca de tiempo ISO cuando se actualizó el evento | +| `updated_by` | object | Usuario que actualizó el evento por última vez | +| `verified` | boolean | Si el evento ha sido verificado | +| `verified_at` | string | Marca de tiempo ISO cuando se verificó el evento | +| `verified_by` | string | Usuario que verificó el evento | + +### `posthog_list_property_definitions` + +Lista todas las definiciones de propiedades en un proyecto de PostHog. Las definiciones de propiedades representan propiedades rastreadas con metadatos como descripciones, etiquetas, tipos y estadísticas de uso. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `region` | string | Sí | Región de la nube de PostHog: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `limit` | number | No | Número de resultados a devolver por página \(predeterminado: 100\) | +| `offset` | number | No | El índice inicial desde el cual devolver resultados | +| `search` | string | No | Término de búsqueda para filtrar definiciones de propiedades por nombre | +| `type` | string | No | Filtrar por tipo de propiedad: event, person o group | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `count` | number | Número total de definiciones de propiedades | +| `next` | string | URL para la siguiente página de resultados | +| `previous` | string | URL para la página anterior de resultados | +| `results` | array | Lista de definiciones de propiedades | + +### `posthog_get_property_definition` + +Obtén detalles de una definición de propiedad específica en PostHog. Devuelve información completa sobre la propiedad, incluyendo metadatos, tipo, estadísticas de uso y estado de verificación. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto de PostHog | +| `propertyDefinitionId` | string | Sí | ID de la definición de propiedad a recuperar | +| `region` | string | Sí | Región de la nube de PostHog: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | string | Identificador único para la definición de propiedad | +| `name` | string | Nombre de la propiedad | +| `description` | string | Descripción de la propiedad | +| `tags` | array | Etiquetas asociadas con la propiedad | +| `is_numerical` | boolean | Si la propiedad es numérica | +| `is_seen_on_filtered_events` | boolean | Si la propiedad se ve en eventos filtrados | +| `property_type` | string | El tipo de datos de la propiedad | +| `type` | string | Tipo de propiedad: evento, persona o grupo | +| `volume_30_day` | number | Número de veces que se vio la propiedad en los últimos 30 días | +| `query_usage_30_day` | number | Número de veces que se consultó esta propiedad en los últimos 30 días | +| `created_at` | string | Marca de tiempo ISO cuando se creó la propiedad | +| `updated_at` | string | Marca de tiempo ISO cuando se actualizó la propiedad | +| `updated_by` | object | Usuario que actualizó por última vez la propiedad | +| `verified` | boolean | Si la propiedad ha sido verificada | +| `verified_at` | string | Marca de tiempo ISO cuando se verificó la propiedad | +| `verified_by` | string | Usuario que verificó la propiedad | +| `example` | string | Valor de ejemplo para la propiedad | + +### `posthog_update_property_definition` + +Actualiza una definición de propiedad en PostHog. Puede modificar la descripción, etiquetas, tipo de propiedad y estado de verificación para mantener esquemas de propiedades limpios. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ---------- | ----------- | +| `projectId` | string | Sí | ID del proyecto PostHog | +| `propertyDefinitionId` | string | Sí | ID de definición de propiedad a actualizar | +| `region` | string | Sí | Región de la nube PostHog: us o eu | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `description` | string | No | Descripción actualizada para la propiedad | +| `tags` | string | No | Lista separada por comas de etiquetas para asociar con la propiedad | +| `verified` | boolean | No | Si se debe marcar la propiedad como verificada | +| `property_type` | string | No | El tipo de datos de la propiedad \(p. ej., String, Numeric, Boolean, DateTime, etc.\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `id` | string | Identificador único para la definición de la propiedad | +| `name` | string | Nombre de la propiedad | +| `description` | string | Descripción actualizada de la propiedad | +| `tags` | array | Etiquetas actualizadas asociadas con la propiedad | +| `is_numerical` | boolean | Si la propiedad es numérica | +| `is_seen_on_filtered_events` | boolean | Si la propiedad se ve en eventos filtrados | +| `property_type` | string | El tipo de datos de la propiedad | +| `type` | string | Tipo de propiedad: evento, persona o grupo | +| `volume_30_day` | number | Número de veces que se vio la propiedad en los últimos 30 días | +| `query_usage_30_day` | number | Número de veces que se consultó esta propiedad en los últimos 30 días | +| `created_at` | string | Marca de tiempo ISO cuando se creó la propiedad | +| `updated_at` | string | Marca de tiempo ISO cuando se actualizó la propiedad | +| `updated_by` | object | Usuario que actualizó la propiedad por última vez | +| `verified` | boolean | Si la propiedad ha sido verificada | +| `verified_at` | string | Marca de tiempo ISO cuando se verificó la propiedad | +| `verified_by` | string | Usuario que verificó la propiedad | +| `example` | string | Valor de ejemplo para la propiedad | + +### `posthog_list_projects` + +Lista todos los proyectos en la organización. Devuelve detalles del proyecto incluyendo IDs, nombres, tokens API y configuraciones. Útil para obtener IDs de proyectos necesarios para otros endpoints. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `region` | string | No | Región en la nube: us o eu \(predeterminado: us\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `projects` | array | Lista de proyectos con su configuración y ajustes | + +### `posthog_get_project` + +Obtener información detallada sobre un proyecto específico por ID. Devuelve la configuración completa del proyecto, ajustes y feature flags. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Sí | ID del proyecto \(ID numérico o UUID\) | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `region` | string | No | Región en la nube: us o eu \(predeterminado: us\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `project` | object | Información detallada del proyecto con todos los ajustes de configuración | + +### `posthog_list_organizations` + +Listar todas las organizaciones a las que el usuario tiene acceso. Devuelve detalles de la organización incluyendo nombre, slug, nivel de membresía y características de producto disponibles. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `region` | string | No | Región en la nube: us o eu \(predeterminado: us\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `organizations` | array | Lista de organizaciones con sus configuraciones y características | + +### `posthog_get_organization` + +Obtén información detallada sobre una organización específica por ID. Devuelve configuraciones completas de la organización, características, uso e información del equipo. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `organizationId` | string | Sí | ID de la organización \(UUID\) | +| `apiKey` | string | Sí | Clave API personal de PostHog | +| `region` | string | No | Región en la nube: us o eu \(predeterminado: us\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `organization` | object | Información detallada de la organización con configuraciones y características | + +## Notas + +- Categoría: `tools` +- Tipo: `posthog` diff --git a/apps/docs/content/docs/es/tools/sentry.mdx b/apps/docs/content/docs/es/tools/sentry.mdx new file mode 100644 index 0000000000..e44581175c --- /dev/null +++ b/apps/docs/content/docs/es/tools/sentry.mdx @@ -0,0 +1,305 @@ +--- +title: Sentry +description: Gestiona problemas, proyectos, eventos y lanzamientos de Sentry +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +Potencia tu monitoreo de errores y la fiabilidad de aplicaciones con [Sentry](https://sentry.io/) — la plataforma líder en la industria para seguimiento de errores en tiempo real, monitoreo de rendimiento y gestión de lanzamientos. Integra Sentry sin problemas en tus flujos de trabajo de agentes automatizados para monitorear fácilmente problemas, seguir eventos críticos, gestionar proyectos y orquestar lanzamientos en todas tus aplicaciones y servicios. + +Con la herramienta Sentry, puedes: + +- **Monitorear y clasificar problemas**: Obtén listas completas de problemas usando la operación `sentry_issues_list` y recupera información detallada sobre errores y fallos individuales a través de `sentry_issues_get`. Accede instantáneamente a metadatos, etiquetas, trazas de pila y estadísticas para reducir el tiempo medio de resolución. +- **Seguir datos de eventos**: Analiza instancias específicas de errores y eventos con `sentry_events_list` y `sentry_events_get`, proporcionando una visión profunda de las ocurrencias de errores y el impacto en los usuarios. +- **Gestionar proyectos y equipos**: Usa `sentry_projects_list` y `sentry_project_get` para enumerar y revisar todos tus proyectos de Sentry, asegurando una colaboración fluida del equipo y una configuración centralizada. +- **Coordinar lanzamientos**: Automatiza el seguimiento de versiones, la salud de los despliegues y la gestión de cambios en tu código con operaciones como `sentry_releases_list`, `sentry_release_get`, y más. +- **Obtener potentes perspectivas de aplicaciones**: Aprovecha filtros avanzados y consultas para encontrar problemas no resueltos o de alta prioridad, agregar estadísticas de eventos a lo largo del tiempo y seguir regresiones a medida que evoluciona tu código. + +La integración de Sentry capacita a los equipos de ingeniería y DevOps para detectar problemas temprano, priorizar los errores más impactantes y mejorar continuamente la salud de las aplicaciones en todos los entornos de desarrollo. Orquesta programáticamente la automatización de flujos de trabajo para la observabilidad moderna, respuesta a incidentes y gestión del ciclo de vida de lanzamientos, reduciendo el tiempo de inactividad y aumentando la satisfacción del usuario. + +**Operaciones clave de Sentry disponibles**: +- `sentry_issues_list`: Lista problemas de Sentry para organizaciones y proyectos, con potentes búsquedas y filtrado. +- `sentry_issues_get`: Recupera información detallada de un problema específico de Sentry. +- `sentry_events_list`: Enumera los eventos de un problema específico para análisis de causa raíz. +- `sentry_events_get`: Obtén detalles completos de un evento individual, incluyendo trazas de pila, contexto y metadatos. +- `sentry_projects_list`: Lista todos los proyectos de Sentry dentro de tu organización. +- `sentry_project_get`: Recupera la configuración y detalles de un proyecto específico. +- `sentry_releases_list`: Lista versiones recientes y su estado de implementación. +- `sentry_release_get`: Recupera información detallada de versiones, incluyendo commits y problemas asociados. + +Ya sea que estés gestionando proactivamente la salud de la aplicación, solucionando errores en producción o automatizando flujos de trabajo de lanzamiento, Sentry te equipa con monitoreo de clase mundial, alertas procesables e integración DevOps perfecta. Mejora la calidad de tu software y la visibilidad en búsquedas aprovechando Sentry para seguimiento de errores, observabilidad y gestión de versiones, todo desde tus flujos de trabajo agénticos. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra Sentry en el flujo de trabajo. Monitorea problemas, gestiona proyectos, realiza seguimiento de eventos y coordina lanzamientos en todas tus aplicaciones. + +## Herramientas + +### `sentry_issues_list` + +Lista problemas de Sentry para una organización específica y opcionalmente un proyecto específico. Devuelve detalles del problema incluyendo estado, recuento de errores y marcas de tiempo de última visualización. + +#### Entrada + +| Parámetro | Tipo | Requerido | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de autenticación de la API de Sentry | +| `organizationSlug` | string | Sí | El slug de la organización | +| `projectSlug` | string | No | Filtrar problemas por slug de proyecto específico \(opcional\) | +| `query` | string | No | Consulta de búsqueda para filtrar problemas. Admite sintaxis de búsqueda de Sentry \(p.ej., "is:unresolved", "level:error"\) | +| `statsPeriod` | string | No | Período de tiempo para estadísticas \(p.ej., "24h", "7d", "30d"\). Por defecto es 24h si no se especifica. | +| `cursor` | string | No | Cursor de paginación para recuperar la siguiente página de resultados | +| `limit` | number | No | Número de problemas a devolver por página \(predeterminado: 25, máx: 100\) | +| `status` | string | No | Filtrar por estado del problema: unresolved, resolved, ignored o muted | +| `sort` | string | No | Orden de clasificación: date, new, freq, priority o user \(predeterminado: date\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `issues` | array | Lista de problemas de Sentry | + +### `sentry_issues_get` + +Recupera información detallada sobre un problema específico de Sentry mediante su ID. Devuelve detalles completos del problema, incluyendo metadatos, etiquetas y estadísticas. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de autenticación de la API de Sentry | +| `organizationSlug` | string | Sí | El slug de la organización | +| `issueId` | string | Sí | El ID único del problema a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `issue` | object | Información detallada sobre el problema de Sentry | + +### `sentry_issues_update` + +Actualiza un problema de Sentry cambiando su estado, asignación, estado de marcador u otras propiedades. Devuelve los detalles actualizados del problema. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de autenticación de la API de Sentry | +| `organizationSlug` | string | Sí | El slug de la organización | +| `issueId` | string | Sí | El ID único del problema a actualizar | +| `status` | string | No | Nuevo estado para el problema: resolved, unresolved, ignored, o resolvedInNextRelease | +| `assignedTo` | string | No | ID de usuario o correo electrónico para asignar el problema. Usar cadena vacía para desasignar. | +| `isBookmarked` | boolean | No | Si se debe marcar el problema como favorito | +| `isSubscribed` | boolean | No | Si se debe suscribir a las actualizaciones del problema | +| `isPublic` | boolean | No | Si el problema debe ser visible públicamente | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `issue` | object | El problema de Sentry actualizado | + +### `sentry_projects_list` + +Lista todos los proyectos en una organización de Sentry. Devuelve detalles del proyecto incluyendo nombre, plataforma, equipos y configuración. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de autenticación de la API de Sentry | +| `organizationSlug` | string | Sí | El slug de la organización | +| `cursor` | string | No | Cursor de paginación para recuperar la siguiente página de resultados | +| `limit` | number | No | Número de proyectos a devolver por página \(predeterminado: 25, máximo: 100\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `projects` | array | Lista de proyectos de Sentry | + +### `sentry_projects_get` + +Recupera información detallada sobre un proyecto específico de Sentry por su slug. Devuelve detalles completos del proyecto incluyendo equipos, características y configuración. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de autenticación de la API de Sentry | +| `organizationSlug` | string | Sí | El slug de la organización | +| `projectSlug` | string | Sí | El ID o slug del proyecto a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `project` | object | Información detallada sobre el proyecto de Sentry | + +### `sentry_projects_create` + +Crea un nuevo proyecto de Sentry en una organización. Requiere un equipo para asociar el proyecto. Devuelve los detalles del proyecto creado. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de autenticación de la API de Sentry | +| `organizationSlug` | string | Sí | El slug de la organización | +| `name` | string | Sí | El nombre del proyecto | +| `teamSlug` | string | Sí | El slug del equipo que será propietario de este proyecto | +| `slug` | string | No | Identificador del proyecto compatible con URL \(generado automáticamente a partir del nombre si no se proporciona\) | +| `platform` | string | No | Plataforma/lenguaje para el proyecto \(por ejemplo, javascript, python, node, react-native\). Si no se especifica, el valor predeterminado es "other" | +| `defaultRules` | boolean | No | Si se deben crear reglas de alerta predeterminadas \(predeterminado: true\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `project` | object | El proyecto de Sentry recién creado | + +### `sentry_projects_update` + +Actualiza un proyecto de Sentry cambiando su nombre, slug, plataforma u otros ajustes. Devuelve los detalles del proyecto actualizado. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de autenticación de la API de Sentry | +| `organizationSlug` | string | Sí | El slug de la organización | +| `projectSlug` | string | Sí | El slug del proyecto a actualizar | +| `name` | string | No | Nuevo nombre para el proyecto | +| `slug` | string | No | Nuevo identificador del proyecto compatible con URL | +| `platform` | string | No | Nueva plataforma/lenguaje para el proyecto \(por ejemplo, javascript, python, node\) | +| `isBookmarked` | boolean | No | Si se debe marcar el proyecto como favorito | +| `digestsMinDelay` | number | No | Retraso mínimo \(en segundos\) para notificaciones de resumen | +| `digestsMaxDelay` | number | No | Retraso máximo \(en segundos\) para notificaciones de resumen | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `project` | objeto | El proyecto de Sentry actualizado | + +### `sentry_events_list` + +Lista eventos de un proyecto de Sentry. Puede filtrarse por ID de problema, consulta o período de tiempo. Devuelve detalles del evento incluyendo contexto, etiquetas e información del usuario. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de autenticación de la API de Sentry | +| `organizationSlug` | string | Sí | El slug de la organización | +| `projectSlug` | string | Sí | El slug del proyecto del que listar eventos | +| `issueId` | string | No | Filtrar eventos por un ID de problema específico | +| `query` | string | No | Consulta de búsqueda para filtrar eventos. Admite sintaxis de búsqueda de Sentry \(p. ej., "user.email:*@example.com"\) | +| `cursor` | string | No | Cursor de paginación para recuperar la siguiente página de resultados | +| `limit` | number | No | Número de eventos a devolver por página \(predeterminado: 50, máx: 100\) | +| `statsPeriod` | string | No | Período de tiempo para consultar \(p. ej., "24h", "7d", "30d"\). Por defecto es 90d si no se especifica. | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `events` | array | Lista de eventos de Sentry | + +### `sentry_events_get` + +Recupera información detallada sobre un evento específico de Sentry por su ID. Devuelve detalles completos del evento incluyendo trazas de pila, migas de pan, contexto e información del usuario. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de autenticación de la API de Sentry | +| `organizationSlug` | string | Sí | El slug de la organización | +| `projectSlug` | string | Sí | El slug del proyecto | +| `eventId` | string | Sí | El ID único del evento a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `event` | object | Información detallada sobre el evento de Sentry | + +### `sentry_releases_list` + +Lista las versiones para una organización o proyecto de Sentry. Devuelve detalles de la versión incluyendo versión, commits, información de despliegue y proyectos asociados. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de autenticación de la API de Sentry | +| `organizationSlug` | string | Sí | El slug de la organización | +| `projectSlug` | string | No | Filtrar versiones por slug de proyecto específico \(opcional\) | +| `query` | string | No | Consulta de búsqueda para filtrar versiones \(p. ej., patrón de nombre de versión\) | +| `cursor` | string | No | Cursor de paginación para recuperar la siguiente página de resultados | +| `limit` | number | No | Número de versiones a devolver por página \(predeterminado: 25, máx: 100\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `releases` | array | Lista de versiones de Sentry | + +### `sentry_releases_create` + +Crea una nueva versión en Sentry. Una versión es una versión de tu código desplegada en un entorno. Puede incluir información de commits y proyectos asociados. Devuelve los detalles de la versión creada. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de autenticación de la API de Sentry | +| `organizationSlug` | string | Sí | El slug de la organización | +| `version` | string | Sí | Identificador de versión para la release \(p. ej., "2.0.0", "my-app@1.0.0", o un SHA de commit git\) | +| `projects` | string | Sí | Lista separada por comas de slugs de proyectos para asociar con esta versión | +| `ref` | string | No | Referencia Git \(SHA de commit, etiqueta o rama\) para esta versión | +| `url` | string | No | URL que apunta a la versión \(p. ej., página de lanzamiento de GitHub\) | +| `dateReleased` | string | No | Marca de tiempo ISO 8601 para cuando se desplegó la versión \(por defecto es la hora actual\) | +| `commits` | string | No | Array JSON de objetos de commit con id, repository \(opcional\), y message \(opcional\). Ejemplo: \[\{"id":"abc123","message":"Fix bug"\}\] | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `release` | object | La versión de Sentry recién creada | + +### `sentry_releases_deploy` + +Crea un registro de despliegue para una versión de Sentry en un entorno específico. Los despliegues rastrean cuándo y dónde se despliegan las versiones. Devuelve los detalles del despliegue creado. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Token de autenticación de la API de Sentry | +| `organizationSlug` | string | Sí | El slug de la organización | +| `version` | string | Sí | Identificador de versión de la release que se está desplegando | +| `environment` | string | Sí | Nombre del entorno donde se está desplegando la release \(p. ej., "production", "staging"\) | +| `name` | string | No | Nombre opcional para este despliegue \(p. ej., "Deploy v2.0 to Production"\) | +| `url` | string | No | URL que apunta al despliegue \(p. ej., URL del pipeline de CI/CD\) | +| `dateStarted` | string | No | Marca de tiempo ISO 8601 para cuando comenzó el despliegue \(por defecto es la hora actual\) | +| `dateFinished` | string | No | Marca de tiempo ISO 8601 para cuando finalizó el despliegue | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `deploy` | object | El registro de despliegue recién creado | + +## Notas + +- Categoría: `tools` +- Tipo: `sentry` diff --git a/apps/docs/content/docs/fr/blocks/agent.mdx b/apps/docs/content/docs/fr/blocks/agent.mdx index 8b4866fabb..b543ef4ff1 100644 --- a/apps/docs/content/docs/fr/blocks/agent.mdx +++ b/apps/docs/content/docs/fr/blocks/agent.mdx @@ -46,7 +46,7 @@ Le bloc Agent prend en charge plusieurs fournisseurs de LLM via une interface d' - **Anthropic** : Claude 4.5 Sonnet, Claude Opus 4.1 - **Google** : Gemini 2.5 Pro, Gemini 2.0 Flash - **Autres fournisseurs** : Groq, Cerebras, xAI, Azure OpenAI, OpenRouter -- **Modèles locaux** : modèles compatibles avec Ollama +- **Modèles locaux** : modèles compatibles avec Ollama ou VLLM ### Température diff --git a/apps/docs/content/docs/fr/blocks/evaluator.mdx b/apps/docs/content/docs/fr/blocks/evaluator.mdx index fb6ea7b85c..419dc9010e 100644 --- a/apps/docs/content/docs/fr/blocks/evaluator.mdx +++ b/apps/docs/content/docs/fr/blocks/evaluator.mdx @@ -52,7 +52,7 @@ Choisissez un modèle d'IA pour effectuer l'évaluation : - **Anthropic** : Claude 3.7 Sonnet - **Google** : Gemini 2.5 Pro, Gemini 2.0 Flash - **Autres fournisseurs** : Groq, Cerebras, xAI, DeepSeek -- **Modèles locaux** : Modèles compatibles avec Ollama +- **Modèles locaux** : modèles compatibles avec Ollama ou VLLM Utilisez des modèles avec de fortes capacités de raisonnement comme GPT-4o ou Claude 3.7 Sonnet pour de meilleurs résultats. diff --git a/apps/docs/content/docs/fr/blocks/guardrails.mdx b/apps/docs/content/docs/fr/blocks/guardrails.mdx index cd2c491e5c..83d2e0582d 100644 --- a/apps/docs/content/docs/fr/blocks/guardrails.mdx +++ b/apps/docs/content/docs/fr/blocks/guardrails.mdx @@ -64,9 +64,9 @@ Utilise la génération augmentée par récupération (RAG) avec notation LLM po **Configuration :** - **Base de connaissances** : Sélectionnez parmi vos bases de connaissances existantes -- **Modèle** : Choisissez le LLM pour la notation (nécessite un raisonnement solide - GPT-4o, Claude 3.7 Sonnet recommandés) -- **Clé API** : Authentification pour le fournisseur LLM sélectionné (automatiquement masquée pour les modèles hébergés/Ollama) -- **Seuil de confiance** : Score minimum pour réussir (0-10, par défaut : 3) +- **Modèle** : Choisissez le LLM pour l'évaluation (nécessite un raisonnement solide - GPT-4o, Claude 3.7 Sonnet recommandés) +- **Clé API** : Authentification pour le fournisseur LLM sélectionné (masquée automatiquement pour les modèles hébergés/Ollama ou compatibles VLLM) +- **Seuil de confiance** : Score minimum pour valider (0-10, par défaut : 3) - **Top K** (Avancé) : Nombre de fragments de base de connaissances à récupérer (par défaut : 10) **Sortie :** diff --git a/apps/docs/content/docs/fr/blocks/router.mdx b/apps/docs/content/docs/fr/blocks/router.mdx index 953f68ac8c..29f42dc6c0 100644 --- a/apps/docs/content/docs/fr/blocks/router.mdx +++ b/apps/docs/content/docs/fr/blocks/router.mdx @@ -56,7 +56,7 @@ Choisissez un modèle d'IA pour alimenter la décision de routage : - **Anthropic** : Claude 3.7 Sonnet - **Google** : Gemini 2.5 Pro, Gemini 2.0 Flash - **Autres fournisseurs** : Groq, Cerebras, xAI, DeepSeek -- **Modèles locaux** : modèles compatibles avec Ollama +- **Modèles locaux** : modèles compatibles avec Ollama ou VLLM Utilisez des modèles avec de fortes capacités de raisonnement comme GPT-4o ou Claude 3.7 Sonnet pour de meilleurs résultats. diff --git a/apps/docs/content/docs/fr/execution/costs.mdx b/apps/docs/content/docs/fr/execution/costs.mdx index 54c8486fce..2daf1ad909 100644 --- a/apps/docs/content/docs/fr/execution/costs.mdx +++ b/apps/docs/content/docs/fr/execution/costs.mdx @@ -47,7 +47,7 @@ La répartition des modèles montre : ## Options de tarification - + **Modèles hébergés** - Sim fournit des clés API avec un multiplicateur de prix de 2,5x : @@ -74,6 +74,7 @@ La répartition des modèles montre : | Groq | Llama 4 Scout | 0,40 $ / 0,60 $ | | Cerebras | Llama 3.3 70B | 0,94 $ / 0,94 $ | | Ollama | Modèles locaux | Gratuit | + | VLLM | Modèles locaux | Gratuit | *Payez directement les fournisseurs sans majoration* @@ -87,8 +88,8 @@ La répartition des modèles montre : - **Sélection du modèle** : choisissez les modèles en fonction de la complexité de la tâche. Les tâches simples peuvent utiliser GPT-4.1-nano tandis que le raisonnement complexe pourrait nécessiter o1 ou Claude Opus. - **Ingénierie de prompt** : des prompts bien structurés et concis réduisent l'utilisation de tokens sans sacrifier la qualité. -- **Modèles locaux** : utilisez Ollama pour les tâches non critiques afin d'éliminer complètement les coûts d'API. -- **Mise en cache et réutilisation** : stockez les résultats fréquemment utilisés dans des variables ou des fichiers pour éviter les appels répétés au modèle d'IA. +- **Modèles locaux** : utilisez Ollama ou VLLM pour les tâches non critiques afin d'éliminer complètement les coûts d'API. +- **Mise en cache et réutilisation** : stockez les résultats fréquemment utilisés dans des variables ou des fichiers pour éviter les appels répétés aux modèles d'IA. - **Traitement par lots** : traitez plusieurs éléments dans une seule requête d'IA plutôt que de faire des appels individuels. ## Surveillance de l'utilisation diff --git a/apps/docs/content/docs/fr/introduction/index.mdx b/apps/docs/content/docs/fr/introduction/index.mdx index 91a69777fc..8c757a5a85 100644 --- a/apps/docs/content/docs/fr/introduction/index.mdx +++ b/apps/docs/content/docs/fr/introduction/index.mdx @@ -59,7 +59,7 @@ Permettez à votre équipe de construire ensemble. Plusieurs utilisateurs peuven Sim fournit des intégrations natives avec plus de 80 services dans plusieurs catégories : -- **Modèles d'IA** : OpenAI, Anthropic, Google Gemini, Groq, Cerebras, modèles locaux via Ollama +- **Modèles d'IA** : OpenAI, Anthropic, Google Gemini, Groq, Cerebras, modèles locaux via Ollama ou VLLM - **Communication** : Gmail, Slack, Microsoft Teams, Telegram, WhatsApp - **Productivité** : Notion, Google Workspace, Airtable, Monday.com - **Développement** : GitHub, Jira, Linear, tests automatisés de navigateur diff --git a/apps/docs/content/docs/fr/tools/incidentio.mdx b/apps/docs/content/docs/fr/tools/incidentio.mdx new file mode 100644 index 0000000000..11bb2b1f0f --- /dev/null +++ b/apps/docs/content/docs/fr/tools/incidentio.mdx @@ -0,0 +1,841 @@ +--- +title: incidentio +description: Gérez les incidents avec incident.io +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +Optimisez votre gestion d'incidents avec [incident.io](https://incident.io) – la plateforme leader pour orchestrer les incidents, rationaliser les processus de réponse et suivre les actions à mener, le tout en un seul endroit. Intégrez incident.io de manière transparente dans vos flux de travail automatisés pour prendre le contrôle de la création d'incidents, de la collaboration en temps réel, des suivis, de la planification, des escalades et bien plus encore. + +Avec l'outil incident.io, vous pouvez : + +- **Lister et rechercher des incidents** : Récupérez rapidement une liste d'incidents en cours ou historiques, avec toutes les métadonnées comme la gravité, le statut et les horodatages, en utilisant `incidentio_incidents_list`. +- **Créer de nouveaux incidents** : Déclenchez la création de nouveaux incidents par programmation via `incidentio_incidents_create`, en spécifiant la gravité, le nom, le type et les détails personnalisés pour garantir que rien ne ralentit votre réponse. +- **Automatiser les suivis d'incidents** : Exploitez l'automatisation puissante d'incident.io pour garantir que les actions importantes et les enseignements ne sont pas oubliés, aidant les équipes à résoudre les problèmes et à améliorer les processus. +- **Personnaliser les flux de travail** : Intégrez des types d'incidents sur mesure, des niveaux de gravité et des champs personnalisés adaptés aux besoins de votre organisation. +- **Appliquer les meilleures pratiques avec des planifications et des escalades** : Rationalisez les astreintes et la gestion des incidents en attribuant, notifiant et escaladant automatiquement à mesure que les situations évoluent. + +incident.io permet aux organisations modernes de répondre plus rapidement, de coordonner les équipes et de capturer les enseignements pour une amélioration continue. Que vous gériez des incidents SRE, DevOps, de sécurité ou informatiques, incident.io apporte une réponse aux incidents centralisée et de premier ordre par programmation à vos flux de travail d'agent. + +**Opérations clés disponibles** : +- `incidentio_incidents_list` : Listez, paginez et filtrez les incidents avec tous les détails. +- `incidentio_incidents_create` : Ouvrez programmatiquement de nouveaux incidents avec des attributs personnalisés et un contrôle de la duplication (idempotence). +- ...et plus à venir ! + +Améliorez votre fiabilité, votre responsabilité et votre excellence opérationnelle en intégrant incident.io à vos automatisations de flux de travail dès aujourd'hui. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez incident.io dans le flux de travail. Gérez les incidents, les actions, les suivis, les workflows, les plannings, les escalades, les champs personnalisés, et plus encore. + +## Outils + +### `incidentio_incidents_list` + +Liste les incidents depuis incident.io. Renvoie une liste d'incidents avec leurs détails, y compris la gravité, le statut et les horodatages. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `page_size` | nombre | Non | Nombre d'incidents à renvoyer par page \(par défaut : 25\) | +| `after` | chaîne | Non | Curseur de pagination pour récupérer la page suivante de résultats | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `incidents` | tableau | Liste des incidents | + +### `incidentio_incidents_create` + +Créer un nouvel incident dans incident.io. Nécessite idempotency_key, severity_id et visibility. Accepte optionnellement name, summary, type et status. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `idempotency_key` | chaîne | Oui | Identifiant unique pour éviter la création de doublons d'incidents. Utilisez un UUID ou une chaîne unique. | +| `name` | chaîne | Non | Nom de l'incident \(facultatif\) | +| `summary` | chaîne | Non | Bref résumé de l'incident | +| `severity_id` | chaîne | Oui | ID du niveau de gravité \(obligatoire\) | +| `incident_type_id` | chaîne | Non | ID du type d'incident | +| `incident_status_id` | chaîne | Non | ID du statut initial de l'incident | +| `visibility` | chaîne | Oui | Visibilité de l'incident : "public" ou "private" \(obligatoire\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `incident` | objet | L'objet incident créé | + +### `incidentio_incidents_show` + +Récupérer des informations détaillées sur un incident spécifique de incident.io par son ID. Renvoie les détails complets de l'incident, y compris les champs personnalisés et les attributions de rôles. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | ID de l'incident à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `incident` | objet | Informations détaillées sur l'incident | + +### `incidentio_incidents_update` + +Mettre à jour un incident existant dans incident.io. Peut mettre à jour le nom, le résumé, la gravité, le statut ou le type. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | ID de l'incident à mettre à jour | +| `name` | chaîne | Non | Nom mis à jour de l'incident | +| `summary` | chaîne | Non | Résumé mis à jour de l'incident | +| `severity_id` | chaîne | Non | ID de gravité mis à jour pour l'incident | +| `incident_status_id` | chaîne | Non | ID de statut mis à jour pour l'incident | +| `incident_type_id` | chaîne | Non | ID de type d'incident mis à jour | +| `notify_incident_channel` | booléen | Oui | Indique s'il faut notifier le canal d'incident de cette mise à jour | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `incident` | objet | L'objet incident mis à jour | + +### `incidentio_actions_list` + +Liste les actions depuis incident.io. Filtrage optionnel par ID d'incident. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `incident_id` | chaîne | Non | Filtrer les actions par ID d'incident | +| `page_size` | nombre | Non | Nombre d'actions à retourner par page | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `actions` | tableau | Liste des actions | + +### `incidentio_actions_show` + +Obtenir des informations détaillées sur une action spécifique depuis incident.io. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | ID de l'action | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `action` | objet | Détails de l'action | + +### `incidentio_follow_ups_list` + +Liste les suivis depuis incident.io. Filtrage optionnel par ID d'incident. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `incident_id` | chaîne | Non | Filtrer les suivis par ID d'incident | +| `page_size` | nombre | Non | Nombre de suivis à retourner par page | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `follow_ups` | array | Liste des suivis | + +### `incidentio_follow_ups_show` + +Obtenir des informations détaillées sur un suivi spécifique d'incident.io. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API incident.io | +| `id` | string | Oui | ID du suivi | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `follow_up` | object | Détails du suivi | + +### `incidentio_users_list` + +Liste tous les utilisateurs dans votre espace de travail Incident.io. Renvoie les détails de l'utilisateur, y compris l'identifiant, le nom, l'e-mail et le rôle. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Incident.io | +| `page_size` | number | Non | Nombre de résultats à renvoyer par page \(par défaut : 25\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `users` | array | Liste des utilisateurs dans l'espace de travail | + +### `incidentio_users_show` + +Obtenir des informations détaillées sur un utilisateur spécifique dans votre espace de travail Incident.io par son ID. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Incident.io | +| `id` | string | Oui | L'identifiant unique de l'utilisateur à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `user` | objet | Détails de l'utilisateur demandé | + +### `incidentio_workflows_list` + +Listez tous les workflows dans votre espace de travail incident.io. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `page_size` | nombre | Non | Nombre de workflows à retourner par page | +| `after` | chaîne | Non | Curseur de pagination pour récupérer la page suivante de résultats | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `workflows` | tableau | Liste des workflows | + +### `incidentio_workflows_show` + +Obtenez les détails d'un workflow spécifique dans incident.io. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | L'ID du workflow à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `workflow` | objet | Les détails du workflow | + +### `incidentio_workflows_update` + +Mettez à jour un workflow existant dans incident.io. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | L'ID du workflow à mettre à jour | +| `name` | chaîne | Non | Nouveau nom pour le workflow | +| `state` | chaîne | Non | Nouvel état pour le workflow \(actif, brouillon ou désactivé\) | +| `folder` | chaîne | Non | Nouveau dossier pour le workflow | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `workflow` | object | Le workflow mis à jour | + +### `incidentio_workflows_delete` + +Supprimer un workflow dans incident.io. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API incident.io | +| `id` | string | Oui | L'ID du workflow à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `message` | string | Message de succès | + +### `incidentio_schedules_list` + +Lister tous les plannings dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API incident.io | +| `page_size` | number | Non | Nombre de résultats par page \(par défaut : 25\) | +| `after` | string | Non | Curseur de pagination pour récupérer la page suivante de résultats | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `schedules` | array | Liste des plannings | + +### `incidentio_schedules_create` + +Créer un nouveau planning dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API incident.io | +| `name` | string | Oui | Nom du planning | +| `timezone` | string | Oui | Fuseau horaire pour le planning \(ex. : America/New_York\) | +| `config` | string | Oui | Configuration du planning au format JSON avec rotations. Exemple : \{"rotations": \[\{"name": "Primary", "users": \[\{"id": "user_id"\}\], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": \[\{"interval": 1, "interval_type": "weekly"\}\]\}\]\} | +| `Example` | string | Non | Pas de description | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `schedule` | objet | Le planning créé | + +### `incidentio_schedules_show` + +Obtenir les détails d'un planning spécifique dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | L'ID du planning | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `schedule` | objet | Les détails du planning | + +### `incidentio_schedules_update` + +Mettre à jour un planning existant dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | L'ID du planning à mettre à jour | +| `name` | chaîne | Non | Nouveau nom pour le planning | +| `timezone` | chaîne | Non | Nouveau fuseau horaire pour le planning \(ex., America/New_York\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `schedule` | objet | Le planning mis à jour | + +### `incidentio_schedules_delete` + +Supprimer un planning dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | L'ID du planning à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `message` | string | Message de succès | + +### `incidentio_escalations_list` + +Lister toutes les politiques d'escalade dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API incident.io | +| `page_size` | number | Non | Nombre de résultats par page \(par défaut : 25\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `escalations` | array | Liste des politiques d'escalade | + +### `incidentio_escalations_create` + +Créer une nouvelle politique d'escalade dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API incident.io | +| `idempotency_key` | string | Oui | Identifiant unique pour éviter la création de doublons d'escalade. Utilisez un UUID ou une chaîne unique. | +| `title` | string | Oui | Titre de l'escalade | +| `escalation_path_id` | string | Non | ID du chemin d'escalade à utiliser \(requis si user_ids n'est pas fourni\) | +| `user_ids` | string | Non | Liste d'IDs d'utilisateurs séparés par des virgules à notifier \(requis si escalation_path_id n'est pas fourni\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `escalation` | object | La politique d'escalade créée | + +### `incidentio_escalations_show` + +Obtenir les détails d'une politique d'escalade spécifique dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | L'ID de la politique d'escalade | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `escalation` | objet | Les détails de la politique d'escalade | + +### `incidentio_custom_fields_list` + +Liste tous les champs personnalisés d'incident.io. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `custom_fields` | tableau | Liste des champs personnalisés | + +### `incidentio_custom_fields_create` + +Créer un nouveau champ personnalisé dans incident.io. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `name` | chaîne | Oui | Nom du champ personnalisé | +| `description` | chaîne | Oui | Description du champ personnalisé \(obligatoire\) | +| `field_type` | chaîne | Oui | Type du champ personnalisé \(par ex., text, single_select, multi_select, numeric, datetime, link, user, team\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `custom_field` | objet | Champ personnalisé créé | + +### `incidentio_custom_fields_show` + +Obtenez des informations détaillées sur un champ personnalisé spécifique d'incident.io. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | ID du champ personnalisé | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `custom_field` | objet | Détails du champ personnalisé | + +### `incidentio_custom_fields_update` + +Mettre à jour un champ personnalisé existant dans incident.io. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | ID du champ personnalisé | +| `name` | chaîne | Oui | Nouveau nom pour le champ personnalisé \(obligatoire\) | +| `description` | chaîne | Oui | Nouvelle description pour le champ personnalisé \(obligatoire\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `custom_field` | objet | Champ personnalisé mis à jour | + +### `incidentio_custom_fields_delete` + +Supprimer un champ personnalisé d'incident.io. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | ID du champ personnalisé | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `message` | chaîne | Message de succès | + +### `incidentio_severities_list` + +Liste tous les niveaux de gravité configurés dans votre espace de travail Incident.io. Renvoie les détails de gravité, y compris l'identifiant, le nom, la description et le rang. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Incident.io | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `severities` | array | Liste des niveaux de gravité | + +### `incidentio_incident_statuses_list` + +Liste tous les statuts d'incident configurés dans votre espace de travail Incident.io. Renvoie les détails du statut, y compris l'identifiant, le nom, la description et la catégorie. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Incident.io | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `incident_statuses` | array | Liste des statuts d'incident | + +### `incidentio_incident_types_list` + +Liste tous les types d'incident configurés dans votre espace de travail Incident.io. Renvoie les détails du type, y compris l'identifiant, le nom, la description et l'indicateur par défaut. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Incident.io | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `incident_types` | array | Liste des types d'incident | + +### `incidentio_incident_roles_list` + +Liste tous les rôles d'incident dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API incident.io | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `incident_roles` | array | Liste des rôles d'incident | + +### `incidentio_incident_roles_create` + +Créer un nouveau rôle d'incident dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API incident.io | +| `name` | string | Oui | Nom du rôle d'incident | +| `description` | string | Oui | Description du rôle d'incident | +| `instructions` | string | Oui | Instructions pour le rôle d'incident | +| `shortform` | string | Oui | Abréviation courte pour le rôle | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `incident_role` | object | Le rôle d'incident créé | + +### `incidentio_incident_roles_show` + +Obtenir les détails d'un rôle d'incident spécifique dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API incident.io | +| `id` | string | Oui | L'ID du rôle d'incident | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `incident_role` | object | Les détails du rôle d'incident | + +### `incidentio_incident_roles_update` + +Mettre à jour un rôle d'incident existant dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API incident.io | +| `id` | string | Oui | L'ID du rôle d'incident à mettre à jour | +| `name` | string | Oui | Nom du rôle d'incident | +| `description` | string | Oui | Description du rôle d'incident | +| `instructions` | string | Oui | Instructions pour le rôle d'incident | +| `shortform` | string | Oui | Abréviation courte pour le rôle | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `incident_role` | objet | Le rôle d'incident mis à jour | + +### `incidentio_incident_roles_delete` + +Supprimer un rôle d'incident dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | L'ID du rôle d'incident à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `message` | chaîne | Message de succès | + +### `incidentio_incident_timestamps_list` + +Lister toutes les définitions d'horodatage d'incident dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `incident_timestamps` | tableau | Liste des définitions d'horodatage d'incident | + +### `incidentio_incident_timestamps_show` + +Obtenir les détails d'une définition d'horodatage d'incident spécifique dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | L'ID de l'horodatage d'incident | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `incident_timestamp` | objet | Les détails de l'horodatage d'incident | + +### `incidentio_incident_updates_list` + +Lister toutes les mises à jour pour un incident spécifique dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `incident_id` | chaîne | Non | L'ID de l'incident pour lequel obtenir les mises à jour \(facultatif - si non fourni, renvoie toutes les mises à jour\) | +| `page_size` | nombre | Non | Nombre de résultats à renvoyer par page | +| `after` | chaîne | Non | Curseur pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `incident_updates` | tableau | Liste des mises à jour d'incidents | + +### `incidentio_schedule_entries_list` + +Lister toutes les entrées pour un planning spécifique dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `schedule_id` | chaîne | Oui | L'ID du planning pour lequel obtenir les entrées | +| `entry_window_start` | chaîne | Non | Date/heure de début pour filtrer les entrées \(format ISO 8601\) | +| `entry_window_end` | chaîne | Non | Date/heure de fin pour filtrer les entrées \(format ISO 8601\) | +| `page_size` | nombre | Non | Nombre de résultats à renvoyer par page | +| `after` | chaîne | Non | Curseur pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `schedule_entries` | tableau | Liste des entrées du planning | + +### `incidentio_schedule_overrides_create` + +Créer une nouvelle dérogation de planning dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `rotation_id` | chaîne | Oui | L'ID de la rotation à remplacer | +| `schedule_id` | chaîne | Oui | L'ID du planning | +| `user_id` | chaîne | Non | L'ID de l'utilisateur à assigner \(fournir l'un des éléments suivants : user_id, user_email ou user_slack_id\) | +| `user_email` | chaîne | Non | L'email de l'utilisateur à assigner \(fournir l'un des éléments suivants : user_id, user_email ou user_slack_id\) | +| `user_slack_id` | chaîne | Non | L'ID Slack de l'utilisateur à assigner \(fournir l'un des éléments suivants : user_id, user_email ou user_slack_id\) | +| `start_at` | chaîne | Oui | Quand la dérogation commence \(format ISO 8601\) | +| `end_at` | chaîne | Oui | Quand la dérogation se termine \(format ISO 8601\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `override` | objet | La dérogation de planning créée | + +### `incidentio_escalation_paths_create` + +Créer un nouveau chemin d'escalade dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `name` | chaîne | Oui | Nom du chemin d'escalade | +| `path` | json | Oui | Tableau des niveaux d'escalade avec cibles et délai d'accusé de réception en secondes. Chaque niveau doit avoir : targets \(tableau de \{id, type, schedule_id?, user_id?, urgency\}\) et time_to_ack_seconds \(nombre\) | +| `working_hours` | json | Non | Configuration optionnelle des heures de travail. Tableau de \{weekday, start_time, end_time\} | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `escalation_path` | objet | Le chemin d'escalade créé | + +### `incidentio_escalation_paths_show` + +Obtenir les détails d'un chemin d'escalade spécifique dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | L'ID du chemin d'escalade | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `escalation_path` | objet | Les détails du chemin d'escalade | + +### `incidentio_escalation_paths_update` + +Mettre à jour un chemin d'escalade existant dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | L'ID du chemin d'escalade à mettre à jour | +| `name` | chaîne | Non | Nouveau nom pour le chemin d'escalade | +| `path` | json | Non | Nouvelle configuration du chemin d'escalade. Tableau des niveaux d'escalade avec cibles et time_to_ack_seconds | +| `working_hours` | json | Non | Nouvelle configuration des heures de travail. Tableau de \{weekday, start_time, end_time\} | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `escalation_path` | objet | Le chemin d'escalade mis à jour | + +### `incidentio_escalation_paths_delete` + +Supprimer un chemin d'escalade dans incident.io + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API incident.io | +| `id` | chaîne | Oui | L'ID du chemin d'escalade à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `message` | chaîne | Message de succès | + +## Notes + +- Catégorie : `tools` +- Type : `incidentio` diff --git a/apps/docs/content/docs/fr/tools/knowledge.mdx b/apps/docs/content/docs/fr/tools/knowledge.mdx index a03d26d2fc..44406ac68c 100644 --- a/apps/docs/content/docs/fr/tools/knowledge.mdx +++ b/apps/docs/content/docs/fr/tools/knowledge.mdx @@ -41,9 +41,13 @@ Rechercher du contenu similaire dans une base de connaissances en utilisant la s | Paramètre | Type | Obligatoire | Description | | --------- | ---- | ---------- | ----------- | | `knowledgeBaseId` | chaîne | Oui | ID de la base de connaissances dans laquelle effectuer la recherche | -| `query` | chaîne | Non | Texte de la requête de recherche \(facultatif lors de l'utilisation de filtres de tags\) | +| `query` | chaîne | Non | Texte de la requête de recherche \(facultatif lors de l'utilisation de filtres par tags\) | | `topK` | nombre | Non | Nombre de résultats les plus similaires à retourner \(1-100\) | | `tagFilters` | tableau | Non | Tableau de filtres de tags avec les propriétés tagName et tagValue | +| `items` | objet | Non | Pas de description | +| `properties` | chaîne | Non | Pas de description | +| `tagName` | chaîne | Non | Pas de description | +| `tagValue` | chaîne | Non | Pas de description | #### Sortie @@ -76,18 +80,23 @@ Créer un nouveau document dans une base de connaissances #### Entrée | Paramètre | Type | Obligatoire | Description | -| --------- | ---- | ----------- | ----------- | +| --------- | ---- | ---------- | ----------- | | `knowledgeBaseId` | chaîne | Oui | ID de la base de connaissances contenant le document | | `name` | chaîne | Oui | Nom du document | | `content` | chaîne | Oui | Contenu du document | -| `tag1` | chaîne | Non | Valeur de l'étiquette 1 pour le document | -| `tag2` | chaîne | Non | Valeur de l'étiquette 2 pour le document | -| `tag3` | chaîne | Non | Valeur de l'étiquette 3 pour le document | -| `tag4` | chaîne | Non | Valeur de l'étiquette 4 pour le document | -| `tag5` | chaîne | Non | Valeur de l'étiquette 5 pour le document | -| `tag6` | chaîne | Non | Valeur de l'étiquette 6 pour le document | -| `tag7` | chaîne | Non | Valeur de l'étiquette 7 pour le document | -| `documentTagsData` | tableau | Non | Données d'étiquettes structurées avec noms, types et valeurs | +| `tag1` | chaîne | Non | Valeur du tag 1 pour le document | +| `tag2` | chaîne | Non | Valeur du tag 2 pour le document | +| `tag3` | chaîne | Non | Valeur du tag 3 pour le document | +| `tag4` | chaîne | Non | Valeur du tag 4 pour le document | +| `tag5` | chaîne | Non | Valeur du tag 5 pour le document | +| `tag6` | chaîne | Non | Valeur du tag 6 pour le document | +| `tag7` | chaîne | Non | Valeur du tag 7 pour le document | +| `documentTagsData` | tableau | Non | Données de tags structurées avec noms, types et valeurs | +| `items` | objet | Non | Pas de description | +| `properties` | chaîne | Non | Pas de description | +| `tagName` | chaîne | Non | Pas de description | +| `tagValue` | chaîne | Non | Pas de description | +| `tagType` | chaîne | Non | Pas de description | #### Sortie diff --git a/apps/docs/content/docs/fr/tools/posthog.mdx b/apps/docs/content/docs/fr/tools/posthog.mdx new file mode 100644 index 0000000000..53f368c6fa --- /dev/null +++ b/apps/docs/content/docs/fr/tools/posthog.mdx @@ -0,0 +1,1112 @@ +--- +title: PostHog +description: Analyse de produit et gestion de fonctionnalités +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +L'outil [PostHog](https://posthog.com/) intègre des analyses de produit puissantes, la gestion des fonctionnalités, l'expérimentation et des insights sur le comportement des utilisateurs directement dans vos flux de travail agentiques. Conçu pour les équipes modernes, il vous permet de capturer, d'analyser et d'agir sur les données utilisateurs en temps réel — vous aidant à créer de meilleurs produits, comprendre l'engagement et augmenter les conversions. + +Avec l'outil PostHog, vous pouvez : + +- **Suivre et analyser les événements** : utilisez les opérations `posthog_capture_event` et `posthog_batch_events` pour enregistrer des actions individuelles ou multiples des utilisateurs, des vues de pages ou des événements personnalisés pour des analyses approfondies. +- **Explorer les données d'événements** : récupérez et listez les événements historiques ou en temps réel à l'aide de l'opération `posthog_list_events` pour une analyse avancée des événements. +- **Comprendre les utilisateurs** : tirez parti des opérations `posthog_list_persons`, `posthog_get_person` et `posthog_delete_person` pour gérer les profils utilisateurs, obtenir des insights détaillés sur les utilisateurs ou les supprimer si nécessaire. +- **Obtenir des insights exploitables sur les produits** : visualisez les parcours utilisateurs, l'utilisation des fonctionnalités et l'engagement via les opérations `posthog_list_insights`, `posthog_get_insight` et `posthog_create_insight`. +- **Gérer et déployer des fonctionnalités en toute sécurité** : activez des fonctionnalités et exécutez des tests A/B ou multivariés à grande échelle à l'aide d'opérations comme `posthog_list_feature_flags`, `posthog_get_feature_flag`, `posthog_create_feature_flag`, `posthog_update_feature_flag` et `posthog_delete_feature_flag`. +- **Segmenter et cibler des audiences** : créez, listez ou gérez des cohortes avec `posthog_list_cohorts`, `posthog_get_cohort` et `posthog_create_cohort`. +- **Recueillir des retours directs** : concevez, déployez et analysez des sondages grâce à `posthog_list_surveys`, `posthog_get_survey`, `posthog_create_survey` et `posthog_update_survey`. +- **Surveiller l'expérience utilisateur** : accédez et analysez les enregistrements de sessions via les opérations `posthog_list_session_recordings` et `posthog_get_session_recording`. +- **Collaborer avec votre équipe** : organisez des tableaux de bord (`posthog_list_dashboards`, `posthog_get_dashboard`), créez et annotez des insights et des événements, et gérez des projets et des organisations au sein de PostHog. + +Que vous souhaitiez mettre en œuvre des analyses de produits à grande échelle, améliorer l'intégration des utilisateurs, affiner votre feuille de route produit ou automatiser les décisions basées sur des données d'utilisation réelles, l'outil PostHog dote vos agents et flux de travail d'analyses avancées et d'expérimentations intégrées au produit — le tout sur une plateforme unifiée. + +Vous recherchez une véritable analyse de produit avec confidentialité, évolutivité et une option open-source ? PostHog est approuvé par des équipes agiles et des entreprises du monde entier. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez PostHog dans votre flux de travail. Suivez les événements, gérez les indicateurs de fonctionnalités, analysez le comportement des utilisateurs, menez des expériences, créez des sondages et accédez aux enregistrements de session. + +## Outils + +### `posthog_capture_event` + +Capturez un événement unique dans PostHog. Utilisez cette fonction pour suivre les actions des utilisateurs, les vues de pages ou des événements personnalisés. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectApiKey` | string | Oui | Clé API du projet PostHog \(jeton public pour l'ingestion d'événements\) | +| `region` | string | Non | Région PostHog : us \(par défaut\) ou eu | +| `event` | string | Oui | Le nom de l'événement à capturer \(par ex., "page_view", "button_clicked"\) | +| `distinctId` | string | Oui | Identifiant unique pour l'utilisateur ou l'appareil. Peut être l'ID utilisateur, l'ID de l'appareil ou un ID anonyme | +| `properties` | string | Non | Chaîne JSON des propriétés de l'événement \(par ex., \{"button_name": "signup", "page": "homepage"\}\) | +| `timestamp` | string | Non | Horodatage ISO 8601 indiquant quand l'événement s'est produit. Si non fourni, utilise l'heure actuelle | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `status` | string | Message d'état indiquant si l'événement a été capturé avec succès | + +### `posthog_batch_events` + +Capturez plusieurs événements à la fois dans PostHog. Utilisez cette fonction pour l'ingestion d'événements en masse afin d'améliorer les performances. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectApiKey` | chaîne | Oui | Clé API du projet PostHog \(jeton public pour l'ingestion d'événements\) | +| `region` | chaîne | Non | Région PostHog : us \(par défaut\) ou eu | +| `batch` | chaîne | Oui | Tableau JSON d'événements à capturer. Chaque événement doit avoir : event, distinct_id, et éventuellement properties, timestamp. Exemple : \[\{"event": "page_view", "distinct_id": "user123", "properties": \{"page": "/"\}\}\] | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `status` | chaîne | Message d'état indiquant si le lot a été capturé avec succès | +| `eventsProcessed` | nombre | Nombre d'événements traités dans le lot | + +### `posthog_list_events` + +Liste des événements dans PostHog. Remarque : ce point de terminaison est obsolète mais conservé pour la compatibilité ascendante. Pour une utilisation en production, préférez le point de terminaison Query avec HogQL. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | chaîne | Oui | Clé API personnelle PostHog \(pour l'accès API authentifié\) | +| `region` | chaîne | Non | Région PostHog : us \(par défaut\) ou eu | +| `projectId` | chaîne | Oui | ID du projet PostHog | +| `limit` | nombre | Non | Nombre d'événements à retourner \(par défaut : 100, max : 100\) | +| `offset` | nombre | Non | Nombre d'événements à ignorer pour la pagination | +| `event` | chaîne | Non | Filtrer par nom d'événement spécifique | +| `distinctId` | chaîne | Non | Filtrer par distinct_id spécifique | +| `before` | chaîne | Non | Horodatage ISO 8601 - ne renvoie que les événements antérieurs à cette date | +| `after` | chaîne | Non | Horodatage ISO 8601 - ne renvoie que les événements postérieurs à cette date | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `events` | array | Liste des événements avec leurs propriétés et métadonnées | + +### `posthog_list_persons` + +Liste des personnes (utilisateurs) dans PostHog. Renvoie les profils utilisateurs avec leurs propriétés et identifiants distincts. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Oui | Clé API personnelle PostHog \(pour l'accès API authentifié\) | +| `region` | string | Non | Région PostHog : us \(par défaut\) ou eu | +| `projectId` | string | Oui | ID du projet PostHog | +| `limit` | number | Non | Nombre de personnes à renvoyer \(par défaut : 100, max : 100\) | +| `offset` | number | Non | Nombre de personnes à ignorer pour la pagination | +| `search` | string | Non | Rechercher des personnes par email, nom ou ID distinct | +| `distinctId` | string | Non | Filtrer par distinct_id spécifique | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `persons` | array | Liste des personnes avec leurs propriétés et identifiants | + +### `posthog_get_person` + +Obtenir des informations détaillées sur une personne spécifique dans PostHog par son ID ou UUID. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Oui | Clé API personnelle PostHog \(pour l'accès API authentifié\) | +| `region` | string | Non | Région PostHog : us \(par défaut\) ou eu | +| `projectId` | string | Oui | ID du projet PostHog | +| `personId` | string | Oui | ID ou UUID de la personne à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `person` | object | Détails de la personne incluant les propriétés et les identifiants | + +### `posthog_delete_person` + +Supprimer une personne de PostHog. Cela supprimera tous les événements et données associés. À utiliser avec précaution. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Oui | Clé API personnelle PostHog \(pour l'accès API authentifié\) | +| `region` | string | Non | Région PostHog : us \(par défaut\) ou eu | +| `projectId` | string | Oui | ID du projet PostHog | +| `personId` | string | Oui | ID ou UUID de la personne à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `status` | string | Message d'état indiquant si la personne a été supprimée avec succès | + +### `posthog_query` + +Exécuter une requête HogQL dans PostHog. HogQL est PostHog + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | Oui | Clé API personnelle PostHog \(pour l'accès API authentifié\) | +| `region` | string | Non | Région PostHog : us \(par défaut\) ou eu | +| `projectId` | string | Oui | ID du projet PostHog | +| `query` | string | Oui | Requête HogQL à exécuter. Exemple : \{"kind": "HogQLQuery", "query": "SELECT event, count\(\) FROM events WHERE timestamp > now\(\) - INTERVAL 1 DAY GROUP BY event"\} | +| `Example` | string | Non | Pas de description | +| `values` | string | Non | Chaîne JSON optionnelle des valeurs de paramètres pour les requêtes paramétrées. Exemple : \{"user_id": "123"\} | +| `Example` | string | Non | Pas de description | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `results` | array | Résultats de la requête sous forme de tableau de lignes | + +### `posthog_list_insights` + +Liste tous les insights dans un projet PostHog. Renvoie les configurations, filtres et métadonnées des insights. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API personnelle PostHog | +| `projectId` | string | Oui | L'ID du projet PostHog | +| `region` | string | Non | Région cloud PostHog : "us" ou "eu" \(par défaut : "us"\) | +| `limit` | number | Non | Nombre de résultats à renvoyer par page \(par défaut : 100\) | +| `offset` | number | Non | Nombre de résultats à ignorer pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `count` | number | Nombre total d'insights dans le projet | +| `next` | string | URL pour la page suivante de résultats | +| `previous` | string | URL pour la page précédente de résultats | +| `results` | array | Liste des insights avec leurs configurations et métadonnées | + +### `posthog_get_insight` + +Obtenir un insight spécifique par ID depuis PostHog. Renvoie la configuration détaillée, les filtres et les métadonnées de l'insight. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API personnelle PostHog | +| `projectId` | string | Oui | L'ID du projet PostHog | +| `insightId` | string | Oui | L'ID de l'insight à récupérer | +| `region` | string | Non | Région cloud PostHog : "us" ou "eu" \(par défaut : "us"\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | number | Identifiant unique pour l'aperçu | +| `name` | string | Nom de l'aperçu | +| `description` | string | Description de l'aperçu | +| `filters` | object | Configuration du filtre pour l'aperçu | +| `query` | object | Configuration de la requête pour l'aperçu | +| `created_at` | string | Horodatage ISO de création de l'aperçu | +| `created_by` | object | Utilisateur ayant créé l'aperçu | +| `last_modified_at` | string | Horodatage ISO de la dernière modification de l'aperçu | +| `last_modified_by` | object | Utilisateur ayant effectué la dernière modification de l'aperçu | +| `saved` | boolean | Indique si l'aperçu est enregistré | +| `dashboards` | array | Identifiants des tableaux de bord où cet aperçu apparaît | +| `tags` | array | Tags associés à l'aperçu | +| `favorited` | boolean | Indique si l'aperçu est marqué comme favori | + +### `posthog_create_insight` + +Créer un nouvel aperçu dans PostHog. Nécessite un nom d'aperçu et des filtres de configuration ou une requête. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | string | Oui | Clé API personnelle PostHog | +| `projectId` | string | Oui | L'ID du projet PostHog | +| `region` | string | Non | Région cloud PostHog : "us" ou "eu" \(par défaut : "us"\) | +| `name` | string | Non | Nom de l'aperçu \(facultatif - PostHog générera un nom dérivé si non fourni\) | +| `description` | string | Non | Description de l'aperçu | +| `filters` | string | Non | Chaîne JSON de configuration du filtre pour l'aperçu | +| `query` | string | Non | Chaîne JSON de configuration de la requête pour l'aperçu | +| `dashboards` | string | Non | Liste d'identifiants de tableaux de bord séparés par des virgules pour y ajouter cet aperçu | +| `tags` | string | Non | Liste de tags séparés par des virgules pour l'aperçu | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | number | Identifiant unique pour l'insight créé | +| `name` | string | Nom de l'insight | +| `description` | string | Description de l'insight | +| `filters` | object | Configuration du filtre pour l'insight | +| `query` | object | Configuration de la requête pour l'insight | +| `created_at` | string | Horodatage ISO de création de l'insight | +| `created_by` | object | Utilisateur ayant créé l'insight | +| `last_modified_at` | string | Horodatage ISO de la dernière modification de l'insight | +| `saved` | boolean | Indique si l'insight est enregistré | +| `dashboards` | array | Identifiants des tableaux de bord où cet insight apparaît | +| `tags` | array | Tags associés à l'insight | + +### `posthog_list_dashboards` + +Liste tous les tableaux de bord dans un projet PostHog. Renvoie les configurations des tableaux de bord, les tuiles et les métadonnées. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | string | Oui | Clé API personnelle PostHog | +| `projectId` | string | Oui | L'ID du projet PostHog | +| `region` | string | Non | Région cloud PostHog : "us" ou "eu" \(par défaut : "us"\) | +| `limit` | number | Non | Nombre de résultats à renvoyer par page \(par défaut : 100\) | +| `offset` | number | Non | Nombre de résultats à ignorer pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `count` | number | Nombre total de tableaux de bord dans le projet | +| `next` | string | URL pour la page suivante de résultats | +| `previous` | string | URL pour la page précédente de résultats | +| `results` | array | Liste des tableaux de bord avec leurs configurations et métadonnées | + +### `posthog_get_dashboard` + +Obtenir un tableau de bord spécifique par ID depuis PostHog. Renvoie la configuration détaillée du tableau de bord, les tuiles et les métadonnées. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `projectId` | chaîne | Oui | L'ID du projet PostHog | +| `dashboardId` | chaîne | Oui | L'ID du tableau de bord à récupérer | +| `region` | chaîne | Non | Région cloud PostHog : "us" ou "eu" \(par défaut : "us"\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | nombre | Identifiant unique pour le tableau de bord | +| `name` | chaîne | Nom du tableau de bord | +| `description` | chaîne | Description du tableau de bord | +| `pinned` | booléen | Indique si le tableau de bord est épinglé | +| `created_at` | chaîne | Horodatage ISO de création du tableau de bord | +| `created_by` | objet | Utilisateur qui a créé le tableau de bord | +| `last_modified_at` | chaîne | Horodatage ISO de la dernière modification du tableau de bord | +| `last_modified_by` | objet | Utilisateur qui a modifié le tableau de bord en dernier | +| `tiles` | tableau | Tuiles/widgets sur le tableau de bord avec leurs configurations | +| `filters` | objet | Filtres globaux appliqués au tableau de bord | +| `tags` | tableau | Tags associés au tableau de bord | +| `restriction_level` | nombre | Niveau de restriction d'accès pour le tableau de bord | + +### `posthog_list_actions` + +Lister toutes les actions dans un projet PostHog. Renvoie les définitions d'actions, les étapes et les métadonnées. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `projectId` | chaîne | Oui | L'ID du projet PostHog | +| `region` | chaîne | Non | Région cloud PostHog : "us" ou "eu" \(par défaut : "us"\) | +| `limit` | nombre | Non | Nombre de résultats à renvoyer par page \(par défaut : 100\) | +| `offset` | nombre | Non | Nombre de résultats à ignorer pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `count` | nombre | Nombre total d'actions dans le projet | +| `next` | chaîne | URL pour la page suivante de résultats | +| `previous` | chaîne | URL pour la page précédente de résultats | +| `results` | tableau | Liste des actions avec leurs définitions et métadonnées | + +### `posthog_list_cohorts` + +Liste toutes les cohortes dans un projet PostHog. Renvoie les définitions de cohorte, les filtres et les décomptes d'utilisateurs. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `projectId` | chaîne | Oui | L'ID du projet PostHog | +| `region` | chaîne | Non | Région cloud PostHog : "us" ou "eu" \(par défaut : "us"\) | +| `limit` | nombre | Non | Nombre de résultats à renvoyer par page \(par défaut : 100\) | +| `offset` | nombre | Non | Nombre de résultats à ignorer pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `count` | number | Nombre total de cohortes dans le projet | +| `next` | string | URL pour la page suivante de résultats | +| `previous` | string | URL pour la page précédente de résultats | +| `results` | array | Liste des cohortes avec leurs définitions et métadonnées | + +### `posthog_get_cohort` + +Obtenir une cohorte spécifique par ID depuis PostHog. Renvoie la définition détaillée de la cohorte, les filtres et le nombre d'utilisateurs. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | string | Oui | Clé API personnelle PostHog | +| `projectId` | string | Oui | L'ID du projet PostHog | +| `cohortId` | string | Oui | L'ID de la cohorte à récupérer | +| `region` | string | Non | Région cloud PostHog : "us" ou "eu" \(par défaut : "us"\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | number | Identifiant unique pour la cohorte | +| `name` | string | Nom de la cohorte | +| `description` | string | Description de la cohorte | +| `groups` | array | Groupes qui définissent la cohorte | +| `deleted` | boolean | Si la cohorte est supprimée | +| `filters` | object | Configuration des filtres pour la cohorte | +| `query` | object | Configuration des requêtes pour la cohorte | +| `created_at` | string | Horodatage ISO de création de la cohorte | +| `created_by` | object | Utilisateur qui a créé la cohorte | +| `is_calculating` | boolean | Si la cohorte est en cours de calcul | +| `last_calculation` | string | Horodatage ISO du dernier calcul | +| `errors_calculating` | number | Nombre d'erreurs pendant le calcul | +| `count` | number | Nombre d'utilisateurs dans la cohorte | +| `is_static` | boolean | Si la cohorte est statique | +| `version` | number | Numéro de version de la cohorte | + +### `posthog_create_cohort` + +Créer une nouvelle cohorte dans PostHog. Nécessite un nom de cohorte et une configuration de filtre ou de requête. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `projectId` | chaîne | Oui | L'ID du projet PostHog | +| `region` | chaîne | Non | Région cloud PostHog : "us" ou "eu" \(par défaut : "us"\) | +| `name` | chaîne | Non | Nom de la cohorte \(facultatif - PostHog utilisera "Untitled cohort" si non fourni\) | +| `description` | chaîne | Non | Description de la cohorte | +| `filters` | chaîne | Non | Chaîne JSON de la configuration du filtre pour la cohorte | +| `query` | chaîne | Non | Chaîne JSON de la configuration de requête pour la cohorte | +| `is_static` | booléen | Non | Si la cohorte est statique \(par défaut : false\) | +| `groups` | chaîne | Non | Chaîne JSON des groupes qui définissent la cohorte | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | nombre | Identifiant unique pour la cohorte créée | +| `name` | chaîne | Nom de la cohorte | +| `description` | chaîne | Description de la cohorte | +| `groups` | tableau | Groupes qui définissent la cohorte | +| `deleted` | booléen | Si la cohorte est supprimée | +| `filters` | objet | Configuration du filtre pour la cohorte | +| `query` | objet | Configuration de requête pour la cohorte | +| `created_at` | chaîne | Horodatage ISO de création de la cohorte | +| `created_by` | objet | Utilisateur qui a créé la cohorte | +| `is_calculating` | booléen | Si la cohorte est en cours de calcul | +| `count` | nombre | Nombre d'utilisateurs dans la cohorte | +| `is_static` | booléen | Si la cohorte est statique | +| `version` | nombre | Numéro de version de la cohorte | + +### `posthog_list_annotations` + +Liste toutes les annotations dans un projet PostHog. Renvoie le contenu des annotations, les horodatages et les insights associés. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `projectId` | chaîne | Oui | L'ID du projet PostHog | +| `region` | chaîne | Non | Région cloud PostHog : "us" ou "eu" \(par défaut : "us"\) | +| `limit` | nombre | Non | Nombre de résultats à renvoyer par page \(par défaut : 100\) | +| `offset` | nombre | Non | Nombre de résultats à ignorer pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `count` | nombre | Nombre total d'annotations dans le projet | +| `next` | chaîne | URL pour la page suivante de résultats | +| `previous` | chaîne | URL pour la page précédente de résultats | +| `results` | tableau | Liste des annotations avec leur contenu et métadonnées | + +### `posthog_create_annotation` + +Créer une nouvelle annotation dans PostHog. Marquez des événements importants sur vos graphiques avec date et description. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `projectId` | chaîne | Oui | L'ID du projet PostHog | +| `region` | chaîne | Non | Région cloud PostHog : "us" ou "eu" \(par défaut : "us"\) | +| `content` | chaîne | Oui | Contenu/texte de l'annotation | +| `date_marker` | chaîne | Oui | Horodatage ISO indiquant quand l'annotation s'applique \(ex. : "2024-01-15T10:00:00Z"\) | +| `scope` | chaîne | Non | Portée de l'annotation : "project" ou "dashboard_item" \(par défaut : "project"\) | +| `dashboard_item` | chaîne | Non | ID de l'élément du tableau de bord auquel attacher cette annotation | +| `insight_short_id` | chaîne | Non | ID court de l'insight auquel attacher cette annotation | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | number | Identifiant unique pour l'annotation créée | +| `content` | string | Contenu/texte de l'annotation | +| `date_marker` | string | Horodatage ISO indiquant quand l'annotation s'applique | +| `created_at` | string | Horodatage ISO de la création de l'annotation | +| `updated_at` | string | Horodatage ISO de la dernière mise à jour de l'annotation | +| `created_by` | object | Utilisateur qui a créé l'annotation | +| `dashboard_item` | number | ID de l'élément du tableau de bord auquel cette annotation est attachée | +| `insight_short_id` | string | ID court de l'aperçu auquel cette annotation est attachée | +| `insight_name` | string | Nom de l'aperçu auquel cette annotation est attachée | +| `scope` | string | Portée de l'annotation \(projet ou élément du tableau de bord\) | +| `deleted` | boolean | Indique si l'annotation est supprimée | + +### `posthog_list_feature_flags` + +Lister tous les indicateurs de fonctionnalité dans un projet PostHog + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `projectId` | string | Oui | L'ID du projet PostHog | +| `region` | string | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | string | Oui | Clé API personnelle PostHog | +| `limit` | number | Non | Nombre de résultats à retourner | +| `offset` | number | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `results` | array | Liste des indicateurs de fonctionnalité | + +### `posthog_get_feature_flag` + +Obtenir les détails d'un indicateur de fonctionnalité spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | L'ID du projet PostHog | +| `flagId` | string | Oui | L'ID de l'indicateur de fonctionnalité | +| `region` | string | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | string | Oui | Clé API personnelle PostHog | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `flag` | object | Détails de l'indicateur de fonctionnalité | + +### `posthog_create_feature_flag` + +Créer un nouvel indicateur de fonctionnalité dans PostHog + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | L'ID du projet PostHog | +| `region` | string | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | string | Oui | Clé API personnelle PostHog | +| `name` | string | Non | Nom de l'indicateur de fonctionnalité \(facultatif - peut être vide\) | +| `key` | string | Oui | Clé de l'indicateur de fonctionnalité \(identifiant unique\) | +| `filters` | string | Non | Filtres de l'indicateur de fonctionnalité sous forme de chaîne JSON | +| `active` | boolean | Non | Si l'indicateur est actif \(par défaut : true\) | +| `ensureExperienceContinuity` | boolean | Non | Si la continuité de l'expérience doit être assurée \(par défaut : false\) | +| `rolloutPercentage` | number | Non | Pourcentage de déploiement \(0-100\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `flag` | objet | Feature flag créé | + +### `posthog_update_feature_flag` + +Mettre à jour un feature flag existant dans PostHog + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | chaîne | Oui | L'ID du projet PostHog | +| `flagId` | chaîne | Oui | L'ID du feature flag | +| `region` | chaîne | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `name` | chaîne | Non | Nom du feature flag | +| `key` | chaîne | Non | Clé du feature flag \(identifiant unique\) | +| `filters` | chaîne | Non | Filtres du feature flag au format JSON | +| `active` | booléen | Non | Si le flag est actif | +| `ensureExperienceContinuity` | booléen | Non | Si la continuité de l'expérience doit être assurée | +| `rolloutPercentage` | nombre | Non | Pourcentage de déploiement \(0-100\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `flag` | objet | Feature flag mis à jour | + +### `posthog_delete_feature_flag` + +Supprimer un feature flag de PostHog + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | chaîne | Oui | L'ID du projet PostHog | +| `flagId` | chaîne | Oui | L'ID du feature flag à supprimer | +| `region` | chaîne | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Indique si la suppression a réussi | +| `message` | string | Message de confirmation | + +### `posthog_evaluate_flags` + +Évalue les indicateurs de fonctionnalités pour un utilisateur ou un groupe spécifique. Il s'agit d'un point de terminaison public qui utilise la clé API du projet. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `region` | string | Oui | Région cloud PostHog : us ou eu | +| `projectApiKey` | string | Oui | Clé API du projet PostHog (pas la clé API personnelle) | +| `distinctId` | string | Oui | L'identifiant distinct de l'utilisateur pour lequel évaluer les indicateurs | +| `groups` | string | Non | Groupes sous forme de chaîne JSON (par exemple, \{"company": "company_id_in_your_db"\}) | +| `personProperties` | string | Non | Propriétés de la personne sous forme de chaîne JSON | +| `groupProperties` | string | Non | Propriétés du groupe sous forme de chaîne JSON | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `featureFlags` | object | Évaluations des indicateurs de fonctionnalités (paires clé-valeur où les valeurs sont des booléens ou des variantes de chaînes) | +| `featureFlagPayloads` | object | Charges utiles supplémentaires attachées aux indicateurs de fonctionnalités | +| `errorsWhileComputingFlags` | boolean | Indique s'il y a eu des erreurs lors du calcul des indicateurs | + +### `posthog_list_experiments` + +Liste toutes les expériences dans un projet PostHog + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | L'ID du projet PostHog | +| `region` | string | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | string | Oui | Clé API personnelle PostHog | +| `limit` | number | Non | Nombre de résultats à retourner | +| `offset` | number | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `results` | array | Liste des expériences | + +### `posthog_get_experiment` + +Obtenir les détails d'une expérience spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | L'ID du projet PostHog | +| `experimentId` | string | Oui | L'ID de l'expérience | +| `region` | string | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | string | Oui | Clé API personnelle PostHog | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `experiment` | object | Détails de l'expérience | + +### `posthog_create_experiment` + +Créer une nouvelle expérience dans PostHog + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | L'ID du projet PostHog | +| `region` | string | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | string | Oui | Clé API personnelle PostHog | +| `name` | string | Non | Nom de l'expérience \(facultatif\) | +| `description` | string | Non | Description de l'expérience | +| `featureFlagKey` | string | Oui | Clé du feature flag à utiliser pour l'expérience | +| `parameters` | string | Non | Paramètres de l'expérience sous forme de chaîne JSON | +| `filters` | string | Non | Filtres de l'expérience sous forme de chaîne JSON | +| `variants` | string | Non | Variantes de l'expérience sous forme de chaîne JSON | +| `startDate` | string | Non | Date de début de l'expérience \(format ISO\) | +| `endDate` | string | Non | Date de fin de l'expérience \(format ISO\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `experiment` | objet | Expérience créée | + +### `posthog_list_surveys` + +Liste tous les sondages dans un projet PostHog. Les sondages vous permettent de recueillir des commentaires des utilisateurs. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `projectId` | chaîne | Oui | ID du projet PostHog | +| `region` | chaîne | Non | Région cloud PostHog : us ou eu \(par défaut : us\) | +| `limit` | nombre | Non | Nombre de résultats à retourner \(par défaut : 100\) | +| `offset` | nombre | Non | Nombre de résultats à ignorer pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `surveys` | tableau | Liste des sondages dans le projet | + +### `posthog_get_survey` + +Obtenir les détails d'un sondage spécifique dans PostHog par ID. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `projectId` | chaîne | Oui | ID du projet PostHog | +| `surveyId` | chaîne | Oui | ID du sondage à récupérer | +| `region` | chaîne | Non | Région cloud PostHog : us ou eu \(par défaut : us\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `survey` | objet | Détails du sondage | + +### `posthog_create_survey` + +Créez un nouveau sondage dans PostHog. Prend en charge les types de questions : basique (ouvert), lien, évaluation et choix multiple. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `projectId` | chaîne | Oui | ID de projet PostHog | +| `region` | chaîne | Non | Région cloud PostHog : us ou eu \(par défaut : us\) | +| `name` | chaîne | Non | Nom du sondage \(facultatif\) | +| `description` | chaîne | Non | Description du sondage | +| `type` | chaîne | Non | Type de sondage : popover \(in-app\) ou api \(implémentation personnalisée\) \(par défaut : popover\) | +| `questions` | chaîne | Oui | Chaîne JSON du tableau de questions du sondage. Chaque question doit avoir un type \(open/link/rating/multiple_choice\) et un texte de question. Les questions d'évaluation peuvent avoir une échelle \(1-10\), lowerBoundLabel, upperBoundLabel. Les questions à choix multiples nécessitent un tableau de choix. Les questions de lien peuvent avoir buttonText. | +| `startDate` | chaîne | Non | Date de début du sondage au format ISO 8601 | +| `endDate` | chaîne | Non | Date de fin du sondage au format ISO 8601 | +| `appearance` | chaîne | Non | Chaîne JSON de configuration d'apparence \(couleurs, position, etc.\) | +| `conditions` | chaîne | Non | Chaîne JSON des conditions d'affichage \(correspondance d'URL, etc.\) | +| `targetingFlagFilters` | chaîne | Non | Chaîne JSON des filtres de feature flag pour le ciblage | +| `linkedFlagId` | chaîne | Non | ID de feature flag à lier à ce sondage | +| `responsesLimit` | nombre | Non | Nombre maximum de réponses à collecter | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `survey` | objet | Détails du sondage créé | + +### `posthog_update_survey` + +Mettre à jour un sondage existant dans PostHog. Permet de modifier les questions, l'apparence, les conditions et d'autres paramètres. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `projectId` | chaîne | Oui | ID du projet PostHog | +| `surveyId` | chaîne | Oui | ID du sondage à mettre à jour | +| `region` | chaîne | Non | Région cloud PostHog : us ou eu \(par défaut : us\) | +| `name` | chaîne | Non | Nom du sondage | +| `description` | chaîne | Non | Description du sondage | +| `type` | chaîne | Non | Type de sondage : popover ou api | +| `questions` | chaîne | Non | Chaîne JSON du tableau des questions du sondage. Chaque question doit avoir un type \(open/link/rating/multiple_choice\) et un texte de question. | +| `startDate` | chaîne | Non | Date de début du sondage au format ISO 8601 | +| `endDate` | chaîne | Non | Date de fin du sondage au format ISO 8601 | +| `appearance` | chaîne | Non | Chaîne JSON de configuration d'apparence \(couleurs, position, etc.\) | +| `conditions` | chaîne | Non | Chaîne JSON des conditions d'affichage \(correspondance d'URL, etc.\) | +| `targetingFlagFilters` | chaîne | Non | Chaîne JSON des filtres de feature flag pour le ciblage | +| `linkedFlagId` | chaîne | Non | ID du feature flag à lier à ce sondage | +| `responsesLimit` | nombre | Non | Nombre maximum de réponses à collecter | +| `archived` | booléen | Non | Archiver ou désarchiver le sondage | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `survey` | objet | Détails du sondage mis à jour | + +### `posthog_list_session_recordings` + +Liste des enregistrements de session dans un projet PostHog. Les enregistrements de session capturent les interactions des utilisateurs avec votre application. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `projectId` | chaîne | Oui | ID du projet PostHog | +| `region` | chaîne | Non | Région cloud PostHog : us ou eu \(par défaut : us\) | +| `limit` | nombre | Non | Nombre de résultats à retourner \(par défaut : 50\) | +| `offset` | nombre | Non | Nombre de résultats à ignorer pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `recordings` | tableau | Liste des enregistrements de session | + +### `posthog_get_session_recording` + +Obtenir les détails d'un enregistrement de session spécifique dans PostHog par ID. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `projectId` | chaîne | Oui | ID du projet PostHog | +| `recordingId` | chaîne | Oui | ID de l'enregistrement de session à récupérer | +| `region` | chaîne | Non | Région cloud PostHog : us ou eu \(par défaut : us\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `recording` | objet | Détails de l'enregistrement de session | + +### `posthog_list_recording_playlists` + +Lister les playlists d'enregistrements de session dans un projet PostHog. Les playlists vous permettent d'organiser et de gérer les enregistrements de session. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `projectId` | chaîne | Oui | ID du projet PostHog | +| `region` | chaîne | Non | Région cloud PostHog : us ou eu \(par défaut : us\) | +| `limit` | nombre | Non | Nombre de résultats à retourner \(par défaut : 100\) | +| `offset` | nombre | Non | Nombre de résultats à ignorer pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `playlists` | tableau | Liste des playlists d'enregistrements de session | + +### `posthog_list_event_definitions` + +Lister toutes les définitions d'événements dans un projet PostHog. Les définitions d'événements représentent les événements suivis avec des métadonnées comme les descriptions, les tags et les statistiques d'utilisation. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `projectId` | chaîne | Oui | ID du projet PostHog | +| `region` | chaîne | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `limit` | nombre | Non | Nombre de résultats à retourner par page \(par défaut : 100\) | +| `offset` | nombre | Non | L'index initial à partir duquel retourner les résultats | +| `search` | chaîne | Non | Terme de recherche pour filtrer les définitions d'événements par nom | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `count` | number | Nombre total de définitions d'événements | +| `next` | string | URL pour la page suivante de résultats | +| `previous` | string | URL pour la page précédente de résultats | +| `results` | array | Liste des définitions d'événements | + +### `posthog_get_event_definition` + +Obtenir les détails d'une définition d'événement spécifique dans PostHog. Renvoie des informations complètes sur l'événement, y compris les métadonnées, les statistiques d'utilisation et le statut de vérification. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `projectId` | string | Oui | ID du projet PostHog | +| `eventDefinitionId` | string | Oui | ID de la définition d'événement à récupérer | +| `region` | string | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | string | Oui | Clé API personnelle PostHog | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | string | Identifiant unique pour la définition d'événement | +| `name` | string | Nom de l'événement | +| `description` | string | Description de l'événement | +| `tags` | array | Tags associés à l'événement | +| `volume_30_day` | number | Nombre d'événements reçus au cours des 30 derniers jours | +| `query_usage_30_day` | number | Nombre de fois où cet événement a été interrogé au cours des 30 derniers jours | +| `created_at` | string | Horodatage ISO de création de l'événement | +| `last_seen_at` | string | Horodatage ISO de dernière observation de l'événement | +| `updated_at` | string | Horodatage ISO de mise à jour de l'événement | +| `updated_by` | object | Utilisateur ayant dernièrement mis à jour l'événement | +| `verified` | boolean | Indique si l'événement a été vérifié | +| `verified_at` | string | Horodatage ISO de vérification de l'événement | +| `verified_by` | string | Utilisateur ayant vérifié l'événement | + +### `posthog_update_event_definition` + +Mettre à jour une définition d'événement dans PostHog. Permet de modifier la description, les tags et le statut de vérification pour maintenir des schémas d'événements propres. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `projectId` | chaîne | Oui | ID du projet PostHog | +| `eventDefinitionId` | chaîne | Oui | ID de la définition d'événement à mettre à jour | +| `region` | chaîne | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `description` | chaîne | Non | Description mise à jour pour l'événement | +| `tags` | chaîne | Non | Liste de tags séparés par des virgules à associer à l'événement | +| `verified` | booléen | Non | Indique si l'événement doit être marqué comme vérifié | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | chaîne | Identifiant unique pour la définition d'événement | +| `name` | chaîne | Nom de l'événement | +| `description` | chaîne | Description mise à jour de l'événement | +| `tags` | tableau | Tags mis à jour associés à l'événement | +| `volume_30_day` | nombre | Nombre d'événements reçus au cours des 30 derniers jours | +| `query_usage_30_day` | nombre | Nombre de fois où cet événement a été interrogé au cours des 30 derniers jours | +| `created_at` | chaîne | Horodatage ISO de création de l'événement | +| `last_seen_at` | chaîne | Horodatage ISO de la dernière observation de l'événement | +| `updated_at` | chaîne | Horodatage ISO de la mise à jour de l'événement | +| `updated_by` | objet | Utilisateur ayant effectué la dernière mise à jour de l'événement | +| `verified` | booléen | Indique si l'événement a été vérifié | +| `verified_at` | chaîne | Horodatage ISO de vérification de l'événement | +| `verified_by` | chaîne | Utilisateur ayant vérifié l'événement | + +### `posthog_list_property_definitions` + +Liste toutes les définitions de propriétés dans un projet PostHog. Les définitions de propriétés représentent les propriétés suivies avec des métadonnées comme les descriptions, les tags, les types et les statistiques d'utilisation. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | ID du projet PostHog | +| `region` | string | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | string | Oui | Clé API personnelle PostHog | +| `limit` | number | Non | Nombre de résultats à renvoyer par page \(par défaut : 100\) | +| `offset` | number | Non | L'index initial à partir duquel renvoyer les résultats | +| `search` | string | Non | Terme de recherche pour filtrer les définitions de propriétés par nom | +| `type` | string | Non | Filtrer par type de propriété : event, person ou group | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `count` | number | Nombre total de définitions de propriétés | +| `next` | string | URL pour la page suivante de résultats | +| `previous` | string | URL pour la page précédente de résultats | +| `results` | array | Liste des définitions de propriétés | + +### `posthog_get_property_definition` + +Obtenir les détails d'une définition de propriété spécifique dans PostHog. Renvoie des informations complètes sur la propriété, y compris les métadonnées, le type, les statistiques d'utilisation et le statut de vérification. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | Oui | ID du projet PostHog | +| `propertyDefinitionId` | string | Oui | ID de la définition de propriété à récupérer | +| `region` | string | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | string | Oui | Clé API personnelle PostHog | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | string | Identifiant unique pour la définition de propriété | +| `name` | string | Nom de la propriété | +| `description` | string | Description de la propriété | +| `tags` | array | Tags associés à la propriété | +| `is_numerical` | boolean | Si la propriété est numérique | +| `is_seen_on_filtered_events` | boolean | Si la propriété est visible sur les événements filtrés | +| `property_type` | string | Le type de données de la propriété | +| `type` | string | Type de propriété : événement, personne ou groupe | +| `volume_30_day` | number | Nombre de fois où la propriété a été vue au cours des 30 derniers jours | +| `query_usage_30_day` | number | Nombre de fois où cette propriété a été interrogée au cours des 30 derniers jours | +| `created_at` | string | Horodatage ISO de création de la propriété | +| `updated_at` | string | Horodatage ISO de mise à jour de la propriété | +| `updated_by` | object | Utilisateur ayant effectué la dernière mise à jour de la propriété | +| `verified` | boolean | Si la propriété a été vérifiée | +| `verified_at` | string | Horodatage ISO de vérification de la propriété | +| `verified_by` | string | Utilisateur ayant vérifié la propriété | +| `example` | string | Exemple de valeur pour la propriété | + +### `posthog_update_property_definition` + +Mettre à jour une définition de propriété dans PostHog. Permet de modifier la description, les tags, le type de propriété et le statut de vérification pour maintenir des schémas de propriétés propres. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `projectId` | string | Oui | ID du projet PostHog | +| `propertyDefinitionId` | string | Oui | ID de définition de propriété à mettre à jour | +| `region` | string | Oui | Région cloud PostHog : us ou eu | +| `apiKey` | string | Oui | Clé API personnelle PostHog | +| `description` | string | Non | Description mise à jour pour la propriété | +| `tags` | string | Non | Liste de tags séparés par des virgules à associer à la propriété | +| `verified` | boolean | Non | Si la propriété doit être marquée comme vérifiée | +| `property_type` | string | Non | Le type de données de la propriété \(par ex., String, Numeric, Boolean, DateTime, etc.\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `id` | string | Identifiant unique pour la définition de propriété | +| `name` | string | Nom de la propriété | +| `description` | string | Description mise à jour de la propriété | +| `tags` | array | Tags mis à jour associés à la propriété | +| `is_numerical` | boolean | Indique si la propriété est numérique | +| `is_seen_on_filtered_events` | boolean | Indique si la propriété est visible sur les événements filtrés | +| `property_type` | string | Le type de données de la propriété | +| `type` | string | Type de propriété : événement, personne ou groupe | +| `volume_30_day` | number | Nombre de fois où la propriété a été vue au cours des 30 derniers jours | +| `query_usage_30_day` | number | Nombre de fois où cette propriété a été interrogée au cours des 30 derniers jours | +| `created_at` | string | Horodatage ISO de création de la propriété | +| `updated_at` | string | Horodatage ISO de mise à jour de la propriété | +| `updated_by` | object | Utilisateur ayant effectué la dernière mise à jour de la propriété | +| `verified` | boolean | Indique si la propriété a été vérifiée | +| `verified_at` | string | Horodatage ISO de vérification de la propriété | +| `verified_by` | string | Utilisateur ayant vérifié la propriété | +| `example` | string | Exemple de valeur pour la propriété | + +### `posthog_list_projects` + +Liste tous les projets dans l'organisation. Renvoie les détails du projet, y compris les identifiants, les noms, les jetons API et les paramètres. Utile pour obtenir les identifiants de projet nécessaires pour d'autres points de terminaison. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `region` | chaîne | Non | Région cloud : us ou eu \(par défaut : us\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `projects` | tableau | Liste des projets avec leur configuration et leurs paramètres | + +### `posthog_get_project` + +Obtenir des informations détaillées sur un projet spécifique par ID. Renvoie la configuration complète du projet, les paramètres et les feature flags. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `projectId` | chaîne | Oui | ID du projet \(ID numérique ou UUID\) | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `region` | chaîne | Non | Région cloud : us ou eu \(par défaut : us\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `project` | objet | Informations détaillées sur le projet avec tous les paramètres de configuration | + +### `posthog_list_organizations` + +Liste toutes les organisations auxquelles l'utilisateur a accès. Renvoie les détails de l'organisation, y compris le nom, le slug, le niveau d'adhésion et les fonctionnalités disponibles. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API personnelle PostHog | +| `region` | chaîne | Non | Région cloud : us ou eu \(par défaut : us\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `organizations` | array | Liste des organisations avec leurs paramètres et fonctionnalités | + +### `posthog_get_organization` + +Obtenez des informations détaillées sur une organisation spécifique par ID. Renvoie des informations complètes sur les paramètres, les fonctionnalités, l'utilisation et l'équipe de l'organisation. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `organizationId` | string | Oui | ID de l'organisation \(UUID\) | +| `apiKey` | string | Oui | Clé API personnelle PostHog | +| `region` | string | Non | Région cloud : us ou eu \(par défaut : us\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `organization` | object | Informations détaillées sur l'organisation avec paramètres et fonctionnalités | + +## Notes + +- Catégorie : `tools` +- Type : `posthog` diff --git a/apps/docs/content/docs/fr/tools/sentry.mdx b/apps/docs/content/docs/fr/tools/sentry.mdx new file mode 100644 index 0000000000..47730c618a --- /dev/null +++ b/apps/docs/content/docs/fr/tools/sentry.mdx @@ -0,0 +1,305 @@ +--- +title: Sentry +description: Gérez les problèmes, projets, événements et versions de Sentry +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +Optimisez votre surveillance des erreurs et la fiabilité de vos applications avec [Sentry](https://sentry.io/) — la plateforme leader du secteur pour le suivi des erreurs en temps réel, la surveillance des performances et la gestion des versions. Intégrez Sentry de manière transparente dans vos flux de travail d'agents automatisés pour surveiller facilement les problèmes, suivre les événements critiques, gérer les projets et orchestrer les versions à travers toutes vos applications et services. + +Avec l'outil Sentry, vous pouvez : + +- **Surveiller et trier les problèmes** : récupérez des listes complètes de problèmes à l'aide de l'opération `sentry_issues_list` et obtenez des informations détaillées sur les erreurs et bugs individuels via `sentry_issues_get`. Accédez instantanément aux métadonnées, tags, traces d'appel et statistiques pour réduire le temps moyen de résolution. +- **Suivre les données d'événements** : analysez des instances d'erreurs et d'événements spécifiques avec `sentry_events_list` et `sentry_events_get`, offrant un aperçu approfondi des occurrences d'erreurs et de leur impact sur les utilisateurs. +- **Gérer les projets et les équipes** : utilisez `sentry_projects_list` et `sentry_project_get` pour énumérer et examiner tous vos projets Sentry, assurant une collaboration fluide entre les équipes et une configuration centralisée. +- **Coordonner les versions** : automatisez le suivi des versions, la santé des déploiements et la gestion des changements dans votre code avec des opérations comme `sentry_releases_list`, `sentry_release_get`, et plus encore. +- **Obtenir des insights puissants sur vos applications** : utilisez des filtres et requêtes avancés pour trouver des problèmes non résolus ou de haute priorité, agréger des statistiques d'événements au fil du temps et suivre les régressions à mesure que votre code évolue. + +L'intégration de Sentry permet aux équipes d'ingénierie et de DevOps de détecter les problèmes tôt, de prioriser les bugs les plus impactants et d'améliorer continuellement la santé des applications à travers les différentes piles de développement. Orchestrez de manière programmatique l'automatisation des flux de travail pour une observabilité moderne, une réponse aux incidents et une gestion du cycle de vie des versions, réduisant ainsi les temps d'arrêt et augmentant la satisfaction des utilisateurs. + +**Opérations Sentry clés disponibles** : +- `sentry_issues_list` : Liste des problèmes Sentry pour les organisations et les projets, avec des fonctionnalités puissantes de recherche et de filtrage. +- `sentry_issues_get` : Récupère des informations détaillées pour un problème Sentry spécifique. +- `sentry_events_list` : Énumère les événements pour un problème particulier pour l'analyse des causes profondes. +- `sentry_events_get` : Obtient tous les détails sur un événement individuel, y compris les traces d'appel, le contexte et les métadonnées. +- `sentry_projects_list` : Liste tous les projets Sentry au sein de votre organisation. +- `sentry_project_get` : Récupère la configuration et les détails d'un projet spécifique. +- `sentry_releases_list` : Liste les versions récentes et leur statut de déploiement. +- `sentry_release_get` : Récupère des informations détaillées sur les versions, y compris les commits et les problèmes associés. + +Que vous gériez de manière proactive la santé de votre application, que vous résoudiez des erreurs en production ou que vous automatisiez les flux de travail de publication, Sentry vous équipe d'une surveillance de classe mondiale, d'alertes exploitables et d'une intégration DevOps transparente. Améliorez la qualité de votre logiciel et la visibilité dans les recherches en utilisant Sentry pour le suivi des erreurs, l'observabilité et la gestion des versions, le tout depuis vos flux de travail agentiques. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez Sentry dans le flux de travail. Surveillez les problèmes, gérez les projets, suivez les événements et coordonnez les versions à travers vos applications. + +## Outils + +### `sentry_issues_list` + +Liste les problèmes de Sentry pour une organisation spécifique et éventuellement un projet spécifique. Renvoie les détails des problèmes, y compris le statut, le nombre d'erreurs et les horodatages de dernière apparition. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry | +| `organizationSlug` | chaîne | Oui | Le slug de l'organisation | +| `projectSlug` | chaîne | Non | Filtrer les problèmes par slug de projet spécifique (facultatif) | +| `query` | chaîne | Non | Requête de recherche pour filtrer les problèmes. Prend en charge la syntaxe de recherche Sentry (par exemple, "is:unresolved", "level:error") | +| `statsPeriod` | chaîne | Non | Période pour les statistiques (par exemple, "24h", "7d", "30d"). Par défaut à 24h si non spécifié. | +| `cursor` | chaîne | Non | Curseur de pagination pour récupérer la page suivante de résultats | +| `limit` | nombre | Non | Nombre de problèmes à renvoyer par page (par défaut : 25, max : 100) | +| `status` | chaîne | Non | Filtrer par statut du problème : unresolved, resolved, ignored ou muted | +| `sort` | chaîne | Non | Ordre de tri : date, new, freq, priority ou user (par défaut : date) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `issues` | array | Liste des problèmes Sentry | + +### `sentry_issues_get` + +Récupère des informations détaillées sur un problème Sentry spécifique par son ID. Renvoie les détails complets du problème, y compris les métadonnées, les tags et les statistiques. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Jeton d'authentification de l'API Sentry | +| `organizationSlug` | string | Oui | Le slug de l'organisation | +| `issueId` | string | Oui | L'ID unique du problème à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `issue` | object | Informations détaillées sur le problème Sentry | + +### `sentry_issues_update` + +Met à jour un problème Sentry en modifiant son statut, son attribution, son état de signet ou d'autres propriétés. Renvoie les détails du problème mis à jour. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Jeton d'authentification de l'API Sentry | +| `organizationSlug` | string | Oui | Le slug de l'organisation | +| `issueId` | string | Oui | L'ID unique du problème à mettre à jour | +| `status` | string | Non | Nouveau statut pour le problème : resolved, unresolved, ignored, ou resolvedInNextRelease | +| `assignedTo` | string | Non | ID utilisateur ou email à qui attribuer le problème. Utilisez une chaîne vide pour retirer l'attribution. | +| `isBookmarked` | boolean | Non | Indique si le problème doit être mis en signet | +| `isSubscribed` | boolean | Non | Indique si l'on souhaite s'abonner aux mises à jour du problème | +| `isPublic` | boolean | Non | Indique si le problème doit être visible publiquement | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `issue` | objet | Le problème Sentry mis à jour | + +### `sentry_projects_list` + +Liste tous les projets dans une organisation Sentry. Renvoie les détails du projet, y compris le nom, la plateforme, les équipes et la configuration. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry | +| `organizationSlug` | chaîne | Oui | Le slug de l'organisation | +| `cursor` | chaîne | Non | Curseur de pagination pour récupérer la page suivante de résultats | +| `limit` | nombre | Non | Nombre de projets à renvoyer par page \(par défaut : 25, max : 100\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `projects` | tableau | Liste des projets Sentry | + +### `sentry_projects_get` + +Récupère des informations détaillées sur un projet Sentry spécifique par son slug. Renvoie les détails complets du projet, y compris les équipes, les fonctionnalités et la configuration. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry | +| `organizationSlug` | chaîne | Oui | Le slug de l'organisation | +| `projectSlug` | chaîne | Oui | L'ID ou le slug du projet à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `project` | objet | Informations détaillées sur le projet Sentry | + +### `sentry_projects_create` + +Créez un nouveau projet Sentry dans une organisation. Nécessite une équipe à laquelle associer le projet. Renvoie les détails du projet créé. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry | +| `organizationSlug` | chaîne | Oui | Le slug de l'organisation | +| `name` | chaîne | Oui | Le nom du projet | +| `teamSlug` | chaîne | Oui | Le slug de l'équipe qui sera propriétaire de ce projet | +| `slug` | chaîne | Non | Identifiant de projet compatible URL \(généré automatiquement à partir du nom si non fourni\) | +| `platform` | chaîne | Non | Plateforme/langage pour le projet \(par exemple, javascript, python, node, react-native\). Si non spécifié, la valeur par défaut est "other" | +| `defaultRules` | booléen | Non | Indique s'il faut créer des règles d'alerte par défaut \(par défaut : true\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `project` | objet | Le projet Sentry nouvellement créé | + +### `sentry_projects_update` + +Mettez à jour un projet Sentry en modifiant son nom, son slug, sa plateforme ou d'autres paramètres. Renvoie les détails du projet mis à jour. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry | +| `organizationSlug` | chaîne | Oui | Le slug de l'organisation | +| `projectSlug` | chaîne | Oui | Le slug du projet à mettre à jour | +| `name` | chaîne | Non | Nouveau nom pour le projet | +| `slug` | chaîne | Non | Nouvel identifiant de projet compatible URL | +| `platform` | chaîne | Non | Nouvelle plateforme/langage pour le projet \(par exemple, javascript, python, node\) | +| `isBookmarked` | booléen | Non | Indique s'il faut mettre le projet en favori | +| `digestsMinDelay` | nombre | Non | Délai minimum \(en secondes\) pour les notifications par digest | +| `digestsMaxDelay` | nombre | Non | Délai maximum \(en secondes\) pour les notifications par digest | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `project` | objet | Le projet Sentry mis à jour | + +### `sentry_events_list` + +Liste les événements d'un projet Sentry. Peut être filtré par ID de problème, requête ou période. Renvoie les détails de l'événement, y compris le contexte, les balises et les informations utilisateur. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry | +| `organizationSlug` | chaîne | Oui | Le slug de l'organisation | +| `projectSlug` | chaîne | Oui | Le slug du projet dont on veut lister les événements | +| `issueId` | chaîne | Non | Filtrer les événements par un ID de problème spécifique | +| `query` | chaîne | Non | Requête de recherche pour filtrer les événements. Prend en charge la syntaxe de recherche Sentry \(ex. : "user.email:*@example.com"\) | +| `cursor` | chaîne | Non | Curseur de pagination pour récupérer la page suivante de résultats | +| `limit` | nombre | Non | Nombre d'événements à renvoyer par page \(par défaut : 50, max : 100\) | +| `statsPeriod` | chaîne | Non | Période à interroger \(ex. : "24h", "7d", "30d"\). Par défaut 90j si non spécifié. | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `events` | tableau | Liste des événements Sentry | + +### `sentry_events_get` + +Récupère des informations détaillées sur un événement Sentry spécifique par son ID. Renvoie les détails complets de l'événement, y compris les traces de pile, les fils d'Ariane, le contexte et les informations utilisateur. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | string | Oui | Jeton d'authentification de l'API Sentry | +| `organizationSlug` | string | Oui | Le slug de l'organisation | +| `projectSlug` | string | Oui | Le slug du projet | +| `eventId` | string | Oui | L'identifiant unique de l'événement à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `event` | object | Informations détaillées sur l'événement Sentry | + +### `sentry_releases_list` + +Liste les versions pour une organisation ou un projet Sentry. Renvoie les détails des versions, y compris la version, les commits, les informations de déploiement et les projets associés. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | string | Oui | Jeton d'authentification de l'API Sentry | +| `organizationSlug` | string | Oui | Le slug de l'organisation | +| `projectSlug` | string | Non | Filtrer les versions par slug de projet spécifique \(facultatif\) | +| `query` | string | Non | Requête de recherche pour filtrer les versions \(par exemple, modèle de nom de version\) | +| `cursor` | string | Non | Curseur de pagination pour récupérer la page suivante de résultats | +| `limit` | number | Non | Nombre de versions à renvoyer par page \(par défaut : 25, max : 100\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `releases` | array | Liste des versions Sentry | + +### `sentry_releases_create` + +Créez une nouvelle version dans Sentry. Une version est une version de votre code déployée dans un environnement. Peut inclure des informations de commit et des projets associés. Renvoie les détails de la version créée. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry | +| `organizationSlug` | chaîne | Oui | Le slug de l'organisation | +| `version` | chaîne | Oui | Identifiant de version pour la release (par exemple, "2.0.0", "my-app@1.0.0", ou un SHA de commit git) | +| `projects` | chaîne | Oui | Liste séparée par des virgules des slugs de projet à associer à cette version | +| `ref` | chaîne | Non | Référence Git (SHA de commit, tag ou branche) pour cette version | +| `url` | chaîne | Non | URL pointant vers la version (par exemple, page de version GitHub) | +| `dateReleased` | chaîne | Non | Horodatage ISO 8601 indiquant quand la version a été déployée (par défaut : heure actuelle) | +| `commits` | chaîne | Non | Tableau JSON d'objets de commit avec id, repository (facultatif) et message (facultatif). Exemple : `[{"id":"abc123","message":"Fix bug"}]` | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `release` | objet | La version Sentry nouvellement créée | + +### `sentry_releases_deploy` + +Créez un enregistrement de déploiement pour une version Sentry dans un environnement spécifique. Les déploiements suivent quand et où les versions sont déployées. Renvoie les détails du déploiement créé. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | string | Oui | Jeton d'authentification de l'API Sentry | +| `organizationSlug` | string | Oui | Le slug de l'organisation | +| `version` | string | Oui | Identifiant de version de la release en cours de déploiement | +| `environment` | string | Oui | Nom de l'environnement où la release est déployée \(par ex., "production", "staging"\) | +| `name` | string | Non | Nom optionnel pour ce déploiement \(par ex., "Déploiement v2.0 en production"\) | +| `url` | string | Non | URL pointant vers le déploiement \(par ex., URL du pipeline CI/CD\) | +| `dateStarted` | string | Non | Horodatage ISO 8601 indiquant quand le déploiement a commencé \(par défaut : heure actuelle\) | +| `dateFinished` | string | Non | Horodatage ISO 8601 indiquant quand le déploiement s'est terminé | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `deploy` | object | L'enregistrement du déploiement nouvellement créé | + +## Remarques + +- Catégorie : `tools` +- Type : `sentry` diff --git a/apps/docs/content/docs/ja/blocks/agent.mdx b/apps/docs/content/docs/ja/blocks/agent.mdx index d38bae14eb..c2516664ce 100644 --- a/apps/docs/content/docs/ja/blocks/agent.mdx +++ b/apps/docs/content/docs/ja/blocks/agent.mdx @@ -46,7 +46,7 @@ When responding to questions about investments, include risk disclaimers. - **Anthropic**: Claude 4.5 Sonnet、Claude Opus 4.1 - **Google**: Gemini 2.5 Pro、Gemini 2.0 Flash - **その他のプロバイダー**: Groq、Cerebras、xAI、Azure OpenAI、OpenRouter -- **ローカルモデル**: Ollama互換モデル +- **ローカルモデル**: OllamaまたはVLLM互換モデル ### 温度 diff --git a/apps/docs/content/docs/ja/blocks/evaluator.mdx b/apps/docs/content/docs/ja/blocks/evaluator.mdx index d6ed4339a4..8fcc6d5ec7 100644 --- a/apps/docs/content/docs/ja/blocks/evaluator.mdx +++ b/apps/docs/content/docs/ja/blocks/evaluator.mdx @@ -48,11 +48,11 @@ Relevance (1-5): How relevant is the content to the original query? 評価を実行するAIモデルを選択します: -- **OpenAI**:GPT-4o、o1、o3、o4-mini、gpt-4.1 -- **Anthropic**:Claude 3.7 Sonnet -- **Google**:Gemini 2.5 Pro、Gemini 2.0 Flash -- **その他のプロバイダー**:Groq、Cerebras、xAI、DeepSeek -- **ローカルモデル**:Ollama互換モデル +- **OpenAI**: GPT-4o、o1、o3、o4-mini、gpt-4.1 +- **Anthropic**: Claude 3.7 Sonnet +- **Google**: Gemini 2.5 Pro、Gemini 2.0 Flash +- **Other Providers**: Groq、Cerebras、xAI、DeepSeek +- **Local Models**: OllamaまたはVLLM互換モデル 最良の結果を得るには、GPT-4oやClaude 3.7 Sonnetなど、強力な推論能力を持つモデルを使用してください。 diff --git a/apps/docs/content/docs/ja/blocks/guardrails.mdx b/apps/docs/content/docs/ja/blocks/guardrails.mdx index a9ed0b43c6..5e908dc8c6 100644 --- a/apps/docs/content/docs/ja/blocks/guardrails.mdx +++ b/apps/docs/content/docs/ja/blocks/guardrails.mdx @@ -65,9 +65,9 @@ import { Video } from '@/components/ui/video' **設定:** - **ナレッジベース**: 既存のナレッジベースから選択 - **モデル**: スコアリング用のLLMを選択(強力な推論能力が必要 - GPT-4o、Claude 3.7 Sonnetを推奨) -- **APIキー**: 選択したLLMプロバイダーの認証(ホスト型/Ollamaモデルの場合は自動的に非表示) -- **信頼度閾値**: 合格するための最小スコア(0〜10、デフォルト:3) -- **Top K**(詳細設定): 取得するナレッジベースのチャンク数(デフォルト:10) +- **APIキー**: 選択したLLMプロバイダーの認証(ホスト型/OllamaまたはVLLM互換モデルの場合は自動的に非表示) +- **信頼度しきい値**: 合格するための最小スコア(0-10、デフォルト: 3) +- **Top K**(高度な設定): 取得するナレッジベースのチャンク数(デフォルト: 10) **出力:** - `passed`: 信頼度スコア ≥ しきい値の場合は `true` diff --git a/apps/docs/content/docs/ja/blocks/router.mdx b/apps/docs/content/docs/ja/blocks/router.mdx index c705d08247..8cfc609ad3 100644 --- a/apps/docs/content/docs/ja/blocks/router.mdx +++ b/apps/docs/content/docs/ja/blocks/router.mdx @@ -52,11 +52,11 @@ import { Image } from '@/components/ui/image' ルーティング判断を行うAIモデルを選択します: -- **OpenAI**:GPT-4o、o1、o3、o4-mini、gpt-4.1 -- **Anthropic**:Claude 3.7 Sonnet -- **Google**:Gemini 2.5 Pro、Gemini 2.0 Flash -- **その他のプロバイダー**:Groq、Cerebras、xAI、DeepSeek -- **ローカルモデル**:Ollama互換モデル +- **OpenAI**: GPT-4o、o1、o3、o4-mini、gpt-4.1 +- **Anthropic**: Claude 3.7 Sonnet +- **Google**: Gemini 2.5 Pro、Gemini 2.0 Flash +- **Other Providers**: Groq、Cerebras、xAI、DeepSeek +- **Local Models**: OllamaまたはVLLM互換モデル 最良の結果を得るには、GPT-4oやClaude 3.7 Sonnetなど、強力な推論能力を持つモデルを使用してください。 diff --git a/apps/docs/content/docs/ja/execution/costs.mdx b/apps/docs/content/docs/ja/execution/costs.mdx index 8f639970b9..53a523649e 100644 --- a/apps/docs/content/docs/ja/execution/costs.mdx +++ b/apps/docs/content/docs/ja/execution/costs.mdx @@ -47,7 +47,7 @@ AIブロックを使用するワークフローでは、ログで詳細なコス ## 料金オプション - + **ホステッドモデル** - Simは2.5倍の価格倍率でAPIキーを提供します: @@ -64,7 +64,7 @@ AIブロックを使用するワークフローでは、ログで詳細なコス - **自前のAPIキー** - 基本価格で任意のモデルを使用できます: + **独自のAPIキー** - 基本価格で任意のモデルを使用: | プロバイダー | モデル | 入力 / 出力 | |----------|---------|----------------| @@ -74,8 +74,9 @@ AIブロックを使用するワークフローでは、ログで詳細なコス | Groq | Llama 4 Scout | $0.40 / $0.60 | | Cerebras | Llama 3.3 70B | $0.94 / $0.94 | | Ollama | ローカルモデル | 無料 | + | VLLM | ローカルモデル | 無料 | - *マークアップなしでプロバイダーに直接支払い* + *プロバイダーに直接支払い、マークアップなし* @@ -85,11 +86,11 @@ AIブロックを使用するワークフローでは、ログで詳細なコス ## コスト最適化戦略 -- **モデル選択**: タスクの複雑さに基づいてモデルを選択します。単純なタスクにはGPT-4.1-nanoを使用し、複雑な推論にはo1やClaude Opusが必要かもしれません。 +- **モデル選択**: タスクの複雑さに基づいてモデルを選択してください。単純なタスクにはGPT-4.1-nanoを使用し、複雑な推論にはo1やClaude Opusが必要かもしれません。 - **プロンプトエンジニアリング**: 構造化された簡潔なプロンプトは、品質を犠牲にすることなくトークン使用量を削減します。 -- **ローカルモデル**: 重要度の低いタスクにはOllamaを使用して、API費用を完全に排除します。 -- **キャッシュと再利用**: 頻繁に使用される結果を変数やファイルに保存して、AIモデル呼び出しの繰り返しを避けます。 -- **バッチ処理**: 個別の呼び出しを行うのではなく、1回のAIリクエストで複数のアイテムを処理します。 +- **ローカルモデル**: 重要でないタスクにはOllamaやVLLMを使用して、API費用を完全に排除します。 +- **キャッシングと再利用**: 頻繁に使用される結果を変数やファイルに保存して、AIモデル呼び出しの繰り返しを避けます。 +- **バッチ処理**: 個別の呼び出しを行うのではなく、1つのAIリクエストで複数のアイテムを処理します。 ## 使用状況モニタリング diff --git a/apps/docs/content/docs/ja/introduction/index.mdx b/apps/docs/content/docs/ja/introduction/index.mdx index 544b8a94ea..d606340de9 100644 --- a/apps/docs/content/docs/ja/introduction/index.mdx +++ b/apps/docs/content/docs/ja/introduction/index.mdx @@ -59,10 +59,10 @@ Simはオープンソースのビジュアルワークフロービルダーで Simは複数のカテゴリにわたる80以上のサービスとネイティブ連携を提供します: -- **AIモデル**: OpenAI、Anthropic、Google Gemini、Groq、Cerebras、Ollamaを介したローカルモデル +- **AIモデル**: OpenAI、Anthropic、Google Gemini、Groq、Cerebras、OllamaやVLLM経由のローカルモデル - **コミュニケーション**: Gmail、Slack、Microsoft Teams、Telegram、WhatsApp - **生産性**: Notion、Google Workspace、Airtable、Monday.com -- **開発**: GitHub、Jira、Linear、自動ブラウザテスト +- **開発**: GitHub、Jira、Linear、自動化されたブラウザテスト - **検索とデータ**: Google検索、Perplexity、Firecrawl、Exa AI - **データベース**: PostgreSQL、MySQL、Supabase、Pinecone、Qdrant diff --git a/apps/docs/content/docs/ja/tools/incidentio.mdx b/apps/docs/content/docs/ja/tools/incidentio.mdx new file mode 100644 index 0000000000..05c4b5a6b0 --- /dev/null +++ b/apps/docs/content/docs/ja/tools/incidentio.mdx @@ -0,0 +1,841 @@ +--- +title: incidentio +description: incident.ioでインシデントを管理する +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[incident.io](https://incident.io)でインシデント管理を強化しましょう – インシデントの調整、対応プロセスの合理化、アクションアイテムの追跡を一箇所で行える主要プラットフォームです。incident.ioを自動化ワークフローにシームレスに統合して、インシデントの作成、リアルタイムコラボレーション、フォローアップ、スケジューリング、エスカレーションなどを管理できます。 + +incident.ioツールでは、以下のことが可能です: + +- **インシデントの一覧表示と検索**: `incidentio_incidents_list`を使用して、重要度、ステータス、タイムスタンプなどのメタデータを含む進行中または過去のインシデントのリストをすばやく取得できます。 +- **新しいインシデントの作成**: `incidentio_incidents_create`を通じてプログラムで新しいインシデントを作成し、重要度、名前、タイプ、カスタム詳細を指定して、対応の遅延を防ぎます。 +- **インシデントフォローアップの自動化**: incident.ioの強力な自動化機能を活用して、重要なアクションアイテムや学びが見逃されないようにし、チームが問題を解決しプロセスを改善するのを支援します。 +- **ワークフローのカスタマイズ**: 組織のニーズに合わせたカスタムインシデントタイプ、重要度、カスタムフィールドを統合します。 +- **スケジュールとエスカレーションによるベストプラクティスの実施**: 状況の進展に応じて自動的に割り当て、通知、エスカレーションを行うことで、オンコールとインシデント管理を効率化します。 + +incident.ioは、現代の組織がより迅速に対応し、チームを調整し、継続的な改善のために学びを捉えることを可能にします。SRE、DevOps、セキュリティ、またはITインシデントを管理する場合でも、incident.ioはエージェントワークフローにプログラムで一元化された最高クラスのインシデント対応をもたらします。 + +**利用可能な主要操作**: +- `incidentio_incidents_list`: 詳細情報を含むインシデントの一覧表示、ページネーション、フィルタリング。 +- `incidentio_incidents_create`: カスタム属性と重複制御(べき等性)を備えた新しいインシデントをプログラムで開く。 +- ...そしてさらに多くの機能が追加予定! + +今日、incident.ioをワークフロー自動化と統合して、信頼性、説明責任、運用の卓越性を向上させましょう。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +incident.ioをワークフローに統合します。インシデント、アクション、フォローアップ、ワークフロー、スケジュール、エスカレーション、カスタムフィールドなどを管理できます。 + +## ツール + +### `incidentio_incidents_list` + +incident.ioからインシデントのリストを取得します。重大度、ステータス、タイムスタンプなどの詳細を含むインシデントのリストを返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `page_size` | number | いいえ | ページごとに返すインシデントの数(デフォルト:25) | +| `after` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `incidents` | array | インシデントのリスト | + +### `incidentio_incidents_create` + +incident.ioに新しいインシデントを作成します。idempotency_key、severity_id、visibilityが必要です。オプションとして、name、summary、type、statusを受け付けます。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `idempotency_key` | string | はい | インシデント作成の重複を防ぐための一意の識別子。UUIDまたは一意の文字列を使用してください。 | +| `name` | string | いいえ | インシデントの名前(オプション) | +| `summary` | string | いいえ | インシデントの簡単な概要 | +| `severity_id` | string | はい | 重大度レベルのID(必須) | +| `incident_type_id` | string | いいえ | インシデントタイプのID | +| `incident_status_id` | string | いいえ | 初期インシデントステータスのID | +| `visibility` | string | はい | インシデントの可視性:"public"または"private"(必須) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `incident` | object | 作成されたインシデントオブジェクト | + +### `incidentio_incidents_show` + +IDによってincident.ioから特定のインシデントに関する詳細情報を取得します。カスタムフィールドや役割の割り当てを含む完全なインシデントの詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | 取得するインシデントのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `incident` | object | 詳細なインシデント情報 | + +### `incidentio_incidents_update` + +incident.ioで既存のインシデントを更新します。名前、概要、重大度、ステータス、またはタイプを更新できます。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | 更新するインシデントのID | +| `name` | string | いいえ | インシデントの更新された名前 | +| `summary` | string | いいえ | インシデントの更新された概要 | +| `severity_id` | string | いいえ | インシデントの更新された重大度ID | +| `incident_status_id` | string | いいえ | インシデントの更新されたステータスID | +| `incident_type_id` | string | いいえ | 更新されたインシデントタイプID | +| `notify_incident_channel` | boolean | はい | この更新についてインシデントチャンネルに通知するかどうか | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `incident` | object | 更新されたインシデントオブジェクト | + +### `incidentio_actions_list` + +incident.ioからアクションを一覧表示します。オプションでインシデントIDによるフィルタリングが可能です。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `incident_id` | string | いいえ | インシデントIDでアクションをフィルタリング | +| `page_size` | number | いいえ | ページごとに返すアクションの数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `actions` | array | アクションのリスト | + +### `incidentio_actions_show` + +incident.ioから特定のアクションに関する詳細情報を取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | アクションID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `action` | object | アクションの詳細 | + +### `incidentio_follow_ups_list` + +incident.ioからフォローアップを一覧表示します。オプションでインシデントIDによるフィルタリングが可能です。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `incident_id` | string | いいえ | インシデントIDでフォローアップをフィルタリング | +| `page_size` | number | いいえ | ページごとに返すフォローアップの数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `follow_ups` | array | フォローアップのリスト | + +### `incidentio_follow_ups_show` + +incident.ioから特定のフォローアップに関する詳細情報を取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | フォローアップID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `follow_up` | object | フォローアップの詳細 | + +### `incidentio_users_list` + +Incident.ioワークスペース内のすべてのユーザーを一覧表示します。ID、名前、メール、役割などのユーザー詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Incident.io APIキー | +| `page_size` | number | いいえ | ページごとに返す結果の数(デフォルト:25) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `users` | array | ワークスペース内のユーザーリスト | + +### `incidentio_users_show` + +IDによってIncident.ioワークスペース内の特定のユーザーに関する詳細情報を取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Incident.io APIキー | +| `id` | string | はい | 取得するユーザーの一意の識別子 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `user` | object | リクエストされたユーザーの詳細 | + +### `incidentio_workflows_list` + +incident.ioワークスペース内のすべてのワークフローを一覧表示します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `page_size` | number | いいえ | ページごとに返すワークフローの数 | +| `after` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `workflows` | array | ワークフローのリスト | + +### `incidentio_workflows_show` + +incident.ioの特定のワークフローの詳細を取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | 取得するワークフローのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `workflow` | object | ワークフローの詳細 | + +### `incidentio_workflows_update` + +incident.ioの既存のワークフローを更新します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | 更新するワークフローのID | +| `name` | string | いいえ | ワークフローの新しい名前 | +| `state` | string | いいえ | ワークフローの新しい状態(active、draft、またはdisabled) | +| `folder` | string | いいえ | ワークフローの新しいフォルダ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `workflow` | object | 更新されたワークフロー | + +### `incidentio_workflows_delete` + +incident.ioでワークフローを削除します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | 削除するワークフローのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `message` | string | 成功メッセージ | + +### `incidentio_schedules_list` + +incident.ioのすべてのスケジュールを一覧表示します + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `page_size` | number | いいえ | ページあたりの結果数(デフォルト:25) | +| `after` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `schedules` | array | スケジュールのリスト | + +### `incidentio_schedules_create` + +incident.ioで新しいスケジュールを作成します + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `name` | string | はい | スケジュールの名前 | +| `timezone` | string | はい | スケジュールのタイムゾーン(例:America/New_York) | +| `config` | string | はい | ローテーションを含むJSONフォーマットのスケジュール設定。例:\{"rotations": \[\{"name": "Primary", "users": \[\{"id": "user_id"\}\], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": \[\{"interval": 1, "interval_type": "weekly"\}\]\}\]\} | +| `Example` | string | いいえ | 説明なし | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `schedule` | object | 作成されたスケジュール | + +### `incidentio_schedules_show` + +incident.io内の特定のスケジュールの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | スケジュールのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `schedule` | object | スケジュールの詳細 | + +### `incidentio_schedules_update` + +incident.io内の既存のスケジュールを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | 更新するスケジュールのID | +| `name` | string | いいえ | スケジュールの新しい名前 | +| `timezone` | string | いいえ | スケジュールの新しいタイムゾーン(例:America/New_York) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `schedule` | object | 更新されたスケジュール | + +### `incidentio_schedules_delete` + +incident.io内のスケジュールを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | 削除するスケジュールのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `message` | string | 成功メッセージ | + +### `incidentio_escalations_list` + +incident.io のすべてのエスカレーションポリシーを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io API キー | +| `page_size` | number | いいえ | ページあたりの結果数(デフォルト:25) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `escalations` | array | エスカレーションポリシーのリスト | + +### `incidentio_escalations_create` + +incident.io に新しいエスカレーションポリシーを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io API キー | +| `idempotency_key` | string | はい | 重複したエスカレーション作成を防ぐための一意の識別子。UUID または一意の文字列を使用してください。 | +| `title` | string | はい | エスカレーションのタイトル | +| `escalation_path_id` | string | いいえ | 使用するエスカレーションパスの ID(user_ids が提供されていない場合は必須) | +| `user_ids` | string | いいえ | 通知するユーザー ID のカンマ区切りリスト(escalation_path_id が提供されていない場合は必須) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `escalation` | object | 作成されたエスカレーションポリシー | + +### `incidentio_escalations_show` + +incident.io の特定のエスカレーションポリシーの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | エスカレーションポリシーのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `escalation` | object | エスカレーションポリシーの詳細 | + +### `incidentio_custom_fields_list` + +incident.ioからすべてのカスタムフィールドを一覧表示します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `custom_fields` | array | カスタムフィールドのリスト | + +### `incidentio_custom_fields_create` + +incident.ioに新しいカスタムフィールドを作成します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `name` | string | はい | カスタムフィールドの名前 | +| `description` | string | はい | カスタムフィールドの説明(必須) | +| `field_type` | string | はい | カスタムフィールドの種類(例:text、single_select、multi_select、numeric、datetime、link、user、team) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `custom_field` | object | 作成されたカスタムフィールド | + +### `incidentio_custom_fields_show` + +incident.ioの特定のカスタムフィールドに関する詳細情報を取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | カスタムフィールドID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `custom_field` | object | カスタムフィールドの詳細 | + +### `incidentio_custom_fields_update` + +incident.ioの既存のカスタムフィールドを更新します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | カスタムフィールドID | +| `name` | string | はい | カスタムフィールドの新しい名前(必須) | +| `description` | string | はい | カスタムフィールドの新しい説明(必須) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `custom_field` | object | 更新されたカスタムフィールド | + +### `incidentio_custom_fields_delete` + +incident.ioからカスタムフィールドを削除します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | カスタムフィールドID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `message` | string | 成功メッセージ | + +### `incidentio_severities_list` + +Incident.ioワークスペースで設定されているすべての重大度レベルを一覧表示します。IDや名前、説明、ランクなどの重大度の詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Incident.io APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `severities` | array | 重大度レベルのリスト | + +### `incidentio_incident_statuses_list` + +Incident.ioワークスペースで設定されているすべてのインシデントステータスを一覧表示します。ID、名前、説明、カテゴリなどのステータスの詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Incident.io APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `incident_statuses` | array | インシデントステータスのリスト | + +### `incidentio_incident_types_list` + +Incident.ioワークスペースで設定されているすべてのインシデントタイプを一覧表示します。ID、名前、説明、デフォルトフラグなどのタイプの詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Incident.io APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `incident_types` | array | インシデントタイプのリスト | + +### `incidentio_incident_roles_list` + +incident.ioのすべてのインシデントロールを一覧表示します + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `incident_roles` | array | インシデントロールのリスト | + +### `incidentio_incident_roles_create` + +incident.ioで新しいインシデントロールを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `name` | string | はい | インシデントロールの名前 | +| `description` | string | はい | インシデントロールの説明 | +| `instructions` | string | はい | インシデントロールの指示 | +| `shortform` | string | はい | ロールの短縮形 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `incident_role` | object | 作成されたインシデントロール | + +### `incidentio_incident_roles_show` + +incident.ioで特定のインシデントロールの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | インシデントロールのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `incident_role` | object | インシデントロールの詳細 | + +### `incidentio_incident_roles_update` + +incident.ioで既存のインシデントロールを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | 更新するインシデントロールのID | +| `name` | string | はい | インシデントロールの名前 | +| `description` | string | はい | インシデントロールの説明 | +| `instructions` | string | はい | インシデントロールの指示 | +| `shortform` | string | はい | ロールの短縮形 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `incident_role` | object | 更新されたインシデントロール | + +### `incidentio_incident_roles_delete` + +incident.ioでインシデントロールを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | 削除するインシデントロールのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `message` | string | 成功メッセージ | + +### `incidentio_incident_timestamps_list` + +incident.ioのすべてのインシデントタイムスタンプ定義をリスト表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `incident_timestamps` | array | インシデントタイムスタンプ定義のリスト | + +### `incidentio_incident_timestamps_show` + +incident.ioの特定のインシデントタイムスタンプ定義の詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | インシデントタイムスタンプのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `incident_timestamp` | object | インシデントタイムスタンプの詳細 | + +### `incidentio_incident_updates_list` + +incident.ioの特定のインシデントに関するすべての更新を一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `incident_id` | string | いいえ | 更新を取得するインシデントのID(オプション - 提供されない場合、すべての更新を返します) | +| `page_size` | number | いいえ | ページごとに返す結果の数 | +| `after` | string | いいえ | ページネーション用のカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `incident_updates` | array | インシデント更新のリスト | + +### `incidentio_schedule_entries_list` + +incident.ioの特定のスケジュールに関するすべてのエントリを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `schedule_id` | string | はい | エントリを取得するスケジュールのID | +| `entry_window_start` | string | いいえ | エントリをフィルタリングする開始日時(ISO 8601形式) | +| `entry_window_end` | string | いいえ | エントリをフィルタリングする終了日時(ISO 8601形式) | +| `page_size` | number | いいえ | ページごとに返す結果の数 | +| `after` | string | いいえ | ページネーション用のカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `schedule_entries` | array | スケジュールエントリのリスト | + +### `incidentio_schedule_overrides_create` + +incident.ioで新しいスケジュールオーバーライドを作成する + +#### 入力 + +| パラメータ | タイプ | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `rotation_id` | string | はい | オーバーライドするローテーションのID | +| `schedule_id` | string | はい | スケジュールのID | +| `user_id` | string | いいえ | 割り当てるユーザーのID(user_id、user_email、またはuser_slack_idのいずれかを提供)| +| `user_email` | string | いいえ | 割り当てるユーザーのメールアドレス(user_id、user_email、またはuser_slack_idのいずれかを提供)| +| `user_slack_id` | string | いいえ | 割り当てるユーザーのSlack ID(user_id、user_email、またはuser_slack_idのいずれかを提供)| +| `start_at` | string | はい | オーバーライドの開始時間(ISO 8601形式)| +| `end_at` | string | はい | オーバーライドの終了時間(ISO 8601形式)| + +#### 出力 + +| パラメータ | タイプ | 説明 | +| --------- | ---- | ----------- | +| `override` | object | 作成されたスケジュールオーバーライド | + +### `incidentio_escalation_paths_create` + +incident.ioで新しいエスカレーションパスを作成する + +#### 入力 + +| パラメータ | タイプ | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `name` | string | はい | エスカレーションパスの名前 | +| `path` | json | はい | ターゲットと確認までの時間(秒)を含むエスカレーションレベルの配列。各レベルには以下が必要:targets(\{id, type, schedule_id?, user_id?, urgency\}の配列)とtime_to_ack_seconds(数値)| +| `working_hours` | json | いいえ | オプションの勤務時間設定。\{weekday, start_time, end_time\}の配列 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `escalation_path` | object | 作成されたエスカレーションパス | + +### `incidentio_escalation_paths_show` + +incident.io内の特定のエスカレーションパスの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | エスカレーションパスのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `escalation_path` | object | エスカレーションパスの詳細 | + +### `incidentio_escalation_paths_update` + +incident.ioで既存のエスカレーションパスを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | 更新するエスカレーションパスのID | +| `name` | string | いいえ | エスカレーションパスの新しい名前 | +| `path` | json | いいえ | 新しいエスカレーションパスの設定。ターゲットとtime_to_ack_secondsを持つエスカレーションレベルの配列 | +| `working_hours` | json | いいえ | 新しい稼働時間の設定。\{weekday, start_time, end_time\}の配列 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `escalation_path` | object | 更新されたエスカレーションパス | + +### `incidentio_escalation_paths_delete` + +incident.ioでエスカレーションパスを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | incident.io APIキー | +| `id` | string | はい | 削除するエスカレーションパスのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `message` | string | 成功メッセージ | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `incidentio` diff --git a/apps/docs/content/docs/ja/tools/knowledge.mdx b/apps/docs/content/docs/ja/tools/knowledge.mdx index 3b5d055ee5..8ebff26c1b 100644 --- a/apps/docs/content/docs/ja/tools/knowledge.mdx +++ b/apps/docs/content/docs/ja/tools/knowledge.mdx @@ -40,10 +40,14 @@ Simでは、ナレッジベースブロックによってエージェントが | パラメータ | 型 | 必須 | 説明 | | --------- | ---- | -------- | ----------- | -| `knowledgeBaseId` | string | はい | 検索対象のナレッジベースのID | -| `query` | string | いいえ | 検索クエリテキスト(タグフィルターを使用する場合は省略可能) | +| `knowledgeBaseId` | string | はい | 検索対象のナレッジベースID | +| `query` | string | いいえ | 検索クエリテキスト(タグフィルター使用時はオプション) | | `topK` | number | いいえ | 返す最も類似した結果の数(1-100) | | `tagFilters` | array | いいえ | tagNameとtagValueプロパティを持つタグフィルターの配列 | +| `items` | object | いいえ | 説明なし | +| `properties` | string | いいえ | 説明なし | +| `tagName` | string | いいえ | 説明なし | +| `tagValue` | string | いいえ | 説明なし | #### 出力 @@ -87,7 +91,12 @@ Simでは、ナレッジベースブロックによってエージェントが | `tag5` | string | いいえ | ドキュメントのタグ5の値 | | `tag6` | string | いいえ | ドキュメントのタグ6の値 | | `tag7` | string | いいえ | ドキュメントのタグ7の値 | -| `documentTagsData` | array | いいえ | 名前、タイプ、値を持つ構造化されたタグデータ | +| `documentTagsData` | array | いいえ | 名前、タイプ、値を持つ構造化タグデータ | +| `items` | object | いいえ | 説明なし | +| `properties` | string | いいえ | 説明なし | +| `tagName` | string | いいえ | 説明なし | +| `tagValue` | string | いいえ | 説明なし | +| `tagType` | string | いいえ | 説明なし | #### 出力 diff --git a/apps/docs/content/docs/ja/tools/posthog.mdx b/apps/docs/content/docs/ja/tools/posthog.mdx new file mode 100644 index 0000000000..77e9346279 --- /dev/null +++ b/apps/docs/content/docs/ja/tools/posthog.mdx @@ -0,0 +1,1112 @@ +--- +title: PostHog +description: プロダクトアナリティクスと機能管理 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[PostHog](https://posthog.com/)ツールは、強力なプロダクトアナリティクス、機能フラグ管理、実験、ユーザー行動インサイトをエージェントワークフローに直接統合します。現代のチーム向けに設計されており、ユーザーデータをリアルタイムでキャプチャ、分析、活用することができ、より良い製品の構築、エンゲージメントの理解、コンバージョン率の向上に役立ちます。 + +PostHogツールでは以下のことが可能です: + +- **イベントの追跡と分析**: `posthog_capture_event`および`posthog_batch_events`操作を使用して、個別または複数のユーザーアクション、ページビュー、カスタムイベントを記録し、詳細な分析を行います。 +- **イベントデータの探索**: `posthog_list_events`操作を使用して、履歴またはリアルタイムのイベントを取得・一覧表示し、高度なイベント分析を行います。 +- **ユーザーの理解**: `posthog_list_persons`、`posthog_get_person`、および`posthog_delete_person`操作を活用して、ユーザープロファイルを管理し、詳細なユーザーインサイトを取得したり、必要に応じてユーザーを削除したりします。 +- **実用的な製品インサイトの獲得**: `posthog_list_insights`、`posthog_get_insight`、および`posthog_create_insight`操作を通じて、ユーザージャーニー、機能の使用状況、エンゲージメントを可視化します。 +- **機能の安全な管理とロールアウト**: `posthog_list_feature_flags`、`posthog_get_feature_flag`、`posthog_create_feature_flag`、`posthog_update_feature_flag`、および`posthog_delete_feature_flag`などの操作を使用して、機能を切り替えたり、A/Bテストや多変量テストを大規模に実行したりします。 +- **オーディエンスのセグメント化とターゲティング**: `posthog_list_cohorts`、`posthog_get_cohort`、および`posthog_create_cohort`でコホートの構築、一覧表示、管理を行います。 +- **直接的なフィードバックの収集**: `posthog_list_surveys`、`posthog_get_survey`、`posthog_create_survey`、および`posthog_update_survey`を通じて、アンケートの設計、展開、分析を行います。 +- **ユーザーエクスペリエンスのモニタリング**: `posthog_list_session_recordings`および`posthog_get_session_recording`操作を通じてセッション記録にアクセスし分析します。 +- **チームとのコラボレーション**: ダッシュボード(`posthog_list_dashboards`、`posthog_get_dashboard`)の整理、インサイトやイベントの作成・注釈付け、PostHog内でのプロジェクトや組織の管理を行います。 + +製品分析の完全実装、ユーザーオンボーディングの強化、製品ロードマップの改善、または実際の使用データに基づく意思決定の自動化など、どのようなニーズにも対応できるPostHogツールは、高度な分析機能や製品内実験機能をエージェントやワークフローに提供します — すべてが一つの統合プラットフォームで実現します。 + +プライバシー、スケーラビリティ、オープンソースオプションを備えた真の製品分析をお探しですか?PostHogは世界中の俊敏なチームや企業から信頼されています。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +PostHogをワークフローに統合しましょう。イベントの追跡、機能フラグの管理、ユーザー行動の分析、実験の実施、アンケートの作成、セッション記録へのアクセスが可能です。 + +## ツール + +### `posthog_capture_event` + +PostHogで単一のイベントをキャプチャします。ユーザーアクション、ページビュー、またはカスタムイベントを追跡するために使用します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectApiKey` | string | はい | PostHogプロジェクトAPIキー(イベント取り込み用の公開トークン) | +| `region` | string | いいえ | PostHogリージョン:us(デフォルト)またはeu | +| `event` | string | はい | キャプチャするイベントの名前(例:"page_view"、"button_clicked") | +| `distinctId` | string | はい | ユーザーまたはデバイスの一意の識別子。ユーザーID、デバイスID、または匿名IDが使用可能 | +| `properties` | string | いいえ | イベントプロパティのJSON文字列(例:\{"button_name": "signup", "page": "homepage"\}) | +| `timestamp` | string | いいえ | イベントが発生した時刻のISO 8601タイムスタンプ。提供されない場合は現在時刻を使用 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `status` | string | イベントが正常にキャプチャされたかどうかを示すステータスメッセージ | + +### `posthog_batch_events` + +PostHogで複数のイベントを一度に取得します。バルクイベント取り込みによりパフォーマンスを向上させるために使用します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectApiKey` | string | はい | PostHogプロジェクトAPIキー(イベント取り込み用の公開トークン) | +| `region` | string | いいえ | PostHogリージョン: us (デフォルト)または eu | +| `batch` | string | はい | 取得するイベントのJSON配列。各イベントには以下が必要: event、distinct_id、およびオプションのproperties、timestamp。例: \[\{"event": "page_view", "distinct_id": "user123", "properties": \{"page": "/"\}\}\] | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `status` | string | バッチが正常に取得されたかどうかを示すステータスメッセージ | +| `eventsProcessed` | number | バッチで処理されたイベントの数 | + +### `posthog_list_events` + +PostHogでイベントを一覧表示します。注意: このエンドポイントは非推奨ですが、後方互換性のために維持されています。本番環境では、HogQLを使用したQueryエンドポイントを推奨します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | はい | PostHog個人APIキー(認証されたAPIアクセス用) | +| `region` | string | いいえ | PostHogリージョン: us (デフォルト)または eu | +| `projectId` | string | はい | PostHogプロジェクトID | +| `limit` | number | いいえ | 返すイベントの数(デフォルト: 100、最大: 100) | +| `offset` | number | いいえ | ページネーション用にスキップするイベントの数 | +| `event` | string | いいえ | 特定のイベント名でフィルタリング | +| `distinctId` | string | いいえ | 特定のdistinct_idでフィルタリング | +| `before` | string | いいえ | ISO 8601タイムスタンプ - この時間より前のイベントのみを返す | +| `after` | string | いいえ | ISO 8601タイムスタンプ - この時間より後のイベントのみを返す | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `events` | array | プロパティとメタデータを含むイベントのリスト | + +### `posthog_list_persons` + +PostHogの人物(ユーザー)を一覧表示します。プロパティと個別IDを含むユーザープロファイルを返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | はい | PostHog個人APIキー(認証済みAPIアクセス用) | +| `region` | string | いいえ | PostHogリージョン:us(デフォルト)またはeu | +| `projectId` | string | はい | PostHogプロジェクトID | +| `limit` | number | いいえ | 返す人物の数(デフォルト:100、最大:100) | +| `offset` | number | いいえ | ページネーション用にスキップする人物の数 | +| `search` | string | いいえ | メール、名前、または個別IDで人物を検索 | +| `distinctId` | string | いいえ | 特定のdistinct_idでフィルタリング | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `persons` | array | プロパティと識別子を含む人物のリスト | + +### `posthog_get_person` + +IDまたはUUIDによってPostHogの特定の人物に関する詳細情報を取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | はい | PostHog個人APIキー(認証済みAPIアクセス用) | +| `region` | string | いいえ | PostHogリージョン:us(デフォルト)またはeu | +| `projectId` | string | はい | PostHogプロジェクトID | +| `personId` | string | はい | 取得する人物IDまたはUUID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `person` | object | プロパティと識別子を含む人物の詳細 | + +### `posthog_delete_person` + +PostHogから人物を削除します。これにより、関連するすべてのイベントとデータが削除されます。注意して使用してください。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | はい | PostHog個人APIキー(認証されたAPIアクセス用) | +| `region` | string | いいえ | PostHogリージョン:us(デフォルト)またはeu | +| `projectId` | string | はい | PostHogプロジェクトID | +| `personId` | string | はい | 削除する人物IDまたはUUID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `status` | string | 人物が正常に削除されたかどうかを示すステータスメッセージ | + +### `posthog_query` + +PostHogでHogQLクエリを実行します。HogQLはPostHogです + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | はい | PostHog個人APIキー(認証されたAPIアクセス用) | +| `region` | string | いいえ | PostHogリージョン:us(デフォルト)またはeu | +| `projectId` | string | はい | PostHogプロジェクトID | +| `query` | string | はい | 実行するHogQLクエリ。例:\{"kind": "HogQLQuery", "query": "SELECT event, count\(\) FROM events WHERE timestamp > now\(\) - INTERVAL 1 DAY GROUP BY event"\} | +| `Example` | string | いいえ | 説明なし | +| `values` | string | いいえ | パラメータ化されたクエリのパラメータ値のオプションJSONストリング。例:\{"user_id": "123"\} | +| `Example` | string | いいえ | 説明なし | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `results` | array | 行の配列としてのクエリ結果 | + +### `posthog_list_insights` + +PostHogプロジェクト内のすべてのインサイトを一覧表示します。インサイトの設定、フィルター、およびメタデータを返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | いいえ | PostHogクラウドリージョン:「us」または「eu」\(デフォルト:「us」\) | +| `limit` | number | いいえ | ページごとに返す結果の数\(デフォルト:100\) | +| `offset` | number | いいえ | ページネーションのためにスキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `count` | number | プロジェクト内のインサイトの総数 | +| `next` | string | 結果の次のページのURL | +| `previous` | string | 結果の前のページのURL | +| `results` | array | 設定とメタデータを含むインサイトのリスト | + +### `posthog_get_insight` + +IDによって特定のインサイトをPostHogから取得します。詳細なインサイト設定、フィルター、およびメタデータを返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `insightId` | string | はい | 取得するインサイトID | +| `region` | string | いいえ | PostHogクラウドリージョン:「us」または「eu」\(デフォルト:「us」\) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | number | インサイトの一意の識別子 | +| `name` | string | インサイトの名前 | +| `description` | string | インサイトの説明 | +| `filters` | object | インサイトのフィルター設定 | +| `query` | object | インサイトのクエリ設定 | +| `created_at` | string | インサイトが作成されたISO形式のタイムスタンプ | +| `created_by` | object | インサイトを作成したユーザー | +| `last_modified_at` | string | インサイトが最後に変更されたISO形式のタイムスタンプ | +| `last_modified_by` | object | インサイトを最後に変更したユーザー | +| `saved` | boolean | インサイトが保存されているかどうか | +| `dashboards` | array | このインサイトが表示されるダッシュボードのID | +| `tags` | array | インサイトに関連付けられたタグ | +| `favorited` | boolean | インサイトがお気に入りに登録されているかどうか | + +### `posthog_create_insight` + +PostHogで新しいインサイトを作成します。インサイト名と設定フィルターまたはクエリが必要です。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | いいえ | PostHogクラウドリージョン: "us"または"eu"(デフォルト: "us") | +| `name` | string | いいえ | インサイトの名前(オプション - 提供されない場合、PostHogは派生した名前を生成します) | +| `description` | string | いいえ | インサイトの説明 | +| `filters` | string | いいえ | インサイトのフィルター設定のJSON文字列 | +| `query` | string | いいえ | インサイトのクエリ設定のJSON文字列 | +| `dashboards` | string | いいえ | このインサイトを追加するダッシュボードIDのカンマ区切りリスト | +| `tags` | string | いいえ | インサイト用タグのカンマ区切りリスト | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | number | 作成されたインサイトの一意の識別子 | +| `name` | string | インサイトの名前 | +| `description` | string | インサイトの説明 | +| `filters` | object | インサイトのフィルター設定 | +| `query` | object | インサイトのクエリ設定 | +| `created_at` | string | インサイトが作成されたISO形式のタイムスタンプ | +| `created_by` | object | インサイトを作成したユーザー | +| `last_modified_at` | string | インサイトが最後に変更されたISO形式のタイムスタンプ | +| `saved` | boolean | インサイトが保存されているかどうか | +| `dashboards` | array | このインサイトが表示されるダッシュボードのID | +| `tags` | array | インサイトに関連付けられたタグ | + +### `posthog_list_dashboards` + +PostHogプロジェクト内のすべてのダッシュボードを一覧表示します。ダッシュボードの設定、タイル、およびメタデータを返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | いいえ | PostHogクラウドリージョン:「us」または「eu」\(デフォルト:「us」\) | +| `limit` | number | いいえ | ページごとに返す結果の数\(デフォルト:100\) | +| `offset` | number | いいえ | ページネーションのためにスキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `count` | number | プロジェクト内のダッシュボードの総数 | +| `next` | string | 結果の次のページのURL | +| `previous` | string | 結果の前のページのURL | +| `results` | array | 設定とメタデータを含むダッシュボードのリスト | + +### `posthog_get_dashboard` + +IDを指定してPostHogからダッシュボードを取得します。詳細なダッシュボード設定、タイル、メタデータを返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `dashboardId` | string | はい | 取得するダッシュボードID | +| `region` | string | いいえ | PostHogクラウドリージョン: "us"または"eu"(デフォルト: "us") | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | number | ダッシュボードの一意の識別子 | +| `name` | string | ダッシュボードの名前 | +| `description` | string | ダッシュボードの説明 | +| `pinned` | boolean | ダッシュボードがピン留めされているかどうか | +| `created_at` | string | ダッシュボードが作成されたISO形式のタイムスタンプ | +| `created_by` | object | ダッシュボードを作成したユーザー | +| `last_modified_at` | string | ダッシュボードが最後に変更されたISO形式のタイムスタンプ | +| `last_modified_by` | object | ダッシュボードを最後に変更したユーザー | +| `tiles` | array | ダッシュボード上のタイル/ウィジェットとその設定 | +| `filters` | object | ダッシュボードに適用されるグローバルフィルター | +| `tags` | array | ダッシュボードに関連付けられたタグ | +| `restriction_level` | number | ダッシュボードのアクセス制限レベル | + +### `posthog_list_actions` + +PostHogプロジェクト内のすべてのアクションをリストします。アクション定義、ステップ、メタデータを返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | いいえ | PostHogクラウドリージョン:「us」または「eu」(デフォルト:「us」) | +| `limit` | number | いいえ | ページごとに返す結果の数(デフォルト:100) | +| `offset` | number | いいえ | ページネーションのためにスキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `count` | number | プロジェクト内のアクションの総数 | +| `next` | string | 結果の次のページのURL | +| `previous` | string | 結果の前のページのURL | +| `results` | array | 定義とメタデータを含むアクションのリスト | + +### `posthog_list_cohorts` + +PostHogプロジェクト内のすべてのコホートをリストします。コホートの定義、フィルター、ユーザー数を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | いいえ | PostHogクラウドリージョン:「us」または「eu」(デフォルト:「us」) | +| `limit` | number | いいえ | ページごとに返す結果の数(デフォルト:100) | +| `offset` | number | いいえ | ページネーションのためにスキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `count` | number | プロジェクト内のコホートの総数 | +| `next` | string | 次のページの結果のURL | +| `previous` | string | 前のページの結果のURL | +| `results` | array | 定義とメタデータを含むコホートのリスト | + +### `posthog_get_cohort` + +PostHogから特定のコホートをIDで取得します。詳細なコホート定義、フィルター、ユーザー数を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `cohortId` | string | はい | 取得するコホートID | +| `region` | string | いいえ | PostHogクラウドリージョン:「us」または「eu」\(デフォルト:「us」\) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | number | コホートの一意の識別子 | +| `name` | string | コホートの名前 | +| `description` | string | コホートの説明 | +| `groups` | array | コホートを定義するグループ | +| `deleted` | boolean | コホートが削除されているかどうか | +| `filters` | object | コホートのフィルター設定 | +| `query` | object | コホートのクエリ設定 | +| `created_at` | string | コホートが作成されたISO形式のタイムスタンプ | +| `created_by` | object | コホートを作成したユーザー | +| `is_calculating` | boolean | コホートが計算中かどうか | +| `last_calculation` | string | 最後の計算のISO形式のタイムスタンプ | +| `errors_calculating` | number | 計算中のエラー数 | +| `count` | number | コホート内のユーザー数 | +| `is_static` | boolean | コホートが静的かどうか | +| `version` | number | コホートのバージョン番号 | + +### `posthog_create_cohort` + +PostHogで新しいコホートを作成します。コホート名とフィルターまたはクエリ設定が必要です。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | いいえ | PostHogクラウドリージョン: "us"または"eu"(デフォルト: "us") | +| `name` | string | いいえ | コホートの名前(オプション - 提供されない場合、PostHogは「Untitled cohort」を使用します) | +| `description` | string | いいえ | コホートの説明 | +| `filters` | string | いいえ | コホートのフィルター設定のJSON文字列 | +| `query` | string | いいえ | コホートのクエリ設定のJSON文字列 | +| `is_static` | boolean | いいえ | コホートが静的かどうか(デフォルト: false) | +| `groups` | string | いいえ | コホートを定義するグループのJSON文字列 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | number | 作成されたコホートの一意の識別子 | +| `name` | string | コホートの名前 | +| `description` | string | コホートの説明 | +| `groups` | array | コホートを定義するグループ | +| `deleted` | boolean | コホートが削除されているかどうか | +| `filters` | object | コホートのフィルター設定 | +| `query` | object | コホートのクエリ設定 | +| `created_at` | string | コホートが作成されたISO形式のタイムスタンプ | +| `created_by` | object | コホートを作成したユーザー | +| `is_calculating` | boolean | コホートが計算中かどうか | +| `count` | number | コホート内のユーザー数 | +| `is_static` | boolean | コホートが静的かどうか | +| `version` | number | コホートのバージョン番号 | + +### `posthog_list_annotations` + +PostHogプロジェクト内のすべてのアノテーションを一覧表示します。アノテーションの内容、タイムスタンプ、関連するインサイトを返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | いいえ | PostHogクラウドリージョン: "us"または"eu"(デフォルト: "us") | +| `limit` | number | いいえ | ページごとに返す結果の数(デフォルト: 100) | +| `offset` | number | いいえ | ページネーションのためにスキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `count` | number | プロジェクト内のアノテーションの総数 | +| `next` | string | 結果の次のページのURL | +| `previous` | string | 結果の前のページのURL | +| `results` | array | 内容とメタデータを含むアノテーションのリスト | + +### `posthog_create_annotation` + +PostHogに新しいアノテーションを作成します。日付と説明でグラフ上の重要なイベントをマークします。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | いいえ | PostHogクラウドリージョン: "us"または"eu"(デフォルト: "us") | +| `content` | string | はい | アノテーションの内容/テキスト | +| `date_marker` | string | はい | アノテーションが適用される時刻を示すISOタイムスタンプ(例: "2024-01-15T10:00:00Z") | +| `scope` | string | いいえ | アノテーションの範囲: "project"または"dashboard_item"(デフォルト: "project") | +| `dashboard_item` | string | いいえ | このアノテーションを添付するダッシュボードアイテムのID | +| `insight_short_id` | string | いいえ | このアノテーションを添付するインサイトの短いID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | number | 作成されたアノテーションの一意の識別子 | +| `content` | string | アノテーションの内容/テキスト | +| `date_marker` | string | アノテーションが適用される時刻を示すISO形式のタイムスタンプ | +| `created_at` | string | アノテーションが作成された時刻のISO形式のタイムスタンプ | +| `updated_at` | string | アノテーションが最後に更新された時刻のISO形式のタイムスタンプ | +| `created_by` | object | アノテーションを作成したユーザー | +| `dashboard_item` | number | このアノテーションが添付されているダッシュボード項目のID | +| `insight_short_id` | string | このアノテーションが添付されているインサイトの短いID | +| `insight_name` | string | このアノテーションが添付されているインサイトの名前 | +| `scope` | string | アノテーションの範囲(プロジェクトまたはダッシュボード項目) | +| `deleted` | boolean | アノテーションが削除されているかどうか | + +### `posthog_list_feature_flags` + +PostHogプロジェクト内のすべての機能フラグを一覧表示する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | はい | PostHogクラウドリージョン: usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | +| `limit` | number | いいえ | 返す結果の数 | +| `offset` | number | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `results` | array | 機能フラグのリスト | + +### `posthog_get_feature_flag` + +特定の機能フラグの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `flagId` | string | はい | 機能フラグID | +| `region` | string | はい | PostHogクラウドリージョン: usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `flag` | object | 機能フラグの詳細 | + +### `posthog_create_feature_flag` + +PostHogに新しい機能フラグを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | はい | PostHogクラウドリージョン: usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | +| `name` | string | いいえ | 機能フラグ名(オプション - 空でも可) | +| `key` | string | はい | 機能フラグキー(一意の識別子) | +| `filters` | string | いいえ | JSON文字列としての機能フラグフィルター | +| `active` | boolean | いいえ | フラグがアクティブかどうか(デフォルト: true) | +| `ensureExperienceContinuity` | boolean | いいえ | 体験の継続性を確保するかどうか(デフォルト: false) | +| `rolloutPercentage` | number | いいえ | ロールアウト割合(0-100) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `flag` | object | 作成されたフィーチャーフラグ | + +### `posthog_update_feature_flag` + +PostHogの既存のフィーチャーフラグを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `flagId` | string | はい | フィーチャーフラグID | +| `region` | string | はい | PostHogクラウドリージョン:usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | +| `name` | string | いいえ | フィーチャーフラグ名 | +| `key` | string | いいえ | フィーチャーフラグキー(一意の識別子) | +| `filters` | string | いいえ | JSON文字列としてのフィーチャーフラグフィルター | +| `active` | boolean | いいえ | フラグがアクティブかどうか | +| `ensureExperienceContinuity` | boolean | いいえ | 体験の継続性を確保するかどうか | +| `rolloutPercentage` | number | いいえ | ロールアウト割合(0-100) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `flag` | object | 更新されたフィーチャーフラグ | + +### `posthog_delete_feature_flag` + +PostHogからフィーチャーフラグを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `flagId` | string | はい | 削除するフィーチャーフラグID | +| `region` | string | はい | PostHogクラウドリージョン:usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 削除が成功したかどうか | +| `message` | string | 確認メッセージ | + +### `posthog_evaluate_flags` + +特定のユーザーまたはグループに対する機能フラグを評価します。これはプロジェクトAPIキーを使用する公開エンドポイントです。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `region` | string | はい | PostHogクラウドリージョン: usまたはeu | +| `projectApiKey` | string | はい | PostHogプロジェクトAPIキー(個人APIキーではない) | +| `distinctId` | string | はい | フラグを評価するユーザーの固有ID | +| `groups` | string | いいえ | グループをJSON文字列として(例:\{"company": "company_id_in_your_db"\}) | +| `personProperties` | string | いいえ | ユーザープロパティをJSON文字列として | +| `groupProperties` | string | いいえ | グループプロパティをJSON文字列として | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `featureFlags` | object | 機能フラグの評価(キーと値のペアで、値はブールまたは文字列バリアント) | +| `featureFlagPayloads` | object | 機能フラグに添付された追加のペイロード | +| `errorsWhileComputingFlags` | boolean | フラグの計算中にエラーが発生したかどうか | + +### `posthog_list_experiments` + +PostHogプロジェクト内のすべての実験をリストアップします + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | はい | PostHogクラウドリージョン: usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | +| `limit` | number | いいえ | 返す結果の数 | +| `offset` | number | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `results` | array | 実験のリスト | + +### `posthog_get_experiment` + +特定の実験の詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `experimentId` | string | はい | 実験ID | +| `region` | string | はい | PostHogクラウドリージョン: usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `experiment` | object | 実験の詳細 | + +### `posthog_create_experiment` + +PostHogで新しい実験を作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | はい | PostHogクラウドリージョン: usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | +| `name` | string | いいえ | 実験名(オプション) | +| `description` | string | いいえ | 実験の説明 | +| `featureFlagKey` | string | はい | 実験に使用するフィーチャーフラグキー | +| `parameters` | string | いいえ | JSON文字列としての実験パラメータ | +| `filters` | string | いいえ | JSON文字列としての実験フィルター | +| `variants` | string | いいえ | JSON文字列としての実験バリアント | +| `startDate` | string | いいえ | 実験開始日(ISO形式) | +| `endDate` | string | いいえ | 実験終了日(ISO形式) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `experiment` | object | 作成された実験 | + +### `posthog_list_surveys` + +PostHogプロジェクト内のすべてのアンケートを一覧表示します。アンケートを使用すると、ユーザーからフィードバックを収集できます。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | いいえ | PostHogクラウドリージョン: usまたはeu(デフォルト: us) | +| `limit` | number | いいえ | 返す結果の数(デフォルト: 100) | +| `offset` | number | いいえ | ページネーション用にスキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `surveys` | array | プロジェクト内のアンケート一覧 | + +### `posthog_get_survey` + +IDによってPostHogの特定のアンケートの詳細を取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `surveyId` | string | はい | 取得するアンケートID | +| `region` | string | いいえ | PostHogクラウドリージョン: usまたはeu(デフォルト: us) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `survey` | object | アンケートの詳細 | + +### `posthog_create_survey` + +PostHogで新しいアンケートを作成します。対応している質問タイプ:基本(オープン)、リンク、評価、および複数選択。 + +#### 入力 + +| パラメータ | タイプ | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | いいえ | PostHogクラウドリージョン:usまたはeu(デフォルト:us) | +| `name` | string | いいえ | アンケート名(任意) | +| `description` | string | いいえ | アンケートの説明 | +| `type` | string | いいえ | アンケートタイプ:popover(アプリ内)またはapi(カスタム実装)(デフォルト:popover) | +| `questions` | string | はい | アンケート質問の配列のJSON文字列。各質問にはタイプ(open/link/rating/multiple_choice)と質問テキストが必要です。評価質問にはスケール(1-10)、lowerBoundLabel、upperBoundLabelを設定できます。複数選択質問にはchoices配列が必要です。リンク質問にはbuttonTextを設定できます。 | +| `startDate` | string | いいえ | ISO 8601形式のアンケート開始日 | +| `endDate` | string | いいえ | ISO 8601形式のアンケート終了日 | +| `appearance` | string | いいえ | 外観設定(色、位置など)のJSON文字列 | +| `conditions` | string | いいえ | 表示条件(URLマッチングなど)のJSON文字列 | +| `targetingFlagFilters` | string | いいえ | ターゲティング用のフィーチャーフラグフィルターのJSON文字列 | +| `linkedFlagId` | string | いいえ | このアンケートにリンクするフィーチャーフラグID | +| `responsesLimit` | number | いいえ | 収集する回答の最大数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `survey` | object | 作成されたアンケートの詳細 | + +### `posthog_update_survey` + +PostHogの既存のアンケートを更新します。質問、外観、条件、その他の設定を変更できます。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `surveyId` | string | はい | 更新するアンケートID | +| `region` | string | いいえ | PostHogクラウドリージョン: usまたはeu(デフォルト: us) | +| `name` | string | いいえ | アンケート名 | +| `description` | string | いいえ | アンケートの説明 | +| `type` | string | いいえ | アンケートタイプ: popoverまたはapi | +| `questions` | string | いいえ | アンケート質問配列のJSON文字列。各質問にはタイプ(open/link/rating/multiple_choice)と質問テキストが必要です。 | +| `startDate` | string | いいえ | アンケート開始日(ISO 8601形式) | +| `endDate` | string | いいえ | アンケート終了日(ISO 8601形式) | +| `appearance` | string | いいえ | 外観設定のJSON文字列(色、位置など) | +| `conditions` | string | いいえ | 表示条件のJSON文字列(URLマッチングなど) | +| `targetingFlagFilters` | string | いいえ | ターゲティング用のフィーチャーフラグフィルターのJSON文字列 | +| `linkedFlagId` | string | いいえ | このアンケートにリンクするフィーチャーフラグID | +| `responsesLimit` | number | いいえ | 収集する回答の最大数 | +| `archived` | boolean | いいえ | アンケートをアーカイブまたはアーカイブ解除する | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `survey` | object | 更新されたアンケートの詳細 | + +### `posthog_list_session_recordings` + +PostHogプロジェクト内のセッション録画を一覧表示します。セッション録画はアプリケーションとのユーザーインタラクションを記録します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | いいえ | PostHogクラウドリージョン: usまたはeu(デフォルト: us) | +| `limit` | number | いいえ | 返す結果の数(デフォルト: 50) | +| `offset` | number | いいえ | ページネーション用にスキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `recordings` | array | セッション録画のリスト | + +### `posthog_get_session_recording` + +IDによってPostHogの特定のセッション録画の詳細を取得します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `recordingId` | string | はい | 取得するセッション録画ID | +| `region` | string | いいえ | PostHogクラウドリージョン: usまたはeu(デフォルト: us) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `recording` | object | セッション録画の詳細 | + +### `posthog_list_recording_playlists` + +PostHogプロジェクト内のセッション録画プレイリストを一覧表示します。プレイリストを使用すると、セッション録画を整理およびキュレーションできます。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | いいえ | PostHogクラウドリージョン: usまたはeu(デフォルト: us) | +| `limit` | number | いいえ | 返す結果の数(デフォルト: 100) | +| `offset` | number | いいえ | ページネーション用にスキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `playlists` | array | セッション録画プレイリストのリスト | + +### `posthog_list_event_definitions` + +PostHogプロジェクト内のすべてのイベント定義を一覧表示します。イベント定義は、説明、タグ、使用統計などのメタデータを持つ追跡されたイベントを表します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | はい | PostHogクラウドリージョン: usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | +| `limit` | number | いいえ | ページごとに返す結果の数(デフォルト: 100) | +| `offset` | number | いいえ | 結果を返す初期インデックス | +| `search` | string | いいえ | 名前でイベント定義をフィルタリングする検索語 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `count` | number | イベント定義の総数 | +| `next` | string | 次のページの結果のURL | +| `previous` | string | 前のページの結果のURL | +| `results` | array | イベント定義のリスト | + +### `posthog_get_event_definition` + +PostHogの特定のイベント定義の詳細を取得します。メタデータ、使用統計、検証ステータスなど、イベントに関する包括的な情報を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `eventDefinitionId` | string | はい | 取得するイベント定義ID | +| `region` | string | はい | PostHogクラウドリージョン: usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | string | イベント定義の一意の識別子 | +| `name` | string | イベント名 | +| `description` | string | イベントの説明 | +| `tags` | array | イベントに関連付けられたタグ | +| `volume_30_day` | number | 過去30日間に受信したイベントの数 | +| `query_usage_30_day` | number | 過去30日間にこのイベントがクエリされた回数 | +| `created_at` | string | イベントが作成されたISOタイムスタンプ | +| `last_seen_at` | string | イベントが最後に確認されたISOタイムスタンプ | +| `updated_at` | string | イベントが更新されたISOタイムスタンプ | +| `updated_by` | object | イベントを最後に更新したユーザー | +| `verified` | boolean | イベントが検証されているかどうか | +| `verified_at` | string | イベントが検証されたISOタイムスタンプ | +| `verified_by` | string | イベントを検証したユーザー | + +### `posthog_update_event_definition` + +PostHogでイベント定義を更新します。説明、タグ、検証ステータスを変更して、整理されたイベントスキーマを維持できます。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `eventDefinitionId` | string | はい | 更新するイベント定義ID | +| `region` | string | はい | PostHogクラウドリージョン: usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | +| `description` | string | いいえ | イベントの更新された説明 | +| `tags` | string | いいえ | イベントに関連付けるタグのカンマ区切りリスト | +| `verified` | boolean | いいえ | イベントを検証済みとしてマークするかどうか | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | string | イベント定義の一意の識別子 | +| `name` | string | イベント名 | +| `description` | string | 更新されたイベントの説明 | +| `tags` | array | イベントに関連付けられた更新されたタグ | +| `volume_30_day` | number | 過去30日間に受信したイベントの数 | +| `query_usage_30_day` | number | 過去30日間にこのイベントが照会された回数 | +| `created_at` | string | イベントが作成されたISO形式のタイムスタンプ | +| `last_seen_at` | string | イベントが最後に確認されたISO形式のタイムスタンプ | +| `updated_at` | string | イベントが更新されたISO形式のタイムスタンプ | +| `updated_by` | object | イベントを最後に更新したユーザー | +| `verified` | boolean | イベントが検証済みかどうか | +| `verified_at` | string | イベントが検証されたISO形式のタイムスタンプ | +| `verified_by` | string | イベントを検証したユーザー | + +### `posthog_list_property_definitions` + +PostHogプロジェクト内のすべてのプロパティ定義をリストします。プロパティ定義は、説明、タグ、タイプ、使用統計などのメタデータを持つ追跡されたプロパティを表します。 + +#### 入力 + +| パラメータ | タイプ | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `region` | string | はい | PostHogクラウドリージョン: usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | +| `limit` | number | いいえ | ページごとに返す結果の数(デフォルト: 100) | +| `offset` | number | いいえ | 結果を返す初期インデックス | +| `search` | string | いいえ | 名前でプロパティ定義をフィルタリングする検索語 | +| `type` | string | いいえ | プロパティタイプでフィルタリング: event、person、またはgroup | + +#### 出力 + +| パラメータ | タイプ | 説明 | +| --------- | ---- | ----------- | +| `count` | number | プロパティ定義の総数 | +| `next` | string | 結果の次のページのURL | +| `previous` | string | 結果の前のページのURL | +| `results` | array | プロパティ定義のリスト | + +### `posthog_get_property_definition` + +PostHogの特定のプロパティ定義の詳細を取得します。メタデータ、タイプ、使用統計、検証ステータスなど、プロパティに関する包括的な情報を返します。 + +#### 入力 + +| パラメータ | タイプ | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `propertyDefinitionId` | string | はい | 取得するプロパティ定義ID | +| `region` | string | はい | PostHogクラウドリージョン: usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | string | プロパティ定義の一意識別子 | +| `name` | string | プロパティ名 | +| `description` | string | プロパティの説明 | +| `tags` | array | プロパティに関連付けられたタグ | +| `is_numerical` | boolean | プロパティが数値かどうか | +| `is_seen_on_filtered_events` | boolean | プロパティがフィルタリングされたイベントで表示されるかどうか | +| `property_type` | string | プロパティのデータ型 | +| `type` | string | プロパティタイプ:イベント、人物、またはグループ | +| `volume_30_day` | number | 過去30日間にプロパティが表示された回数 | +| `query_usage_30_day` | number | 過去30日間にこのプロパティが照会された回数 | +| `created_at` | string | プロパティが作成されたときのISO形式のタイムスタンプ | +| `updated_at` | string | プロパティが更新されたときのISO形式のタイムスタンプ | +| `updated_by` | object | プロパティを最後に更新したユーザー | +| `verified` | boolean | プロパティが検証済みかどうか | +| `verified_at` | string | プロパティが検証されたときのISO形式のタイムスタンプ | +| `verified_by` | string | プロパティを検証したユーザー | +| `example` | string | プロパティのサンプル値 | + +### `posthog_update_property_definition` + +PostHogでプロパティ定義を更新します。説明、タグ、プロパティタイプ、検証ステータスを変更して、整理されたプロパティスキーマを維持できます。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | PostHogプロジェクトID | +| `propertyDefinitionId` | string | はい | 更新するプロパティ定義ID | +| `region` | string | はい | PostHogクラウドリージョン:usまたはeu | +| `apiKey` | string | はい | PostHog個人APIキー | +| `description` | string | いいえ | プロパティの更新された説明 | +| `tags` | string | いいえ | プロパティに関連付けるタグのカンマ区切りリスト | +| `verified` | boolean | いいえ | プロパティを検証済みとしてマークするかどうか | +| `property_type` | string | いいえ | プロパティのデータ型(例:String、Numeric、Boolean、DateTimeなど) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `id` | string | プロパティ定義の一意識別子 | +| `name` | string | プロパティ名 | +| `description` | string | 更新されたプロパティの説明 | +| `tags` | array | プロパティに関連付けられた更新済みタグ | +| `is_numerical` | boolean | プロパティが数値かどうか | +| `is_seen_on_filtered_events` | boolean | プロパティがフィルタリングされたイベントで表示されるかどうか | +| `property_type` | string | プロパティのデータ型 | +| `type` | string | プロパティタイプ:イベント、人物、またはグループ | +| `volume_30_day` | number | 過去30日間にプロパティが表示された回数 | +| `query_usage_30_day` | number | 過去30日間にこのプロパティが照会された回数 | +| `created_at` | string | プロパティが作成されたときのISO形式のタイムスタンプ | +| `updated_at` | string | プロパティが更新されたときのISO形式のタイムスタンプ | +| `updated_by` | object | プロパティを最後に更新したユーザー | +| `verified` | boolean | プロパティが検証されているかどうか | +| `verified_at` | string | プロパティが検証されたときのISO形式のタイムスタンプ | +| `verified_by` | string | プロパティを検証したユーザー | +| `example` | string | プロパティのサンプル値 | + +### `posthog_list_projects` + +組織内のすべてのプロジェクトを一覧表示します。ID、名前、APIトークン、設定などのプロジェクト詳細を返します。他のエンドポイントで必要なプロジェクトIDを取得するのに役立ちます。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `region` | string | いいえ | クラウドリージョン: usまたはeu(デフォルト: us) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `projects` | array | 設定と設定を含むプロジェクトのリスト | + +### `posthog_get_project` + +IDで特定のプロジェクトに関する詳細情報を取得します。プロジェクトの包括的な設定、設定、機能フラグを返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | はい | プロジェクトID(数値IDまたはUUID) | +| `apiKey` | string | はい | PostHog個人APIキー | +| `region` | string | いいえ | クラウドリージョン: usまたはeu(デフォルト: us) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `project` | object | すべての設定を含む詳細なプロジェクト情報 | + +### `posthog_list_organizations` + +ユーザーがアクセスできるすべての組織をリストします。組織名、スラグ、メンバーシップレベル、利用可能な製品機能など、組織の詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | PostHog個人APIキー | +| `region` | string | いいえ | クラウドリージョン: usまたはeu(デフォルト: us) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `organizations` | array | 設定と機能を含む組織のリスト | + +### `posthog_get_organization` + +IDによって特定の組織に関する詳細情報を取得します。包括的な組織設定、機能、使用状況、チーム情報を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `organizationId` | string | はい | 組織ID(UUID) | +| `apiKey` | string | はい | PostHog個人APIキー | +| `region` | string | いいえ | クラウドリージョン:usまたはeu(デフォルト:us) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `organization` | object | 設定と機能を含む詳細な組織情報 | + +## 注意事項 + +- カテゴリ: `tools` +- タイプ: `posthog` diff --git a/apps/docs/content/docs/ja/tools/sentry.mdx b/apps/docs/content/docs/ja/tools/sentry.mdx new file mode 100644 index 0000000000..94d8958074 --- /dev/null +++ b/apps/docs/content/docs/ja/tools/sentry.mdx @@ -0,0 +1,305 @@ +--- +title: Sentry +description: Sentryの問題、プロジェクト、イベント、リリースを管理 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Sentry](https://sentry.io/)でエラー監視とアプリケーションの信頼性を強化しましょう — リアルタイムエラー追跡、パフォーマンス監視、リリース管理のための業界をリードするプラットフォームです。Sentryを自動化エージェントワークフローにシームレスに統合して、問題の監視、重要なイベントの追跡、プロジェクトの管理、およびすべてのアプリケーションとサービス全体でのリリースの調整を簡単に行うことができます。 + +Sentryツールを使用すると、以下のことが可能です: + +- **問題の監視とトリアージ**: `sentry_issues_list` 操作を使用して問題の包括的なリストを取得し、`sentry_issues_get` を通じて個々のエラーやバグに関する詳細情報を取得できます。メタデータ、タグ、スタックトレース、統計情報に即座にアクセスして、解決までの平均時間を短縮します。 +- **イベントデータの追跡**: `sentry_events_list` と `sentry_events_get` を使用して特定のエラーとイベントインスタンスを分析し、エラーの発生とユーザーへの影響に関する深い洞察を提供します。 +- **プロジェクトとチームの管理**: `sentry_projects_list` と `sentry_project_get` を使用してすべてのSentryプロジェクトを列挙・確認し、チームのコラボレーションと一元化された構成を確保します。 +- **リリースの調整**: `sentry_releases_list`、`sentry_release_get` などの操作を使用して、コードベース全体でのバージョン追跡、デプロイメントの健全性、変更管理を自動化します。 +- **強力なアプリケーションインサイトの獲得**: 高度なフィルターとクエリを活用して、未解決または優先度の高い問題を見つけ、時間の経過に伴うイベント統計を集計し、コードベースの進化に伴う回帰を追跡します。 + +Sentryの統合により、エンジニアリングチームとDevOpsチームは早期に問題を検出し、最も影響の大きいバグに優先順位を付け、開発スタック全体でアプリケーションの健全性を継続的に改善することができます。最新の可観測性、インシデント対応、リリースライフサイクル管理のためのワークフロー自動化をプログラムで調整し、ダウンタイムを削減してユーザー満足度を向上させます。 + +**利用可能な主要なSentry操作**: +- `sentry_issues_list`: 組織やプロジェクトのSentry課題を一覧表示し、強力な検索とフィルタリング機能を提供します。 +- `sentry_issues_get`: 特定のSentry課題に関する詳細情報を取得します。 +- `sentry_events_list`: 根本原因分析のために特定の課題に関連するイベントを列挙します。 +- `sentry_events_get`: スタックトレース、コンテキスト、メタデータを含む個別イベントの詳細情報を取得します。 +- `sentry_projects_list`: 組織内のすべてのSentryプロジェクトを一覧表示します。 +- `sentry_project_get`: 特定のプロジェクトの設定と詳細を取得します。 +- `sentry_releases_list`: 最近のリリースとそのデプロイメント状況を一覧表示します。 +- `sentry_release_get`: 関連するコミットと課題を含む詳細なリリース情報を取得します。 + +アプリの健全性を積極的に管理する場合でも、本番環境のエラーをトラブルシューティングする場合でも、リリースワークフローを自動化する場合でも、Sentryは世界クラスの監視、実用的なアラート、シームレスなDevOps統合を提供します。エージェントワークフローから、エラー追跡、可観測性、リリース管理にSentryを活用することで、ソフトウェアの品質と検索の可視性を向上させましょう。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +Sentryをワークフローに統合します。アプリケーション全体で課題の監視、プロジェクト管理、イベント追跡、リリース調整を行います。 + +## ツール + +### `sentry_issues_list` + +特定の組織、およびオプションで特定のプロジェクトのSentryから課題を一覧表示します。ステータス、エラー数、最終確認タイムスタンプなどの課題の詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Sentry API認証トークン | +| `organizationSlug` | string | はい | 組織のスラグ | +| `projectSlug` | string | いいえ | 特定のプロジェクトスラグで課題をフィルタリング(オプション) | +| `query` | string | いいえ | 課題をフィルタリングする検索クエリ。Sentryの検索構文をサポート(例:「is:unresolved」、「level:error」) | +| `statsPeriod` | string | いいえ | 統計の期間(例:「24h」、「7d」、「30d」)。指定されない場合は24hがデフォルト | +| `cursor` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル | +| `limit` | number | いいえ | ページごとに返す課題の数(デフォルト:25、最大:100) | +| `status` | string | いいえ | 課題のステータスでフィルタリング:unresolved、resolved、ignored、またはmuted | +| `sort` | string | いいえ | ソート順:date、new、freq、priority、またはuser(デフォルト:date) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `issues` | array | Sentryの問題一覧 | + +### `sentry_issues_get` + +IDによって特定のSentry問題に関する詳細情報を取得します。メタデータ、タグ、統計情報を含む問題の完全な詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Sentry API認証トークン | +| `organizationSlug` | string | はい | 組織のスラグ | +| `issueId` | string | はい | 取得する問題の一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `issue` | object | Sentryの問題に関する詳細情報 | + +### `sentry_issues_update` + +ステータス、割り当て、ブックマーク状態、またはその他のプロパティを変更することでSentryの問題を更新します。更新された問題の詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Sentry API認証トークン | +| `organizationSlug` | string | はい | 組織のスラグ | +| `issueId` | string | はい | 更新する問題の一意のID | +| `status` | string | いいえ | 問題の新しいステータス:resolved、unresolved、ignored、またはresolvedInNextRelease | +| `assignedTo` | string | いいえ | 問題を割り当てるユーザーIDまたはメール。割り当てを解除するには空の文字列を使用します。 | +| `isBookmarked` | boolean | いいえ | 問題をブックマークするかどうか | +| `isSubscribed` | boolean | いいえ | 問題の更新を購読するかどうか | +| `isPublic` | boolean | いいえ | 問題を公開表示するかどうか | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `issue` | object | 更新されたSentryの課題 | + +### `sentry_projects_list` + +Sentryの組織内のすべてのプロジェクトを一覧表示します。名前、プラットフォーム、チーム、設定などのプロジェクト詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Sentry API認証トークン | +| `organizationSlug` | string | はい | 組織のスラグ | +| `cursor` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル | +| `limit` | number | いいえ | ページごとに返すプロジェクト数(デフォルト:25、最大:100) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `projects` | array | Sentryプロジェクトのリスト | + +### `sentry_projects_get` + +スラグによって特定のSentryプロジェクトに関する詳細情報を取得します。チーム、機能、設定を含むプロジェクトの完全な詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Sentry API認証トークン | +| `organizationSlug` | string | はい | 組織のスラグ | +| `projectSlug` | string | はい | 取得するプロジェクトのIDまたはスラグ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `project` | object | Sentryプロジェクトに関する詳細情報 | + +### `sentry_projects_create` + +組織内に新しいSentryプロジェクトを作成します。プロジェクトを関連付けるチームが必要です。作成されたプロジェクトの詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Sentry API認証トークン | +| `organizationSlug` | string | はい | 組織のスラッグ | +| `name` | string | はい | プロジェクトの名前 | +| `teamSlug` | string | はい | このプロジェクトを所有するチームのスラッグ | +| `slug` | string | いいえ | URL用のプロジェクト識別子(提供されない場合は名前から自動生成されます) | +| `platform` | string | いいえ | プロジェクトのプラットフォーム/言語(例:javascript、python、node、react-native)。指定されない場合、デフォルトは"other"になります | +| `defaultRules` | boolean | いいえ | デフォルトのアラートルールを作成するかどうか(デフォルト:true) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `project` | object | 新しく作成されたSentryプロジェクト | + +### `sentry_projects_update` + +名前、スラッグ、プラットフォームなどの設定を変更して、Sentryプロジェクトを更新します。更新されたプロジェクトの詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Sentry API認証トークン | +| `organizationSlug` | string | はい | 組織のスラッグ | +| `projectSlug` | string | はい | 更新するプロジェクトのスラッグ | +| `name` | string | いいえ | プロジェクトの新しい名前 | +| `slug` | string | いいえ | 新しいURL用のプロジェクト識別子 | +| `platform` | string | いいえ | プロジェクトの新しいプラットフォーム/言語(例:javascript、python、node) | +| `isBookmarked` | boolean | いいえ | プロジェクトをブックマークするかどうか | +| `digestsMinDelay` | number | いいえ | ダイジェスト通知の最小遅延(秒単位) | +| `digestsMaxDelay` | number | いいえ | ダイジェスト通知の最大遅延(秒単位) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `project` | object | 更新されたSentryプロジェクト | + +### `sentry_events_list` + +Sentryプロジェクトからイベントを一覧表示します。課題ID、クエリ、または期間でフィルタリングできます。コンテキスト、タグ、ユーザー情報などのイベント詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Sentry API認証トークン | +| `organizationSlug` | string | はい | 組織のスラグ | +| `projectSlug` | string | はい | イベントを一覧表示するプロジェクトのスラグ | +| `issueId` | string | いいえ | 特定の課題IDでイベントをフィルタリング | +| `query` | string | いいえ | イベントをフィルタリングする検索クエリ。Sentryの検索構文をサポート(例:"user.email:*@example.com") | +| `cursor` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル | +| `limit` | number | いいえ | ページごとに返すイベントの数(デフォルト:50、最大:100) | +| `statsPeriod` | string | いいえ | クエリの期間(例:"24h"、"7d"、"30d")。指定されない場合、デフォルトは90d | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `events` | array | Sentryイベントのリスト | + +### `sentry_events_get` + +IDによって特定のSentryイベントの詳細情報を取得します。スタックトレース、パンくずリスト、コンテキスト、ユーザー情報などの完全なイベント詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Sentry API認証トークン | +| `organizationSlug` | string | はい | 組織のスラグ | +| `projectSlug` | string | はい | プロジェクトのスラグ | +| `eventId` | string | はい | 取得するイベントの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `event` | object | Sentryイベントに関する詳細情報 | + +### `sentry_releases_list` + +Sentryの組織またはプロジェクトのリリース一覧を取得します。バージョン、コミット、デプロイ情報、関連プロジェクトなどのリリース詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Sentry API認証トークン | +| `organizationSlug` | string | はい | 組織のスラグ | +| `projectSlug` | string | いいえ | 特定のプロジェクトスラグでリリースをフィルタリング(オプション) | +| `query` | string | いいえ | リリースをフィルタリングする検索クエリ(例:バージョン名パターン) | +| `cursor` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル | +| `limit` | number | いいえ | ページごとに返すリリース数(デフォルト:25、最大:100) | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `releases` | array | Sentryリリースのリスト | + +### `sentry_releases_create` + +Sentryで新しいリリースを作成します。リリースとは、環境にデプロイされたコードのバージョンです。コミット情報や関連プロジェクトを含めることができます。作成されたリリースの詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Sentry API認証トークン | +| `organizationSlug` | string | はい | 組織のスラッグ | +| `version` | string | はい | リリースのバージョン識別子(例:"2.0.0"、"my-app@1.0.0"、またはgitコミットSHA) | +| `projects` | string | はい | このリリースに関連付けるプロジェクトスラッグのカンマ区切りリスト | +| `ref` | string | いいえ | このリリースのGitリファレンス(コミットSHA、タグ、またはブランチ) | +| `url` | string | いいえ | リリースを指すURL(例:GitHubリリースページ) | +| `dateReleased` | string | いいえ | リリースがデプロイされた日時のISO 8601タイムスタンプ(デフォルトは現在時刻) | +| `commits` | string | いいえ | id、repository(オプション)、message(オプション)を持つコミットオブジェクトのJSON配列。例:\[\{"id":"abc123","message":"Fix bug"\}\] | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `release` | object | 新しく作成されたSentryリリース | + +### `sentry_releases_deploy` + +特定の環境でSentryリリースのデプロイ記録を作成します。デプロイは、リリースがいつどこにデプロイされたかを追跡します。作成されたデプロイの詳細を返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | Sentry API認証トークン | +| `organizationSlug` | string | はい | 組織のスラグ | +| `version` | string | はい | デプロイされるリリースのバージョン識別子 | +| `environment` | string | はい | リリースがデプロイされる環境名(例:"production"、"staging") | +| `name` | string | いいえ | このデプロイのオプション名(例:"Deploy v2.0 to Production") | +| `url` | string | いいえ | デプロイを指すURL(例:CI/CDパイプラインURL) | +| `dateStarted` | string | いいえ | デプロイが開始された時刻のISO 8601タイムスタンプ(デフォルトは現在時刻) | +| `dateFinished` | string | いいえ | デプロイが完了した時刻のISO 8601タイムスタンプ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `deploy` | object | 新しく作成されたデプロイレコード | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `sentry` diff --git a/apps/docs/content/docs/zh/blocks/agent.mdx b/apps/docs/content/docs/zh/blocks/agent.mdx index 4e2fd9d786..97aafe251d 100644 --- a/apps/docs/content/docs/zh/blocks/agent.mdx +++ b/apps/docs/content/docs/zh/blocks/agent.mdx @@ -42,11 +42,11 @@ When responding to questions about investments, include risk disclaimers. 代理模块通过统一的推理接口支持多个 LLM 提供商。可用模型包括: -- **OpenAI**:GPT-5.1、GPT-5、GPT-4o、o1、o3、o4-mini、gpt-4.1 -- **Anthropic**:Claude 4.5 Sonnet、Claude Opus 4.1 -- **Google**:Gemini 2.5 Pro、Gemini 2.0 Flash -- **其他提供商**:Groq、Cerebras、xAI、Azure OpenAI、OpenRouter -- **本地模型**:兼容 Ollama 的模型 +- **OpenAI**: GPT-5.1、GPT-5、GPT-4o、o1、o3、o4-mini、gpt-4.1 +- **Anthropic**: Claude 4.5 Sonnet、Claude Opus 4.1 +- **Google**: Gemini 2.5 Pro、Gemini 2.0 Flash +- **其他提供商**: Groq、Cerebras、xAI、Azure OpenAI、OpenRouter +- **本地模型**: 兼容 Ollama 或 VLLM 的模型 ### 温度 diff --git a/apps/docs/content/docs/zh/blocks/evaluator.mdx b/apps/docs/content/docs/zh/blocks/evaluator.mdx index 99371432a3..3fcb8e4bd1 100644 --- a/apps/docs/content/docs/zh/blocks/evaluator.mdx +++ b/apps/docs/content/docs/zh/blocks/evaluator.mdx @@ -48,11 +48,11 @@ Relevance (1-5): How relevant is the content to the original query? 选择一个 AI 模型来执行评估: -- **OpenAI**:GPT-4o, o1, o3, o4-mini, gpt-4.1 +- **OpenAI**:GPT-4o、o1、o3、o4-mini、gpt-4.1 - **Anthropic**:Claude 3.7 Sonnet -- **Google**:Gemini 2.5 Pro, Gemini 2.0 Flash -- **其他提供商**:Groq, Cerebras, xAI, DeepSeek -- **本地模型**:支持 Ollama 的模型 +- **Google**:Gemini 2.5 Pro、Gemini 2.0 Flash +- **其他提供商**:Groq、Cerebras、xAI、DeepSeek +- **本地模型**:兼容 Ollama 或 VLLM 的模型 使用具有强大推理能力的模型,例如 GPT-4o 或 Claude 3.7 Sonnet,以获得最佳效果。 diff --git a/apps/docs/content/docs/zh/blocks/guardrails.mdx b/apps/docs/content/docs/zh/blocks/guardrails.mdx index c36ade2032..76871f884d 100644 --- a/apps/docs/content/docs/zh/blocks/guardrails.mdx +++ b/apps/docs/content/docs/zh/blocks/guardrails.mdx @@ -65,8 +65,8 @@ Guardrails 模块通过针对多种验证类型检查内容,验证并保护您 **配置:** - **知识库**:从现有知识库中选择 - **模型**:选择用于评分的 LLM(需要强推理能力 - 推荐 GPT-4o、Claude 3.7 Sonnet) -- **API 密钥**:所选 LLM 提供商的身份验证(托管/Ollama 模型自动隐藏) -- **置信阈值**:通过的最低评分(0-10,默认值:3) +- **API 密钥**:所选 LLM 提供商的身份验证(对于托管/Ollama 或 VLLM 兼容模型会自动隐藏) +- **置信度阈值**:通过的最低分数(0-10,默认值:3) - **Top K**(高级):要检索的知识库块数量(默认值:10) **输出:** diff --git a/apps/docs/content/docs/zh/blocks/router.mdx b/apps/docs/content/docs/zh/blocks/router.mdx index a18dac5415..e7162fe3eb 100644 --- a/apps/docs/content/docs/zh/blocks/router.mdx +++ b/apps/docs/content/docs/zh/blocks/router.mdx @@ -52,11 +52,11 @@ Router 可以选择的目标块。Router 会自动检测连接的块,但您也 选择一个 AI 模型来支持路由决策: -- **OpenAI**:GPT-4o, o1, o3, o4-mini, gpt-4.1 +- **OpenAI**:GPT-4o、o1、o3、o4-mini、gpt-4.1 - **Anthropic**:Claude 3.7 Sonnet -- **Google**:Gemini 2.5 Pro, Gemini 2.0 Flash -- **其他提供商**:Groq, Cerebras, xAI, DeepSeek -- **本地模型**:兼容 Ollama 的模型 +- **Google**:Gemini 2.5 Pro、Gemini 2.0 Flash +- **其他提供商**:Groq、Cerebras、xAI、DeepSeek +- **本地模型**:兼容 Ollama 或 VLLM 的模型 使用具有强大推理能力的模型,例如 GPT-4o 或 Claude 3.7 Sonnet,以获得最佳效果。 diff --git a/apps/docs/content/docs/zh/execution/costs.mdx b/apps/docs/content/docs/zh/execution/costs.mdx index a5814347ab..af3108aaf4 100644 --- a/apps/docs/content/docs/zh/execution/costs.mdx +++ b/apps/docs/content/docs/zh/execution/costs.mdx @@ -47,9 +47,9 @@ totalCost = baseExecutionCharge + modelCost ## 定价选项 - + - **托管模型** - Sim 提供 API 密钥,价格有 2.5 倍的加成: + **托管模型** - Sim 提供的 API 密钥价格为基础价格的 2.5 倍: | 模型 | 基础价格(输入/输出) | 托管价格(输入/输出) | |-------|---------------------------|----------------------------| @@ -60,11 +60,11 @@ totalCost = baseExecutionCharge + modelCost | Claude 3.5 Sonnet | $3.00 / $15.00 | $7.50 / $37.50 | | Claude Opus 4.0 | $15.00 / $75.00 | $37.50 / $187.50 | - *2.5 倍加成覆盖了基础设施和 API 管理成本。* + *2.5 倍的价格倍增用于覆盖基础设施和 API 管理成本。* - **自带 API 密钥** - 使用任何模型按基础价格计费: + **使用您自己的 API 密钥** - 以基础价格使用任何模型: | 提供商 | 模型 | 输入 / 输出 | |----------|---------|----------------| @@ -74,8 +74,9 @@ totalCost = baseExecutionCharge + modelCost | Groq | Llama 4 Scout | $0.40 / $0.60 | | Cerebras | Llama 3.3 70B | $0.94 / $0.94 | | Ollama | 本地模型 | 免费 | + | VLLM | 本地模型 | 免费 | - *直接向提供商支付,无额外加成* + *直接向提供商支付,无额外加价* @@ -86,8 +87,8 @@ totalCost = baseExecutionCharge + modelCost ## 成本优化策略 - **模型选择**:根据任务复杂性选择模型。简单任务可以使用 GPT-4.1-nano,而复杂推理可能需要 o1 或 Claude Opus。 -- **提示工程**:结构良好、简洁的提示可以在不牺牲质量的情况下减少 token 的使用。 -- **本地模型**:对于非关键任务,使用 Ollama 可以完全消除 API 成本。 +- **提示工程**:结构良好、简洁的提示可以减少令牌使用,同时保持质量。 +- **本地模型**:对于非关键任务,使用 Ollama 或 VLLM 来完全消除 API 成本。 - **缓存和重用**:将经常使用的结果存储在变量或文件中,以避免重复调用 AI 模型。 - **批量处理**:在单次 AI 请求中处理多个项目,而不是逐一调用。 diff --git a/apps/docs/content/docs/zh/introduction/index.mdx b/apps/docs/content/docs/zh/introduction/index.mdx index ca87c4bc49..e1443b7953 100644 --- a/apps/docs/content/docs/zh/introduction/index.mdx +++ b/apps/docs/content/docs/zh/introduction/index.mdx @@ -59,11 +59,11 @@ Sim 是一个开源的可视化工作流构建器,用于构建和部署 AI 代 Sim 提供了跨多个类别的 80 多种服务的原生集成: -- **AI 模型**:OpenAI、Anthropic、Google Gemini、Groq、Cerebras、本地模型(通过 Ollama) +- **AI 模型**:OpenAI、Anthropic、Google Gemini、Groq、Cerebras、本地模型(通过 Ollama 或 VLLM) - **通信**:Gmail、Slack、Microsoft Teams、Telegram、WhatsApp - **生产力**:Notion、Google Workspace、Airtable、Monday.com - **开发**:GitHub、Jira、Linear、自动化浏览器测试 -- **搜索与数据**:Google Search、Perplexity、Firecrawl、Exa AI +- **搜索与数据**:Google 搜索、Perplexity、Firecrawl、Exa AI - **数据库**:PostgreSQL、MySQL、Supabase、Pinecone、Qdrant 对于自定义集成,请利用我们的 [MCP(模型上下文协议)支持](/mcp) 来连接任何外部服务或工具。 diff --git a/apps/docs/content/docs/zh/tools/incidentio.mdx b/apps/docs/content/docs/zh/tools/incidentio.mdx new file mode 100644 index 0000000000..3385a01036 --- /dev/null +++ b/apps/docs/content/docs/zh/tools/incidentio.mdx @@ -0,0 +1,841 @@ +--- +title: incidentio +description: 使用 incident.io 管理事件 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +通过 [incident.io](https://incident.io) 提升您的事件管理能力 —— 这是一个领先的平台,可用于协调事件、简化响应流程,并在一个地方跟踪行动项。将 incident.io 无缝集成到您的自动化工作流程中,掌控事件创建、实时协作、后续跟进、排程、升级等诸多功能。 + +使用 incident.io 工具,您可以: + +- **列出和搜索事件**:快速检索正在进行或历史事件的列表,包含严重性、状态和时间戳等元数据,使用 `incidentio_incidents_list`。 +- **创建新事件**:通过 `incidentio_incidents_create` 以编程方式触发新事件的创建,指定严重性、名称、类型和自定义详细信息,确保您的响应不会被延误。 +- **自动化事件后续**:利用 incident.io 强大的自动化功能,确保重要的行动项和经验教训不会被遗漏,帮助团队解决问题并改进流程。 +- **自定义工作流程**:集成定制的事件类型、严重性和适合您组织需求的自定义字段。 +- **通过排程和升级实施最佳实践**:通过自动分配、通知和升级来简化值班和事件管理,适应不断变化的情况。 + +incident.io 赋能现代组织更快响应、协调团队并捕获经验教训以实现持续改进。无论您管理的是 SRE、DevOps、安全还是 IT 事件,incident.io 都能以编程方式将集中化的顶级事件响应集成到您的代理工作流程中。 + +**可用的关键操作**: +- `incidentio_incidents_list`:列出、分页和筛选事件,提供完整的详细信息。 +- `incidentio_incidents_create`:以编程方式打开具有自定义属性的新事件,并控制重复(幂等性)。 +- ...更多功能即将推出! + +通过将 incident.io 集成到您的工作流程自动化中,提升您的可靠性、责任感和运营卓越性,立即行动吧。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 incident.io 集成到工作流程中。管理事件、操作、后续任务、工作流程、日程安排、升级、自定义字段等。 + +## 工具 + +### `incidentio_incidents_list` + +从 incident.io 列出事件。返回包含事件详细信息的列表,包括严重性、状态和时间戳。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `page_size` | number | 否 | 每页返回的事件数量 \(默认值:25\) | +| `after` | string | 否 | 用于获取下一页结果的分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `incidents` | array | 事件列表 | + +### `incidentio_incidents_create` + +在 incident.io 中创建一个新事件。需要 idempotency_key、severity_id 和 visibility。可选接受名称、摘要、类型和状态。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `idempotency_key` | string | 是 | 用于防止重复创建事件的唯一标识符。使用 UUID 或唯一字符串。 | +| `name` | string | 否 | 事件名称 \(可选\) | +| `summary` | string | 否 | 事件的简要摘要 | +| `severity_id` | string | 是 | 严重性级别的 ID \(必需\) | +| `incident_type_id` | string | 否 | 事件类型的 ID | +| `incident_status_id` | string | 否 | 初始事件状态的 ID | +| `visibility` | string | 是 | 事件的可见性:"public" 或 "private" \(必需\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `incident` | object | 创建的事件对象 | + +### `incidentio_incidents_show` + +从 incident.io 根据其 ID 检索特定事件的详细信息。返回完整的事件详细信息,包括自定义字段和角色分配。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 要检索的事件 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `incident` | object | 详细的事件信息 | + +### `incidentio_incidents_update` + +更新 incident.io 中的现有事件。可以更新名称、摘要、严重性、状态或类型。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 要更新的事件 ID | +| `name` | string | 否 | 更新后的事件名称 | +| `summary` | string | 否 | 更新后的事件摘要 | +| `severity_id` | string | 否 | 更新后的事件严重性 ID | +| `incident_status_id` | string | 否 | 更新后的事件状态 ID | +| `incident_type_id` | string | 否 | 更新后的事件类型 ID | +| `notify_incident_channel` | boolean | 是 | 是否通知事件频道关于此更新 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `incident` | object | 更新后的事件对象 | + +### `incidentio_actions_list` + +从 incident.io 列出操作。可选择按事件 ID 进行筛选。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `incident_id` | string | 否 | 按事件 ID 筛选操作 | +| `page_size` | number | 否 | 每页返回的操作数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `actions` | array | 操作列表 | + +### `incidentio_actions_show` + +从 incident.io 获取有关特定操作的详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 操作 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `action` | object | 操作详情 | + +### `incidentio_follow_ups_list` + +从 incident.io 列出后续操作。可选择按事件 ID 进行筛选。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `incident_id` | string | 否 | 按事件 ID 筛选后续操作 | +| `page_size` | number | 否 | 每页返回的后续操作数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `follow_ups` | 数组 | 跟进列表 | + +### `incidentio_follow_ups_show` + +获取有关 incident.io 中特定跟进的详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | 字符串 | 是 | incident.io API 密钥 | +| `id` | 字符串 | 是 | 跟进 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `follow_up` | 对象 | 跟进详情 | + +### `incidentio_users_list` + +列出 Incident.io 工作区中的所有用户。返回的用户详细信息包括 ID、姓名、电子邮件和角色。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | 字符串 | 是 | Incident.io API 密钥 | +| `page_size` | 数字 | 否 | 每页返回的结果数量 \(默认值: 25\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `users` | 数组 | 工作区中的用户列表 | + +### `incidentio_users_show` + +通过用户 ID 获取 Incident.io 工作区中特定用户的详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | 字符串 | 是 | Incident.io API 密钥 | +| `id` | 字符串 | 是 | 要检索的用户的唯一标识符 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `user` | object | 请求用户的详细信息 | + +### `incidentio_workflows_list` + +列出 incident.io 工作区中的所有工作流。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `page_size` | number | 否 | 每页返回的工作流数量 | +| `after` | string | 否 | 用于获取下一页结果的分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `workflows` | array | 工作流列表 | + +### `incidentio_workflows_show` + +获取 incident.io 中特定工作流的详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 要检索的工作流 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `workflow` | object | 工作流详细信息 | + +### `incidentio_workflows_update` + +更新 incident.io 中的现有工作流。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 要更新的工作流 ID | +| `name` | string | 否 | 工作流的新名称 | +| `state` | string | 否 | 工作流的新状态 \(active, draft, 或 disabled\) | +| `folder` | string | 否 | 工作流的新文件夹 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `workflow` | object | 更新后的工作流 | + +### `incidentio_workflows_delete` + +删除 incident.io 中的一个工作流。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 要删除的工作流的 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `message` | string | 成功消息 | + +### `incidentio_schedules_list` + +列出 incident.io 中的所有日程 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `page_size` | number | 否 | 每页结果数量 \(默认值: 25\) | +| `after` | string | 否 | 用于获取下一页结果的分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `schedules` | array | 日程列表 | + +### `incidentio_schedules_create` + +在 incident.io 中创建一个新日程 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `name` | string | 是 | 日程名称 | +| `timezone` | string | 是 | 日程的时区 \(例如: America/New_York\) | +| `config` | string | 是 | 以 JSON 字符串形式表示的日程配置,包括轮换。例如: \{"rotations": \[\{"name": "Primary", "users": \[\{"id": "user_id"\}\], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": \[\{"interval": 1, "interval_type": "weekly"\}\]\}\]\} | +| `Example` | string | 否 | 无描述 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `schedule` | object | 创建的日程 | + +### `incidentio_schedules_show` + +获取 incident.io 中特定日程的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 日程的 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `schedule` | object | 日程详情 | + +### `incidentio_schedules_update` + +更新 incident.io 中的现有日程 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 要更新的日程 ID | +| `name` | string | 否 | 日程的新名称 | +| `timezone` | string | 否 | 日程的新时区 \(例如,America/New_York\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `schedule` | object | 更新后的日程 | + +### `incidentio_schedules_delete` + +删除 incident.io 中的日程 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 要删除的日程 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `message` | string | 成功消息 | + +### `incidentio_escalations_list` + +列出 incident.io 中的所有升级策略 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `page_size` | number | 否 | 每页结果数量 \(默认值: 25\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `escalations` | array | 升级策略列表 | + +### `incidentio_escalations_create` + +在 incident.io 中创建一个新的升级策略 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `idempotency_key` | string | 是 | 用于防止重复创建升级的唯一标识符。使用 UUID 或唯一字符串。 | +| `title` | string | 是 | 升级的标题 | +| `escalation_path_id` | string | 否 | 要使用的升级路径的 ID \(如果未提供 user_ids,则必需\) | +| `user_ids` | string | 否 | 要通知的用户 ID 的逗号分隔列表 \(如果未提供 escalation_path_id,则必需\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `escalation` | object | 创建的升级策略 | + +### `incidentio_escalations_show` + +获取 incident.io 中特定升级策略的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 升级策略的 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `escalation` | object | 升级策略详情 | + +### `incidentio_custom_fields_list` + +列出 incident.io 中的所有自定义字段。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `custom_fields` | array | 自定义字段列表 | + +### `incidentio_custom_fields_create` + +在 incident.io 中创建一个新的自定义字段。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `name` | string | 是 | 自定义字段的名称 | +| `description` | string | 是 | 自定义字段的描述 \(必需\) | +| `field_type` | string | 是 | 自定义字段的类型 \(例如,text, single_select, multi_select, numeric, datetime, link, user, team\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `custom_field` | object | 已创建的自定义字段 | + +### `incidentio_custom_fields_show` + +获取有关 incident.io 中特定自定义字段的详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 自定义字段 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `custom_field` | object | 自定义字段详情 | + +### `incidentio_custom_fields_update` + +更新 incident.io 中现有的自定义字段。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 自定义字段 ID | +| `name` | string | 是 | 自定义字段的新名称(必填) | +| `description` | string | 是 | 自定义字段的新描述(必填) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `custom_field` | object | 更新后的自定义字段 | + +### `incidentio_custom_fields_delete` + +从 incident.io 中删除自定义字段。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 自定义字段 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `message` | string | 成功消息 | + +### `incidentio_severities_list` + +列出在您的 Incident.io 工作区中配置的所有严重性级别。返回的严重性详细信息包括 id、名称、描述和排名。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Incident.io API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `severities` | array | 严重性级别列表 | + +### `incidentio_incident_statuses_list` + +列出在您的 Incident.io 工作区中配置的所有事件状态。返回的状态详细信息包括 id、名称、描述和类别。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Incident.io API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `incident_statuses` | array | 事件状态列表 | + +### `incidentio_incident_types_list` + +列出在您的 Incident.io 工作区中配置的所有事件类型。返回的类型详细信息包括 id、名称、描述和默认标志。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Incident.io API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `incident_types` | array | 事件类型列表 | + +### `incidentio_incident_roles_list` + +列出 Incident.io 中的所有事件角色 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Incident.io API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `incident_roles` | 数组 | 事件角色列表 | + +### `incidentio_incident_roles_create` + +在 incident.io 中创建一个新的事件角色 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | 字符串 | 是 | incident.io API 密钥 | +| `name` | 字符串 | 是 | 事件角色的名称 | +| `description` | 字符串 | 是 | 事件角色的描述 | +| `instructions` | 字符串 | 是 | 事件角色的指令 | +| `shortform` | 字符串 | 是 | 角色的缩写 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `incident_role` | 对象 | 创建的事件角色 | + +### `incidentio_incident_roles_show` + +获取 incident.io 中特定事件角色的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | 字符串 | 是 | incident.io API 密钥 | +| `id` | 字符串 | 是 | 事件角色的 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `incident_role` | 对象 | 事件角色的详细信息 | + +### `incidentio_incident_roles_update` + +更新 incident.io 中的现有事件角色 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | 字符串 | 是 | incident.io API 密钥 | +| `id` | 字符串 | 是 | 要更新的事件角色的 ID | +| `name` | 字符串 | 是 | 事件角色的名称 | +| `description` | 字符串 | 是 | 事件角色的描述 | +| `instructions` | 字符串 | 是 | 事件角色的指令 | +| `shortform` | 字符串 | 是 | 角色的缩写 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `incident_role` | object | 更新的事件角色 | + +### `incidentio_incident_roles_delete` + +删除 incident.io 中的事件角色 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 要删除的事件角色的 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `message` | string | 成功消息 | + +### `incidentio_incident_timestamps_list` + +列出 incident.io 中所有事件时间戳定义 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `incident_timestamps` | array | 事件时间戳定义列表 | + +### `incidentio_incident_timestamps_show` + +获取 incident.io 中特定事件时间戳定义的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 事件时间戳的 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `incident_timestamp` | object | 事件时间戳详细信息 | + +### `incidentio_incident_updates_list` + +列出 incident.io 中特定事件的所有更新 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `incident_id` | string | 否 | 要获取更新的事件 ID(可选 - 如果未提供,将返回所有更新) | +| `page_size` | number | 否 | 每页返回的结果数量 | +| `after` | string | 否 | 分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `incident_updates` | array | 事件更新列表 | + +### `incidentio_schedule_entries_list` + +列出 incident.io 中特定日程的所有条目 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `schedule_id` | string | 是 | 要获取条目的日程 ID | +| `entry_window_start` | string | 否 | 用于筛选条目的开始日期/时间(ISO 8601 格式) | +| `entry_window_end` | string | 否 | 用于筛选条目的结束日期/时间(ISO 8601 格式) | +| `page_size` | number | 否 | 每页返回的结果数量 | +| `after` | string | 否 | 分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `schedule_entries` | array | 日程条目列表 | + +### `incidentio_schedule_overrides_create` + +在 incident.io 中创建一个新的日程覆盖 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `rotation_id` | string | 是 | 要覆盖的轮换 ID | +| `schedule_id` | string | 是 | 日程 ID | +| `user_id` | string | 否 | 要分配的用户 ID(提供以下之一:user_id、user_email 或 user_slack_id)| +| `user_email` | string | 否 | 要分配的用户邮箱(提供以下之一:user_id、user_email 或 user_slack_id)| +| `user_slack_id` | string | 否 | 要分配的用户 Slack ID(提供以下之一:user_id、user_email 或 user_slack_id)| +| `start_at` | string | 是 | 覆盖开始时间(ISO 8601 格式)| +| `end_at` | string | 是 | 覆盖结束时间(ISO 8601 格式)| + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `override` | object | 创建的日程覆盖 | + +### `incidentio_escalation_paths_create` + +在 incident.io 中创建一个新的升级路径 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `name` | string | 是 | 升级路径名称 | +| `path` | json | 是 | 包含目标和确认时间(以秒为单位)的升级级别数组。每个级别应包含:targets(\{id, type, schedule_id?, user_id?, urgency\} 的数组)和 time_to_ack_seconds(数字)| +| `working_hours` | json | 否 | 可选的工作时间配置。\{weekday, start_time, end_time\} 的数组 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `escalation_path` | object | 创建的升级路径 | + +### `incidentio_escalation_paths_show` + +获取 incident.io 中特定升级路径的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 升级路径的 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `escalation_path` | object | 升级路径详细信息 | + +### `incidentio_escalation_paths_update` + +更新 incident.io 中现有的升级路径 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 要更新的升级路径的 ID | +| `name` | string | 否 | 升级路径的新名称 | +| `path` | json | 否 | 新的升级路径配置。包含目标和 time_to_ack_seconds 的升级级别数组 | +| `working_hours` | json | 否 | 新的工作时间配置。包含 \{weekday, start_time, end_time\} 的数组 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `escalation_path` | object | 更新后的升级路径 | + +### `incidentio_escalation_paths_delete` + +删除 incident.io 中的升级路径 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | incident.io API 密钥 | +| `id` | string | 是 | 要删除的升级路径的 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `message` | string | 成功消息 | + +## 注意事项 + +- 类别: `tools` +- 类型: `incidentio` diff --git a/apps/docs/content/docs/zh/tools/knowledge.mdx b/apps/docs/content/docs/zh/tools/knowledge.mdx index 6c88714de9..3b1cf4f9c2 100644 --- a/apps/docs/content/docs/zh/tools/knowledge.mdx +++ b/apps/docs/content/docs/zh/tools/knowledge.mdx @@ -44,6 +44,10 @@ Sim 的知识库是一项强大的原生功能,能够让您直接在平台内 | `query` | string | 否 | 搜索查询文本(使用标签过滤器时可选) | | `topK` | number | 否 | 要返回的最相似结果的数量(1-100) | | `tagFilters` | array | 否 | 包含 tagName 和 tagValue 属性的标签过滤器数组 | +| `items` | object | 否 | 无描述 | +| `properties` | string | 否 | 无描述 | +| `tagName` | string | 否 | 无描述 | +| `tagValue` | string | 否 | 无描述 | #### 输出 @@ -88,6 +92,11 @@ Sim 的知识库是一项强大的原生功能,能够让您直接在平台内 | `tag6` | string | 否 | 文档的标签 6 值 | | `tag7` | string | 否 | 文档的标签 7 值 | | `documentTagsData` | array | 否 | 包含名称、类型和值的结构化标签数据 | +| `items` | object | 否 | 无描述 | +| `properties` | string | 否 | 无描述 | +| `tagName` | string | 否 | 无描述 | +| `tagValue` | string | 否 | 无描述 | +| `tagType` | string | 否 | 无描述 | #### 输出 diff --git a/apps/docs/content/docs/zh/tools/posthog.mdx b/apps/docs/content/docs/zh/tools/posthog.mdx new file mode 100644 index 0000000000..49312fb7ba --- /dev/null +++ b/apps/docs/content/docs/zh/tools/posthog.mdx @@ -0,0 +1,1112 @@ +--- +title: PostHog +description: 产品分析和功能管理 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[PostHog](https://posthog.com/) 工具将强大的产品分析、功能标志管理、实验和用户行为洞察直接集成到您的智能工作流中。专为现代团队设计,它使您能够实时捕获、分析和利用用户数据,从而帮助您构建更好的产品、了解用户参与度并提高转化率。 + +使用 PostHog 工具,您可以: + +- **跟踪和分析事件**:使用 `posthog_capture_event` 和 `posthog_batch_events` 操作记录单个或多个用户操作、页面浏览或自定义事件以进行深入分析。 +- **探索事件数据**:使用 `posthog_list_events` 操作检索和列出历史或实时事件以进行高级事件分析。 +- **了解用户**:利用 `posthog_list_persons`、`posthog_get_person` 和 `posthog_delete_person` 操作管理用户档案、获取详细的用户洞察或根据需要删除用户。 +- **获取可操作的产品洞察**:通过 `posthog_list_insights`、`posthog_get_insight` 和 `posthog_create_insight` 操作可视化用户旅程、功能使用情况和参与度。 +- **安全地管理和推出功能**:使用 `posthog_list_feature_flags`、`posthog_get_feature_flag`、`posthog_create_feature_flag`、`posthog_update_feature_flag` 和 `posthog_delete_feature_flag` 等操作大规模切换功能并运行 A/B 或多变量测试。 +- **细分和定位受众**:使用 `posthog_list_cohorts`、`posthog_get_cohort` 和 `posthog_create_cohort` 构建、列出或管理群组。 +- **收集直接反馈**:通过 `posthog_list_surveys`、`posthog_get_survey`、`posthog_create_survey` 和 `posthog_update_survey` 设计、部署和分析调查。 +- **监控用户体验**:通过 `posthog_list_session_recordings` 和 `posthog_get_session_recording` 操作访问和分析会话记录。 +- **与团队协作**:组织仪表板(`posthog_list_dashboards`、`posthog_get_dashboard`),创建和注释洞察和事件,并在 PostHog 中管理项目和组织。 + +无论您是想实施全面的产品分析、优化用户引导流程、完善产品路线图,还是基于实际使用数据自动化决策,PostHog 工具都能通过高级分析和产品内实验为您的代理和工作流程提供支持——这一切都在一个统一的平台上完成。 + +在寻找具有隐私保护、可扩展性和开源选项的真正产品分析工具吗?PostHog 已被全球快速发展的团队和企业所信赖。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 PostHog 集成到您的工作流程中。跟踪事件、管理功能标志、分析用户行为、运行实验、创建调查问卷并访问会话录制。 + +## 工具 + +### `posthog_capture_event` + +在 PostHog 中捕获单个事件。使用此功能跟踪用户操作、页面浏览或自定义事件。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectApiKey` | string | 是 | PostHog 项目 API 密钥 \(用于事件摄取的公共令牌\) | +| `region` | string | 否 | PostHog 区域:us \(默认\) 或 eu | +| `event` | string | 是 | 要捕获的事件名称 \(例如,"page_view","button_clicked"\) | +| `distinctId` | string | 是 | 用户或设备的唯一标识符。可以是用户 ID、设备 ID 或匿名 ID | +| `properties` | string | 否 | 事件属性的 JSON 字符串 \(例如,\{"button_name": "signup", "page": "homepage"\}\) | +| `timestamp` | string | 否 | 事件发生时的 ISO 8601 时间戳。如果未提供,则使用当前时间 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `status` | string | 指示事件是否成功捕获的状态消息 | + +### `posthog_batch_events` + +在 PostHog 中一次捕获多个事件。使用此功能进行批量事件摄取以提高性能。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectApiKey` | string | 是 | PostHog 项目 API 密钥(用于事件摄取的公共令牌) | +| `region` | string | 否 | PostHog 区域:us(默认)或 eu | +| `batch` | string | 是 | 要捕获的事件的 JSON 数组。每个事件应包含:event、distinct_id,以及可选的 properties 和 timestamp。例如:\[\{"event": "page_view", "distinct_id": "user123", "properties": \{"page": "/"\}\}\] | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `status` | string | 状态消息,指示批量是否成功捕获 | +| `eventsProcessed` | number | 批处理中处理的事件数量 | + +### `posthog_list_events` + +列出 PostHog 中的事件。注意:此端点已被弃用,但为了向后兼容仍然保留。对于生产环境,建议使用带有 HogQL 的查询端点。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | 是 | PostHog 个人 API 密钥(用于认证的 API 访问) | +| `region` | string | 否 | PostHog 区域:us(默认)或 eu | +| `projectId` | string | 是 | PostHog 项目 ID | +| `limit` | number | 否 | 要返回的事件数量(默认:100,最大:100) | +| `offset` | number | 否 | 分页时要跳过的事件数量 | +| `event` | string | 否 | 按特定事件名称过滤 | +| `distinctId` | string | 否 | 按特定 distinct_id 过滤 | +| `before` | string | 否 | ISO 8601 时间戳 - 仅返回此时间之前的事件 | +| `after` | string | 否 | ISO 8601 时间戳 - 仅返回此时间之后的事件 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `events` | 数组 | 包含其属性和元数据的事件列表 | + +### `posthog_list_persons` + +列出 PostHog 中的人员(用户)。返回包含其属性和唯一 ID 的用户档案。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | 字符串 | 是 | PostHog 个人 API 密钥(用于认证的 API 访问) | +| `region` | 字符串 | 否 | PostHog 区域:us(默认)或 eu | +| `projectId` | 字符串 | 是 | PostHog 项目 ID | +| `limit` | 数字 | 否 | 返回的人员数量(默认:100,最大:100) | +| `offset` | 数字 | 否 | 分页时跳过的人员数量 | +| `search` | 字符串 | 否 | 通过电子邮件、姓名或唯一 ID 搜索人员 | +| `distinctId` | 字符串 | 否 | 按特定的唯一 ID 过滤 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `persons` | 数组 | 包含其属性和标识符的人员列表 | + +### `posthog_get_person` + +通过 ID 或 UUID 获取 PostHog 中特定人员的详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | 字符串 | 是 | PostHog 个人 API 密钥(用于认证的 API 访问) | +| `region` | 字符串 | 否 | PostHog 区域:us(默认)或 eu | +| `projectId` | 字符串 | 是 | PostHog 项目 ID | +| `personId` | 字符串 | 是 | 要检索的人员 ID 或 UUID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `person` | object | 包含属性和标识符的人员详细信息 | + +### `posthog_delete_person` + +从 PostHog 中删除一个人员。这将移除所有相关的事件和数据。请谨慎使用。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | 是 | PostHog 个人 API 密钥(用于认证的 API 访问) | +| `region` | string | 否 | PostHog 区域:us(默认)或 eu | +| `projectId` | string | 是 | PostHog 项目 ID | +| `personId` | string | 是 | 要删除的人员 ID 或 UUID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `status` | string | 状态消息,指示人员是否成功删除 | + +### `posthog_query` + +在 PostHog 中执行 HogQL 查询。HogQL 是 PostHog + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `personalApiKey` | string | 是 | PostHog 个人 API 密钥(用于认证的 API 访问) | +| `region` | string | 否 | PostHog 区域:us(默认)或 eu | +| `projectId` | string | 是 | PostHog 项目 ID | +| `query` | string | 是 | 要执行的 HogQL 查询。例如:\{"kind": "HogQLQuery", "query": "SELECT event, count\(\) FROM events WHERE timestamp > now\(\) - INTERVAL 1 DAY GROUP BY event"\} | +| `Example` | string | 否 | 无描述 | +| `values` | string | 否 | 参数化查询的可选 JSON 字符串参数值。例如:\{"user_id": "123"\} | +| `Example` | string | 否 | 无描述 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `results` | array | 查询结果作为行数组 | + +### `posthog_list_insights` + +列出 PostHog 项目中的所有洞察。返回洞察配置、过滤器和元数据。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 否 | PostHog 云区域:"us" 或 "eu" (默认值:"us")| +| `limit` | number | 否 | 每页返回的结果数量(默认值:100)| +| `offset` | number | 否 | 分页时跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `count` | number | 项目中洞察的总数 | +| `next` | string | 下一页结果的 URL | +| `previous` | string | 上一页结果的 URL | +| `results` | array | 包含其配置和元数据的洞察列表 | + +### `posthog_get_insight` + +通过 ID 从 PostHog 获取特定洞察。返回详细的洞察配置、过滤器和元数据。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `insightId` | string | 是 | 要检索的洞察 ID | +| `region` | string | 否 | PostHog 云区域:"us" 或 "eu" (默认值:"us")| + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | number | 洞察的唯一标识符 | +| `name` | string | 洞察的名称 | +| `description` | string | 洞察的描述 | +| `filters` | object | 洞察的过滤器配置 | +| `query` | object | 洞察的查询配置 | +| `created_at` | string | 洞察创建时的 ISO 时间戳 | +| `created_by` | object | 创建洞察的用户 | +| `last_modified_at` | string | 洞察最后修改时的 ISO 时间戳 | +| `last_modified_by` | object | 最后修改洞察的用户 | +| `saved` | boolean | 洞察是否已保存 | +| `dashboards` | array | 此洞察出现在的仪表板 ID | +| `tags` | array | 与洞察相关的标签 | +| `favorited` | boolean | 洞察是否被标记为收藏 | + +### `posthog_create_insight` + +在 PostHog 中创建一个新的洞察。需要提供洞察名称和配置过滤器或查询。 + +#### 输入 + +| 参数 | 类型 | 是否必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 否 | PostHog 云区域:"us" 或 "eu" \(默认:"us"\) | +| `name` | string | 否 | 洞察的名称 \(可选 - 如果未提供,PostHog 将生成一个派生名称\) | +| `description` | string | 否 | 洞察的描述 | +| `filters` | string | 否 | 洞察的过滤器配置的 JSON 字符串 | +| `query` | string | 否 | 洞察的查询配置的 JSON 字符串 | +| `dashboards` | string | 否 | 要将此洞察添加到的仪表板 ID 的逗号分隔列表 | +| `tags` | string | 否 | 洞察的标签的逗号分隔列表 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | number | 创建的洞察的唯一标识符 | +| `name` | string | 洞察的名称 | +| `description` | string | 洞察的描述 | +| `filters` | object | 洞察的过滤器配置 | +| `query` | object | 洞察的查询配置 | +| `created_at` | string | 洞察创建时的 ISO 时间戳 | +| `created_by` | object | 创建洞察的用户 | +| `last_modified_at` | string | 洞察最后修改时的 ISO 时间戳 | +| `saved` | boolean | 洞察是否已保存 | +| `dashboards` | array | 此洞察显示的仪表板 ID 列表 | +| `tags` | array | 与洞察相关的标签 | + +### `posthog_list_dashboards` + +列出 PostHog 项目中的所有仪表板。返回仪表板配置、图块和元数据。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 否 | PostHog 云区域:"us" 或 "eu" \(默认值:"us"\) | +| `limit` | number | 否 | 每页返回的结果数量 \(默认值:100\) | +| `offset` | number | 否 | 分页时跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `count` | number | 项目中仪表板的总数 | +| `next` | string | 下一页结果的 URL | +| `previous` | string | 上一页结果的 URL | +| `results` | array | 包含其配置和元数据的仪表板列表 | + +### `posthog_get_dashboard` + +通过 ID 从 PostHog 获取特定仪表板。返回详细的仪表板配置、组件和元数据。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `dashboardId` | string | 是 | 要检索的仪表板 ID | +| `region` | string | 否 | PostHog 云区域:"us" 或 "eu" \(默认值:"us"\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | number | 仪表板的唯一标识符 | +| `name` | string | 仪表板名称 | +| `description` | string | 仪表板描述 | +| `pinned` | boolean | 仪表板是否已固定 | +| `created_at` | string | 仪表板创建时的 ISO 时间戳 | +| `created_by` | object | 创建仪表板的用户 | +| `last_modified_at` | string | 仪表板最后修改时的 ISO 时间戳 | +| `last_modified_by` | object | 最后修改仪表板的用户 | +| `tiles` | array | 仪表板上的组件/小部件及其配置 | +| `filters` | object | 应用于仪表板的全局过滤器 | +| `tags` | array | 与仪表板关联的标签 | +| `restriction_level` | number | 仪表板的访问限制级别 | + +### `posthog_list_actions` + +列出 PostHog 项目中的所有操作。返回操作定义、步骤和元数据。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 否 | PostHog 云区域:"us" 或 "eu" \(默认值:"us"\) | +| `limit` | number | 否 | 每页返回的结果数量 \(默认值:100\) | +| `offset` | number | 否 | 分页时跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `count` | number | 项目中的操作总数 | +| `next` | string | 下一页结果的 URL | +| `previous` | string | 上一页结果的 URL | +| `results` | array | 包含其定义和元数据的操作列表 | + +### `posthog_list_cohorts` + +列出 PostHog 项目中的所有群组。返回群组定义、过滤器和用户计数。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 否 | PostHog 云区域:"us" 或 "eu" \(默认值:"us"\) | +| `limit` | number | 否 | 每页返回的结果数量 \(默认值:100\) | +| `offset` | number | 否 | 分页时跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `count` | number | 项目中群组的总数 | +| `next` | string | 下一页结果的 URL | +| `previous` | string | 上一页结果的 URL | +| `results` | array | 包含定义和元数据的群组列表 | + +### `posthog_get_cohort` + +通过 ID 从 PostHog 获取特定群组。返回详细的群组定义、筛选器和用户数量。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `cohortId` | string | 是 | 要检索的群组 ID | +| `region` | string | 否 | PostHog 云区域:"us" 或 "eu" \(默认:"us"\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | number | 群组的唯一标识符 | +| `name` | string | 群组名称 | +| `description` | string | 群组描述 | +| `groups` | array | 定义群组的组 | +| `deleted` | boolean | 群组是否已被删除 | +| `filters` | object | 群组的筛选器配置 | +| `query` | object | 群组的查询配置 | +| `created_at` | string | 群组创建时的 ISO 时间戳 | +| `created_by` | object | 创建群组的用户 | +| `is_calculating` | boolean | 群组是否正在计算中 | +| `last_calculation` | string | 上次计算的 ISO 时间戳 | +| `errors_calculating` | number | 计算过程中发生的错误数量 | +| `count` | number | 群组中的用户数量 | +| `is_static` | boolean | 群组是否为静态群组 | +| `version` | number | 群组的版本号 | + +### `posthog_create_cohort` + +在 PostHog 中创建一个新的群组。需要提供群组名称以及过滤器或查询配置。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 否 | PostHog 云区域:"us" 或 "eu" \(默认值:"us"\) | +| `name` | string | 否 | 群组名称 \(可选 - 如果未提供,PostHog 将使用 "未命名群组"\) | +| `description` | string | 否 | 群组描述 | +| `filters` | string | 否 | 群组过滤器配置的 JSON 字符串 | +| `query` | string | 否 | 群组查询配置的 JSON 字符串 | +| `is_static` | boolean | 否 | 群组是否为静态 \(默认值:false\) | +| `groups` | string | 否 | 定义群组的组的 JSON 字符串 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | number | 创建的群组的唯一标识符 | +| `name` | string | 群组名称 | +| `description` | string | 群组描述 | +| `groups` | array | 定义群组的组 | +| `deleted` | boolean | 群组是否已被删除 | +| `filters` | object | 群组的过滤器配置 | +| `query` | object | 群组的查询配置 | +| `created_at` | string | 群组创建时的 ISO 时间戳 | +| `created_by` | object | 创建群组的用户 | +| `is_calculating` | boolean | 群组是否正在计算中 | +| `count` | number | 群组中的用户数量 | +| `is_static` | boolean | 群组是否为静态 | +| `version` | number | 群组的版本号 | + +### `posthog_list_annotations` + +列出 PostHog 项目中的所有注释。返回注释内容、时间戳和相关的洞察。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 否 | PostHog 云区域:"us" 或 "eu" (默认值:"us")| +| `limit` | number | 否 | 每页返回的结果数量(默认值:100)| +| `offset` | number | 否 | 分页时跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `count` | number | 项目中注释的总数 | +| `next` | string | 下一页结果的 URL | +| `previous` | string | 上一页结果的 URL | +| `results` | array | 包含注释内容和元数据的注释列表 | + +### `posthog_create_annotation` + +在 PostHog 中创建一个新注释。在图表上用日期和描述标记重要事件。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 否 | PostHog 云区域:"us" 或 "eu" (默认值:"us")| +| `content` | string | 是 | 注释的内容/文本 | +| `date_marker` | string | 是 | 标记注释适用时间的 ISO 时间戳(例如:"2024-01-15T10:00:00Z")| +| `scope` | string | 否 | 注释的范围:"project" 或 "dashboard_item" (默认值:"project")| +| `dashboard_item` | string | 否 | 要将此注释附加到的仪表板项的 ID | +| `insight_short_id` | string | 否 | 要将此注释附加到的洞察的短 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | number | 创建的注释的唯一标识符 | +| `content` | string | 注释的内容/文本 | +| `date_marker` | string | 注释适用时的 ISO 时间戳 | +| `created_at` | string | 注释创建时的 ISO 时间戳 | +| `updated_at` | string | 注释最后更新时的 ISO 时间戳 | +| `created_by` | object | 创建注释的用户 | +| `dashboard_item` | number | 此注释附加到的仪表板项的 ID | +| `insight_short_id` | string | 此注释附加到的洞察的短 ID | +| `insight_name` | string | 此注释附加到的洞察的名称 | +| `scope` | string | 注释的范围 \(项目或仪表板项\) | +| `deleted` | boolean | 注释是否被删除 | + +### `posthog_list_feature_flags` + +列出 PostHog 项目中的所有功能标志 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `limit` | number | 否 | 要返回的结果数量 | +| `offset` | number | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `results` | array | 功能标志列表 | + +### `posthog_get_feature_flag` + +获取特定功能标志的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `flagId` | string | 是 | 功能标志 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `flag` | object | 功能标志详细信息 | + +### `posthog_create_feature_flag` + +在 PostHog 中创建一个新的功能标志 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `name` | string | 否 | 功能标志名称(可选 - 可以为空) | +| `key` | string | 是 | 功能标志键(唯一标识符) | +| `filters` | string | 否 | 功能标志过滤器(JSON 字符串) | +| `active` | boolean | 否 | 标志是否激活(默认:true) | +| `ensureExperienceContinuity` | boolean | 否 | 是否确保体验连续性(默认:false) | +| `rolloutPercentage` | number | 否 | 发布百分比(0-100) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `flag` | object | 创建的功能标志 | + +### `posthog_update_feature_flag` + +更新 PostHog 中现有的功能标志 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `flagId` | string | 是 | 功能标志 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `name` | string | 否 | 功能标志名称 | +| `key` | string | 否 | 功能标志键(唯一标识符)| +| `filters` | string | 否 | 功能标志过滤器(JSON 字符串)| +| `active` | boolean | 否 | 标志是否激活 | +| `ensureExperienceContinuity` | boolean | 否 | 是否确保体验连续性 | +| `rolloutPercentage` | number | 否 | 发布百分比(0-100)| + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `flag` | object | 更新的功能标志 | + +### `posthog_delete_feature_flag` + +从 PostHog 中删除功能标志 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `flagId` | string | 是 | 要删除的功能标志 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 是否删除成功 | +| `message` | string | 确认消息 | + +### `posthog_evaluate_flags` + +为特定用户或群组评估功能标志。这是一个使用项目 API 密钥的公共端点。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `projectApiKey` | string | 是 | PostHog 项目 API 密钥(不是个人 API 密钥) | +| `distinctId` | string | 是 | 要评估标志的用户的唯一 ID | +| `groups` | string | 否 | 以 JSON 字符串形式表示的群组(例如,\{"company": "company_id_in_your_db"\}) | +| `personProperties` | string | 否 | 以 JSON 字符串形式表示的人员属性 | +| `groupProperties` | string | 否 | 以 JSON 字符串形式表示的群组属性 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `featureFlags` | object | 功能标志评估(键值对,其中值为布尔值或字符串变体) | +| `featureFlagPayloads` | object | 附加到功能标志的额外负载 | +| `errorsWhileComputingFlags` | boolean | 计算标志时是否存在错误 | + +### `posthog_list_experiments` + +列出 PostHog 项目中的所有实验 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `limit` | number | 否 | 要返回的结果数量 | +| `offset` | number | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `results` | array | 实验列表 | + +### `posthog_get_experiment` + +获取特定实验的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `experimentId` | string | 是 | 实验 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `experiment` | object | 实验详情 | + +### `posthog_create_experiment` + +在 PostHog 中创建一个新实验 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `name` | string | 否 | 实验名称(可选) | +| `description` | string | 否 | 实验描述 | +| `featureFlagKey` | string | 是 | 用于实验的功能标志键 | +| `parameters` | string | 否 | 实验参数(JSON 字符串) | +| `filters` | string | 否 | 实验过滤器(JSON 字符串) | +| `variants` | string | 否 | 实验变体(JSON 字符串) | +| `startDate` | string | 否 | 实验开始日期(ISO 格式) | +| `endDate` | string | 否 | 实验结束日期(ISO 格式) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `experiment` | object | 创建的实验 | + +### `posthog_list_surveys` + +列出 PostHog 项目中的所有调查。调查允许您收集用户的反馈。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 否 | PostHog 云区域:us 或 eu \(默认:us\) | +| `limit` | number | 否 | 返回结果数量 \(默认:100\) | +| `offset` | number | 否 | 分页时跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `surveys` | array | 项目中的调查列表 | + +### `posthog_get_survey` + +通过 ID 获取 PostHog 中特定调查的详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `surveyId` | string | 是 | 要检索的调查 ID | +| `region` | string | 否 | PostHog 云区域:us 或 eu \(默认:us\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `survey` | object | 调查详情 | + +### `posthog_create_survey` + +在 PostHog 中创建一个新调查。支持的问题类型包括:基础(开放式)、链接、评分和多选。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 否 | PostHog 云区域:us 或 eu (默认:us) | +| `name` | string | 否 | 调查名称(可选) | +| `description` | string | 否 | 调查描述 | +| `type` | string | 否 | 调查类型:popover(应用内)或 api(自定义实现)(默认:popover) | +| `questions` | string | 是 | 调查问题数组的 JSON 字符串。每个问题必须包含类型(open/link/rating/multiple_choice)和问题文本。评分问题可以包含 scale(1-10)、lowerBoundLabel、upperBoundLabel。多选问题需要 choices 数组。链接问题可以包含 buttonText。 | +| `startDate` | string | 否 | ISO 8601 格式的调查开始日期 | +| `endDate` | string | 否 | ISO 8601 格式的调查结束日期 | +| `appearance` | string | 否 | 外观配置的 JSON 字符串(颜色、位置等) | +| `conditions` | string | 否 | 显示条件的 JSON 字符串(URL 匹配等) | +| `targetingFlagFilters` | string | 否 | 用于定位的功能标志过滤器的 JSON 字符串 | +| `linkedFlagId` | string | 否 | 要链接到此调查的功能标志 ID | +| `responsesLimit` | number | 否 | 要收集的最大响应数 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `survey` | object | 创建的调查详情 | + +### `posthog_update_survey` + +更新 PostHog 中的现有调查。可以修改问题、外观、条件和其他设置。 + +#### 输入 + +| 参数 | 类型 | 是否必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `surveyId` | string | 是 | 要更新的调查 ID | +| `region` | string | 否 | PostHog 云区域:us 或 eu \(默认:us\) | +| `name` | string | 否 | 调查名称 | +| `description` | string | 否 | 调查描述 | +| `type` | string | 否 | 调查类型:popover 或 api | +| `questions` | string | 否 | 调查问题数组的 JSON 字符串。每个问题必须包含类型 \(open/link/rating/multiple_choice\) 和问题文本。 | +| `startDate` | string | 否 | ISO 8601 格式的调查开始日期 | +| `endDate` | string | 否 | ISO 8601 格式的调查结束日期 | +| `appearance` | string | 否 | 外观配置的 JSON 字符串 \(颜色、位置等\) | +| `conditions` | string | 否 | 显示条件的 JSON 字符串 \(URL 匹配等\) | +| `targetingFlagFilters` | string | 否 | 用于定位的功能标志过滤器的 JSON 字符串 | +| `linkedFlagId` | string | 否 | 要链接到此调查的功能标志 ID | +| `responsesLimit` | number | 否 | 要收集的最大响应数 | +| `archived` | boolean | 否 | 归档或取消归档调查 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `survey` | object | 更新的调查详情 | + +### `posthog_list_session_recordings` + +列出 PostHog 项目中的会话录制。会话录制捕获用户与您的应用程序的交互。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 否 | PostHog 云区域:us 或 eu \(默认:us\) | +| `limit` | number | 否 | 返回结果数量 \(默认:50\) | +| `offset` | number | 否 | 分页时跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `recordings` | array | 会话录制列表 | + +### `posthog_get_session_recording` + +通过 ID 获取 PostHog 中特定会话录制的详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `recordingId` | string | 是 | 要检索的会话录制 ID | +| `region` | string | 否 | PostHog 云区域:us 或 eu \(默认:us\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `recording` | object | 会话录制详情 | + +### `posthog_list_recording_playlists` + +列出 PostHog 项目中的会话录制播放列表。播放列表允许您组织和策划会话录制。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 否 | PostHog 云区域:us 或 eu \(默认:us\) | +| `limit` | number | 否 | 返回结果数量 \(默认:100\) | +| `offset` | number | 否 | 分页时跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `playlists` | array | 会话录制播放列表 | + +### `posthog_list_event_definitions` + +列出 PostHog 项目中的所有事件定义。事件定义表示带有描述、标签和使用统计信息等元数据的跟踪事件。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `limit` | number | 否 | 每页返回的结果数量 \(默认:100\) | +| `offset` | number | 否 | 返回结果的起始索引 | +| `search` | string | 否 | 按名称筛选事件定义的搜索词 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `count` | number | 事件定义的总数 | +| `next` | string | 下一页结果的 URL | +| `previous` | string | 上一页结果的 URL | +| `results` | array | 事件定义列表 | + +### `posthog_get_event_definition` + +获取 PostHog 中特定事件定义的详细信息。返回关于该事件的全面信息,包括元数据、使用统计和验证状态。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `eventDefinitionId` | string | 是 | 要检索的事件定义 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | string | 事件定义的唯一标识符 | +| `name` | string | 事件名称 | +| `description` | string | 事件描述 | +| `tags` | array | 与事件关联的标签 | +| `volume_30_day` | number | 最近 30 天内接收到的事件数量 | +| `query_usage_30_day` | number | 最近 30 天内查询此事件的次数 | +| `created_at` | string | 事件创建时的 ISO 时间戳 | +| `last_seen_at` | string | 事件最后一次被看到时的 ISO 时间戳 | +| `updated_at` | string | 事件更新时的 ISO 时间戳 | +| `updated_by` | object | 最后更新事件的用户 | +| `verified` | boolean | 事件是否已被验证 | +| `verified_at` | string | 事件被验证时的 ISO 时间戳 | +| `verified_by` | string | 验证事件的用户 | + +### `posthog_update_event_definition` + +更新 PostHog 中的事件定义。可以修改描述、标签和验证状态,以保持事件模式的清晰。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `eventDefinitionId` | string | 是 | 要更新的事件定义 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `description` | string | 否 | 事件的更新描述 | +| `tags` | string | 否 | 与事件关联的逗号分隔标签列表 | +| `verified` | boolean | 否 | 是否将事件标记为已验证 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | string | 事件定义的唯一标识符 | +| `name` | string | 事件名称 | +| `description` | string | 更新后的事件描述 | +| `tags` | array | 更新后的与事件关联的标签 | +| `volume_30_day` | number | 最近 30 天内接收到的事件数量 | +| `query_usage_30_day` | number | 最近 30 天内查询此事件的次数 | +| `created_at` | string | 事件创建时的 ISO 时间戳 | +| `last_seen_at` | string | 事件最后一次被看到时的 ISO 时间戳 | +| `updated_at` | string | 事件更新时的 ISO 时间戳 | +| `updated_by` | object | 最后更新事件的用户 | +| `verified` | boolean | 事件是否已验证 | +| `verified_at` | string | 事件验证时的 ISO 时间戳 | +| `verified_by` | string | 验证事件的用户 | + +### `posthog_list_property_definitions` + +列出 PostHog 项目中的所有属性定义。属性定义表示带有元数据(如描述、标签、类型和使用统计信息)的跟踪属性。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `limit` | number | 否 | 每页返回的结果数量 \(默认值:100\) | +| `offset` | number | 否 | 返回结果的初始索引 | +| `search` | string | 否 | 按名称筛选属性定义的搜索词 | +| `type` | string | 否 | 按属性类型筛选:event、person 或 group | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `count` | number | 属性定义的总数 | +| `next` | string | 下一页结果的 URL | +| `previous` | string | 上一页结果的 URL | +| `results` | array | 属性定义列表 | + +### `posthog_get_property_definition` + +获取 PostHog 中特定属性定义的详细信息。返回有关该属性的全面信息,包括元数据、类型、使用统计信息和验证状态。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `propertyDefinitionId` | string | 是 | 要检索的属性定义 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | string | 属性定义的唯一标识符 | +| `name` | string | 属性名称 | +| `description` | string | 属性描述 | +| `tags` | array | 与属性关联的标签 | +| `is_numerical` | boolean | 属性是否为数值型 | +| `is_seen_on_filtered_events` | boolean | 属性是否出现在筛选事件中 | +| `property_type` | string | 属性的数据类型 | +| `type` | string | 属性类型:事件、人员或组 | +| `volume_30_day` | number | 属性在过去 30 天内被查看的次数 | +| `query_usage_30_day` | number | 属性在过去 30 天内被查询的次数 | +| `created_at` | string | 属性创建时的 ISO 时间戳 | +| `updated_at` | string | 属性更新时的 ISO 时间戳 | +| `updated_by` | object | 最后更新属性的用户 | +| `verified` | boolean | 属性是否已验证 | +| `verified_at` | string | 属性验证时的 ISO 时间戳 | +| `verified_by` | string | 验证属性的用户 | +| `example` | string | 属性的示例值 | + +### `posthog_update_property_definition` + +更新 PostHog 中的属性定义。可以修改描述、标签、属性类型和验证状态,以保持属性架构的整洁。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | PostHog 项目 ID | +| `propertyDefinitionId` | string | 是 | 要更新的属性定义 ID | +| `region` | string | 是 | PostHog 云区域:us 或 eu | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `description` | string | 否 | 属性的更新描述 | +| `tags` | string | 否 | 要与属性关联的逗号分隔标签列表 | +| `verified` | boolean | 否 | 是否将属性标记为已验证 | +| `property_type` | string | 否 | 属性的数据类型(例如:String、Numeric、Boolean、DateTime 等) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `id` | string | 属性定义的唯一标识符 | +| `name` | string | 属性名称 | +| `description` | string | 更新后的属性描述 | +| `tags` | array | 与属性关联的更新标签 | +| `is_numerical` | boolean | 属性是否为数值型 | +| `is_seen_on_filtered_events` | boolean | 属性是否出现在过滤的事件中 | +| `property_type` | string | 属性的数据类型 | +| `type` | string | 属性类型:事件、人员或组 | +| `volume_30_day` | number | 属性在过去 30 天内被看到的次数 | +| `query_usage_30_day` | number | 属性在过去 30 天内被查询的次数 | +| `created_at` | string | 属性创建时的 ISO 时间戳 | +| `updated_at` | string | 属性更新时的 ISO 时间戳 | +| `updated_by` | object | 最后更新属性的用户 | +| `verified` | boolean | 属性是否已被验证 | +| `verified_at` | string | 属性验证时的 ISO 时间戳 | +| `verified_by` | string | 验证属性的用户 | +| `example` | string | 属性的示例值 | + +### `posthog_list_projects` + +列出组织中的所有项目。返回包括 ID、名称、API 令牌和设置在内的项目详细信息。可用于获取其他端点所需的项目 ID。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `region` | string | 否 | 云区域:us 或 eu \(默认:us\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `projects` | array | 包含其配置和设置的项目列表 | + +### `posthog_get_project` + +通过 ID 获取特定项目的详细信息。返回全面的项目配置、设置和功能标志。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `projectId` | string | 是 | 项目 ID \(数字 ID 或 UUID\) | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `region` | string | 否 | 云区域:us 或 eu \(默认:us\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `project` | object | 包含所有配置设置的详细项目信息 | + +### `posthog_list_organizations` + +列出用户有权限访问的所有组织。返回组织详细信息,包括名称、slug、成员级别和可用的产品功能。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | PostHog 个人 API 密钥 | +| `region` | string | 否 | 云区域:us 或 eu \(默认:us\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `organizations` | 数组 | 包含其设置和功能的组织列表 | + +### `posthog_get_organization` + +通过 ID 获取特定组织的详细信息。返回全面的组织设置、功能、使用情况和团队信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `organizationId` | 字符串 | 是 | 组织 ID \(UUID\) | +| `apiKey` | 字符串 | 是 | PostHog 个人 API 密钥 | +| `region` | 字符串 | 否 | 云区域:us 或 eu \(默认:us\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `organization` | 对象 | 包含设置和功能的详细组织信息 | + +## 注意 + +- 类别:`tools` +- 类型:`posthog` diff --git a/apps/docs/content/docs/zh/tools/sentry.mdx b/apps/docs/content/docs/zh/tools/sentry.mdx new file mode 100644 index 0000000000..2b55e29871 --- /dev/null +++ b/apps/docs/content/docs/zh/tools/sentry.mdx @@ -0,0 +1,305 @@ +--- +title: Sentry +description: 管理 Sentry 的问题、项目、事件和发布 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +通过 [Sentry](https://sentry.io/) —— 业界领先的实时错误跟踪、性能监控和发布管理平台,增强您的错误监控和应用程序可靠性。将 Sentry 无缝集成到您的自动化代理工作流中,轻松监控问题、跟踪关键事件、管理项目,并协调所有应用程序和服务的发布。 + +使用 Sentry 工具,您可以: + +- **监控和分类问题**:使用 `sentry_issues_list` 操作获取全面的问题列表,并通过 `sentry_issues_get` 检索单个错误和漏洞的详细信息。即时访问元数据、标签、堆栈跟踪和统计数据,以减少平均解决时间。 +- **跟踪事件数据**:通过 `sentry_events_list` 和 `sentry_events_get` 分析特定的错误和事件实例,深入了解错误发生情况及其对用户的影响。 +- **管理项目和团队**:使用 `sentry_projects_list` 和 `sentry_project_get` 枚举和审查所有 Sentry 项目,确保团队协作顺畅和配置集中化。 +- **协调发布**:通过 `sentry_releases_list`、`sentry_release_get` 等操作,自动化版本跟踪、部署健康和变更管理。 +- **获取强大的应用程序洞察**:利用高级过滤器和查询,查找未解决或高优先级问题,汇总事件统计数据,并在代码库演变时跟踪回归。 + +Sentry 的集成使工程和 DevOps 团队能够及早发现问题,优先处理最具影响力的漏洞,并持续改善开发堆栈中的应用程序健康状况。以编程方式协调现代可观测性、事件响应和发布生命周期管理的工作流自动化——减少停机时间并提高用户满意度。 + +**可用的 Sentry 关键操作**: +- `sentry_issues_list`:列出组织和项目的 Sentry 问题,支持强大的搜索和过滤功能。 +- `sentry_issues_get`:检索特定 Sentry 问题的详细信息。 +- `sentry_events_list`:枚举特定问题的事件,用于根本原因分析。 +- `sentry_events_get`:获取单个事件的完整详细信息,包括堆栈跟踪、上下文和元数据。 +- `sentry_projects_list`:列出组织内的所有 Sentry 项目。 +- `sentry_project_get`:检索特定项目的配置和详细信息。 +- `sentry_releases_list`:列出最近的发布及其部署状态。 +- `sentry_release_get`:检索详细的发布信息,包括相关的提交和问题。 + +无论是主动管理应用健康状况、排查生产错误,还是自动化发布工作流,Sentry 都为您提供世界一流的监控、可操作的警报以及无缝的 DevOps 集成。通过利用 Sentry 进行错误跟踪、可观测性和发布管理,从您的智能工作流中提升软件质量和搜索可见性。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Sentry 集成到工作流中。监控问题、管理项目、跟踪事件,并协调应用程序的发布。 + +## 工具 + +### `sentry_issues_list` + +列出特定组织(可选特定项目)的 Sentry 问题。返回包括状态、错误计数和最后一次查看时间戳在内的问题详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Sentry API 身份验证令牌 | +| `organizationSlug` | string | 是 | 组织的 slug | +| `projectSlug` | string | 否 | 按特定项目 slug 过滤问题(可选) | +| `query` | string | 否 | 用于过滤问题的搜索查询。支持 Sentry 搜索语法(例如,"is:unresolved","level:error") | +| `statsPeriod` | string | 否 | 统计的时间范围(例如,"24h","7d","30d")。如果未指定,默认为 24h。 | +| `cursor` | string | 否 | 用于检索下一页结果的分页游标 | +| `limit` | number | 否 | 每页返回的问题数量(默认:25,最大:100) | +| `status` | string | 否 | 按问题状态过滤:未解决、已解决、已忽略或已静音 | +| `sort` | string | 否 | 排序顺序:日期、新、频率、优先级或用户(默认:日期) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `issues` | array | Sentry 问题列表 | + +### `sentry_issues_get` + +通过问题的 ID 检索特定 Sentry 问题的详细信息。返回完整的问题详情,包括元数据、标签和统计信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Sentry API 身份验证令牌 | +| `organizationSlug` | string | 是 | 组织的 slug | +| `issueId` | string | 是 | 要检索的问题的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `issue` | object | Sentry 问题的详细信息 | + +### `sentry_issues_update` + +通过更改状态、分配、书签状态或其他属性来更新 Sentry 问题。返回更新后的问题详情。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Sentry API 身份验证令牌 | +| `organizationSlug` | string | 是 | 组织的 slug | +| `issueId` | string | 是 | 要更新的问题的唯一 ID | +| `status` | string | 否 | 问题的新状态:resolved、unresolved、ignored 或 resolvedInNextRelease | +| `assignedTo` | string | 否 | 要分配问题的用户 ID 或电子邮件。使用空字符串取消分配。 | +| `isBookmarked` | boolean | 否 | 是否为问题添加书签 | +| `isSubscribed` | boolean | 否 | 是否订阅问题更新 | +| `isPublic` | boolean | 否 | 问题是否应公开可见 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `issue` | object | 更新后的 Sentry 问题 | + +### `sentry_projects_list` + +列出 Sentry 组织中的所有项目。返回的项目详情包括名称、平台、团队和配置。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Sentry API 身份验证令牌 | +| `organizationSlug` | string | 是 | 组织的 slug | +| `cursor` | string | 否 | 用于获取下一页结果的分页游标 | +| `limit` | number | 否 | 每页返回的项目数量 \(默认: 25, 最大: 100\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `projects` | array | Sentry 项目列表 | + +### `sentry_projects_get` + +通过项目的 slug 检索特定 Sentry 项目的详细信息。返回完整的项目详情,包括团队、功能和配置。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Sentry API 身份验证令牌 | +| `organizationSlug` | string | 是 | 组织的 slug | +| `projectSlug` | string | 是 | 要检索的项目的 ID 或 slug | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `project` | object | 关于 Sentry 项目的详细信息 | + +### `sentry_projects_create` + +在组织中创建一个新的 Sentry 项目。需要一个团队来关联该项目。返回创建的项目详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Sentry API 身份验证令牌 | +| `organizationSlug` | string | 是 | 组织的 slug | +| `name` | string | 是 | 项目的名称 | +| `teamSlug` | string | 是 | 将拥有此项目的团队的 slug | +| `slug` | string | 否 | URL 友好的项目标识符(如果未提供,则根据名称自动生成) | +| `platform` | string | 否 | 项目的平台/语言(例如,javascript、python、node、react-native)。如果未指定,默认为 "other" | +| `defaultRules` | boolean | 否 | 是否创建默认的警报规则(默认值:true) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `project` | object | 新创建的 Sentry 项目 | + +### `sentry_projects_update` + +通过更改名称、slug、平台或其他设置来更新 Sentry 项目。返回更新后的项目详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Sentry API 身份验证令牌 | +| `organizationSlug` | string | 是 | 组织的 slug | +| `projectSlug` | string | 是 | 要更新的项目的 slug | +| `name` | string | 否 | 项目的新名称 | +| `slug` | string | 否 | 新的 URL 友好的项目标识符 | +| `platform` | string | 否 | 项目的新平台/语言(例如,javascript、python、node) | +| `isBookmarked` | boolean | 否 | 是否将项目标记为书签 | +| `digestsMinDelay` | number | 否 | 摘要通知的最小延迟(以秒为单位) | +| `digestsMaxDelay` | number | 否 | 摘要通知的最大延迟(以秒为单位) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `project` | object | 更新后的 Sentry 项目 | + +### `sentry_events_list` + +列出 Sentry 项目中的事件。可以通过问题 ID、查询或时间段进行筛选。返回的事件详情包括上下文、标签和用户信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Sentry API 身份验证令牌 | +| `organizationSlug` | string | 是 | 组织的 slug | +| `projectSlug` | string | 是 | 要列出事件的项目的 slug | +| `issueId` | string | 否 | 按特定问题 ID 筛选事件 | +| `query` | string | 否 | 用于筛选事件的搜索查询。支持 Sentry 搜索语法(例如:"user.email:*@example.com") | +| `cursor` | string | 否 | 用于检索下一页结果的分页游标 | +| `limit` | number | 否 | 每页返回的事件数量(默认:50,最大:100) | +| `statsPeriod` | string | 否 | 查询的时间段(例如:"24h"、"7d"、"30d")。如果未指定,默认为 90d。 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `events` | array | Sentry 事件列表 | + +### `sentry_events_get` + +通过事件 ID 检索特定 Sentry 事件的详细信息。返回完整的事件详情,包括堆栈跟踪、面包屑、上下文和用户信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Sentry API 身份验证令牌 | +| `organizationSlug` | string | 是 | 组织的 slug | +| `projectSlug` | string | 是 | 项目的 slug | +| `eventId` | string | 是 | 要检索的事件的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `event` | object | 有关 Sentry 事件的详细信息 | + +### `sentry_releases_list` + +列出 Sentry 组织或项目的发布版本。返回包括版本、提交、部署信息和相关项目的发布详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Sentry API 身份验证令牌 | +| `organizationSlug` | string | 是 | 组织的 slug | +| `projectSlug` | string | 否 | 按特定项目 slug 筛选发布版本(可选) | +| `query` | string | 否 | 用于筛选发布版本的搜索查询(例如,版本名称模式) | +| `cursor` | string | 否 | 用于检索下一页结果的分页游标 | +| `limit` | number | 否 | 每页返回的发布版本数量(默认:25,最大:100) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `releases` | array | Sentry 发布版本列表 | + +### `sentry_releases_create` + +在 Sentry 中创建一个新版本。版本是部署到环境中的代码版本。可以包含提交信息和相关项目。返回创建的版本详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Sentry API 身份验证令牌 | +| `organizationSlug` | string | 是 | 组织的 slug | +| `version` | string | 是 | 版本标识符 \(例如,"2.0.0"、"my-app@1.0.0" 或 git 提交 SHA\) | +| `projects` | string | 是 | 与此版本关联的项目 slug 的逗号分隔列表 | +| `ref` | string | 否 | 此版本的 Git 引用 \(提交 SHA、标签或分支\) | +| `url` | string | 否 | 指向版本的 URL \(例如,GitHub 版本页面\) | +| `dateReleased` | string | 否 | 部署版本时的 ISO 8601 时间戳 \(默认为当前时间\) | +| `commits` | string | 否 | 包含 id、repository \(可选\) 和 message \(可选\) 的提交对象 JSON 数组。例如:\[\{"id":"abc123","message":"修复错误"\}\] | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `release` | object | 新创建的 Sentry 版本 | + +### `sentry_releases_deploy` + +为特定环境中的 Sentry 版本创建一个部署记录。部署记录跟踪版本的部署时间和位置。返回创建的部署详细信息。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | Sentry API 身份验证令牌 | +| `organizationSlug` | string | 是 | 组织的 slug | +| `version` | string | 是 | 部署的版本标识符 | +| `environment` | string | 是 | 部署版本的环境名称(例如,"production","staging") | +| `name` | string | 否 | 此次部署的可选名称(例如,"Deploy v2.0 to Production") | +| `url` | string | 否 | 指向部署的 URL(例如,CI/CD 管道 URL) | +| `dateStarted` | string | 否 | 部署开始时间的 ISO 8601 时间戳(默认为当前时间) | +| `dateFinished` | string | 否 | 部署完成时间的 ISO 8601 时间戳 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `deploy` | object | 新创建的部署记录 | + +## 注意 + +- 类别: `tools` +- 类型: `sentry` diff --git a/apps/docs/i18n.lock b/apps/docs/i18n.lock index 87b3c80120..80de9e68f3 100644 --- a/apps/docs/i18n.lock +++ b/apps/docs/i18n.lock @@ -2453,7 +2453,7 @@ checksums: content/10: 3b04588b480d6544f0229ce28b21224d content/11: 5f2cafef64da0c457716763f65d05caf content/12: 371d0e46b4bd2c23f559b8bc112f6955 - content/13: 0e2601b609b4c95beada4bd76ca52322 + content/13: 7a3e7967f85a496901076ad1ba98683c content/14: bcadfc362b69078beee0088e5936c98b content/15: 9d5d5f979dc1f1a21c93f63bf2cb1adf content/16: 207fd9316e6f5f7c8f9ba48d4f5a7a7f @@ -2465,7 +2465,7 @@ checksums: content/22: 8cb6669bf6d57235010862de548636e9 content/23: 8b8d96ec79fe97a769d7fd3e13d19bfb content/24: 371d0e46b4bd2c23f559b8bc112f6955 - content/25: 28dfe62caa68909eb253f0be68eeb658 + content/25: a97593e885de39102fe50dc9ecce0791 content/26: bcadfc362b69078beee0088e5936c98b content/27: c72a85c51da160a512d174810753bcd8 content/28: b3f310d5ef115bea5a8b75bf25d7ea9a @@ -4410,7 +4410,7 @@ checksums: content/14: 01b8941506483c3bbd8d03d7064cc4ae content/15: 2761b45701dcdee505d6b522e21af1bf content/16: 21f396ab14e4ae7853d79f352f7eeebb - content/17: 9a9774cec40cbdd2b14f4489b98d04eb + content/17: d869967bc0a87215c81a91aaaf6cc544 content/18: c4442ebf954ce44792673e999fa5ae57 content/19: 8a5bf876779f64c00bbfe410a76b876d content/20: 3baabe4ef51745247512b0226e9722da @@ -4531,10 +4531,10 @@ checksums: content/10: d19c8c67f52eb08b6a49c0969a9c8b86 content/11: 4024a36e0d9479ff3191fb9cd2b2e365 content/12: 0396a1e5d9548207f56e6b6cae85a542 - content/13: d014638b4fab46577558440eb368a36d + content/13: a6a8301f1aacee9f511e99740e110646 content/14: 890b65b7326a9eeef3933a8b63f6ccdd content/15: 892d6a80d8ac5a895a20408462f63cc5 - content/16: fb0ac212dcfa154f45570779d3c83656 + content/16: 930176b3786ebbe9eb1f76488f183140 content/17: 22d9d167630c581e868d6d7a9fdddbcf content/18: d250621762d63cd87b3359236c95bdac content/19: 50be8ae73b8ce27de7ddd21964ee29e8 @@ -4825,7 +4825,7 @@ checksums: content/12: 3feae99a88d11d54d43e8caab985b244 content/13: e50bd5107ca3410126cf0252b3c47eca content/14: 2da4c66be3932ebcc0d86d66e9c00919 - content/15: 4bcd866abc04fa7e7fd3b8b4e5b17e5d + content/15: 4c2e98bb00c2c3b3aad53097da81e948 content/16: 9ee411a24e109b1e6d9c322ca3bfccf8 content/17: 668793e8bd78ab4dc9a82e5d906fb770 content/18: c7a8a1c273afffd2bf9731087d97c086 @@ -5020,7 +5020,7 @@ checksums: content/11: 9b995c0ff96e18d698077a2d775af07d content/12: e50bd5107ca3410126cf0252b3c47eca content/13: 5a7bf52eb993cc64a21981bf57d0a7f4 - content/14: 4bcd866abc04fa7e7fd3b8b4e5b17e5d + content/14: 4c2e98bb00c2c3b3aad53097da81e948 content/15: 9ee411a24e109b1e6d9c322ca3bfccf8 content/16: 668793e8bd78ab4dc9a82e5d906fb770 content/17: c7a8a1c273afffd2bf9731087d97c086 @@ -5134,7 +5134,7 @@ checksums: content/9: e688b523909d6d6e9966c17892a18c96 content/10: e50bd5107ca3410126cf0252b3c47eca content/11: d03d17960348dea95c6df8f46114bd0a - content/12: 80da7e96414b75bb5b910c437bf7894a + content/12: 96a19f2fe56d94163eb2eb3683e50dd2 content/13: 6a7479225be3a7c7a42ba557ece50d03 content/14: c64f9cd5168b3e592fe3341cbe1a41fe content/15: 87d6b6280da1c98b1bc291483459c8cf @@ -5809,7 +5809,7 @@ checksums: content/13: 1f882cdaba7a9b78b05d26836e2411a5 content/14: eacb0ee18275bf6801de5d2eef84e493 content/15: 503ec68e64c9cbe4c283192659b5dbd2 - content/16: c09c061bd9bb350f345269de8532ac82 + content/16: 0e2f83dd597777c11517cceb208a7309 content/17: c128c130dd3d3fd4148323cfcb675db2 content/18: 83f4c595ce175cd6a414b46a88dfff57 content/19: a746c949b86da5eca4fe9e1624b07836 @@ -45477,3 +45477,650 @@ checksums: content/57: 865bee89ca6af3170d2b0682dd3bbc08 content/58: b3f310d5ef115bea5a8b75bf25d7ea9a content/59: 6f52ba90fdce587206b75878a322e55f + 86fb349534fd07528eeb26b692f32b43: + meta/title: 9eba9b92a167ba4f5ce7774d61ccde93 + meta/description: 3edbe3d9f558a0102eb3a7494e7e0cd7 + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: 04c9ad363607c64f1c2221745ac92f43 + content/2: 8829861c25f3749efb74790e8710da33 + content/3: a6344a8855a8598b17295015bc81d290 + content/4: 7f9e68509130d16642f55765aba495e5 + content/5: 585a32592b60c1019110ed534b6fe01c + content/6: 40fd01f0217a5135142487201098664e + content/7: 984c0dafe428c2797dd89a4f4306c59f + content/8: 821e6394b0a953e2b0842b04ae8f3105 + content/9: 7edcac23dba37460c8119a3021876020 + content/10: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/11: 3d5d48d04968f0179e62a2355f3b8e15 + content/12: 586d9d7f3cfffea89f20638b1048617b + content/13: 371d0e46b4bd2c23f559b8bc112f6955 + content/14: 43f76b166a80f9d5748154d62cd36b69 + content/15: bcadfc362b69078beee0088e5936c98b + content/16: 38eca0537544601d031275c2177d6ad7 + content/17: 4079b745f688e3b1126241d55383819c + content/18: e1cb20de018480d3038862c96cdcbc7b + content/19: 371d0e46b4bd2c23f559b8bc112f6955 + content/20: 7da135817e2a6409aa02997aa401b228 + content/21: bcadfc362b69078beee0088e5936c98b + content/22: 06c150b711bc45184218f874147ad063 + content/23: 391f786f723a9a433f0a12d2a6300794 + content/24: c34a5136c091ee4a3e234e80fb69770b + content/25: 371d0e46b4bd2c23f559b8bc112f6955 + content/26: 8ef9600a7ce6ece4e7f96a8fa19f9be3 + content/27: bcadfc362b69078beee0088e5936c98b + content/28: 4555691320be460d3e42b8bb0db8afd3 + content/29: c2286e24f4145b6cb76f83c1d98a35da + content/30: c266bdff9c3c3514dfda381b69527c01 + content/31: 371d0e46b4bd2c23f559b8bc112f6955 + content/32: 47557912ba721f04a272d0ee168911fc + content/33: bcadfc362b69078beee0088e5936c98b + content/34: 79d3930ec29eeac4731366126c1f55e2 + content/35: aa8bb14ebc89b75922c0bd1b9f8ddc93 + content/36: 2b18df69325865a4872caad0e361aa90 + content/37: 371d0e46b4bd2c23f559b8bc112f6955 + content/38: 588838219e6b5f65566fc15c47faa5cd + content/39: bcadfc362b69078beee0088e5936c98b + content/40: 05345f906f9f1040dcaffa682294d9a3 + content/41: c94d0fa02c754537c7214d7beefdedb8 + content/42: a37606f8a5ec864f850f8d202ad14e81 + content/43: 371d0e46b4bd2c23f559b8bc112f6955 + content/44: 04d289c689afb909b25988d07aeedbae + content/45: bcadfc362b69078beee0088e5936c98b + content/46: da71c0893f6bebb22decb5b619a94263 + content/47: 1e83d308ab7aeef0e72559c6ed159fc3 + content/48: b9d866215366db4f0143f272ac7a90ec + content/49: 371d0e46b4bd2c23f559b8bc112f6955 + content/50: c103529c4d05734d40e936732ca633b3 + content/51: bcadfc362b69078beee0088e5936c98b + content/52: aa079ad564035acdf76b52c88514a2e0 + content/53: f9c3a8f98cb17f63fdd00083e8476f09 + content/54: 9f0980882075b744dd69c50594882d05 + content/55: 371d0e46b4bd2c23f559b8bc112f6955 + content/56: 13f259aa2394f00c1be665962eea513a + content/57: bcadfc362b69078beee0088e5936c98b + content/58: db430683c69861a705ebd7817afa9b13 + content/59: 5138f9b84aed7a21d6b086cbaa4497f8 + content/60: 61752c141ce9918f550335070a138506 + content/61: 371d0e46b4bd2c23f559b8bc112f6955 + content/62: 8bd11713af708aed2843b04b5560fde0 + content/63: bcadfc362b69078beee0088e5936c98b + content/64: d351a6823f9bd14f2edf932cacc32e8d + content/65: 8fe24bebb1d222dd7e180d7fa58e298b + content/66: 88bde4f29d6a43e23d879d67bca470f2 + content/67: 371d0e46b4bd2c23f559b8bc112f6955 + content/68: af8f3df41ea103afe3a08a5c108d7428 + content/69: bcadfc362b69078beee0088e5936c98b + content/70: 460bc9a02d1e5c6c3cf18747766e9439 + content/71: a9a0f22d8bfa39e9decd2d451752401d + content/72: fc948825a6dcca6d7a20ee1860dfc9e0 + content/73: 371d0e46b4bd2c23f559b8bc112f6955 + content/74: 9c32d8dc11b2ac40c43843797c5046ad + content/75: bcadfc362b69078beee0088e5936c98b + content/76: b2008d417c1df0c5c39129a7bb25e701 + content/77: e9ab5d7292e6fadb77175b8e41862a0b + content/78: 34409c3943c18d78ec24c2b983798b3c + content/79: 371d0e46b4bd2c23f559b8bc112f6955 + content/80: a3cc25d1555cd2558325b7fb375ea881 + content/81: bcadfc362b69078beee0088e5936c98b + content/82: f997ffaa6bbc086d3aedaf4d90c091dc + content/83: b3f310d5ef115bea5a8b75bf25d7ea9a + content/84: 4c9a244d3788b6eb9ada549ee723629d + 2143d1c4ee2d97920be185fc27863e96: + meta/title: 9bfa2b5ee4278a8c915e9c7ef3a20755 + meta/description: 55f9e906b841377a238eaa70dc95f767 + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: eee72b53f5e5d53c2e44c3ce796cd9d0 + content/2: aa293d435651a90cad1033a95c872386 + content/3: 77a71e748470546acda9508aab5ff953 + content/4: 1f16dbfd92ab98604f05ad0db4508657 + content/5: 3980e10f82f77a27c1a805eeeedf15b9 + content/6: 4f8bb59656727edd845b0d9bce102d4b + content/7: 821e6394b0a953e2b0842b04ae8f3105 + content/8: 701c8a2db3fbc4b1e97573af295713c3 + content/9: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/10: 9666e13a994b777ed13e757a465ef046 + content/11: 761fbc7f76e1123e50075d1e8be8e404 + content/12: 371d0e46b4bd2c23f559b8bc112f6955 + content/13: d1112bcb2a2a63c9077cc2f6b30ba044 + content/14: bcadfc362b69078beee0088e5936c98b + content/15: 93c2553f65d3afc992bc7bc081ee25c9 + content/16: 46f6033efb5ec91430913700cb2632fa + content/17: 4d8c9023b0d694acb74dacf3e5f41d2f + content/18: 371d0e46b4bd2c23f559b8bc112f6955 + content/19: 791875326710bbf7326b8934b0fe5ec2 + content/20: bcadfc362b69078beee0088e5936c98b + content/21: b395bfddeed31ac07d511e1a970a40ff + content/22: 110d3d98b7fc021e6076d11a003c18dd + content/23: 39fc50e65bc685e9fc8f492998d8462b + content/24: 371d0e46b4bd2c23f559b8bc112f6955 + content/25: 142687c57a9b97db9b71bd8ae46331cb + content/26: bcadfc362b69078beee0088e5936c98b + content/27: 2569035dc61f0952b705cc2ccbf3e58b + content/28: 20eca54b9563c400ce893a7dd9a0b381 + content/29: 94a2b6c7b9bfa451f308a758e1347edc + content/30: 371d0e46b4bd2c23f559b8bc112f6955 + content/31: 69259b6b5b1732fe7fc4c89917f5113c + content/32: bcadfc362b69078beee0088e5936c98b + content/33: 6cfffdc67f01d5d77eb999b7cd97132f + content/34: b8e69f18a2d023ef8d013378ef81bf0b + content/35: 0c24ae0f264f645107b896758efb7449 + content/36: 371d0e46b4bd2c23f559b8bc112f6955 + content/37: 01c05f0cd0894d9ae1cd85c3e95661c1 + content/38: bcadfc362b69078beee0088e5936c98b + content/39: ef5f5213b4765c8da26fc309f7ce90f9 + content/40: b85c67769647939a595f523a9e809a4d + content/41: dfa472270e36fd014e790c168ab0ddeb + content/42: 371d0e46b4bd2c23f559b8bc112f6955 + content/43: 93c0149efbb8b80b330235eef6be4104 + content/44: bcadfc362b69078beee0088e5936c98b + content/45: 1f3271fdb87de2390905415340de8f58 + content/46: ad4bf438e42aa4daf5dac517088ee8d6 + content/47: f69cd5a758fd7706052e439f82b3b2a2 + content/48: 371d0e46b4bd2c23f559b8bc112f6955 + content/49: 5e7c5def8b718e6693f6b3d9866d6c17 + content/50: bcadfc362b69078beee0088e5936c98b + content/51: 0d67ff4fe974abed923f84d23b99a8a1 + content/52: 8e600ce2da3939eca0d106ed45ffbe50 + content/53: 9fff9f03032885b37a8465df116ceb54 + content/54: 371d0e46b4bd2c23f559b8bc112f6955 + content/55: efe97d3e6aecd9657470a2021d97f37d + content/56: bcadfc362b69078beee0088e5936c98b + content/57: 218c0faff0aec8fdf4b4e00ad66cb336 + content/58: caf1ed5fa3bb0224d5f8f0f1a999756f + content/59: 51ae84cb20decec28911d1aa56bce493 + content/60: 371d0e46b4bd2c23f559b8bc112f6955 + content/61: 5e167d0e8abf146461a8a0ade7dc1e3f + content/62: bcadfc362b69078beee0088e5936c98b + content/63: 37eb87ac4e111775bd43ec135e5844f1 + content/64: 3472296fe19ce29e8d68d0ab0c8b2798 + content/65: 81b4a163addae062c56a5eab6dc55a8b + content/66: 371d0e46b4bd2c23f559b8bc112f6955 + content/67: b29154f79cdf3e9f7424cd1814b0c82b + content/68: bcadfc362b69078beee0088e5936c98b + content/69: 22133d3321b950f407104bf0788c151c + content/70: 8077729acb5bb09b88813081c12c1f0e + content/71: adf1f3597bb55d7a11b8488d5da402df + content/72: 371d0e46b4bd2c23f559b8bc112f6955 + content/73: efe97d3e6aecd9657470a2021d97f37d + content/74: bcadfc362b69078beee0088e5936c98b + content/75: 9604defb91bdaa9b8e10f1a6531487d9 + content/76: a9e663412de0cb37792bf64f2a8280b5 + content/77: 851923974bc7fa99d4b3782d2c8b0868 + content/78: 371d0e46b4bd2c23f559b8bc112f6955 + content/79: 492f757e058fce0ffda1fbef91caae2f + content/80: bcadfc362b69078beee0088e5936c98b + content/81: 7e6bfab9ae2c51738e8fc35f3c96071e + content/82: 3b4bc99f80bb9141e7fd429101e0178b + content/83: d286efb5a0d2ede431c99aab50f66738 + content/84: 371d0e46b4bd2c23f559b8bc112f6955 + content/85: efe97d3e6aecd9657470a2021d97f37d + content/86: bcadfc362b69078beee0088e5936c98b + content/87: 44e696e9e004f6a900d830a50927110a + content/88: ac9e726e0ed919ea5f0f83869abb394b + content/89: 3323e25821011e59a1dba4977720ba49 + content/90: 371d0e46b4bd2c23f559b8bc112f6955 + content/91: efe97d3e6aecd9657470a2021d97f37d + content/92: bcadfc362b69078beee0088e5936c98b + content/93: 5948e5c3f938cf9ff8fa941771f7df01 + content/94: 62d417d513d03d9c79a54c25c0e715fd + content/95: 2413cc10b46aa4c20d428f258fbbf7da + content/96: 371d0e46b4bd2c23f559b8bc112f6955 + content/97: 423d026a5ede2367cbf2b4ab37b9c61b + content/98: bcadfc362b69078beee0088e5936c98b + content/99: 0f1119837c82686792176610146fc086 + content/100: 90cbddcaa157b79a3c45c23bc92cb05e + content/101: 0f95a6ba75572d019fd6216feb1b370c + content/102: 371d0e46b4bd2c23f559b8bc112f6955 + content/103: 34d29668ea079220c0d287726d9b1132 + content/104: bcadfc362b69078beee0088e5936c98b + content/105: 6ff8aa9fb25a91a26da64265c379ff80 + content/106: 529e0965c997dffa27d81da261d3061e + content/107: 93670e278b58ac477c4de256c7c8fb76 + content/108: 371d0e46b4bd2c23f559b8bc112f6955 + content/109: efe97d3e6aecd9657470a2021d97f37d + content/110: bcadfc362b69078beee0088e5936c98b + content/111: 845b6a205b815534820511fae8e4c904 + content/112: 60694125898f101cb6e8be074b047f4d + content/113: 731b0f7e7fa6c4b62d191e27ab082b36 + content/114: 371d0e46b4bd2c23f559b8bc112f6955 + content/115: 546ae5d7209c411f75e97db650fdb870 + content/116: bcadfc362b69078beee0088e5936c98b + content/117: 5cb5ba33dbdfe3151c02862782c9ee86 + content/118: b2b2d194e0805efce07172a8b749160c + content/119: 43e67fbb9ea4749129a11aa7c3f5390a + content/120: 371d0e46b4bd2c23f559b8bc112f6955 + content/121: ce7365ded1b15ad7d4a0690f01f21751 + content/122: bcadfc362b69078beee0088e5936c98b + content/123: 5742a9f35608f7047a12a68d144c4e2d + content/124: c8db3c24bbc13c2a50239a88405c8eb3 + content/125: 61a522c85d7cf6348e73fbf6a8ee40c3 + content/126: 371d0e46b4bd2c23f559b8bc112f6955 + content/127: 6b001a0911b6d1cef5918104df4279fe + content/128: bcadfc362b69078beee0088e5936c98b + content/129: 53946e9d12f1ff67fba051ccb3ce6e56 + content/130: 6bec56edde353001d37a72789f63c1e9 + content/131: b211bb6658369e9114f167507a8148e1 + content/132: 371d0e46b4bd2c23f559b8bc112f6955 + content/133: 80a9048b7c5e4b65c8ebf55dec1acb43 + content/134: bcadfc362b69078beee0088e5936c98b + content/135: b2baaaf48865c5c57228207bbf0d2d58 + content/136: 1abdf77ed04353c9af670af692c6ce68 + content/137: d4ed8cd2ec616a3a63f79b75b77807d5 + content/138: 371d0e46b4bd2c23f559b8bc112f6955 + content/139: 9792fef98b156a9bdbb1244cddba89e4 + content/140: bcadfc362b69078beee0088e5936c98b + content/141: 207b112157dda041fb42901a51339958 + content/142: bf5af1182c9c8759ee6fe0f4aebd1a14 + content/143: be6be7c676c264a84b6a8daa514da2a0 + content/144: 371d0e46b4bd2c23f559b8bc112f6955 + content/145: ae1ed02ff62ea27a9fc63ef7c88d6f84 + content/146: bcadfc362b69078beee0088e5936c98b + content/147: 01740e5e76d171a96aa79a88795e292a + content/148: face64b059e24d5b3bf2a17c6078692f + content/149: 1973b4be824a13122a29b4c8d33e4321 + content/150: 371d0e46b4bd2c23f559b8bc112f6955 + content/151: a1ff6347e49b331d723f416a2ad732d3 + content/152: bcadfc362b69078beee0088e5936c98b + content/153: f6699a946788785b5f1f1c47d32824ce + content/154: e77077eb0c5ec1e6868ad86e9363f41e + content/155: 62707f01c2c2fb3af7ada39108df4da0 + content/156: 371d0e46b4bd2c23f559b8bc112f6955 + content/157: ce7365ded1b15ad7d4a0690f01f21751 + content/158: bcadfc362b69078beee0088e5936c98b + content/159: 08b17e214fbd9f2b240ff8ea4eb20600 + content/160: 35036c72a797d01aeb583e8b74a54b2e + content/161: 3717d46968e4ff86ade273bd0b8f27bf + content/162: 371d0e46b4bd2c23f559b8bc112f6955 + content/163: 593d99cc63542f533caa03f13b40df0c + content/164: bcadfc362b69078beee0088e5936c98b + content/165: 6aea1f0e00031735184bd6343bff1ef0 + content/166: fa59b3d80ab0bc77364c7510db9a5428 + content/167: 2a5130c7366dd13fece0142e03be9f1b + content/168: 371d0e46b4bd2c23f559b8bc112f6955 + content/169: b17158532d9e0c83ac615b238ce1ecc7 + content/170: bcadfc362b69078beee0088e5936c98b + content/171: 3c99f9d04463316c11630382cddf2a43 + content/172: 03abbeee38813b014c642c95c460452a + content/173: 954ab16a7db625663a96a1e9441fa2aa + content/174: 371d0e46b4bd2c23f559b8bc112f6955 + content/175: 6068317e91217be85f03d2bc6d225bf0 + content/176: bcadfc362b69078beee0088e5936c98b + content/177: c6dae875d4f0ae49ead1b0c3a1c6784c + content/178: a176eb6226c3d379183d714b001961b6 + content/179: 4680a9ed0c75487ba3ac22a8dba093e7 + content/180: 371d0e46b4bd2c23f559b8bc112f6955 + content/181: 1c3fe823132c0b81bccd9d57ff4f8282 + content/182: bcadfc362b69078beee0088e5936c98b + content/183: 184b1251c41e09f532ba4ab0118a8a77 + content/184: 7444f6919ea92c571a9e808a301c2cb5 + content/185: 7ba4bf56413c39f9c6fb00df249d84c9 + content/186: 371d0e46b4bd2c23f559b8bc112f6955 + content/187: 9e14672e21bdcd02ebc4835e1a859b50 + content/188: bcadfc362b69078beee0088e5936c98b + content/189: cce65fd1e13795acd5d738663ce0e280 + content/190: 22ae91363b11d2570886d768f1a34bf3 + content/191: 3d4552ade13fac9c4a5d018289773f87 + content/192: 371d0e46b4bd2c23f559b8bc112f6955 + content/193: 813d69956f3c4f1fb15b470188d640cf + content/194: bcadfc362b69078beee0088e5936c98b + content/195: 22b965233de807cfab345accc1b142db + content/196: f7dbdb28b233488e29f61cee9feb76a9 + content/197: d485952ea3bf6b7b63472fe98a2f2142 + content/198: 371d0e46b4bd2c23f559b8bc112f6955 + content/199: bae875861d40acda4263a256b9cd8c39 + content/200: bcadfc362b69078beee0088e5936c98b + content/201: 783fff0abd0ed6b31013bdc9f0735163 + content/202: a1f4937f85c5c73eb5c99637b7498762 + content/203: 452fc396ef58cf4ca77268c2ece2609a + content/204: 371d0e46b4bd2c23f559b8bc112f6955 + content/205: ae5c32cc2bb80cab58581af5775b0140 + content/206: bcadfc362b69078beee0088e5936c98b + content/207: 1f0eaa3a62805723f9489d57513fed20 + content/208: 2a19e486310b819920e94df4840e3db5 + content/209: 7a9a196030843828ff242b8b6390c7e4 + content/210: 371d0e46b4bd2c23f559b8bc112f6955 + content/211: 6068317e91217be85f03d2bc6d225bf0 + content/212: bcadfc362b69078beee0088e5936c98b + content/213: 6f61e3647fc276a6aa3da1c97a703db8 + content/214: 4fd5462cc7d3dca08239a8271c7c8dc0 + content/215: fe95e4ba59e8e27d1bca6c6bf168c535 + content/216: 371d0e46b4bd2c23f559b8bc112f6955 + content/217: 136dc4d472195584b993a807b6e315fd + content/218: bcadfc362b69078beee0088e5936c98b + content/219: 2772f030e17300739c23b80d5bf97da6 + content/220: 681500e7f9129c0bb337b524f600468d + content/221: afd45473479e47836cc9366eec28b3c7 + content/222: 371d0e46b4bd2c23f559b8bc112f6955 + content/223: 45622c4b33e4a253cbdc0cc29bc829c6 + content/224: bcadfc362b69078beee0088e5936c98b + content/225: c393f2f321ac983c010df4dcfae7ffd8 + content/226: d7c1d22e2c65651193408aa0e7be8daa + content/227: 35d63c869cc3c912d5a3c9817da0e763 + content/228: 371d0e46b4bd2c23f559b8bc112f6955 + content/229: bba842295b2d7fbc2150c368b6707909 + content/230: bcadfc362b69078beee0088e5936c98b + content/231: f3ac5e7af6586e5b3de7904c99360502 + content/232: 7f3270013d7742986d13b379c86d78b3 + content/233: 40bd7cea33d9380b926f970a6ab50d3f + content/234: 371d0e46b4bd2c23f559b8bc112f6955 + content/235: 490b3fcc4a98f2d7aa5ee5c8e7d4e54e + content/236: bcadfc362b69078beee0088e5936c98b + content/237: e47fd02a4b143503e43c15f4b4ae788c + content/238: 220e26b5643e021eaa6e26b400733b7c + content/239: f8ca84f508b847fece7ee0596b096317 + content/240: 371d0e46b4bd2c23f559b8bc112f6955 + content/241: 2c2325a81b649d914275c2490f4a643c + content/242: bcadfc362b69078beee0088e5936c98b + content/243: 207341d0e6c91517ac36dd2a6d817aa5 + content/244: cd1b225752f6793d0b0c1b40844a5392 + content/245: a861adecf1597d48f9e2208e5c04517a + content/246: 371d0e46b4bd2c23f559b8bc112f6955 + content/247: 5a74c9334b57c9071241c9f155cf7575 + content/248: bcadfc362b69078beee0088e5936c98b + content/249: ff259ef87beaac17f6a520027aa249fc + content/250: 5dd5be33ff41752163d34ba21eb0deae + content/251: fe35d624930a4960b98d36a128f61efa + content/252: 371d0e46b4bd2c23f559b8bc112f6955 + content/253: e987b17351a321386a94b8ac3c086bc2 + content/254: bcadfc362b69078beee0088e5936c98b + content/255: b227d26f3ed11dbbf459e9147c1fa6b2 + content/256: 90faac8159690aa56b11f3aa4d6b2aa3 + content/257: 0826aacf8530c935fcea8a03aeafbe32 + content/258: 371d0e46b4bd2c23f559b8bc112f6955 + content/259: b7808a36d112b8821835f62059f645e9 + content/260: bcadfc362b69078beee0088e5936c98b + content/261: f78e5b396f022dc562d6de689fb6f5c3 + content/262: d97e986eec58a77aab60718da9b11250 + content/263: 41cdfdedaaf43766b08e1b70afd102a4 + content/264: 371d0e46b4bd2c23f559b8bc112f6955 + content/265: e987b17351a321386a94b8ac3c086bc2 + content/266: bcadfc362b69078beee0088e5936c98b + content/267: 7f8d12787e2e9581fcb44839e67da547 + content/268: 579ad7b1aa6999ac556ceb7245b58414 + content/269: e266295988f7e506d0c50b44ec1eda97 + content/270: 371d0e46b4bd2c23f559b8bc112f6955 + content/271: 0e2c29096bea271a60bcafc98b4db9e1 + content/272: bcadfc362b69078beee0088e5936c98b + content/273: d4895f5a2e8657455736aa8b9b1ebc46 + content/274: b3f310d5ef115bea5a8b75bf25d7ea9a + content/275: f03741f386b9d12bf2f3c8279f0423b6 + 800ce8bbe6f3a39acf9be111195ff41a: + meta/title: 0ebd16d99f130a288134b589b0e7a48a + meta/description: cf4913a25de668c770a46d6db6dd9375 + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: 0baee3631bbd627fe47bc688e664838f + content/2: 0ea1216a4da9b556a390e537b8ffdb54 + content/3: 53d5bf29019fb7055993589c1dc16347 + content/4: 14e17d3cadf657bb71fe513f333938c7 + content/5: 531e0e5a48272bb3c78dd45c4626cc83 + content/6: 34405235b12d6b70e40ddcb02a253a5d + content/7: fe284a5b25ad042f1866cfabd16031e7 + content/8: 821e6394b0a953e2b0842b04ae8f3105 + content/9: f05e0d41ee72c184028117323f953bc1 + content/10: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/11: 9548a5ebf2d416f7e7e2a498dcf47179 + content/12: be5993ee4544ff50699ebba09fa86564 + content/13: 371d0e46b4bd2c23f559b8bc112f6955 + content/14: c0c9c634e60e03980bb13cb5f3b627c5 + content/15: bcadfc362b69078beee0088e5936c98b + content/16: a869415b6d93856eb0ec2091f28ec6b0 + content/17: 94ce45f9769213aa31609b4f1a4e9528 + content/18: 22018d5b53a11b2d041e475140b32b9b + content/19: 371d0e46b4bd2c23f559b8bc112f6955 + content/20: 75b220a3bd411b4a37792633cb7aa283 + content/21: bcadfc362b69078beee0088e5936c98b + content/22: 57da732e90884c0990f69f32a70d7225 + content/23: 7ad103d36cc40d520ad5899cfbd15cfa + content/24: 45e4f727c24dd2d4a6f52aa866f54fa5 + content/25: 371d0e46b4bd2c23f559b8bc112f6955 + content/26: 8c65701b5e426eb5d22d26930164c236 + content/27: bcadfc362b69078beee0088e5936c98b + content/28: 16033f55aa874c387d52fe14034be4df + content/29: 39c0a5f0a5e3ed172eddea6e69c7587b + content/30: 7b24181bfdc3e38cbac563671e009f6b + content/31: 371d0e46b4bd2c23f559b8bc112f6955 + content/32: 503372a10f67bbe3372b13708218c42a + content/33: bcadfc362b69078beee0088e5936c98b + content/34: d0299aa1983e2f656e53ca5a813f2064 + content/35: 208f872e5594b11885ef4d09dbe9593e + content/36: c73ec60f09ec3c2d6bd0ae68df3d65cc + content/37: 371d0e46b4bd2c23f559b8bc112f6955 + content/38: ada6d52a5875ff63c7f8f419bec6b43e + content/39: bcadfc362b69078beee0088e5936c98b + content/40: e41202bfa92ca93e1f41cdddcae06eb9 + content/41: 262056c658837f637c566947a38cdf82 + content/42: 628f1dfda93230515cfbbd303596bc76 + content/43: 371d0e46b4bd2c23f559b8bc112f6955 + content/44: 7056d13cee5f006dea1e660dc7e94b64 + content/45: bcadfc362b69078beee0088e5936c98b + content/46: 795a0c3e5311ad460566ad6c3fcb18c5 + content/47: db57b0dcbbc904ea50a4ebcabd751f42 + content/48: 2150a73bf1318bdc52c4f53a0440d307 + content/49: 371d0e46b4bd2c23f559b8bc112f6955 + content/50: a7a19e7f4d022f40f06d02e4260b3f40 + content/51: bcadfc362b69078beee0088e5936c98b + content/52: 53d429b25a4af79a2f1b6053d0ce8573 + content/53: 79fc4ce9bfa74a181a8cac8ce8bd3172 + content/54: f870f1412539e088c30d7bbceb8d7c36 + content/55: 371d0e46b4bd2c23f559b8bc112f6955 + content/56: 5b37691760df7d760cb7857ee2541a45 + content/57: bcadfc362b69078beee0088e5936c98b + content/58: 864669c93927ce4c05885029e0fcf152 + content/59: 1ab944bdbf6333582fa128c067d30055 + content/60: 9bdca117a45e0466c1c9417ae025cee5 + content/61: 371d0e46b4bd2c23f559b8bc112f6955 + content/62: 8ff3237c259c1c7c81c3e9374e52ea37 + content/63: bcadfc362b69078beee0088e5936c98b + content/64: 584b40df845b386a2de9f5dd62040be5 + content/65: 1f7316761f00e4de5555bd08f8984ed1 + content/66: 6ecc504ab9016abaf1e9e2a1d965a62f + content/67: 371d0e46b4bd2c23f559b8bc112f6955 + content/68: 47b4a44ad05668006ef996f606be0e0d + content/69: bcadfc362b69078beee0088e5936c98b + content/70: 4a7b04bf058e905f1db8650bef62286a + content/71: d758af6f6e0282f609a82105107c14ce + content/72: ef85f8d1611e4815d84d148100722f0d + content/73: 371d0e46b4bd2c23f559b8bc112f6955 + content/74: 6bdb0b2dd46ff55ee4986cdb7cc9446c + content/75: bcadfc362b69078beee0088e5936c98b + content/76: 76161cd96c3dda6971c36c029302e485 + content/77: 604a6a9a5c60d3621ddaee3fdbff9c03 + content/78: c829e7cad028da1114da8f9a7c5f86c9 + content/79: 371d0e46b4bd2c23f559b8bc112f6955 + content/80: 30615edede17780995825fbdc0097e09 + content/81: bcadfc362b69078beee0088e5936c98b + content/82: 5d1691a382da8d13d241dc81f90cacca + content/83: 570aeb90bb50abde50071b7e74400bbe + content/84: dd08f126847ba709a50bde56c8ba0681 + content/85: 371d0e46b4bd2c23f559b8bc112f6955 + content/86: c15977e1762245fe03389305c96bc971 + content/87: bcadfc362b69078beee0088e5936c98b + content/88: 8035d73749e1ec9e00d1f60377aba7a3 + content/89: 9d5a7f80a89f101d3a33e98663cce1de + content/90: 978995b77530c83b8d2152a7100799de + content/91: 371d0e46b4bd2c23f559b8bc112f6955 + content/92: f922dfdaf227f98da4868c6de1ac207a + content/93: bcadfc362b69078beee0088e5936c98b + content/94: 2b3c80bcbce92fe344b5d92ace204b15 + content/95: f94c489fb98fa7d1d2160a13c6b9dc2b + content/96: 64e2b78f1d1939ea50126585208f9dbe + content/97: 371d0e46b4bd2c23f559b8bc112f6955 + content/98: 4e02393a14fdfaa65fccc1f7d55085c8 + content/99: bcadfc362b69078beee0088e5936c98b + content/100: 9674d83a67fe5303ba34a266adbfc946 + content/101: aad37058044de6d953642c346e924db7 + content/102: 9d5ce4e0b522efb2f2512ce6018def39 + content/103: 371d0e46b4bd2c23f559b8bc112f6955 + content/104: a6199a2c8a7fb18e3105273cdaa1c11c + content/105: bcadfc362b69078beee0088e5936c98b + content/106: 7392d0d796561cd8de84aeddf0c4dfb8 + content/107: af620d8c1ccfb23e71b1dcfc1916ce4e + content/108: 58a75a75560e12cfeb6f5b87940a2917 + content/109: 371d0e46b4bd2c23f559b8bc112f6955 + content/110: 36a758519738100d3b96fb6afe32e044 + content/111: bcadfc362b69078beee0088e5936c98b + content/112: a7f6694c5b74812e7106baac5fdcf4ff + content/113: 61f62451582748e0ed3dbc1e2fe5a85e + content/114: 03da6d5c0e86cf220a45e3618628ed32 + content/115: 371d0e46b4bd2c23f559b8bc112f6955 + content/116: f3f04e72c93bb67b9d324c881485a501 + content/117: bcadfc362b69078beee0088e5936c98b + content/118: 0c3b89bd00a8d061646b17910809500d + content/119: eecf897a6786b775557f2682cc7b1c9e + content/120: 0adda5aa6f6b32d5bbb67f944801c0af + content/121: 371d0e46b4bd2c23f559b8bc112f6955 + content/122: 1254f872003f68913e45bdf471ca332f + content/123: bcadfc362b69078beee0088e5936c98b + content/124: 2b3c80bcbce92fe344b5d92ace204b15 + content/125: f1a1112fa0cd3e7dad2d35167bfc74ef + content/126: e01eac297a52723bb187e910e0101c1d + content/127: 371d0e46b4bd2c23f559b8bc112f6955 + content/128: 2e6131bcc19708826982828bc3385770 + content/129: bcadfc362b69078beee0088e5936c98b + content/130: 4965a0834597414016c349b8a12d49b1 + content/131: 02337abdd0224ff9a951fb4405b39983 + content/132: eaa09f7425ce87670040364c6279d618 + content/133: 371d0e46b4bd2c23f559b8bc112f6955 + content/134: d81bdcca0476a76e160a9eda4af3dc74 + content/135: bcadfc362b69078beee0088e5936c98b + content/136: 61f40f8a9aebaa953e632301d71ea2e1 + content/137: 2ed3288fb70a7a5d15135680e8a75a93 + content/138: e90c59b850cc51072de6eb05f8236e39 + content/139: 371d0e46b4bd2c23f559b8bc112f6955 + content/140: 77a63b21c56933af7783726b78dcde12 + content/141: bcadfc362b69078beee0088e5936c98b + content/142: 2ed40e6fc40178b54768db71c96a6790 + content/143: b30cf88e92d6d8eda845bc7f5bb2c0cd + content/144: e899e22ead5f122f99b770348c019cd1 + content/145: 371d0e46b4bd2c23f559b8bc112f6955 + content/146: 657b0464b33dec6b7a0b3bf9d6286874 + content/147: bcadfc362b69078beee0088e5936c98b + content/148: 7d9ee64a87436ee83722d0bed5d9d40e + content/149: 00de7cd3b154f451f73c9f0a2ab98b11 + content/150: 1bd8c634eb3708956c2a813b1bc886b7 + content/151: 371d0e46b4bd2c23f559b8bc112f6955 + content/152: bc80a869e7c65b35fc97715845246a5a + content/153: bcadfc362b69078beee0088e5936c98b + content/154: 02a0156ff1d422d1cbbefcfa7eb5893d + content/155: 48946bcccd3128ce65f9afe07f815cab + content/156: d627c20eac6a53d7992e2d09957d4736 + content/157: 371d0e46b4bd2c23f559b8bc112f6955 + content/158: daa0745f44574d098df908cd72cf17bf + content/159: bcadfc362b69078beee0088e5936c98b + content/160: c84a0981ce620c195c75daa70dc212c1 + content/161: 05d22feb83300286158e5588c2d826b0 + content/162: 8e81c7747d4a941116d9d09f764c0bdc + content/163: 371d0e46b4bd2c23f559b8bc112f6955 + content/164: ae8fd243a608163ad8ca6ab6321fdda6 + content/165: bcadfc362b69078beee0088e5936c98b + content/166: 5bb27dbb745ff89cd888b9137245c756 + content/167: 8d97080e96426d5d97f5742ff8276b9e + content/168: 2cfe59668908aad68b7f1452b7399dca + content/169: 371d0e46b4bd2c23f559b8bc112f6955 + content/170: daa0745f44574d098df908cd72cf17bf + content/171: bcadfc362b69078beee0088e5936c98b + content/172: 2b3c80bcbce92fe344b5d92ace204b15 + content/173: ffb2b5c1442700efdd8ebccf98130ab6 + content/174: 34d098af819bab3628b1809e0094718a + content/175: 371d0e46b4bd2c23f559b8bc112f6955 + content/176: 7ea1e0c34b4b3b4621f14dbc36fa09fd + content/177: bcadfc362b69078beee0088e5936c98b + content/178: ae5dbfc0327283374b79c23b833db8d5 + content/179: 71b581b0bcbbdedc2aef4356dc53465d + content/180: 5a6fc1f06995dd878f3a4f26452c4e58 + content/181: 371d0e46b4bd2c23f559b8bc112f6955 + content/182: 7ea1e0c34b4b3b4621f14dbc36fa09fd + content/183: bcadfc362b69078beee0088e5936c98b + content/184: 3185dd266996c325cb06903219b56f90 + content/185: b479acea095a2975d94d6799abaf7bf8 + content/186: e5d02785b4b0ea3033eb5d8b7d6b3c06 + content/187: 371d0e46b4bd2c23f559b8bc112f6955 + content/188: 7ea1e0c34b4b3b4621f14dbc36fa09fd + content/189: bcadfc362b69078beee0088e5936c98b + content/190: a7b9cab710be9cb01350987a39d9a04c + content/191: 2556b9df56f831004631ff267aef874f + content/192: 4a51503b42f7d537871a91c3c2b9d668 + content/193: 371d0e46b4bd2c23f559b8bc112f6955 + content/194: 657b0464b33dec6b7a0b3bf9d6286874 + content/195: bcadfc362b69078beee0088e5936c98b + content/196: 35171378f467b0df0066321acf352822 + content/197: 67b06ee46cea91e7eeaea157bec286d3 + content/198: 0d0db71755b778d03525f27f24b42bc1 + content/199: 371d0e46b4bd2c23f559b8bc112f6955 + content/200: 94bd582d35e7ad9979344880c496094b + content/201: bcadfc362b69078beee0088e5936c98b + content/202: 3a0a27fb0b248bed33134f726166cf31 + content/203: ea21bcf579a37316fcf50797b47f106e + content/204: 9b192fcd79cebbf1d623f4feb67c2809 + content/205: 371d0e46b4bd2c23f559b8bc112f6955 + content/206: 322f9ddd60d715a0d8b1155959b488c8 + content/207: bcadfc362b69078beee0088e5936c98b + content/208: bad6ad5db3057bca25fea110bd9f4775 + content/209: e7965db83d663f7d3336c02aee6ab5cc + content/210: 23237fc498e703db4be130c87a0332b1 + content/211: 371d0e46b4bd2c23f559b8bc112f6955 + content/212: bacd78e2b3feee1442b40f3655f348fa + content/213: bcadfc362b69078beee0088e5936c98b + content/214: 8d959335363f4bcf6f6b12d8ac0542b1 + content/215: 4566c4b3084dd0cc5379fb1deaf6fd9e + content/216: 82715fcd2aa66ec7d7a255597a6347d4 + content/217: 371d0e46b4bd2c23f559b8bc112f6955 + content/218: 30be13c2e76a54d8b844f3d4735e39d4 + content/219: bcadfc362b69078beee0088e5936c98b + content/220: 2b3c80bcbce92fe344b5d92ace204b15 + content/221: 37d55862104cff8c9cca3f9ad1ba2bb2 + content/222: f103511f99691a7614613deb922979ac + content/223: 371d0e46b4bd2c23f559b8bc112f6955 + content/224: 657b0464b33dec6b7a0b3bf9d6286874 + content/225: bcadfc362b69078beee0088e5936c98b + content/226: f3daae51b9072203b1b70c9b8653c429 + content/227: 7fbb1ffcb79044d3ead8be10351c14da + content/228: dd2d72dc82cb49e35894a6f183f2e51d + content/229: 371d0e46b4bd2c23f559b8bc112f6955 + content/230: 0edcbb0a53df61f91f64c257b86ef852 + content/231: bcadfc362b69078beee0088e5936c98b + content/232: f9c31995057e451c2316c26269310ca5 + content/233: eedd27bc9d874297bab2d4ca33a9e4e0 + content/234: f3ad403e9656d2fe6e27fe3cfbca0b60 + content/235: 371d0e46b4bd2c23f559b8bc112f6955 + content/236: 5c4e2621e62182d96de41bd42c8c1000 + content/237: bcadfc362b69078beee0088e5936c98b + content/238: ab48208e48d1c7fa8e09f8ccfec11910 + content/239: 4a3a35d10c539f316265800d3a2df8e5 + content/240: 1cc0e1eb7174f0f2d88cfe7a582bd593 + content/241: 371d0e46b4bd2c23f559b8bc112f6955 + content/242: e293556eb7c97705029e6b1f8615d35e + content/243: bcadfc362b69078beee0088e5936c98b + content/244: b2c5a17ae55992be986981f56db82f82 + content/245: df7e7a3b6c956149253b19f61bb0c2a6 + content/246: f18b224dfffab17bf3c4d36e5d90c67a + content/247: 371d0e46b4bd2c23f559b8bc112f6955 + content/248: ae5e0e400dd36bb88ff6017db725b79e + content/249: bcadfc362b69078beee0088e5936c98b + content/250: ba02f697227a11bbcfa5d9be57d4f1b6 + content/251: 8443f9688c995b1bb80500588db0016e + content/252: da3fe6a2a9eb30f89418c81564fd4aca + content/253: 371d0e46b4bd2c23f559b8bc112f6955 + content/254: c173785b767c0049a40eb60bb76a12c3 + content/255: bcadfc362b69078beee0088e5936c98b + content/256: 9d0a513a105fab7cb1c99205954edd73 + content/257: 715672452899d6bc193a669da455315a + content/258: e547a4ebc81e99b9754015e463d670fd + content/259: 371d0e46b4bd2c23f559b8bc112f6955 + content/260: 24ee435761f8906e81bd2a32b28f588a + content/261: bcadfc362b69078beee0088e5936c98b + content/262: 934f1c23571352f7a77eb82aee3dee24 + content/263: ed8f2e7ce45317cf58adbb7557c0737b + content/264: e7b8cb8737b44163a20c60c047ee982c + content/265: 371d0e46b4bd2c23f559b8bc112f6955 + content/266: 94384a3dd7165cadb559d7dfffb4a1a8 + content/267: bcadfc362b69078beee0088e5936c98b + content/268: 0bb7d21c740d8f9fd08ee5e437e720c1 + content/269: 0a3197e1e858c53a57d16c000c274a23 + content/270: 78dccafec4713dc897d9584d104da183 + content/271: 371d0e46b4bd2c23f559b8bc112f6955 + content/272: 456416f808059e0858caad8b6ceffe1d + content/273: bcadfc362b69078beee0088e5936c98b + content/274: 2b3c80bcbce92fe344b5d92ace204b15 + content/275: b3f310d5ef115bea5a8b75bf25d7ea9a + content/276: 9dff534bf0aab9094e712a33a704e047