

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Integrasikan agen Connect AI dengan step-by-step panduan
<a name="integrate-guides-with-ai-agents"></a>

Untuk membantu agen mendapatkan solusi lebih cepat, Anda dapat mengaitkan [step-by-step panduan](step-by-step-guided-experiences.md) dengan konten basis pengetahuan, seperti artikel pengetahuan. Kemudian, ketika agen Connect AI memberikan solusi yang direkomendasikan kepada agen, itu juga memberi mereka opsi untuk memulai step-by-step panduan yang Anda kaitkan dengan konten.

Topik ini menjelaskan cara mengaitkan step-by-step panduan dengan konten basis pengetahuan.

## Langkah 1: Identifikasi sumber daya yang ingin Anda integrasikan
<a name="identify-resources-to-integrate"></a>

Langkah pertama adalah mengumpulkan informasi yang diperlukan untuk menjalankan perintah integrasi di [Langkah 2: Kaitkan step-by-step panduan dengan konten basis pengetahuan](#associate-guide-content): 
+ ID basis pengetahuan yang berisi sumber daya konten yang ingin Anda kaitkan dengan step-by-step panduan.
+ ID sumber daya konten di basis pengetahuan.
+ ARN dari step-by-step panduan yang ingin Anda kaitkan dengan konten.

Bagian berikut menjelaskan cara mendapatkan informasi ini.

### Dapatkan ID basis pengetahuan
<a name="obtain-knowledgebaseid"></a>

Untuk mendapatkan ID basis pengetahuan yang ingin Anda kaitkan dengan step-by-step panduan, Anda dapat memanggil [ListKnowledgeBases](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListKnowledgeBases.html)API atau menjalankan perintah `list-knowledge-bases` CLI.

Berikut ini adalah contoh `list-knowledge-bases` perintah yang mencantumkan semua basis pengetahuan:

```
aws qconnect list-knowledge-bases
```

Identifikasi basis pengetahuan yang berisi sumber daya konten yang ingin Anda kaitkan. Salin dan simpan`knowledgeBaseId`. Anda akan menggunakannya di [Langkah 2](#associate-guide-content).

### Dapatkan Content ID
<a name="identify-knowledgebase-content"></a>

Untuk membuat daftar sumber daya konten di basis pengetahuan, Anda dapat memanggil [ListContents](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContents.html)API atau menjalankan perintah `list-contents` CLI. 

Berikut ini adalah contoh `list-contents` perintah yang mencantumkan sumber daya konten dan ID konten mereka.

```
aws qconnect list-contents \
--knowledge-base-id knowledgeBaseId
```

Identifikasi sumber daya konten mana yang ingin Anda kaitkan dengan step-by-step panduan. Salin dan simpan`contentId`. Anda akan menggunakannya di [Langkah 2](#associate-guide-content).

### Dapatkan step-by-step panduan `flowARN`
<a name="identify-step-by-step-guides-integrate"></a>

Anda perlu mendapatkan step-by-step panduan `flowARN` yang ingin Anda kaitkan dengan konten. Ada dua cara Anda bisa mendapatkan`flowARN`: menggunakan situs web Amazon Connect admin atau CLI. 

------
#### [ Amazon Connect admin website ]

1. Di situs web Amazon Connect admin, pada menu navigasi pilih **Routing**, **Flows**.

1. Pada halaman **Flows**, pilih step-by-step panduan untuk membukanya di flow designer.

1. Di desainer aliran, pilih **About this flow**, lalu pilih **View ARN**.

1. Salin dan simpan`flowARN`. Ini adalah seluruh string, seperti yang ditunjukkan pada gambar berikut.  
![\[Kotak dialog yang menampilkan flowARN lengkap (Nama Sumber Daya Amazon) untuk step-by-step panduan, menunjukkan pengenal unik yang diperlukan untuk integrasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/qic-flow-id.png)

   Anda akan menggunakan `flowARN` di [Langkah 2](#associate-guide-content).

------
#### [ AWS CLI ]

1. Anda dapat memanggil Amazon Connect [ListInstances](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListInstances.html)API atau menjalankan perintah `list-instances` CLI untuk mendapatkan instance `instanceId` yang ingin Anda gunakan.

   Berikut ini adalah contoh `list-instances` perintah:

   ```
   aws connect list-instances
   ```

   Salin dan simpan`instanceId`.

1. Anda dapat memanggil Amazon Connect [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API atau menjalankan perintah `list-contact-flows` CLI untuk menentukan step-by-step panduan yang akan digunakan. 

   Berikut ini adalah contoh `list-contact-flows` perintah yang mencantumkan semua alur dan step-by-step panduan, dan mereka`flowARNs`:

   ```
   aws connect list-contact-flows \
   --instance-id instanceId
   ```

   Identifikasi step-by-step panduan yang ingin Anda kaitkan dengan basis pengetahuan, dan salin dan simpan`flowARN`. Anda akan menggunakan `flowARN` di [Langkah 2](#associate-guide-content). 

------

## Langkah 2: Kaitkan step-by-step panduan dengan konten basis pengetahuan
<a name="associate-guide-content"></a>

### Buat asosiasi konten
<a name="create-content-association"></a>

Untuk menyelesaikan langkah ini Anda membutuhkan`knowledgeBaseId`, `contentId` dan `flowARN` yang Anda peroleh di Langkah 1.

Anda dapat memanggil [CreateContentAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_CreateContentAssociation.html)API atau menjalankan perintah `create-content-association` CLI untuk menautkan sumber daya konten dan step-by-step panduan. 
+ Anda hanya dapat membuat satu asosiasi konten untuk setiap sumber daya konten.
+ Anda dapat mengaitkan step-by-step panduan dengan beberapa sumber daya konten.

Berikut ini adalah contoh `create-content-association` perintah untuk membuat asosiasi konten antara sumber daya konten dan step-by-step panduan:

```
aws qconnect create-content-association \
--knowledge-base-id knowledgeBaseId \
--content-id contentId \
--association-type AMAZON_CONNECT_GUIDE \
--association '{"amazonConnectGuideAssociation":{"flowId":"flowArn"}}'
```

Misalnya, perintah mungkin terlihat seperti contoh berikut ketika nilai ditambahkan:

```
aws qconnect create-content-association \
--knowledge-base-id 00000000-0000-0000-0000-000000000000 \
--content-id 11111111-1111-1111-1111-111111111111 \
--association-type AMAZON_CONNECT_GUIDE \
--association '{"amazonConnectGuideAssociation":{"flowId":"arn:aws:connect:us-west-2:111111111111:instance/22222222-2222-2222-2222-222222222222/contact-flow/00711358-cd68-441d-8301-2e847ca80c82"}}'
```

### Konfirmasikan bahwa asosiasi konten ada
<a name="confirm-content-association"></a>

Anda dapat memanggil [ListContentAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContentAssociations.html)API atau menjalankan perintah `list-content-associations` CLI untuk mencantumkan semua asosiasi konten untuk konten yang ditentukan. 

Berikut ini adalah contoh `list-content-associations` perintah yang mengembalikan daftar asosiasi konten sehingga Anda dapat memverifikasi bahwa asosiasi yang Anda buat ada:

```
aws qconnect list-content-associations \
--knowledge-base-id knowledgebaseId \
--content-id contentId
```

Misalnya, perintah mungkin terlihat seperti contoh berikut ketika nilai ditambahkan:

```
aws qconnect list-content-associations \
--knowledge-base-id 00000000-0000-0000-0000-000000000000 \
--content-id 11111111-1111-1111-1111-111111111111
```

### Tetapkan izin agar agen dapat melihat rekomendasi dan panduan step-by-step
<a name="enable-guide-experience"></a>

Tetapkan izin profil keamanan **Aplikasi Agen** berikut kepada agen sehingga mereka dapat melihat konten basis pengetahuan dan panduan. step-by-step
+ **Connect AI agents - View**: Memungkinkan agen untuk mencari dan melihat konten. Mereka juga dapat menerima rekomendasi otomatis selama panggilan jika analisis Contact Lens percakapan diaktifkan.
+ **Tampilan kustom - Akses**: Memungkinkan agen untuk melihat step-by-step panduan di ruang kerja agen mereka.

Untuk informasi tentang cara menambahkan izin lainnya ke profil keamanan yang ada, lihat[Perbarui profil keamanan di Amazon Connect](update-security-profiles.md).