Anteprima : connettore BigQuery

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Connettore MCP

Il connettore Model Context Protocol (MCP) consente di creare e configurare una connessione MCP in Integration Connectors. Puoi utilizzare questa connessione nelle tue applicazioni aziendali per scambiare dati in modo sicuro ed eseguire operazioni con MCP.

Per l'elenco delle entità e delle operazioni supportate, consulta Esempi di operazioni sulle entità. Per informazioni sulle azioni specifiche del connettore supportate, consulta Azioni.

Tutte le connessioni in Integration Connectors forniscono un livello di astrazione per gli oggetti di servizio sottostanti. Questi oggetti vengono esposti come entità gestibili, che consentono di eseguire operazioni standard o utilizzare azioni specifiche del connettore.

Versioni del connettore MCP

Il connettore MCP supporta due versioni:

• MCP v1: utilizza questa versione del connettore per accedere all'API MCP v1.
• MCP v2: utilizza questa versione del connettore per accedere all'API MCP v2.

Per informazioni sulla creazione di una connessione MCP, consulta Creare e configurare un connettore MCP.

Entità, operazioni e azioni

Tutti gli Integration Connectors forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione viene esposta come entità, operazioni e azioni.

Nota: puoi visualizzare le entità, le operazioni e le azioni di un connettore nell'attività Connettori.

• Entità: un'entità può essere considerata un oggetto o una raccolta di proprietà nell' applicazione o nel servizio connesso. La definizione di un'entità varia da connettore a connettore. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore di file server, le cartelle sono le entità e in un connettore di sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l' Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta Operazioni sulle entità dell'attività Connettori . Tuttavia, se un connettore non supporta nessuna delle operazioni sulle entità, le operazioni non supportate non vengono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe che viene resa disponibile all'integrazione tramite l'interfaccia del connettore. Un'azione consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione avrà alcuni parametri di input e un parametro di output parametro. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Nota: tutte le entità e le azioni avranno uno schema associato. Ad esempio, uno schema di azione avrà i dettagli dei parametri, ad esempio i nomi dei parametri e il tipo di dati corrispondente. Lo schema (metadati) per entità e azioni viene recuperato dalla connessione in fase di runtime dal backend. Se vengono apportati aggiornamenti allo schema, questi non verranno applicati automaticamente alle connessioni esistenti; devi aggiornare manualmente lo schema. Per aggiornare lo schema di una connessione, apri la pagina Dettagli connessione della connessione e fai clic Aggiorna schema di connessione.

Entità e operazioni supportate

Il connettore MCP supporta entità e operazioni, con quelle specifiche disponibili a seconda dello strumento connesso tramite MCP.

Esempi di operazioni sulle entità

Questa sezione fornisce esempi di operazioni sulle entità per diversi strumenti.

Elenca entità Problemi Jira

Questo esempio elenca tutti i problemi nell'entità Problemi utilizzando una connessione MCP Jira.

1. Nella finestra Configura attività connettore, fai clic su Entità.
2. Seleziona Problemi dall'elenco Entità.
3. Seleziona l'operazione Elenca e fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic connectorInputPayload e poi inserisci un valore simile al seguente nel campo Valore predefinito:

   {
         "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": ""
       }

Elenca tutte le richieste

Questo esempio elenca tutte le richieste nell'entità Richieste.

1. Nella finestra Configura attività connettore, fai clic su Entità.
2. Seleziona Richieste dall'elenco Entità.
3. Seleziona l'operazione Elenca e fai clic su Fine.

Scarica un utente per ID

Questo esempio recupera l'utente con AccountId come `6035864ce2020c0070b5285b` dall'entità Utenti. `AccountId` è la chiave primaria per l'entità Utenti. Per recuperare un'entità specifica, utilizza l'operazione Elenca con una filterClause sulla chiave primaria, poiché l'operazione Scarica non è supportata per questa entità.

1. Nella finestra Configura attività connettore, fai clic su Entità.
2. Seleziona Utenti dall'elenco Entità.
3. Seleziona l'operazione Elenca e fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su filterClause e poi inserisci `AccountId`=6035864ce2020c0070b5285b nel campo Valore predefinito.

Azioni

Il connettore MCP fornisce varie azioni, con quelle specifiche disponibili a seconda dello strumento connesso tramite MCP.

Esempi di azioni

Questa sezione descrive come eseguire alcune delle azioni disponibili tramite il connettore MCP per diversi strumenti.

Azioni Jira: recupera problemi

Questo esempio mostra come elencare i problemi Jira utilizzando una connessione MCP configurata per Jira.

1. Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
2. Seleziona l'azione get_issues e fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Valore predefinito:

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

Azioni lineari: elenca problemi

Questo esempio mostra come elencare i problemi in Linear utilizzando una connessione MCP configurata per Linear.

1. Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
2. Seleziona l'azione list_issues e fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Valore predefinito:

     {
       "limit": 50
     }

Azioni Sentry: Whoami

Questo esempio mostra come recuperare le informazioni utente da Sentry utilizzando una connessione MCP configurata per Sentry.

1. Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
2. Seleziona l'azione whoami e fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Valore predefinito:

     {
       "name": "example-org"
     }

Trova organizzazioni

Questo esempio mostra come trovare le organizzazioni in Sentry utilizzando una connessione MCP configurata per Sentry.

1. Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
2. Seleziona l'azione find_organizations e fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Valore predefinito:

     {}

Azioni Intercom: cerca conversazioni

Questo esempio mostra come cercare i dettagli delle conversazioni in Intercom utilizzando una connessione MCP configurata per Intercom.

1. Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
2. Seleziona l'azione search e fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Valore predefinito:

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

Limitazioni di sistema

Il connettore MCP presenta limitazioni di sistema che possono variare in base allo strumento specifico a cui è connesso. Per impostazione predefinita, Integration Connectors alloca 2 nodi (per una maggiore disponibilità) per una connessione.

Per informazioni sui limiti applicabili a Integration Connectors, consulta Limiti.

Nota: il numero di nodi di Integration Connectors verrà scalato automaticamente in modo dinamico in base all'utilizzo. Tuttavia, se vuoi riservare capacità per volumi elevati senza attendere la scalabilità automatica, puoi modificare il valore minimo del nodo per una connessione. Sono necessari più nodi per elaborare più transazioni per una connessione. Al contrario, sono necessari meno nodi se una connessione elabora meno transazioni. Per configurare i valori dei nodi :

• Se hai un account con pagamento a consumo, configura il valore minimo e massimo del nodo nella pagina di modifica della connessione.
• Se hai un account basato su abbonamento cliente, contatta l'assistenza.

Il numero massimo di transazioni che un nodo può gestire dipende da vari fattori. Pertanto, prima di modificare i nodi minimi per un throughput migliore, ti consigliamo di verificare se i sistemi di backend sono configurati in modo ottimale per gestire il traffico richiesto.