Referensi Pusat Partner AWS API direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Refer Pusat Partner AWS ensi 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 Partner.
Titik akhir
| Properti | Nilai |
|---|---|
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp |
| Region | us-east-1(Virginia Utara) hanya |
| Protokol | JSON-RPC 2.0 melalui HTTPS |
| Streaming | Server-Sent Acara (SSE) |
| Autentikasi | AWS Tanda Tangan Versi 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
Sebagai AWS identitas yang diautentikasi, Anda memiliki akses protokol ke server MCP secara default. Anda tidak memerlukan IAM Allow eksplisit untuk akses protokol.
Untuk otentikasi OAuth, izin masuk berikut diperlukan:
| Tindakan | Deskripsi |
|---|---|
signin:AuthorizeOAuth2Access |
Mengotorisasi aliran OAuth berbasis browser |
signin:CreateOAuth2Token |
Mengeluarkan dan menyegarkan token akses OAuth |
Untuk membatasi akses MCP, terapkan Tolak eksplisit. partnercentral:InvokeMcp
Manajemen peluang
| Tindakan | Deskripsi |
|---|---|
partnercentral:List* |
Daftar peluang, solusi, dan sumber daya Mitra Central lainnya |
partnercentral:Get* |
Ambil detail untuk peluang individu dan sumber daya lainnya |
partnercentral:CreateOpportunity |
Ciptakan peluang |
partnercentral:UpdateOpportunity |
Ubah bidang peluang (tahap, tanggal penutupan, pendapatan, dll.) |
partnercentral:SubmitOpportunity |
Kirimkan kesempatan untuk dit AWS injau |
partnercentral:AssignOpportunity |
Menetapkan kesempatan kepada perwakilan mitra |
partnercentral:AssociateOpportunity |
Tautkan peluang ke sumber daya lain (solusi, dll.) |
partnercentral:DisassociateOpportunity |
Menghapus tautan antara peluang dan sumber daya lain |
partnercentral:StartEngagementFromOpportunityTask |
Kirimkan peluang untuk memulai keterlibatan dari peluang |
Program pendanaan
| Tindakan | Deskripsi |
|---|---|
partnercentral:ListBenefitAllocations |
Daftar alokasi manfaat yang tersedia untuk akun Anda |
partnercentral:ListBenefitApplications |
Daftar aplikasi manfaat yang diajukan |
partnercentral:CreateBenefitApplication |
Buat aplikasi manfaat baru (MAP, POC, WMP) |
partnercentral:GetBenefitApplication |
Ambil rincian aplikasi manfaat tertentu |
partnercentral:UpdateBenefitApplication |
Perbarui aplikasi manfaat yang tertunda |
partnercentral:AssociateBenefitApplicationResource |
Menautkan sumber daya ke aplikasi manfaat |
partnercentral:DisassociateBenefitApplicationResource |
Menghapus tautan sumber daya dari aplikasi manfaat |
Akses pasar
| Tindakan | Deskripsi |
|---|---|
aws-marketplace:DescribeEntity |
Mengambil rincian entitas pasar |
aws-marketplace:SearchAgreements |
Cari perjanjian pasar |
aws-marketplace:ListEntities |
Daftar entitas pasar |
Agen Onboarding
Manajemen akun mitra (partnercentral):
| Tindakan | Deskripsi |
|---|---|
partnercentral:ListPartners |
Daftar pendaftaran mitra untuk akun |
partnercentral:GetPartner |
Ambil pendaftaran 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 async 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 |
Mengirim 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 |
Daftar koneksi akun aktif (misalnya, tautan anak perusahaan) |
partnercentral:GetConnectionInvitations |
Daftar undangan koneksi tertunda terkirim dan diterima |
partnercentral:CreateConnectionInvitation |
Mengirim 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 |
Mendapatkan atau perbarui preferensi berbagi antar akun yang terhubung |
Pengaturan penjual pasar (aws-marketplace):
| Tindakan | Deskripsi |
|---|---|
aws-marketplace:ListEntities |
Daftar entitas Marketplace (misalnya, entitas penjual) |
aws-marketplace:DescribeEntity |
Mengambil detail lengkap dari entitas Marketplace |
aws-marketplace:DescribeChangeSet |
Periksa status kumpulan perubahan yang dikirimkan |
aws-marketplace:StartChangeSet |
Kirim set perubahan Marketplace (misalnya, 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 ada dampak 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 |
| Kadaluwarsa sesi | 48 jam sejak pembuatan sesi (kedaluwarsa mutlak, bukan berbasis ketidakaktifan) |
Unggahan file
| Properti | Nilai |
|---|---|
| Maksimal file per pesan | 3 |
| Batas ukuran gambar | 3,75 MB |
| Batas ukuran dokumen | 4,5MB |
| Ekstensi yang diizinkan | doc, docx, pdf, png,
jpeg, xlsx, csv,
txt |
| Bucket S3 (produksi) | aws-partner-pusat-marketplace-berkas-berkas-berkas-berkas |
| Jalur unggah | s3://{bucket}/{aws-account-id}/ |
| Persyaratan URI S3 | Harus menyertakan versionId parameter kueri |
Upload 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 |
Tanda tangan SIGv4 tidak valid atau kredensi 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 mundur eksponensial. |
-30001 |
RESOURCE_NOT_FOUND |
Sumber daya yang diminta (sesi, peluang, dll.) Tidak ada |
-32600 |
INVALID_REQUEST |
Per JSON-RPC mintaan yang salah bentuk 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_EXCEEDED). Terapkan backoff eksponensial dengan jitter di klien Anda untuk menangani pembatasan laju dengan anggun.
Jenis acara Streaming (SSE)
Ketika stream disetel ke true dalam sendMessage panggilan, server mengembalikan A Server-Sent cara dengan jenis peristiwa ini:
| Jenis Acara | Deskripsi |
|---|---|
stream_start |
Koneksi aliran dibuat |
assistant-response.start |
Agen telah mulai menghasilkan respons |
assistant-response.delta |
Potongan teks tambahan dari respons agen |
assistant-response.completed |
Agen telah selesai menghasilkan respons |
server-tool-use |
Agen memanggil alat internal (baca operasi) |
server-tool-response |
Hasil dari pemanggilan alat internal |
tool_approval_request |
Agen meminta persetujuan manusia untuk operasi penulisan |
stream_end |
Penutupan koneksi streaming |
done |
Peristiwa terakhir yang menunjukkan aliran SSE selesai |
Langkah selanjutnya
Referensi Alat - Dokumentasi terperinci untuk
sendMessagedangetSessionalat
