全部产品
Search
文档中心

Intelligent Media Services:FAQ tentang AI Percakapan Real-time

更新时间:Jul 06, 2025

Halaman ini menjawab beberapa pertanyaan umum terkait AI Percakapan Real-time.

Pertanyaan terkait fitur

Pertanyaan terkait integrasi

Detail

Apakah saya perlu menerapkan agen AI di server asal?

Tidak, Anda tidak perlu menerapkannya di cloud. Agen AI adalah layanan cloud publik yang disediakan oleh Alibaba Cloud. Cukup buat agen di konsol dan akses melalui OpenAPI.

Bagaimana cara agen mengakses model bahasa besar (LLM) yang diterapkan di Alibaba Cloud Model Studio?

AI Percakapan Real-time telah terintegrasi dengan Alibaba Cloud Model Studio. Konfigurasikan parameter yang diperlukan di konsol untuk mengakses LLM yang disediakan oleh Model Studio. Untuk informasi lebih lanjut, lihat LLM.

Bagaimana cara menangani kesalahan yang terjadi saat memulai panggilan?

Kesalahan 1: Tidak dapat menyelesaikan placeholder 'biz.live_mic.gslb' dalam nilai "${biz.live_mic.gslb}"

  • Penyebab: Konfigurasi hilang atau dihapus di file application.yaml sisi server.

  • Solusi: Variabel yang diinjeksikan melalui anotasi @value harus ada di file tersebut. Anda bisa menetapkan placeholder ke nilai default atau sebagai string kosong "" jika berlaku.

Kesalahan 2: Pengguna tidak berwenang untuk mengoperasikan sumber daya tertentu

  • Solusi: Saat menerapkan server aplikasi, pastikan pasangan AccessKey yang dikonfigurasi benar dan berikan izin AliyunICEFullAccess kepada pengguna RAM. Untuk informasi lebih lanjut, lihat Terapkan melalui kode sumber.

Kesalahan 3: generateAIAgentCall Tea error. e:code: 404, Access key yang ditentukan tidak ditemukan

  • Solusi: Periksa apakah ID AccessKey dan AccessKey Secret dikonfigurasi dengan benar di file application.yaml sisi server. Kemudian, berikan izin AliyunICEFullAccess kepada pengguna RAM. Untuk informasi lebih lanjut, lihat Terapkan melalui kode sumber.

Kesalahan 4: generateAIAgentCall Tea error. e:code: 400, agentId "123456" yang ditentukan tidak ditemukan. request id: xxxxxxx

  • Solusi: Periksa apakah ID agen dan wilayah dikonfigurasi dengan benar.image

Kesalahan 5: Token dikembalikan, tetapi klien masih tidak dapat terhubung.

  • Solusi: Gunakan Alat verifikasi token RTC untuk memeriksa akurasi pembuatan token. Parameter relevan ada di permintaan atau nilai balasan server. Tetapkan nonce sebagai null dan periksa apakah token yang dihasilkan benar.

Klien melaporkan kesalahan "AgentNotFound" saat memulai percakapan pesan

Periksa apakah ID agen dan wilayah dikonfigurasi dengan benar di kode klien.

image

Android
String mAgentId = "XXX";          // ID dari agen AI yang dibuat di konsol untuk percakapan pesan.
String mRegion = "cn-shanghai";   // Wilayah tempat agen AI diterapkan di konsol.
ARTCAIChatAgentInfo agentInfo = new ARTCAIChatEngine.ARTCAIChatAgentInfo(mAgentId, mRegion)

iOS

// ID dari agen AI yang dibuat di konsol untuk percakapan pesan.
let agentInfo = ARTCAIChatAgentInfo(agentId: "xxxx")
// Wilayah tempat agen AI diterapkan di konsol.
agentInfo.region = "cn-shanghai"

Klien melaporkan kesalahan "UnsupportedWorkflowType" saat memulai percakapan pesan

