事前構築済みエージェント向けアプリの接続

事前構築済みエージェントは、データの取得、ワークフローの開始、レコードの更新などのアクションを実行するために外部アプリケーションに依存します。 アプリを接続すると、エージェントがそのアプリケーションのAPIを使用してタスクを完了できるようになります。

接続を設定する前に、アプリの統合ページを確認し、アプリケーションの認証情報の種類と設定要件を理解してください。

サポートされている認証方法

IBM watsonx Orchestrate 外部アプリケーションへの接続において、複数の認証方式に対応しています。 使用する方法は、対象アプリの要件に完全に依存します。

各認証タイプの詳細な説明については、 「認証タイプの概要」 を参照してください。

認証設定は、ドラフト環境と本番環境で個別に構成します。 一部のアプリでは、環境ごとに異なる認証タイプが必要です(例:開発環境では基本認証、本番環境ではAPIキー)。

一部のアプリでは、環境ごとに異なる認証方法やスコープが必要になる場合があります。 具体的な要件については、アプリの統合ページを参照してください。

アプリへの接続

以下の共通手順に従って、あらゆるアプリケーションの認証情報を追加してください:

  1. メインメニューから、 [管理 ] > [接続] に移動します。

  2. 接続したいアプリケーションを検索してください。

  3. 一致する項目の横にある「編集」 Connection IDをクリックしてください。

  4. 接続したいアプリケーションを選択してください。

注:

各アプリには固有の接続IDがあり、そのアプリの連携ページで確認できます。 一致する接続IDの横にある「編集」をクリックしてください。

  1. ドラフト環境を設定する。

    1. アプリケーションで要求される認証情報フィールド(例:ドメイン、APIキー、トークン、 OAuth の値、スコープなど)を入力してください。

    2. チーム認証情報を使用する場合は、 [接続] をクリックしてチーム全体のアクセスを有効にしてください。

    3. 保存 をクリックします。

  2. 本番環境を設定する。

    1. 本番環境向けの認証設定を再実行してください。

    2. 本番環境での使用には、チーム全体の認証情報の使用が推奨されます。

    3. チーム認証情報を使用する場合は、 [接続] をクリックしてチーム全体のアクセスを有効にしてください。

接続が確立されたことを示す成功メッセージが表示されます。

開発環境と本番環境

各アプリ接続にはドラフト環境と本番環境が含まれており、それぞれ個別に設定する必要があります。

  • ドラフト環境 :テストおよび検証に使用します。 本番環境に移行する前に、接続が正常に機能することを確認するため、リスクの低い資格情報またはテスト用の資格情報を入力してください。

  • 本番環境 :本番運用に使用する。 本番環境で使用可能な完全な認証情報を入力してください。 この環境が設定されるまで、エージェントはライブモードで実行できません。

次のタスク

  • サポートされているアプリのリストから、接続したいアプリケーションを探してください。

  • アプリの連携ページを開き、接続ID、必要な認証情報フィールド、および外部アプリでの設定内容を確認してください。

  • アプリが必要とする認証情報を収集します。これにはAPIキー、 OAuth 値、クライアントシークレットなどが含まれます。