Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Action-Anschlüsse
<a name="action-integrations"></a>

Action Connectors verwenden sichere Verbindungen zu externen Diensten und führen Aktionen auf der Grundlage Ihrer Authentifizierungsstufe und Ihrer Berechtigungen aus.

# So funktionieren Action-Konnektoren
<a name="int-actions-how-it-works"></a>

Action-Konnektoren in Amazon Quick stellen sichere Verbindungen zwischen Amazon Quick und externen Diensten her. Wenn Sie diese Integrationen konfigurieren, können Sie Aktionen auf der Grundlage Ihrer Authentifizierungsstufe und Ihrer Berechtigungen ausführen.

## Kernkomponenten
<a name="qbs-actions-how-it-works-qbs-actions-core-components"></a>

**Action-Konnektoren**  
Die grundlegenden Ressourcen, die in externe Dienste integriert werden können. Amazon Quick unterstützt 15 Integrationen von Drittanbietern und 5 AWS Serviceintegrationen. Informationen zur Einrichtung AWS integrierter Service Action Connectors finden Sie unter. [AWS Konnektoren für Serviceaktionen](builtin-services-integration.md)

**Authentifizierungsmethoden**  
Action Connectors unterstützen mehrere Authentifizierungsmethoden, darunter verwaltete (3LO), benutzerdefinierte, benutzerbasierte Authentifizierungsmethoden, API-Schlüssel und 2LO. Ausführliche Informationen zu den einzelnen Authentifizierungsmethoden finden Sie unter. [Authentifizierungsmethoden](action-connector-apis.md#action-connector-apis-authentication)

**Implementierungsarten**  
+ **On-Demand-Aktionen für sofortige, vom Benutzer ausgelöste Operationen** — Echtzeitoperationen, die sofort ausgeführt werden, wenn Sie sie auslösen. Sie können Aktionen über Chat-Benutzeroberflächen, Dashboards oder Amazon Q Apps initiieren. Beispiele hierfür sind das Erstellen von Tickets, das Senden von Nachrichten oder das Abfragen von Daten.
+ **Automatisierte Workflows für geplante oder vom System ausgelöste Aufgaben — vom** System verwaltete Operationen, die auf der Grundlage von Zeitplänen oder Triggern ausgeführt werden. Sie werden ohne Benutzereingriff im Hintergrund ausgeführt. Beispiele hierfür sind Datensynchronisierung, Berichtserstellung oder Systemwartung.

**Berechtigungsmodelle**  
+ **Persönliche Zugriffsberechtigungen über 3LO** — Sie können Amazon Quick über Three-Legged OAuth bestimmte Berechtigungen gewähren und behalten so die Kontrolle über Ihren Servicezugriff. Die Berechtigungen sind an Ihre Identität und Ihre Anmeldeinformationen im Zieldienst gebunden.
+ **Berechtigungen auf Dienstebene für automatisierte Workflows** — Diese Berechtigungen werden auf automatisierte Workflows angewendet und unterstützen system-to-system Interaktionen ohne Benutzereingriff. Sie werden auf Serviceebene konfiguriert und verwenden in der Regel API-Schlüssel oder Anmeldeinformationen für Dienstkonten.
+ **Zugriffskontrollen auf Entitätsebene** — Steuern Sie den Zugriff auf Aktionen innerhalb von Amazon Quick und legen fest, welche Benutzer oder Gruppen bestimmte Aktionen ausführen können. Diese Kontrollen lassen sich in das umfassendere Berechtigungssystem von Amazon Quick integrieren und sorgen so für eine konsistente Zugriffsverwaltung auf der gesamten Plattform.

# Arten von Aktionen
<a name="int-actions-types"></a>

Amazon Quick unterstützt zwei Methoden zum Aufrufen von Aktionen, die jeweils unterschiedliche Anwendungsfälle und Authentifizierungsmodelle abdecken.

## Aktionen auf Abruf
<a name="qbs-actions-types-qbs-actions-on-demand"></a>

On-Demand-Aktionen werden sofort ausgeführt, wenn Sie sie auslösen. Diese Aktionen unterstützen interaktive Operationen, die eine Reaktion in Echtzeit erfordern.

**Wichtigste Merkmale:**
+ Benutzerinitiierte Ausführung — Sie lösen Aktionen in natürlicher Sprache in der Chat-Oberfläche aus.
+ Interaktives Ausfüllen von Formularen — Sie füllen Formulare mit den erforderlichen Parametern aus, bevor die Aktion ausgeführt wird.
+ Sofortige Reaktion — Aktionen werden in Echtzeit ausgeführt und geben sofortiges Feedback über Erfolg oder Misserfolg.
+ Persönliche Authentifizierung (3LO) — Verwendet Ihre individuellen Anmeldeinformationen und Berechtigungen des Zieldienstes.

**Häufige Anwendungsfälle:**
+ Tickets in Jira erstellen.
+ Nachrichten in Slack senden.
+ Aktualisierung von Salesforce-Datensätzen.
+ Informationen werden abgerufen von SharePoint.

## Automatisierte Workflows
<a name="qbs-actions-types-qbs-actions-automated-workflows"></a>

Automatisierte Workflows führen Aktionen nach einem Zeitplan oder als Reaktion auf bestimmte Auslöser aus. Diese sind nützlich für Operationen im Hintergrund und auf Systemebene.

**Wichtigste Merkmale:**
+ Ausführung auf Systemebene — Aktionen werden automatisch ohne Benutzereingriff auf der Grundlage vordefinierter Trigger ausgeführt.
+ Geplant oder ereignisgesteuert — Die Ausführung erfolgt nach zeitbasierten Zeitplänen oder als Reaktion auf bestimmte Systemereignisse.
+ Nicht interaktiver Vorgang — Wird im Hintergrund ausgeführt, ohne dass Benutzereingaben oder das Ausfüllen eines Formulars erforderlich sind.
+ Authentifizierung auf Dienstebene — Verwenden Sie Systemanmeldedaten statt individueller Benutzerauthentifizierung.

**Häufige Anwendungsfälle:**
+ Regelmäßige Datensynchronisierung.
+ Geplante Berichtsgenerierung.
+ Automatisierte Ticketaktualisierungen.
+ Systemintegritätsprüfungen.

# Eingeschränkte und unbegrenzte Agenten
<a name="int-actions-bounded-unbounded"></a>

Amazon Quick bietet zwei Arten von Agenten, die unterschiedliche Zugriffs- und Funktionsebenen bieten: begrenzte und unbegrenzte Agenten. Wenn Sie die Unterschiede zwischen diesen Agententypen kennen, können Sie die richtige Lösung für Ihren Anwendungsfall implementieren.

## Eingeschränkte Agenten
<a name="qbs-actions-bounded-unbounded-qbs-actions-bounded-agents"></a>

Eingeschränkte Agenten arbeiten innerhalb definierter Parameter, die speziell mit einem oder mehreren Bereichen in Amazon Quick verknüpft sind. Diese Agenten können nur auf Ressourcen zugreifen und Aktionen mit ihnen ausführen, die explizit mit den ihnen zugewiesenen Bereichen verbunden sind. Ein für den HR-Bereich konfigurierter, begrenzter Agent kann beispielsweise nur auf Dokumente und Datensätze zugreifen, die sich auf die Personalabteilung beziehen, und Aktionen ausführen, die mit der Personalabteilung zu tun haben.

Verwenden Sie begrenzte Agenten für:
+ Abteilungsspezifische Workflows (HR, Finanzen, IT).
+ Zusammenarbeit im Projektteam.
+ Umgang mit sensiblen Daten.
+ Auf die Einhaltung von Vorschriften ausgerichtete Abläufe.

Der begrenzte Charakter sorgt für mehr Sicherheit, da sichergestellt wird, dass der Agent nicht auf Ressourcen außerhalb der dafür vorgesehenen Bereiche zugreifen kann. Dies macht es ideal für Szenarien, in denen Datenisolierung wichtig ist.

## Unbegrenzte Anzahl an Agenten
<a name="qbs-actions-bounded-unbounded-qbs-actions-unbounded-agents"></a>

Unbounded-Agenten verfügen über umfassendere Zugriffsmöglichkeiten und können mit allen konfigurierten Aktionen und Ressourcen innerhalb der Amazon Quick-Umgebung arbeiten. Diese Agenten sind nicht auf bestimmte Bereiche beschränkt und können auf jeden ordnungsgemäß konfigurierten Action-Connector zugreifen, der im System verfügbar ist.

Verwenden Sie unbegrenzt viele Agenten für:
+ Unternehmensweite Unterstützung.
+ Abteilungsübergreifende Arbeitsabläufe.
+ Allzweck-Aktionen.
+ Szenarien, die Zugriff auf mehrere Systeme erfordern.

# Voraussetzungen
<a name="int-actions-prerequisites"></a>

Bevor Sie Aktionen in Amazon Quick verwenden, stellen Sie sicher, dass Sie über Folgendes verfügen:

## Anforderungen an die Lizenz
<a name="qbs-actions-prerequisites-qbs-actions-license-requirements"></a>

Eine der folgenden Amazon Quick-Lizenzen:
+ Reader Pro — Bietet Lesezugriff auf Daten und die Möglichkeit, Aktionen in verbundenen Diensten auszuführen.
+ Author — Beinhaltet Funktionen von Reader Pro sowie die Möglichkeit, Inhalte und Konfigurationen zu erstellen und zu ändern.
+ Author Pro — Vollständiger Zugriff auf alle Funktionen, einschließlich erweiterter Aktionskonfigurations- und Verwaltungsfunktionen.

## Anforderungen an den Service
<a name="qbs-actions-prerequisites-qbs-actions-service-requirements"></a>

Stellen Sie für Dienste von Drittanbietern (wie Jira oder Salesforce) sicher, dass Sie über Folgendes verfügen:
+ Entsprechende Berechtigungen in den Zieldiensten.
+ Authentifizierungsdaten für jeden Dienst.

Für AWS Action Connectors benötigen Sie Administratorzugriff auf die entsprechenden Dienste.

## AWS Kontoanforderungen
<a name="qbs-actions-prerequisites-qbs-actions-aws-account-requirements"></a>
+ Aktives AWS Konto — Ein gültiges AWS Konto mit aktivierter Abrechnung und einwandfreiem Status.
+ Geeignete IAM-Berechtigungen — IAM-Rollen und -Richtlinien, die Amazon Quick den Zugriff auf die erforderlichen AWS Services ermöglichen.
+ Erforderliche Servicekontingente — Ausreichende Servicelimits für die AWS Services, die Sie in Ihre Aktionen integrieren möchten.

# Unterstützte Action-Connector-Typen und verfügbare Aktionen
<a name="action-connector-apis-supported-types"></a>

Amazon Quick unterstützt mehrere Konnektortypen, für die jeweils bestimmte Aktionen verfügbar sind:

## Konnektoren für externe Dienste
<a name="action-connector-apis-external-services"></a>
+ **Salesforce** — Erstellen Sie Datensätze, aktualisieren Sie Opportunities, suchen Sie nach Accounts, verwalten Sie Leads.
+ **JIRA** — Probleme erstellen, Tickets aktualisieren, Projekte durchsuchen, Workflows verwalten.
+ **Microsoft Outlook** - E-Mails senden, Kalenderereignisse verwalten, auf Kontakte zugreifen.
+ **Slack** - Nachrichten senden, Kanäle erstellen, Benachrichtigungen verwalten.
+ **ServiceNow**- Vorfälle erstellen, Anfragen aktualisieren, Workflows verwalten.
+ **Zendesk** — Tickets erstellen, Fälle aktualisieren, Wissensdatenbank durchsuchen.
+ **PagerDuty**- Erstelle Vorfälle, verwalte Eskalationen, aktualisiere Bereitschaftszeiten.
+ **Asana** — Aktionen erstellen, Projekte aktualisieren, Team-Workflows verwalten.
+ **BambooHR** — Greifen Sie auf Mitarbeiterdaten zu, verwalten Sie Urlaubsanträge.
+ **Box** — Verwalte Dateien und Ordner und arbeite gemeinsam an Dokumenten.
+ **Canva** — Designs erstellen und bearbeiten, Vorlagen und Ressourcen verwalten.
+ **FactSet**- Greifen Sie auf Finanzdaten zu und erstellen Sie Berichte.
+ **GitHub**- Verwalte Repositorys, Issues, Pull-Requests und Code-Zusammenarbeit.
+ **HuggingFace**- Greifen Sie auf KI-Modelle, Datensätze und Workflows für maschinelles Lernen zu.
+ **HubSpot**- Verwalten Sie Kontakte, Angebote, Marketingkampagnen und CRM-Daten.
+ **Intercom** - Verwalten Sie Kundengespräche, Support-Tickets und Nachrichten.
+ **Linear** — Erstellen und verwalten Sie Probleme, Projekte und Entwicklungsworkflows.
+ **Montag** — Verwalte Projekte, Aufgaben und Workflows für die Teamzusammenarbeit.
+ **Notion** — Erstellen und verwalten Sie Seiten, Datenbanken und kollaborative Arbeitsbereiche.
+ **Smartsheet** — Blätter aktualisieren, Projektdaten verwalten.
+ **Confluence** — Erstellen, aktualisieren und verwalten Sie Seiten, Bereiche und andere Confluence-Objekte.
+ **SharePoint**- Führen Sie Aktionen für SharePoint Listen, Elemente und Excel-Dateien aus. Es stehen 19 Aktionen zum Erstellen, Aktualisieren, Löschen und Abrufen von Inhalten zur Verfügung. SharePoint 
+ **OneDrive**- OneDrive Dateien und Ordner erstellen, aktualisieren, löschen und verwalten.
+ **SAP** — Greifen Sie auf SAP S/4HANA-Systeme zu, um nur Leseoperationen für Unternehmensdaten durchzuführen.

## AWS Service-Konnektoren
<a name="action-connector-apis-aws-services"></a>
+ **Amazon S3** — Dateien hochladen, Buckets verwalten, Objekte abrufen.
+ **Amazon Bedrock** — Generieren Sie Inhalte, analysieren Sie Daten, bearbeiten Sie Anfragen.
+ **Amazon Textract** - Extrahieren Sie Text und Daten aus Dokumenten.
+ **Amazon Comprehend** — Verarbeitung natürlicher Sprache und Stimmungsanalyse.
+ **Amazon Comprehend Medical — Medizinische** Textanalyse und Extraktion von Entitäten.

## Kompatibilitätsmatrix für Action Connector
<a name="action-connector-compatibility-matrix"></a>

Die folgende Tabelle zeigt, welche Amazon Quick-Funktionen die einzelnen Action-Connector-Typen unterstützen:


**Kompatibilität der Action Connector-Funktionen**  

| Action Connector | Chat-Agenten | Ströme | Visuelle Darstellung des Dashboards | Benachrichtigungen im Dashboard | Automatisierungen | Gefährten | 
| --- | --- | --- | --- | --- | --- | --- | 
| AWS Integrierte Dienste | 
| AWS Bedrock Agent Runtime | — | — | — | — | ✓ | — | 
| AWS Laufzeit von Bedrock Data Automation | — | — | — | — | ✓ | — | 
| AWS Bedrock Runtime | — | — | — | — | ✓ | — | 
| Amazon Comprehend | — | — | — | — | ✓ | — | 
| Amazon Comprehend Medical | — | — | — | — | — | — | 
| Amazon S3 | — | — | — | — | ✓ | — | 
| Amazon Textract | — | — | — | — | ✓ | — | 
| Konnektoren für externe Dienste | 
| Asana | ✓ | ✓ | — | — | — | ✓ | 
| Atlassian Confluence Cloud | ✓ | ✓ | — | — | ✓ | ✓ | 
| Atlassian Jira Cloud | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 
| BambooHR | ✓ | ✓ | — | — | — | ✓ | 
| Box (Kasten) | ✓ | ✓ | — | — | — | — | 
| Leinwand | ✓ | ✓ | — | — | — | — | 
| FactSet | ✓ | ✓ | — | — | — | — | 
| GitHub | ✓ | ✓ | — | — | — | — | 
| HuggingFace | ✓ | ✓ | — | — | — | — | 
| HubSpot | ✓ | ✓ | — | — | — | — | 
| Intercom | ✓ | ✓ | — | — | — | — | 
| Linear | ✓ | ✓ | — | — | — | — | 
| Montag | ✓ | ✓ | — | — | — | — | 
| Begriff | ✓ | ✓ | — | — | — | — | 
| Microsoft OneDrive | ✓ | ✓ | — | — | ✓ | ✓ | 
| Microsoft Outlook | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 
| Microsoft SharePoint | ✓ | ✓ | — | — | ✓ | ✓ | 
| Microsoft Teams | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 
| PagerDuty | ✓ | ✓ | — | — | ✓ | ✓ | 
| Salesforce | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 
| SAP | ✓ | — | — | — | ✓ | ✓ | 
| ServiceNow | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 
| Slack | ✓ | ✓ | ✓ | — | — | ✓ | 
| Smartsheet | ✓ | ✓ | — | — | — | ✓ | 
| Zendesk | ✓ | ✓ | — | — | — | ✓ | 
| Benutzerdefinierte Steckertypen | 
| Model Context Protocol (MCP) | ✓ | ✓ | — | — | ✓ | — | 
| OpenAPI | ✓ | ✓ | — | — | — | — | 
| REST-API | — | — | — | — | ✓ | — | 

**Support für Authentifizierung:**
+ **Chat-Agenten und Begleiter** — Support der Benutzerauthentifizierung (3LO, Basic)
+ **Dashboard-Visuals** — Support der Benutzerauthentifizierung (3LO)
+ **Dashboard-Benachrichtigungen** — Support der Systemauthentifizierung (2LO oder API-Schlüssel)
+ **Automatisierungen** — Support der Systemauthentifizierung (2LO)

# Action-Anschluss APIs
<a name="action-connector-apis"></a>

Mit Action APIs Connector können Sie programmgesteuert Verbindungen zwischen Amazon Quick und externen Services erstellen und verwalten. Diese APIs unterstützen die Aktionsintegrationsfunktion, mit der Benutzer Aktionen in Drittanbieteranwendungen direkt über Amazon Quick Chat-Benutzeroberflächen und automatisierte Workflows ausführen können.

## Was sind Action Connector APIs?
<a name="action-connector-apis-overview"></a>

Action Connectors dienen als grundlegende Ressourcen, die die Integration mit Anwendungen von Erst- und Drittanbietern ermöglichen. Über diese APIs können Sie sich bei Anwendungen authentifizieren, Berechtigungen verwalten und kontrollieren, welche Aktionen Benutzern in Ihren Amazon Quick-Anwendungen zur Verfügung stehen.

### Wie APIs unterstützt Action Connector Aktionsintegrationen
<a name="action-connector-apis-task-integrations"></a>

Action Connector APIs stellt die Backend-Infrastruktur für Amazon Quick Action-Integrationen bereit. Wenn Sie über die API einen Action-Connector erstellen, stellen Sie eine sichere Verbindung her, mit der Sie:
+ Führen Sie Aktionen in externen Diensten über Chat-Schnittstellen aus.
+ Führen Sie automatisierte Workflows in Hintergrundprozessen durch.
+ Integrieren Sie Dienste von Drittanbietern in Amazon Quick-Anwendungen.
+ Verwalten Sie die Authentifizierung und die Berechtigungen für den Servicezugriff.

Sie APIs kümmern sich um die komplexen Authentifizierungsabläufe, die Verwaltung von Anmeldeinformationen und die Berechtigungskontrollen, die für eine sichere Verbindung von Amazon Quick mit externen Diensten erforderlich sind.

## Authentifizierungsmethoden
<a name="action-connector-apis-authentication"></a>

Action Connector APIs unterstützt mehrere Authentifizierungsmethoden, um unterschiedlichen Anwendungsfällen und Sicherheitsanforderungen gerecht zu werden:

### Verwaltete Authentifizierung (3LO)
<a name="qbs-action-connector-apis-managed-auth"></a>

Three-Legged OAuth bietet die einfachste Einrichtung für den persönlichen Zugriff auf Dienste von Drittanbietern:
+ Keine Erstkonfiguration erforderlich.
+ Benutzerspezifische Authentifizierung durch Anmeldung beim Dienstanbieter.
+ Automatische Token-Aktualisierung mit einem Lebenszyklus von 90 Tagen.
+ Sicherer Speicher für Anmeldeinformationen, verwaltet von Amazon Quick.

### Service-to-service Authentifizierung (2LO)
<a name="qbs-action-connector-apis-service-auth"></a>

Für komplexe Unternehmensintegrationen:
+ Unterstützt den OAuth Fluss von Kundenanmeldedaten.
+ Ermöglicht system-to-system Interaktionen.
+ Erfordert die Konfiguration der Client-ID, des geheimen Client-Schlüssels und der Token-URL.
+ Geeignet für automatisierte Workflows, die eine ausgefeilte Sicherheit erfordern.
+ OAuth - Dynamische Client-Registrierung (DCR — gilt nur für ausgewählte MCP-Server).

### API-Schlüsselauthentifizierung
<a name="qbs-action-connector-apis-api-key"></a>

Vereinfachte Authentifizierung für automatisierte Workflows:
+ Authentifizierung auf Basis eines einzelnen Tokens.
+ Berechtigungen auf Dienstebene.
+ Ideal für Hintergrundprozesse und geplante Aktionen.
+ Erfordert einen gültigen API-Schlüssel vom Zieldienst.

### Grundlegende Authentifizierung
<a name="qbs-action-connector-apis-basic-auth"></a>

Die Standardauthentifizierung bietet eine einfache username/password Authentifizierungsmethode:
+ Verwendet Standard-Header für die HTTP-Standardauthentifizierung.
+ Die Anmeldeinformationen sind Base64-codiert.
+ Geeignet für Dienste, die API-Schlüssel nicht unterstützen OAuth .
+ Erfordert eine sichere HTTPS-Verbindung.
+ Nicht für öffentlich zugängliche Dienste empfohlen.

### Keine
<a name="qbs-action-connector-apis-no-auth"></a>

Keine Authentifizierung erforderlich:
+ Wird für die Öffentlichkeit APIs und für Dienstleistungen verwendet.
+ Keine Anmeldeinformationen oder Token erforderlich.
+ Beschränkt auf schreibgeschützte oder öffentliche Operationen.
+ Wird in der Regel für öffentliche Datenfeeds und Dokumentation verwendet.
+ Sollte nicht für sensible Operationen verwendet werden.

## Berechtigungen und Zugriffskontrolle
<a name="qbs-action-connector-apis-permissions"></a>

Action Connector APIs implementiert umfassende Berechtigungskontrollen mithilfe von Zugriffskontrolllisten (ACLs):

### Berechtigungen auf Ressourcenebene
<a name="qbs-action-connector-apis-resource-permissions"></a>
+ **Besitzer** — Vollständige Kontrolle, einschließlich Lösch- und Berechtigungsverwaltung.
+ **Mitwirkender** — Kann Connectoreinstellungen verwenden und ändern.
+ **Viewer** — Kann Connector-Details anzeigen und aktivierte Aktionen verwenden.

### API-Operationen für die Rechteverwaltung
<a name="qbs-action-connector-apis-permission-operations"></a>
+ `DescribeActionConnectorPermissions`- Rufen Sie die aktuellen Berechtigungseinstellungen ab.
+ `UpdateActionConnectorPermissions`- Benutzerberechtigungen gewähren oder entziehen.

## Unterstützte Connector-Kategorien
<a name="qbs-action-connector-apis-categories"></a>

### Steckverbinder mit doppeltem Verwendungszweck
<a name="qbs-action-connector-apis-dual-purpose"></a>

Diese Konnektoren unterstützen sowohl die Integration von Aktionen als auch die Erstellung von Wissensdatenbanken:
+ **Amazon S3** — Verwenden Sie die Admin-Konsole, um Aktionen für Dateioperationen zu erstellen, und verwenden Sie die Webapp, um Wissensdatenbanken aus S3-Inhalten zu erstellen.
+ **Microsoft SharePoint** - Aktionen zur Dokumentenverwaltung, Inhaltsindizierung.
+ **OneDrive**- Dateioperationen, Funktionen zur Dokumentensuche.
+ **Confluence** — Aktionen zur Erstellung von Inhalten, Integration von Wissensdatenbanken.

### Konnektoren, die nur für Aktionen geeignet sind
<a name="qbs-action-connector-apis-task-only"></a>

Spezialisiert auf die Ausführung von Aktionen ohne Knowledge-Base-Funktionen:
+ **Salesforce** — CRM-Integration für Unternehmen zur Unterstützung von Konto- und Kontaktoperationen, CRUD-Vorgängen für benutzerdefinierte Objekte und Automatisierung von Vertriebsprozessen.
+ **JIRA** — Problemverfolgung und Projektmanagement.
+ **Microsoft Outlook** - E-Mails senden, Kalenderereignisse verwalten, auf Kontakte zugreifen.
+ **Slack** — Kommunikations- und Benachrichtigungs-Workflows.
+ **ServiceNow**- Betrieb des IT-Servicemanagements.
+ **Zendesk** — Tickets erstellen, Fälle aktualisieren, Wissensdatenbank durchsuchen.
+ **PagerDuty**- Erstelle Vorfälle, verwalte Eskalationen, aktualisiere Bereitschaftszeiten.
+ **Asana** — Aktionen erstellen, Projekte aktualisieren, Team-Workflows verwalten.
+ **BambooHR** — Greifen Sie auf Mitarbeiterdaten zu, verwalten Sie Urlaubsanträge.
+ **Smartsheet** — Blätter aktualisieren, Projektdaten verwalten.
+ **FactSet**- Greifen Sie auf Finanzdaten zu, erstellen Sie Berichte.
+ **SAP** — Greifen Sie auf SAP-Systeme zu, führen Sie Geschäftsfunktionen aus und verwalten Sie Unternehmensdaten.

### Konnektoren, die nur für die Wissensdatenbank bestimmt sind
<a name="qbs-action-connector-apis-data-only"></a>

Konzentriert sich auf die Integration von Wissensdatenbanken ohne Handlungsmöglichkeiten:
+ **Google Drive** — Indizierung und Suche von Dokumenten.
+ **Web Crawler** — Entdeckung und Indexierung von Inhalten.

## API-Lebenszyklusmanagement
<a name="qbs-action-connector-apis-lifecycle"></a>

### Verwalten von Anmeldeinformationen
<a name="qbs-action-connector-apis-credential-management"></a>
+ Automatische Behandlung von Aktualisierungstoken für OAuth Action-Konnektoren.
+ Sichere Speicherung von Authentifizierungsdaten mithilfe von AWS KMS.
+ Support für die Rotation und Aktualisierung von Anmeldeinformationen.
+ Kontoübergreifender Zugriff für Amazon S3 S3-Konnektoren.

### Verbindungsaktualisierungen
<a name="qbs-action-connector-apis-connection-updates"></a>

Verwenden Sie die `UpdateActionConnector` API, um:
+ Ändern Sie die Anmeldeinformationen für die Authentifizierung.
+ Aktualisieren Sie die Konfigurationsparameter des Dienstes.
+ Ändern Sie die Metadaten des Aktionskonnektors.

### Überwachung und Problembehandlung
<a name="qbs-action-connector-apis-monitoring"></a>
+ Verfolgen Sie die API-Nutzung anhand von CloudWatch Metriken.
+ Überwachen Sie den Verbindungsstatus und den Authentifizierungsstatus.
+ Implementieren Sie die Fehlerbehandlung für häufig auftretende Ausfallszenarien.
+ Verwenden Sie APIs die Validierung, um Konfigurationsprobleme zu diagnostizieren.

## Ratenbegrenzung und Kontingente
<a name="qbs-action-connector-apis-rate-limiting"></a>

Action Connector APIs implementiert eine standardmäßige AWS API-Ratenbegrenzung:
+ Die standardmäßige AWS API-Drosselung gilt für alle Operationen.
+ Für die Verbindungsvalidierung können zusätzliche Einschränkungen gelten.
+ Die Ausführungsraten von Aktionen hängen von den Funktionen des Zieldienstes ab.
+ Implementieren Sie exponentielles Backoff für die Wiederholungslogik.

## Kontoübergreifende Unterstützung
<a name="qbs-action-connector-apis-cross-account"></a>

Für Amazon S3 S3-Konnektoren APIs unterstützen sie den kontoübergreifenden Zugriff:
+ Geben Sie IDs bei der Erstellung des Connectors AWS ein anderes Konto an.
+ Konfigurieren Sie die entsprechenden IAM-Berechtigungen für den kontoübergreifenden Zugriff.
+ Wird AWS KMS für die sichere Verwaltung von Anmeldeinformationen für alle Konten verwendet.
+ Überprüfen Sie die Berechtigungen, bevor Sie kontenübergreifende Verbindungen aktivieren.

## Fehlerbehandlung und -behebung
<a name="qbs-action-connector-apis-error-handling"></a>

Action Connector APIs gibt AWS Standardfehlerantworten zurück:

### Häufige Fehlertypen
<a name="qbs-action-connector-apis-common-errors"></a>
+ `AccessDeniedException`- Unzureichende Berechtigungen für den Vorgang.
+ `InvalidParameterValueException`- Ein oder mehrere Parameterwerte sind für den Vorgang ungültig.
+ Ungültige Konfigurationsparameter — Dienstspezifische Konfigurationswerte sind falsch oder fehlen.
+ `ResourceNotFoundException`- Konnektor oder Ressource wurde nicht gefunden.
+ `ThrottlingException`- Das Ratenlimit wurde überschritten.
+ `ConflictException`- Ressourcenkonflikt oder doppelte Namen.
+ `InternalFailureException`- Bei der Bearbeitung der Anfrage ist ein interner Dienstfehler aufgetreten.
+ `ResourceExistsException`- Es wurde versucht, eine Ressource zu erstellen, die bereits existiert.
+ `InvalidNextTokenException`- Das angegebene Paginierungstoken ist ungültig oder abgelaufen.
+ `AccessTokenNotFoundException`- Der Benutzer muss die Verbindung autorisieren (d. h. die Schaltfläche „Signieren“). Diese Ausnahme wird von UX verwendet, um Benutzer um Autorisierung zu bitten.
+ `TokenResponseException`- Die Einrichtung der Aktion ist nicht gültig.

Implementieren Sie eine angemessene Fehlerbehandlung in Ihren Anwendungen, um diese Szenarien ordnungsgemäß zu verwalten und den Benutzern aussagekräftiges Feedback zu geben.

## Action Connector APIs mit AWS CLI verwenden
<a name="qbs-action-connector-apis-cli-examples"></a>

Sie können die AWS CLI verwenden, um Action Connectors programmgesteuert zu verwalten. Die folgenden Beispiele zeigen gängige Operationen mit generischen Platzhalterwerten.

### Einen Aktionskonnektor erstellen
<a name="create-action-connector-cli"></a>

Verwenden Sie den `create-action-connector` Befehl, um einen neuen Aktionskonnektor für die Integration mit externen Diensten zu erstellen.

```
aws quicksight create-action-connector \
  --aws-account-id "123456789012" \
  --name "MyS3Connector" \
  --action-connector-id "my-s3-connector-id" \
  --type "AMAZON_S3" \
  --authentication-config '{
    "AuthenticationType": "IAM",
    "AuthenticationMetadata": {
      "IamConnectionMetadata": {
        "RoleArn": "arn:aws:iam::123456789012:role/MyConnectorRole"
      }
    }
  }' \
  --enabled-actions "CreateBucket" "ListBuckets" \
  --description "S3 connector for automation workflows" \
  --region "us-east-1"
```

### Aktionskonnektoren auflisten
<a name="list-action-connectors-cli"></a>

Verwenden Sie den `list-action-connectors` Befehl, um alle Action-Connectors in Ihrem Konto abzurufen.

```
aws quicksight list-action-connectors \
  --aws-account-id "123456789012" \
  --max-results 10 \
  --region "us-east-1"
```

### Beschreibung eines Action-Connectors
<a name="describe-action-connector-cli"></a>

Verwenden Sie den `describe-action-connector` Befehl, um detaillierte Informationen zu einem bestimmten Aktionskonnektor abzurufen.

```
aws quicksight describe-action-connector \
  --aws-account-id "123456789012" \
  --action-connector-id "my-s3-connector-id" \
  --region "us-east-1"
```

### Aktualisierung eines Aktionskonnektors
<a name="update-action-connector-cli"></a>

Verwenden Sie den `update-action-connector` Befehl, um die Konfiguration eines vorhandenen Aktionskonnektors zu ändern.

```
aws quicksight update-action-connector \
  --aws-account-id "123456789012" \
  --action-connector-id "my-s3-connector-id" \
  --name "UpdatedS3Connector" \
  --authentication-config '{
    "AuthenticationType": "IAM",
    "AuthenticationMetadata": {
      "IamConnectionMetadata": {
        "RoleArn": "arn:aws:iam::123456789012:role/UpdatedConnectorRole"
      }
    }
  }' \
  --enabled-actions "CreateBucket" "ListBuckets" "DeleteBucket" \
  --region "us-east-1"
```

### Nach Action-Konnektoren suchen
<a name="search-action-connectors-cli"></a>

Verwenden Sie den `search-action-connectors` Befehl, um Aktionskonnektoren anhand bestimmter Kriterien zu finden.

```
aws quicksight search-action-connectors \
  --aws-account-id "123456789012" \
  --max-results 5 \
  --filters '[{
    "Name": "ACTION_CONNECTOR_NAME",
    "Operator": "StringLike",
    "Value": "S3"
  }]' \
  --region "us-east-1"
```

### Verwaltung von Action-Connector-Berechtigungen
<a name="update-action-connector-permissions-cli"></a>

Verwenden Sie den `update-action-connector-permissions` Befehl, um Berechtigungen für einen Action Connector zu gewähren oder zu widerrufen.

```
aws quicksight update-action-connector-permissions \
  --aws-account-id "123456789012" \
  --action-connector-id "my-s3-connector-id" \
  --grant-permissions '[{
    "Actions": [
      "quicksight:DescribeActionConnector",
      "quicksight:UpdateActionConnector",
      "quicksight:DeleteActionConnector"
    ],
    "Principal": "arn:aws:quicksight:us-east-1:123456789012:user/default/myuser"
  }]' \
  --region "us-east-1"
```

### Berechtigungen für den Action Connector anzeigen
<a name="describe-action-connector-permissions-cli"></a>

Verwenden Sie den `describe-action-connector-permissions` Befehl, um die aktuellen Berechtigungen für einen Action Connector anzuzeigen.

```
aws quicksight describe-action-connector-permissions \
  --aws-account-id "123456789012" \
  --action-connector-id "my-s3-connector-id" \
  --region "us-east-1"
```

### Löschen eines Aktionskonnektors
<a name="delete-action-connector-cli"></a>

Verwenden Sie den `delete-action-connector` Befehl, um einen Action-Connector aus Ihrem Konto zu entfernen.

```
aws quicksight delete-action-connector \
  --aws-account-id "123456789012" \
  --action-connector-id "my-s3-connector-id" \
  --region "us-east-1"
```

## Nächste Schritte
<a name="qbs-action-connector-apis-next-steps"></a>

Nachdem Sie den Action Connector verstanden haben APIs, können Sie:
+ Detaillierte Parameterspezifikationen finden Sie in der vollständigen API-Referenzdokumentation.
+ Sehen Sie sich spezifische Anleitungen zur Einrichtung von Konnektoren für Ihre Zieldienste an.
+ Implementieren Sie Authentifizierungsabläufe, die für Ihren Anwendungsfall geeignet sind.
+ Richten Sie die Überwachung und Fehlerbehandlung für Produktionsbereitstellungen ein.
+ Konfigurieren Sie Berechtigungen und Zugriffskontrollen für Ihr Unternehmen.

# Authentifizierungsmethoden
<a name="quick-action-auth"></a>

Amazon Quick unterstützt mehrere Authentifizierungsmethoden, die jeweils für bestimmte Anwendungsfälle und Sicherheitsanforderungen konzipiert sind.

## Verwaltete Authentifizierung (3LO)
<a name="quick-managed-auth"></a>

Three-Legged OAuth (3LO) ist die empfohlene Authentifizierungsmethode für den persönlichen Zugriff auf Dienste von Drittanbietern.

**Hauptmerkmale von 3LO:**
+ Keine Erstkonfiguration erforderlich.
+ Benutzerspezifische Authentifizierung.
+ Sicherer Speicher von Anmeldeinformationen.
+ Automatische Token-Aktualisierung.
+ 90-tägiger Lebenszyklus des Aktualisierungstokens.

**3LO-Setup-Prozess:**

1. Wählen Sie den Anschluss aus.

1. Wählen Sie verwaltete Authentifizierung.

1. Vollständige Anmeldung für den Dienstanbieter.

1. Gewähren Sie die angeforderten Berechtigungen.

1. Verbindung bestätigen.

## Benutzerdefinierte benutzerbasierte Authentifizierung
<a name="quick-custom-user-auth"></a>

Für Szenarien, die eine spezifische organisatorische Kontrolle oder eine benutzerdefinierte Konfiguration erfordern.

**Erforderliche Informationen:**
+ Client-ID.
+ Geheimes Kundengeheimnis.
+ Domain-URL.
+ Autorisierungs-URL.
+ Token-URL.
+ URL umleiten.

**Schritte zur Konfiguration:**

1. Besorgen Sie sich Anmeldeinformationen vom Dienstanbieter.

1. Konfigurieren Sie die Authentifizierungseinstellungen.

1. Verbindung validieren.

1. Testen Sie die Zugriffsberechtigungen.

Wenn Sie die benutzerbasierte Authentifizierung in der Amazon Quick Console konfigurieren, holen Sie sich die richtigen Anmeldeinformationen von Ihrem Dienstanbieter und konfigurieren Sie Ihre Authentifizierungseinstellungen. Bestätigen Sie anschließend die Verbindung und testen Sie Ihre Zugriffsberechtigungen.

## API-Schlüsselauthentifizierung
<a name="quick-actions-api-key-auth"></a>

Wird hauptsächlich für automatisierte Workflows und Zugriff auf Systemebene verwendet.

**Die wichtigsten Funktionen:**
+ Einfache tokenbasierte Authentifizierung.
+ Verwaltung einzelner Anmeldeinformationen.
+ Berechtigungen auf Dienstebene.
+ Geeignet für automatisierte Prozesse.

**Anforderungen an die Einrichtung:**

Stellen Sie bei der Einrichtung der API-Schlüsselauthentifizierung sicher, dass Sie über Folgendes verfügen:
+ Gültiger API-Schlüssel vom Dienst.
+ Entsprechende Serviceberechtigungen.
+ Geheime Speicherkonfiguration.

## Service-to-service authentication
<a name="quick-actions-service-to-service-auth"></a>

Für automatisierte Workflows, die eine komplexe Authentifizierung erfordern.

**Anforderungen an die Konfiguration:**
+ Client-ID.
+ Geheimer Client-Schlüssel.
+ Domain-URL.
+ Token-URL.
+ Dienstspezifische Parameter.

# Methoden zur Ausführung von Aktionen
<a name="int-actions-execution"></a>

Amazon Quick bietet mehrere Möglichkeiten zur Ausführung von Aktionen und berücksichtigt dabei unterschiedliche Anwendungsfälle und Interaktionspräferenzen.

## Chat-Oberfläche
<a name="qbs-actions-execution-qbs-actions-chat-interface"></a>

Sie können implizite Aktionen im Amazon Quick Chat ausführen.

### Implizite Aktionen
<a name="qbs-actions-execution-qbs-actions-implicit-actions"></a>

Amazon Quick unterstützt auch die implizite Ausführung von Aktionen durch natürliche Konversation mit Agenten. Mithilfe fortschrittlicher Verarbeitung natürlicher Sprache kann das System erkennen, wann Ihre Konversation auf die Notwendigkeit bestimmter Aktionen hindeutet. Konversationen werden analysiert, um festzustellen, welche Aktionen zur Erfüllung Ihrer Anfrage erforderlich sind.

Für die Ausführung einer einzelnen Anfrage sind möglicherweise mehrere Aktionen erforderlich. In diesem Fall verarbeitet das System diese Aktionen nacheinander und führt Sie durch jeden Schritt. Für jede identifizierte Aktion zeigt das System das entsprechende Formular an, das Sie ausfüllen müssen. Nach Abschluss jeder Aktion erhalten Sie eine Bestätigung, bevor Sie mit der nächsten Aktion in der Sequenz fortfahren.

Wenn du zum Beispiel fragst: „Erstelle ein Jira-Ticket für dieses Problem und informiere das Team in Slack“, würde das System:

1. Präsentieren Sie zunächst das Formular zur Erstellung eines Jira-Tickets.

1. Zeigen Sie nach Abschluss der Ticketerstellung das Slack-Nachrichtenformular an.

1. Schließe beide Aktionen nacheinander ab.

Während des gesamten Vorgangs können Sie Ihren Fortschritt anhand mehrerer Aktionen verfolgen. Wenn alle Aktionen abgeschlossen sind, bietet das System eine umfassende Zusammenfassung aller ausgeführten Aktionen und ihrer Ergebnisse. Sie können bei Bedarf auf die zugehörige Dokumentation zugreifen und alle Fehlerstatus überprüfen, die während des Vorgangs aufgetreten sein könnten.

# Überwachung und Wartung
<a name="int-actions-monitoring"></a>

Die Überwachung Ihrer Action Connectors trägt dazu bei, eine zuverlässige Leistung sicherzustellen und Probleme zu identifizieren, bevor sie sich auf Benutzer auswirken. Durch die regelmäßige Überwachung können Sie Nutzungsmuster verfolgen, die Leistung optimieren und gesunde Verbindungen zu externen Diensten aufrechterhalten.

## Überwachung der Leistung
<a name="qbs-actions-monitoring-qbs-actions-performance-monitoring"></a>

Sie können die Leistung des Action Connectors anhand der folgenden Metriken und Analysen beurteilen.

### CloudWatch Metriken
<a name="qbs-actions-monitoring-qbs-actions-cloudwatch-metrics"></a>
+ Erfolgsquoten bei der Ausführung von Maßnahmen — Verfolgen Sie den Prozentsatz erfolgreicher Aktionsausführungen, um Zuverlässigkeitsprobleme zu identifizieren.
+ Reaktionszeiten — Überwachen Sie, wie lange es dauert, bis Maßnahmen abgeschlossen sind, und identifizieren Sie Leistungsengpässe.
+ Fehlerhäufigkeit — Verfolgen Sie Fehlermuster, um häufige Schwachstellen und Verbesserungsmöglichkeiten zu identifizieren.
+ API-Kontingentnutzung — Überwachen Sie die Nutzung anhand der Dienstlimits, um Drosselungen zu vermeiden, und planen Sie die Kapazität.

### Nutzungsanalysen
<a name="qbs-actions-monitoring-qbs-actions-usage-analytics"></a>

Die folgenden Nutzungsanalysen werden für Action Connectors gesammelt:
+ Aktive Benutzer — Verfolgen Sie, wie viele Benutzer Action Connectors aktiv verwenden, um die Akzeptanz- und Nutzungsmuster zu verstehen.
+ Beliebte Aktionen — Identifizieren Sie, welche Aktionen am häufigsten verwendet werden, um Optimierungsmaßnahmen zu priorisieren.
+ Ausführungsmuster — Analysieren Sie, wann und wie oft Aktionen ausgeführt werden, um die Ressourcenzuweisung zu optimieren.
+ Fehlertrends — Überwachen Sie die Fehlermuster im Laufe der Zeit, um systemische Probleme und Verbesserungsmöglichkeiten zu identifizieren.

## Gesundheit der Verbindung
<a name="qbs-actions-monitoring-qbs-actions-connection-health"></a>

Sie können den Zustand des Aktionsconnectors mithilfe der folgenden Tools zur Verbindungsintegrität beurteilen:

### Überwachung des Status
<a name="qbs-actions-monitoring-qbs-actions-status-monitoring"></a>
+ Verbindungsstatus — Überwachen Sie, ob die Anschlüsse aktiv angeschlossen sind und ordnungsgemäß funktionieren.
+ Gültigkeit der Authentifizierung — Verfolgen Sie den Status von Authentifizierungstoken und Anmeldeinformationen, um Zugriffsfehler zu vermeiden.
+ Nachverfolgung des Ablaufs von Token — Überwachen Sie, wann Authentifizierungstoken ablaufen und erneuert werden müssen.
+ Serviceverfügbarkeit — Verfolgen Sie die Verfügbarkeit und den Antwortstatus verbundener externer Dienste.

### Automatisierte Wartung
<a name="qbs-actions-monitoring-qbs-actions-automated-maintenance"></a>
+ Handhabung der Token-Aktualisierung.
+ Wiederherstellung der Verbindung.
+ Fehler bei der Wiederholungslogik.
+ Leistungsoptimierung.

## CloudWatch Referenz zu Metriken
<a name="qbs-actions-monitoring-qbs-actions-cloudwatch-metrics-table"></a>


**Verfügbare CloudWatch Metriken**  

| Metrik | Description | Einheit | 
| --- | --- | --- | 
| ActionSuccess | Erfolgreiche Ausführungen | Anzahl | 
| ActionLatency | Execution time (Ausführungszeit) | Millisekunden | 
| AuthFailures | Fehlgeschlagene Authentifizierungen | Anzahl | 
| APIThrottling | API-Drosselungsereignisse | Anzahl | 

# Best Practices
<a name="int-actions-best-practices"></a>

Die Einhaltung von Best Practices für Action Connectors trägt dazu bei, einen sicheren, zuverlässigen und effizienten Betrieb zu gewährleisten. Diese Methoden helfen Ihnen dabei, eine optimale Leistung aufrechtzuerhalten, vertrauliche Daten zu schützen und Betriebsprobleme zu minimieren.

## Sicherheit
<a name="qbs-actions-best-practices-qbs-actions-security-best-practices"></a>

### Verwaltung der Authentifizierung
<a name="qbs-actions-best-practices-qbs-actions-authentication-management"></a>
+ Regelmäßige Rotation der Anmeldeinformationen — Aktualisieren Sie API-Schlüssel und OAuth Token regelmäßig, um die Sicherheit zu gewährleisten.
+ Regelmäßige Überprüfungen der Berechtigungen — Überprüfen Sie die Benutzer- und Serviceberechtigungen vierteljährlich, um sicherzustellen, dass der Zugriff mit den geringsten Rechten gewährleistet ist.
+ Überwachung des Token-Lebenszyklus — Verfolgen Sie die Ablaufdaten von Token und richten Sie Warnmeldungen ein, bevor die Anmeldeinformationen ablaufen.
+ Protokollierung von Zugriffsprüfungen — Ermöglichen Sie eine umfassende Protokollierung, um nachzuverfolgen, wer wann auf welche Dienste zugegriffen hat.

### Zugriffskontrolle
<a name="qbs-actions-best-practices-qbs-actions-access-control"></a>
+ Implementieren Sie den Zugriff mit den geringsten Rechten — Gewähren Sie nur die Mindestberechtigungen, die für die ordnungsgemäße Ausführung der einzelnen Aktionen erforderlich sind.
+ Regelmäßige Genehmigungsprüfungen — Überprüfen und validieren Sie, ob die aktuellen Berechtigungen den tatsächlichen Nutzungsmustern und Geschäftsanforderungen entsprechen.
+ Zugriffsmuster für Dokumente — Sorgen Sie für eine klare Dokumentation darüber, wer Zugriff auf welche Konnektoren hat und warum.
+ Nutzungsanomalien überwachen — Richten Sie Warnmeldungen für ungewöhnliche Zugriffsmuster ein, die auf Sicherheitsprobleme hinweisen könnten.

## Leistung
<a name="qbs-actions-best-practices-qbs-actions-performance-best-practices"></a>

### Aktionskonfiguration
<a name="qbs-actions-best-practices-qbs-actions-action-configuration"></a>
+ Optimieren Sie die Standardeinstellungen von Formularen — Füllen Sie häufig verwendete Werte vorab aus, um die Zeit für Benutzereingaben zu reduzieren und Fehler zu vermeiden.
+ Konfigurieren Sie geeignete Timeouts — Legen Sie realistische Timeout-Werte fest, die auf den typischen Antwortzeiten für jeden Service basieren.
+ Richten Sie die Fehlerbehandlung ein — Implementieren Sie eine robuste Fehlerbehandlung mit klaren Benutzernachrichten und gegebenenfalls einer Wiederholungslogik.
+ Dokumentabhängigkeiten — Dokumentieren Sie klar und deutlich alle Voraussetzungen oder Abhängigkeiten zwischen verschiedenen Aktionen.

### Ressourcenmanagement
<a name="qbs-actions-best-practices-qbs-actions-resource-management"></a>
+ Überwachen Sie die API-Kontingente.
+ Verfolgen Sie Nutzungsmuster.
+ Optimieren Sie Aktualisierungspläne.
+ Regelmäßige Reinigung ungenutzter Anschlüsse.

## Wartung
<a name="qbs-actions-best-practices-qbs-actions-maintenance-best-practices"></a>

### Regelmäßige Aktionen
<a name="qbs-actions-best-practices-qbs-actions-regular-tasks"></a>
+ Überprüfen Sie den Status des Connectors.
+ Konfigurationen aktualisieren.
+ Verbindungen validieren.
+ Änderungen an Dokumenten.

### Fehlerbehebung
<a name="qbs-actions-best-practices-qbs-actions-troubleshooting-tasks"></a>
+ Überwachen Sie Fehlermuster.
+ Überprüfen Sie die CloudWatch Protokolle.
+ Verfolgen Sie die Lösungszeiten.
+ Lösungen dokumentieren.

# Fehlerbehebung
<a name="int-actions-troubleshooting"></a>

Wenn Action Connectors auf Probleme stoßen, hilft Ihnen die systematische Fehlerbehebung dabei, Probleme schnell zu identifizieren und zu lösen. Diese Anleitung behandelt häufig auftretende Probleme und deren Lösungen zur Minimierung von Ausfallzeiten und zur Wiederherstellung der Funktionalität.

## Häufige Probleme und Lösungen
<a name="qbs-actions-troubleshooting-qbs-actions-common-issues"></a>

### Probleme bei der Authentifizierung
<a name="qbs-actions-troubleshooting-qbs-actions-authentication-problems"></a>

#### Ablauf des Tokens
<a name="qbs-actions-troubleshooting-qbs-actions-token-expiration"></a>

```
Symptom: "Authentication token expired" error
Resolution:
```

1. Wählen Sie in der Konsole „Erneut verbinden“.

1. Schließen Sie den Authentifizierungsablauf ab.

1. Aktion erneut versuchen.

#### Fehler bei der Genehmigung
<a name="qbs-actions-troubleshooting-qbs-actions-permission-errors"></a>

```
Symptom: "Insufficient permissions" message
Resolution:
```

1. Überprüfen Sie die Dienstberechtigungen.

1. Überprüfen Sie die Connector-Konfiguration.

1. Überprüfen Sie die Maßnahmenanforderungen.

#### Verbindungsfehler
<a name="qbs-actions-troubleshooting-qbs-actions-connection-failures"></a>

```
Symptom: "Unable to connect to service" error
Resolution:
```

1. Überprüfen Sie die Verfügbarkeit des Dienstes.

1. Überprüfen Sie die Netzwerkkonnektivität.

1. Bestätigen Sie die Anmeldeinformationen.

1. Überprüfen von -Servicekontingenten.

### Aktionsspezifische Probleme
<a name="qbs-actions-troubleshooting-qbs-actions-action-specific-issues"></a>

#### Fehler beim Einreichen des Formulars
<a name="qbs-actions-troubleshooting-qbs-actions-form-submission-failures"></a>

##### Validierungsfehler
<a name="qbs-actions-troubleshooting-qbs-actions-validation-errors"></a>
+ Überprüfen Sie die erforderlichen Felder.
+ Überprüfen Sie die Datenformate.
+ Überprüfen Sie die Feldbeschränkungen.
+ Suchen Sie nach Sonderzeichen.

##### Probleme mit dem Timeout
<a name="qbs-actions-troubleshooting-qbs-actions-timeout-issues"></a>
+ Reduzieren Sie die Komplexität von Formularen.
+ Überprüfen Sie die Netzwerklatenz.
+ Überprüfen Sie die Reaktionszeiten des Dienstes.
+ Erwägen Sie, mehrere Aktionen durchzuführen.

#### Synchronisierungs- und Leistungsprobleme
<a name="qbs-actions-troubleshooting-qbs-actions-sync-performance-issues"></a>

##### Langsame Reaktionszeiten
<a name="qbs-actions-troubleshooting-qbs-actions-slow-response-times"></a>

```
Resolution:
```

1. Überprüfen Sie die API-Ratenlimits.

1. Überprüfen Sie gleichzeitige Ausführungen.

1. Überwachen Sie den Dienststatus.

1. Optimieren Sie die Aktionskonfiguration.

##### Fehlgeschlagene Ausführungen
<a name="qbs-actions-troubleshooting-qbs-actions-failed-executions"></a>

```
Resolution:
```

1. Überprüfen Sie die CloudWatch Protokolle.

1. Überprüfen Sie die Fehlermeldungen.

1. Überprüfen Sie den Dienststatus.

1. Testen Sie den Zustand der Verbindung.

## Häufige Fehlermeldungen
<a name="qbs-actions-troubleshooting-qbs-actions-error-messages"></a>


**Fehlercodes und Lösungen**  

| Fehlercode | Description | Auflösung | 
| --- | --- | --- | 
| AUTH\$1001 | Die Authentifizierung ist fehlgeschlagen | Überprüfen Sie die Anmeldeinformationen und versuchen Sie es erneut | 
| CONN\$1002 | Verbindungstimeout | Überprüfen Sie den Netzwerk- und Dienststatus | 
| PERM\$1003 | Unzureichende Berechtigungen | Überprüfen Sie die erforderlichen Berechtigungen | 
| TOKEN\$1004 | Das Token ist abgelaufen | Initiieren Sie die Authentifizierung erneut |