

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 panduan langkah demi langkah
<a name="integrate-guides-with-ai-agents"></a>

Untuk membantu agen mendapatkan solusi lebih cepat, Anda dapat mengaitkan [panduan langkah demi langkah](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 panduan langkah demi langkah yang Anda kaitkan dengan konten.

Topik ini menjelaskan cara mengaitkan panduan langkah demi langkah 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 panduan langkah demi langkah dengan konten basis pengetahuan](#associate-guide-content): 
+ ID basis pengetahuan yang berisi sumber daya konten yang ingin Anda kaitkan dengan panduan langkah demi langkah.
+ ID sumber daya konten di basis pengetahuan.
+ ARN dari panduan langkah demi langkah 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 panduan langkah demi langkah, 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 panduan langkah demi langkah. Salin dan simpan`contentId`. Anda akan menggunakannya di [Langkah 2](#associate-guide-content).

### Dapatkan `FlowARN dari panduan` langkah demi langkah
<a name="identify-step-by-step-guides-integrate"></a>

Anda perlu mendapatkan panduan langkah demi langkah yang ingin Anda kaitkan dengan konten. `flowARN` Ada dua cara Anda bisa mendapatkan`flowARN`: menggunakan situs web Connect Customer admin atau CLI. 

------
#### [ Connect Customer admin website ]

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

1. Pada halaman **Flows**, pilih panduan langkah demi langkah 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 panduan langkah demi langkah.](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 Connect Customer [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 Connect Customer [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API atau menjalankan perintah `list-contact-flows` CLI untuk menentukan panduan langkah demi langkah yang akan digunakan. 

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

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

   Identifikasi panduan langkah demi langkah 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 panduan langkah demi langkah 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 panduan langkah demi langkah. 
+ Anda hanya dapat membuat satu asosiasi konten untuk setiap sumber daya konten.
+ Anda dapat mengaitkan panduan langkah demi langkah dengan beberapa sumber daya konten.

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

```
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 langkah demi langkah
<a name="enable-guide-experience"></a>

Tetapkan izin profil keamanan **Aplikasi Agen** berikut kepada agen sehingga mereka dapat melihat konten basis pengetahuan dan panduan langkah demi langkah.
+ **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 panduan langkah demi langkah di ruang kerja agen mereka.

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