Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Utilizzo di connettori gestiti dai partner
Un connettore gestito dai partner si connette AWS DevOps Agente a un server Model Context Protocol (MCP) ospitato da un partner. Gli esempi includono il servizio di osservabilità o gestione degli incidenti di un partner. Il partner pubblica il connettore nel AWS DevOps Archivio Agent Tools
Con un connettore, non è necessario cercare gli URL degli endpoint, gli URL OAuth o gli ambiti del partner. Scegli un endpoint e inserisci solo le tue credenziali e AWS DevOps L'agente crea il resto della registrazione dal connettore. Utilizza un connettore quando il partner ne pubblica uno per il suo server MCP. Per istruzioni sulla registrazione di qualsiasi altro server MCP, vedere Registrazione di un server MCP.
In questo argomento, connettore indica la definizione del partner e server MCP indica la registrazione che viene creata da esso. La console utilizza gli stessi termini, ad esempio Rimuovi il server MCP.
Un connettore registra un server MCP, quindi i suoi strumenti funzionano come per un server MCP che registri tu stesso. Un connettore fornisce anche quanto segue:
Configurazione fissa — Gli URL degli endpoint, i metodi di autenticazione e gli URL e gli ambiti OAuth provengono dal connettore. Non puoi cambiarli.
Competenze consigliate — È possibile installare le competenze consigliate dal connettore quando lo si aggiunge a un Agent Space. Successivamente, puoi installarne altre, attivarle o disattivarle o rimuoverle.
Webhook di avviso — Quando si aggiunge il connettore a un Agent Space, AWS DevOps L'agente crea un webhook in modo che gli avvisi provenienti dal prodotto del partner possano avviare le indagini. Alcuni connettori definiscono anche il payload degli avvisi per te.
Come funzionano i connettori gestiti dai partner
L'elenco seguente descrive chi gestisce il server di un connettore e dove vanno i tuoi dati:
Funzionamento del server — Il partner gestisce e supporta il server MCP. AWS non lo gestisce. Per assistenza con il server, usa il Supporto collegamento per il connettore nella console.
Manutenzione del connettore — Ogni connettore mostra un Partner-managed o AWS-gestito distintivo. I nomi dei badge che mantengono la definizione del connettore.
Credenziali — Le tue credenziali vanno solo agli URL nella definizione del connettore.
Richieste — L'endpoint che scegli appartiene alla regione o al sito del partner per il tuo account con il partner. Può essere al di fuori del AWS Regione del tuo spazio agente. Come per qualsiasi server MCP a cui ci si connette, le richieste al server vengono quindi abbandonate AWS Regione.
Registrazioni e versioni
L'elenco seguente descrive in che modo una registrazione si riferisce ad Agent Spaces e alle versioni dei connettori:
Ambito di registrazione — Si registra un connettore una volta nel AWS account. Quindi lo aggiungi a ogni Agent Space che ne ha bisogno.
Versioni — Una registrazione mantiene la versione del connettore registrata. Quando un partner rende obsoleto un connettore, il connettore non viene più visualizzato nella Disponibile sezione e non puoi registrarla nuovamente. La sua scheda è sotto Attualmente registrato mostra Obsoletoe la pagina che Visualizza tutto opens può assegnare un nome al connettore che lo sostituisce. Le registrazioni esistenti continuano a funzionare finché non vengono annullate.
Competenze consigliate
Un'abilità consigliata è un'abilità che il partner suggerisce per il suo connettore, ad esempio una guida sull'uso degli strumenti del partner durante un'indagine. Le competenze consigliate provengono dal catalogo delle competenze in AWS DevOps Archivio Agent Tools
Un'abilità installata consigliata viene visualizzata insieme alle altre abilità nel tuo Agent Space. Il suo contenuto proviene dal catalogo, quindi non è possibile modificarlo. L'agente lo carica nello stesso modo di qualsiasi altra abilità. Per ulteriori informazioni sulle competenze, consulta DevOps Competenze degli agenti.
Prima di iniziare
Per utilizzare un connettore gestito dai partner, verifica di disporre di quanto segue:
Un account con il partner in grado di creare le credenziali richieste dal connettore, ad esempio una chiave API o un client OAuth. La guida alla configurazione del connettore elenca i passaggi del prodotto del partner.
Autorizzazione a registrare i fornitori di funzionalità e ad aggiungere funzionalità a un Agent Space nel AWS DevOps Console dell'agente.
(Facoltativo) Una connessione privata esistente, se raggiungi l'endpoint del partner tramite una rete privata. Per ulteriori informazioni sulle connessioni private, consulta Connessione a strumenti ospitati privatamente.
Per ulteriori informazioni sulle considerazioni di sicurezza che si applicano a qualsiasi server MCP, ad esempio consentire l'inserimento di elenchi solo gli strumenti necessari, consultate Considerazioni sulla sicurezza.
Trovare un connettore
Trova un connettore per visualizzarne la guida alla configurazione e le competenze consigliate prima di registrarlo. Puoi iniziare con Fornitori di capacità pagina o da un Agent Space.
Ricerca di un connettore nella pagina Capability Providers
Per trovare un connettore su Fornitori di capacità pagina, completa i seguenti passaggi:
Aprire il AWS DevOps Console dell'agente all'indirizzo https://console.aws.amazon.com/devops-agent/
. Nel pannello di navigazione, scegli Fornitori di capacità.
Nel Disponibile sezione, trova il connettore. Per restringere l'elenco, inserisci il suo nome in Trova funzionalitào scegli una categoria. Ogni scheda riporta il badge, la descrizione e le categorie del connettore.
Scegli il nome del connettore.
Si apre la pagina del connettore. Per saltarla e iniziare la registrazione, puoi scegliere Registrare sulla carta invece.
Trovare un connettore da un Agent Space
Per trovare un connettore da un Agent Space, completa i seguenti passaggi:
Aprite il AWS DevOps Console dell'agente all'indirizzo https://console.aws.amazon.com/devops-agent/
, quindi seleziona il tuo Agent Space. Scegli la scheda Funzionalità.
Nella sezione relativa alla categoria del connettore, ad esempio Telemetria, Comunicazioni, o DevOps, scegli Inserisci.
Nel Aggiungere una funzionalità, sotto Partner-managed connettori, scegli Registrare.
Nell'elenco dei connettori, scegli Seleziona per il connettore.
Si apre la pagina del connettore.
Cosa mostra la pagina del connettore
La pagina del connettore mostra le seguenti informazioni:
Il partner, la versione del connettore e le relative categorie
Collegamenti alla documentazione e al supporto del partner
La guida alla configurazione del connettore
Le competenze consigliate dal connettore
Per iniziare la registrazione, scegli Registrare. Per istruzioni, vedere Registrazione di un connettore.
Registrazione di un connettore
Quando si registra un connettore, AWS DevOps L'agente crea una registrazione del server MCP nel tuo AWS account dalla definizione del connettore. La registrazione è composta da quattro fasi. La console salta i passaggi non necessari al connettore.
Fase 1: dettagli del server MCP
In questo passaggio, assegnate un nome al server MCP e scegliete dove AWS DevOps L'agente si connette. Il titolo del passaggio include il nome del connettore, ad esempio Esempio di dettagli del server MCP di Corp.
Se il passaggio mostra Guida all'installazione, espandilo prima di compilare il modulo e completa i passaggi del partner. Mostrano come creare le credenziali che inserisci Fase 3: configurazione dell'autenticazione. Per conservare una copia dei passaggi, scegli Copia.
Immetti le seguenti informazioni:
Nome — Inserire un nome breve per questo server MCP. La console inserisce il nome del connettore, che è possibile modificare. Usa lettere, numeri, trattini (
-) e caratteri di sottolineatura (_). Il nome deve essere univoco nel tuo AWS account. AWS DevOps L'agente aggiunge il nome all'inizio del nome di ogni strumento e il nome dello strumento può contenere al massimo 64 caratteri, quindi mantieni il nome breve.Punto finale — Alcuni partner offrono più di un endpoint, ad esempio un sito regionale. In tal caso, scegli l'endpoint utilizzato dal tuo account con il partner. Altrimenti, la console mostra l'endpoint del connettore. L'URL dell'endpoint viene visualizzato in AWS CloudTrail accede al tuo account.
Campi del connettore — Alcuni connettori richiedono più valori, ad esempio il nome dell'istanza con il partner. Ogni campo mostra l'etichetta che gli assegna il connettore. Inserisci il valore del tuo account con il partner.
Connettiti all'endpoint utilizzando una connessione privata — (Facoltativo) Seleziona questa opzione per indirizzare le richieste all'endpoint del partner tramite una connessione privata esistente. Per un connettore che utilizza OAuth, puoi scegliere una connessione privata separata per lo scambio di token.
Configurazione avanzata — (Facoltativo) Scegli un cliente gestito AWS Servizio di gestione delle chiavi (AWS chiave KMS) per crittografare la registrazione. Per ulteriori informazioni sulla crittografia, vedere Crittografia inattiva per DevOps Agente.
Scegli Avanti.
Fase 2: Metodo di autenticazione
In questo passaggio, scegli come AWS DevOps L'agente esegue l'autenticazione sul prodotto del partner. Questo passaggio viene visualizzato solo quando il connettore offre più di un metodo di autenticazione. Il connettore definisce l'ordine dei metodi. Seleziona una delle seguenti opzioni:
Chiave API — AWS DevOps L'agente si autentica con una chiave che crei nel prodotto del partner, in modo da controllarne le autorizzazioni.
Credenziali del cliente OAuth — AWS DevOps L'agente si autentica con un ID cliente e un segreto che crei nel prodotto del partner.
Accedi a compagno (ad esempio, Accedi a Example Corp) — AWS DevOps L'agente agisce per tuo conto dopo che hai effettuato l'accesso al prodotto del partner.
Accedi con la registrazione dinamica del cliente — AWS DevOps L'agente registra il proprio client OAuth presso il partner e quindi agisce per tuo conto dopo l'accesso.
Scegli Avanti.
Fase 3: configurazione dell'autenticazione
In questo passaggio, inserisci le credenziali necessarie al tuo metodo di autenticazione. Le Definito dal connettore la sezione mostra i valori impostati dal connettore, che non è possibile modificare.
La console salta questo passaggio per Accedi con la registrazione dinamica del cliente. Inoltre, salta questo passaggio per Accedi a compagno quando il connettore fornisce il proprio client OAuth.
Chiave API
Per una chiave API, immettete un valore per ogni intestazione elencata nel connettore. Il connettore imposta il nome dell'intestazione e qualsiasi prefisso, ad esempio Bearer , quindi inserisci solo la chiave.
Credenziali del client OAuth
Per le credenziali del client OAuth, completa i seguenti passaggi:
Inserisci il ID cliente e Segreto del cliente che hai creato nel prodotto del partner.
(Facoltativo) Aggiungi Ambiti aggiuntivi e Parametri di scambio aggiuntivi. AWS DevOps L'agente li richiede in aggiunta agli ambiti e ai parametri definiti dal connettore.
Accedi al partner
Per Accedi a compagno, completa i seguenti passaggi:
Se il connettore non fornisce un proprio client OAuth, inserisci ID cliente e Segreto del cliente che hai creato nel prodotto del partner. Se il partner supporta Proof Key for Code Exchange (PKCE), puoi lasciare vuoto il segreto del cliente.
(Facoltativo) Aggiungi Ambiti aggiuntivi.
Scegli Avanti.
Fase 4: Rivedi e registrati
Per completare la registrazione, completa i seguenti passaggi:
Rivedi i dettagli. Per modificare un passaggio, scegli Modifica nella sezione dedicata a quel passaggio.
Scegli Registrati.
Se hai scelto un metodo di accesso, accedi alla pagina del partner aperta dalla console, quindi approva l'accesso.
La console torna a AWS DevOps Agente, e la registrazione è completa. Se ti sei registrato da un Agent Space, la console apre quindi la procedura per aggiungere il connettore a quell'Agent Space. Se ti sei registrato da Fornitori di capacità pagina, vedere Aggiungere un connettore a un Agent Space.
Se la registrazione non riesce, la console rimane in fase di revisione e mostra l'errore. Correggi i dettagli, quindi scegli Registrare di nuovo.
Aggiungere un connettore a un Agent Space
Quando si aggiunge un connettore a un Agent Space, si scelgono gli strumenti che gli agenti possono utilizzare e, facoltativamente, si installano le competenze consigliate del connettore. Se il connettore è stato registrato da Fornitori di capacità pagina, inizia dal tuo Agent Space:
Apri il AWS DevOps Console dell'agente all'indirizzo https://console.aws.amazon.com/devops-agent/
, quindi seleziona il tuo Agent Space. Scegli la scheda Funzionalità.
Nella sezione relativa alla categoria del connettore, scegli Inserisci.
Nel Aggiungere una funzionalità, trova il server MCP che hai registrato dal connettore, quindi scegli Inserisci.
Fase 1: Seleziona gli strumenti
In questo passaggio, scegli gli strumenti che l'agente può utilizzare in questo Agent Space. Seleziona solo gli strumenti di cui ha bisogno il tuo Agent Space. Se classifichi gli strumenti come di sola lettura o mutanti, scegli una classificazione per ogni strumento. Per ulteriori informazioni sulla classificazione degli strumenti, vedere Lavorare con azioni dirette. Per ulteriori informazioni sul numero massimo di strumenti MCP in un Agent Space, vedere Quote.
Alcuni connettori mostrano anche Tipo di autenticazione Webhook. Scegli in che modo il prodotto del partner si autentica nel webhook di avviso di Agent Space: HMAC (impostazione predefinita) o Chiave API. I connettori che definiscono i propri avvisi lo impostano per te.
Per saltare la fase delle competenze opzionali, scegli Passa a Rivedi e salva. Altrimenti, scegli Next (Successivo).
Fase 2: Seleziona le competenze consigliate (opzionale)
Questo passaggio viene visualizzato solo quando il connettore consiglia le competenze. In questo passaggio, scegli le competenze consigliate da installare. La console elenca le competenze consigliate dal connettore, nessuna selezionata. Viene visualizzata una skill già installata in Agent Space Abilitata o Disabilie non puoi selezionarlo. Seleziona le competenze che desideri installare, quindi scegli Avanti.
Passaggio 3: Rivedere e salvare
Per salvare il connettore nell'Agent Space, completare i seguenti passaggi:
Rivedi gli strumenti, le competenze e Webhook Alert digitare. Per modificarli, scegli Modifica nella loro sezione.
Selezionare Salva.
AWS DevOps L'agente aggiunge il server MCP all'Agent Space e quindi installa le competenze selezionate. Se una skill non viene installata, viene elencata una notifica e il server MCP rimane nell'Agent Space. Per riprovare, modifica il connettore nell'Agent Space, quindi seleziona la skill. Per istruzioni, consulta Modifica di un connettore in un Agent Space.
Impostazione del webhook di avviso
Dopo aver scelto Salva, si apre la console Configura un webhook di avviso. Si apre ogni volta che si aggiunge il connettore a un Agent Space, ma non quando si modifica il connettore. Dopo aver impostato il webhook, ogni avviso inviato avvia un'indagine nell'Agent Space.
Per configurare il webhook, completa i seguenti passaggi:
Copia il URL del webhook, il Intestazione o Segreto di firma, e il Corpo della richiesta o Richiedi il formato del corpo. Per salvare l'URL e il segreto in un file, scegli Scarica il file .csv. AWS DevOps L'agente mostra il segreto solo una volta.
Seleziona Ho salvato e archiviato il mio URL e le mie credenziali, quindi scegli Fatto.
Configura il webhook nel prodotto del partner. Per istruzioni, consulta la guida alla configurazione del connettore.
I valori funzionano come segue:
URL del webhook — L'URL a cui il prodotto del partner invia gli avvisi.
- Intestazione — Per un webhook che utilizza un token al portatore,
Authorization: Bearerintestazione che il prodotto del partner invia con ogni richiesta.Firma segreta — Per un webhook che firma le richieste, il segreto utilizzato dal prodotto del partner per firmare
timestamp:bodycon HMAC-SHA256. Il prodotto del partner invia il timestamp nelx-amzn-event-timestampintestazione e firma inx-amzn-event-signatureintestazione.Corpo della richiesta — Per un connettore che definisce i relativi avvisi, il payload degli avvisi. Il prodotto del partner inserisce i valori del modello quando viene attivato un avviso.
Formato del corpo della richiesta — Per qualsiasi altro connettore, il formato JSON che ogni avviso deve utilizzare. Assegna a ogni avviso un valore univoco
incidentId.
Quale delle Intestazione o Segreto di firma come vedi, dipende da come si autentica il webhook. O è il connettore a impostarlo o lo scegli tu Seleziona strumenti. Non dipende dal metodo di autenticazione scelto al momento della registrazione del connettore.
Per ulteriori informazioni sull'autenticazione e sul payload del webhook, vedi Invocando DevOps Agente tramite Webhook. Per ulteriori informazioni sulla sostituzione di un segreto perduto, vedi Rotazione delle credenziali del webhook.
Dove appare il connettore
Sul Capacità scheda, il connettore viene visualizzato nella sezione relativa alla prima categoria: Telemetria, Gasdotto, Comunicazioni, o DevOps. Un connettore la cui prima categoria è Nuvola, o che il catalogo non elenca più, viene visualizzato nel Server MCP sezione.
Modifica di un connettore in un Agent Space
È possibile modificare gli strumenti di un connettore in un Agent Space e installare, abilitare, disabilitare o rimuovere le competenze consigliate. Per modificare un connettore, completa i seguenti passaggi:
Aprite il AWS DevOps Console dell'agente all'indirizzo https://console.aws.amazon.com/devops-agent/
, quindi seleziona il tuo Agent Space. Sul Capacità scheda, seleziona il server MCP nella sua sezione, quindi scegli Modifica.
Attiva Seleziona strumenti, cambia gli strumenti. La console parte dagli strumenti che hai salvato. Se il server MCP non elenca più uno strumento salvato, la console rimuove lo strumento dalla selezione e mostra un avviso.
Attivato Seleziona le competenze consigliate, seleziona le competenze da conservare o installare. Per rimuovere una skill installata, cancellala.
(Facoltativo) Attivato Imposta lo stato dell'abilità, attiva o disattiva ogni abilità installata. Gli agenti utilizzano solo le abilità attive. Questo passaggio viene visualizzato solo quando è installata almeno una skill.
Attiva Rivedi e salva, rivedi le modifiche apportate a ciascuna abilità, quindi scegli Salva.
AWS DevOps L'agente salva le modifiche e il webhook di avviso rimane invariato. Prima di salvare, la revisione ti avvisa se la modifica rimuove le competenze. Ti avvisa anche se un altro connettore in Agent Space consiglia un'abilità da disattivare o rimuovere, perché la modifica si applica anche a quel connettore. Puoi installare nuovamente una skill rimossa in un secondo momento.
Se una modifica a una skill fallisce, viene elencata una notifica e le altre modifiche vengono mantenute. Per riprovare, modifica nuovamente il connettore.
Rimozione di un connettore da un Agent Space
Per rimuovere un connettore da un Agent Space, completare i seguenti passaggi:
Aprire il AWS DevOps Console dell'agente all'indirizzo https://console.aws.amazon.com/devops-agent/
, quindi seleziona il tuo Agent Space. Sul Capacità scheda, seleziona il server MCP nella sua sezione, quindi scegli Rimuovi.
Nel Rimuovi il server MCP, controlla la conferma, quindi scegli Rimuovi.
Il server MCP viene rimosso dall'Agent Space. La sua rimozione comporta anche l'eliminazione delle competenze consigliate del connettore installate nell'Agent Space. Ciò include un'abilità consigliata che hai installato tu stesso. Un'abilità rimane installata se viene consigliata anche da un altro connettore nell'Agent Space. La conferma nomina l'abilità o indica il numero di abilità prima che qualcosa venga eliminato. Questa operazione non può essere annullata.
Se AWS DevOps L'agente non è in grado di verificare quali competenze sono installate, lo dice la conferma. In tal caso, le competenze rimangono installate e Rimuovi rimuove solo il server MCP.
Aggiornamento o annullamento della registrazione di un connettore
Per trovare la registrazione di un connettore, completa i seguenti passaggi:
Apri il AWS DevOps Console dell'agente all'indirizzo https://console.aws.amazon.com/devops-agent/
. Nel pannello di navigazione, scegli Fornitori di capacità.
Sotto Attualmente registrato, trova la scheda del connettore, quindi scegli Visualizza tutto.
Nel Registrazioni, seleziona il server MCP.
Se la registrazione utilizza Accedi a compagno o Accedi con la registrazione dinamica del cliente, puoi accedere nuovamente senza annullare la registrazione, ad esempio dopo che il partner ha revocato l'accesso. Scegli Azioni, quindi scegli Aggiorna. Nella fase di revisione, esci URL di autorizzazione vuoto, scegli Aggiorna, quindi accedi alla pagina del partner. AWS DevOps L'agente aggiorna l'accesso e le credenziali del cliente e le associazioni di Agent Space rimangono invariate.
Per modificare una chiave API o le credenziali del client OAuth o per utilizzare una versione più recente del connettore, annulla la registrazione del server MCP e registra nuovamente il connettore. Per annullare la registrazione, rimuovi prima il server MCP da ogni Agent Space che lo utilizza. Per istruzioni, vedere Rimozione di un connettore da un Agent Space. Quindi seleziona il server MCP, scegli Azionie scegli Annulla la registrazione. La console annulla immediatamente la registrazione del server MCP, senza chiedere conferma.
Risoluzione dei problemi relativi ai connettori gestiti dai partner
Utilizza le seguenti informazioni per risolvere i problemi più comuni con i connettori gestiti dai partner.
«Questo connettore non definisce un URL per l'endpoint che hai scelto»
Questo errore indica che la definizione del connettore non include l'endpoint scelto. Per risolverlo, scegli un altro endpoint. Se l'errore persiste, contatta l'assistenza del connettore.
La registrazione non riesce perché il nome è in uso
I nomi dei server MCP devono essere univoci nel tuo AWS account. Per risolvere il problema, inserisci un altro nome in Fase 1: dettagli del server MCPe quindi effettuare nuovamente la registrazione.
La pagina webhook di avviso non mostra alcuna credenziale
Se Configura un webhook di avviso mostra un errore al posto dell'intestazione o del segreto di firma, AWS DevOps L'agente non ha restituito una credenziale per il webhook. Per ottenerne una, ruota il webhook. Per istruzioni, consulta Rotazione delle credenziali del webhook.
Gli avvisi non avviano le indagini
Il prodotto del partner deve inviare la richiesta esattamente come indicata dalla console. Per risolvere il problema, completala seguente procedura:
Nel prodotto del partner, verifica che il webhook utilizzi l'URL del webhook dalla console.
Verifica che ogni richiesta includa
Authorizationintestazione ox-amzn-event-timestampex-amzn-event-signatureintestazioni per un webhook firmato.Verifica che il corpo della richiesta corrisponda a Corpo della richiesta o Richiedi il formato del corpo dalla console.
Per ulteriori procedure di risoluzione dei problemi, consulta Risoluzione dei problemi relativi ai webhook.