intra-mart Accel Platform IM-Copilot 利用ガイド 第4版 2025-10-01

5. セットアップ( iAP )

IM-Copilot を利用するための intra-mart Accel Platform のセットアップ方法について説明します。

5.1. 前提条件

IM-Copilot は以下のエディションでご利用が可能です。
  • パッケージライセンス
    • intra-mart Accel Platform Advanced Edition 2025 Spring(Kamille) 以降
  • カスタマーサクセスライセンス
    • intra-mart Accel Platform Low-Code Edition 2025 Spring(Kamille) 以降
    • intra-mart Accel Platform Advance Edition 2024 Spring(Iris) 以降
    • intra-mart Accel Platform Professional Edition 2024 Spring(Iris) 以降

コラム

Standard Edition, Basic Edition, Pro Code Edition ではご利用いただけません。

5.2. セットアップ手順

5.2.1. IM-Jugglingプロジェクトの編集

  1. ご利用のIM-Jugglingプロジェクトに、IM-Copilotモジュールを追加してください。
    IM-Copilotモジュールは、[標準機能 - 基盤機能 - IM-Copilot] 配下に存在します。
    ../../../_images/iap_juggling_1.png

    コラム

    Amazon Bedrock を生成AIサービスとして利用する場合は IM-Copilot Amazon Bedrock ドライバモジュールを選択してください。
  2. エラーメッセージが表示された場合は、そのメッセージをクリックし、指示に従って以下の設定ファイルを追加してください。
    • IM-Copilot生成AI連携ドライバ設定
    • IM-Copilot生成AI連携アクション設定

コラム

IM-Jugglingの使用方法の詳細については、「intra-mart Accel Platform セットアップガイド」 - 「プロジェクトの作成とモジュールの選択」 を参照してください。

5.2.2. 生成AI連携ドライバ設定

  1. 生成AI連携ドライバ設定ファイルを編集します。
    「ProjectNavigator」内の <(プロジェクト名)/conf/im-copilot-driver-config.xml> ファイルをダブルクリックで開き、「ソース」タブを選択してください。

    各生成AIサービスに対しての接続に関する設定を行います。
    <?xml version="1.0" encoding="UTF-8"?>
    <im-copilot-driver-config xmlns="https://www.intra-mart.jp/im-copilot/im-copilot-driver-config" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://www.intra-mart.jp/im-copilot/im-copilot-driver-config ../schema/im-copilot-driver-config.xsd ">
      <!-- Linkage Driver Setting for Common to Tenants -->
      <default-drivers>
        <driver type="open-ai">
          <api-key>sk-0000XXXXXX</api-key>
          <base-url>https://api.openai.com/v1</base-url>
          <organization>XXXXXXXX</organization>
          <retry-count>3</retry-count>
          <retry-wait>1</retry-wait>
          <parameters>
            <parameter>
              <parameter-name>default-chat-model</parameter-name>
              <parameter-value>gpt-4o-mini</parameter-value>
            </parameter>
            <parameter>
              <parameter-name>default-embeddings-model</parameter-name>
              <parameter-value>text-embedding-3-small</parameter-value>
            </parameter>
            <parameter>
              <parameter-name>default-images-model</parameter-name>
              <parameter-value>dall-e-2</parameter-value>
            </parameter>
            <parameter>
              <parameter-name>default-speech-model</parameter-name>
              <parameter-value>tts-1</parameter-value>
            </parameter>
            <parameter>
              <parameter-name>default-speech-voice</parameter-name>
              <parameter-value>echo</parameter-value>
            </parameter>
            <parameter>
              <parameter-name>default-transcription-model</parameter-name>
              <parameter-value>whisper-1</parameter-value>
            </parameter>
          </parameters>
        </driver>
        <driver type="azure-open-ai">
          <api-key>9999XXXXXX</api-key>
          <base-url>https://openai-service-foo.openai.azure.com/openai/</base-url>
          <retry-count>3</retry-count>
          <retry-wait>1</retry-wait>
          <parameters>
            <parameter>
              <parameter-name>default-chat-deployment-id</parameter-name>
              <parameter-value>gpt-4o-mini</parameter-value>
            </parameter>
            <parameter>
              <parameter-name>default-embeddings-deployment-id</parameter-name>
              <parameter-value>text-embedding-ada-002</parameter-value>
            </parameter>
            <parameter>
              <parameter-name>default-images-deployment-id</parameter-name>
              <parameter-value>dall-e-3</parameter-value>
            </parameter>
            <parameter>
              <parameter-name>default-transcription-deployment-id</parameter-name>
              <parameter-value>whisper</parameter-value>
            </parameter>
          </parameters>
        </driver>
        <driver type="amazon-bedrock">
          <aws-region>ap-northeast-1</aws-region>
          <aws-credentials-profile>default</aws-credentials-profile>
          <parameters>
            <parameter>
              <parameter-name>default-chat-model</parameter-name>
              <parameter-value>anthropic.claude-3-haiku-20240307-v1:0</parameter-value>
            </parameter>
            <parameter>
              <parameter-name>default-chat-max-tokens</parameter-name>
              <parameter-value>4096</parameter-value>
            </parameter>
            <parameter>
              <parameter-name>default-embeddings-model</parameter-name>
              <parameter-value>amazon.titan-embed-text-v1</parameter-value>
            </parameter>
            <parameter>
              <parameter-name>default-images-model</parameter-name>
              <parameter-value>amazon.nova-canvas-v1:0</parameter-value>
            </parameter>
          </parameters>
        </driver>
      </default-drivers>
    </im-copilot-driver-config>
    
  2. 以下のドライバ設定の項目を記述してください。
    設定内容の詳細については、 「設定ファイルリファレンス」 - 「IM-Copilot生成AI連携ドライバ設定」 を参照してください。
    • OpenAI を利用する場合
      <driver>タグの type属性に、open-ai を指定してください。
      <api-key>タグ 、<base-url>タグ が必須項目です。
      必要に応じて、 <organization>タグ 、<retry-count>タグ、<retry-wait>タグを設定してください。
    • Azure OpenAI Service を利用する場合
      <driver>タグの type属性に、azure-open-ai を指定してください。
      <api-key>タグ 、<base-url>タグ が必須項目です。
      必要に応じて、 <retry-count>タグ、<retry-wait>タグを設定してください。
    • Amazon Bedrock を利用する場合
      <driver>タグの type属性に、amazon-bedrock を指定してください。
      <aws-region>タグにAWSリージョンコードを設定してください。(例:us-east-1、ap-northeast-1)
      認証方式に応じて以下のいずれかの設定を行ってください。
      • 認証情報ファイルを利用して認証する場合
        <aws-credentials-profile>タグを記述し、認証情報ファイルの作成 で得たプロファイル名を設定してください。
      • 設定ファイルに直接記述したアクセスキーとシークレットキーを利用して認証する場合
        <aws-credentials-static>タグを記述し、アクセスキーとシークレットキーの作成 で得たアクセスキーとシークレットキーを設定してください。
      • インスタンスプロファイルを利用して認証する場合(※Amazon EC2 インスタンス上で iAP が動作している場合のみ)
        <aws-credentials-iam-role-arn>タグを記述し、ロールの作成 で作成したロールのARNを設定してください。
    • <parameters>タグ内にデフォルトパラメータを指定してください。(モデル、デプロイ名など)