Agent Tasks

エージェントタスクでできること

エージェントタスクを使うと、繰り返し行う作業をご自身で行う代わりに、AIのエージェントに任せられます。担当者に依頼するのと同じように指示します。「毎週月曜の朝に、先週の注文を集計して、ダイジェストをメールで送って」のように伝え、使ってよいツールを選び、実行するタイミングを指定します。エージェントは実行時に自分で手順を立て、設定した制限の中で作業します。顧客に何かを送信する前には、承認のために止まります。

このガイドでは、次の3つの言葉が繰り返し出てきます。

• エージェント：設定したひとつの作業です。指示、使用するツール、トリガーで構成されます。
• 実行：エージェントを1回動かすことです。すべての実行は、実行ログに手順ごとの記録が残ります。
• コネクター：エージェントが使用してよいサービスです。ストア、チャットチャネル、スプレッドシート、マーケットプレイス、決済サービスなどがあります。1つの接続は、そのボット上のすべてのエージェントで共有されます。

エージェントタスクはアドオンです。購入すると、ダッシュボードのサイドバーでアドオン → エージェントタスクのグレー表示が解除され、その下に概要、エージェント、ライブラリ、コネクター、実行ログ、設定が表示されます。アドオンがない場合、このページには短い説明しか表示されません。

各機能の場所

ダッシュボードのサイドバーでアドオン → エージェントタスクを開きます。コンソールには5つのページがあり、それぞれがサイドバーの項目になっています。

• 概要：今すぐ対応が必要なことと、有効なエージェントの一覧です。
• エージェント：すべてのエージェントの一覧です。一時停止、実行、編集、削除ができます。
• ライブラリ：ワンクリックで追加できる既製のエージェントと、空の状態から作成するビルダーがあります。
• コネクター：内蔵のもの、接続済みのもの、接続できるものを表示します。
• 実行ログ：すべての実行、その手順、コスト、待機中の承認を表示します。

ビルダーは、エージェントタブとライブラリタブから開けます。ビルダーを開いている間は、エージェントの下に表示されます。

概要：対応が必要なこと

要対応カードが、確認すべき場所です。ヘッダーには、待機中の件数と、今週処理されたタスクの数が表示されます。行は次の3種類です。

• 保留中の実行：エージェントが何かを送信しようとしていて、あなたの判断を待っています。確認を選ぶと、送信しようとしている正確なメッセージを含む実行が開きます。
• 切断された接続：コネクターのアクセス権が期限切れになっています。再接続するまで、それを使うエージェントは失敗します。再接続を選ぶと、コネクタータブに移動します。
• 下書きのエージェント：ビルドされたものの、まだ公開されていないエージェントです。下書きを開くを選ぶと、ビルダーに戻ります。

対応が必要なものがない場合、カードにはその旨が表示されます。その場合、コンソールを開いておく必要はありません。エージェントは自動で実行され、判断が必要な場合にのみここに表示されます。

その下の有効なエージェントには、実行中の各エージェントについて、スケジュール、次回の実行時刻、使用しているコネクター、直近の実行結果が表示されます。

ライブラリからエージェントを追加する

最も早く始める方法は、既製のエージェントを使うことです。ライブラリを開き、顧客、サポート、運用、レポートで絞り込んで、カードのエージェントを追加を押してください。ライブラリからの追加は無料で、カードに表示されたスケジュールで、すぐに有効になります。

テンプレートによっては、先に接続が必要なものがあります。スプレッドシートを読み取るカードは、追加時にファイルの選択を求めます。スプレッドシートがまだ接続されていない場合は、コネクタータブに移動します。特定のサービス（Shopify、Calendly、AfterShip、Stripe、HubSpot、Slack、Mailchimp、音声番号など）が必要なカードは、そのコネクターを設定した後にのみ動作します。

ライブラリには、現在次のものがあります。

