Agentic - FAQ ​

Agent Studioは、ビジネスシステム全体でアクションを実行できるGenie（AIエージェント）を構築する場所です。

Workato GOは、ユーザーがGenieと対話するチャットインターフェイスと、接続されたデータソース全体のエンタープライズ検索を提供します。

MCPは、Workato連携を、Claude、ChatGPT、Cursorなどの外部AIアプリケーションが使用できるツールとして公開します。

Agent Studio、Workato GO、MCPは、いくつかの方法で接続されます。

• Agent Studioで構築したGenieは、チャットインターフェイスとしてWorkato GOにデプロイできます。
• Workato GOのデータソース（Google DriveやSlackなど）は、Genieのナレッジベースに取り込むことができます。
• スキルはGenieが直接使用することも、外部AIクライアント向けのMCPツールとして公開することもできます。
• MCPサーバーにより、Genieと外部AIクライアントの両方が同じWorkato連携を使用できます。

Genieは、Workatoがホストおよび管理するAIエージェントです。会話の管理、ナレッジの取得、使用するスキルに関する意思決定を処理します。

MCPサーバーは、Workatoの機能を、外部AIクライアントが使用できるツールとして公開します。外部AIクライアントは会話を管理し、Workatoツールを呼び出すタイミングを決定します。

次の場合はWorkato Genieを使用します。

• WorkatoにAIエージェントのホストと管理を任せたい場合
• ユーザーがSlack、Microsoft Teams、またはWorkato GOを通じて対話する場合
• 会社固有のコンテキストに対応する組み込みナレッジベースが必要な場合
• プロアクティブなアクションをトリガーするビジネス承認またはアプリイベントが必要な場合

次の場合はMCPを使用する外部AIクライアントを使用します。

• 組織がすでにClaude Desktop、ChatGPT、またはCursorを使用している場合
• これらのAIクライアントからWorkatoの機能にツールとしてアクセスできるようにしたい場合
• Workato連携を必要とするカスタムAIアプリケーションを構築している場合
• AIコーディングアシスタントにビジネスシステム連携を使用させたい場合

両方のアプローチを使用できます。スキルを一度構築してから、それらをGenieにデプロイするか、MCPを通じて外部AIクライアントに公開します。 Genieは、追加のツールとしてMCPサーバーを利用することもできます。 MCPサーバースキルの詳細をご覧ください。

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のチャットインターフェイスを使用して、Genieとの会話をトリガーできます。
• ナレッジベースは、会社固有の情報、会話履歴、メタデータを保存します。
• スキルは、さまざまなアプリケーションやシステムとのやり取りを可能にします。

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 > Agent Studioに移動すると、Genieを表示および設定できます。詳細については、Genieの開始方法を参照してください。

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

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

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

Genieのチャットインターフェースでは、次のオプションを使用できます:

• Slack
• Microsoft Teams
• Workato GO
• カスタムインターフェース

カスタムインターフェースのみがHeadless APIを使用できます。 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に適用されます。

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

スキルは、GenieとMCPクライアントがビジネスシステムでアクションを実行できるようにするツールです。スキルは、データのクエリ、レコードの作成、メッセージの送信、チケットの更新、またはWorkatoレシピで実行できる任意のアクションを実行できます。スキルの動作を支えるコネクターについては、Workato Skillコネクターを参照してください。

はい。スキルは、Genieが異なるプロジェクトに属している場合でも、複数のGenie間で共有できます。共有により、重複させることなく、異なるGenie間でスキルを再利用できます。

はい。スキルをコミュニティライブラリで共有できます。

いいえ。 Workato Genieコネクターで構築された既存のスキルは、引き続き機能し、Genieへの割り当てに利用できます。

Workato GenieコネクターのStart workflowトリガーとReturn responseアクションは非推奨です。引き続き動作しますが、新しい機能強化は提供されません。

いいえ。移行は任意であり、自分のペースで行えます。新しいスキルは、作成場所に関係なく自動的にWorkato Skillコネクターを使用します。手順については、既存のスキルを移行するを参照してください。

