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

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

メモ：この機能は現在、Creator 6のすべての有料プランで早期アクセス機能として利用できます

概要

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

利用条件

Creator 6のすべての有料プランで早期アクセス機能として利用できます。
特権管理者または管理者が、［操作］→［Zoho Zia］から有効にできます。
利用できるのは、特権管理者、管理者、開発者です。
Zoho ZiaでAIプロバイダーとしてGoogle Geminiが設定されている場合、ビルドエージェントは利用できません。

1. ビルドエージェントとは

ビルドエージェントは、Zoho CreatorのAI搭載開発アシスタントです。自然言語のプロンプトを使用して、アプリケーションを変更できます。編集モードとライブモードの両方で利用でき、アプリケーションの操作画面にあるビルドエージェントアイコン（

）からアクセスできます。このアイコンは、編集モードでは画面の左端、ライブモードでは上部ナビゲーションバーに表示されます。

メモ：アプリケーションで環境が有効になっている場合、ビルドエージェントには開発環境の編集モードとライブモードからのみアクセスできます。

ビルドエージェントでは、次の操作を支援できます。

コンポーネントの作成と変更：フォーム、項目、レポート、ページ、ワークフロー、関数。
アプリケーション設定の構成：ユーザーとポータルの権限、ローカライズ、タイムゾーン形式やアプリ名などの一般的なアプリケーション設定
Delugeスクリプトの生成：ワークフロー、関数、ページスクリプト、スニペット用。

プロンプトを送信すると、要件が分析され、提案されるすべての操作がコンポーネント別に一覧表示された変更内容の概要が生成されます。変更内容を確認して承認すると、ビルドエージェントがアプリケーションに適用します。

ビルドエージェントは、Zoho Ziaで設定されたAIプロバイダーを使用して要件を解釈し、該当するコンポーネントとその設定に変更を即座に適用します。これにより、必要なコンポーネントを最初から作成する手間を減らせます。

メモ：

ビルドエージェントは、新しいコンポーネントの作成と既存コンポーネントの更新ができます。フォームに保存されているデータにはアクセスできず、アプリケーションのコンポーネントやデータを削除することもできません。
変更を本番環境に反映する前にテストできるよう、環境を使用しているアプリケーションでビルドエージェントを利用することをおすすめします。
変更処理中にビルドエージェントが中断されたりエラーが発生したりした場合、その要件に関するすべての変更はロールバックされます。これにより、部分的に適用された変更が残らないようになります。

1.1. 仕組み

ステップ1：加えたい変更を説明する

アプリケーションの編集モードまたはライブモードからビルドエージェントを開き、必要な変更を自然言語で説明します。要件ドキュメントやスクリーンショットなどの関連ファイルをアップロードしたり、フォーム、レポート、ページ、その他のコンポーネントを@メンションしたりして、追加のコンテキストを提供し、精度を高めることもできます。

ステップ2：変更内容の概要を確認する

ビルドエージェントは、生成された出力を提案されるCreatorのコンポーネントと設定に変換し、変更内容の概要を表示します。この概要には、予定されているすべての操作がコンポーネント別に一覧表示されるため、変更が適用される前に何が変更されるかを確認できます。

たとえば、プロンプトでフォームに項目を追加するよう指示した場合、概要には対象のフォーム、作成される項目、関連する設定が表示されます。

ステップ3：変更を適用する

変更内容の概要を確認したら、提案された変更を実装するには［変更を適用］をクリックし、破棄するには［キャンセル］をクリックします。ビルドエージェントが、関連するアプリケーションコンポーネントを更新します。

メモ：ビルドエージェントを通じて適用した変更は元に戻せません。変更を適用する前に、変更内容の概要を慎重に確認してください。

2. 前提条件

早期アクセス機能からビルドエージェントを有効にする

［操作］→［アプリケーション］→［早期アクセス機能］に移動します。
ビルドエージェントを検索し、切り替えボタンをオンにしてアカウントで有効にします。

Zoho Ziaの設定

