La référence AWS Partner Central d'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 la connexion et la configuration du serveur MCP Partner Central Agent.
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 sur HTTPS |
| Streaming | Server-Sent Événements (SSE) |
| Authentification | AWS Version 4 de la signature |
| 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
Le moyen le plus simple d'accorder l'accès au protocole MCP consiste à associer la politique AWSMcpServiceActionsFullAccess gérée à votre identité IAM. Cette politique inclut toutes les autorisations nécessaires pour interagir avec le serveur MCP. Pour un contrôle précis, vous pouvez utiliser la clé de aws:IsMcpServiceAction condition de vos politiques IAM pour définir les autorisations spécifiques aux actions de service MCP.
| Action | Description |
|---|---|
partnercentral:UseSession |
Création, mise à jour et récupération de sessions de conversation |
Gestion des opportunités
| Action | Description |
|---|---|
partnercentral:List* |
Répertoriez 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 examen |
partnercentral:AssignOpportunity |
Attribuer une opportunité à un représentant du partenaire |
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 |
Liste des allocations d'avantages disponibles pour votre compte |
partnercentral:ListBenefitApplications |
Liste des 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 |
Lier une ressource à une demande de prestations |
partnercentral:DisassociateBenefitApplicationResource |
Supprimer un lien vers une ressource d'une demande de prestations |
Accès à la Marketplace
| Action | Description |
|---|---|
aws-marketplace:DescribeEntity |
Récupérer les détails d'une entité de marché |
aws-marketplace:SearchAgreements |
Contrats de recherche sur le marché |
aws-marketplace:ListEntities |
Lister les entités du marché |
Agent d'intégration
Gestion des comptes partenaires (partnercentral) :
| Action | Description |
|---|---|
partnercentral:ListPartners |
Répertorier les enregistrements de partenaires pour le compte |
partnercentral:GetPartner |
Récupérez les informations d'enregistrement et de profil des partenaires |
partnercentral:GetProfileVisibility |
Récupère la visibilité du profil actuel (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 d'e-mail de certification de formation associé |
partnercentral:GetAccountConnections |
Répertorier les connexions aux comptes actifs (par exemple, liens subsidiaires) |
partnercentral:GetConnectionInvitations |
Répertorier les 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 une connexion active à un compte |
partnercentral:ManageConnectionPreferences |
Obtenir ou mettre à jour les préférences de partage entre les comptes connectés |
Configuration du vendeur sur le Marketplace (aws-marketplace) :
| Action | Description |
|---|---|
aws-marketplace:ListEntities |
Répertoriez les entités Marketplace (par exemple, les entités vendeuses) |
aws-marketplace:DescribeEntity |
Récupérez les informations complètes d'une entité Marketplace |
aws-marketplace:DescribeChangeSet |
Vérifier le statut d'un ensemble de modifications soumis |
aws-marketplace:StartChangeSet |
Soumettre un ensemble de modifications au 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 réelles des partenaires. |
"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 de l'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 après 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 MB |
| Limite de taille du document | 4,5 MO |
| Extensions autorisées | doc, docx, pdf, png,
jpeg, xlsx, csv,
txt |
| godet S3 (production) | fichiers aws-partner-central-marketplace-ephemeral-writeonly-files |
| Chemin de téléchargement | s3://{bucket}/{aws-account-id}/ |
| Exigence d'URI S3 | Doit inclure le paramètre de versionId requête |
Flux de travail de téléchargement
Chargez votre fichier dans le compartiment S3 approprié sous le préfixe d'identifiant de votre 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 dispose pas de l'partnercentral:action requise pour cette opération |
-32002 |
ACCESS_DENIED |
Accès général refusé (compte non inscrit, incompatibilité de région, etc.) |
-32004 |
LIMIT_EXCEEDED |
Limite de débit ou quota dépassé. Réessayez avec un recul 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 demandes par minute | 20 |
Si vous dépassez ces limites, le serveur renvoie le code d'erreur -32004 (LIMIT_EXCEDED). Mettez en œuvre un ralentissement exponentiel avec instabilité chez votre client afin de gérer la limitation du débit avec élégance.
Types d'événements de streaming (SSE)
Lorsque stream ce paramètre 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 streaming établie |
assistant-response.start |
L'agent a commencé à générer une réponse |
assistant-response.delta |
Partie de texte incrémentielle 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'un appel d'outil interne |
tool_approval_request |
L'agent demande l'approbation humaine pour une opération d'écriture |
stream_end |
Fermeture de la connexion au streaming |
done |
Événement final indiquant que le stream SSE est terminé |
Étapes suivantes
Référence des outils — Documentation détaillée
sendMessageetgetSessionoutils