ビルドエージェントの理解

ビルドエージェントの理解

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

Info

 概要
Build Agentは、自然言語のプロンプトを使用して既存のアプリケーションを変更できる、Zoho CreatorのAI搭載開発アシスタントです。編集モードとライブモードの両方で利用でき、要件を解釈して、提案されたすべての変更を確認用の変更概要としてプレビュー表示し、承認された変更をアプリケーションに適用します。Zoho Ziaで設定されたAIプロバイダーを活用し、変更指示をCreatorのコンポーネントや設定に変換することで、アプリケーション開発を迅速化し、各ビルダーを手動で設定する手間を軽減します。

Idea
利用条件
  1. Creator 6のすべての有料プランで利用できます。
  2. [操作]→[Zoho Zia]から、特権管理者または管理者が有効にできます。
  3. 特権管理者、管理者、開発者がアプリケーションの変更に使用できます。
  4. Build Agentでは、Zoho ZiaのLLMプロバイダーとしてGoogle Geminiを使用するよう設定することはできません。

1. Build Agentとは

Build Agentは、自然言語のプロンプトを使用してアプリケーションを変更できる、Zoho CreatorのAI搭載開発アシスタントです。アプリケーションのコンポーネントを手動で設定する代わりに、必要な変更を記述すると、Build Agentが要求された変更をアプリケーションに実装します。Build Agentを使用すると、フォーム、レポート、ワークフローの作成、項目の追加、項目プロパティの変更、HTMLコードやDelugeコードの生成など、サポートされている操作を実行できます。Build Agentはアプリケーションのコンポーネントを設定するだけでなく、実装手順や推奨されるベストプラクティスも提示し、目的の結果をより効率的に達成できるよう支援します。追加情報が必要な場合は、要求された変更を正確に実装できるよう、Build Agentが必要な詳細情報の入力を求めます。

機能の変更要求を送信すると、Build Agentが要件を分析し、提案された変更をまとめた概要を生成します。要求された機能をより効果的に実装するため、要求された変更に加えて、補助項目の追加、レポートの生成、他のアプリケーションコンポーネントの更新など、関連する更新が推奨される場合があります。変更概要を確認して承認すると、Build Agentによって提案された変更がアプリケーションに適用されます。
Notes
メモ:公開済みのアプリケーションを変更すると、ライブ環境でのユーザー体験に影響する可能性があります。そのため、Build Agentでは開発環境の作成を推奨します。このオプションを選択すると、Build Agentによって環境が自動的に作成され、本番環境に公開する前に変更を実装、テスト、検証できます。
Build Agentは、アプリケーションの編集モードとライブモードの両方で利用でき、アプリケーションの操作画面にあるBuild Agentアイコン()からアクセスできます。Build Agentでは、手動設定とは異なり、ライブモードのままアプリケーションを変更できます。そのため、編集モードに戻ることなく、アプリケーションのテスト、改善点の特定、コンポーネントの追加や変更を行えます。

Build Agentは、Zoho Ziaで設定されたLLMプロバイダーを基盤として動作します。このLLMプロバイダーが、ユーザーの要求を解釈し、対応するアプリケーションコンポーネント、設定、コードを生成します。
Notes
メモ:Build Agentを使用する前に、管理者ダッシュボードの[操作]セクションにある[Zoho Zia]でBuild Agentが有効になっていることを確認してください。

2. 前提条件

Zoho Ziaの設定
Build Agentを使用するには、Creatorアカウント全体のAI機能を管理できるようにZoho Ziaを設定します。Zoho Ziaでは、Zoho GenAI LLMプロバイダーが初期設定されているため、追加の設定は必要ありません。別のプロバイダーを使用する場合は、Zoho Ziaを連携して、サポートされているLLMプロバイダー(OpenAIまたはAnthropic)を使用できます。Zoho Ziaの設定は一度のみ必要で、設定するとBuild Agentを含むすべてのZoho Zia機能を利用できるようになります。Zoho Ziaの設定方法をご確認ください。

セキュリティ上のヒント:Zoho GenAI LLMは無料で利用でき、すべてのプロンプトがZoho内で処理されます。一方、外部のLLMプロバイダーでは、それぞれのシステム内でデータが処理されます。外部プロバイダーを使用する場合は、機密情報や規制対象の情報をプロンプトに入力しないでください。

Build Agent機能の有効化
1. [操作]→[Zoho Zia]→[機能]に移動します。[機能]タブに、利用可能なすべてのZoho Zia機能の一覧が表示されます。

