AIコンシェルジュのクライアントモジュール設定

アップロードするファイルの種類

クライアントモジュールでは、アップロードする方法は3種類あります。

• クライアントモジュール配下のupload_filesフォルダにファイルを格納して、バッチファイルを起動する

  upload_filesフォルダ配下に、各ジャンルごとにフォルダを作成してファイルを格納することで、対象のファイルをアップロード対象にすることが可能です。
  ジャンルごとにフォルダを作成する際の設定内容は、以下の章を確認してください。

  ジャンル設定

• デスクトップなど、任意のフォルダ配下にファイルを格納して、バッチファイルを起動する

  クライアントモジュール配下のbatch.confで、対象のフォルダパスを指定します。 複数のフォルダを指定したい場合は、カンマ区切りで指定することで、指定フォルダ内のファイルをアップロード対象にすることが可能です。

• Boxなど、任意のクラウド上にファイルを格納して、バッチファイル起動する

  クライアントモジュール配下のbatch.confで、FTP接続に関する各種パラメータを指定することで、指定フォルダ内のファイルをアップロード対象にすることが可能です。
  各種パラメータの詳細は、以下の章を確認してください。

  batch.conf パラメーターの説明表
  補足

  ・3つのアップロード方法を組み合わせて、運用に合わせて柔軟にファイルをアップロードできます。

設定ファイル (batch.conf)

• 環境設定と認証情報

  ・esm.host、esm.tenantは、クライアントモジュールをダウンロードした際に自動的に設定されます。

  ・通常、ユーザーが手動で入力する必要はありませんが、トークンの再発行などが必要な場合は手動で変更する必要があります。
  esm.host: アップロード先のホスト名
  esm.token: 認証用トークン

• ジャンル設定

  ・各ファイルは、以下のように3つのジャンルに分けられます。

  ・それぞれのジャンルに合ったフォルダやファイルをアップロードすることで、AIが適切に学習し、質問に回答します。

  ジャンル	説明	設定例
  PRODUCT_MASTER	商品説明書類	商品の詳細情報や使用を記載した資料
  DOCUMENT	規定書類	ガイドラインやポリシー、利用規約など
  SALES_PROPOSAL	提案書類	営業提案やプレゼン資料

  ・以下のように、batch.confでファイルやフォルダをglobパターンでジャンルに割り当てます。
  例：
  segment.glob.PRODUCT_MASTER=**/product/**,**/product*
  segment.glob.DOCUMENT=**/document/**,**/document*
  segment.glob.SALES_PROPOSAL=**/sales/**,**/sales*
  
  

  複数のジャンルに該当する場合、batch.conf内で最初に定義されているジャンルが優先されます。

  ・PRODUCT_MASTER：
  →/product/という名前が含まれるフォルダのファイル((例：/path/to/product/catalog.pdf) または ファイル名の先頭にproductを含むファイル(例：/path/to/product_management.pdf)に一致します。
  

  ・DOCUMENT：
  →/document/という名前が含まれるフォルダのファイル(例：/path/to/document/policy.pdf) または ファイル名の先頭にdocumentを含むファイル(例：/path/to/document_1111.pdf)に一致します。
  

  ・SALS_PROPOSAL：
  →/sales/という名前が含まれるフォルダのファイル(例：/path/to/sales/presentation.pdf) または ファイル名の先頭にsalesを含むファイル(例：/path/to/sales_presentation.pdf)に一致します。
  

  補足

  ・globパターンとは、特定のファイル名やパスを簡単に指定するためのルールです。
  以下のように、特定の条件に一致するファイルやフォルダを効率的に指定できます。

  パターン	説明	例
  *	任意の文字列に一致します。	*.txt → .txtで終わるすべてのファイルに一致
  **/	全階層に一致します（再帰検索）。	**/logs/** → すべてのlogsフォルダ内のファイルに一致
  ?	任意の1文字に一致します。	file?.txt → file1.txt、fileA.txtなどに一致
  {a,b}	複数の候補から一致するパターンを選択します。	*.{java,class} → .java または .classファイルに一致
  [a-z]	指定された範囲の1文字に一致します。	file[1-3].txt → file1.txt、file2.txt、file3.txtに一致

• フォルダ操作とファイル無視設定

  ・無視するファイルの指定: batch.confにてglobパターンを使って、無視するファイルやフォルダを指定できます。
  例：
  batch.ignore_globs=**/.env,**/ignore/**
  説明：
  .envファイルまたはignoreという名前のフォルダ配下にあるファイルは、アップロード対象に含まれなくなります。

• ファイル更新日チェック

  ・batch.confでは、ファイルの更新日を基準に、アップロードするかどうかを決定する2つのモードを選択できます。

  fixed_date（固定日付モード）

  特定の日付以降に更新されたファイルのみをアップロード対象にするモードです。

  例：
  batch.upload_mode=fixed_date
  batch.fixed_date=2024-01-01

  説明：
  2024年1月1日以降に更新されたファイルのみがアップロードされます。

  recent_days（○日前モード）

  現在の日付から指定した日数以内に更新されたファイルをアップロード対象とするモードです。

  例：
  batch.upload_mode=recent_days
  batch.recent_days=30
  

  説明：
  本日から過去30日以内に更新されたファイルが対象になります。

batch.conf パラメーターの説明表