Referensi AWS Partner Central API direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Referensi AWS Partner Central API.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Referensi Konfigurasi
Halaman ini menyediakan referensi lengkap untuk menghubungkan dan mengonfigurasi Server MCP Agen Pusat Mitra.
Titik akhir
| Properti | Nilai |
|---|---|
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp |
| Region | us-east-1(Virginia N.) hanya |
| Protokol | JSON-RPC 2.0 melalui HTTPS |
| Streaming | Server-Sent Acara (SSE) |
| Autentikasi | AWS Versi Tanda Tangan 4 |
| Nama layanan SiGv4 | partnercentral-agents-mcp |
| Persyaratan TLS | TLS 1.2 atau lebih tinggi |
Izin IAM
Semua tindakan IAM menggunakan partnercentral: awalan kecuali dinyatakan lain.
Akses protokol MCP
Cara termudah untuk memberikan akses protokol MCP adalah dengan melampirkan kebijakan AWSMcpServiceActionsFullAccess terkelola ke identitas IAM Anda. Kebijakan ini mencakup semua izin yang diperlukan untuk berinteraksi dengan server MCP. Untuk kontrol halus, Anda dapat menggunakan kunci aws:IsMcpServiceAction kondisi dalam kebijakan IAM Anda untuk cakupan izin khusus untuk tindakan layanan MCP.
| Tindakan | Deskripsi |
|---|---|
partnercentral:UseSession |
Membuat, memperbarui, dan mengambil sesi percakapan |
Manajemen peluang
| Tindakan | Deskripsi |
|---|---|
partnercentral:List* |
Buat daftar peluang, solusi, dan sumber daya Pusat Mitra lainnya |
partnercentral:Get* |
Ambil detail untuk peluang individu dan sumber daya lainnya |
partnercentral:CreateOpportunity |
Ciptakan peluang |
partnercentral:UpdateOpportunity |
Ubah bidang peluang (tahap, tanggal tutup, pendapatan, dll.) |
partnercentral:SubmitOpportunity |
Kirimkan kesempatan untuk AWS ditinjau |
partnercentral:AssignOpportunity |
Tetapkan kesempatan kepada perwakilan mitra |
partnercentral:AssociateOpportunity |
Tautkan peluang ke sumber daya lain (solusi, dll.) |
partnercentral:DisassociateOpportunity |
Hapus tautan antara peluang dan sumber daya lain |
partnercentral:StartEngagementFromOpportunityTask |
Kirimkan kesempatan untuk memulai keterlibatan dari sebuah kesempatan |
Program pendanaan
| Tindakan | Deskripsi |
|---|---|
partnercentral:ListBenefitAllocations |
Buat daftar alokasi manfaat yang tersedia untuk akun Anda |
partnercentral:ListBenefitApplications |
Daftar aplikasi manfaat yang dikirimkan |
partnercentral:CreateBenefitApplication |
Buat aplikasi manfaat baru (MAP, POC, WMP) |
partnercentral:GetBenefitApplication |
Mengambil rincian aplikasi manfaat tertentu |
partnercentral:UpdateBenefitApplication |
Perbarui aplikasi manfaat yang tertunda |
partnercentral:AssociateBenefitApplicationResource |
Tautkan sumber daya ke aplikasi manfaat |
partnercentral:DisassociateBenefitApplicationResource |
Hapus tautan sumber daya dari aplikasi manfaat |
Akses Marketplace
| Tindakan | Deskripsi |
|---|---|
aws-marketplace:DescribeEntity |
Mengambil rincian entitas pasar |
aws-marketplace:SearchAgreements |
Cari perjanjian pasar |
aws-marketplace:ListEntities |
Daftar entitas pasar |
Agen Orientasi
Manajemen akun mitra (partnercentral):
| Tindakan | Deskripsi |
|---|---|
partnercentral:ListPartners |
Daftar pendaftaran mitra untuk akun |
partnercentral:GetPartner |
Ambil registrasi mitra dan detail profil |
partnercentral:GetProfileVisibility |
Ambil visibilitas profil saat ini () PUBLIC/PRIVATE |
partnercentral:GetAllianceLeadContact |
Ambil informasi kontak pemimpin aliansi |
partnercentral:GetProfileUpdateTask |
Periksa status pembaruan profil asinkron yang tertunda |
partnercentral:StartProfileUpdateTask |
Kirim pembaruan profil mitra (async) |
partnercentral:CancelProfileUpdateTask |
Membatalkan tugas pembaruan profil yang tertunda |
partnercentral:PutProfileVisibility |
Ubah visibilitas profil menjadi PUBLIK atau PRIBADI |
partnercentral:PutAllianceLeadContact |
Perbarui kontak utama aliansi (nama, judul, email) |
partnercentral:SendEmailVerificationCode |
Kirim kode verifikasi untuk perubahan berbasis email domain/contact |
partnercentral:AssociateAwsTrainingCertificationEmailDomain |
Menautkan domain email untuk pelacakan sertifikasi pelatihan |
partnercentral:DisassociateAwsTrainingCertificationEmailDomain |
Menghapus domain email sertifikasi pelatihan yang ditautkan |
partnercentral:GetAccountConnections |
Buat daftar koneksi akun aktif (mis., Tautan anak perusahaan) |
partnercentral:GetConnectionInvitations |
Daftar undangan koneksi terkirim dan terima yang tertunda |
partnercentral:CreateConnectionInvitation |
Kirim undangan koneksi ke AWS akun lain |
partnercentral:CancelConnectionInvitation |
Membatalkan undangan koneksi keluar yang tertunda |
partnercentral:RespondConnectionInvitation |
Menerima atau menolak undangan koneksi masuk |
partnercentral:CancelConnection |
Membatalkan koneksi akun aktif |
partnercentral:ManageConnectionPreferences |
Dapatkan atau perbarui preferensi berbagi antar akun yang terhubung |
Pengaturan penjual Marketplace (aws-marketplace):
| Tindakan | Deskripsi |
|---|---|
aws-marketplace:ListEntities |
Daftar entitas Marketplace (misalnya, entitas penjual) |
aws-marketplace:DescribeEntity |
Mengambil rincian lengkap dari entitas Marketplace |
aws-marketplace:DescribeChangeSet |
Memeriksa status set perubahan yang dikirimkan |
aws-marketplace:StartChangeSet |
Kirim set perubahan Marketplace (mis., Pembaruan profil penjual) |
IAM — peran terkait layanan (): iam
| Tindakan | Deskripsi |
|---|---|
iam:GetRole |
Periksa apakah peran terkait layanan Otorisasi Penjualan Kembali Marketplace ada |
iam:CreateServiceLinkedRole |
Buat AWSServiceRoleForMarketplaceResaleAuthorization peran |
Lingkungan katalog
| Katalog | Deskripsi |
|---|---|
"AWS" |
Lingkungan produksi. Semua operasi memengaruhi data mitra langsung. |
"Sandbox" |
Lingkungan pengujian yang terisolasi. Tidak berdampak pada data produksi. Gunakan untuk pengembangan dan validasi. |
Manajemen sesi
| Properti | Nilai |
|---|---|
| Format ID Sesi | UUID v4 dengan session- awalan (mis.,) session-550e8400-e29b-41d4-a716-446655440000 |
| Pembuatan sesi | Otomatis pada sendMessage panggilan pertama tanpa sessionId |
| Kedaluwarsa sesi | 48 jam dari pembuatan sesi (kedaluwarsa absolut, bukan berbasis inaktivitas) |
Unggahan file
| Properti | Nilai |
|---|---|
| Maks file per pesan | 3 |
| Batas ukuran gambar | 3,75 MB |
| Batas ukuran dokumen | 4,5 MB |
| Ekstensi yang diizinkan | doc, docx, pdf, png,
jpeg, xlsx, csv,
txt |
| Ember S3 (produksi) | aws-partner-central-marketplace-ephemeral-writeonly-file |
| Unggah jalur | s3://{bucket}/{aws-account-id}/ |
| Persyaratan URI S3 | Harus menyertakan parameter versionId kueri |
Unggah alur kerja
Unggah file Anda ke bucket S3 yang sesuai di bawah awalan ID AWS akun Anda.
Perhatikan URI S3 termasuk yang
versionIddikembalikan oleh unggahan.Sertakan file sebagai blok
documentkonten dalamsendMessagepanggilan Anda.
Contoh format URI S3:
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
Kode eror
| Code | Nama | Deskripsi |
|---|---|---|
-32001 |
AUTHENTICATION_FAILURE |
Sigv4 signature tidak valid atau kredensialnya telah kedaluwarsa |
-31004 |
TOOL_PERMISSION_DENIED |
Identitas IAM tidak memiliki partnercentral: tindakan yang diperlukan untuk operasi ini |
-32002 |
ACCESS_DENIED |
Akses umum ditolak (akun tidak terdaftar, ketidakcocokan wilayah, dll.) |
-32004 |
LIMIT_EXCEEDED |
Batas tarif atau kuota terlampaui. Coba lagi dengan backoff eksponensial. |
-30001 |
RESOURCE_NOT_FOUND |
Sumber daya yang diminta (sesi, peluang, dll.) Tidak ada |
-32600 |
INVALID_REQUEST |
JSON-RPC Permintaan cacat atau parameter tidak valid |
-32603 |
INTERNAL_ERROR |
Server-side kesalahan. Coba lagi permintaannya. |
Batas tarif
Server memberlakukan batas tarif per akun:
| Operasi | Tingkat berkelanjutan | Burst |
|---|---|---|
sendMessage |
2 permintaan per menit | 10 |
| Semua operasi lainnya | 10 permintaan per menit | 20 |
Jika Anda melebihi batas ini, server mengembalikan kode kesalahan -32004 (LIMIT_EXCEEDEDED). Terapkan backoff eksponensial dengan jitter di klien Anda untuk menangani pembatasan laju dengan anggun.
Jenis acara Streaming (SSE)
Ketika stream diatur ke true dalam sendMessage panggilan, server mengembalikan Server-Sent Peristiwa dengan jenis acara ini:
| Jenis Acara | Deskripsi |
|---|---|
stream_start |
Koneksi aliran dibuat |
assistant-response.start |
Agen telah mulai menghasilkan respon |
assistant-response.delta |
Potongan teks tambahan dari respons agen |
assistant-response.completed |
Agen telah selesai menghasilkan respons |
server-tool-use |
Agen menggunakan alat internal (operasi baca) |
server-tool-response |
Hasil pemanggilan alat internal |
tool_approval_request |
Agen meminta persetujuan manusia untuk operasi menulis |
stream_end |
Penutupan koneksi aliran |
done |
Acara terakhir yang menunjukkan aliran SSE selesai |
Langkah selanjutnya
Referensi Alat - Dokumentasi terperinci untuk
sendMessagedangetSessionalat