ドコモAIエージェントAPIについて

多言語利用は可能でしょうか。

多言語機能は現在ございません。

料金について

使い始めるのに料金はかかりますか？

開発ツールであるAgentcraft®は無料でご利用いただけます。商用目的での利用をお考えの方はお考えの方は、料金プランのページからご希望のプランを選択して下さい

FAQチャットボット関連

FAQチャットボットで対話を行おうとすると、「#FAQ_EXACT_TALK」などが返ってきて想定通りの対話ができない。

サンプルとして配布しております『FAQConfig.aiml』の「key_acquisition_count」の値が「3」となっていた場合、「1」へと変更ください。

Agentcraft®関連

Agentcraft®のテスト対話側から初回発話をすることは可能ですか。

Agentcraft®のテスト対話側から発話を開始することはできません。

連携ボット(AIMLファイル)をアップロードしようとすると「エラーが発生しました。ページの再読込み等で状況が改善しない場合はサポートにご連絡をお願いします。」が表示されてしまう。

下記のパターンが考えられます。
・AIMLのバージョンが『2.0.0〜2.5.0』でない
・ファイルの文字コードが『UTF-8』でない(set, mapファイルも同様)
・set, mapファイルに重複がある
・AIML構文に誤りがある(SUNABAでご確認ください)

チャットUI導入関連

各UI連携における、改行方法を教えてください。

こちらのページで各UIに対するコマンド記述方法についてのファイルをアップロードしており、その中に改行コマンドが記載されております。ご確認ください。
（尚、WowTalkにつきましては現在コマンド記述ファイルはございませんが、brタグを使用することによって可能となります。）

各UI連携における、UI側からの発話の方法を教えてください。

各UIによって異なります。ご確認ください。

WebUI	WowTalk	Microsoft Teams	LINE	LINE WORKS
『index.html』ファイル内のdata-init-voice-textを設定することで変更可能です。	システムからの発話は出来かねます。	システムからの発話は出来かねます。	Developerサイトより、初回発話を設定します。AIML上の設定は不要です。	ユーザ発話側から「利用開始」と発話するため、それに合わせたAIMLの設定が必要です。

Microsoft Teams連携において、チームではなく、個別チャットでのやりとりは可能でしょうか？

個別でのチャットを行うことはできません。

辞書関連（シナリオでの対話）

専門用語が多いので、独自の辞書を作成したいのですが作成可能ですか。

可能となります。setファイルもしくは、mapファイルを用いて作成します。

文字の揺らぎには対応していますか。

類義語などを判定できるよう設定可能です。
Agentcraft®で設定する場合はこちらをご覧ください。
連携ボットで設定する場合は、patternタグのlevelを調整することで設定可能となります。詳しくはこちらをご覧ください。

辞書関連（FAQチャットボット）

文字の揺らぎには対応していますか。

ゆらぎに対応しております。こちらでダウンロードしていただく初期シート内にございます。
動詞の揺らぎにつきましては「動詞ゆらぎ辞書」、名詞の揺らぎにつきましては、「専門用語辞書」にて設定が可能です。

対話設計関連

ユーザー発話に対して想定していないパターンにマッチする。

こちらをご確認いただき、展開レベルを下げることをご検討ください。

マネジメントサイト関連

契約IDはどこで確認できますか。

マネジメントサイトにログインしていただき、画面左側のメニューから「契約参照・更新」をクリックください。
契約基本情報の一番上の項目に、契約IDが記載されております。

SDKについて

SDKはどこで入手できますか？

無料でご利用いただけるSDKはこちらで公開しております。有償版の音声制御ライブラリについてはお問い合わせください。

SDKのバージョン番号の付け方についてどうなっていますか？

メジャー番号.マイナー番号.リビジョン番号で構成されており、リビジョン番号のカウントアップはバグフィックス、マイナー番号のカウントアップはAPIレベルの下位互換性を保ったままの機能アップ、メジャー番号は下位互換がなく、APIレベルで変更が生じた場合にカウントアップされます。

音声制御ライブラリにおけるエラーについて

エラーコード40101について教えてください。

