Buat agen AI di Amazon Connect - Amazon Connect
Cara membuat agen AIKaitkan agen AI dengan aliranContoh perintah CLI

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

Buat agen AI di Amazon Connect

Agen AI adalah sumber daya Amazon Q in Connect yang mengonfigurasi dan menyesuaikan pengalaman end-to-end Amazon Q in Connect. Misalnya, agen AI memberi tahu Asisten AI cara menangani pencarian manual: apa yang diminta AI dan pagar pembatas AI yang harus digunakan, dan lokal mana yang digunakan untuk respons tersebut.

Amazon Q in Connect menyediakan agen AI sistem untuk setiap kasus penggunaan: rekomendasi jawaban, pencarian manual, layanan mandiri. Agen AI sistem diisi dengan petunjuk AI default untuk setiap kasus penggunaan.

Misalnya, gambar berikut menunjukkan pengalaman Amazon Q in Connect yang dikonfigurasi untuk menggunakan agen AI yang disesuaikan untuk rekomendasi jawaban dan pencarian manual, tetapi menggunakan agen AI default sistem untuk kasus penggunaan layanan mandiri.

Agen AI default yang ditentukan untuk pengalaman Amazon Q in Connect.

Inilah cara kerja agen AI yang disesuaikan:

  • Anda dapat mengganti satu atau lebih agen AI sistem dengan agen AI khusus Anda.

  • Agen AI khusus Anda kemudian menjadi default untuk kasus penggunaan yang ditentukan.

  • Saat membuat agen AI yang disesuaikan, Anda dapat menentukan satu atau lebih permintaan AI khusus Anda sendiri, dan satu pagar pembatas.

  • Dua kasus penggunaan - Rekomendasi jawaban dan Layanan mandiri - mendukung dua jenis permintaan AI. Jika Anda memilih untuk membuat prompt AI baru untuk satu jenis tetapi tidak yang lain, maka agen AI terus menggunakan default sistem untuk prompt AI yang tidak Anda timpa. Dengan cara ini Anda dapat memilih untuk mengganti hanya bagian tertentu dari Amazon Q default dalam pengalaman Connect.

Cara membuat agen AI

  1. Masuk ke situs web Amazon Connect admin di https://instance name.my.connect.aws/. Gunakan akun admin, atau akun dengan Amazon Q - agen AI - Buat izin di profil keamanannya.

  2. Pada menu navigasi, pilih Amazon Q, agen AI.

  3. Pada halaman Agen AI, pilih Buat Agen AI.

  4. Pada kotak dialog Buat Agen AI, untuk jenis Agen AI, gunakan kotak tarik-turun untuk memilih salah satu jenis berikut:

    • Rekomendasi jawaban: Agen AI ini yang mendorong rekomendasi berbasis niat otomatis yang didorong ke agen ketika mereka terlibat dalam kontak dengan pelanggan. Ini menggunakan jenis prompt AI berikut:

      • Intent labelling generation AI prompt untuk menghasilkan maksud bagi agen layanan pelanggan untuk memilih sebagai langkah pertama.

      • Perumusan ulang kueri AI prompt setelah maksud dipilih. Ini menggunakan prompt ini untuk merumuskan kueri yang sesuai yang kemudian digunakan untuk mengambil kutipan basis pengetahuan yang relevan.

      • Pembuatan jawaban, kueri dan kutipan yang dihasilkan dimasukkan ke dalam prompt ini menggunakan $.contentExcerpt variabel $.query dan masing-masing.

    • Pencarian manual: Agen AI ini yang menghasilkan solusi dalam menanggapi pencarian sesuai permintaan yang diprakarsai oleh agen. Ini menggunakan jenis prompt AI generasi Jawaban.

    • Layanan mandiri: Agen AI ini yang menghasilkan solusi untuk swalayan. Ini menggunakan generasi jawaban swalayan dan jenis pra-pemrosesan layanan mandiri dari prompt AI.

    penting

    Rekomendasi jawaban dan Layanan mandiri mendukung dua jenis permintaan AI. Jika Anda memilih untuk membuat prompt AI baru untuk satu jenis tetapi tidak yang lain, maka agen AI terus menggunakan default sistem untuk yang tidak Anda ganti. Dengan cara ini Anda dapat memilih untuk mengganti hanya bagian tertentu dari Amazon Q default dalam pengalaman Connect.

  5. Pada halaman Pembuat agen, Anda dapat menentukan lokal yang akan digunakan untuk respons. Untuk daftar lokal yang didukung, lihatKode lokal yang didukung.

    Anda dapat memilih lokal untuk rekomendasi Jawaban dan jenis pencarian manual agen AI. Anda tidak dapat memilih lokal untuk layanan mandiri; hanya bahasa Inggris yang didukung.

  6. Pilih prompt AI yang ingin Anda ganti default. Perhatikan bahwa Anda memilih versi prompt AI yang dipublikasikan, bukan hanya prompt AI yang disimpan. Jika diinginkan, tambahkan pagar pembatas AI ke agen AI Anda.

    catatan

    Jika Anda tidak secara khusus mengganti prompt AI default dengan yang disesuaikan, default akan terus digunakan.

  7. Pilih Simpan. Anda dapat terus memperbarui dan menyimpan agen AI sampai Anda puas itu selesai.

  8. Untuk membuat versi agen AI baru tersedia sebagai default potensial, pilih Publish.

