AIエージェントの概要

AIエージェントの概要

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

メモメモ：AIエージェントは、AI呼び出しの上限を消費しません。
概要
AIエージェントでは、エージェント型AI技術を活用し、簡単な指示でタスクを自動化できます。AIの動作を説明し、処理を実行するスクリプトを含むDeluge関数を追加することで、エージェントを作成できます。エージェントは、定義された内容に従ってタスクを計画し、順に実行しながら、状況を分析し、ユーザーに代わって判断します。
利用条件
AIエージェントの利用条件は次のとおりです：
  1. Creatorのすべてのプランで作成、管理できます。APIの呼び出し上限は、契約プランによって異なります。
  2. 作成、管理できるのは特権管理者と管理者のみですが、その他の種類のユーザーも呼び出すことができます。

1. 概要

AIエージェントは、人の介入なしに状況を分析し、判断し、自律的に行動することで、複数の複雑なタスクを実行できる専用のAI機能です。従来のワークフローとは異なり、固定されたルールに従うのではなく、状況を動的に分析し、最適な行動を選択して、状況の変化に対応できます。

Zoho CreatorのAIエージェントでは、自然言語でエージェントのスキルを定義し、Deluge関数などの必要なツールを指定すると、エンドポイントURLが自動的に生成されます。このURLを呼び出すことで、エージェントを使用して必要なタスクを実行できます。AIエージェントはエージェント型AIモデルを使用しており、わかりやすい自然言語で定義した目的や目標を達成するために、役割を担って行動します。各エージェントは、個別のニーズに合わせてカスタマイズできます。

たとえば、図書館の利用者が本を検索して借りられる図書館管理アプリがあるとします。利用者の読書履歴を分析し、それぞれに合った本をおすすめするよう指示して、おすすめ図書エージェントを作成できます。また、貸し出しできない本が頻繁に検索された場合に、管理者にCliqメッセージを送信するよう指示することもできます。このプロセスには、読書履歴の分析、本の提案、管理者への通知が含まれます。このように、複数のタスクを論理的かつ体系的に、一貫性を持って実行するAIエージェントを作成することで、複雑なワークフローを簡素化できます。

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

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

要求の例
  1. {'data' :
  2. {
  3. 'query' : 'フィードバックを確認し、内容に応じてレコードを更新してください'
  4. }
  5. }

応答の例
  1. {
  2. 'ai_response' : フィードバックは否定的な内容です。フィードバックフォームにレコードを追加しました。Cliqチャットで通知しました。
  3. }

AIエージェントを呼び出すDelugeスクリプトの例

  1. void invokeAISkill(string feedbackID)
  2. {

  3. query = Map();

  4. query.put('query','フィードバックを分析してください。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. }
情報

セキュリティ上のヒント 

AIエージェントはタスクの自動化と効率化を目的として設計されていますが、制限なく自律的に動作するわけではありません。その動作は、セットアップ時にAIに設定された指示とツールに完全に従い、ユーザーの役割と権限の範囲内で実行されます。
AIエージェントには、目的のタスクに必要な権限のみを付与してください。これにより、明示的に許可された操作のみを実行し、定められた範囲を超えて独自にデータやシステムにアクセスすることを防げます。 

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

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

このエンドポイントURLにアクセスできるユーザーは？
AIエージェントの［ユーザー範囲］は、初期設定ですべてに設定されています。そのため、Creatorアカウントのユーザーモジュールに登録されている有効なユーザーは全員、エンドポイントURLを呼び出すことができます。ポータルユーザーは対象外です。

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

AIエージェントの呼び出しに必要なスコープ
メソッド
 スコープ
POST
 ZohoCreator.aiskill.execute

1.2. 活用例

ユーザーが技術者とその専門分野の一覧や、さまざまなインシデントに対応するための機器の一覧を追加できるインシデント対応アプリを例に考えてみます。
 
システム障害、機器の不具合、安全上の危険など、予期しないインシデントが発生した際には、迅速かつ効率的な対応が求められます。状況の把握が遅れると、業務の中断や効率の低下につながる可能性があります。そのため、状況を迅速に管理し、適切な解決策で対処するプロセスが必要です。

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

活用例の実装
この活用例では、次の内容でAIエージェントを作成できます：

1. AIに次の指示を設定します
  1. あなたは、24時間365日の緊急対応と復旧において、被害の軽減と拡大防止に関する詳細情報を提供する専門エージェントです。
  2. インシデントの詳細に基づき、被害の拡大を防ぐための詳細な被害軽減計画を提示してください。
  3. インシデント対応の指揮責任者や技術者など、対応要員の詳細を提示してください。
  4. 対応要員に必要な機器の一覧も提示してください。

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



1.3. 前提条件

Ziaの設定
開始する前に、ZiaとOpenAIの連携を設定し、必要な権限を付与する必要があります。OpenAIのキーを追加すると、AIエージェント機能が自動的に有効になります。
メモ
メモ：この機能は、Zoho GenAI LLMではまだサポートされていません。

AIエージェント機能の有効化
  1. ［運用］→［Zia］→［機能］に移動します。［機能］タブには、利用可能なZiaのすべての機能が一覧表示されます。
  2. 機能へのアクセスセクションで、AIエージェントの横にある［アクセス］ボタンを切り替えて有効にします。ドロップダウンから、設定済みのOpenAIのキーを選択します。
AIエージェント機能の有効化や無効化、およびこの機能に使用するOpenAIのキーの設定は、特権管理者のみが行えます。

メモ
メモ：AIエージェントを作成する前に、要件に合わせてDeluge関数も設定しておく必要があります。

1.4. アクセス手順

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



2. 注意事項

  1. AIエージェントは、Zoho CreatorのAIの呼び出し回数やAPI呼び出し回数を消費しません。
  2. AIエージェントに設定した外部のLLMプロバイダーでは、APIのレート制限が適用される場合があります。これは、ユーザーやクライアントが一定期間内にサービスにアクセスできる回数に対してLLMプロバイダーが設ける制限で、利用プランや使用するモデルによって異なります。各LLMプロバイダーのレート制限については、それぞれの公式ドキュメントをご参照ください。
    1. OpenAIのレート制限
    2. Google Geminiのレート制限
    3. Anthropicのレート制限

3. 関連情報

  1. AIエージェントの作成と管理
  2. AIモデル作成ツールの概要