Vorschau : BigQuery Connector

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

MCP-Connector

Mit dem MCP-Connector (Model Context Protocol) können Sie eine MCP-Verbindung in Integration Connectors erstellen und konfigurieren. Sie können diese Verbindung in Ihren Geschäftsanwendungen verwenden, um Daten sicher auszutauschen und Vorgänge mit MCP auszuführen.

Eine Liste der unterstützten Entitäten und Vorgänge finden Sie unter Beispiele für Entitätsvorgänge. Informationen zu den unterstützten connectorspezifischen Aktionen finden Sie unter Aktionen.

Alle Verbindungen in Integration Connectors bieten eine Abstraktionsebene für die zugrunde liegenden Dienstobjekte. Diese Objekte werden als verwaltbare Entitäten verfügbar gemacht, sodass Sie Standard-Vorgänge ausführen oder connectorspezifische Aktionen verwenden können.

MCP-Connector-Versionen

Der MCP-Connector unterstützt zwei Versionen:

• MCP v1: Verwenden Sie diese Connector-Version, um auf die MCP v1 API zuzugreifen.
• MCP v2: Verwenden Sie diese Connector-Version, um auf die MCP v2 API zuzugreifen.

Informationen zum Erstellen einer MCP-Verbindung finden Sie unter MCP-Connector erstellen und konfigurieren.

Entitäten, Vorgänge und Aktionen

Alle Integration Connectors bieten eine Abstraktionsebene für die Objekte der verbundenen Anwendung. Sie können nur über diese Abstraktion auf die Objekte einer Anwendung zugreifen. Die Abstraktion wird Ihnen als Entitäten, Vorgänge und Aktionen zur Verfügung gestellt.

Hinweis: Sie können die Entitäten, Vorgänge und Aktionen eines Connectors in der Connectors-Aufgabe aufrufen.

• Entität: Eine Entität kann als Objekt oder Sammlung von Attributen in der verbundenen Anwendung oder im verbundenen Dienst verstanden werden. Die Definition einer Entität unterscheidet sich von Connector zu Connector. Beispiel: In einem Datenbank-Connector sind Tabellen die Entitäten, in einem Dateiserver-Connector sind Ordner die Entitäten und in einem Nachrichtensystem-Connector sind Warteschlangen die Entitäten.

  Es ist jedoch möglich, dass ein Connector keine Entitäten unterstützt oder keine Entitäten enthält. In diesem Fall ist die Entities Liste leer.

• Vorgang: Ein Vorgang ist die Aktivität, die Sie für eine Entität ausführen können. Sie können einen der folgenden Vorgänge für eine Entität ausführen:
  • Liste
  • Abrufen
  • Erstellen
  • Aktualisieren
  • Löschen

  Durch Auswahl einer Entität aus der verfügbaren Liste wird eine Liste der Vorgänge generiert, die für die Entität verfügbar sind. Eine detaillierte Beschreibung der Vorgänge finden Sie in den Entitätsvorgängen der Connectors-Aufgabe. Wenn ein Connector jedoch keine der Entitätsvorgänge unterstützt, werden diese nicht in der Operations Liste aufgeführt.

• Aktion: Eine Aktion ist eine Funktion erster Klasse, die über die Connector-Benutzeroberfläche für die Integration verfügbar gemacht wird. Mit einer Aktion können Sie Änderungen an einer oder mehreren Entitäten vornehmen, die von Connector zu Connector unterschiedlich sind. Normalerweise hat eine Aktion einige Eingabeparameter und einen Ausgabe parameter. Es ist jedoch möglich , dass ein Connector keine Aktionen unterstützt. In diesem Fall ist die Liste Actions leer.

Hinweis: Mit allen Entitäten und Aktionen ist ein Schema verknüpft. Ein Aktionsschema enthält beispielsweise die Parameterdetails wie die Parameternamen und den entsprechenden Datentyp. Das Schema (Metadaten) für Entitäten und Aktionen wird von der Verbindung zur Laufzeit aus Ihrem Back-End abgerufen. Wenn es Aktualisierungen am Schema gibt, werden diese nicht automatisch in Ihren vorhandenen Verbindungen berücksichtigt. Sie müssen das Schema manuell aktualisieren. Öffnen Sie zum Aktualisieren des Schemas für eine Verbindung die Seite Verbindungsdetails der Verbindung und klicken Sie dann auf Verbindungsschema aktualisieren.

Unterstützte Entitäten und Vorgänge

Der MCP-Connector unterstützt Entitäten und Vorgänge. Welche verfügbar sind, hängt vom Tool ab, das über MCP verbunden ist.

Beispiele für Entitätsvorgänge

In diesem Abschnitt finden Sie Beispiele für Entitätsvorgänge für verschiedene Tools.

Jira-Tickets auflisten

In diesem Beispiel werden alle Tickets in der Entität Tickets mit einer Jira-MCP-Verbindung aufgelistet.

