Agent Developer Kit コマンド リファレンス

この記事のすべてのコマンドは、Visual Studio Code の [GitHub Copilot チャット] ウィンドウに入力するスラッシュ コマンドです。 [最初のコマンドの実行] を完了した後、 ess-maker-skills ワークスペースでこれらの コマンドを実行します

コマンドを忘れた場合、Copilot チャットは、チャット入力に「 / 」と入力したときに使用可能なものを一覧表示します。 簡単な説明を使用して、同じリストに対して /menu を実行することもできます。

コマンドの概要

コマンド 機能 使用するタイミング
/setup Power Platform 環境に接続し、Employee Self-Service エージェントを検索し、ローカル コピーを保存します。 初回セットアップに使用します。 また、環境を切り替えたり、後で 2 つ目のエージェントを追加したりすることもできます。
/connect Workday または ServiceNow の外部システムをエンドツーエンドで接続します。 これを使用して、新しい統合を追加するか、壊れた統合を修正します。
/create 簡単な英語の説明から新しいトピックまたはワークフローを構築します。 これを使用して、エージェントが処理できる新しいシナリオを追加します。
/update 既存のトピックまたはワークフローを変更します。 これを使用して、トリガー フレーズ、メッセージ、または既存のシナリオのフローを変更します。
/delete ダウンストリーム参照の安全性チェックを使用して、トピックまたはワークフローを削除します。 シナリオが不要になった場合に使用します。
/scan エージェント ファイルでエラーがチェックされ、修正の手順が示されます。 変更の後とプッシュする前に使用します。
/evaluate Copilot Studioエバリュエーターが想定する CSV 形式でテスト ケースを生成します。 これを使用して、ベースライン テスト セットを構築するか、大きな変更後に品質を確認します。
/push ローカルの変更をCopilot Studioに送信します。 ライブ エージェントにローカル編集を適用する準備ができたら、それを使用します。
/flightcheck ライセンス、環境、統合、およびエージェント ファイル間で、デプロイ前の準備チェックを実行します。 公開する前に、または顧客の問題をトリアージするときに使用します。
/troubleshoot 一般的な問題に対して対話型トリアージを提供します。 何かが機能せず、ガイド付きヘルプが必要な場合に使用します。
/menu 使用可能なコマンドの一覧を表示します。 コマンド名を忘れた場合に使用します。

一般的なコマンド シーケンス

新しいトピックをゼロから追加する

/create        <- describe the scenario
/scan          <- catch any compile errors
/push          <- send the change to Copilot Studio

統合を結び付け

/connect servicenow      <- or /connect workday
/flightcheck             <- confirm the integration is healthy

公開の準備をする

/scan          <- catch local errors
/flightcheck   <- comprehensive readiness check across 40+ verifications
/push          <- send any final changes

エバリュエーターのテスト ケースを生成する

/evaluate      <- pick which dimensions to generate

結果の CSV ファイルを、エージェントの分析ビューのCopilot Studioエバリュエーターにアップロードします。

FlightCheck の準備チェック

/flightcheckは、40 を超える検証にわたって包括的なデプロイ前準備チェックを実行します。 エンド ユーザーに発行する前に実行するか、顧客の問題をトリアージし、最も一般的な原因をチェックする 1 つのレポートが必要な場合に実行します。

チェックの内容は次のとおりです。

  • [ライセンス] - 必要なライセンスと権利が設定されていることを確認します。
  • 環境 - Power Platform 環境とその構成を検証します。
  • ID - サインイン アカウントと、そのアカウントが持つアクセス許可を確認します。
  • 統合 - Workday や ServiceNow などの接続されたシステムが有線接続され、到達可能であることを確認します。
  • エージェント ファイル - ローカル トピックとワークフローでエラーがスキャンされます。
  • 発行 - エージェントが発行する準備ができているかどうかを確認します。

FlightCheck は、関係者と共有できる HTML レポートを生成します。 解決できる問題が見つかると、問題を解決できます。

/flightcheck

FlightCheck が検証する内容の概念の背景については、「 Employee Self-Service エージェントを発行する」を参照してください。

コマンドの応答方法

キットのコマンドは会話型です。 コマンドに詳細情報が必要な場合は、次のように求められます。 すべてのオプションを覚える必要はありません。

  • "どのエージェントで作業しますか?" - 名前または番号で返信する
  • "トリガー フレーズは何ですか? - プレーンな英語で返信する
  • "削除してもよろしいですか?" - yes または no

答えがあいまいな場合、コマンドは推測する代わりに詳細を求めます。

コマンドが指示を探す場所

キットのコマンドは、ワークスペースからコンテキストを取得するCopilot Chat モデルに依存します。 コマンドが混乱を招く応答を提供する場合:

  • ワークスペースルートが完全なリポジトリではなく ess-maker-skills されていることを確認します ( 手順 1 を参照してください)。
  • 推奨されるモデルを選択してください。
  • コマンドを再実行します。 モデルが応答できない場合があります。

特定のエラー モードについては、「 トラブルシューティングの概要」を参照してください。

各コマンドの詳細を確認する場所

Copilot Studio ドキュメント セットでは、コマンドが動作する広範な概念について説明します。 概念の背景が必要な場合:

概念 詳細については、
従業員 Self-Service エージェント コンポーネント (トピック、ワークフロー、変数) Employee Self-Service エージェントをカスタマイズする
Workday 統合 Workday 統合または Workday 統合の簡略化
ServiceNow統合 HRSD と ITSM の統合をServiceNowする
評価 従業員 Self-Service エージェントの評価
発行 Employee Self-Service エージェントを発行する

次の手順