La référence de AWS Partner Central l'API a été restructurée. Pour plus d'informations sur les opérations d'API prises en charge, consultez la référence des AWS Partner Central API.
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Référence de configuration
Cette page fournit la référence complète pour se connecter au serveur MCP Partner Central Agent et le configurer.
Endpoint
| Propriété | Value |
|---|---|
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp |
| Région | us-east-1(Virginie du Nord) uniquement |
| Protocole | JSON-RPC 2.0 via HTTPS |
| Streaming | Server-Sent Événements (SSE) |
| Authentification | AWS Signature, version 4 |
| Nom du service SIGv4 | partnercentral-agents-mcp |
| Exigence TLS | TLS 1.2 ou supérieur |
Autorisations IAM
Toutes les actions IAM utilisent le partnercentral: préfixe, sauf indication contraire.
Accès au protocole MCP
En tant qu' AWS identité authentifiée, vous disposez par défaut d'un accès protocolaire au serveur MCP. Vous n'avez pas besoin d'une autorisation IAM explicite pour accéder au protocole.
Pour l'authentification OAuth, les autorisations de connexion suivantes sont requises :
| Action | Description |
|---|---|
signin:AuthorizeOAuth2Access |
Autorise le flux OAuth basé sur le navigateur |
signin:CreateOAuth2Token |
Émet et actualise les jetons d'accès OAuth |
Pour restreindre l'accès au MCP, appliquez une option Refuser explicite. partnercentral:InvokeMcp
Gestion des opportunités
| Action | Description |
|---|---|
partnercentral:List* |
Répertorier les opportunités, les solutions et les autres ressources de Partner Central |
partnercentral:Get* |
Récupérez les détails des opportunités individuelles et d'autres ressources |
partnercentral:CreateOpportunity |
Créez une opportunité |
partnercentral:UpdateOpportunity |
Modifier les champs d'opportunité (étape, date de clôture, chiffre d'affaires, etc.) |
partnercentral:SubmitOpportunity |
Soumettre une opportunité pour AWS évaluation |
partnercentral:AssignOpportunity |
Attribuer une opportunité à un représentant des partenaires |
partnercentral:AssociateOpportunity |
Lier une opportunité à une autre ressource (solution, etc.) |
partnercentral:DisassociateOpportunity |
Supprimer un lien entre une opportunité et une autre ressource |
partnercentral:StartEngagementFromOpportunityTask |
Soumettez des opportunités pour démarrer un engagement à partir d'une opportunité |
Programmes de financement
| Action | Description |
|---|---|
partnercentral:ListBenefitAllocations |
Répertorier les allocations d'avantages disponibles pour votre compte |
partnercentral:ListBenefitApplications |
Répertorier les demandes de prestations soumises |
partnercentral:CreateBenefitApplication |
Créez une nouvelle demande de prestations (MAP, POC, WMP) |
partnercentral:GetBenefitApplication |
Récupérez les détails d'une demande de prestations spécifique |
partnercentral:UpdateBenefitApplication |
Mettre à jour une demande de prestations en attente |
partnercentral:AssociateBenefitApplicationResource |
Associer une ressource à une demande de prestations |
partnercentral:DisassociateBenefitApplicationResource |
Supprimer un lien vers une ressource d'une demande de prestations |
Accès au marché
| Action | Description |
|---|---|
aws-marketplace:DescribeEntity |
Récupérer les informations d'une entité de la place de marché |
aws-marketplace:SearchAgreements |
Rechercher des contrats sur le marché |
aws-marketplace:ListEntities |
Liste des entités du marché |
Agent d'intégration
Gestion des comptes partenaires (partnercentral) :
| Action | Description |
|---|---|
partnercentral:ListPartners |
Répertorier les inscriptions des partenaires pour le compte |
partnercentral:GetPartner |
Récupérez les informations d'inscription et de profil des partenaires |
partnercentral:GetProfileVisibility |
Récupérer la visibilité actuelle du profil (PUBLIC/PRIVATE) |
partnercentral:GetAllianceLeadContact |
Récupérez les coordonnées du responsable de l'alliance |
partnercentral:GetProfileUpdateTask |
Vérifier l'état d'une mise à jour de profil asynchrone en attente |
partnercentral:StartProfileUpdateTask |
Soumettre une mise à jour du profil d'un partenaire (asynchrone) |
partnercentral:CancelProfileUpdateTask |
Annuler une tâche de mise à jour de profil en attente |
partnercentral:PutProfileVisibility |
Modifier la visibilité du profil en PUBLIC ou PRIVÉ |
partnercentral:PutAllianceLeadContact |
Mettre à jour le contact principal de l'alliance (nom, titre, e-mail) |
partnercentral:SendEmailVerificationCode |
Envoyer un code de vérification pour les modifications par e-mail domain/contact |
partnercentral:AssociateAwsTrainingCertificationEmailDomain |
Associer un domaine de messagerie pour le suivi des certifications de formation |
partnercentral:DisassociateAwsTrainingCertificationEmailDomain |
Supprimer un domaine de messagerie de certification de formation lié |
partnercentral:GetAccountConnections |
Répertorier les connexions de compte actives (par exemple, liens subsidiaires) |
partnercentral:GetConnectionInvitations |
Liste des invitations de connexion envoyées et reçues en attente |
partnercentral:CreateConnectionInvitation |
Envoyer une invitation de connexion à un autre AWS compte |
partnercentral:CancelConnectionInvitation |
Annuler une invitation de connexion sortante en attente |
partnercentral:RespondConnectionInvitation |
Accepter ou rejeter une invitation de connexion entrante |
partnercentral:CancelConnection |
Annuler la connexion à un compte actif |
partnercentral:ManageConnectionPreferences |
Obtenir ou mettre à jour les préférences de partage entre les comptes connectés |
Configuration du vendeur sur la place de marché (aws-marketplace) :
| Action | Description |
|---|---|
aws-marketplace:ListEntities |
Répertorier les entités de Marketplace (par exemple, les entités vendeurs) |
aws-marketplace:DescribeEntity |
Récupérez les informations complètes d'une entité Marketplace |
aws-marketplace:DescribeChangeSet |
Vérifier l'état d'un ensemble de modifications soumis |
aws-marketplace:StartChangeSet |
Soumettre un ensemble de modifications sur Marketplace (par exemple, mise à jour du profil du vendeur) |
IAM — rôle lié à un service () : iam
| Action | Description |
|---|---|
iam:GetRole |
Vérifiez si le rôle lié au service Marketplace Resale Authorization existe |
iam:CreateServiceLinkedRole |
Créez le AWSServiceRoleForMarketplaceResaleAuthorization rôle |
Environnements de catalogue
| Catalogue | Description |
|---|---|
"AWS" |
Environnement de production. Toutes les opérations ont une incidence sur les données des partenaires en direct. |
"Sandbox" |
Environnement de test isolé. Aucune incidence sur les données de production. À utiliser pour le développement et la validation. |
Gestion de session
| Propriété | Value |
|---|---|
| Format d'identifiant de session | UUID v4 avec session- préfixe (par exemple,) session-550e8400-e29b-41d4-a716-446655440000 |
| Création de session | Automatique dès le premier sendMessage appel sans sessionId |
| Expiration de session | 48 heures à compter de la création de la session (expiration absolue, non basée sur l'inactivité) |
Chargement d'un fichier
| Propriété | Value |
|---|---|
| Nombre maximum de fichiers par message | 3 |
| Limite de taille d'image | 3,75 MO |
| Limite de taille du document | 4,5 MO |
| Extensions autorisées | doc, docx, pdf, png,
jpeg, xlsx, csv,
txt |
| Seau S3 (production) | fichiers éphémères en écriture uniquement sur AWS Partner-Central-Marketplace-WriteOnly |
| Chemin de téléchargement | s3://{bucket}/{aws-account-id}/ |
| Exigence d'URI S3 | Doit inclure le paramètre de versionId requête |
Workflow de téléchargement
Téléchargez votre fichier dans le compartiment S3 approprié sous le préfixe de votre identifiant de AWS compte.
Notez l'URI S3, y compris celui
versionIdrenvoyé par le téléchargement.Incluez le fichier en tant que bloc de
documentcontenu dans votresendMessageappel.
Exemple de format d'URI S3 :
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
Codes d’erreur
| Code | Nom | Description |
|---|---|---|
-32001 |
AUTHENTICATION_FAILURE |
La signature SIGv4 n'est pas valide ou les informations d'identification ont expiré |
-31004 |
TOOL_PERMISSION_DENIED |
L'identité IAM ne comporte pas l'partnercentral:action requise pour cette opération |
-32002 |
ACCESS_DENIED |
Accès général refusé (compte non inscrit, région non correspondante, etc.) |
-32004 |
LIMIT_EXCEEDED |
Limite tarifaire ou quota dépassé. Réessayez avec un backoff exponentiel. |
-30001 |
RESOURCE_NOT_FOUND |
La ressource demandée (session, opportunité, etc.) n'existe pas |
-32600 |
INVALID_REQUEST |
JSON-RPC Demande mal formée ou paramètres non valides |
-32603 |
INTERNAL_ERROR |
Server-side erreur. Réitérez la demande. |
Limites de débit
Le serveur applique des limites de débit par compte :
| Opération | Taux soutenu | Mode rafale |
|---|---|---|
sendMessage |
2 demandes par minute | 10 |
| Toutes les autres opérations | 10 requêtes par minute | 20 |
Si vous dépassez ces limites, le serveur renvoie le code d'erreur -32004 (LIMIT_EXCEEDED). Mettez en œuvre un ralentissement exponentiel avec gigue chez votre client pour gérer la limitation du débit avec élégance.
Types d'événements de streaming (SSE)
Lorsqu'il stream est défini sur true Dans un sendMessage appel, le serveur renvoie Server-Sent des événements avec les types d'événements suivants :
| Type d’événement | Description |
|---|---|
stream_start |
Connexion au flux établie |
assistant-response.start |
L'agent a commencé à générer une réponse |
assistant-response.delta |
Bloc de texte incrémentiel de la réponse de l'agent |
assistant-response.completed |
L'agent a fini de générer la réponse |
server-tool-use |
L'agent invoque un outil interne (opération de lecture) |
server-tool-response |
Résultat d'une invocation d'outil interne |
tool_approval_request |
L'agent demande l'approbation d'une personne pour une opération d'écriture |
stream_end |
Fermeture de la connexion au flux |
done |
Événement final indiquant que le flux SSE est terminé |
Étapes suivantes
Référence sur les outils : documentation détaillée
sendMessageetgetSessionoutils
