FAQ ini menjawab pertanyaan umum dan menyediakan solusi terkait AI Percakapan Real-time.
FAQ
Fitur
Integrasi
Fitur
Penerapan agent di server origin
Tidak. Agent merupakan layanan cloud publik dari Alibaba Cloud, sehingga tidak perlu diterapkan di server origin Anda. Anda dapat membuat dan menggunakan agent dengan mengonfigurasinya di Konsol dan memanggil OpenAPI.
Menghubungkan agent ke LLM di Model Studio
Agent telah terintegrasi dengan Alibaba Cloud Model Studio secara desain. Anda cukup menentukan parameter yang diperlukan di Konsol untuk memanggil model bahasa besar di Alibaba Cloud Model Studio. Untuk informasi selengkapnya, lihat Model Bahasa Besar (LLM).
Integrasi
Terjadi error saat memulai panggilan
Error 1: "Could not resolve placeholder..."
Error ini terjadi ketika konfigurasi hilang atau dihapus dari file application.yaml di sisi server. File konfigurasi harus berisi variabel apa pun yang disuntikkan menggunakan anotasi @value. Anda dapat mempertahankan konfigurasi tersebut di file application.yml dengan nilai placeholder seperti "xxxxxx" atau mengaturnya sebagai string kosong "".
Error 2: "User not authorized to operate on the specified resource"
Saat menerapkan server aplikasi, pastikan bahwa AccessKey yang dikonfigurasi benar dan berikan izin AliyunICEFullAccess kepada Pengguna RAM. Untuk informasi selengkapnya, lihat Terapkan dari kode sumber.
Error 3: "generateAIAgentCall Tea error. e:code: 404, Specified access key is not found."
Pastikan bahwa AccessKey dan AccessSecret dikonfigurasi dengan benar di file application.yaml sisi server. Anda juga harus memberikan izin AliyunICEFullAccess kepada RAM user. Untuk informasi selengkapnya, lihat Terapkan dari kode sumber.
Error 4: "generateAIAgentCall Tea error. e:code: 400, The specified agentId "123456" is not found. request id: xxxxxxx"
Pastikan bahwa agentId dan Wilayah dikonfigurasi dengan benar.
Di Konsol Intelligent Media Services, buka Real-time Conversational AI > Manajemen Agent di panel navigasi sebelah kiri. Pastikan Wilayah yang dipilih di bagian atas halaman sesuai dengan Wilayah yang dikonfigurasi dalam kode Anda, lalu ambil agentId yang benar dari kolom ID/Nama Agent dalam daftar agent.
Error 5: Token dikembalikan, tetapi klien tetap tidak dapat terhubung.
Gunakan alat verifikasi token RTC untuk memverifikasi bahwa signature dihasilkan dengan benar. Semua parameter yang diperlukan terdapat dalam permintaan atau respons sisi server. Atur nonce ke null dan periksa apakah token yang dihasilkan sudah benar.
Error "AgentNotFound" saat memulai percakapan pesan
Dalam kode klien Anda, pastikan bahwa agentId dan Wilayah dikonfigurasi dengan benar.
Di Konsol Intelligent Media Services, buka Real-time Conversational AI > Manajemen Agent di panel navigasi sebelah kiri. Pastikan Wilayah yang dipilih di bagian atas halaman sesuai dengan Wilayah yang dikonfigurasi dalam kode Anda, lalu ambil agentId yang benar dari kolom ID/Nama Agent dalam daftar agent.
Kode klien:
Android
String mAgentId = "XXX"; // Agent ID. Gunakan ID agent percakapan pesan yang dibuat di Konsol.
String mRegion = "cn-shanghai"; // Wilayah tempat agent berada. Gunakan Wilayah agent percakapan pesan yang ditampilkan di Konsol.
ARTCAIChatAgentInfo agentInfo = new ARTCAIChatEngine.ARTCAIChatAgentInfo(mAgentId, mRegion)iOS
// Agent ID. Gunakan ID agent percakapan pesan yang dibuat di Konsol.
let agentInfo = ARTCAIChatAgentInfo(agentId: "xxxx")
// Wilayah tempat agent berada. Gunakan Wilayah agent percakapan pesan yang ditampilkan di Konsol.
agentInfo.region = "cn-shanghai"Error "UnsupportedWorkflowType" saat memulai percakapan pesan
Jika detail error-nya adalah "The specified workflowType \"VoiceChat\" is not supported by this interface. Please use a compatible workflowType: [\"MessageChat\"]", periksa agentId dan pastikan tipe alur kerja yang terkait adalah MessageChat.
Di halaman Manajemen Agent, temukan agent yang dimaksud dan periksa kolom ID Alur Kerja Agent untuk memastikan tipe alur kerja yang terkait adalah MessageChat.
Menyesuaikan laju sampel perekaman audio klien
AI Percakapan Real-time mendukung pengaturan berikut untuk perekaman audio sisi klien:
-
Laju sampel 48 kHz, saluran mono
-
Laju sampel 16 kHz, saluran mono
Secara default, SDK AICallKit menggunakan laju sampel 48 kHz. Untuk beralih ke 16 kHz, lihat contoh kode berikut:
SDK Web hanya mendukung laju sampel 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);Menyesuaikan laju sampel pemutaran audio agent
AI Percakapan Real-time mendukung pengaturan audio berikut untuk pemutaran agent:
-
Laju sampel 48 kHz, saluran mono atau stereo
-
Laju sampel 16 kHz, saluran mono
Secara default, AI Percakapan Real-time menggunakan laju sampel 48 kHz saluran mono. Anda harus menyesuaikan pengaturan ini dalam pemanggilan API yang memulai percakapan. Metodenya berbeda-beda tergantung cara Anda memulai panggilan:
Metode 1: Menggunakan API GenerateAIAgentCall di sisi server
Anda dapat menambahkan parameter AgentConfig dan menyusun bidang ExperimentalConfig di AIAgentConfig.
// AudioQualityMode: Integer
// Mode laju sampel untuk output RTC.
// 0: 48 kHz saluran mono
// 1: 48 kHz saluran stereo
// 2: 16 kHz saluran mono
// Nilai ExperimentalConfig harus berupa string JSON.
{
"ExperimentalConfig":"{\"AudioQualityMode\":2}"
}Metode 2: Menggunakan API StartAIAgentInstance di sisi server
Anda dapat menambahkan parameter AgentConfig dan menyusun bidang ExperimentalConfig di AIAgentConfig.
// AudioQualityMode: Integer
// Mode laju sampel untuk output RTC.
// 0: 48 kHz saluran mono
// 1: 48 kHz saluran stereo
// 2: 16 kHz saluran mono
// Nilai ExperimentalConfig harus berupa string JSON.
{
"ExperimentalConfig":"{\"AudioQualityMode\":2}"
}Metode 3: Menggunakan API call() di sisi klien
Jika Anda membuat dan memulai panggilan menggunakan API call(xxx) dengan parameter callConfig, Anda dapat menggunakan metode ini untuk mengubah laju sampel pemutaran agent.
Metode ini memerlukan SDK AICallKit versi 2.5.0 atau lebih baru.
iOS
let callConfig = ... // Buat dan inisialisasi ARTCAICallConfig. Untuk detailnya, lihat panduan pengguna.
let agentConfig = ARTCAICallAgentConfig() // Buat objek ARTCAICallAgentConfig.
agentConfig.experimentalConfig = [
"AudioQualityMode": 2
]
... // Atur parameter sesuai kebutuhan bisnis Anda.
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);