Kaitkan agen AI dengan aliran

Untuk menggunakan fungsi out-of-the-box Amazon Q default di Connect, Anda menambahkan Amazon Q di Connect blok ke alur. Blok ini mengaitkan Asisten dan pemetaan default agen AI.

Untuk mengganti perilaku default ini, buat Lambda, lalu gunakan blok Fungsi AWS Lambda tersebut untuk menambahkannya ke alur Anda.

Contoh perintah CLI untuk membuat dan mengelola agen AI

Bagian ini menyediakan beberapa contoh perintah AWS CLI untuk membantu Anda membuat dan mengelola agen AI.

Buat agen AI yang menggunakan setiap versi prompt AI yang disesuaikan

Amazon Q in Connect menggunakan versi prompt AI untuk fungsinya jika ditentukan untuk agen AI. Jika tidak, default ke perilaku sistem.

Gunakan contoh perintah AWS CLI berikut untuk membuat agen AI yang menggunakan setiap versi prompt AI yang disesuaikan untuk rekomendasi jawaban.


aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --name example_answer_recommendation_ai_agent \
  --visibility-status PUBLISHED \
  --type ANSWER_RECOMMENDATION \
  --configuration '{
    "answerRecommendationAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>",
      "intentLabelingGenerationAIPromptId": "<INTENT_LABELING_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>",
      "queryReformulationAIPromptId": "<QUERY_REFORMULATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>"
    }
  }'

Konfigurasikan sebagian agen AI

Anda dapat mengonfigurasi sebagian agen AI dengan menentukannya harus menggunakan beberapa versi prompt AI yang disesuaikan. Untuk apa yang tidak ditentukan, ia menggunakan petunjuk AI default.

Gunakan contoh perintah AWS CLI berikut untuk membuat agen AI rekomendasi jawaban yang menggunakan versi prompt AI yang disesuaikan dan memungkinkan default sistem menangani sisanya. 


aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --name example_answer_recommendation_ai_agent \
  --visibility-status PUBLISHED \
  --type ANSWER_RECOMMENDATION \
  --configuration '{
    "answerRecommendationAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>"
    }
  }'

Konfigurasikan versi prompt AI untuk pencarian manual

Jenis agen AI pencarian manual hanya memiliki satu versi prompt AI sehingga tidak ada konfigurasi sebagian yang memungkinkan.

Gunakan contoh perintah AWS CLI berikut untuk menentukan versi prompt AI untuk pencarian manual.


aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --name example_manual_search_ai_agent \
  --visibility-status PUBLISHED \
  --type MANUAL_SEARCH \
  --configuration '{
    "manualSearchAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>"
    }
  }'

Gunakan agen AI untuk mengganti konfigurasi basis pengetahuan

Anda dapat menggunakan agen AI untuk mengonfigurasi asosiasi asisten Amazon Q di Connect mana yang harus digunakan dan bagaimana seharusnya menggunakannya. Asosiasi yang didukung untuk kustomisasi adalah basis pengetahuan yang mendukung:

  • Menentukan basis pengetahuan yang akan digunakan dengan menggunakan nyaassociationId.

  • Menentukan filter konten untuk pencarian yang dilakukan di atas basis pengetahuan terkait dengan menggunakan file. contentTagFilter

  • Menentukan jumlah hasil yang akan digunakan dari pencarian terhadap basis pengetahuan dengan menggunakanmaxResults.

  • Menentukan overrideKnowledgeBaseSearchType yang dapat digunakan untuk mengontrol jenis pencarian yang dilakukan terhadap basis pengetahuan. Pilihannya adalah SEMANTIC yang menggunakan embeddings vektor atau HYBRID yang menggunakan embeddings vektor dan teks mentah.