デバイストークンの取得に失敗している可能性があります。デバイストークン取得手順について確認してください。

ID関連

デバイスIDは変更可能ですか？

Client Secretを使えば再取得は可能ですが、別のデバイスとして認識しますので、デバイスIDは固有番号として利用することをおすすめします。

Client Secretは変更可能ですか？

変更可能です。その場合、DeviceIDを変更してください

Shadow IDをユーザIDとして利用可能ですか？

利用可能です。ただし、ShadowIDはBot毎に異なりますので、同じユーザに紐付いていたとしても同じユーザとして識別出来ません。

Device Tokenは再発行可能ですか？

いいえ、出来ません。その場合はDevice IDの再登録が必要になります。

Device Tokenの発行に関して失敗しました。どうすればよいですか？

Device IDをユーザに再登録し、再発行してください。

ユーザ識別が必要ないのですが、DeviceIDやDeviceTokenを利用しなければなりませんか？

テキストチャットボットGWを利用してください。各種IDの発行が不要になります。セッションごとに個別の識別子が発行されます。

発行済DeviceTokenを無効にしたいのですが？

Device IDでDelete Device Token APIを発行してください。削除可能です。

発行済Device IDを削除したいのですが？

Device IDでDelete Device ID APIを発行してください。削除可能です。

Access Tokenの有効期限はユーザがアクセスするたびに延長されますか。

Access Tokenはユーザーのアクセスによって延長されません。

Access Token、Refresh Tokenの有効期限を教えてください。

Access Tokenの有効期限は30日です。Refresh Tokenの有効期限は90日です。

音声認識関連

音声認識がうまくいきません。

音声がきちんと入力されているか、デバイスやアプリでマイクや音声のデバイスが動作しているかを確認してください。ノイズが多い、サンプリングレートが間違っているなどで音声認識ができないこともあります。

音声認識で間違って認識される

音声の認識に関して近い音の間違った語（同音異義語）として認識されることがあります。音声認識辞書はシステム共通です。NTTドコモでは新語に対応するために、適宜辞書を更新していますが、特殊な用語に関しては認識できないことがあります。なお、音声認識の認識結果の判定には前後の文脈で判断するものもありますので、単語の認識ではなく、文として認識するとうまくいくことがあります。

音声認識が安定しない

特定の文や語によっては毎回同じように認識されないなどの問題がある場合があります。これに関しては、音声認識へのノイズや話者によってもどうしても異なってしまう場合もありますので、認識結果のログ（認識結果のメタデータ）を見た上でシナリオ側でロジックを複数作ることで吸収できる場合がありますので、そちらをご検討ください。

音声合成関連

音声合成を間違える。間違った読みで読んでしまう。

音声合成は現在のところ個別の読みを与える方法については提供されていませんが、発話する音声と表示するテキストを変えることで強制的に発話させることが出来るようになっています。例えば、どうしても読めないブランド名などの発話に関してはカタカナ表記で強制的に発話させ、画面表示用には正しいブランド表記などで表示させるなどが可能です。音声合成のSDKのドキュメントを参照ください。

音声合成が途切れる。発話にノイズが乗る。発話が変。

発話の再生に問題がある場合は、大きく分けて①通信品質が極端に悪く、発話できない、②CPU性能が足りていないために音声合成ができない、の２通りが考えられます。
①に関しては通信の品質を上げる工夫をするなども効果的ですが、バッファリングのパラメータを変更することで対応可能な場合がありますので、ドキュメントを参照ください。
②に関してはCPUの性能を高いものにするか、発話中に処理を減らすなどの工夫をすることで回避できることがあります。

音声合成の声が変わらない。 常にデフォルトの音声合成になる。

音声合成のキャラクタIDが正しく与えられていないか、KeyIDが間違っているために合成音声モデルを指定できていないと思われます。発話時のメタデータに合成音声モデル名が記載されていますので、そちらを確認し、モデル名が期待されている値になっているかを確認ください。

その他の質問

その他、よくいただく質問を追加しました。本ページに見当たらない場合はこちらをご覧ください。