• レポート：週次売上ダイジェスト（毎週月曜朝）、売上ログからシートへ（毎朝）、通話ログのエクスポート（毎晩）。
• 運用：ナレッジベースの更新（毎週）、キャンペーン送信（毎週）、コール・ラウンド（毎時）、在庫不足アラート（毎朝）、マーケットプレイスの在庫監査（毎朝）。
• サポート：注文状況の監視（毎日）、期限超過チケットのエスカレーション（チケットがSLAを超えたとき）、ハンドオーバー・コンシェルジュ（顧客が担当者を求めたとき）。
• 顧客：予約、保証状況、店舗検索、配送状況、返金状況、再入荷のウェイトリスト。これらは、顧客がチャットから呼び出します。詳しくは後述の「顧客がチャットからエージェントを呼び出す」を参照してください。

ライブラリから追加したエージェントは、ご自身で編集できます。エージェントタブの編集から開いてください。名前、指示、モデル、スケジュールを変更でき、ツールを追加または削除できます。ツールを削除すると、エージェントができることは狭まるだけで、広がることはありません。

独自のエージェントを作る

エージェントタブで+ エージェントを作成を押すか、ライブラリで+ ゼロから作成を押してください。ビルダーは、4つのカードからなる1ページです。

処理内容

• 名前：一覧や承認メールに表示される名前です。
• 指示：依頼内容で、4,000文字まで入力できます。スタッフに書くように書いてください。何を確認するか、何をするか、何を絶対にしないかです。エージェントはこの指示から自分の手順を立て、設定したガードレールの範囲内で止まります。
• モデル：短い検索や定型の返信には高速、ツール呼び出しを含む複数ステップの作業にはバランス（既定）、間違いのコストが大きい長い推論には詳細を選びます。詳細なモデルほど、1回の実行あたりのコストが高くなります。

使用してよいツール

ツールは、エージェントが実行してよいもの、読み取りしてよいもの、書き込みしてよいものに分類されています。各グループで+ 追加を押してください。まだ接続していないコネクターが必要なものには先に接続と表示されます。プラットフォームでまだ利用できないものには近日公開と表示されます。

実行してよい操作：

• メッセージ：接続済みのチャットチャネルで会話に送信します。すべてのメッセージは承認のために保留されます。複数のチャネルを接続している場合は、カードでチャネルを選ぶか、*任意のチャネル*のままにしてください。
• メール：接続済みのメールボックスから、任意のアドレスに送信します。すべてのメールは承認のために保留されます。ご自身の受信箱へのレポートは、設定が一切不要です。
• 電話：音声番号から発信します。すべての通話は承認のために保留され、最大15分に制限されます。音声チャネルと番号が必要です。
• コネクターのAPI：接続済みのサービスごとに1つ表示されます。エージェントが呼び出しを組み立てます。認証情報はサーバー上に保持され、エージェントからは見えません。
• クローラー：指示に記載された公開Webページを取得して読み取ります。
• Web検索：最新の情報をWebで検索します。
• APIの呼び出し：カードに記載したホストのAPIを、任意のキーを付けて呼び出します。キーはエージェントとともに保存され、プラットフォームが挿入します。エージェントがキーを読むことはありません。
• MCPツール：カードに入力したMCPサーバーのアドレスのツールを使用します。

読み取ってよいデータソース：ストア（Shopify、WordPress、Wixの注文とストア情報。読み取りのみ）、会話のトランスクリプト、チャットボットのナレッジベース、ナレッジの維持管理（サイトからナレッジベースを更新し、その状態を読み取る）、ヘルプデスクのエージェントの内部ナレッジ、カードで選んだスプレッドシート、以前の実行から得たエージェント自身のメモリ。

書き込んでよいデータストア：カードで選んだスプレッドシートと、エージェントのメモリ。エージェントのメモリは、実行間でエージェントが残す独自のメモ（誰にすでに連絡したかなど）です。

スプレッドシートのカードでは、それぞれ使用するファイルを固定します。Googleスプレッドシートでは、Googleのファイルピッカーが開きます。Microsoft Excelでは、接続済みのOneDriveにあるブックの一覧が開きます。エージェントが読み書きするのは、選択したファイルだけです。

実行のタイミング