1. Klicken Sie im Fenster Connector-Aufgabe konfigurieren auf Entitäten.
2. Wählen Sie in der Liste Entität die Option Tickets aus.
3. Wählen Sie den Vorgang Liste aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Standardwert ein:

   {
         "operation": "LIST_ENTITIES",
         "connection_name": "projects/YOUR_PROJECT_ID/locations/YOUR_LOCATION/connections/YOUR_JIRA_CONNECTION_NAME",
         "service_name": "projects/YOUR_TENANT_PROJECT_ID/locations/YOUR_LOCATION/namespaces/cloudrun/services/YOUR_RUNTIME_SERVICE",
         "host": "https://YOUR_TENANT_PROJECT_ID-YOUR_LOCATION.us-west1-runtime-connectors-google.com",
         "entity": "Issues",
         "entity_id": "Issues",
         "page_token": ""
       }

Alle Anfragen auflisten

In diesem Beispiel werden alle Anfragen in der Entität Anfragen aufgelistet.

1. Klicken Sie im Fenster Connector-Aufgabe konfigurieren auf Entitäten.
2. Wählen Sie in der Liste Entität die Option Anfragen aus.
3. Wählen Sie den Vorgang Liste aus und klicken Sie auf Fertig.

Nutzer nach ID abrufen

In diesem Beispiel wird der Nutzer mit AccountId als `6035864ce2020c0070b5285b` aus der Entität Nutzer abgerufen. `AccountId` ist der Primärschlüssel für die Entität Nutzer. Wenn Sie eine bestimmte Entität abrufen möchten, verwenden Sie den Vorgang Liste mit einer filterClause für den Primärschlüssel, da der Vorgang Abrufen für diese Entität nicht unterstützt wird.

1. Klicken Sie im Fenster Connector-Aufgabe konfigurieren auf Entitäten.
2. Wählen Sie in der Liste Entität die Option Nutzer aus.
3. Wählen Sie den Vorgang Liste aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf filterClause und geben Sie dann `AccountId`=6035864ce2020c0070b5285b in das Feld Standardwert ein.

Aktionen

Der MCP-Connector bietet verschiedene Aktionen. Welche verfügbar sind, hängt vom Tool ab, das über MCP verbunden ist.

Beispiele für Aktionen

In diesem Abschnitt wird beschrieben, wie Sie einige der Aktionen ausführen, die über den MCP-Connector für verschiedene Tools verfügbar sind.

Jira-Aktionen: Tickets abrufen

In diesem Beispiel wird gezeigt, wie Sie Jira-Tickets mit einer für Jira konfigurierten MCP-Verbindung auflisten.

1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
2. Wählen Sie die Aktion get_issues aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Standardwert ein:

     {
       "issue_ids": ["YOUR_ISSUE_ID_1", "YOUR_ISSUE_ID_2"]
     }

Linear-Aktionen: Tickets auflisten

In diesem Beispiel wird gezeigt, wie Sie Tickets in Linear mit einer für Linear konfigurierten MCP-Verbindung auflisten.

1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
2. Wählen Sie die Aktion list_issues aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Standardwert ein:

     {
       "limit": 50
     }

Sentry-Aktionen: Whoami

In diesem Beispiel wird gezeigt, wie Sie Nutzerinformationen aus Sentry mit einer für Sentry konfigurierten MCP-Verbindung abrufen.

1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
2. Wählen Sie die Aktion whoami aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Standardwert ein:

     {
       "name": "example-org"
     }

Organisationen suchen

In diesem Beispiel wird gezeigt, wie Sie Organisationen in Sentry mit einer für Sentry konfigurierten MCP-Verbindung suchen.

1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
2. Wählen Sie die Aktion find_organizations aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Standardwert ein:

     {}

Intercom-Aktionen: Unterhaltungen suchen

In diesem Beispiel wird gezeigt, wie Sie mit einer für Intercom konfigurierten MCP-Verbindung nach Unterhaltungsdetails in Intercom suchen.

1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
2. Wählen Sie die Aktion search aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Standardwert ein:

     {
       "query": "object_type:conversations state:open created_at:gt:2024-01-01"
     }

Systembeschränkungen

Der MCP-Connector hat Systembeschränkungen, die je nach verbundenem Tool variieren können. Standardmäßig weist Integration Connectors einer Verbindung zwei Knoten zu, um die Verfügbarkeit zu verbessern.

Informationen zu den für Integration Connectors geltenden Limits finden Sie unter Limits.

Hinweis: Die Anzahl der Integration Connectors-Knoten wird automatisch dynamisch an Ihre Nutzung angepasst. Wenn Sie jedoch Kapazität für große Mengen reservieren möchten, ohne auf das Autoscaling zu warten, können Sie den Mindestwert für Knoten für eine Verbindung anpassen. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, wenn eine Verbindung weniger Transaktionen verarbeitet. So konfigurieren Sie die Knoten Werte:

• Wenn Sie ein Kunde mit nutzungsabhängiger Bezahlung sind, konfigurieren Sie den Mindest- und Höchstwert für Knoten auf der Seite zum Bearbeiten der Verbindung.
• Wenn Sie ein Abo haben wenden Sie sich an den Support.

Die maximale Anzahl von Transaktionen, die ein Knoten verarbeiten kann, hängt von verschiedenen Faktoren ab. Bevor Sie also die Mindestanzahl von Knoten für einen besseren Durchsatz anpassen, sollten Sie prüfen, ob Ihre Back-End-Systeme optimal für die Verarbeitung des erforderlichen Traffics eingerichtet sind.