2. [機能へのアクセス]セクションにある[Build Agent]の横の[アクセス]ボタンを有効にし、この機能で使用する設定済みのLLMプロバイダーを選択します。

 
メモ:
  1. Zoho ZiaでBuild Agent機能を有効または無効にしたり、LLMプロバイダーを設定したりできるのは、特権管理者のみです。
  2. AIプロバイダーとしてGoogle Geminiが設定されている場合、Build Agentはサポートされません。この機能を利用するには、Zoho Ziaの設定でサポート対象のプロバイダーに切り替えてください。

 3. Build Agentへのアクセス方法

Build Agentアイコン()の表示位置は、使用中のモードによって異なります。

編集モードの場合
Build Agentアイコン()は、画面の左端に表示されます。クリックすると、チャットパネルが画面左側にスライド表示されます。
 
ライブモードの場合
Build Agentアイコン()は、上部のナビゲーションバーに表示されます。クリックすると、画面右側にチャットパネルが開きます。

4. Build Agentで実行できる操作 

コンポーネント
対応
非対応
フォーム項目、対応しているプロパティの作成と変更。
カスタマイズ:スマートフォン向けのフォームのカスタマイズ。

フォームと項目の削除には対応していません。
対応しているレポートの作成と変更

レポートの種類:ピボットグラフピボットテーブル

Notesメモ:独自の順序による並べ替えとグループ化は、アプリケーションの編集モードで実行できます。

カスタマイズクイックビューのレイアウトの変更、クイックビューと詳細ビューのカスタムレイアウトの作成、スマートフォン向けレポートのカスタマイズ。

レポートの削除には対応していません。
ページと対応しているページ要素の追加。

対応しているページ要素:パネルグラフボードゲージ検索、フォーム、レポート、HTMLスニペット埋め込みスニペット

ページのプロパティ:ページ変数とスクリプト、背景色の変更、PDF出力と印刷の有効化/無効化。
カスタマイズ:スマートフォン向けページのカスタマイズ。

ページ要素:ウィジェットARビューアーZMLスニペットの生成、パネル要素の設定の更新。

ページとページ要素の削除には対応していません。
対応しているワークフローの作成と変更。ワークフロー用のDelugeスクリプトの生成。

対応しているワークフロー:フォームイベント時関数呼び出し時。
種類:ブループリント承認決済一括処理スケジュールの各ワークフロー。Node.jsJavaで記述された関数。

ワークフローの削除には対応していません。
チャットエージェントの作成と変更。
チャットエージェント名、チャットエージェントのリンク名、アバターの変更。

連携:AIエージェントの関連付けまたは解除。

チャットエージェントの削除には対応していません。
次のアプリ設定を行えます。
アプリメニュー、アプリアイコン、アプリ名の変更、ユーザー権限ポータルユーザー権限ローカライズ、アプリの時刻形式の変更、アプリケーションのテーマと色の更新。
ユーザー権限:役割、データ共有、ユーザー権限の削除。

ポータルユーザー権限:ポータルユーザー権限の削除。

その他の設定:アプリ変数コンテキストメッセージデータテンプレートスキーマビルダー、アプリケーションIDEを使用したアプリのエクスポート。
アプリケーションのデータ
アプリケーションのデータの作成、変更、削除には対応していません。

5. Build Agentの操作画面

Build Agentは次の要素で構成されています。

  1. セッションツールバー
    パネル上部にあるツールバーには、次の3つの操作ボタンがあります。
    1. [新しいチャット]():新しい会話を開始します。関連のないタスクに切り替える場合や、現在のセッションのコンテキストが不要になった場合に使用します。
    2. [履歴]():現在のアプリケーションでの過去の会話一覧を開きます。会話を選択すると、会話を再開したり、加えられた変更を確認したりできます。
    3. [最小化]()/[閉じる(X)]:編集モードでは、最小化アイコンをクリックすると、チャットパネルが画面の左端に折りたたまれます。ライブモードでは、(X)アイコンをクリックすると、チャットパネルが閉じます。どちらの場合も、セッションは保持されます。
  2. 会話エリア
    プロンプトに対するBuild Agentの回答が表示される、パネルのメイン領域です。ユーザーのリクエストとBuild Agentの回答のやり取りに加え、変更が提案された場合は変更内容の概要が表示されます。

  3. プロンプト入力欄
    パネル下部にある入力領域です。要件を自然な言葉でこちらに入力します。プロンプト入力欄には、次の2つの操作ボタンもあります。
    1. [@メンション]:@を入力するか、@アイコンをクリックして、プロンプト内で参照するコンポーネントを選択します。これにより、変更対象のアプリケーションコンポーネントをBuild Agentが正確に特定できます。
    2. [ファイルのアップロード]():スクリーンショット、サンプルデータ、参考資料などのファイルをプロンプトに添付して、追加のコンテキストを提供できます。画像、PDF、CSV、テキストファイルに対応しています。
      メモ:プロンプトごとに最大10件のファイルを添付できます。各ファイルの上限サイズは10MBです。ただし、PDFファイルは1件あたり2MBまでです。

