DialBBノーコードツール（DialBB-NC）ドキュメント

はじめに

本ドキュメントはDialBBのノーコードツール（DialBB-NC）のドキュメントです．

Ver1.xからの大きな変更点

• Python3.10では動かなくなりました．

• 言語理解，固有表現抽出がなくなり，代わりにスロット抽出が使えるようになりました．

動作環境

Windows11，MacOSで動作します．

インストール・起動（Windows）

Pythonのインストール

• もし，すでにPythonがインストールされていれば，バージョンを確かめてください．インストールされていても，バージョンが3.11-3.14であれば，新しくインストールする必要はありません．3.10以前のPythonがインストールされている場合，使っていないならアンインストールしてください．使っている場合，DialBBの開発者（dialbbあっとc4a.jp）に相談してください（”あっと"を"@"に置き換えてください。）．

• Windows 11

  • Pythonがインストールされていない場合，以下の手順でPythonをインストールします．

    • ブラウザのアドレスバーに https://www.python.org/downloads/windows/ を打ち込んでEnterキーを押します．

    • 表示されている中から以下の部分を探します．以下は3.11.9ですが，3.11.x-3.14.xであれば，別のバージョンでも構いません．3.10.x以前と3.15.x以降は利用できません．

    

    • お持ちのPCが64bit OSの場合は，Windows installer (64-bit)を，32bit OSの場合はWindows installer (32 -bit)をクリックします．

    • 「ダウンロード」フォルダに python-3.13.14-amd64.exeまたはpython-3.13.14-amd32.exeというファイルができるので，ダブルクリックします．

    • 以下の画面が現れます．

      

      • Add python.exe to PATHにチェックを入れてからInstall Nowをクリックします．

        

      • Pythonがインストールされます．

DialBBのインストール

• 必要なファイルを以下の手順でダウンロードします．

  • ブラウザから https://c4a-ri.github.io/dialbb/files/dialbb-setup.zip にアクセスします．

  • ダウンロードフォルダにdialbbファイルがダウンロードされます．エクスプローラでダウンロードフォルダを開いて確認してください．以下のようなファイルができているはずです．

    

    • このようにチャックの模様があるものをzipファイルと呼びます．環境によっては，dialbb-setup.zipという名前で表示されます．

    • 複数回ダウンロードすると，新しくダウンロードしたものはdialbb-setup(1)のような名前になるので，その場合，ダウンロードフォルダのdialbb-setupを削除してからもう一度ダウンロードしてください．

• エクスプローラでdialbb-setupアイコンの上にカーソルを持っていき右クリックし，「すべて展開」を選びます．出てきた画面で，「展開」を押してください．dialbb-setupフォルダができるので，それを開いてください．

• install（環境によってはinstall.bat）をダブルクリックします．DialBBがインストールされます．

  • 「WindowsによってPCが保護されました」と出るかもしれません．その場合，「詳細情報」をクリックすると，「実行」ボタンが出てくるので，それを押してください．

  • Press any key to continue . . .と表示されたらインストールは完了なので，何かキーを押して終了してください．

起動

dialbb-setupフォルダ内でstart-dialbb-nc（またはstart-dialbb-nc.bat）をダブルクリックします．

正常に起動するとメイン画面が表示されます．

インストールと起動（Mac）

Pythonのインストール

Windowsの場合と同様，Python3.11-3.14がインストールされていれば，新たにインストールする必要はありません．

Pythonがインストールされていない場合，以下の手順でインストールしてください．

• Pythonの公式ダウンロードサイトにアクセスしてください．

• 適当なバージョン（例:3.13.14）の下の，macOS 64-bit universal2 installerをクリックし，ファイルをダウンロードします．

• ダウンロードした .pkg ファイルを開いて，画面に表示される指示に従いインストールを進めてください．

DialBBのインストール

https://c4a-ri.github.io/dialbb/files/dialbb-setup.zip からdialbb-setup.zipファイルをダウンロードします．Downloadフォルダにダウンロードされます．ターミナルを開きます．適当なディレクトリ（DialBBディレクトリと呼びます）を作って移動してください．

そこで，

unzip ~/Downloads/dialbb-setup.zip
pip install --force-reinstall *.whl

としてください．DialBBがインストールされます．

起動

ターミナルで以下を実行します．（ディレクトリはどこでも構いません）

xxxxxxxxxx
dialbb-nc

