Agent Studio - FAQ ​

Agent Studioは、AIエージェント（Genie）を構築および設定する場所です。 これらのGenieは、定義した目標を達成するために、アクションを実行し、ワークフローを呼び出し、コンテキストを理解し、事前定義されたスキルを実行します。

Genieは、Agent Studioで構築されるAI搭載エージェントで、定義した目標を追求し、コンテキストに適応し、アプリとデータシステム全体で動作します。

Genieは、次の主要コンポーネントを通じて動作します：

• AIモデルとジョブの説明を組み合わせることで、Genieの頭脳と指示が形成されます。 これらのコンポーネントはLLMを使用して、リクエストの解釈、コンテキストの分析、意思決定、応答の生成を行い、Genieの動作、ペルソナ、制約を定義します。 GenieはデフォルトでAnthropic Claudeを使用します。 LLMをOpenAI GPTまたは独自のLLMコネクションに切り替えることができます。
• チャットインターフェースは、ユーザーがGenieと会話できるユーザーインターフェースを提供します。 チャットインターフェースとしてSlack、Microsoft Teams、またはWorkato GOを使用できます。
• ナレッジベースは、会社固有の情報、会話履歴、メタデータを保存します。
• スキルは、さまざまなアプリケーションやシステムとのやり取りを可能にします。

Geniesは、特定の料金プランのお客様が利用できるAgentic機能です。 GenieはUS、EU、AU、SG、JPのデータセンターで利用できます。 GenieモデルはUS、EU、APACリージョンでホストされ、可能な限りデータレジデンシー要件に準拠します。

この機能を使用する前に、アカウントでGenieが有効になっていることを確認する必要があります。 ワークスペースにGenieオプションが表示されない場合、または追加情報が必要な場合は、Customer Success担当者に連絡してGenieを有効にしてください。 詳細については、ご利用の料金プランおよび契約を参照してください。

いいえ。 AHQ親ワークスペースでAgent Studioを有効にすると、すべての子ワークスペースで利用できるようになります。 先に親ワークスペースで有効にせずに、特定の子ワークスペースに対してAgent Studioを有効にすることはできません。

コラボレーター権限を使用して、各ワークスペースでAgent Studioにアクセスできるユーザーを制御できます。

AI Hubに移動してGeniesタブをクリックすると、Genieを表示および設定できます。 詳細については、Genieの開始方法を参照してください。

Agent Studioは、Genie向けの3つのLLMオプションをサポートしています。

• Anthropic Claude（デフォルト）
• OpenAI GPT
• 独自のLLMコネクションを使用（BYOLLM）

AIモデルは、Genieを停止した後にのみ変更できることに注意してください。

Genieを次のチャットインターフェースにデプロイできます。

• Slack
• Microsoft Teams
• Workato GO

Genieの作成後にチャットインターフェースを変更することはできない点に注意してください。

Genieは最大25MBのファイルと画像のアップロードをサポートしています。

.pdf、.doc、.csvなどの一般的なドキュメントファイルタイプがサポートされています。 サポートされているファイルタイプの完全なリストについては、ファイルを参照してください。

.jpgや.pngなどの一般的な画像形式がサポートされています。 動画ファイルはサポートされていません。 サポートされている画像形式の完全なリストについては、画像を参照してください。

詳細な手順については、最初のGenieを作成するを参照してください。

Genieを動作させるには、次のコンポーネントを設定します。

• ジョブ説明: Genieの役割と目標を定義します。
• チャットインターフェース: ユーザーがGenieとやり取りする場所を選択します。 オプションはSlack、Microsoft Teams、またはWorkato GOです。
• AIモデル: Genieを動作させるLLMを選択します。 オプションはAnthropic Claude、OpenAI GPT、または独自のLLMコネクションです。
• ナレッジベース: Genieのナレッジソースを設定します。
• スキル: Genieがアクションを実行できるようにします。

すべてのコンポーネントをまとめて作成する手順については、最初のGenieを作成するを参照してください。

GenieのOverviewページでは、次を追跡できます。

• 合計会話数：毎日開始された個別の会話
• エンドユーザーメッセージ合計数：エンゲージメントを把握するためのメッセージ量
• ユニークユーザー数：導入状況を測定するための個別ユーザー
• 応答時間：平均、中央値、および90パーセンタイルの応答時間
• 会話量：時間の経過に伴う会話
• スキル利用状況ヒートマップ：スキルの実行頻度と成功率

