ZiaアシスタンスによるDelugeスクリプトの生成

ZiaアシスタンスによるDelugeスクリプトの生成

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

Notes
メモ:
レート制限について
  1. Zoho Zia は Zoho Creator の AI コールや API コールを消費しません。ただし、API のレート制限は引き続き適用される場合があります。レート制限とは、LLM プロバイダーが、特定の期間内にユーザーまたはクライアントがサービスへアクセスできる回数に対して設ける制約であり、利用プランや使用するモデルによって異なります。
  2. 各 LLM プロバイダーのレート制限は、それぞれの公式ドキュメントで確認できます。
    1. OpenAI のレート制限
    2. Google Gemini のレート制限
    3. Anthropic のレート制限
生成されたスクリプトは、他のあらゆる AI と同様、常に正確であるとは限りません。ただし、信頼性を最大化できるよう継続的に改善を行っています。
生成されるスクリプトは適応的に変化します。同じプロンプトでも、学習状況に応じて、異なるスクリプトが生成される場合があります。

1. Deluge Zoho Zia Assistance の概要

Zoho Zia Assistance は、会話形式のプロンプトから要件を理解し、Deluge エディター上で直接 Deluge スクリプトを生成できます。Zoho Zia Assistance は、GenAI を基盤とした自然言語処理（NLP）や機械学習などの先進技術を活用し、複雑なスクリプト作成をより簡単かつ効率的にします。Deluge のベストプラクティスに従うことで、潜在的なエラーを減らし、最適化された信頼性の高いスクリプトを提供して、実装までの時間を短縮し、開発プロセス全体を向上させます。
Idea

2. 提供状況

  1. Creator の有料プランで利用可能
  2. 米国 (.com)、欧州 (.eu)、インド (.in)、オーストラリア (.au)、カナダ (.ca) の各データセンターで利用可能

3. 概要

Zoho Zia Assistance は、GenAI を搭載した高度で信頼性が高く、コスト効率に優れたモデルであり、自然言語処理（NLP）を活用しています。会話形式のプロンプトから要件を解釈し、Zoho Creator 上で Deluge スクリプトを生成します。Zoho Zia は、ワークフローや関数内の Deluge エディターから直接アクセスでき、Deluge スクリプト作成をリアルタイムで支援します。これにより、スクリプト作成プロセスが加速・効率化されます。アプリケーションのメタデータを解析することで、フォーム間の既存の関連性を考慮した最適なスクリプトを生成します。また、関連するワークフローや関数内でサポートされていない処理を自動的に除外し、Deluge コーディングをより扱いやすく、エラーの少ないものにします。

Creator の Deluge エディターで Zoho Zia Deluge Assistance を利用するには、次の一度きりのセットアップが必要です。
  1. API キーの作成 - Zoho Zia は複数の異なる API 上で動作するため、Zoho GenAI を LLM プロバイダーとして使用する場合を除き、利用したい GenAI アカウントで API キーを作成する必要があります。
  2. Zoho Zia の設定と Deluge Assistance の有効化- Zoho Creator 内で Deluge Assistance を有効にするには、生成した API キーを使用して Zoho Zia を設定する必要があります。

4. 動作イメージ


5. ビジネスユースケース

ケース 1: 招待メール送信用スクリプトの生成

ある組織が営業活動を管理するために Zoho Creator の Sales アプリケーションを利用しているとします。顧客エンゲージメントを高めるために、新しい顧客が追加されたタイミングで自動的に招待メールを送信したいとします。従来であれば、「成功時」アクションを持つワークフローを設定し、send mail タスクを使ったスクリプトを記述する必要がありました。しかし Zoho Zia Assistance を使えば、このプロセスを簡略化できます。自然言語のプロンプトを入力するだけで、Zoho Zia がワークフローとアプリケーションのメタデータを解析し、必要なスクリプトを自動生成します。
ご覧のとおり、スクリプトが「成功時」ワークフローアクション内で記述されることを踏まえ、Zoho Zia は input キーワードを使用してフォーム項目に適切にアクセスしています。また、生成されたスクリプト内にはサンプルのメール本文も含まれています。
  1. 新しい顧客データがフォームに追加されるたびに、その顧客のメールアドレス宛に招待メールを送信する。