Misalnya, gunakan perintah AWS CLI berikut untuk membuat agen AI dengan konfigurasi basis pengetahuan yang disesuaikan.

aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --name example_manual_search_ai_agent \
  --visibility-status PUBLISHED \
  --type MANUAL_SEARCH \
  --configuration '{
    "manualSearchAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>",
      "associationConfigurations": [
        {
          "associationType": "KNOWLEDGE_BASE",
          "associationId": "<ASSOCIATION_ID>",
          "associationConfigurationData": {
            "knowledgeBaseAssociationConfigurationData": {
              "overrideKnowledgeBaseSearchType": "SEMANTIC",
              "maxResults": 5,
              "contentTagFilter": {
                "tagCondition": { "key": "<KEY>", "value": "<VALUE>" }
              }
            }
          }
        }
      ]
    }
  }'

Buat versi agen AI

Sama seperti permintaan AI, setelah agen AI dibuat, Anda dapat membuat versi yang merupakan instance agen AI yang tidak dapat diubah yang dapat digunakan oleh Amazon Q di Connect saat runtime.

Gunakan contoh perintah AWS CLI berikut untuk membuat versi agen AI.

aws qconnect create-ai-agent-version \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --ai-agent-id <YOUR_AI_AGENT_ID>

Setelah versi dibuat, Id agen AI dapat dikualifikasikan dengan menggunakan format berikut: 

 <AI_AGENT_ID>:<VERSION_NUMBER>

Tetapkan agen AI untuk digunakan dengan Amazon Q di Connect

Setelah Anda membuat versi prompt AI dan versi agen AI untuk kasus penggunaan Anda, Anda dapat mengaturnya untuk digunakan dengan Amazon Q di Connect.

Setel versi agen AI di Amazon Q di Connect Assistant

Anda dapat menetapkan versi agen AI sebagai default yang akan digunakan di Amazon Q di Connect Assistant.

Gunakan contoh perintah AWS CLI berikut untuk mengatur versi agen AI sebagai default. Setelah versi agen AI disetel, itu akan digunakan saat Amazon Connect kontak berikutnya dan Amazon Q terkait di sesi Connect dibuat. 

aws qconnect update-assistant-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --ai-agent-type MANUAL_SEARCH \
  --configuration '{
    "aiAgentId": "<MANUAL_SEARCH_AI_AGENT_ID_WITH_VERSION_QUALIFIER>"
  }'

Setel versi agen AI di Amazon Q di sesi Connect

Anda juga dapat mengatur versi agen AI untuk setiap Amazon Q yang berbeda di sesi Connect saat membuat atau memperbarui sesi.

Gunakan contoh perintah AWS CLI berikut untuk mengatur versi agen AI untuk setiap sesi yang berbeda.

aws qconnect update-session \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --session-id <YOUR_Q_IN_CONNECT_SESSION_ID> \
  --ai-agent-configuration '{
    "ANSWER_RECOMMENDATION": { "aiAgentId": "<ANSWER_RECOMMENDATION_AI_AGENT_ID_WITH_VERSION_QUALIFIER>" },
    "MANUAL_SEARCH": { "aiAgentId": "<MANUAL_SEARCH_AI_AGENT_ID_WITH_VERSION_QUALIFIER>" }
  }'

Versi agen AI yang disetel pada sesi lebih diutamakan daripada yang ditetapkan pada tingkat Amazon Q di Connect Assistant, yang pada gilirannya lebih diutamakan daripada default sistem. Urutan prioritas ini dapat digunakan untuk mengatur versi agen AI pada sesi yang dibuat untuk segmen bisnis pusat kontak tertentu. Misalnya, dengan menggunakan flow untuk mengotomatiskan pengaturan versi agen AI untuk antrian Amazon Connect tertentu menggunakan blok aliran Lambda.

Kembalikan ke default sistem

Anda dapat kembali ke versi agen AI default jika menghapus kustomisasi diperlukan karena alasan apa pun.

Gunakan contoh perintah AWS CLI berikut untuk membuat daftar versi agen AI dan kembali ke yang asli.

aws qconnect list-ai-agents \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --origin SYSTEM
catatan

--origin SYSTEMditentukan sebagai argumen untuk mengambil versi agen AI sistem. Tanpa argumen ini, versi agen AI khusus Anda akan terdaftar. Setelah versi agen AI dicantumkan, gunakan untuk mengatur ulang ke pengalaman Amazon Q in Connect default di level Amazon Q di Connect Assistant atau sesi; gunakan perintah CLI yang dijelaskan di. Tetapkan agen AI untuk digunakan dengan Amazon Q di Connect