1. AI Agent Studioの使用方法
  2. AI Agent Studio用のMicrosoft Teamsチャネルの作成
機械翻訳について

AI Agent Studio用のMicrosoft Teamsチャネルの作成

Microsoft TeamsをAI Agent Studioと統合し、ユーザーがMicrosoft TeamsからOracle AIエージェントにアクセスできるようにします。 統合により、Oracle Fusion Cloud ApplicationsおよびMicrosoftアカウント間でユーザーIDとデータ・セキュリティが保持されます。 統合後、ユーザーはMicrosoft Teamsで「Oracleに問い合せる」アプリケーションを選択し、使用可能なAIエージェントと対話できます。

Microsoft Teamsとの統合には、Microsoft Entra (Azure Active Directory)、Microsoft Bot Framework、Teamsアプリケーション・マニフェストなど、複数のMicrosoft 365サービスの構成が含まれます。 これらのコンポーネントは密接に相互に依存しており、環境およびテナント間で正しく構成する必要があります。 アイデンティティ・フロー、マニフェスト・パッケージング、チャネル登録、許可範囲指定およびエンドポイント・エクスポージャには、適切な調整とバージョン管理が不可欠です。

Microsoft TeamsでAsk Oracleを設定するステップは、次のとおりです。
  1. Microsoft Entra (Azure Active Directory)にAzureボットを登録します。 登録後にボットID、パスワードおよびテナントIDを保存してください。
  2. AI Agent StudioでMicrosoft Teamsのマニフェスト・ファイルを作成し、ダウンロードします。
  3. Microsoft TeamsのAI Agent Studioからダウンロードしたマニフェスト・ファイルをアップロードします。

Microsoft EntraでAzureボットを登録

  1. Azure/Exchange管理者として、Microsoft Azureポータルにサインインします。

  2. 「リソースの作成」をクリックし、「Azure Bot」を検索します。
  3. 次の詳細を追加してボットを作成します:
    • 一意のボット・ハンドルを入力します。
    • アクティブなサブスクリプションを選択します。
    • 既存のリソース・グループを選択するか、作成します。 「アプリケーションのタイプ」で、「単一テナント」を選択します。
    • 「作成タイプ」として「新規MicrosoftアプリケーションIDの作成」を選択します。
  4. 「次へ」をクリックして、ボットを作成します。
  5. デプロイメントが完了したら、「リソースに移動」をクリックします。

  6. 「メッセージング・エンドポイント」にボット・サービスのURLを入力します。 URLは次のパターンになります: 

    https://<pod name>/api/fusion-ai/orchestrator/collabTools/v1/teams-message

    <pod name>を、Oracleアプリケーション環境のベースURLに置き換えます。

    ノート: AI Agent Studioでマニフェスト・ファイルを作成するときに必要になるため、アプリケーションIDおよびテナントIDをノートにとります。
  7. クライアント・シークレットを生成します:
    1. 「MicrosoftアプリケーションID」の横にある「パスワードの管理」をクリックし、新しいクライアント・シークレットを作成します。
    2. 説明(Oracle Agents Secretなど)を指定し、必要な有効期限を選択します。
      ノート: AI Agent Studioでマニフェスト・ファイルを作成するときに必要になるため、クライアント・シークレットをノートにとります。
  8. アプリケーション権限の構成:
    1. 左側のパネルから、「API権限」を開きます。
    2. 「権限の追加」→「Microsoft Graph」→「アプリケーション権限」に移動します。
    3. 「ユーザー」フォルダで、User.ReadBasic.Allを検索して追加します。

    4. 追加した権限に対して「管理者同意の付与」をクリックします。

  9. 委任権限の構成:
    1. 左側のパネルから、「API権限」を開きます。
    2. 「権限の追加」→「Microsoft Graph」→「権限の委任」に移動します。
    3. 「ユーザー」フォルダで、User.ReadBasic.Allを検索して追加します。

    4. 追加した権限に対して「管理者同意の付与」をクリックします。

  10. Microsoft Teamsチャネルを有効にします。
    1. ボット・リソースに戻り、左側のパネルから「チャネル」を開きます。
    2. Microsoft Teamsチャネルを選択し、条件に同意して、「適用」をクリックします。

AI Agent Studioでのマニフェスト・ファイルの作成

前提条件: ロールに必要な権限グループがあることを確認してください。 詳細は、AI Agent Studioのアクセス要件の資格証明でチャネルを使用するための権限グループの割当てを参照してください。

  1. AI Agent Studioで、「資格証明」タブに移動し、「チャネル」タブを開きます。
  2. Microsoft Teamsを構成します。
  3. チャネルマニフェストファイルの詳細を入力します。
    • 短いマニフェスト名: Microsoft Teamsに表示されるアプリケーションの短縮名を入力します。 デフォルト値は「Oracleに問い合せる」です。
    • Full Manifest Name: Microsoft Teamsに表示されるアプリのフルネームを入力します。 たとえば、Oracle Fusion Agentに問い合せます。
    • マニフェスト・コード: AI Agent Studioで使用する一意のIDを入力します(Microsoft Teamsスキーマの一部ではありません)。 たとえば、b3e4a289-7cbb-43d3-9a4c-d52bc874e830
    • バージョン: マニフェスト・スキーマのバージョンを選択します。
    • マニフェスト・スキーマ・バージョン: マニフェスト・ファイルに使用するMicrosoftスキーマ・バージョンを選択します。
    • Oracle Instance URL: Fusion Applications用のOracleテナントのURLを入力します。
      書式は次のとおりです 
      https://<fully qualified pod name>:<optional port>
      テナントごとに個別のマニフェストを作成します。
    • ボットIDまたはアプリケーションID: Azureボットの設定中に生成されたアプリケーションIDを入力します。
    • Tenant: Azureボットの設定中に生成されたテナントIDを入力します。
    • シークレット: Azureボットの設定中に生成されたクライアント・シークレットを入力します。
    • 詳細設定: ボットがアクセスまたはリダイレクトできる有効なドメインまたはWebサイトのリスト。 すべてのAPIまたはアイデンティティ関連のエンドポイントを含めます。
      ノート:完全修飾ポッド名を含むtoken.botframework.comを追加する必要があります。
  4. マニフェスト・ファイルを作成します。
  5. 「編集」を選択して、Microsoft Teamsで使用するマニフェスト・ファイルをダウンロードします。

Microsoft Teamsコンソールでのボット・アーティファクトのアップロード

  1. 管理者として、Microsoft Teams管理センターに移動します。
  2. 「アプリケーションの管理」を開き、「アクション」メニューから「新規アプリケーションのアップロード」を選択します。
  3. AI Agent Studioからダウンロードしたマニフェスト・ファイルをアップロードします。
  4. アプリケーションを公開します。 これで、使用可能なアプリのリストにアプリが表示されます。
  5. 「アプリケーションの管理」で、「ポリシーの設定」→「組織全体のポリシー」に移動して、公開したアプリケーションを追加します。

これで、このアプリはOrg Wide Policyに含まれるすべてのユーザーが使用できるようになります。