• スケジュール：毎時、毎日、平日、週末、毎週、毎月のいずれかを、選んだ時刻とタイムゾーンで実行します。選択肢の下の緑色の行に、その内容が平易な言葉で表示されます。
• イベント：チャットのイベント（ハンドオーバーの要求、乱用の検知、回答が見つからなかったとき）、ヘルプデスクのイベント（新しいチケット、承認が必要、対応が必要、再開、SLA超過）、ストアのイベント（新規注文、注文の返金、注文のキャンセル。Wixではカート放棄と在庫不足も含まれます）、またはWebhookで実行です。Webhookを選ぶと、エージェントに専用のURLが割り当てられます。このURLはカードに表示され、どのシステムからもPOSTできます。
• 顧客がチャットで依頼したとき：顧客が会話からエージェントを開始します。次のセクションを参照してください。
• 手動のみ：スケジュールもイベントもありません。エージェントタブで今すぐ実行を押してください。

ガードレール

2つのガードレールは常に有効です。顧客へのメッセージは、承認のために保留されます。また、実行の費用が1回あたりの上限（現在2.00ドル）を超えると、その実行は停止します。どちらもカードに表示されるため、ご確認いただけます。

テスト実行と公開

依頼内容から作成されたエージェントでは、テスト実行が、何も送信せずに計画を実行し、もし実行していたら何をしていたかを表示します。表示には*テストのプレビューです。何も送信されていません*と付きます。テスト実行にも、通常の実行と同じ料金がかかります。内容に問題がなければ、エージェントを公開で有効にします。有効なエージェントを再コンパイルした場合は、更新を公開が表示されます。

コンパイル後には、緑色のバナーに*コンパイル済みです。このエージェントの動作は次のとおりです*と表示され、その後に平易な言葉で計画が示されます。公開する前に必ず確認してください。

顧客がチャットからエージェントを呼び出す

実行のタイミングを顧客がチャットで依頼したときに設定すると、ビルダーに小さな設定項目が表示されます。

• ツール名：チャットAIが内部で呼び出す名前です。顧客には表示されません。
• 使用する場面：このタスクが該当するタイミングを、チャットAIに伝える1文です。スタッフへの指示のように書いてください。
• 顧客が入力できる項目：最大5つまでです。それぞれ名前、種類（テキスト、数値、はい/いいえ）、説明、必須かどうかを設定します。
• 顧客ごとの実行回数：1人の顧客が24時間にこのタスクを開始できる回数です。1〜10の範囲で、既定値は3です。
• データの範囲：顧客から依頼された実行のすべての手順に追加される指示です。エージェントが何を繰り返してよいか、また何を繰り返してはいけないかを定めます。

エージェントにはメッセージのアクションが必要です。なければ、顧客に回答する手段がありません。

公開する前に、2点を理解しておいてください。1点目は、タスクが読めるものは、依頼した顧客に繰り返して伝えてしまう可能性があることです。データの範囲はAIへの指示であり、セキュリティの境界ではありません。顧客に見せるべきではないデータを、顧客向けのタスクに与えないでください。その背後にある仕組みとして、顧客から依頼されたタスクが生成したすべての回答は、チャットで配信される前に、顧客の依頼とデータの範囲に照らして漏えいチェックを受けます。

顧客自身の予約時間を伝える回答は送信されます。一方で、カレンダーの一覧、メモの引用、別の顧客の名前を含む回答は、保留中の実行として止まります。顧客には、ストアのチームが確認していると伝えられ、実行履歴であなたが承認するか却下するかによって、配信されるか終了するかが決まります。

顧客から依頼されたタスクは、クローラーやWeb検索を使うこともできません。また、メモリは顧客ごとに分けて保持され、メールは依頼した顧客かご自身にしか送れません。2点目は、各実行はご自身のクレジットを消費し、顧客ごとの上限で制限されることです。利用枠を使い切った顧客には、そのタスクは今は利用できないと伝えられます。残高について顧客に伝えられることはありません。