6. Build Agentを使用したアプリコンポーネントの変更方法

手順1:変更内容の説明
Build Agentを開き、アプリケーションの編集モードまたはライブモードで、必要な変更を自然な言葉で説明します。要件定義書やスクリーンショットなどの関連ファイルをアップロードしたり、フォーム、レポート、ページ、その他のコンポーネントを@メンションしたりすることで、追加のコンテキストを提供して精度を高めることもできます。[送信]()アイコンをクリックして、プロンプトを送信します。

手順2:変更内容の概要の確認
Build Agentは生成された出力を、提案するCreatorコンポーネントと設定に変換し、変更内容の概要を表示します。概要には予定されている変更の全体像が表示され、アクションセクションには具体的な操作がコンポーネント別に表示されます。これにより、変更を適用する前に、変更対象を確認できます。
たとえば、プロンプトによってフォームに項目を追加する場合、概要には対象のフォーム、作成される項目、関連する設定が表示されます。

手順3:変更の適用
概要を確認した後、提案された変更を実装するには[変更を適用]をクリックし、破棄するには[キャンセル]をクリックします。Build Agentによって、関連するアプリケーションコンポーネントが更新されます。

Notes
メモ。
  1. Build Agentを通じて適用した変更は元に戻せません。変更を適用する前に、概要を慎重に確認してください。
  2. 前の概要に表示された変更を適用せずに新しいプロンプトを送信すると、保留中の変更は破棄されます。
Build Agentによって関連するアプリケーションコンポーネントが更新され、適用された変更の概要を示す成功メッセージが表示されます。開発者が別のコンポーネントを表示している場合、Build Agentが更新済みのコンポーネントを自動的に開き、確認できるようになります。


6.1. 動作の仕組み

次の動画では、ユーザーのプロンプトに基づいて、アプリケーションの編集モードとライブモードの両方でBuild Agentがアプリケーションコンポーネントを生成および変更する方法を説明します。

編集モード:


ライブモード:

7. ユースケース

ZylkerTechnologiesでは、Zoho Creatorで作成した顧客サポートアプリケーションを使用して、顧客サポートチケットを管理しています。アフターサービスの拡大に伴い、サポートチームは、顧客が購入した製品の保証記録を管理し、顧客が保証請求を送信できるようにして、請求の承認プロセスを効率化するための保証管理モジュールを必要としています。
開発者は必要なコンポーネントを手動で作成する代わりに、Build Agentを開いて要件を自然な言葉で説明し、必要なアプリケーションコンポーネントとスクリプトを生成させます。

7.1. 既存のアプリケーションへのフォームの追加

開発者は、保証管理に必要なフォームを生成するため、次のプロンプトを使用します。
Idea「既存の顧客サポートアプリケーションに、保証登録、保証請求、保証承認フォームを追加してください。保証登録フォームには購入製品の保証情報を保存し、保証請求フォームでは登録済み製品の請求を送信できるようにし、保証承認フォームでは送信された請求を確認して承認または却下できるようにしてください」
Build Agentは、保証管理用に指定されたフォームを作成するなど、アプリケーションに加える変更の概要を表示します。また、保証情報、請求情報、承認結果を取得するために必要な主要項目も提案します。さらに、対応するレポートを生成し、実装の一環としてフォームとレポートをアプリケーションメニューに追加することを提案します。
変更内容を確認して承認すると、開発者はフォーム、その項目、対応するレポートをアプリケーションに追加します。

7.2. ワークフローの設定

開発者は、保証請求の承認プロセスを自動化するため、次のプロンプトを使用します。
Idea
「保証請求の承認プロセスを自動化するワークフローを作成してください。保証を検証し、請求を承認に回し、請求ステータスを更新して、承認結果を顧客に通知してください」
Build Agentは、保証請求フォームと保証承認フォームに必要なワークフローを作成することを示す変更内容の概要を生成します。概要には、送信前に保証請求を検証すること、新しい請求を審査に回すこと、決定日を含む承認記録を作成すること、承認後に請求結果を更新すること、承認結果が記録された時点で顧客に通知することが示されます。変更内容を確認して承認すると、開発者は生成されたワークフローをアプリケーションに追加します。

7.3. Deluge関数の作成と変更

開発者は、保証有効期限を計算する関数を生成するため、次のプロンプトを入力します。
Idea
「@保証登録フォームの購入日項目が更新されたときに、保証有効期限を自動計算する、再利用可能なDeluge関数を作成してください」
変更内容の概要には、購入日と保証期間に基づいて保証有効期限を計算する、calculateWarrantyExpiry()という再利用可能なDeluge関数がBuild Agentによって生成されることが示されます。また、購入日項目が更新されたときに保証終了日項目を自動入力するためのフォームルールが、@保証登録フォームに追加されることも示されます。変更内容を確認して承認すると、開発者は生成された関数とフォームルールをアプリケーションに追加します。

