Se reestructuró la referencia de la Centro de socios de AWS API. Para obtener más información sobre las operaciones de API compatibles, consulte la referencia de la Centro de socios de AWS API.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Referencia de la configuración
Esta página proporciona la referencia completa para conectarse al servidor MCP de Partner Central Agent y configurarlo.
Punto de conexión
| Propiedad | Valor |
|---|---|
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp |
| Region | us-east-1(Virginia del Norte) únicamente |
| Protocolo | JSON-RPC 2.0 a través de HTTPS |
| Transmisión | Server-Sent Eventos (SSE) |
| Autenticación | AWS Signature, versión 4 |
| Nombre del servicio SigV4 | partnercentral-agents-mcp |
| Requisito de TLS | TLS 1.2 o superior |
Permisos de IAM
Todas las acciones de IAM utilizan el partnercentral: prefijo, a menos que se indique lo contrario.
Acceso al protocolo MCP
Como AWS identidad autenticada, tiene acceso protocolario al servidor MCP de forma predeterminada. No necesita un permiso de IAM explícito para el acceso al protocolo.
Para la autenticación OAuth, se requieren los siguientes permisos de inicio de sesión:
| Action | Description (Descripción) |
|---|---|
signin:AuthorizeOAuth2Access |
Autoriza el flujo de OAuth basado en el navegador |
signin:CreateOAuth2Token |
Emite y actualiza los tokens de acceso de OAuth |
Para restringir el acceso al MCP, aplica una opción de denegación explícita. partnercentral:InvokeMcp
Gestión de oportunidades
| Action | Description (Descripción) |
|---|---|
partnercentral:List* |
Enumere las oportunidades, las soluciones y otros recursos de Partner Central |
partnercentral:Get* |
Recupere los detalles de las oportunidades individuales y otros recursos |
partnercentral:CreateOpportunity |
Crea una oportunidad |
partnercentral:UpdateOpportunity |
Modifique los campos de oportunidad (fase, fecha de cierre, ingresos, etc.) |
partnercentral:SubmitOpportunity |
Envíe una oportunidad para su AWS revisión |
partnercentral:AssignOpportunity |
Asigne una oportunidad a un representante de un socio |
partnercentral:AssociateOpportunity |
Vincula una oportunidad a otro recurso (solución, etc.) |
partnercentral:DisassociateOpportunity |
Eliminar un vínculo entre una oportunidad y otro recurso |
partnercentral:StartEngagementFromOpportunityTask |
Envíe oportunidades para iniciar una interacción a partir de una oportunidad |
Programas de financiación
| Action | Description (Descripción) |
|---|---|
partnercentral:ListBenefitAllocations |
Enumere las asignaciones de beneficios disponibles para su cuenta |
partnercentral:ListBenefitApplications |
Enumere las solicitudes de beneficios presentadas |
partnercentral:CreateBenefitApplication |
Cree una nueva solicitud de beneficios (MAP, POC, WMP) |
partnercentral:GetBenefitApplication |
Recupere los detalles de una solicitud de beneficios específica |
partnercentral:UpdateBenefitApplication |
Actualice una solicitud de beneficios pendiente |
partnercentral:AssociateBenefitApplicationResource |
Vincular un recurso a una solicitud de beneficios |
partnercentral:DisassociateBenefitApplicationResource |
Elimine un enlace a un recurso de una solicitud de beneficios |
Acceso al mercado
| Action | Description (Descripción) |
|---|---|
aws-marketplace:DescribeEntity |
Recupera los detalles de una entidad del mercado |
aws-marketplace:SearchAgreements |
Busca acuerdos de mercado |
aws-marketplace:ListEntities |
Enumere las entidades del mercado |
Agente de incorporación
Administración de cuentas de socios (partnercentral):
| Action | Description (Descripción) |
|---|---|
partnercentral:ListPartners |
Enumera los registros de socios para la cuenta |
partnercentral:GetPartner |
Recupera los detalles de registro y perfil de los socios |
partnercentral:GetProfileVisibility |
Recupera la visibilidad del perfil actual (PUBLIC/PRIVATE) |
partnercentral:GetAllianceLeadContact |
Recupere la información de contacto principal de la alianza |
partnercentral:GetProfileUpdateTask |
Compruebe el estado de una actualización de perfil asincrónica pendiente |
partnercentral:StartProfileUpdateTask |
Envía una actualización del perfil de socio (asincrónica) |
partnercentral:CancelProfileUpdateTask |
Cancela una tarea de actualización de perfil pendiente |
partnercentral:PutProfileVisibility |
Cambia la visibilidad del perfil a PÚBLICA o PRIVADA |
partnercentral:PutAllianceLeadContact |
Actualice el contacto principal de la alianza (nombre, cargo, correo electrónico) |
partnercentral:SendEmailVerificationCode |
Envía un código de verificación para los cambios basados en el correo electrónico domain/contact |
partnercentral:AssociateAwsTrainingCertificationEmailDomain |
Vincula un dominio de correo electrónico para el seguimiento de la certificación de la formación |
partnercentral:DisassociateAwsTrainingCertificationEmailDomain |
Eliminar un dominio de correo electrónico de certificación de formación vinculado |
partnercentral:GetAccountConnections |
Enumera las conexiones de cuentas activas (por ejemplo, enlaces subsidiarios) |
partnercentral:GetConnectionInvitations |
Enumera las invitaciones de conexión pendientes enviadas y recibidas |
partnercentral:CreateConnectionInvitation |
Enviar una invitación de conexión a otra AWS cuenta |
partnercentral:CancelConnectionInvitation |
Cancelar una invitación de conexión saliente pendiente |
partnercentral:RespondConnectionInvitation |
Aceptar o rechazar una invitación de conexión entrante |
partnercentral:CancelConnection |
Cancelar una conexión de cuenta activa |
partnercentral:ManageConnectionPreferences |
Obtenga o actualice las preferencias de uso compartido entre cuentas conectadas |
Configuración para vendedores de Marketplace (aws-marketplace):
| Action | Description (Descripción) |
|---|---|
aws-marketplace:ListEntities |
Enumera las entidades de Marketplace (p. ej., las entidades vendedoras) |
aws-marketplace:DescribeEntity |
Recupera todos los detalles de una entidad de Marketplace |
aws-marketplace:DescribeChangeSet |
Comprueba el estado de un conjunto de cambios enviado |
aws-marketplace:StartChangeSet |
Envía un conjunto de cambios a Marketplace (por ejemplo, una actualización del perfil de vendedor) |
IAM: función vinculada al servicio (): iam
| Action | Description (Descripción) |
|---|---|
iam:GetRole |
Compruebe si existe la función vinculada al servicio de autorización de reventa de Marketplace |
iam:CreateServiceLinkedRole |
Creación del rol de AWSServiceRoleForMarketplaceResaleAuthorization |
Entornos de catálogo
| Catálogo | Description (Descripción) |
|---|---|
"AWS" |
Entorno de producción. Todas las operaciones afectan a los datos actuales de los socios. |
"Sandbox" |
Entorno de pruebas aislado. Sin impacto en los datos de producción. Úselo para el desarrollo y la validación. |
Administración de sesiones
| Propiedad | Valor |
|---|---|
| Formato de ID de sesión | UUID v4 con session- prefijo (p. ej.,) session-550e8400-e29b-41d4-a716-446655440000 |
| Creación de sesión | Automático en la primera sendMessage llamada sin sessionId |
| Caducidad de sesión | 48 horas desde la creación de la sesión (caducidad absoluta, no basada en la inactividad) |
Cargar archivo
| Propiedad | Valor |
|---|---|
| Número máximo de archivos por mensaje | 3 |
| Límite de tamaño de imagen | 3,75 MB |
| Límite de tamaño del documento | 4,5 MB |
| Extensiones permitidas | doc, docx, pdf, png,
jpeg, xlsx, csv,
txt |
| Cubeta S3 (producción) | aws-partner-central-marketplace-efímero-archivos-de solo escritura |
| Ruta de carga | s3://{bucket}/{aws-account-id}/ |
| Requisito de URI de S3 | Debe incluir el parámetro versionId de consulta |
Subir flujo de trabajo
Sube el archivo al bucket de S3 correspondiente con el prefijo de ID de tu AWS cuenta.
Anota la URI de S3, incluida la que
versionIddevolvió la subida.Incluye el archivo como bloque de
documentcontenido en tusendMessagellamada.
Ejemplo de formato URI S3:
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
Códigos de error
| Code | Name | Description (Descripción) |
|---|---|---|
-32001 |
AUTHENTICATION_FAILURE |
La firma SIGv4 no es válida o las credenciales han caducado |
-31004 |
TOOL_PERMISSION_DENIED |
La identidad de IAM carece de la partnercentral: acción requerida para esta operación |
-32002 |
ACCESS_DENIED |
Acceso general denegado (la cuenta no está inscrita, la región no coincide, etc.) |
-32004 |
LIMIT_EXCEEDED |
Se ha superado el límite de velocidad o la cuota. Vuelva a intentarlo con retroceso exponencial. |
-30001 |
RESOURCE_NOT_FOUND |
El recurso solicitado (sesión, oportunidad, etc.) no existe |
-32600 |
INVALID_REQUEST |
La JSON-RPC solicitud tiene un formato incorrecto o los parámetros no son válidos |
-32603 |
INTERNAL_ERROR |
Server-side error. Intente realizar de nuevo la solicitud . |
Límites de frecuencia
El servidor aplica límites de tarifas por cuenta:
| Operación | Tasa sostenida | Ráfaga |
|---|---|---|
sendMessage |
Dos solicitudes por minuto | 10 |
| Otras operaciones | 10 solicitudes por minuto | 20 |
Si superas estos límites, el servidor devuelve el código de error -32004 (LIMIT_EXCEEDED). Implementa un retroceso exponencial con fluctuación en tu cliente para gestionar la limitación de velocidad de forma eficiente.
Tipos de eventos de streaming (SSE)
Cuando stream está configurado como true en una sendMessage llamada, el servidor devuelve Server-Sent eventos con estos tipos de eventos:
| Tipo de evento | Description (Descripción) |
|---|---|
stream_start |
Se ha establecido la conexión de transmisión |
assistant-response.start |
El agente ha empezado a generar una respuesta |
assistant-response.delta |
Fragmento de texto incremental de la respuesta del agente |
assistant-response.completed |
El agente terminó de generar la respuesta |
server-tool-use |
El agente está invocando una herramienta interna (operación de lectura) |
server-tool-response |
Resultado de la invocación de una herramienta interna |
tool_approval_request |
El agente solicita la aprobación humana para una operación de escritura |
stream_end |
Se cierra la conexión de transmisión |
done |
Evento final que indica que la transmisión de SSE ha completado |
Siguientes pasos
Referencia de herramientas : documentación detallada sobre
getSessionherramientassendMessage
