メインコンテンツへスキップ
見出し画像

AIエージェントの設定:AI Agent Studio で有効化・起動のきっかけ・承認の有無を決める


    AI エージェントを導入する前に、管理者はどこで何を設定するのかを把握しておきたいところです。設定の置き場は、AI Agent Studio(AI エージェントスタジオ)の画面、sn_aia スコープのテーブル、システムプロパティの3か所に分かれています。本記事はその設定調査資料で、標準のエージェント型ワークフローを1件選び、有効状態・起動のきっかけ・実行ユーザー・承認の有無を、画面とテーブルの両方で照らし合わせました。

    検証環境:Now Assist デモ環境(Australia Patch 5)/ OOTB / 2026-10-01 確認

    画面で確かめた要点

    • AI Agent Studio の設定画面は、概要・作成と管理・テスト・アクティビティ・設定の5つのタブに分かれる

    • ワークフローのガイド付きセットアップは、要件、セキュリティコントロール、トリガー、チャネルの4区分で進む

    • ツールの実行モード(Supervised/Autonomous)の設定値は、AI エージェントのツール設定で確認できる

    • 標準のレコードは保護ポリシーが付き、画面は読み取り専用

    調べたのは、標準のワークフロー1件(プロジェクトタスクの監視)です。所属する AI エージェント2件を確認し、うち1件のツール設定を詳しく開きました。操作は、管理者による画面の閲覧と、REST の GET に限定しました。保存、有効化、テスト実行は行っていません。一般の利用者の画面と、起動したときの動作は、今回の調査範囲外です。

    調査の範囲と方法

    対象は、AI Agent Studio の画面と、関連する sn_aia スコープのテーブル・ロール・システムプロパティです。モデルの選択やプロンプトインジェクションの構成は Now Assist アドミンの画面にあるため、今回は設定ページに表示された内容だけを見ています。

    例にするワークフローは、トリガーを持つこと、ツールに自律の実行モードがあること、標準のレコードであることの3点で選びました。

    方法は次のとおりです。

    • テーブルの定義、ロール、ACL、プロパティ:REST の読み取り(GET)

    • 画面:AI Agent Studio の各タブと、ワークフローのガイド付きセットアップを閲覧

    • 公式の説明:ドキュメントの本文を開いて確かめたページだけを引用

    • デモ環境で追加されたレコード:個別の紹介から除外

    件数は、標準のワークフロー130件、エージェント446件、ツール1,972件です(2026-09-19 の集計値。デモ追加分と判定保留を除く)。総数はワークフロー188件、エージェント601件で、デモ追加分を含みます。

    モジュール構成

    AI Agent Studio は、ServiceNow Otto AI Agents(sn_aia)スコープのアプリケーションです。管理者が開くと、5つのタブが並びます。


    画像

    ①のタブが、AI Agent Studio の各画面への移動先です。

    • 概要:既製のソリューション(②)と自分のソリューション(③)を並べる。作成から展開までの4ステップのガイドも開ける

    • 作成と管理:エージェント型ワークフローと AI エージェントを一覧し、新規作成・複製・削除ができる

    • テスト:公式の説明では、エージェントとワークフローの手動テストと、アクセス制御のテストに使う画面

    • アクティビティ:実行ログを見る画面

    • 設定:ガーディアン、長期記憶、外部エージェント、MCP サーバー、モデルプロバイダーを確認する画面

    この環境では、概要の「既製のソリューション」の一覧が空で、「ライセンスの制限により、アクセスが制限されます」という案内が出ていました。標準のワークフローは、作成と管理の一覧から開けます。

    メニューの定義には、新しい画面(エージェント型ソリューション・ホーム・設定・アクティビティ)が4つ登録されています。この環境では無効で、開ける画面は有効な5つのタブです。

    ワークフロー・チーム・エージェント・ツール・トリガーの関係は、次の図のとおりです。


    画像

    図の内容を文字でも書き出します。

    • トリガー(レコードの作成・更新・UI アクション)が、エージェント型ワークフロー(sn_aia_usecase)を起動する

    • ワークフローはチーム(sn_aia_team)を持ち、チームの AI エージェント(sn_aia_agent)がツール(sn_aia_tool)を使う

    • ツールの実行モードは2つに分かれる。Supervised は人が承認してから実行、Autonomous はエージェントが選んだ時点で実行

    • 設定ページとシステムプロパティ(ガーディアン・長期記憶・外部エージェント・MCP)は、エージェントの挙動を決める

    • ロール(sn_aia.admin / worker_manager / viewer)は、ワークフローの権限を決める

    データモデル

    sn_aia スコープのテーブルは66個あります。設定で触る主な12テーブルは次のとおりです。

    • sn_aia_usecase(ユースケース):エージェント型ワークフロー本体。名前、説明、基本プラン(手順の一覧)、チーム、実行モードを持つ

    • sn_aia_team / sn_aia_team_member:ワークフローに入れるエージェントの組。1チームに複数のエージェントを入れられる

    • sn_aia_agent(AI エージェント):役割、指示、エージェントタイプ(AI Agent/External/Omni/AI Phone Agent)、チャネル(NAP/NAP and VA)を持つ

    • sn_aia_agent_config:有効状態(active)、実行ユーザー(run_as_user)、外部検出可能(public)。エージェントの有効状態をここで確認できる

    • sn_aia_tool:ツール本体。種類は Script、Flow Action、Subflow、Model Context Protocol、Capability(生成 AI スキル)、Record Operation など

    • sn_aia_agent_tool_m2m:エージェントとツールの対応。実行モード、最大自動実行数(辞書の既定値10)、タイムアウト、表示モードを持つ

    • sn_aia_trigger_configuration:トリガー。対象テーブル、条件、実行方法、トリガー戦略、チャネルを持つ

    • sn_aia_usecase_config_override / sn_aia_trigger_config_override:ワークフローとトリガーの有効状態の上書き

    • sn_aia_version:版の管理。状態は Draft、Committed、Published、Withdrawn

    • sn_aia_execution_plan:実行履歴。アクティビティ画面に表示される実行の記録

    ワークフローの実行モードの項目名は「実行モード(ツールの上書き)」で、ワークフロー単位の値がツール単位の値を上書きする用途の項目だと、項目名から分かります。

    トリガーのユースケース項目とビジネスルール項目には、「使用廃止」のラベルが付いています。トリガーとワークフローの対応を持つテーブルは sn_aia_trigger_agent_usecase_m2m ですが、API ユーザーでは読み取れませんでした。

    トリガー戦略の選択肢は、内部値とラベルの対応で確認できます。

    • once:1 回

    • unique_changes:それぞれ一意の変更の場合

    • always:現在実行されていない場合のみ(英語ラベルは Only if not currently running)

    • every:更新ごと

    再実行の細かい条件は、今回の調査範囲外です。

    画面

    作成と管理の一覧

    エージェント型ワークフローの一覧には、名前・説明・AI エージェント数・チーム・基本プラン・モデルサポートの列が並びます。名前を選ぶと、ガイド付きセットアップが開きます。


    画像

    ①のタブで「エージェント型ワークフロー」と「AI エージェント」を切り替えます。

    ②の件数は、登録済みのワークフロー総数(デモ追加分を含む)です。③の「新規」から、新しいワークフローを作れます。

    AI エージェントのタブは、今回の管理者アカウントで「リストをロードできません」と表示されました。

    ガイド付きセットアップの構成

    ワークフローの名前を開くと、左側に次の項目が並びます。

    • 主要な要件を定義

    • セキュリティコントロールを定義(配下にユーザーアクセスの定義、データアクセスの定義)

    • トリガーを追加

    • チャネルとステータスを選択

    ワークフローを使える状態にするための設定項目が、この順に並んでいます。

    主要な要件の画面では、ワークフロー名・説明・ステップのリスト・LLM への指示を確認できます。画面には、大規模言語モデル(LLM)が説明とステップを読んで、各ステップを担う AI エージェントを選ぶという説明があります。

    「AI エージェントを追加」の表には、ワークフローに入るエージェントと、有効状態の列が並びます。


    画像

    ①のとおり、プロジェクトタスクの監視には2つの AI エージェントが入っています。

    ②の列には、エージェントが使うツールの名前が出ます。エージェント単位の有効状態は、③のアクティブで確かめられます。

    トリガーとチャネル

    トリガーの画面には、名前・種類・対象テーブル・条件・実行方法・チャネル・ステータスの列が並びます。


    画像

    標準のトリガー(Project task Update Monitoring)は、pm_project_task の更新(種類 Updated)を契機にします。①がトリガー名、②が対象テーブルと条件です。

    条件の全文は REST で取得でき、ステータスが赤であることや、アサイン先が空でないことなどの組み合わせです。画面の実行方法は assigned_to で、REST の run_as_user は AI ユーザーでした。

    ③のステータスは、この環境で Inactive と表示されました。テーブルの active は true で、画面との違いが残っています。

    有効化の手順は、公式に次のとおり書かれています。

    Agentic workflows that are installed with AI applications aren't automatically activated. You must activate them before they can be used in the ServiceNow Otto panel or as a UI action. Some may come with predefined triggers that must be set to active, too.

    (訳:AI アプリと一緒にインストールされるエージェント型ワークフローは、自動では有効にならない。ServiceNow Otto パネルや UI アクションで使う前に、有効化が必要。事前定義のトリガーも、有効にしなければならないものがある)

    引用元:Activate an agentic workflow template

    止める手順は、Deactivate an agentic AI assetにあります。

    チャネルの画面では、ワークフローを使える場所を確認できます。選択の手順は、公式のSelect channels for an agentic workflowにあります。


    画像

    ①の Now Assist パネルは、利用者がパネルにメッセージを送ると、ワークフローが選ばれて応答が返る経路です。

    ②の仮想エージェントは、仮想エージェントの会話に AI エージェントの出力を表示する経路です。画面には、保存するとアシスタントデザイナーで有効化するという説明があり、下部に「保存してテスト」のボタンが付いています。

    アクティビティ

    アクティビティは、ワークフローとエージェントの実行ログを見る画面です。状況(完了・進行中・failed・中断)、作成者、実行タイプの集計の下に、すべての実行の一覧が並びます。


    画像

    ①のプルダウンで、集計の見方を切り替えます。状況の内訳は②の円グラフ、状況の種類は③の凡例で確かめられます。集計は、デモ環境の全実行(デモ追加分を含む)が対象です。

    一覧の列は、作成日時・作成者・状況・理由の説明・実行タイプ・ワークフロー・エージェント・達成目標・バージョンです。失敗した実行をバージョン別に絞り込む用途に使えます。

    ロジックと自動化

    起動経路

    本記事で扱う起動経路は、ServiceNow Otto パネルでの依頼、レコードの作成・更新を条件にするトリガー、UI アクションの3種類です。

    標準のトリガー55件の実装は、次の4種類に分かれます。パネルだけで使うワークフローには、トリガーを付けなくて構いません。

    • record_create:18件

    • record_create_or_update:23件

    • record_update:10件

    • ui_action:4件

    トリガーの追加手順は、公式のAdd a trigger to an agentic workflowに書かれています。

    ツールの実行モードと承認

    公式の説明では、承認の有無は、AI エージェントに付けたツールごとの実行モードで決まります。

    Supervised — The agent pauses and asks a person to approve the action before the tool runs. [...] Use it for anything that writes, deletes, contacts a customer, or spends budget.

    (訳:Supervised は、ツールの実行前にエージェントが止まり、人に承認を求める。書き込み、削除、顧客への連絡、予算の支出を伴うものに使う)

    引用元:Add tools and information to an AI agent

    標準のエージェント×ツールの対応1,806件のうち、Autonomous(自律)は1,764件、Supervised(監視)は42件です。書き込みを伴うツールの実行モードは、ツール一覧で1件ずつ照合できます。


    画像

    今回の AI エージェントでは、①のツール「Generates the project summary」の実行モードが、②のとおり「自律」でした。③の「出力を表示」は false です。

    このエージェントのツール設定の画面には、ツールの追加ボタン、推奨ツールの提案依頼、子 AI エージェントの追加の領域が表示されています。標準のレコードは保護ポリシーが付いているため、これらは閲覧だけにとどめました。

    ワークフローの実行モードとの関係


    画像

    図の内容を文字でも書き出します。

    • ワークフロー(標準130件):Supervised 123件、Autonomous 3件、空 4件

    • ツールの対応(標準1,806件):Autonomous 1,764件、Supervised 42件

    • 上書きのプロパティ sn_aia.enable_usecase_tool_execution_mode_override は false。対象は Autonomous のワークフローだけ

    • 今回のワークフローは Supervised、ツールは自律で、上書きの対象に当たらない

    上書きの動きを決めるシステムプロパティは、次の1件です。

    • sn_aia.enable_usecase_tool_execution_mode_override(調査環境の取得値は false):説明文は「ユースケースを『完全』に自律的に実行できるようにします。true に設定すると、『自律』実行モードのユースケースによって、ユースケースに含まれるすべてのエージェントのツールの実行モード設定が上書きされます」

    説明文の対象は、「自律」実行モードのユースケースです。今回のワークフローは Supervised のため、この上書きの対象に当たりません。ワークフロー単位の値と、実行時の承認の関係は、画面の値だけでは確定できません。

    システムプロパティ

    sn_aia の名前を持つプロパティは83件で、67件に説明が付いています。挙動に関わる主な項目は次のとおりです。

    • sn_aia.maximum_agent_tools(20):1つのエージェントに関連付けられるツール数の上限

    • sn_aia.enable_mcp_tool(true):Studio から MCP ツールを追加できるか

    • sn_aia.enable_deep_research_tool(false):Deep Research ツールを追加できるか

    • sn_aia.enable_trigger_AI_user(false):トリガーの実行ユーザーに AI ユーザーを選べるか

    • sn_aia.agent_strategy_choice_enabled(false):セットアップ画面に LLM の推論戦略を表示するか

    • sn_aia.enable_conversational_debugger(false):テスト画面に分析ボタンを表示するか

    • sn_aia.continuous_tool_execution_limit(25):同じツールの連続実行の上限

    • sn_aia.max_scheduled_trigger_query(10):スケジュールトリガーの対象レコード取得の上限

    • sn_aia.type_2_disamb(off):あいまいな質問への確認質問の頻度

    • sn_aia.enable_follow_up(true):完了後のフォローアップで会話を続けられるか

    権限

    ロール

    sn_aia スコープのロールは次の4つで、説明文はロールの定義にある記述です。

    • sn_aia.admin:Can access and update Autonomous AI Assistant tables(自律型 AI アシスタントのテーブルを参照・更新できる)

    • sn_aia.worker_manager:Can access and update AIA workers(AIA ワーカーを参照・更新できる)。トリガーの read/write/create の ACL を持つ

    • sn_aia.viewer:Read-only role for Agent Studio viewers(Agent Studio の読み取り専用)

    • sn_aia.integration:Role for Run As users(Run As ユーザー用)

    ロールの包含を調べると、sn_aia.admin は sn_aia.worker_manager と sn_aia.viewer を含みます。

    ほかに含むのは、user_admin・flow_designer・connection_admin・sn_mcp_client.admin です。sn_aia.admin の付与範囲は、この包含で確認できます。


    画像

    図の内容を文字でも書き出します。

    • sn_aia.admin が含む sn_aia のロール:worker_manager(AIA ワーカーの更新、トリガーの ACL)、viewer(読み取り専用)

    • 含む他アプリのロール:user_admin、flow_designer、connection_admin、sn_mcp_client.admin

    • sn_aia.integration(Run As ユーザー用)は、この包含に出てこない

    公式のConfigure AI Agent Studio settingsでは、設定ページの変更に sn_aia.admin が必要と書かれています。

    ワークフロー・エージェント・ツールの主要テーブルでは、読み取りの ACL に sn_aia.viewer と sn_aia.admin が付いています。書き込み・作成・削除の ACL は sn_aia.admin です。maint ロールや、個別アプリのロールが付くテーブルもあります。

    実行履歴(sn_aia_execution_plan)の読み取りの ACL には、itil ロールも含まれていました。

    ワークフローごとのアクセス制御

    ガイド付きセットアップの「セキュリティコントロールを定義」では、ワークフローを使える利用者と、実行ユーザーを確認できます。


    画像

    ①の決定タイプは「次の場合に許可」、②のロールは project_manager です。画面には、選択内容を保存すると ACL が自動的に生成されるという説明があります。


    画像

    データアクセスの画面では、ワークフローを実行するユーザー ID を確認できます。

    ①のタイプは AI ユーザーです。このワークフローには、ppm.ai_project_manager_agent という専用のユーザーが設定されています。

    ③には、agent_workspace_user・cmdb_read・demand_manager・financial_mgmt_user など、AI ユーザーに付いた多数のロールが並びます。

    ②の警告は、一般ユーザーに AI ユーザーの代理操作を許可すると、アクセスできるデータに関する権限が昇格すると伝えています。

    公式の説明では、ACL の Run As で、動的ユーザーまたは AI ユーザーとして実行できます。引用元:ITSM の AI エージェントに関する留意事項

    連携

    設定ページ

    設定ページは、AI Agent Studio 全体の挙動を確認する画面です。公式のConfigure AI Agent Studio settingsにも、ガーディアン・長期記憶・外部 AI エージェント・MCP サーバー・モデルプロバイダーの順に設定する手順があります。


    画像

    ①のメニューが設定の5項目です。各項目の確認内容は次のとおりです。

    • Now Assist ガーディアン:攻撃性の検出はオン(②。すべての AI エージェントが対象)。検出影響はログのみ(③)。プロンプトインジェクションはグローバル設定で、Now Assist アドミンの画面で構成

    • 長期記憶:ユーザー情報の保持、知識の応用、LLM によるメモリのカテゴリ分け、過去の実行結果からの学習が、すべて「はい」。画面の説明は、ユーザーの知識を使って質問を繰り返さないようにする、という内容

    • 外部の AI エージェント:A2A プロトコルでの連携。外部エージェントへのアクセス許可はオン、サードパーティへの許可もオン、通信モードは Synchronous

    • MCP サーバーの管理:MCP サーバーを追加して外部のツールとデータにつなぐ。登録は7件

    • モデルプロバイダー:エージェント型ワークフローと AI エージェントすべてが使う LLM のプロバイダー。この環境は Azure OpenAI で、構成は Now Assist アドミンの画面

    ツールの連携先

    標準のツール1,972件の種類別の内訳は、Script が1,159件、Flow Action が481件、Subflow が95件です。Model Context Protocol が86件、Capability(Now Assist スキル)が62件で、残りは Topic などの少数の種類です。

    ツールの種類と、個別ツールの呼び出し先は、sn_aia_tool の一覧で確認できます。

    チャネルの設定は、標準のエージェント446件のうち、ServiceNow Otto パネルだけが79件です。パネルと仮想エージェント(VA)の両方が259件で、空欄が108件あります。

    所見と未確認事項

    実機で気づいたこと

    ツール実行モードと承認

    ワークフローは Supervised で、ツールは自律の設定でした。標準のエージェント×ツールの対応では、Supervised は42件です。書き込みを伴うツールの扱いは、公式の説明どおりツール単位の実行モードで確認します。

    有効状態の確認箇所

    有効状態は、エージェントが sn_aia_agent_config、ワークフローが上書きテーブル、トリガーがトリガー自身と上書きテーブルに分かれます。今回のトリガーは、テーブルの値が true で、画面は Inactive でした。画面のステータスと、テーブルの値の両方を照合します。


    画像

    起点は今回のワークフローの3つの部品、緑は確認した値、橙は画面とテーブルが食い違った箇所、灰色は画面では変更できない箇所

    図の内容を文字でも書き出します。

    • ワークフロー:画面は保護ポリシーで読み取り専用。テーブルは sn_aia_usecase_config_override で、今回のワークフローは true

    • AI エージェント:画面は「AI エージェントを追加」表のアクティブ列で、2件ともアクティブ。テーブルは sn_aia_agent_config の active

    • トリガー:画面のステータスは Inactive。テーブルは sn_aia_trigger_configuration の active が true で、上書きテーブル sn_aia_trigger_config_override に該当行なし

    実行ユーザーとデータアクセス

    ワークフローの利用者は ACL で絞れます。実行時の実行ユーザーは、データアクセスの画面で AI ユーザーとそのロールとして確認できます。

    未確認のこと

    • 一般の利用者のロールで見える画面と、起動したときの動作

    • ワークフローとトリガーの対応テーブル(sn_aia_trigger_agent_usecase_m2m)の中身

    • トリガーが、テーブルの値は true で、画面は Inactive になる理由

    • AI エージェントのタブが読み込めなかった原因

    • テストの画面、外部エージェントのデータアクセス、MCP サーバーの個別設定

    • 上書きの行がない標準ワークフロー53件の有効状態

    • ワークフロー単位の実行モードが、実行時に承認へどう影響するか

    • トリガー戦略ごとの再実行の細かい条件

    デモ環境で追加されたワークフロー、エージェント、トリガーは、個別の紹介から除外しました。

    付録:引用した公式説明と確認URL

    公式ドキュメントは、2026-10-01 に本文を開いて確かめた次のページです(Australia 版)。

    実機で同じ内容を確かめるときは、次の URL を自分のインスタンスで開きます。

    • AI Agent Studio:/now/agent-studio/overview、/now/agent-studio/create-manage/、/now/agent-studio/activity、/now/agent-studio/settings

    • ワークフロー:/sn_aia_usecase_list.do

    • エージェントとツールの対応:/sn_aia_agent_tool_m2m_list.do

    • トリガー:/sn_aia_trigger_configuration_list.do

    • ロール:/sys_user_role_list.do?sysparm_query=nameSTARTSWITHsn_aia

    • システムプロパティ:/sys_properties_list.do?sysparm_query=nameSTARTSWITHsn_aia.

    関連記事

     
     
    ServiceNowのPDI(Personal Developer Instance)を実機で観察して、Noteに記事を書いています 実装・運用・教育の現場視点で淡々と記録中です リクエストがあればその記事も書きます 個人の観察日記です

    あなたへのおすすめ