7.4. 指標を使用したダッシュボードの作成

開発者は、保証管理ダッシュボードを作成するため、次のプロンプトを入力します。
Idea
「保証登録、請求ステータス、承認結果、有効期限が近い保証に関する主要指標を表示する、保証管理ダッシュボードを作成してください」
Build Agentは、新しい保証管理ダッシュボードページを作成することを示す変更内容の概要を生成します。概要では、KPIパネルの追加が示され、主要な保証指標と傾向を可視化するグラフが提案されます。また、ダッシュボードがアプリケーションメニューの保証セクションに追加されることも示されます。変更内容を確認して承認すると、開発者は生成されたダッシュボードをアプリケーションに追加します。

7.5. ページへのHTMLスニペットの追加

開発者は、保証管理ダッシュボードにユーザー別のウェルカムバナーを作成するため、次のプロンプトを使用します。
Idea
「現在のユーザー名、現在の日付、保留中の保証請求の概要を含む、ユーザー別のウェルカムメッセージを表示するHTMLスニペットを、保証管理ダッシュボードに追加してください」
変更内容の概要には、Build AgentがHTMLスニペットを使用して保証管理ページにウェルカムバナーを追加することが示されます。また、バナーに保証承認フォームへのクイックナビゲーションリンクを含めることも推奨されます。Build Agentでは既存のページレイアウトを変更できないため、スニペットはダッシュボード上の利用可能なスペースに配置されます。変更内容を確認して承認すると、開発者は生成されたHTMLスニペットをアプリケーションに追加します。

8. 注意事項

動作上の特性/機能と制約
  1. 適用した変更は元に戻せません。承認された変更はすぐに反映されるため、[変更を適用]をクリックする前に、[概要]をよく確認してください。
  2. フォーム項目レポートページワークフロー関数などのアプリケーションコンポーネントのみ作成または変更できます。フォームに保存されているデータには影響しません。
  3. ビルドエージェントは、アクセス元のアプリケーション内でのみ動作し、他のCreatorアプリケーションや外部システムには直接アクセスできません。
  4. 現在のアプリケーションですでに連携が設定および認証されている場合、ビルドエージェントはその連携を使用して、要求された処理を実行できます。
  5. 送信された要求がトピックと無関係または未対応の場合、ビルドエージェントは要求を拒否し、変更が部分的に実装されるのを防ぎます。
  6. 要求は、入力したプロンプトと@メンションしたコンポーネントに基づいて処理されます。コンポーネントが指定されていない場合、ビルドエージェントはプロンプトの文脈から変更対象のコンポーネントを特定します。
  7. 1回のセッションでは複雑すぎる要求は、複数の小さなタスクに分割してください。たとえば、フォームに複数のワークフローを作成するような大規模な要求は、1つのプロンプトにまとめず、個別のプロンプトに分割する必要があります。これにより、不完全な処理を防ぎ、結果の精度と信頼性を向上できます。
AIの使用量とデータ
  1. Zoho GenAIのLLMは無料で利用でき、すべてのプロンプトがZoho内で処理されます。一方、外部のLLMプロバイダーでは、各社のシステム内でデータが処理されます。Zoho Ziaで外部プロバイダーを使用する場合、ビルドエージェントで機密情報や規制対象の情報を共有しないでください。
  2. ビルドエージェントは、Zoho CreatorのAI呼び出しやAPI呼び出しを消費しません。ただし、ビルドエージェントでZoho GenAIを使用すると、開発AIクレジットが消費されます。外部のLLMプロバイダーを使用した場合の利用量は、各サービスプロバイダーによって計上されます。開発AIクレジットの使用量は、[請求]セクションで確認できます詳細はこちら
  3. 外部LLMプロバイダーをZoho Ziaビルドエージェントに設定している場合、APIのレート制限が適用されることがあります。この制限は、指定された期間内にユーザーまたはクライアントがサービスへアクセスできる回数をLLMプロバイダーが制限するもので、利用プランや使用するモデルによって異なります。各LLMプロバイダーのレート制限については、それぞれの公式ドキュメントを参照してください。
    1. OpenAIのレート制限
    2. Google Geminiのレート制限
    3. Anthropicのレート制限
  4. ビルドエージェントの回答精度を高めるため、入力したプロンプトに加えて補助プロンプトがシステムによって追加される場合があります。システムが生成したこれらのプロンプトも、Zoho Ziaに設定されたLLMプロバイダーのAI使用量として計上されます。

9. 関連トピック

  1. Zoho Ziaの設定
  2. CreatorのZoho Zia機能について
  3. Zoho Ziaを活用したCreatorのAI機能
  4. アプリケーションのモード
  5. 早期アクセス機能