AIエージェントの理解

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

1. 要約

AIエージェントは、Agentic AIテクノロジーを利用し、シンプルな指示でタスクを自動化できます。AIの動作方法を記述し、必要なDeluge関数（スクリプトを含む）を追加することでエージェントを作成します。定義した通りに、エージェントがタスクを順に計画・実行し、状況を分析して意思決定を行います。

2. 利用可能性

AIエージェント:

すべてのプランで作成・管理でき、API呼び出し制限は契約プランによって異なります
スーパ管理者および管理者のみ作成・管理が可能で、他のユーザーは実行のみ可能です

3. 概要

AIエージェントは、意思決定や状況分析、処理を自律的に実行し、人手を介さずに複雑なタスクを複数処理できる特化型AI機能です。従来のワークフローと異なり、AIエージェントは状況を動的に分析し、最適な操作方法を選択・適用でき、固定的なルールに従うだけではなく柔軟に対応します。

Zoho Creatorでは、AIエージェントに対して自然言語でスキルを定義し、必要なツール（Deluge関数など）を指定できます。その後、自動的にエンドポイントURLが作成され、このURLを呼び出してエージェントを利用し、必要なタスクを実行できます。AIエージェントはAgentic AIモデルを活用しており、エージェントが指定された目的やゴールを果たす役割を担います。各エージェントは用途に合わせてカスタマイズ可能です。

例えば、Library Management Appで、図書館会員が本を検索・貸出できる場合を考えます。Book Suggesterというエージェントを作成し、会員の読書履歴を分析してパーソナライズされた本の推薦を行うよう指示できます。また、利用不可の本が頻繁に検索された場合、管理者へCliqメッセージを送信するよう依頼することも可能です。このプロセスでは、読書履歴の分析・本の推薦・管理者への通知を行います。同様に、AIエージェントは複数のタスクを論理的かつ体系的に処理し、複雑なワークフローも簡素化できます。

AIエージェントは、次の2つのシンプルな手順で作成できます：

エージェントの定義 - 最初の手順は、AIが得意とすべき内容を全体的に説明します。これはシンプルな指示を自然言語で記述します。
ツールの追加 - 次の手順は、AIが処理を実行するために必要なDeluge関数を追加します。エージェントはシナリオに応じて適切なDeluge関数を選択・実行し、必要な処理を完了します。

エージェント作成後、エンドポイントURLが自動生成されます。このエンドポイントURLは、必要な場所で作成したエージェントを呼び出すためのURLまたはパスです。これを利用してエージェントとやり取りし、応答を受け取ることができます。Creatorでは、invokeURLタスクやJS API経由でエンドポイントURLを使ってエージェントを呼び出せます。さらに、外部システムからAPI通話を通じてアクセスすることも可能です。

メモ: OAuth認証は、エージェントへの安全なアクセスに必須です。

このAIエージェントへのリクエストは単一プロンプトとなります。エージェントがすべてのタスクを処理した後、レスポンスを返します。どちらも自然言語で行われます。

サンプルリクエスト

{'data' :
{
'query' : 'フィードバックを確認し、データをそれに応じて更新してください'
}
}

サンプルレスポンス

{
'ai_response' : フィードバックがネガティブなトーンであることを示しています。フィードバックフォームにデータを正常に追加しました。Cliqチャットで通知しました。
}

AIエージェントを呼び出すためのサンプルDelugeスクリプト

無効 invokeAISkill(string feedbackID)
{
query = Map();
query.put('query','フィードバックを分析してください, feedback_ID : ' + feedbackID);
data = Map();
data.put('data',query);
info data;
resp = invokeurl
[
url :'https://www.zohoapis.com/creator/aiskill/zylker/feedback_analyser'
種類 :POST
パラメーター:data.toString()
connection:'zoho_creator_connection'
コンテンツの種類:'application/json'
];
概要 = resp.取得する('ai_response');
info 概要 ;
}

3.1 AIエージェントへのアクセス方法

AIエージェントにはエンドポイントURLを利用してアクセスできます。

エンドポイントURLとは？

エンドポイントURLは、外部システムがスキルと通信するための固有のパスです。必須の場合に、このURLがエージェントの呼び出しや機能の利用を可能にします。Creatorでは、このエンドポイントURLはエージェントの名前に基づいて自動生成され、最後の部分は作成時に指定したリンク名から派生します。エンドポイントURLの形式は以下の通りです。

https://www.zohoapis.com/creator/aiskill/ /

このエンドポイントURLにアクセスできるのは誰ですか？

AIエージェントの場合、ユーザースコープは初期設定ですべてに設定されています。そのため、Creatorアカウントのユーザータブに登録されている有効ユーザー全員がエンドポイントURLを呼び出すことができます。ポータルユーザーは含まれません。

エンドポイントURLの呼び出し方法

OAuth認証情報または組み込みコネクタを使用し、その後エンドポイントURLを呼び出してAIエージェントにアクセスできます。方法は下記のいずれかです。

invokeURL deluge関数を利用する
ウィジェット内でJS APIを利用する

さらに、サードパーティサービスでもAIエージェントの呼び出しに利用できます。

AIエージェント呼び出しのスコープ

メソッド	スコープ
POST	ZohoCreator.aiskill.実行する

3.2 使用例

インシデント対応アプリケーションを想定します。このアプリでは、ユーザーが技術者およびその専門分野のリストや、さまざまなインシデントに対応する機器のリストを追加できます。

システム障害、機器の故障、安全上のリスクなど、予期しないインシデントが発生した場合、迅速かつ効率的な対応が求められます。状況の把握が遅れると、業務への支障や非効率が生じる可能性があります。状況をすみやかに管理し、適切な解決策で対応できるプロセスが必要です。

このプロセスを効率化するために、AIエージェントをインシデントマネージャーとして作成できます。問題が報告されると、エージェントが内容を分析し、適切な専門分野を特定し、必要な機器や技術者を割り当てます。また、インシデントを効率的に解決するための手順ごとの解決プランも提示可能です。フォームで報告された内容をもとに、エージェントが該当データをレポートに作成します。

使用例の実装

この使用するケースでは、AI Agentを以下の詳細で作成できます。

1. AIに以下の指示を与えます

あなたは24時間365日対応の緊急対応および修復作業における、緩和および封じ込めの詳細を提供する専門エージェントです。
インシデントの詳細に基づき、さらなる被害を防止するための詳細な緩和プランを提供してください。
インシデントコマンダーや技術者など、作業スタッフの詳細も提供してください。
また、対応者が必要とする機器リストも併せて提供してください。

2. 上記タスクに必要なDeluge関数を追加します

利用可能な技術者 – 利用可能な技術者一覧を取得するために呼び出されます。
利用可能な機器 – 利用可能な機器一覧を取得するために呼び出されます。
プラン作成 – 技術者や機器の割り当て、プランの作成に使用されます。

上記の詳細でエージェントを作成した後、自動的にエンドポイントURLが作成され、AIエージェントにアクセス可能となります。

アプリケーションの有効な方法として、下記のようにウィジェット内でこのエンドポイントURLを呼び出すことができます。インシデントの説明を入力することで、AI Agentがすべての指示されたタスクを実行できます。

3.3 前提条件

開始する前に、ZiaをOpenAIと連携して設定する必要があります。これにより、必要な権限が付与されます。OpenAIのキーを追加すると、AI Agent機能が自動で有効化されます。

メモ: この機能は現時点ではZoho LLMではサポートされていません。

AI Agentを作成する前に、ご要件に合わせてDeluge関数の設定も必要です。

3.4 ナビゲーションガイド

Creatorアカウントのホームページから、Microservicesに移動し、画面右上の+新しく作成するボタンをクリックします。AI Modelsカード内の作成を選択し、作成 - カスタムModelsセクションのAI Agentカードを選びます。AI Agent builderが表示されます。このページの手順に従って新規AI Agentを作成できます。