Macの場合少し画面が乱れます．（修正予定）

アプリケーションの読み込み・作成・書き出し

アプリケーションの読み込み/新規作成

• すでにあるアプリケーションを読み込む場合は，選択ボタンをクリックし，読み込むアプリケーションのzipファイルを選択し，読み込みを押します．

  

• アプリケーションを新たに作成する場合は，新規作成ボタンをクリックし，言語を選択します．テンプレートアプリケーションファイルが読み込まれます．

  

• その時点で読み込まれているアプリケーションの名前（zipファイルの名前）がメイン画面のCurrent applicationのところに表示されます．

アプリケーションの書き出し

• 書き出しボタンをクリックし，保存する場所/ファイル名を指定します，zipファイルにまとめて保存されます．

  

アプリケーションの起動・停止

API キーの登録

最初にDialBB-NCを使うときや，DialBBのインストールをし直した後には，利用する大規模言語モデル（ChatGPTなど）のためのAPIキーの登録が必要です．例えば，ChatGPTを使う場合には，OpenAIのAPIキーの登録が必要です（ OpenAIのAPIキーの入手方法は別途「OpenAI API キー」などで検索して調べてください. 少額ですが有料です）．登録は以下のようにします．

• APIキーボタンを押すと設定画面が出ます．

  

• OPENAI_API_KEYの右側に別途入手したOpenAIのAPIキーを入力し，OKボタンを押します．「保存しました」という表示が出るので再度OKボタンを押します．

• 後述の設定画面やテストでGeminiやClaudeを選ぶ場合は，それぞれGOOGLE_API_KEY，ANTHROPIC_API_KEYが必要です．

• 入力したAPIキーは暗号化して保存されますが，DialBBのプログラムがあれば復号できるので，個人用PC以外では保存しないようにしてください．消去する場合には，各キーに他の文字列をセットするか，DialBBをアンインストールしてください．

対話の実行

• 対話開始ボタンを押すと対話ができます．ユーザ入力フィールドに発話を入力して対話をしてください．

  

テスト

ユーザシミュレーションを利用したテストができます．後で詳細に説明します．

対話サーバの使い方(上級用)

Webサーバとしてアプリケーションを動かし，他のプログラムと連携させたりできます．

起動

• サーバ起動ボタンをクリックします．アプリケーションサーバが起動します．

• ChromeやEdgeなどのブラウザを開き，アドレスバーにhttp://localhost:8080/を打ち込んでEnterを押します．以下のようなチャット画面が表示されます．

  

• start dialogueボタンを押すと会話が開始されます．

• 再度最初から会話を始めたい場合はブラウザのリロードボタンを押してください．

• http://localhost:8080/test にアクセスするとシンプルな画面が出ます．

停止

• メインGUIでサーバ停止ボタンを押すとアプリケーションサーバが停止します．

ログ

• ブラウザからアクセスしても画面が出ない場合や対話がうまくいかない場合は，サーバログ表示ボタンを押し，ログを見て近くのエンジニアかDialBB開発者に相談してください．

• ログはホームフォルダ（ホームディレクトリ）の中の.dialbb_nc_logsフォルダの中に書きだされます．

  • ホームフォルダは，Windowsの場合，C:\Users\<ユーザ名>です．

  • ログは日付毎にフォルダにまとまっています．

  • ログファイルは<アプリケーションが起動した時間>.txtです．

アンインストール

dialbb-setupフォルダの中にある，uninstallというアイコンをダブルクリックするとDialBBがアンインストールできます．

アプリケーションの編集

コンフィギュレーションの変更

設定ボタンを押すと，以下の画面が表示されます．

以下が各編集項目の説明です．

シナリオファイルの編集

シナリオ編集ボタンを押すと，シナリオエディタが表示されます．

シナリオエディタの概

シナリオは，システムノードとユーザノードがリンクで接続されたものです．システムノードではシステム発話を記述し，ユーザノードでは，遷移の条件を記述します．priorityの値が高い順に遷移の条件を調べていき，条件が満たされれば，その次のシステムノードに遷移します．どのユーザノードの遷移の条件も満たされない場合，同じシステムノードに戻って，システム発話が生成されます．

システムノードは複数のユーザにリンクが出て行き，ユーザノードからは一つだけのノードにリンクが出て行きます．（ノード右側コネクタが出口，ノード左側が入口です）

