手動統合で外部 AI エージェントを作成

  • リリースバージョン: Zurich
  • 更新日 2025年07月28日
  • 所要時間：5分

    • エージェントワークフローで使用する AI エージェントスタジオ にサードパーティエージェントを手動で統合して、外部 AI エージェントを作成します。

    始める前に

    必要なロール:sn_aia.admin

    手順

    1. 移動先 すべて > AI エージェントスタジオ > 作成と管理 > AI エージェント.
    2. 選択 新規 > 外部.
    3. 手動統合方法を選択します。
    4. [プロバイダーを接続] ステップで、フォームフィールドに入力して AI エージェントに接続します。
      1. [プロバイダーの詳細を入力 (Enter details about the provider)] セクションで、外部 AI エージェントのエイリアスとサブフローを選択します。

        エイリアスはエージェント AI プロバイダーを指し、認証トークンを含める必要があります。[ 新しいエイリアスの作成] を選択すると、エイリアスを作成できます。レコードが作成されたら、ガイド付きセットアップを更新するか、再度開始して、新しいオプションを表示できます。

        API typeはサブフローです。プロバイダーに一致するサブフローを選択します。[新しいサブフローの作成] を選択して、独自のサブフローを作成できます。

      2. [外部 AI エージェントに関する初期詳細を入力 (Enter initial details about the external AI agent)] セクションで、フィールドに入力します。
        表 : 1. [外部 AI エージェントセクションに関する初期詳細を入力] フォームのフィールド

        名前

        説明

        エージェント ID

        エージェント AI プロバイダーに応じたエージェントの一意の識別子。

        メタデータ

        AI エージェントが使用する model など、AI エージェントが機能するために必要なフィールドを含む構造化 JSON。

        通信モード

        同期 (リアルタイム) または非同期 (遅延を許容) のいずれかです。

        応答を分析

        「true」または「false」と入力します。

      [ 保存して続行 ] を選択して、次の手順に進みます。

      プロバイダーのガイド付きセットアップステップを接続

    5. [差別化と定義] ステップで、AI エージェントに関する詳細を追加して、エージェントワークフローでエージェントを利用する方法のコンテキストを AI エージェントオーケストレーターに提供します。
      1. [AI エージェントの説明] セクションで、外部 AI エージェントの名前と説明を追加します。

        名前と説明フィールドは、AI エージェントを使用するタイミングを決定するために AI エージェントオーケストレーターによって使用されます。説明が徹底的であればあるほど、AI エージェントがエージェントワークフロー内で正しく使用される可能性が高くなります。

        [Now Assist を使用] を選択すると、名前、説明、AI エージェントロール、および指示フィールドのコンテンツを生成できます。これらのフィールドが生成された後でも変更を加えることができます。

      2. [AI エージェントに指示する (Instruct the AI agent)] セクションで、AI エージェントのロールと指示を追加します。

        これらのフィールドは、AI エージェントオーケストレーターがワークフロー内で目的を果たすために必要な機能と手順を理解するのに役立つコンテキストを提供します。詳細なロールと指示情報により、より効果的な AI エージェントが作成されます。AI エージェントのロールと指示を記述するための提案については、「AI エージェントとエージェントワークフローを作成するための一般的なガイドライン」を参照してください

      3. AI エージェントのアクセス制御リスト (ACL) を構成します。
        注:
        ACL は、AI エージェントを検出して実行するためのアクセス権を持つユーザーを決定します。AI エージェントスタジオで作成できる ACL の詳細と、より高度なセキュリティ構成を追加する方法については、「AI エージェントにセキュリティのためのアクセス制御を実装する」を参照してください。

        これは必須の手順です。以前に ACL を作成せずに AI エージェントを構成したことがある場合は、他の変更を加える前に ACL を生成する必要があります。

        表 : 2. AI エージェントにアクセスできるユーザーを定義します
        フィールド 説明
        ユーザーアクセス AI エージェントへのアクセスが次のオプションによって定義されるユーザーのタイプ:
        • 任意の認証済みユーザー:ログインしているすべてのユーザーが AI エージェントにアクセスできます。
        • 特定のロールを持つユーザー:アサインされたロールの少なくとも 1 つを持つユーザーが、AI エージェントにアクセスできます。これはデフォルトのオプションです。
          注:
          ユーザーが AI エージェントにアクセスできない場合、またはユーザーがそれぞれのエージェントワークフロー実行で少なくとも 1 つの AI エージェントにアクセスできない場合は、最初の AI エージェントが開始される前に実行全体が中止されます。
        • 公開:ログインしなくても、すべてのユーザーが AI エージェントにアクセスできます。このオプションは、ゲストが AI エージェントにアクセスできるようにする場合にのみ使用します。
        ロール ドロップダウンから 1 つ以上の特定のロールをアサインします。
        注:
        ロールの選択は、[ 特定のロールを持つユーザー (Users with specific roles user access)] を選択した場合にのみ可能です。

      専門ステップの定義

    6. [表示を選択] ステップで、AI エージェントを表示する場所と、AI エージェントの実行時にユーザーに表示するメッセージを選択します。
      1. AI エージェントの可用性を選択します。
        正しいロールを持つユーザーが AI エージェントを利用できるようにするには、 Status をアクティブに設定します。
      2. AI エージェントの実行時にユーザーに表示する処理メッセージを選択します。
        たとえば、 Initiating AI agent 、 Processing record details、 An AI agent is looking into the requestなどです。

      表示ステップを選択

    7. [保存してテスト] を選択して AI エージェントの詳細を保存し、AI エージェントスタジオ の [テスト] ページに移動します。

    タスクの結果

    外部 AI エージェントは ServiceNow に接続されており、エージェントワークフローで使用できます。

    次のタスク

    AI エージェントをテストしたり、新規または既存のエージェントワークフローに追加したりできます。