# 【アップデート版】Agent Builder機能について ## Agent Builderとは？ \ AIエージェントは簡単な指示や外部連携を通じて、LLMの知識だけでは直接回答・実行できない作業を、ユーザーのクエリに応じて実行することが可能です。\ そのように機能するAIエージェントを皆様に作成頂けるのがこのAgent Builder機能です。\ \ AlliのAgentBuilder機能内にはMCP（Model Context Protocol）サーバーおよびツールの連携がサポートされており、様々なMCPツールやAlliに搭載されている回答生成機能・検索機能、Alli内で作成したSingle Actionアプリからツールを組み合わせ、オリジナルのAIエージェントを作成することができます。\ 作成後はアプリと同じユーザーインターフェースから利用可能です。\ ユーザーのクエリの意図をAIエージェントが判断し、適切なツールを実行します。 ## エージェント/エージェントアプリを作成する ### 新規作成 1. アプリ管理＞「新しいアプリを作成」をクリックします。 2. 「新しいエージェントを作成」をクリックします。クリックするとエージェント作成ページに移動します。

### 作成画面について

#### 1.アプリ情報既存のアプリと同様にアプリの名前・説明・アイコンが設定できます。\ 設定した内容は管理画面およびWorksに反映されます #### 2.LLMモデルとインストラクション 1. LLMモデル 1. エージェント利用するモデルを選択します。\ モデルは「recommend」が付いているモデルから選択してください。 2. インストラクション 1. AIエージェントに与えるインストラクション（システムプロンプト）を入力します。\ ペルソナ・役割を与え、AIエージェントとしてふるまうための具体的な指示を記載します。\ 変数をインストラクション内に記載する場合は{変数名}の形で記載を行ってください。 3. 変数 AIエージェントに変数を利用させる場合、利用する変数を指定します。\ 「変数の追加」ボタンをクリックすると、アプリ実行時に各変数へ代入する値の入力を求めることや、Alliに登録済みのシステム変数の値を利用することが可能です。\

1. **メンバーに入力してもらう変数を追加**\ 設定するとアプリ開始時に入力フォームを設けることが可能です。\ 名前の欄に変数名、ラベルに項目名を記入してください。

\ ※「メンバーに入力してもらう変数」に[システム変数](https://docs.allganize.ai/alli_for_llm/project-settings/variables/sdk-variables-system-variables)として登録済みの変数を設定することはできません。\ 保存時にエラー表示が表示されます。
2. **変数を追加**\ Alliに登録済みの任意の変数内の情報をインプットとして利用したい場合は、名前の欄に変数名を設定してください。

{% hint style="info" %} 変数を追加で追加できる変数は「文字列」「数字」タイプの変数のみです。(2025年11月現在） {% endhint %}

#### 3.ツールを統合 MCPサーバーを連携し、ツール（MCP Tool）を追加することができます。\ このツールがエージェントが実行できる一つ一つのタスクとなります。\ ウェブ検索などの単純なツールから、各種サードパーティサービスのMCPサーバー連携を通じて、タスクを実行します。「＋追加」ボタンを押すと、プロジェクトごとに連携されたMCPサーバーおよびツールを確認できます。\ 必要なツールを選択し、エージェントに追加します。

ツールは一つのエージェント内で複数選択可能です。必要なツールを追加してください。

{% hint style="info" %} 必要なツールが見つからない場合は、カスタマーサクセス担当者までお問い合わせください。 {% endhint %} 追加後、下記のようにサーバー、ツール別に連携・ツール設定ボタンを押し、連携に必要な情報や詳細なargument（引数）値を入力します。

ツールのargument（引数）は、一般的にAIエージェントがユーザーの質問および把握したコンテキストに基づき、自動的に入力されます。\ ユーザーが直接入力する場合は例外的な状況とみなされ、その値が常に実行される上書き（override）方式でインプットが入力されます。 1. 連携

をクリックした場合\ 必要なAPIキーの入力などを行ってください。

2. ツール設定

をクリックした場合

#### 4.会話フロー会話開始時のメッセージ、モデルの呼び出しが失敗した際のメッセージ、変数の入力リクエストメッセージを指定できます。 {% hint style="info" %} 変数の入力リクエストは、「メンバーに入力してもらう変数を追加」を選択した場合にのみ使用されます {% endhint %} #### 5.プレビューを開始右側のプレビュー領域でアプリ内容を実行することが可能です。必須入力項目がすべて入力されると「プレビューを開始」ボタンが有効になります。その後、内容に変更が生じると、「プレビューを更新」ボタンに変更され、更新された内容に基づき再度プレビューを実行できます。 ## 作成したエージェントをアプリ形式で公開する構築したエージェントタイプのアプリを公開し、Alli Worksで使用できます。\ 他のアプリと同様に、アクセス権を設定して公開します。

## 応用編：カンバセーションアプリ内の選択肢として公開するアプリ形式での公開だけでなく、アプリとしては公開せず、カンバセーションアプリ内の一つのツールとして作成したAIエージェントを公開することも可能です。\ エージェント機能と他のノードを組み合わせたより複雑なアプリを作成したい場合等は、この機能をご利用ください。 #### エージェントリストに保存する

三点リーダーボタンを押した後、「エージェントのみ公開」を選択します。\ この場合、アプリとしては公開されず、構築したエージェントは対話型アプリのLLM実行ノードでのみ使用できます。「アプリを公開する」を選択した場合でも、LLM実行ノードでも同様に作成したAIエージェントを使用できます。\ 一方で「エージェントのみ公開」を選択した場合は、アプリがWorks上に公開されません。\ \ 保存したAIエージェントは、LLM実行から選択することができます。

## AIエージェントのバージョン管理右上隅で過去に保存または「公開」したバージョン履歴を確認し、各バージョンを編集および公開することができます。\ 各バージョンごとにプレビューがサポートされています。公開されたバージョンはそのままにして、新しいバージョンを作成/編集できます。過去の特定バージョンまたは現在編集中の「Current」を選択後、「公開」を選択すると、既存のアプリをドラフトの状態に変更せずに公開することができます。

## アプリのステータスを変更するアプリ管理ページでアプリ同様エージェントもドラフトに変更できます。\ ドラフトに変更されたアプリはAlli Works上でも公開されなくなり、LLM実行ノードのエージェントリストにも公開されません。

## 応用編：エージェントビルダーページからドラフトに変更するエージェントビルダーページ内でも、現在公開されているバージョンを選択すると、アプリとエージェントのステータスをドラフトに変更できます。アプリ形式で保存したエージェントがドラフトの場合はWorksに公開されず、ユーザーがアクセスできません。\ エージェントのみで公開したエージェントがドラフトの場合、LLM実行ノードに公開されず、使用できません。他のバージョンは公開することができるため、現在公開されているバージョンにアクセスする場合にのみ「ドラフトに戻す」ボタンが公開されます。

他のconversationアプリでエージェントが使用されている場合、該当のエージェントをドラフトに戻すことはできません。\ ただし、以下のように**アプリのみを**ドラフトに変更することは可能です。上記と同様に、現在公開されているバージョンにアクセスしている場合のみ、このオプションは適用されます。