エージェントにトリガーを追加する(プレビュー)

[この記事はプレリリース ドキュメントであり、変更されることがあります。]

トリガーを使って、GitHub Copilot harnessで駆動される自律型エージェントを作成できます。 自律エージェントは、接続されたサービスでイベントが発生すると作動します。 例えば、エージェントはSharePointでアイテムが作成されたり、メールが届いたり、予定時刻になったときに応答したりできます。

トリガーはイベントの詳細をエージェントに送信します。 エージェントの指示やツールが、その詳細をどう扱うかを決めます。

Note

この記事の機能は、GitHub Copilot harnessを搭載するエージェントやワークフローで使用されています。

使用率に基づく請求は、エージェントの使用、構築、テスト、評価に適用されます。 これらの行動はCopilotクレジットを消費することがあります。 詳細は「GitHub Copilot harnessで動くエージェントのコスト管理」をご覧ください。

[この記事はプレリリース ドキュメントであり、変更されることがあります。]

トリガーを追加する前に

トリガーを追加する前に:

トリガーの追加と設定

  1. Copilot Studio でエージェントを開きます。

  2. [トリガー] を選択します。

  3. トリガーを選択します。

  4. トリガーを構成します。

    1. トリガーに使う接続を設定してください。 緑色のチェックマークが見えたら、接続が正常に動作している証拠です。 緑のチェックマークが見当たらない場合は、アカウントを選択し、別のアカウントを選択するか新しい接続を作成してください。

    Note

    RecurrenceやCopilot、Teamsトリガーのように、接続の確認を必要としないトリガーもあります。

    1. オプションとして、このトリガーに対してエージェントに送りたい追加の指示を追加しても構いません。 このステップは、エージェントに複数のトリガーがあり、それぞれのトリガーがエージェントの実行を異なる方向に導く場合に特に重要です。

    2. トリガーイベントが取得された際にエージェントをいつ呼び出すかを決定するトリガー オプションを設定してください。

    3. このエージェントを他の人と共有する場合は、各オプションごとに「 ユーザーごとに編集可能 」をオン・オフすることで、ユーザーが自分で設定できるかどうかを選びましょう。

    4. 必要な高度なパラメータを設定するために、 詳細パラメータ を展開してください。

  5. [トリガーの追加] を選択します。

エージェントのテストと公開

エージェントを公開する前に、すべてのトリガーをテストしてください。

  1. トリガーをテストするには、試験管（）ボタンを選択します。 ボタンにたどり着くには、次のいずれかを行います:

    • ビルドタブからトリガーを選択してください。
    • プレビュータブを開きます。

  2. 次のいずれかを行ってください:

    • 最初のテストでは「聴き始める」を選択してください。 トリガー設定に合ったイベントを生成してください。例えば、メール送信やSharePointアイテムの作成などです。 エージェントはトリガーイベントが起こるのを待ち、テスト目的で反応します。 結果に基づいて、エージェントの指示、ツール、トリガーのカスタマイズ、メッセージを自分のニーズに合わせて修正してください。
    • 以前のトリガーイベントでテストリストから、過去のトリガーイベント（最後のメール、ファイルなど）を選択します。 このアクションは、そのトリガーイベントでエージェントを呼び出します。

自律エージェントを公開し有効化する

エージェントはあなたが公開するまで自動で動作しません。 トリガーやその指示、ツールを変更した後にエージェントを再公開してください。 エージェントを更新すると、ユーザーに新しい変更内容を受け入れるよう促されます。

  1. トリガー付きのエージェントの最新バージョンを更新するには、「発行」 を選択します。

  2. 公開後、成功ダイアログで誰がエージェントを使用するかを選びます:

    • 自分用にアクティブ化: エージェントを使用できるのは、作成者であるあなただけであり、自分自身のメイカー認証情報を使用します。
    • 他のユーザーと共有する:他のユーザーが自分の認証情報でエージェントを使えるようにします。 また、それらのユーザーにも エージェントを共有 する必要があります。

有効化してください

Note

自律エージェントの使用はCopilot Studioの請求料金に従って請求されます。

「Activate for me」 は エージェント管理 に移動し、そこでエージェントを有効にします。 エージェントを有効にすると、エージェントがあなたに代わって実行を開始します。

また、エージェント名のリンクから エージェント管理 にアクセスし、自律エージェントを有効化することもできます。

他のユーザーと共有

人々が自分の認証情報で自律的なエージェントを使えるようにするには、そのトリガーとツールをユーザー認証用に設定してから、公開されたエージェントを共有します。 受信者は必要な接続を完了し、許可したトリガーオプションのみを編集できます。

Note

各エンドユーザーの自律型エージェントの使用量は、ホストされている基盤環境を通じて合計・請求されます。 詳細は「GitHub Copilot ハーネスによるエージェントの請求概要」をご覧ください。

詳細は「自律エージェントを共有する」をご覧ください。 共有自律エージェントをエンドユーザーが設定するための手順については、共有自律エージェントの設定をご覧ください。

  • 最終更新: