AIエージェントの理解

AIエージェントの理解

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

Notesメモ: AI エージェントはAI 通話の上限にはカウントされません。

1. 概要

AI Agent を使用すると、Agentic AI テクノロジーを用いて、シンプルな指示でタスクを自動化できます。AI にどのように振る舞わせるかを記述し、必要なアクションを実行するスクリプトを含む Deluge 関数を追加することで、エージェントを作成します。すると、定義どおりにタスクを順番に計画・実行し、状況を分析して、あなたに代わって意思決定を行います。

2. 提供状況

AI エージェント:
  1. すべての Creator プランで作成および管理できます。API 呼び出し上限は、契約プランによって異なります。
  2. スーパー管理者と管理者のみが作成および管理でき、その他の種類のユーザーはエージェントを呼び出すことができます。

3. 詳細

AI Agent は、状況を分析して意思決定を行い、人の介入なしに自律的に複数の複雑なタスクを実行できる、特化型の AI 機能です。従来のワークフローとは異なり、AI Agent は固定的なルールに従うのではなく、状況を動的に分析し、最適なアクションを選択しながらコンテキストを適応させることができます。

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

たとえば、図書館の会員が本を検索して貸し出しできる図書館管理アプリがあるとします。この場合、会員の読書履歴を分析してパーソナライズされた本のおすすめを行うよう指示したBook Suggester というエージェントを作成できます。また、利用できない本が頻繁に検索されている場合に、管理者へCliq メッセージを送信するように指示することもできます。このプロセスには、読書履歴の分析、本の提案、管理者への通知が含まれます。同様に、AI エージェントを作成して、複数のタスクを論理的かつ整理された一貫性のある手順で実行させることで、複雑なワークフローを簡素化できます。

AI Agent は、次の 2 ステップで簡単に作成できます。
  1. エージェントの定義 - まず、AI にどのようなスキルを持たせるかという全体的な説明を行います。これは、自然な言葉で書かれたシンプルな指示として入力します。
  2. ツールの追加 - 次に、AI がアクションを実行するために必要となるDeluge 関数を追加します。エージェントは、状況に応じて適切な Deluge 関数を選択・実行し、必要な処理を完了します。
エージェントを作成すると、エンドポイント URLが生成されます。このエンドポイント URL は、作成したエージェントを必要な場所から呼び出すための URL（パス）です。これを呼び出すことで、エージェントと対話し、レスポンスを受け取ることができます。Creator では、invokeURL タスクや、エンドポイント URL を利用したJS API からエージェントを呼び出せます。さらに、外部システムから API 通話を通じてアクセスすることも可能です。
メモ: エージェントへ安全にアクセスするには、OAuth 認証が必要です。

この AI Agent への要求は、1 つのプロンプトで行います。エージェントがすべてのタスクを処理した後、レスポンスを返します。どちらも自然言語でやり取りされます。

要求のサンプル
  1. {'data' :
  2. {
  3. 'query' : 'Check the feedback and update records accordingly'
  4. }
  5. }

レスポンスのサンプル
  1. {
  2. 'ai_response' : Feedback conveys a negative tone, added records successfully in the Feedback form. Notified in the Cliq chat
  3. }

AI Agent を呼び出す Deluge スクリプトのサンプル

  1. void invokeAISkill(string feedbackID)
  2. {

  3. query = Map();

  4. query.put('query','Analyse the feedback, feedback_ID : ' + feedbackID);

  5. data = Map();

  6. data.put('data',query);

  7. info data;

  8. resp = invokeurl

  9. [

  10. url :'https://www.zohoapis.com/creator/aiskill/zylker/feedback_analyser'

  11. type :POST

  12. parameters:data.toString()

  13. connection:'zoho_creator_connection'

  14. content-type:'application/json'

  15. ];

  16. summary = resp.get('ai_response');

  17. info summary ;
  18. }

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

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

エンドポイント URL とは？
エンドポイント URL は、必要に応じて外部システムがスキルと連携できる一意のパスです。エージェントを呼び出し、その機能を利用するためのアクセス ポイントとして機能します。Creator では、このエンドポイント URL はエージェント名に基づいて自動生成され、末尾の部分は作成時に指定したリンク名から取得されます。エンドポイント URL は次の形式になります。

このエンドポイント URL にアクセスできるのは誰ですか？
AI エージェントでは、ユーザー範囲はデフォルトですべてに設定されています。そのため、Creator アカウントの［ユーザー］タブにいるすべての有効ユーザーが、このエンドポイント URL を呼び出すことができます。ポータルユーザーは含まれません。

エンドポイント URL を呼び出す方法
OAuth 認証情報または組み込みコネクタを使用し、認証したうえで、次のいずれかの方法でエンドポイント URL を呼び出して AI エージェントにアクセスできます。
  1. invokeURL Deluge 関数を使用する
  2. ウィジェット内でJS APIを使用する
さらに、任意のサードパーティサービスから AI エージェントを呼び出すために使用することもできます。

AI エージェントを呼び出すためのスコープ
メソッド
 スコープ
POST
 ZohoCreator.aiskill.execute

3.2 ユースケース

インシデント対応アプリケーションを想定します。このアプリでは、技術者とその専門分野の一覧、およびさまざまなインシデントに対する機器の一覧を追加できます。
 
システム障害、機器の不具合、安全上の危険などの予期せぬインシデントが発生した場合、迅速かつ効率的な対応が求められます。状況の把握が遅れると、業務の中断や非効率につながります。状況を素早く管理し、適切な解決策で是正できるプロセスが必要です。

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

ユースケースの実装
このユースケースでは、次の内容で AI エージェントを作成します。

1. AI に対して次の指示を与える
  1. あなたは、24 時間 365 日対応の緊急対応および復旧における、緩和策と封じ込め策の提示に精通したエージェントです。
  2. インシデントの詳細に基づき、さらなる被害を防ぐための詳細な緩和プランを提示してください。
  3. インシデント指揮官や技術者の詳細など、クルーの情報を提示してください。
  4. 対応者に必要となる機器の一覧も提示してください。

2. 上記のタスクに必要な Deluge 関数を追加する
  1. Available technicians - 利用可能な技術者の一覧を取得するために呼び出されます。
  2. Available equipment - 利用可能な機器の一覧を取得するために呼び出されます。
  3. Create plan - 技術者と機器を割り当て、プランを作成するために呼び出されます。
上記の内容でエージェントを作成すると、その AI エージェントにアクセスするためのエンドポイント URL が自動的に生成されます。
 
アプリケーションのライブモードでは、以下のようにウィジェット内からこのエンドポイント URL を呼び出せます。インシデントの説明を入力すると、AI エージェントが起動し、指示されたすべてのタスクを実行します。



3.3 前提条件

  1. 作業を開始する前に、Zoho Zia を OpenAI と連携するよう設定する必要があります。これにより、必要な権限が付与されます。OpenAI のキーを追加すると、AI Agent 機能は自動的に有効になります。
    メモ: この機能は、現時点では Zoho LLM ではサポートされていません。
  1. AI Agent を作成する前に、要件に応じて Deluge 関数も設定しておく必要があります。

3.4 ナビゲーションガイド

Creator アカウントのホームページから、Microservices に移動し、右上の +Create New ボタンをクリックします。AI Models カードで Create を選択し、Build - Custom Models セクションの AI Agent カードを選択します。AI Agent builder が表示されます。新しい AI Agent の作成方法については、こちらのページを参照してください。


  1. AI Agent を作成・管理する
  2. AI Modeler について