Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Blok aliran di Connect Customer: Alat Eksternal
Topik ini mendefinisikan blok aliran untuk memanggil alat dari aplikasi eksternal langsung dari aliran.
**catatan**
**Blok Alat ** Eksternal hanya tersedia di [ inst ](https://docs.aws.amazon.com/connect/latest/adminguide/enable-nextgeneration-amazonconnect.html) ans Pelanggan Amazon Connect, dan hanya di Wilayah tertentu. Untuk daftar Wilayah, lihat[Alat Eksternal](regions.md#externaltool_region).
## Deskripsi
+ Memanggil alat dari aplikasi eksternal, seperti Salesforce atau ServiceNow, yang terintegrasi dengan instance Connect Customer Anda melalui gateway Amazon Bedrock. AgentCore Alur Anda dapat mengirim data ke dan membaca data dari aplikasi pihak ketiga tanpa mempertahankan fungsi Lambda khusus.
+ Menjalankan alat secara sinkron, di mana aliran berhenti sampai alat kembali, atau secara asinkron, di mana aliran berlanjut. Untuk pemanggilan asinkron, tambahkan ** blok Alat ** Eksternal kedua yang disetel ke ** Load tool result ** untuk mengambil hasilnya.
+ Menyimpan hasilnya di `$.ExternalTool` namespace.
## Saluran yang didukung
Tabel berikut mencantumkan bagaimana blok ini merutekan kontak yang menggunakan saluran yang ditentukan.
| Saluran | Didukung? |
| --- | --- |
| Suara | Ya |
| Obrolan | Ya |
| Tugas | Ya |
| E-Mail | Ya |
## Jenis aliran
Anda dapat menggunakan blok ini dalam jenis [ aliran berikut](create-contact-flow.md#contact-flow-types):
+ Semua aliran
## Prasyarat dan dependensi
Sebelum Anda dapat menggunakan blok ini, Anda harus [ mengintegrasikan aplikasi eksternal dengan instance Connect Customer Anda sebagai server ](https://docs.aws.amazon.com/connect/latest/adminguide/3p-apps-mcp-server.html#3p-apps-mcp-server-how-to-integrate) MCP. Untuk mengatur integrasi:
1. Buka konsol Connect Customer.
1. Tambahkan integrasi baru dan pilih server ** MCP ** sebagai jenis integrasi.
1. Pilih AgentCore gateway Bedrock untuk terhubung dengan instance Anda. Jika tidak ada gateway, [ buat satu di Bedrock terlebih AgentCore ](https://docs.aws.amazon.com/connect/latest/adminguide/3p-apps-mcp-server.html#3p-apps-mcp-server-how-to-integrate) dahulu.
1. Dalam konfigurasi identitas masuk gateway, tambahkan ID gateway ke ** bidang Audiens ** yang diizinkan. ID gateway diperlukan agar pemanggilan alat berhasil.
1. Kaitkan instance Connect Customer Anda dengan integrasi dengan memilih instance yang dikonfigurasi dengan URL Discovery gateway.
Setelah integrasi selesai, aplikasi muncul di ** blok Alat ** Eksternal dan dapat dipilih berdasarkan nama.
## Sifat-sifat
Blok mendukung tindakan berikut. Pilih tindakan menggunakan ** Pilih tindakan**. Defaultnya adalah ** Invoke tool**.
### Memanggil alat
Gambar berikut menunjukkan konfigurasi tindakan alat Invoke dalam properti blok External Tool.
+ **Nama aplikasi ** (wajib): Aplikasi eksternal untuk dipanggil. Anda dapat mengatur ini secara manual atau dinamis. Hanya aplikasi yang terkait dengan instance Anda yang muncul.
+ **Nama alat ** (wajib): Alat untuk dipanggil dalam aplikasi. Anda dapat mengatur ini secara manual atau dinamis; daftar manual diperbarui berdasarkan aplikasi. Bidang input dihasilkan dari skema alat, dan input alat dapat disediakan secara manual, dinamis, atau sebagai JSON mentah.
+ **Mode eksekusi**:
+ **Sinkron**: Kontak dialihkan ke blok berikutnya hanya setelah pemanggilan Alat Eksternal selesai.
+ **Asinkron**: Kontak dialihkan ke blok berikutnya tanpa menunggu pemanggilan Alat Eksternal selesai. Anda dapat mengonfigurasi [Tunggu](wait.md) blok untuk menunggu Alat Eksternal yang dipanggil dalam mode eksekusi asinkron.
+ **Batas waktu**: Berapa lama menunggu sebelum waktu pemanggilan Alat Eksternal habis. Maksimum adalah 8 detik untuk mode Sin ** kron dan 60 detik untuk ** mode Asin ** kron. **
+ Jika pemanggilan Alat Eksternal dibatasi, atau kegagalan layanan umum (kesalahan 500) terjadi, permintaan dicoba lagi.
+ Ketika pemanggilan Alat Eksternal mengembalikan kesalahan, Connect Customer mencoba lagi hingga tiga kali, hingga batas waktu yang ditentukan. Pada titik itu, kontak diarahkan ke ** cabang Kes ** alahan.
+ Cabang: ** Sukses ** dan ** Kesalahan**.
### Memuat hasil alat
Gambar berikut menunjukkan konfigurasi tindakan hasil Load tool di properti blok External Tool.
+ **ID pemanggilan alat eksternal**: ID pemanggilan Alat Eksternal yang dijalankan dalam mode ** A ** sinkron. `$.ExternalTool.InvocationId`berisi ID pemanggilan dari Alat Eksternal yang dijalankan secara asinkron terbaru.
+ Untuk ** tindakan hasil ** Load tool, atur ** Namespace ** = `ExternalTool` dan ** Key ** = ** Invocation ID. **
+ Cabang: ** Suk ** ses, ** Dalam proses**, dan Kes ** alahan**.
## Namespace
**Blok Alat ** Eksternal menulis hasil ke jalur namespace berikut:
+ `$.ExternalTool.InvocationId`— ID pemanggilan saat ini.
+ `$.ExternalTool.ResultData`— hasil alat (hingga 32 KB).
Setiap pemanggilan baru mengganti hasil sebelumnya`$.ExternalTool`. Untuk menyimpan hasil, salin ke atribut kontak (`$.Attributes.*`) atau atribut flow (`$.FlowAttribute.*`) sebelum memanggil alat lain.
## Kiat konfigurasi
+ **Nama aplikasi ** dan nama ** Alat ** dapat diatur secara dinamis maupun manual.
+ Hasil sinkron dibatasi pada 32 KB. Tanggapan yang lebih besar mengambil ** cabang Kes ** alahan.
## Contoh
Kampanye outbound menyesuaikan pesannya dengan tingkat pengeluaran setiap pelanggan. Setelah mengintegrasikan Amazon Bedrock AgentCore dan integrasi pihak ketiga yang memperlihatkan tingkat pengeluaran setiap akun, aliran menggunakan ** blok Alat ** Eksternal untuk membaca tingkat dari aplikasi pihak ketiga, dan kemudian bercabang ke pesan yang cocok.
## Dikonfigurasi
Setelah Anda mengkonfigurasi blok, itu menunjukkan ** cabang Suk ** ses ** dan ** Kesalahan. Untuk ** tindakan hasil ** Load tool, ini juga menunjukkan ** cabang ** Sedang berjalan.