期間でメトリクスをフィルターできます。

注：Workato GOを使用するGenieでは、カスタムビジネスKPIも追跡できます。 詳細については、アクションボードセクションを参照してください。

ナレッジベースはGenieのメモリとして機能し、次の機能を提供します:

• Genieが役割を実行するためのコンテキスト参照として重要なデータや情報を保存します。
• リアルタイムで更新できるため、Genieは常に最新の情報を保持できます。
• メタデータにアクセスして、作成日、ソース、ナレッジベースIDなどの属性でフィルタリングできます。

ナレッジベースを作成するには、次の手順を実行します:

ナレッジベースをGenieに追加するには、次の手順を実行します:

はい。 ナレッジベースは、Genieが異なるプロジェクトにある場合でも、複数のGenie間で共有できます。 これにより、重複させることなく、同じナレッジベースを異なるGenie間で再利用できます。

ナレッジレシピでStore document in a knowledge baseアクションを使用する場合、次のファイル形式がサポートされます:

• PDF（.pdf）
• Microsoft Word（.docx）
• Microsoft Excel（.xlsx）
• Microsoft PowerPoint（.pptx）

ポリシー、ガイド、説明などの非構造化コンテンツに対するセマンティック検索には、ナレッジベースを使用します。 構造化データに対する完全一致のルックアップ、カウント、およびフィルター付きクエリには、データベース（スキルを通じてアクセス）を使用します。

詳細については、ナレッジベースとデータベースを参照してください。

ナレッジベースはセマンティック検索を使用しますが、JSONやCSVのような構造化形式の処理は苦手です。 未加工の構造化データでは、セマンティック検索がキー値ペアや繰り返しのフィールド名を効果的に解析できないため、検索結果の品質が低くなります。

解決策: 構造化データをナレッジベースに追加する前に、読みやすい文章に変換します。 たとえば、次のように変換します:

• 未加工: {"ticket_id": "12345", "status": "open"}
• 文章: "Acme Corpのサポートチケット#12345 - ログインタイムアウトの問題（ステータス: オープン）"

ナレッジベースとデータベースを使い分けるタイミング:

• 類似する問題の検索やパターンの発見など、セマンティック検索にはナレッジベースを使用します。
• カウント、フィルタリング、完全一致の検索などの構造化クエリには、スキルを通じてアクセスするデータベースを使用します。

形式の例については、JSONとAPIアプリケーションデータを準備を参照してください。

ナレッジベースはセマンティック検索用に設計されており、包括的なクエリ用ではありません。 各クエリは、関連性が最も高い10件のドキュメントのみを返します。 つまり、how many invoices are overdue?と質問すると、何百件存在する場合でも、Genieに表示される一致は10件だけです。

解決策: 件数の取得、集計、包括的な一覧には、スキルを通じてアクセスするデータベースを使用します。 データベースは一致するすべてのレコードをクエリし、正確な件数を返します。

各オプションを使用するタイミングのガイダンスについては、ナレッジベースとデータベースの比較を参照してください。

ナレッジベースはドキュメントを重複のない8,000文字のチャンクに分割します。 つまり、チャンクの境界で概念の途中が分割されている場合や、重要なコンテンツがドキュメントの奥深くに埋もれている場合、Genieが情報を見つけられないことがあります。

クイック修正:

• 見出しでドキュメントを構造化し、段落の途中ではなく自然な区切りでチャンクが分割されるようにします。
• 重要な情報を前方に配置し、ドキュメントの最初の2,000文字以内に含めます。
• 関連する概念をまとめて配置し、8,000文字のセクション内に収めます。

詳細については、ナレッジベースドキュメントの準備を参照してください。

Agent Studioには、複数のセキュリティ制御が用意されています。

アクセス制御:

• エンドユーザーグループを使用して、特定のGenieを使用できるユーザーを制御します。
• スキルが個々のユーザー権限で実行されるように、Verified User Access（VUA）を設定します。

監査:

• Genieログは、スキルの実行とユーザー操作を追跡します。
• VUA対応スキルでは、監査証跡で各アクションを実行したユーザーが表示されます。