顧客を識別する方法：WhatsApp、Telegram、LINE、Messenger、Instagram、Discordなどのメッセージングチャネルでは、顧客ご自身のアカウントが識別情報となり、サインインは不要です。ご自身のWebサイトでは、訪問者がサインインしている必要があります。サインインしていない訪問者には、まずログインするよう求められます。WordPressとShopifyアプリでは、これが自動的に処理されます。その他のサイトでは、サイトを構築した方が一度だけ設定する必要があります。設定のエージェントタスクタブに表示されるアイデンティティ署名シークレットが必要です。

エージェントを公開することで、実際に公開されます。エージェントタブで一時停止すると、公開が取り消されます。エージェントタスク → 設定には、チャットから呼び出せるエージェントの一覧が表示されますが、別のオン/オフのスイッチではありません。

コネクター

コネクターを開いてください。一番上の行の内蔵には、設定しなくてもすべてのエージェントが利用できるものが表示されます。ストアのプラットフォーム（Shopify、WordPress、Wixを自動検出）、チャットボット（どのチャネルでも返信）、ボットのナレッジ、自分へのメール（ご自身の受信箱へのレポートのみ）、エージェントのメモリ、会話です。

その下のコネクターライブラリには、追加できるすべてのサービスが表示されます。チャネル、ソーシャル、マーケットプレイス、ヘルプデスク、決済、CRM、マーケティング、生産性で絞り込めます。各カードは次の4つの方法のいずれかで接続します。

• 接続：提供元へのサインインです。リクエストを承認すると、コンソールに戻ります。コピーするものはありません。Googleスプレッドシート、Microsoft Excel、Slack、Notion、カレンダー、Calendly、Stripe、Square、Squarespace、Mailchimp、Klaviyo、Attentive、HubSpot、Zoho、Salesforce、Judge.me、Googleファミリー、Metaファミリー、X、TikTok、YouTube、マーケットプレイスで使われます。このうち2つは、先に1つ入力を求めます。Judge.meはストアのドメイン、WooCommerceはストアのURLです。承認画面はご自身のストアにあるためです。
• キーで接続：提供元のダッシュボードから認証情報を貼り付けます。フォームには、正しいページへのキーを取得リンクと、そのページにサインインした後にたどる経路が1行で表示されます。PayPal、AfterShip、ShipStation、Shippo、Rakuten、Resend、Mailtrap、Twilio、Vonage、Telnyx、Loox、Microsoft Clarityで使われます。Apple Calendarは同じフォームですが、ラベルがアカウントで接続に変わります。キーではなく、Apple IDとアプリ用パスワードを使うためです。キーは、他のすべての認証情報と同様に、保存時に暗号化されます。
• ボット経由で接続：チャットチャネル（Telegram、WhatsApp、Discord、音声、LINE、Messenger、Instagram）とヘルプデスク（Zendesk、Gorgias、Freshdesk、Help Scout）は、ボット自体の設定から来ます。まだ設定していない場合は、接続を押すと、チャネルタブで使うものと同じ設定フォームが開きます。
• 近日公開：コネクターは存在しますが、プラットフォームではまだ有効になっていません。下の「カードに「近日公開」と表示される理由」を参照してください。

1つの接続は、そのボット上のすべてのエージェントで使われます。切断を押すと、保存されているアクセス権が削除され、提供元が対応している場合は、提供元側でも取り消されます。

提供元のアクセス権が期限切れになると、カードは再接続が必要（接続期限切れ）に変わり、概要に表示されます。それに依存するエージェントは自動的に一時停止され、理由が各行に表示されます。再接続すると再開されます。

コネクターによっては固有の注意点があります。フォームのヒントに説明されています。Rakutenのライセンスキーは約90日ごとに更新されます。PayPalのトランザクション検索は、有効にしてから最大9時間かかる場合があります。Mailtrapは1つの接続に1つのストリームを割り当てます。Twilioは、APIキーまたはアカウントの認証トークンのどちらでも受け付けます。Loox は有料のLooxプランが必要です。Resendは、ご自身のResendアカウントで認証されたドメインからしか送信できません。1週間どのエージェントも使っていないSquarespaceの接続は、再接続が必要です。

承認と保留中の実行