新しいスキルは、作成場所に関係なく自動的にWorkato Skillコネクターを使用します。

いいえ。既存の事前構築済みMCPサーバーに変更はありません。新しく追加された事前構築済みMCPサーバーは、Workato Skillコネクターを使用します。

はい。 Business MCPおよびEnterprise MCPプランのお客様は、Agent Studioライセンスなしでスキルを作成して使用できます。

はい。 Workato Skillコネクターで構築されたスキルは、Workato Genieコネクターで構築されたスキルと同様に、Genieに割り当てることができます。 Genieビルダーには両方のスキルタイプが表示されます。

はい。 Workatoでは、スキルの作成時にStart workflowトリガーがデフォルトとして設定されます。ただし、トリガーを設定した後は、別のトリガーに置き換えて、エージェントの呼び出しではなく外部イベントからレシピを実行できます。これは、トリガーが固定されていたWorkato Genieコネクターで構築されたスキルとは異なります。

Start workflowトリガーを置き換えると、そのスキルは割り当て先のすべてのGenieおよびMCPサーバーから完全に削除され、このアクションは元に戻せません。この変更を行う前に、レシピエディターに確認を求めるプロンプトが表示されます。元のトリガーの結果スキーマで定義されたフィールドは、Return responseアクションで引き続き利用できます。

レスポンスを返すアクションの最大レスポンスサイズは250 KBです。この制限を回避するには、より大きな結果をストリーミング可能なデータピルとして渡すことができます。詳細については、大きな結果をストリーミングを参照してください。

いいえ。結果フィールドはバイナリファイルコンテンツをサポートしていません。この制限を回避するには、レシピの早い段階で、エージェントがアクセスできるファイルストレージの場所（Workatoファイルストレージ、Amazon S3、Google Driveなど）にファイルをアップロードします。次に、ファイルURLまたはIDを文字列フィールドとして返します。エージェントは、その参照を使用してファイルを取得します。

はい。 Developer APIは、Workato SkillコネクターまたはWorkato Genieコネクターのいずれかで構築されたスキルをサポートしています。エンドポイントの詳細については、Workato APIリファレンスのスキルを参照してください。

Formulaモードの代わりにテキストモードを使用した場合、またはRecordsデータピルではなく個々のフィールドデータピルを選択した場合、Return responseアクションは1件のレコードを返すことがあります。テキストモードでは、コレクションから最後のレコードのみが返されます。

これは、Workato SkillコネクターのReturn response（レスポンスを返す）アクションと、従来のWorkato GenieコネクターのReturn response to Genie（Genieにレスポンスを返す）アクションの両方に適用されます。

この問題を解決するには、次の手順を実行します:

詳細はテキストモードとFormulaモードを参照してください。

LLMは数学演算を実行するのではなく、トークンを予測して応答を生成します。これにより、正確な算術でエラーが発生する可能性があります。特に複数ステップの計算や財務計算で発生します。

解決策: Genieに、計算を正確に実行するPythonコード実行スキルへのアクセス権を付与します。スキルは計算リクエストをインターセプトし、正確な結果を返します。

これが重要になる場合:

• 財務計算（経費報告書、予算、請求書）
• 複数ステップの算術（合計、集計、割合）
• 正確な数値結果が必要なあらゆるシナリオ

実装手順と事前構築済みのスキルテンプレートについては、算術エラーのトラブルシューティングを参照してください。

Workato GOは、AI主導のワークフロー、ナレッジ検索、トランザクション型インタラクションを単一の一貫したインターフェースに統合するエンドユーザーインターフェースです。分断されたツール、検索システム、ワークフローを切り替える必要がなくなります。

主な機能:

