L' Centrale Partner AWS API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'Centrale Partner AWS API Reference.
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à.
Informazioni di riferimento sulla configurazione
Questa pagina fornisce il riferimento completo per la connessione e la configurazione del server MCP Partner Central Agent.
Endpoint
| Proprietà | Valore |
|---|---|
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp |
| Region | us-east-1solo (Virginia settentrionale) |
| Protocollo | JSON-RPC 2.0 su HTTPS |
| Streaming | Server-Sent Eventi (SSE) |
| Autenticazione | AWS Signature versione 4 |
| Nome del servizio SIGv4 | partnercentral-agents-mcp |
| requisito TLS | TLS 1.2 o superiore |
autorizzazioni IAM
Tutte le azioni IAM utilizzano il partnercentral: prefisso se non diversamente specificato.
Accesso al protocollo MCP
Come AWS identità autenticata, per impostazione predefinita si dispone dell'accesso tramite protocollo al server MCP. Non è necessario un IAM Allow esplicito per l'accesso al protocollo.
Per l'autenticazione OAuth, sono richieste le seguenti autorizzazioni di accesso:
| Azione | Description |
|---|---|
signin:AuthorizeOAuth2Access |
Autorizza il flusso OAuth basato su browser |
signin:CreateOAuth2Token |
Emette e aggiorna i token di accesso OAuth |
Per limitare l'accesso MCP, applica un pulsante Deny esplicito. partnercentral:InvokeMcp
Gestione delle opportunità
| Azione | Description |
|---|---|
partnercentral:List* |
Elenca opportunità, soluzioni e altre risorse di Partner Central |
partnercentral:Get* |
Recupera i dettagli delle singole opportunità e di altre risorse |
partnercentral:CreateOpportunity |
Crea un'opportunità |
partnercentral:UpdateOpportunity |
Modifica i campi delle opportunità (fase, data di chiusura, entrate, ecc.) |
partnercentral:SubmitOpportunity |
Invia un'opportunità di AWS revisione |
partnercentral:AssignOpportunity |
Assegna un'opportunità a un rappresentante del partner |
partnercentral:AssociateOpportunity |
Collega un'opportunità a un'altra risorsa (soluzione, ecc.) |
partnercentral:DisassociateOpportunity |
Rimuovere un collegamento tra un'opportunità e un'altra risorsa |
partnercentral:StartEngagementFromOpportunityTask |
Invia opportunità per iniziare un coinvolgimento partendo da un'opportunità |
Programmi di finanziamento
| Azione | Description |
|---|---|
partnercentral:ListBenefitAllocations |
Elenca le allocazioni dei vantaggi disponibili per il tuo account |
partnercentral:ListBenefitApplications |
Elenca le domande di benefit presentate |
partnercentral:CreateBenefitApplication |
Crea una nuova domanda di benefit (MAP, POC, WMP) |
partnercentral:GetBenefitApplication |
Recupera i dettagli di una specifica domanda di benefit |
partnercentral:UpdateBenefitApplication |
Aggiornare una domanda di benefit in sospeso |
partnercentral:AssociateBenefitApplicationResource |
Collegare una risorsa a una domanda di benefit |
partnercentral:DisassociateBenefitApplicationResource |
Rimuovere un collegamento a una risorsa da una domanda di benefit |
Accesso al marketplace
| Azione | Description |
|---|---|
aws-marketplace:DescribeEntity |
Recupera i dettagli di un'entità del marketplace |
aws-marketplace:SearchAgreements |
Cerca accordi sul marketplace |
aws-marketplace:ListEntities |
Elenca le entità del marketplace |
Agente di onboarding
Gestione degli account dei partner (partnercentral):
| Azione | Description |
|---|---|
partnercentral:ListPartners |
Elenca le registrazioni dei partner per l'account |
partnercentral:GetPartner |
Recupera la registrazione dei partner e i dettagli del profilo |
partnercentral:GetProfileVisibility |
Recupera la visibilità attuale del profilo () PUBLIC/PRIVATE |
partnercentral:GetAllianceLeadContact |
Recupera le informazioni di contatto dei lead dell'alleanza |
partnercentral:GetProfileUpdateTask |
Verifica lo stato di un aggiornamento asincrono del profilo in sospeso |
partnercentral:StartProfileUpdateTask |
Invia un aggiornamento del profilo del partner (asincrono) |
partnercentral:CancelProfileUpdateTask |
Annulla un'attività di aggiornamento del profilo in sospeso |
partnercentral:PutProfileVisibility |
Cambia la visibilità del profilo in PUBBLICO o PRIVATO |
partnercentral:PutAllianceLeadContact |
Aggiorna il contatto principale dell'alleanza (nome, titolo, email) |
partnercentral:SendEmailVerificationCode |
Invia un codice di verifica per le modifiche via email domain/contact |
partnercentral:AssociateAwsTrainingCertificationEmailDomain |
Collega un dominio email per il monitoraggio delle certificazioni di formazione |
partnercentral:DisassociateAwsTrainingCertificationEmailDomain |
Rimuovi un dominio email collegato per la certificazione della formazione |
partnercentral:GetAccountConnections |
Elenca le connessioni attive agli account (ad esempio, link sussidiari) |
partnercentral:GetConnectionInvitations |
Elenco degli inviti di connessione inviati e ricevuti in sospeso |
partnercentral:CreateConnectionInvitation |
Invia un invito alla connessione a un altro account AWS |
partnercentral:CancelConnectionInvitation |
Annulla un invito alla connessione in uscita in sospeso |
partnercentral:RespondConnectionInvitation |
Accetta o rifiuta un invito alla connessione in entrata |
partnercentral:CancelConnection |
Annullare una connessione attiva all'account |
partnercentral:ManageConnectionPreferences |
Ottieni o aggiorna le preferenze di condivisione tra account connessi |
Configurazione del venditore del Marketplace (aws-marketplace):
| Azione | Description |
|---|---|
aws-marketplace:ListEntities |
Elenca le entità del Marketplace (ad esempio, le entità venditrici) |
aws-marketplace:DescribeEntity |
Recupera i dettagli completi di un'entità del Marketplace |
aws-marketplace:DescribeChangeSet |
Controlla lo stato di un set di modifiche inviato |
aws-marketplace:StartChangeSet |
Invia un set di modifiche al Marketplace (ad esempio, aggiornamento del profilo del venditore) |
IAM — ruolo collegato ai servizi ()iam:
| Azione | Description |
|---|---|
iam:GetRole |
Verifica se esiste il ruolo collegato al servizio di autorizzazione alla rivendita del Marketplace |
iam:CreateServiceLinkedRole |
Crea il ruolo AWSServiceRoleForMarketplaceResaleAuthorization |
Ambienti di catalogo
| Catalogo | Description |
|---|---|
"AWS" |
Ambiente di produzione Tutte le operazioni influiscono sui dati in tempo reale dei partner. |
"Sandbox" |
Ambiente di test isolato. Nessun impatto sui dati di produzione. Utilizzabile per lo sviluppo e la convalida. |
Gestione della sessione
| Proprietà | Valore |
|---|---|
| Formato ID di sessione | UUID v4 con session- prefisso (ad es.) session-550e8400-e29b-41d4-a716-446655440000 |
| Creazione della sessione | Automatico alla prima sendMessage chiamata senza sessionId |
| Scadenza della sessione | 48 ore dalla creazione della sessione (scadenza assoluta, non basata sull'inattività) |
Caricamento di un file
| Proprietà | Valore |
|---|---|
| Numero massimo di file per messaggio | 3 |
| Limite di dimensione dell'immagine | 3,75 MB |
| Limite delle dimensioni del documento | 4,5 MB |
| Estensioni consentite | doc, docx, pdf, png,
jpeg, xlsx, csv,
txt |
| Secchio S3 (produzione) | aws-partner-central-marketplace-ephemeral-writeonly-files |
| Percorso di caricamento | s3://{bucket}/{aws-account-id}/ |
| Requisito URI S3 | Deve includere il parametro di versionId interrogazione |
Carica flusso di lavoro
Carica il file nel bucket S3 appropriato con il prefisso ID AWS del tuo account.
Annota l'URI S3 incluso quello
versionIdrestituito dal caricamento.Includi il file come blocco di
documentcontenuto nellasendMessagechiamata.
Esempio di formato URI S3:
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
Codici di errore
| Codice | Nome | Description |
|---|---|---|
-32001 |
AUTHENTICATION_FAILURE |
La firma SIGv4 non è valida o le credenziali sono scadute |
-31004 |
TOOL_PERMISSION_DENIED |
L'identità IAM non dispone dell'azione richiesta per questa operazione partnercentral: |
-32002 |
ACCESS_DENIED |
Accesso generale negato (account non registrato, regione non corrispondente, ecc.) |
-32004 |
LIMIT_EXCEEDED |
Limite o quota di tariffa superati. Riprova con un backoff esponenziale. |
-30001 |
RESOURCE_NOT_FOUND |
La risorsa richiesta (sessione, opportunità, ecc.) non esiste |
-32600 |
INVALID_REQUEST |
JSON-RPC Richiesta non valida o parametri non validi |
-32603 |
INTERNAL_ERROR |
Server-side errore. Riprova la richiesta . |
Limiti di frequenza
Il server applica limiti tariffari per account:
| Operation | Tasso sostenuto | Scoppio |
|---|---|---|
sendMessage |
2 richieste al minuto | 10 |
| Tutte le altre operazioni | 10 richieste al minuto | 20 |
Se si superano questi limiti, il server restituisce il codice di errore -32004 (LIMIT_EXCEEDED). Implementa il backoff esponenziale con jitter nel tuo client per gestire correttamente la limitazione della velocità.
Tipi di eventi in streaming (SSE)
Se stream è impostato su true In una sendMessage chiamata, il server restituisce Server-Sent Events con questi tipi di eventi:
| Tipo di evento | Description |
|---|---|
stream_start |
Connessione allo streaming stabilita |
assistant-response.start |
L'agente ha iniziato a generare una risposta |
assistant-response.delta |
Parte di testo incrementale della risposta dell'agente |
assistant-response.completed |
L'agente ha terminato la generazione della risposta |
server-tool-use |
L'agente sta richiamando uno strumento interno (operazione di lettura) |
server-tool-response |
Risultato di una chiamata interna allo strumento |
tool_approval_request |
L'agente richiede l'approvazione umana per un'operazione di scrittura |
stream_end |
Chiusura della connessione allo streaming |
done |
Evento finale che indica che lo stream SSE è completo |
Fasi successive
Riferimento agli strumenti : documentazione dettagliata per
sendMessageegetSessionstrumenti