Pesan Kesalahan: workflowType \"VoiceChat\" yang ditentukan tidak didukung oleh antarmuka ini. Silakan gunakan workflowType yang kompatibel: [\"MessageChat\"]

Solusi: Periksa apakah agen terkait dengan alur kerja pesan.

image

image

Bagaimana cara menyesuaikan laju sampel audio klien?

AI Percakapan Real-time mendukung pengaturan berikut untuk penangkapan audio pada klien:

  • Laju sampel: 48 kHz, saluran mono

  • Laju sampel: 16 kHz, saluran mono

SDK AICallKit menggunakan laju sampel 48 kHz secara default. Untuk beralih ke 16 kHz, lihat contoh kode berikut:

Catatan

SDK web saat ini hanya mendukung 48 kHz.

iOS
self.engine.audioConfig = ARTCAICallAudioConfig(audioProfile: .BasicQualityMode, audioScenario: .MusicMode)

// Panggil API lainnya
...  

// Mulai panggilan
self.engine.call(...)
Android
ARTCAICallEngine.ARTCAICallConfig artcaiCallConfig = new ARTCAICallEngine.ARTCAICallConfig();
artcaiCallConfig.audioConfig.audioProfile = ARTCAICallAudioBasicQualityMode;
engine.init(artcaiCallConfig);

Bagaimana cara menyesuaikan laju sampel audio agen?

AI Percakapan Real-time mendukung pengaturan berikut untuk audio agen:

  • Laju sampel: 48 kHz, saluran mono/stereo

  • Laju sampel: 16 kHz, saluran mono

Pengaturan default adalah 48 kHz saluran mono. Untuk mengubah laju sampel, konfigurasikan pengaturan saat memanggil API untuk memulai percakapan. Metode konfigurasi berbeda-beda tergantung pada API.

Metode 1: Panggil GenerateAIAgentCall di sisi server

Tambahkan parameter AIAgentConfig dan konfigurasikan bidang ExperimentalConfig di dalamnya.

// AudioQualityMode: Integer    
// Laju sampel untuk output RTC.
// 0: 48 kHz mono 
// 1: 48 kHz stereo
// 2: 16 kHz mono
// Nilai ExperimentalConfig harus berupa string JSON
{
    "ExperimentalConfig":"{\"AudioQualityMode\":2}"
}

Metode 2: Panggil StartAIAgentInstance di sisi server

Tambahkan parameter AIAgentConfig dan konfigurasikan bidang ExperimentalConfig di dalamnya.

// AudioQualityMode: Integer    
// Laju sampel untuk output RTC.
// 0: 48 kHz mono 
// 1: 48 kHz stereo
// 2: 16 kHz mono
// Nilai ExperimentalConfig harus berupa string JSON
{
    "ExperimentalConfig":"{\"AudioQualityMode\":2}"
}

Metode 3: Mulai panggilan di klien

Jika Anda menggunakan callConfig sebagai parameter dan antarmuka call(xxx) untuk membuat dan memulai panggilan, metode berikut berlaku:

Catatan

Untuk menggunakan metode ini, SDK AICallKit harus versi V2.5.0 atau lebih baru.

iOS
let callConfig = ...   // Buat dan inisialisasi ARTCAICallConfig.

let agentConfig = ARTCAICallAgentConfig()         // Buat objek ARTCAICallAgentConfig.
agentConfig.experimentalConfig = [
    "AudioQualityMode": 2
]
...                                                  // Atur parameter sesuai kebutuhan bisnis
callConfig.agentConfig = agentConfig
self.engine.call(config: callConfig)                 // Mulai panggilan
Android
ARTCAICallEngine.ARTCAICallConfig artcaiCallConfig = new ARTCAICallEngine.ARTCAICallConfig();
artcaiCallConfig.agentConfig.experimentalConfig = new JSONObject();
try {
    artcaiCallConfig.agentConfig.experimentalConfig.put("AudioQualityMode", 2);
} catch (JSONException e) {
    e.printStackTrace();
}
engine.init(artcaiCallConfig);