ビルドエージェントを使用するには、Creatorアカウント全体のAI機能を管理できるようにZoho Ziaを設定します。Zoho Ziaでは、初期設定でZoho GenAI LLMプロバイダーが設定されているため、追加設定は不要です。別のプロバイダーを使用する場合は、対応しているいずれかのLLMプロバイダー（OpenAI、Anthropic）とZoho Ziaを連携できます。Zoho Ziaの設定は一度だけ行う処理で、ビルドエージェントを含むすべてのZoho Zia機能を利用できるようになります。Zoho Ziaの設定方法を確認する。

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

Zoho Ziaを設定したら、アプリケーションで使用を開始するために、［機能を有効にする］セクションでビルドエージェントの［アクセス］切り替えボタンを有効にします。

メモ：AIプロバイダーとしてGoogle Geminiが設定されている場合、ビルドエージェントはサポートされません。この機能を利用するには、Zoho Ziaの設定で対応しているプロバイダーに切り替えてください。

3. ビルドエージェントへのアクセス手順

ビルドエージェントアイコン（

）は、使用しているモードに応じて異なる場所に表示されます。

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

4. Build Agentの操作画面

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

セッションツールバー
パネル上部にあるツールバーには、次の3つの操作があります。

［新しいセッション］（）：新しい会話を開始します。関連のないタスクに切り替える場合や、現在のセッションの文脈が不要になった場合に使用します。
［会話］（）：現在のアプリケーションでの過去の会話一覧を開きます。任意の会話を選択して再開したり、行われた変更を確認したりできます。
スライダーアイコン（）／［閉じる］（X）：編集モードでは、チャットパネルを画面左端に折りたたみます。ライブモードでは、チャットパネルを閉じます。どちらの場合も、セッションは保持されます。

会話エリア
Build Agentがプロンプトに応答する、パネルのメイン領域です。ユーザーのリクエストとBuild Agentの回答のやり取りが表示され、変更が提案される場合は変更概要も表示されます。
プロンプト欄
パネル下部の入力エリアです。要件をここに自然な言葉で入力します。プロンプト欄には、次の2つの追加操作もあります。

@メンション：@を入力するか@アイコンをクリックし、プロンプトで参照するコンポーネントを選択します。これにより、Build Agentは変更対象のアプリケーション内の正確な部分を特定しやすくなります。
［ファイルのアップロード］（）：画像、PDF、CSVファイル、テキストファイルをプロンプトに添付して、追加の文脈を提供できます。たとえば、スクリーンショット、サンプルデータファイル、参考資料をアップロードすると、Build Agentが要件をより正確に理解できます。

メモ：1つのプロンプトにつき最大10件のファイルを添付できます。各ファイルの最大サイズは10MBです。

5. 使用例

5.1. 既存のアプリケーションへのレポートの追加

製造会社の開発者が、生産上の不具合を追跡するためのZoho Creator品質管理アプリケーションを管理しています。プロセス監査の結果、運用チームは、繰り返し発生する品質問題を特定するため、不具合データを製品ラインと重大度別にグループ化するレポートを必要としています。

レポートを手動で作成してグループ化を設定する代わりに、開発者はBuild Agentを開き、要件を自然な言葉で説明します。Build Agentは、関連する項目やグループ化条件を含む、提案されたレポート構造の変更概要を生成します。変更内容を確認して承認すると、開発者はレポートをアプリケーションに追加し、運用チームが不具合の傾向を監視して、繰り返し発生する品質問題をより効果的に特定できるようになります。

プロンプト例

「@DefectsフォームのすべてのデータをProduct LineとSeverityでグループ化し、最新の日付順に並べ替えたレポートを作成してください。」

5.2. フォームへの項目の追加

医療クリニックの管理者が、受付スタッフが使用するZoho Creator患者管理アプリケーションを管理しています。クリニックでは、Patient IntakeフォームにInsurance Provider ルックアップ項目を追加して、患者の保険情報を取得する必要があります。