エージェントが顧客へのメッセージ、メール、または通話を送信しようとすると、送信前に実行が止まり、保留とマークされます。件名*エージェント「…」があなたの承認を待っています*のメールが届き、その実行は要対応に表示されます。

実行ログで開いてください。手順のタイムラインの最後に、提案された書き込みごとに黄色のブロックが表示されます。宛先、件名がある場合はその件名、本文の冒頭部分が表示されます。承認して送信を選ぶと、その実行のすべてが送信されます。却下を選ぶと、破棄されます。承認は全件か無かのどちらかで、個々のメッセージを選ぶことはできません。

保留中の実行は7日間待機します。その間に判断しなければ期限切れになり、判断が保留されている間は、エージェントは新しいスケジュール実行を開始しません。自分宛てのレポートと、ご自身で選んだスプレッドシートの2つは、保留されることはありません。これらは信頼された送信先のため、レポート用のエージェントは初日から無人で実行されます。

実行ログ

すべての実行は実行ログに表示され、新しいものから順に並びます。すべて、失敗、保留中で絞り込めます。各行には、エージェント、実行された時刻、トリガー（スケジュール、イベント、手動、テスト、顧客のチャットからの依頼、承認のいずれか）、所要時間、結果が表示されます。CSVをエクスポートを押すと、一覧をダウンロードできます。

実行を選ぶと、右側に手順が表示されます。各手順は平易な言葉で説明され、使用したツール、所要時間、エラーがあればそれも表示されます。保留中の実行では、提案された書き込みに承認と却下のボタンが表示されます。電話の実行では、各通話とトランスクリプトへのリンクが表示されます。テスト実行ではプレビューのパネルが表示されます。

結果のバッジ：完了は終了、失敗はエラーで停止（行に表示）、保留中はあなたの判断待ち、強制終了はあなたまたはシステムが理由とともに停止、実行中、待機中、適用中は進行中を表します。

エージェントの管理

エージェントタブでは、各行に一時停止と再開の切り替え、今すぐ実行、編集、そして複製と削除がある⋯メニューがあります。

• 一時停止：スケジュールを停止します。顧客がチャットから呼び出すエージェントの場合は、公開も取り消されます。再度オンにするとスケジュールが再開します。
• 今すぐ実行：すぐに実行を開始します。1つのエージェントで同時に進行できる実行は1つだけです。実行中のものがあれば、今すぐ実行は完了を待ちます。
• 編集：ビルダーを開きます。変更は次の実行から反映されます。エージェントのコネクターを変更すると、その新しいサービス向けに指示が書き換えられ、その書き換えはモデル呼び出しと同様に課金されます。
• 複製：コピーを作成します。無料です。
• 削除：確認を2回求めます。エージェント、そのバージョン、実行履歴、メモリが消去されます。会話と請求履歴は残ります。実行中のエージェントは、完了するまで削除できません。

コネクターの期限切れにより自動で一時停止されたエージェントには、その行に理由が表示されます。再接続すると再開されます。切り替えを押せば、そのまま再開することもできます。

料金

すべての費用は、プラットフォームの他の機能と同じクレジット残高から差し引かれます。以下の金額は、執筆時点のものです。

• ライブラリからの追加、複製、編集、スケジュールの変更：無料です。
• 依頼内容からのコンパイル：コンパイルに使うモデルの費用だけで、それ以外の追加費用はありません。
• 実行：実行中に行われたモデル呼び出しの費用と、少額の計算費用です。計算費用は、負荷の高い実行でも1セントの何分の一かです。テスト実行と承認による実行も、同じ方法で課金されます。実行がその1回あたりの上限（現在2.00ドル）を超えると停止します。
• Web検索：現在、1クエリあたり0.01クレジットです。
• X（Twitter）：Xは1回のAPI呼び出しごとに課金し、その料金を2倍のレートで転嫁します。現在、読み取り1回あたり0.01クレジット、書き込み1回あたり0.03クレジットです。
• その他のすべてのコネクターの呼び出し：呼び出しごとの料金はありません。

