Intelligent Media Services:リアルタイム対話型 AI に関する FAQ

オリジンサーバーに AI エージェントをデプロイする必要がありますか?

いいえ、クラウドにデプロイする必要はありません。 AI エージェントは、Alibaba Cloud によって提供されるパブリッククラウドサービスです。 [コンソール] でエージェントを作成し、OpenAPI を介してアクセスするだけです。

エージェントは Alibaba Cloud Model Studio にデプロイされた大規模言語モデル (LLM) にどのようにアクセスしますか?

リアルタイム対話型 AI は Alibaba Cloud Model Studio と統合されています。 Model Studio が提供する LLM にアクセスするには、[コンソール] で必要なパラメーターを構成します。 詳細については、「LLM」をご参照ください。 

通話の開始時に発生するエラーをどのように処理しますか?

エラー 1：値 "${biz.live_mic.gslb}" 内のプレースホルダー 'biz.live_mic.gslb' を解決できませんでした

• 原因: サーバー側の application.yaml ファイルで構成が欠落しているか、削除されています。

• 解決策: @value アノテーションを介して挿入された変数は、ファイル内に存在する必要があります。 該当する場合は、プレースホルダーをデフォルト値または空の文字列 "" に設定できます。

エラー 2：指定されたリソースを操作する権限がユーザーにありません

• 解決策: アプリサーバーをデプロイするときは、構成された AccessKey ペアが正しいことを確認し、RAM ユーザーに AliyunICEFullAccess 権限を付与します。 詳細については、「ソースコードによるデプロイ」をご参照ください。

エラー 3: generateAIAgentCall Tea error. e:code: 404, Specified access key is not found

• 解決策: サーバー側の application.yaml ファイルで AccessKey ID と AccessKey Secret が正しく構成されているかどうかを確認します。 次に、RAM ユーザーに AliyunICEFullAccess 権限を付与します。 詳細については、「ソースコードによるデプロイ」をご参照ください。

エラー 4: generateAIAgentCall Tea error. e:code: 400, The specified agentId "123456" is not found. request id: xxxxxxx

• 解決策: エージェント ID とリージョンが正しく構成されているかどうかを確認します。

エラー 5: トークンは返されますが、クライアントはまだ接続できません。

• 解決策: RTC トークン検証ツール を使用して、トークン生成の精度を確認します。 関連するパラメーターは、サーバーリクエストまたは戻り値にあります。 nonce を null として指定し、生成されたトークンが正しいかどうかを確認します。

メッセージングの会話を開始すると、クライアントから「AgentNotFound」エラーが報告されます

クライアントコードでエージェント ID とリージョンが正しく構成されているかどうかを確認します。

String mAgentId = "XXX";          // メッセージングの会話用にコンソールで作成された AI エージェントの ID。
String mRegion = "cn-shanghai";   // コンソールで AI エージェントがデプロイされているリージョン。
ARTCAIChatAgentInfo agentInfo = new ARTCAIChatEngine.ARTCAIChatAgentInfo(mAgentId, mRegion)

// メッセージングの会話用にコンソールで作成された AI エージェントの ID。
let agentInfo = ARTCAIChatAgentInfo(agentId: "xxxx")
// コンソールで AI エージェントがデプロイされているリージョン。
agentInfo.region = "cn-shanghai"

メッセージングの会話を開始すると、クライアントから「UnsupportedWorkflowType」エラーが報告されます

エラーメッセージ: 指定された workflowType \"VoiceChat\" は、このインターフェースではサポートされていません。 互換性のある workflowType: [\"MessageChat\"] を使用してください

解決策: エージェントがメッセージングワークフローに関連付けられているかどうかを確認します。

クライアントのオーディオサンプルレートを調整するにはどうすればよいですか?

リアルタイム対話型 AI は、クライアントでのオーディオキャプチャについて次の設定をサポートしています。

• サンプルレート：48 kHz、モノラルチャンネル

• サンプルレート：16 kHz、モノラルチャンネル

AICallKit SDK はデフォルトで 48 kHz のサンプルレートを使用します。 16 kHz に切り替えるには、次のコード例を参照してください。

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

// 他の API を呼び出す
...  

// 通話を開始する
self.engine.call(...)

ARTCAICallEngine.ARTCAICallConfig artcaiCallConfig = new ARTCAICallEngine.ARTCAICallConfig();
artcaiCallConfig.audioConfig.audioProfile = ARTCAICallAudioBasicQualityMode;
engine.init(artcaiCallConfig);

// AudioQualityMode: Integer    
// RTC 出力のサンプルレート。
// 0: 48 kHz モノラル
// 1: 48 kHz ステレオ
// 2: 16 kHz モノラル
// ExperimentalConfig の値は JSON 文字列である必要があります
{
    "ExperimentalConfig":"{\"AudioQualityMode\":2}"
}

// AudioQualityMode: Integer    
// RTC 出力のサンプルレート。
// 0: 48 kHz モノラル
// 1: 48 kHz ステレオ
// 2: 16 kHz モノラル
// ExperimentalConfig の値は JSON 文字列である必要があります
{
    "ExperimentalConfig":"{\"AudioQualityMode\":2}"
}

let callConfig = ...   // ARTCAICallConfig を作成して初期化する。

let agentConfig = ARTCAICallAgentConfig()         // ARTCAICallAgentConfig オブジェクトを作成する。
agentConfig.experimentalConfig = [
    "AudioQualityMode": 2
]
...                                                  // ビジネスニーズに応じてパラメーターを設定する
callConfig.agentConfig = agentConfig
self.engine.call(config: callConfig)                 // 通話を開始する

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);