ガバナンス:

• Genieは、明示的に追加されたスキルのみを実行できます。
• スキルは、接続先アプリの権限とアクセス制御に従います。

Verified User Access（VUA）を使用すると、スキルはレシピビルダーの認証情報ではなく、各エンドユーザー自身の認証情報で実行できます。 エンドユーザーは、VUA対応スキルを初めて使用するときに一度認証し、チャット内の!list_connectionsキーワードを使用してコネクションを管理できます。

コネクションタイプ:

スキルでは、2つのアプローチがサポートされています。

エンドユーザーのコネクション（VUAを使用した個別認証情報）:

• アクションは、各エンドユーザーのIDと権限で実行されます
• ユーザーレベルの監査証跡を提供します
• 接続先アプリ内の個々のアクセス権を尊重します
• OAuth 2.0認可コードグラントコネクションが必要です

このレシピのコネクション（ビルダーの認証情報）:

• アクションは、レシピビルダーのコネクションで実行されます
• 標準のWorkatoレシピと同じように動作します

VUAを使用する場合: ユーザーレベルの監査、権限の適用、または共有認証情報のセキュリティリスクの排除が必要な場合は、個別の認証情報を使用します。 個々のユーザー権限が不要な場合は、ビルダーの認証情報を使用します。

スキルへのVerified User Accessの追加を参照してください。

アプリイベントを使用すると、Genieはユーザーが会話を開始するのを待つ代わりに、外部システム（SalesforceやZoomなど）からのトリガーに応答してプロアクティブに動作できます。

たとえば、NetSuiteアクセスリクエストが承認されると、IT Genieはユーザー入力なしで次のステップを自動的に処理できます。

アプリイベントは複雑なタスクを自動化し、適切なタイミングで関連する作業を提示し、プロセスの早い段階でGenieにコンテキストを提供します。

エージェントオーケストレーションを使用すると、Genieはレシピ内で自律的に作業できます。 レシピはユーザー入力なしでGenieにタスクを割り当てることができ、Genieはサブタスクを他のGenieに委任できます。

レシピがAssign task to genieアクションを使用すると、Genieがタスクを自律的に処理している間、レシピジョブは一時停止し、Genieが応答を返すと再開します。 これにより、あるGenieが別の専門的なGenieに証拠収集を委任するコンプライアンス監査のような、複雑なマルチエージェントワークフローが可能になります。

エージェントオーケストレーションには次の制限があります:

• 検証済みユーザーアクセススキルを使用するGenieは、Assign task to genieアクションでは使用できません。
• Business approvalsを必要とするGenieは、自律タスクを処理できません。

はい。 スキル、ナレッジベース、Genieを複数のプロジェクト間で共有して使用できます。

• スキル: 1つのプロジェクトのスキルを、他のプロジェクトのGenieに追加できます。 これにより、チームはレシピを複製せずにスキルを再利用できます。
• ナレッジベース: 1つのプロジェクトのナレッジベースを、他のプロジェクトのGenieに割り当てることができます。 どのプロジェクトに属しているかに関係なく、任意のプロジェクトのレシピはナレッジベースにナレッジを保存し、アプリイベントをGenieに送信することもできます。
• Genie: 他のプロジェクトのレシピからGenieにタスクを割り当てることができます。 Genieはエージェントオーケストレーションを使用して、他のプロジェクトのGenieにサブタスクを委任することもできます。

スキル、ナレッジベース、Genieは、設定やコネクションを失うことなく、プロジェクト間で自由に移動することもできます。

ユーザーがGenieにアクセスできない、またはGenieが応答しない場合は、次を確認してください：

• Genieが開始されていること：AI Hub > Genieでステータスを確認します。
• エンドユーザーアクセスが設定されていること：AI Hub > Genie > End user accessでユーザーグループを追加します。
• Workato Identityアカウントが有効化されていること：ユーザーに招待メールが届いている必要があります。
• 正しいユーザーグループが割り当てられていること：Genieに割り当てられていることを確認します。
• Genieがチャットインターフェイスに正しく接続されていること。

これはSlack、Microsoft Teams、およびWorkato GOのGenieに適用されます。

手順ごとの説明については、ユーザーグループの作成を参照してください。