ケース 2: 2 つの日付項目間の日数を計算する

組織全体でタスクを計画・割り当てるための情報を保存する「Project Details」フォームを備えた Creator のプロジェクト管理アプリケーションがあるとします。プロジェクトを予定どおり進行させるには、「Project Details」フォームの開始日と終了日の間に利用可能な営業日数（週末と祝日を除く）を算出することが重要です。そのためには、特定のタスクに対する正確な稼働日数を求める Deluge スクリプトが必要になります。Zoho Zia AI Assistant を利用すれば、以下のようなプロンプトを入力するだけで、このスクリプトを簡単に生成できます。
  1. 営業日数を計算するスクリプトを作成してください。対象は Start_date と End_date の間の日数です。
Info
Info:
- Start_date と End_date は、日付項目の 2 つのフィールドリンク名です。

6. Zoho Zia AI Assistant のセットアップ

Zoho Zia AI Assistance のセットアップは一度行うだけで、アプリケーションの作成やフォームの作成、次の項目候補の有効化、スクリプトの生成など、すべての Zoho Zia 機能にアクセスできるようになります。すでに Creator アカウントで Deluge Assistance 用の Zoho Zia をセットアップ済みの場合は、Zoho Zia を使ったスクリプト生成に直接進むことができます。

6.1. 前提条件

GenAI
  1. LLM プロバイダーとして Zoho GenAI を選択した場合、Zoho Creator とすでに統合されているため API キーは不要です。Zoho Zia の設定セクションに直接進んでください。
OpenAI
Info
GenAI として OpenAI を選択した場合は、有料プランを利用しており、OpenAI API キーが動作するだけの十分なAPI クレジットがあることを確認してください。
  1. この機能を Creator で利用するには、有効な OpenAI アカウントと、そのアカウントで発行した API キーが必要です。OpenAI API キーを取得するには、
    1. OpenAI アカウントで Settings に移動し、Billing セクションを選択します。
    2. Settings ページで Add Payment Details ボタンをクリックし、必要な支払い情報を追加します。

    3. 次に、API keys セクションに移動し、Create new secret key をクリックします。
    4. 任意で名前を入力し、対象のプロジェクトを選択します。
    5. Create secret key をクリックします。キーが生成されるので、コピーして Creator の Zoho Zia 設定で使用します。

  2. Zoho Zia を使ってアプリやフォームを作成する前に、Zoho Zia 設定でOpenAI API キーを必ず設定し、Creator アカウントで Zoho Zia - Open AI integration を有効にしてください。

Google

Infoinfo: GenAI として Google を選択した場合は、課金が有効になっている Google Cloud プロジェクトと、Google AI API へのアクセス権が必要です。 これは、当該 API が Google Cloud サービスの一部であり、利用状況の管理と生成 AI 機能へのアクセスを確保するために、有効なプロジェクトと課金設定が必要となるためです。
Creator で Google を利用するには、有効な Google Cloud アカウントが必要です。Google AI API キーを取得するには、次の手順を実行します。

  1. Google AI Studio にアクセスします。

  2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。上部メニューバーでGet API keyをクリックします。

  3. 新しい API キーを生成するには、+Create API keyをクリックします。既存のキーも一覧表示されます。

  4. このキーをコピーして、Creator で Google をプロバイダーとして選択した状態のZoho Zia 設定に貼り付けます。

    Notesメモ:
    - Generative AI API に十分なクォータがあり、お使いのリージョンで利用可能であることを確認してください。
    - アクセス制限については、Google AI ドキュメントを確認してください。 

Anthropic

Info
Anthropic を利用する場合は、API アクセスが含まれるサポート対象プランに加入している必要があります。