以下の説明の画像には古いバージョンのものがあります．ver2.0以降では，ユーザノードには発話タイプがありません．

システム発話や遷移の条件の記述については，後で説明します．

ノードの追加

背景で右クリック し，システムノード追加かユーザノード追加を選択するとシステムノードかユーザノードが新規追加されます．

ノードの削除

ノードの上で右クリック し削除を選択するかノードを選択してDelキーを押すとそのノードが削除されます．

ノードの編集

ノードの上でダブルクリック すると，ノードの編集画面が表示されます．

ノードの編集の仕方は後述します．

コネクタの接続・削除

ノード右側〇を左クリックし，他ノードの左側〇へドラッグして接続します．

削除はコネクタ上で右クリック し削除を選択するか，選択した状態でDelキーを押すと削除されます．

元に戻す／やり直し

変更を戻すときには上部の元に戻すボタン，やり直しをする時はやり直しボタンを押してください．コントロールキーを押しながらz／yでも操作が可能です.

保存

上部の保存ボタンをクリックすると保存します．保存しないでエディタを終了した場合は変更データが失われます．

再読み込み

上部の再読み込みボタンをクリックすると最後に保存されたデータを読み込みます．大規模な状態遷移図の編集ではこまめに保存をしておけばその状態まで復元することが可能です．

拡大／縮小

マウスのホイールを使いズームイン／ズームアウトが可能です．

キャンバスの移動

マウスの中ボタンまたはコントロールキーを押しながら左クリックで全体をドラッグできます．

シナリオエディタの終了

メインGUIでシナリオ編集終了ボタンを押すとエディタウィンドウが閉じます．

システムノードの編集の仕方

システムノードをダブルクリックすると以下のような入力ダイアログが表示されますので，中身を書き換えて保存ボタンを押します．キャンセルボタンを押すと保存せずに閉じます．

ノードタイプは以下のどれかです．

発話には，システム発話を書きます．システム発話の中に以下のようなものを書けます．

• $<インストラクション>$ ChatGPTにインストラクションを与えて発話を生成させます．このとき，コンフィギュレーションで指定したsituationとpersonaが用いられます． 例： $感想を言う発話を20字以内で生成してください．$ところで，最近の体調はいかがですか？

• $$$<プロンプトテンプレート>$$$

  ChatGPTにプロンプトを与えて発話を生成させます．プロンプトはプロンプトテンプレートから作られます．プロンプトテンプレートは改行を含んでも構いません．以下が例です．

  ​x
  $$$
  # 状況
  
  {situation}
  
  # あなたのペルソナ
  
  {persona}
  
  # 現在までの対話
  
  {dialogue_history}
  
  # 注意事項
  
  {caution}
  
  # タスク
  
  それまでの会話につづけて，対話を終わらせる発話を50文字以内で生成してください．
  $$$
  

  {と}で囲まれている部分はプレースホルダです．

  • 利用できるプレースホルダ

    • {dialogue_history}

      その時点までの対話（最新のユーザ発話を含む）で置き換えられます．

    • {situation}

      コンフィギュレーションで指定した「状況」で置き換えられます．

    • {persona}

      コンフィギュレーションで指定した「あなたのペルソナ」で置き換えられます．

    • {caution}

      コンフィギュレーションで指定した「注意事項」で置き換えられます．

    • {current_time}

      対話の行われている時点の年月日，曜日，時分秒を表す文字列で置き換えられます．