フォームを手動で変更する代わりに、管理者は開発環境でBuild Agentを開き、要件を自然な言葉で説明します。Build Agentは、Insurance Provider ルックアップ項目の追加と、関連するInsurance Providersフォームとの関連付けを提案する変更概要を生成します。変更内容を確認して適用した後、管理者は更新されたフォームを開発環境とステージ環境で検証してから、変更を本番環境に展開します。これにより、進行中の業務を妨げることなく、拡張機能をエンドユーザーに提供できます。

プロンプト例

「@Patient Intakeフォームに、@Insurance Providersフォームを参照するInsurance Providerというルックアップ項目を追加してください。」

5.3. 会話によるワークフローの設定

コンサルティング会社の開発者が、タスクとマイルストーンを追跡するためのZoho Creatorプロジェクト管理アプリケーションを管理しています。緊急度の高い作業にすぐ対応できるように、期日が近づいているタスクの優先度を自動的に上げ、プロジェクトマネージャーに通知する必要があります。

複数のワークフロー条件や処理を手動で設定する代わりに、開発者はBuild Agentを開き、1つのプロンプトで要件を説明します。Build Agentは、トリガー条件、条件式、項目の更新、通知処理を含む、提案されたワークフローの変更概要を生成します。変更内容を確認して承認すると、開発者はワークフローをアプリケーションに追加し、期限が迫ったタスクの優先度が自動的に上がり、プロジェクトマネージャーにすみやかに通知されるようになります。

プロンプト例

「@Tasksフォームに、データが編集されたときに実行されるワークフローを追加してください。Due Dateが今後3日以内で、Status項目がOpenの場合、Priority項目をHighに更新し、Escalation Required項目をYesに設定して、タスクの詳細を含むメール通知をプロジェクトマネージャーに送信してください。」

6. Build Agent向けの効果的なプロンプトの書き方

Build Agentの出力品質は、要件をどれだけ明確に説明するかによって決まります。次のガイドラインに従うことで、より正確な結果を得やすくなり、修正の手間を減らせます。

6.1. 最適な結果を得るためのヒント

正確なコンポーネント名を指定する - 変更するフォーム、レポート、ページを一般的に説明するのではなく、@メンションを使用して具体的に参照します。正しいコンポーネントを参照すると、Build Agentが意図した結果を生成しやすくなります。
項目の種類と制約を最初に指定する - テキスト、ドロップダウン、日付などの必要な項目タイプと、必須や一意などの制約を含めます。これらの詳細を早めに指定すると、不要な検証の繰り返しを避けられます。
適切な順序で構築する - ページは基盤となるデータモデルに依存するため、ワークフローや関数の前にフォームと項目を作成し、ページの前にワークフローと関数を作成します。
大きな変更の前に計画する - 大規模な要件や複数ステップの要件では、まずBuild Agentに計画を生成させます。提案された進め方を確認し、段階的に実装を進めます。
適切な用語を使う - 具体的な結果を得るには、プロンプトで適切な用語を使います。たとえば、関数を使用すると、Build Agentは再利用可能な関数ロジックを作成できます。一方、HTMLスニペットを指定すると、カスタムスタイルの要素を生成するよう指示できます。同様に、ワークフローやルックアップなどの用語は、Build Agentが適切なコンポーネントを特定し、より正確な結果を生成するのに役立ちます。
ワークフローのロジックを手順ごとに説明する - ワークフローや関数を作成する場合は、各手順を簡単な言葉で説明し、正確な項目名とフォーム名を参照します。結果が期待どおりでない場合は、同じプロンプトを再送信するのではなく、要件を言い換えてください。
トピックを切り替えるときは文脈を伝え直す - 長いやり取りの中では、Build Agentが以前のやり取りを要約することがあります。新しいトピックを始める際に簡単な要約を示すと、文脈を維持し、精度を向上できます。
承認前に変更概要を確認する - 変更概要は、提案された変更内容を確認するためのものです。Build Agentが行う変更の概要と、生成時に適用された既定の選択内容が示されます。

6.2. プロンプト例