各エージェントの当月の支出は、エージェントタブの行に表示され、各実行の費用は実行ログに表示されます。残高が空になると、コンパイルは拒否され、実行は*no_credits*で失敗します。顧客がチャットのタスクを試した場合は、そのタスクは利用できないと伝えられるだけです。プラットフォームの障害で失敗した実行は、自動的に返金されます。

知っておくべき制限

• ボットごとに30のエージェントまで作成できます。空きを作るには、アーカイブまたは削除してください。
• 1つのエージェントで同時に進行できる実行は1つだけです。
• 実行が進展しない場合は、自動的に停止します。同じ引数で同じ呼び出しを3回繰り返した場合、または拒否されたか失敗したアクションが4回連続した場合です。停止した実行は失敗として終了し、実行ログに、どの呼び出しで止まったかが表示されます。
• 顧客からチャットで依頼されたタスク：顧客ごとに24時間で1〜10回です。エージェントごとに設定します。
• Webhookで実行されるエージェント：キューに入れられる未完了の実行は最大10件です。それ以上の投稿は、1件が完了するまで拒否されます。リクエストの本文は4KBで切り捨てられ、それを超える部分はエージェントに渡されません。
• 電話：1回あたり15分です。
• 実行は、約15分後に停止されます。
• ナレッジベースの更新：エージェントごとに24時間に1回です。

これらの制限が実際の作業の妨げになる場合は、support@proxyai.app にご連絡ください。どの制限に当たっているか、何をしようとしているかを教えてください。これらは割り当てではなく、システムの仕組みによる制約です。回避策を取られるより、事情をお聞きしたいと考えています。

プライバシーと保持期間

エージェントが認証情報を保持することはありません。コネクターの呼び出しはプラットフォームを経由し、プラットフォームが送信時に認証情報を付加します。表示される手順の記録は、個人データがマスクされた後に書き込まれます。エージェントが取得した生のページやAPIのレスポンスは保存されません。コネクターの呼び出しの詳細な監査記録は、90日後に削除されます。保留中の実行の提案メッセージは、承認または却下した時点、または期限切れになった時点で削除されます。テスト実行のプレビューは、確認できるように24時間保持されます。

顧客から依頼されたタスクでは、エージェントは読めるものを繰り返してしまうことを忘れないでください。そのようなエージェントは、範囲を狭く設定してください。

カードに「近日公開」と表示される理由

コネクターの近日公開ボタンは、コードは準備できているものの、提供元が当社のアプリをまだ承認していないか、プラットフォームでまだ有効になっていないことを意味します。アクセスを求めるすべてのアプリを審査する提供元もあります。たとえばGoogleは、カレンダー、アナリティクス、YouTubeのコメントを読むアプリを審査し、Metaは広告やページを管理するアプリを審査します。

審査に合格するまでは、接続中に提供元の警告画面が表示されることがあります。または、カードが近日公開のままになります。こちら側で解決できることはありません。提供が始まると、更新なしでカードは接続に変わります。

よくある対処

• 接続していることは確かなのに、カードに「接続」と表示される：チャットチャネルの場合、接続はボットの設定から来ます。設定 → チャネルを確認してください。そこでチャネルが有効になっていれば、コンソールを再読み込みしてください。
• 接続すると提供元に移動し、エラーとともに戻ってくる：最も多い原因は、提供元側の設定がまだ反映されていないことです。1分ほど待ってからもう一度試してください。それでも解決しない場合は、提供元の名前を添えてサポートにご連絡ください。
• 一時停止した覚えがないのに、エージェントが一時停止している：使用しているコネクターの期限が切れています。行に、どのコネクターかが表示されます。コネクタータブで再接続してください。
• エージェントは実行されたのに、何も送信されていない：実行ログを確認してください。おそらく保留中で、承認を待っています。または、「N人を超える相手に送信する前に確認する」というガードレールに当たり、残りがそこで待機しています。
• 顧客が「このチャットタスクは利用できません」と言う：その日の利用枠を使い切っているか、エージェントが一時停止しているか、残高が空になっています。
• コードを確認したい：確認できるコードはありません。コンパイル後に表示される計画と、実行後の手順の記録が、すべてです。