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モデルを利用します。このモデルでは、AI Agentが、平易な自然言語で定義された目的や目標を達成するために役割を担うエージェントのように動作します。各エージェントは、特定のニーズに合わせてカスタマイズできます。

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

AI Agentは、次の2つの簡単な手順で作成できます。
  1. エージェントの定義 - 最初の手順では、AIがどのようなスキルを持つべきかについて全体的な説明を入力します。これは、平易な自然言語による簡単な指示として入力します。
  2. ツールの追加 - 次の手順では、AIがアクションを実行するために必要なDeluge関数を追加します。エージェントは、シナリオに基づいて適切なDeluge関数を選択して実行し、必要なアクションを完了します。
エージェントを作成すると、エンドポイントURLが生成されます。このエンドポイントURLは、作成したエージェントを必要な場所で呼び出すためのURLまたはパスです。エージェントとやり取りし、応答を受け取るために呼び出すことができます。Creatorでは、エンドポイントURLを介してinvokeURLタスクまたはJS APIを使用し、エージェントを呼び出すことができます。また、API呼び出しを通じて任意の外部システムからアクセスすることもできます。
メモ：エージェントに安全にアクセスするには、OAuth認証が必要です。

このAI Agentへのリクエストは、単一のプロンプトです。エージェントがすべてのタスクを処理した後、応答を返します。どちらも自然言語で記述されます。

リクエストの例
  1. {'data' :
  2. {
  3. 'query' : 'フィードバックを確認し、それに応じてデータを更新する'
  4. }
  5. }

応答の例
  1. {
  2. 'ai_response' : フィードバックは否定的なトーンです。フィードバックフォームにデータを正常に追加しました。Cliqチャットで通知しました
  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/ジルカー/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. }
Info

セキュリティ上のヒント 

AIエージェントは、タスクを自動化し効率化するように設計されていますが、無制限に自律して動作するわけではありません。その動作は、設定時にAIに対して設定された指示とツールに完全に従い、ユーザーの役割と権限の範囲内で実行されます。

​
AIエージェントには、目的のタスクに必要な権限のみを付与してください。これにより、明示的に許可された操作のみを実行し、定義された範囲を超えてデータやシステムに独自にアクセスすることを防げます。 

3.1 AI Agentへのアクセス方法

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

このエンドポイントURLにアクセスできるユーザー
AI Agentでは、ユーザースコープは初期設定ですべてに設定されています。そのため、Creatorアカウントの［ユーザー］タブにあるすべての有効なユーザーが、エンドポイントURLを呼び出せます。ポータルユーザーは対象外です。

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

AI Agentを呼び出すためのスコープ
メソッド
 スコープ
POST
 ZohoCreator.aiskill.execute

3.2 ユースケース

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

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

ユースケースの実装
このユースケースでは、以下の詳細でAI Agentを作成できます。

1. AIへの以下の指示の指定
  1. あなたは、24時間365日の緊急対応と修復における緩和策および封じ込めの詳細を提供することを専門とするエージェントです。
  2. インシデントの詳細に基づいて、さらなる被害を防ぐための詳細な緩和計画を提示してください。
  3. インシデント指揮官や技術者の詳細など、対応チームの詳細を提示してください。
  4. 対応者が必要とする機器の一覧も提示してください。

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



3.3 前提条件

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

3.4 ナビゲーションガイド

Creatorアカウントのホームページから、［マイクロサービス］に移動し、右上の［+新規作成］ボタンをクリックします。［AIモデル］カードで［作成］を選択し、作成 - カスタムモデルセクションの［AI Agent］カードを選択します。AI Agentビルダーが表示されます。このページの説明に従って、新しいAI Agentを作成できます。


  1. AI Agentの作成と管理
  2. AI Modelerの概要