Creator で Anthropic の AI モデルを使用するには、API アクセス権を持つ Anthropic アカウントと Anthropic API キーが必要です。
Anthropic API キーを取得するには:

  1. Anthropic アカウントにサインインします。

  2. 左ペインを展開し、API keys をクリックします。

  3. +Create Keyをクリックします。

  4. キー名を入力し、Addをクリックして続行します。

  5. 生成された API キーをコピーし、Anthropic をプロバイダーとして選択した状態の Creator のZoho Zia 設定セクションに貼り付けます。

Notes メモ: アカウントに API アクセス権があり、必要に応じて有料プランを利用していることを確認してください。API の使用制限や課金の詳細については、Anthropic のドキュメントを参照してください。 

6.2. Zoho Zia を設定する

Notes
メモ: Creator で Zoho Zia を設定できるのは、スーパー管理者と管理者のみです。
  1. Creator アカウントで、Operations に移動します。
  2. Applications カードでZoho Ziaをクリックします。Settings画面が表示されます。
    3. Notesメモ: すでに API キーを追加済みの場合、または LLM プロバイダーとして Zoho GenAI を使用している場合は、手順 6 に進んでください。
  3. Configurationタブのドロップダウンから希望するGenAIモデルを選択し、Add API Keyボタンをクリックします。ポップアップが表示されます。
  4. 選択したプロバイダーの API キーを入力し、Addをクリックします。
  5. 追加後にキーを編集または更新するには、Editをクリックします。表示されるポップアップでキーを更新し、Saveをクリックします。
  6. [Enable Features] セクションで、Deluge Assistanceの横にあるAccessボタンを切り替えます。このボタンはデフォルトで無効になっています。有効にすると、Zoho Zia と GenAI の機能を組み合わせてスクリプトを生成できるようになります。

7. AI を使ってスクリプトを生成する

Notes
メモ: Zoho Zia を使用して、あらゆるワークフローや関数の Deluge エディターからスクリプトを生成できます。ここでは説明のために、On Success ワークフローアクション内の Deluge エディターを使用して、Zoho Zia でスクリプトを作成する方法を示します。
  1. ワークフローを作成し、任意のイベントで実行されるように設定してから、Add New Action > Deluge Scriptをクリックして、以下の動画のように Deluge エディターを開きます。

  2. エディターでZoho Ziaアイコン（）をクリックして、Zoho Zia Assistant のチャットウィンドウを開きます。
  3. スライド表示されるウィンドウにプロンプトを入力します。入力したプロンプトに基づいて、Zoho Zia Deluge Assistant が該当するスクリプトを生成します。
  4. 生成されたスクリプトは、コピーアイコン（）をクリックしてコピーするか、Zoho Zia からエディターにドラッグ＆ドロップして挿入できます。
生成されたスクリプトを確認し、そのままワークフローで使用することも、要件に合わせて修正することもできます。アプリケーションのライブモードでワークフローをトリガーし、スクリプトの動作をテストすることを推奨します。開発をより効率的に行うには、環境機能を有効にし、開発環境またはステージング環境のライブモードを使用してスクリプトを効果的にテストできます。
Notes
メモ:
- Deluge エディターを終了すると、Zoho Zia Assistant のチャットウィンドウ内のプロンプトと応答はすべてクリアされます。
- 生成されたスクリプトに対してフィードバックを送信するには、サムズアップ／サムズダウンボタンを使用できます。これにより、お客様のプロンプトとスクリプトが共有され、Zoho Zia の精度向上に役立てられます。