• ナレッジ検索: 公開リソースと複数のサードパーティアプリケーションを組み合わせ、Google Drive、Slack、Confluence、Salesforceなどの内部データソース全体から回答を見つけます。
• 統合チャット: ユーザーは単一のプロンプト駆動型インターフェースを通じて、エージェントおよびエンタープライズデータと対話できます。
• コンテキスト対応ルーティング: クエリに最適なのがGenie、検索結果、またはその両方かを判断します。
• シンプルなタスクフロー：アプリ間の切り替えを避けるため、フォーム、承認、ユーザー確認がインターフェースに組み込まれています。

Workato GOは2つのナレッジソースを提供します:

• World knowledge: 公開されている情報全体を検索
• Company knowledge: 自社のサードパーティアプリおよび内部ドキュメント全体を検索

Workato GOは、Confluence、Salesforce、Slack、Google Drive、Jira、Gmail、Gongなどを含む幅広いデータソースを標準でサポートしています。カスタムWebクローラーデータソースを追加して、内部ドキュメントサイトまたは公開Webページをインデックス化することもできます。

次の手順を実行してサブドメインを設定します：

サブドメインは3～65文字である必要があります。カスタマイズしない場合は、一意のランダムに生成されたサブドメインがデフォルトで提供されます。

はい、組織プロパティを使用して会社名とロゴをカスタマイズできます：

ロゴの要件：公開URL、透明な.pngまたは.svg、210x40pxの寸法、200 KB未満。

次の手順を実行して、Workato GOに管理者を追加します：

管理者はデータソースを管理し、アクティビティログを表示できます。

Workato GOは、ライトテーマ、ダークテーマ、デバイスと同期の3つのテーマをサポートしています。デバイスと同期は、オペレーティングシステムの設定に合わせます。

サイドナビゲーションバーのプロフィールアイコンをクリックして環境設定を開き、希望するテーマを選択すると、テーマを変更できます。

詳細については、テーマを選択を参照してください。

データソースを使用すると、Workato GOをJira、Confluence、Salesforce、Google Driveなどのビジネスシステムに接続し、エンタープライズ検索やAIワークフローで利用できます。これにより、検索結果に実際のビジネスコンテキストが反映され、Genieは現在のデータを取得してタスクを完了できます。

各データソースには固有の設定要件があります。データソースを追加するには、Workato GOの管理者権限が必要です。

セットアップ手順については、コネクター固有のドキュメントを参照してください：

• Confluence
• Gmail
• Gong
• Google Calendar
• Google Drive
• Highspot
• Jira
• Okta
• Salesforce
• Slack
• Zendesk

カスタムWebページ：内部ドキュメントサイトまたは公開Webページをインデックス化するために、カスタムWebクローラーデータソースを追加することもできます。 Webクローラーデータソースを追加するを参照してください。

はい、Google Driveクローラーのスコープを制限して、対象を特定のユーザーのファイルに限定できます：

これにより、インデックス化をパイロットグループや特定の部門に限定したり、機密コンテンツへのアクセスを制限したりできます。

Workato GOは、ソースシステムのネイティブ権限を尊重します：

• 特定のユーザー専用の非公開ドキュメントは、他のユーザーの検索には表示されません
• フォルダーレベルのセキュリティ権限が維持されます（例：Google Drive）
• クロールまたはインデックス化するユーザーを制限できます
• 権限を認識したクロールにより、ユーザーにはソースシステムでアクセス権を持つコンテンツのみが表示されます

アクションボードは、Agent Studioで設定されたKPIメトリクスを可視化する、Workato GO内のカスタマイズ可能なダッシュボードを表示します。アクションボードには次が表示されます:

• 各GenieのリアルタイムKPIメトリクス。チャート、テーブル、または積み上げメトリクス用のカスタマイズ可能なサムネイルを使用します。
• 右側のパネルの未処理のアクションアイテム。自分宛てのビジネスイベントや、自分に割り当てられた承認が含まれます。
• 定義済みのロールとジョブ説明を持ち、対話形式で操作できるGenieウィジェット。

重要: アクションボードとKPIタブは、チャットインターフェイスとしてWorkato GOを使用するGenieでのみ利用できます。アクションボードは、SlackまたはMicrosoft Teamsを使用するGenieをサポートしていません。

