エージェントパッケージファイルダウンロード

エージェントパッケージファイルダウンロード機能は、エージェントとボットの資材をまとめてダウンロードする機能です。

ダウンロード条件

ファイルダウンロードするボットは、会話開始のシナリオ(チャットウィンドウやLINE連携で指定するシナリオ)に「シナリオID」が付与されている必要があります。

ご注意
  • ボットエディタで外部APIと連携しているボットは、後述の手順ではドコモAIエージェントAPIで利用できない可能性があります。
    利用できない場合は、サポートページからお問い合わせください。
  • ドコモAIエージェントAPIのLINE連携機能とRepl-AIのLINE連携機能には機能差分があります。
    Repl-AIでご利用中のLINE連携機能について、移行可否のご相談や引き続きの利用をご検討の場合は、ドコモAIエージェントAPI(有償)のサイトからご相談ください。

事前準備

ポイント
既にダウンロード準備がお済みの方は、こちらの手順から実施してください。
  1. AgentCraft情報のエージェントIDを取得
  2. AgentCraft情報のAPIキーを取得
  3. ボットエディタにAgentCraft情報を設定
  4. AgentCraftと連携
  5. 連携確認

AgentCraft情報のエージェントIDを取得

操作手順

  1. AgentCarftにログインしてください。
  2. エージェントツリーの追加(1)を押下して新規エージェントを作成してください。
     
  3. 追加したエージェントの名前を任意のエージェント名に変更してください。
     
  4. エージェントツリーの追加したエージェント(1)を選択してください。
    URLに表示されている「https://agentcraft.sebastien.ai/main_agents/」以降のエージェントID(2)をテキストファイルなどに書き出しておいてください。

    例)「https://agentcraft.sebastien.ai/main_agents/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx」の場合、
       エージェントIDは「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx」となります。
     

AgentCraft情報のAPIキーを取得

操作手順

  1. 設定(1)を押下し、APIキーの追加(2)を選択して表示されたAPIキー(3)をテキストファイルなどに書き出しておいてください。

ボットエディタにAgentCraft情報を設定

ポイント
本作業は初回のみ必須となります。ボットを紐付けるエージェントに変更がなければ、2回目以降は不要です。

操作手順

  1. ボットエディタにログインしてください。
  2. 画面右上のアカウントアイコンからマイページ(1)を選択してください。
     
  3. AgentCraftで書き出しておいたエージェントID(1)とAPIキー(2)をAgentCraft情報に入力し、保存(3)を押下してください。
     

AgentCraftと連携

ポイント
連携対象は本手順を行ったボットのみです。
複数のボットをAgentCraftと連携する場合は、すべてのボットで本手順を行ってください。

操作手順

  1. メニューからAgentCraftと連携するボットの ファイル一括(1) を選択し、ドコモAIエージェントAPI用ファイルダウンロード(2)を押下してください。
     
  2. 会話開始シナリオ(1)を選択し、ダウンロード(2)を押下してください。
    本手順を行ったボットはAgentCraftに連携ボットとして登録されます。
    ご注意
    • ファイルがダウンロードされますが、エージェントとボットの連携が未設定のファイルですので、この段階では破棄してください。
    • 会話開始シナリオを選択しなかった場合、想定外の挙動となる場合があります。
    • 特定のシナリオから会話を開始させる場合は、必ず会話開始シナリオを選択してください。
     

連携確認

ポイント
エージェントとボットを連携するための設定作業です。1ボットにつき1度、初回のみ必須となります。

操作手順

  1. 再度、AgentCarftにログインしてください。
  2. 追加したエージェント(1)を選択し、設定(2)を押下してください。
  3. ボット一覧タブ(3)にAgentCraftと連携を行ったボット(4)が表示されていることを確認してください。
     
  4. 編集(1)を押下し、新規トピック(2)のメッセージ(3)を選択してください。
     
  5. 「$」を入力し、ボット一覧で確認したボット名(1)を選択してください。
     
  6. 保存(1)を押下してください。
     
  7. 画面右下の「エージェントのテスト」アイコンを押下してください。
     
  8. 発話入力欄にメッセージを入力し、動作確認を行ってください。
    ポイント
    • ボットエディタでシステム起点から会話を開始しているボットの場合、「init」を送信すると設定されていた返答を確認できます。
    • ユーザ起点から会話を開始しているボットの場合、ユーザ起点に繋がるユーザ発話ボックスに設定されていた単語を送信すると設定されていた返答を確認できます。
     

ダウンロード

エージェントパッケージファイルをダウンロード

ポイント
  • 本手順はボットごとに行う必要があります。複数のボットをドコモAIエージェントAPIにアップロードする場合は、すべてのボットで本手順を行ってください。
  • 本手順により、ボットエディタで作成した最新のボットのデータが反映された、エージェントパッケージファイルをダウンロードいただけます。

操作手順

  1. 再度、ボットエディタにログインしてください。
  2. メニューからドコモAIエージェントAPIにアップロードするボットの ファイル一括(1) を選択し、ドコモAIエージェントAPI用ファイルダウンロード(2)を押下してください。
     
  3. 会話開始シナリオ(1)を選択し、ダウンロード(2)を押下してください。
    ダウンロードされたファイルはドコモAIエージェントAPIマネジメントサイトで直接アップロードできます。

    ご注意
    • ドコモAIエージェントAPIマネジメントサイトには本手順でダウンロードしたファイルをアップロードしてください。
      ボットエディタ用の「ファイルダウンロード」でダウンロードしたファイルは、ドコモAIエージェントAPIマネジメントサイトにアップロードできません。
      また、事前準備の手順「AgentCraftと連携」でダウンロードしたファイルは不要です。
    • 会話開始シナリオを選択しなかった場合、想定外の挙動となる場合があります。
      特定のシナリオから会話を開始させる場合は、必ず会話開始シナリオを選択してください。