7.1. プロンプトのガイドライン

  1. プロンプトを入力する際は、明確で適切な表現を使用することを推奨します。乱暴な表現やあいまいな表現を使用すると、正確でない応答につながります。たとえば、フォームのある項目に保存されている特定のメールアドレス宛にメールを送信したい場合は、より正確なスクリプトを生成するために、フォーム名、メール項目名、メールを抽出する条件、件名の内容をプロンプト内で明確に指定することをお勧めします。
  2. 作成済みコンポーネントを正確なスクリプト生成に活用するために、プロンプトとあわせてコンポーネント名、リンク名、項目名、または項目リンク名を指定できます。
  3. 構造化されたプロンプトの例:
    1. 「製品の配送状況を追跡するために、『Orders』フォームの『Email』項目にあるアドレス宛にメール通知を送信するスクリプトを作成してください。」
    2. 「コレクション変数内の要素を更新し、更新後の変数を返すスクリプトを書いてください。」

8. API 使用量の管理

選択した LLM プロバイダーの月次 API 使用量を確認するには、次の操作を行います:
  1. Operations> Zoho Zia > Usage に移動し、ボタンをクリックします。選択した GenAI 開発プラットフォームのログインページにリダイレクトされます。ログイン後、GenAI プロバイダーのダッシュボードから、組織内での API の月次使用量を確認できます。

9. 制限事項

  1. 生成されるスクリプトは、他の GenAI と同様に、常に正確であるとは限りません。ただし、精度向上に継続的に取り組んでいます。
  2. 生成されるスクリプトは適応的であり、マシンの学習状況に応じて、同じプロンプトでも異なる応答が返される場合があります。
  3. プロンプトと要件に基づき、Deluge Zoho Zia アシスタンスは、レコードの削除や重要なデータの変更などの処理を行うスクリプトを生成できます。意図しないデータ損失や変更を防ぐため、実行前に必ず生成されたコードの内容を慎重に確認することを推奨します。
  4. OpenAI API のレート制限: レート制限とは、OpenAI の API が、一定期間内にユーザーまたはクライアントがサービスへアクセスできる回数に課す制限であり、利用プランや使用するモデルによって異なります。Zoho Zia は OpenAI の API キーを使用して動作するため、これらのレート制限が適用されます。この連携で使用している API キーに紐づくアカウントのレート制限を確認するには、https://platform.openai.com/account/limits にアクセスしてください。
  5. Google（Gemini）API のレート制限: Google もレート制限を設けており、特に Gemini API の無料枠では制限が厳しくなっています。無料枠の制限（Gemini 2.0 Flash）:
    1. 1 分あたり 15 リクエスト（RPM）
    2. 1 日あたり 200 リクエスト（RPD）
    3. 1 分あたり 1,000,000 トークン（TPM）
    4. Google におけるレート制限の仕組みについて詳しく見る
    Notesメモ: 複数のアプリを同時に作成しようとすると、レート制限エラーが発生する場合があります。たとえば、短時間に連続して複数のアプリを作成すると、15 RPM の制限を超過してエラーになる可能性があります。
  6. Anthropic API のレート制限: Anthropic では、ユーザーはデフォルトで有料の Tier 1 プランに設定されており、一般的に十分な使用量が許容されています。ただし、レート制限は依然として適用され、1 分あたり 50 リクエスト（RPM）に制限されています。Anthropic におけるレート制限の仕組みについて詳しく見る
    7. Notesメモ: 制限は比較的緩やかですが、特にアプリを高速に連続作成するような高頻度の処理では影響を受ける可能性があります。
  7. お客様のプロンプトに加えて、スクリプト生成の精度を高めるために、システム側で補助的なプロンプトを追加します。これらのシステムプロンプトも GenAI の使用量としてカウントされます。
  8. 1 ユーザーが 1 分間に送信できるプロンプトは最大 20 件です。
  9. Zoho Zia Deluge Assistance は、ページスクリプトおよびアプリケーション IDEでは利用できません。
  10. Zoho Zia によって生成されるスクリプトには、Zoho Creator アカウント内のカスタム関数の呼び出し、アプリ変数、接続、およびユーザーの詳細は含まれません。
  1. Creator における Zoho Zia 機能について
  2. Zoho Zia アシスタンスを使用してフォームを作成する
  3. AI 補助フォーム向けの項目候補を生成する