アクションボードを使用するには、次が必要です:

• チャットインターフェイスとしてWorkato GOが設定されたGenieがある。
• Genie用のKPIを少なくとも1つ作成する。
• メトリクスを表示するアクションボードのサムネイルを少なくとも1つ設定する。
• アクションボードのサムネイルを表示するための適切なユーザーグループ権限がある。

アクションボードの詳細を確認してください。

KPI（Key Performance Indicators）は、会社の目標に向けた進捗を定量化する測定値です。 KPIは、KPIスキルが参照する頻繁に使用されるデータを保存するためにData tablesを使用します。

ワークフローは次のとおりです:

1. エンドユーザーがKPIスキル（例: New lead）をトリガーします。
2. スキルが設定済みのData tablesに書き込みます。
3. Workatoはこの情報を読み込み、設定済みのタスクと組み合わせます。
4. KPIレポートが生成され、アクションボードのサムネイルに表示されます。

アクションボードは4種類のサムネイルタイプをサポートしています:

• カード形式（デフォルト）
• Metric & chart
• Stacked metrics
• Detailed table

各アクションボードで使用できるサムネイルは5つまでです。

KPIの作成の詳細を確認してください。

これは通常、Server-Sent Events（SSE）コネクションがブロックまたは終了されたことが原因です。 SSEはブラウザー固有の問題ではなく、ネットワークレベルの問題です。

症状:

• チャットメッセージがリアルタイムで更新されない
• コネクションがすぐに閉じるように見える
• 継続的なevent streamを受信しない

診断: 影響を受けるマシンから、ブラウザーのDeveloperツールとcurlコマンドを使用してコネクションを直接テストし、ネットワークがSSEコネクションをブロックしているかどうかを判断する必要があります。

解決策: コネクションがすぐに閉じる、またはイベントをストリーミングしない場合は、IT部門にお問い合わせください。 IT部門は次を行う必要があります:

• ご利用のdata center-specific domainをallowlistに追加します（例: api-prod.matrix.workato.com）
• このendpointへのSSE/streamingコネクションを許可する
• proxy設定で長時間維持されるHTTPコネクションを許可することを確認する
• firewallルールが永続的なコネクションを終了しないことを確認する

詳細については、検索およびリアルタイムチャットの問題のトラブルシューティングを参照してください。

設定後にGenieがWorkato GOに表示されない場合は、以下を確認してください:

• Genieが開始されています（単に設定されているだけではありません）。
• Genieの作成時に、チャットインターフェイスとしてWorkato GOが選択されています。
• AI Hub > Genie > End user accessで、正しいユーザーグループに対してEnd user accessが設定されていること。
• Workato Identityアカウントを有効化済みです。招待メールを確認し、end user accessを有効化してください。
• Genieが自分のuser groupに割り当てられています。

設定完了後もGenieが表示されない場合は、デモまたはdev Environmentではなく、自分のアカウント用の正しいWorkato GO URLにアクセスしていることを確認してください。

Model Context Protocol（MCP）は、AIモデルが外部システムやデータソースに接続する方法を標準化するオープンプロトコルです。 MCPにより、Workatoの機能（APIコレクション、APIレシピ、レシピ関数、スキル）をAIクライアントが使用できるツールとして公開できます。

MCPの主な利点は次のとおりです。

• AIを外部リソースに接続：AIモデルが外部データやツールにアクセスできるようにし、汎用性と機能を向上させます
• やり取りを標準化：AIモデルがSlack、Jira、Google Driveなどのさまざまなシステムと通信するための一貫した方法を提供します
• Developmentを削減：MCPの標準化により、新しいデータソースごとのカスタムインテグレーションの必要性を削減します

Workatoは次のMCP機能を提供しています。