• #<スロット抽出で抽出されたスロット名> (上級用)

  スロット抽出で得られたスロットの値で置き換えられます．{#好きなラーメン}なら，好きなラーメンスロットの値で置き換えられます．

  例：{#好きなラーメン}がお好きなんですね！

  スロットが空の場合，空文字列になります．スロットが空でないときだけ，このノードに来るように，ユーザノードで設定する必要があります．

  スロット抽出については後で説明します．

ユーザノードの編集の仕方

ユーザノードをダブルクリックすると以下のような入力ダイアログが表示されますので，中身を書き換えて保存ボタンを押します．キャンセルボタンを押すと保存せずに閉じます．

優先度はこのユーザノードの優先度を表す整数です．一つのシステムノードからつながっているユーザノードのうち，priority numberの高い順に条件がチェックされます．この数字は，シナリオを保存する度にリセットされ，大きいものから順に100, 90, 80, ...に変更されます．

遷移の条件にはこのユーザノードの条件を書きます．両方が満たされたとき，このユーザノードの次のシステムノードに移行します．

遷移の条件には，この遷移が使われる条件を書きます．条件が複数ある場合は，";"でつなぎます．条件には以下のようなものが書けます．

• $インストラクション$ ChatGPTにインストラクションを与えて条件判定をさせます．このとき，コンフィギュレーションで指定したsituationとpersonaが用いられます． 例： $ユーザが会話に飽きたかどうかを判断してください．$

• $$$<プロンプトテンプレート>$$$

  ChatGPTにプロンプトを与えて条件判定をさせます．プロンプトはプロンプトテンプレートから作られます．プロンプトテンプレートは改行を含んでも構いません．以下が例です．

  $$$
  # 状況
  
  {situation}
  
  # あなたのペルソナ
  
  {persona}
  
  # 現在までの対話
  
  {dialogue_history}
  
  # タスク
  
  ユーザが理由を言ったかどうか判断し，yesかnoで答えてください．
  $$$
  

  {と}で囲まれている部分はプレースホルダです．システムノードと同じものを使うことができます．

• #<言語理解のスロット名> == "<文字列>"/ #<言語理解のスロット名> != "" (上級用)

  直前のユーザ発話の言語理解で得られたスロットの値が文字列に一致するかどうか（==）または一致しないかどうか（!=）を判定します．

  例：#好きなラーメン=="豚骨ラーメン"(上級用)

  スロットが空の場合，空文字列になります．例えば好きなラーメンスロットの値が空であれば，条件，#好きなラーメン==""は満たされます．

• TT > <ターン数>

  対話開始からのユーザ発話の回数が<ターン数>を超えた場合に条件が満たされます． 例：TT>10

• TS > <ターン数>

  その状態（システムノード）でのユーザ発話の回数が<ターン数>を超えた場合に条件が満たされます． 例：TS>5

遷移時のアクションは進んだ使い方の時のみ利用するのでここでは説明しません．

スロット抽出知識の編集（上級用）

スロット抽出とは，それまでの対話から必要な情報を取り出すことです．必要な情報のことをスロットと言います．例えば，気象情報を検索する対話システムならば，「地名」や「日付」などがスロットなります． この「地名」や「日付」をスロット名，実際に抽出される地名や日付の値をスロット値と呼びます．このスロット値をシナリオのユーザノードで遷移の条件として使うことができます．

対話システムに言語理解を行わせるには，スロット抽出知識が必要です．スロット抽出知識には以下のような情報を記述します．

• どのようなスロットがあるのか？

• スロット値の例

• 対話とそれから得られるスロットの例

さらに，各スロットの同義語も記述することができます．

同じ単語が別のスロットになることもあります．例えば，券売機の対話システムで「東京から新大阪までの乗車券」と言えば，乗車駅＝東京，降車駅＝新大阪，券種別＝乗車券となりますが，乗車駅スロットと降車駅スロットは両方とも駅名です．

言語理解知識を編集するには，メイン画面で言語理解知識を選択します．Excelが起動して言語理解知識を読み込むので，編集して保存してください． （OpenOfficeなど，Excel以外のものを使っている場合にはそちらが立ち上がります．表計算ソフトを使っていない場合にはご相談ください）

スロット抽出知識のExcelファイルは，dialoguesシートとslotsシートからなります． 以下がdialoguesシートの例です．

• flag列は使いません．

• dialogue列は対話例です．

• slotsには，<スロット名>=<スロット値>, ... ,<スロット名>=<スロット値>の形で発話に含まれるスロットを書きます．カンマは全角でも読点でも構いません．

以下はslotsシートの例です．

flag列は使いません．

• slot name列にはスロット名を書きます．

• entity列にはスロット値になり得るものの例を書きます．

• synonyms列には，スロット値の同義語をカンマまたは読点で並べて書きます．同義語がスロット値になった場合，entity列のものに置き換えられます．

ユーザシミュレータを用いたテスト

ユーザシミュレータを用いたテストができます．メインメニューでテストボタンを押すと以下のテストメニュー画面が現れます．

設定を押すと，シミュレータの設定が表示されます．

モデルはシミュレータが使うモデルで，最大ターン数はシミュレーション対話のユーザ発話の最大数です．プロンプトはシミュレータのプロンプトです．適宜編集してOKボタンを押して終了してください．

テストメニュー画面で実行ボタンを押すとテストが行えます．