特定の項目タイプを含むフォームの作成
「次の項目を含むCustomerフォームを作成してください：Name（テキスト、必須）、メール（メール、一意）、Phone（電話番号）、Status（ドロップダウン：有効／無効）。」
項目タイプと制約を最初に指定すると、Build Agentがフォームを正確に作成しやすくなります。
フィルター付きレポートの追加
「PriorityがHighのデータのみを表示するTasksレポートを作成してください。」
フィルター条件を明確に指定すると、Build Agentは関連するデータのみを表示するレポートを生成しやすくなります。
再利用可能なロジックの作成
「discount_by_tierという関数を作成し、OrderフォームとQuoteフォームから呼び出してください。」
関数という言葉を使用すると、Build Agentは同じロジックを複数の場所に直接記述するのではなく、再利用可能なDelugeスクリプトを作成します。
カスタムスタイルのダッシュボードタイルの作成
「このダッシュボードタイルをHTMLスニペットとして作成し、自分でスタイルを設定できるようにしてください。」
HTMLスニペットと明記すると、Build Agentが標準のグラフやゲージを生成するのを防げます。

7. 注意点

動作／機能と制約

適用した変更は元に戻せません。承認した変更はすぐに有効になるため、［変更を適用］をクリックする前に、変更の概要を慎重に確認してください。
作成または変更できるのは、フォーム、項目、レポート、ページ、ワークフロー、関数などのアプリケーションコンポーネントのみです。フォームに保存されているデータには影響しません。
ビルドエージェントは、アクセス元のアプリケーション内でのみ動作し、他のCreatorアプリケーションや外部システムに直接アクセスすることはできません。
現在のアプリケーションで連携がすでに設定および認証されている場合、ビルドエージェントはそれらを使用して要求された操作を実行できます。
送信されたリクエストが目的外またはサポート対象外の場合、ビルドエージェントはリクエストを拒否し、変更が部分的に実装されることを防ぎます。
リクエストは、入力したプロンプトと@メンションしたコンポーネントに基づきます。コンポーネントが指定されていない場合、ビルドエージェントはプロンプトの文脈を理解して、変更対象のコンポーネントを特定します。
1回のセッションでは複雑すぎるリクエストは、小さなタスクに分割してください。たとえば、フォームに複数のワークフローを作成するような大きなリクエストは、1つのプロンプトにまとめず、個別のプロンプトに分割してください。これにより、実行が不完全になるのを防ぎ、結果の精度と信頼性を高めることができます。

AIの利用とデータ

Zoho GenAIのLLMは無料で利用でき、すべてのプロンプトはZoho内で処理されます。一方、外部LLMプロバイダーはそれぞれのシステムでデータを処理します。Zoho Ziaで外部プロバイダーを使用する場合は、ビルドエージェントで機密情報や規制対象の情報を共有しないでください。
ビルドエージェントはZoho CreatorのAI呼び出しやAPI呼び出しを消費しません。ただし、Zoho Ziaに設定されているLLMプロバイダーによって、APIレート制限が適用される場合があります。これらの制限は、指定された期間内にユーザーまたはクライアントがサービスにアクセスできる回数に対してLLMプロバイダーが課す制限であり、利用プランと使用するモデルによって異なります。LLMプロバイダーのレート制限については、各プロバイダーの公式ドキュメントを参照してください。

ユーザーのプロンプトに加えて、ビルドエージェントの回答精度を高めるために、システムが補助プロンプトを追加する場合があります。これらのシステム生成プロンプトも、Zoho Ziaに設定されているLLMプロバイダーによるAI利用量としてカウントされます。

サポート対象外の操作

ビルドエージェントでは、現在、次の操作はサポートされていません。

全般：データの追加、変更、削除などのデータ関連操作、およびアプリケーションコンポーネントの削除。
フォーム：項目の暗号化、項目の削除、項目の種類の変更、ロール階層設定、フォーム送信通知、モバイル／タブレット向けのカスタマイズ、アプリケーション間の関連付け、フォームの削除。
レポート：ピボットレポート、カスタムの並べ替えとグループ化、データテンプレート、高度なレイアウト、モバイル／タブレット向けのカスタマイズ、レポートの削除。
ワークフロー：Node.jsまたはJavaで記述されたクラウド関数、および承認／決済／バッチワークフロー。