• MCPサーバー：一意で認証済みのURLを持つリモートのクラウドベースMCPサーバーを通じて、Workato機能（APIコレクション、レシピ関数、APIレシピ、およびスキル）をAIエージェントにツールとして提供できます。
• Verified User Access：MCPサーバーで、静的トークンの代わりに認証済みエンドユーザー資格情報を外部API呼び出しに使用できるようにします。
• Workato Developer APIおよびEmbedded API MCP：Claude DesktopやCursorなどのAI搭載開発者環境から、Workatoワークスペースにプログラムでアクセスできるようにします。

Workato MCPは次と互換性があります。

• Claude（Anthropic）
• カーソル
• Windsurf
• ChatGPT
• Model Context Protocol標準をサポートする任意のMCPクライアント

MCPは、US、EU、AU、SG、JPデータセンターで利用できます。

MCPの使用に関心がある場合、または追加情報が必要な場合は、カスタマーサクセス担当者にお問い合わせください。詳細については、ご利用の料金プランおよび契約を参照してください。

AI Hubで、構築済みテンプレートから開始するか、ゼロから独自に構築することで、MCPサーバーを作成できます。セットアップ手順は、選択する方法によって異なります。

Workatoは、Slack、Google Calendar、Google Sheetsなどの一般的なコラボレーションおよび生産性アプリ、JiraおよびGitHubなどのプロジェクトアプリおよびDevelopmentアプリ、Google DirectoryエンドユーザーおよびOktaエンドユーザーなどのID管理アプリ、Gongなどのセールスオペレーションアプリ向けに、構築済みMCPサーバーテンプレートを提供しています。

利用可能なテンプレートの完全な一覧については、構築済みMCPサーバーページを参照してください。

MCPサーバーをゼロから作成する際は、2つのツールソースタイプのいずれかを選択できます:

APIコレクション

APIコレクション全体をMCPツールとして公開します。これには、標準のAPIレシピコレクションとAIゲートウェイコレクション（APIプロキシコレクション）が含まれます。 APIコレクションはVerified User Accessをサポートしていません。

プロジェクトアセット

プロジェクトフォルダから個々のアセットを選択し、MCPツールとして公開します:

• レシピ関数
• APIレシピ
• スキル

プロジェクトアセットでは、同じMCPサーバー内で複数のアセットタイプを組み合わせることができます。すべてのアセットは同じプロジェクトフォルダ内に存在する必要があります。

詳細はMCPサーバーおよびVerified User Accessを参照してください。

設定手順はAIクライアントによって異なります:

• ChatGPT
• Claude Desktop
• Cursor
• Microsoft Copilot

MCPツールを設計する際は、次の主要な原則に従ってください:

ツール設計の原則:

• シンプル: 各ツールは、特定の1つのアクションまたは取得のみを実行します
• 構成可能: ツールは、連携してシームレスに動作する構成要素として機能します
• 予測可能: ツールは一貫して動作し、標準エラーを返します

データ戦略:

• コンテキストウィンドウを維持するために、必要なフィールドのみを返します
• エージェントに返す前に、AI前処理を使用して大規模なデータセットを要約します

開発者エクスペリエンス:

• 明確なツール名と詳細な説明を記述します
• ツールドキュメントにサンプルリクエストとレスポンスを含めます
• すべてのツールで一貫した命名規則を使用します
• 標準のHTTPステータスコード（200、400、404、500）を実装します

モニタリングと改善:

• 実際のAIワークフローでツールをテストします
• 利用状況パターンを監視し、最も頻繁に使用されているツールに基づいて改善します

MCPは2つの認証方式をサポートしています：

トークンベース認証（デフォルト）：

• 最小限の設定で使用できるシンプルな認証
• トークンは自動的に生成され、MCPサーバー設定で管理されます
• 新しいMCPサーバーにデフォルトで割り当てられます

Workato IdentityとのOAuth 2.0連携：

• Verified User Access（VUA）に必要
• 一元化されたユーザーアクセス管理を提供
• ユーザーレベルの監査証跡とIDを認識した認可を有効化

重要：トークンベース認証からWorkato Identityに切り替えるとMCPトークンが取り消されるため、すべてのクライアントをOAuth 2.0認証用に再設定する必要があります。

