A referência AWS Partner Central da API foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a Referência AWS Partner Central da API.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Referência da configuração
Esta página fornece a referência completa para conexão e configuração do Partner Central Agent MCP Server.
Endpoint
| Propriedade | Valor |
|---|---|
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp |
| Região | us-east-1Apenas (Norte da Virgínia) |
| Protocolo | JSON-RPC 2.0 sobre HTTPS |
| Streaming | Server-Sent Eventos (SSE) |
| Autenticação | AWS Signature versão 4 |
| Nome do serviço SigV4 | partnercentral-agents-mcp |
| Requisito de TLS | TLS 1.2 ou superior |
Permissões do IAM
Todas as ações do IAM usam o partnercentral: prefixo, salvo indicação em contrário.
Acesso ao protocolo MCP
A maneira mais simples de conceder acesso ao protocolo MCP é anexar a política AWSMcpServiceActionsFullAccess gerenciada à sua identidade do IAM. Essa política inclui todas as permissões necessárias para interagir com o servidor MCP. Para um controle refinado, você pode usar a chave de aws:IsMcpServiceAction condição em suas políticas do IAM para definir o escopo de permissões especificamente para ações de serviço MCP.
| Ação | Description |
|---|---|
partnercentral:UseSession |
Crie, atualize e recupere sessões de conversação |
Gerenciamento de oportunidades
| Ação | Description |
|---|---|
partnercentral:List* |
Listar oportunidades, soluções e outros recursos do Partner Central |
partnercentral:Get* |
Recupere detalhes de oportunidades individuais e outros recursos |
partnercentral:CreateOpportunity |
Crie uma oportunidade |
partnercentral:UpdateOpportunity |
Modifique os campos de oportunidade (estágio, data de fechamento, receita etc.) |
partnercentral:SubmitOpportunity |
Envie uma oportunidade para AWS análise |
partnercentral:AssignOpportunity |
Atribua uma oportunidade a um representante parceiro |
partnercentral:AssociateOpportunity |
Vincule uma oportunidade a outro recurso (solução etc.) |
partnercentral:DisassociateOpportunity |
Remover um link entre uma oportunidade e outro recurso |
partnercentral:StartEngagementFromOpportunityTask |
Envie oportunidades para iniciar um engajamento a partir de uma oportunidade |
Programas de financiamento
| Ação | Description |
|---|---|
partnercentral:ListBenefitAllocations |
Liste as alocações de benefícios disponíveis para sua conta |
partnercentral:ListBenefitApplications |
Listar os pedidos de benefícios enviados |
partnercentral:CreateBenefitApplication |
Crie um novo aplicativo de benefícios (MAP, POC, WMP) |
partnercentral:GetBenefitApplication |
Recupere detalhes de um pedido de benefício específico |
partnercentral:UpdateBenefitApplication |
Atualizar um pedido de benefício pendente |
partnercentral:AssociateBenefitApplicationResource |
Vincular um recurso a um aplicativo de benefícios |
partnercentral:DisassociateBenefitApplicationResource |
Remover um link de recurso de um aplicativo de benefícios |
Acesso ao Marketplace
| Ação | Description |
|---|---|
aws-marketplace:DescribeEntity |
Recuperar detalhes de uma entidade de mercado |
aws-marketplace:SearchAgreements |
Pesquise contratos de mercado |
aws-marketplace:ListEntities |
Listar entidades do mercado |
Agente de integração
Gerenciamento de contas de parceiros (partnercentral):
| Ação | Description |
|---|---|
partnercentral:ListPartners |
Listar registros de parceiros para a conta |
partnercentral:GetPartner |
Recupere o registro do parceiro e os detalhes do perfil |
partnercentral:GetProfileVisibility |
Recuperar a visibilidade do perfil atual () PUBLIC/PRIVATE |
partnercentral:GetAllianceLeadContact |
Recupere as informações de contato do líder da aliança |
partnercentral:GetProfileUpdateTask |
Verifique o status de uma atualização pendente do perfil assíncrono |
partnercentral:StartProfileUpdateTask |
Enviar uma atualização do perfil do parceiro (assíncrona) |
partnercentral:CancelProfileUpdateTask |
Cancelar uma tarefa pendente de atualização de perfil |
partnercentral:PutProfileVisibility |
Alterar a visibilidade do perfil para PÚBLICO ou PRIVADO |
partnercentral:PutAllianceLeadContact |
Atualizar contato do líder da aliança (nome, cargo, e-mail) |
partnercentral:SendEmailVerificationCode |
Envie um código de verificação para alterações baseadas em e-mail domain/contact |
partnercentral:AssociateAwsTrainingCertificationEmailDomain |
Vincule um domínio de e-mail para acompanhamento de certificações de treinamento |
partnercentral:DisassociateAwsTrainingCertificationEmailDomain |
Remover um domínio de e-mail de certificação de treinamento vinculado |
partnercentral:GetAccountConnections |
Listar conexões de contas ativas (por exemplo, links subsidiários) |
partnercentral:GetConnectionInvitations |
Listar convites de conexão enviados e recebidos pendentes |
partnercentral:CreateConnectionInvitation |
Enviar um convite de conexão para outra AWS conta |
partnercentral:CancelConnectionInvitation |
Cancelar um convite de conexão de saída pendente |
partnercentral:RespondConnectionInvitation |
Aceitar ou rejeitar um convite de conexão recebido |
partnercentral:CancelConnection |
Cancelar uma conexão de conta ativa |
partnercentral:ManageConnectionPreferences |
Obtenha ou atualize as preferências de compartilhamento entre contas conectadas |
Configuração do vendedor do Marketplace (aws-marketplace):
| Ação | Description |
|---|---|
aws-marketplace:ListEntities |
Listar entidades do Marketplace (por exemplo, entidades vendedoras) |
aws-marketplace:DescribeEntity |
Recupere todos os detalhes de uma entidade do Marketplace |
aws-marketplace:DescribeChangeSet |
Verifique o status de um conjunto de alterações enviado |
aws-marketplace:StartChangeSet |
Envie um conjunto de alterações do Marketplace (por exemplo, atualização do perfil do vendedor) |
IAM — função vinculada ao serviço ()iam:
| Ação | Description |
|---|---|
iam:GetRole |
Verifique se a função vinculada ao serviço Marketplace Resale Authorization existe |
iam:CreateServiceLinkedRole |
Criar o perfil do AWSServiceRoleForMarketplaceResaleAuthorization |
Ambientes de catálogo
| Catálogo | Description |
|---|---|
"AWS" |
Ambiente de produção. Todas as operações afetam os dados ativos do parceiro. |
"Sandbox" |
Ambiente de teste isolado. Sem impacto nos dados de produção. Use para desenvolvimento e validação. |
Gerenciamento de sessões
| Propriedade | Valor |
|---|---|
| Formato de ID da sessão | UUID v4 com session- prefixo (por exemplo,) session-550e8400-e29b-41d4-a716-446655440000 |
| Criação de sessão | Automático na primeira sendMessage chamada sem um sessionId |
| Expiração da sessão | 48 horas a partir da criação da sessão (expiração absoluta, não baseada em inatividade) |
Upload de arquivo
| Propriedade | Valor |
|---|---|
| Máximo de arquivos por mensagem | 3 |
| Limite de tamanho de imagem | 3,75 MB |
| Limite de tamanho de documentos | 4,5 MB |
| Extensões permitidas | doc, docx, pdf, png,
jpeg, xlsx, csv,
txt |
| Caçamba S3 (produção) | aws-partner-central-marketplace-efemeral-writeonly-files |
| Caminho de upload | s3://{bucket}/{aws-account-id}/ |
| Requisito de URI do S3 | Deve incluir o parâmetro versionId de consulta |
Carregar fluxo de trabalho
Faça upload do arquivo no bucket do S3 apropriado com o prefixo de ID AWS da conta.
Observe o URI do S3, incluindo o
versionIdretornado pelo upload.Inclua o arquivo como um bloco de
documentconteúdo na suasendMessagechamada.
Exemplo de formato de URI S3:
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
Códigos de erro
| Código | Name (Nome) | Description |
|---|---|---|
-32001 |
AUTHENTICATION_FAILURE |
A assinatura SigV4 é inválida ou as credenciais expiraram |
-31004 |
TOOL_PERMISSION_DENIED |
A identidade do IAM não tem a partnercentral: ação necessária para essa operação |
-32002 |
ACCESS_DENIED |
Acesso geral negado (conta não cadastrada, incompatibilidade de região etc.) |
-32004 |
LIMIT_EXCEEDED |
Limite de taxa ou cota excedido. Tente novamente com um recuo exponencial. |
-30001 |
RESOURCE_NOT_FOUND |
O recurso solicitado (sessão, oportunidade etc.) não existe |
-32600 |
INVALID_REQUEST |
JSON-RPC Solicitação malformada ou parâmetros inválidos |
-32603 |
INTERNAL_ERROR |
Server-side erro. Repetir a solicitação . |
Limites de taxa
O servidor impõe limites de taxa por conta:
| Operation | Taxa sustentada | Intermitência |
|---|---|---|
sendMessage |
2 solicitações por minuto | 10 |
| Todas as outras operações | 10 solicitações por minuto | 20 |
Se você exceder esses limites, o servidor retornará o código de erro -32004 (LIMIT_EXCEEDED). Implemente um recuo exponencial com instabilidade em seu cliente para lidar com a limitação de taxas com elegância.
Tipos de eventos de streaming (SSE)
Quando stream definido como true em uma sendMessage chamada, o servidor retorna Server-Sent Eventos com estes tipos de eventos:
| Tipo de evento | Description |
|---|---|
stream_start |
Conexão de transmissão estabelecida |
assistant-response.start |
O agente começou a gerar uma resposta |
assistant-response.delta |
Fragmento de texto incremental da resposta do agente |
assistant-response.completed |
O agente terminou de gerar a resposta |
server-tool-use |
O agente está invocando uma ferramenta interna (operação de leitura) |
server-tool-response |
Resultado de uma invocação de ferramenta interna |
tool_approval_request |
O agente está solicitando aprovação humana para uma operação de gravação |
stream_end |
Fechamento da conexão de transmissão |
done |
Evento final indicando que o fluxo SSE foi concluído |
Próximas etapas
Referência de ferramentas — documentação detalhada
sendMessageegetSessionferramentas