Verified User Access（VUA）を使用すると、エンドユーザーはMCPツールを操作する際に自分の認証情報で認証でき、AIワークフローにエンタープライズレベルのガバナンスとユーザーレベルのセキュリティをもたらします。

仕組み：

• エンドユーザーは、MCPサーバーに初めてアクセスするときに1回認証します
• 認証情報は安全に保存され、ツール間で再利用されます
• すべてのツール呼び出しは、個々のユーザー権限に従います
• 各アクションは、ユーザー自身のIDとアクセス権で実行されます

VUAを使用する場合：

• コンプライアンスのためにユーザーレベルの監査証跡が必要な場合
• ツールが個別の権限を必要とする機密データにアクセスする場合
• セキュリティのために共有認証情報を排除したい場合
• 組織でIDを認識した認可が必要な場合

要件：

• MCPサーバーはWorkato Identity（OAuth 2.0）認証を使用する必要があります
• MCPサーバーは、ツールソースとしてプロジェクトアセットを使用する必要があります。 APIコレクションはサポートされていません。
• 選択したツールは、レシピ関数またはスキルである必要があります
• 接続済みアプリケーションは、OAuth 2.0認可コードグラントをサポートしている必要があります。 APIキー、基本認証、その他のOAuth 2.0グラントタイプはVUAでは機能しません。

MCPサーバーでVerified User Access（VUA）を使用するには、次の手順を完了します：

これにより、各ユーザーは自分の認証情報を使用してMCPツールを操作でき、ビルダーの認証情報ではなく、認証済みユーザーとしてアクションが実行されます。

はい。 MCPサーバーのSettings（設定）＞Limits（制限）ページに移動すると、MCPサーバークォータを設定できます：登山口がない。待って。要修正。

• レート制限（スロットリング）: カスタマイズ可能な時間間隔でリクエスト速度を制御し、トラフィックの急増を防止します。デフォルトでは、レート制限は適用されません。空白のままにすると、リクエストは無制限になります。
• 利用状況の制限（累積）：集計リクエストクォータにより、一定期間の総消費量を制限します。デフォルトでは利用状況の制限は適用されません。空白のままにすると、消費量は無制限になります。
• IP制限: IP許可リストとブロックリストを設定し、サーバーにアクセスできるIPアドレスを制御します。ブロックされたIPは許可されたIPより優先されます。

レート制限または利用状況クォータを超過すると、クォータ間隔が経過するかクォータがリセットされるまで、すべてのリクエストがブロックされます。

最大50個です。

各リストには最大500件のエントリを保持できます。同じクォータが、許可IPリストとブロックIPリストに個別に適用されます。

ツール呼び出しは30秒以内にインラインで返されます。その後、呼び出しは切り離され、合計で最大300秒までバックグラウンドで続行されます。非同期タイムアウトを超えたリクエストは、MCPクライアントにレスポンスを返しません。非同期タイムアウトはレシピ設定で設定します。

Workato Identity（OAuth 2.0）認証を使用するMCPサーバーでは、どのユーザーにも自動アクセス権は付与されません。管理者を含むすべてのユーザーは、MCPサーバーにアクセスするためにエンドユーザーグループに追加されている必要があります。

アクセスを付与するには、次の手順を完了します:

ユーザーグループを管理するには、管理者権限が必要です。代わりにトークンベース認証を使用する場合は、MCP URLとトークンのみが必要です。

手順については、MCPアクセス方法のユーザーグループを参照してください。

MCPサーバーログは、ガバナンスと追跡のために、利用状況とアクセスの統合概要を提供します。ログには以下が含まれます:

• ユーザーID: サーバーにアクセスしたユーザー
• リクエストIPアドレス: リクエストの送信元
• 作成タイムスタンプ: アクセスが発生した日時
• 呼び出されたツール/API: 実行されたアクション

Workato Logging Serviceでログにアクセスできます。ツール > ログに移動し、ログタイプフィルターをクリックし、MCPサーバーを選択して、適用をクリックすると、MCPサーバーログのみが表示されます。