宣言型エージェントを構築する

ビルドまたは再利用中に、コンポーネント計画で選択した宣言型エージェントコンポーネントを実装します。 この記事は、製品の手順を選択し、コンポーネントの準備を確認するのに役立ちます。 作業中のエージェント、その依存関係、およびプラグイン統合の証拠をテストして終了します。

すべてのプラグインにエージェントを配置する必要はありません。 独自のオーケストレーション、モデル、ホスティング、またはランタイムの場合は、代わりに アプリ パス に従います。

既存のエージェントを作成する前に確認する

  1. 既存のエージェントの対象ユーザー、サポートされているエクスペリエンス、指示、知識、アクション、権限、既知の制限事項をその所有者とともに確認します。

    確認:ドキュメント化された機能は、コンポーネント計画のタスクとターゲットのエクスペリエンスと一致します。

  2. 製品の文書化された再利用または拡張ルートを選択します。 エージェント テンプレートから開始するか、ワークフローが適合する場合は Agent Builder エージェントを Copilot Studio にコピーできます。

    確認:ルートはソースと目的地をサポートします。 エージェント コンポーネントをプラグインに追加すると、既存のプロジェクトがインポートされるとは想定しないでください。

  3. 所有権、バージョン管理、サポート、変更管理について同意し、代表的なタスクをテストします。

    確認:エージェントを変更せずに使用するか、構成するか、または新しいコンポーネントを構築するかを決定する前に、結果と未解決のギャップを記録します。

Work IQ Dev Tools の使用を開始する

専門能力開発の場合は、Work IQ Dev Tools から開始し、 文書化された環境を選択し、コンポーネントに特定のプロジェクト コントロールが必要な場合にのみ Agents Toolkit を追加します。

開始点 製品の手順 期待される結果
エージェント コンポーネントを必要とする新しいプラグイン Work IQ Dev Tools を使用してプラグインを構築する wiqd plugin create コンテナーを作成します。 wiqd plugin add agent 、オプションのエージェント コンポーネントをスキャフォールディングします。
既存の宣言型エージェント ソース プロジェクト エージェント コンポーネントのライフサイクル 文書化された wiqd agent コマンドを使用して、エージェント固有の作成と反復を続行します。
編集が必要なエージェントの指示、知識、またはアクション WIQD の宣言型エージェント と コマンド リファレンス 選択したコンポーネントと環境用に構成された保存済みソース。

ガイド付き作業には WIQD コーディング アシスタント プラグインを使用し、繰り返し実行可能なコマンドには直接 CLI を使用します。 必要に応じて、コーディング アシスタント プラグインと CLI を個別の前提条件としてインストールします。 GitHub Copilot は、ファイル、手順、構成、テストの作成に役立ちます。作成ツール、ランタイム、またはコンポーネントの要件に取って代わるものではありません。

既存のエージェント プロジェクトの場合は、オフライン検証を明示的に選択します。

wiqd agent validate --mode source --env dev

確認:保存されたソースの結果を読み、報告されたエラーを修正します。 ソース チェックに合格しても、実行時の動作、エンドポイント到達可能性、認証の正確性、または最終的なパッケージの受け入れは確立されません。 既定の package モードでは、既存の ZIP が使用され、検証のためにアップロードされ、サインインが必要になる場合もあります。

既存の WIQD エージェント プロジェクトにスキルを追加するには、エージェント スキル コマンド リファレンスでagent-skills機能フラグと現在のスキーマ要件チェックします。 最上位レベルのプラグイン スキルと宣言型エージェントにアタッチされたスキルは異なる登録です。どちらもすべてのホストでサポートを確立するわけではありません。

コンポーネントに適合する場合は、別の製品ルートを使用します

必要要件 製品の手順
Microsoft 365 Copilot での管理されたオーサリング エージェント ビルダー の概要と ビルド エージェント
ローコード ロジック、マネージド環境、または Power Platform コネクタ Copilot Studio と Teams と Microsoft Copilot のエージェントを接続して構成する
低レベル エージェント マニフェストとサポートされる開発統合 Work IQ 開発ツール (サポートされているプロコード シナリオにおすすめ)
既存の Toolkit エージェントのスキル エージェント ツールキットを使用してスキルを追加する

スタンドアロンの Copilot Studio エージェントは、プラグインの下ではなく、エージェント レジストリに表示されます。 スタンドアロン エージェントを公開すると、プラグインとして再パッケージ化されるとは想定しないでください。

エージェントの構成とテスト

実装手順の詳細については、宣言型エージェント製品ガイダンスに従ってください。

完了する作業 信頼できるガイダンス 検証
ID、動作、タスクの境界、会話のきっかけを定義します エージェントをビルドするか、JSON を使用してビルドし、 効果的な命令を記述する 代表的なプロンプトは、期待される動作を生成し、意図したタスク内に留まります。
知識と機能を構成する ナレッジ ソースと機能とカスタム アクションの追加 必須データは目的のユーザーが使用できますが、アクセス許可で許可されていない場合は使用できません。
サポートされている MCP または API アクションを追加する 宣言型エージェント用の MCP および API プラグイン ツールの選択、認証、同意、確認、エラー、サポートされていない要求が意図したとおりに動作します。
サポートされているスキルを追加する 宣言型エージェントのスキル と選択したオーサリング手順 ターゲットエージェントはスキルを読み込み、その製品の制限内で定義されたタスクを完了します。
作成ルートの構成を管理する Toolkit 環境とバージョン または WIQD 環境 ID 値、依存関係、および設定は、意図されたテスト環境に属します。

エージェントのバージョン、所有者、サポートされているエクスペリエンス、依存関係、既知の制限事項、テスト結果を記録します。 製品固有のテストが必要です。ソースまたはパッケージの検証に合格しても、すべてのユーザーがタスクを実行できるという証拠ではありません。

設計ガイダンスについては、「 宣言型エージェントのベスト プラクティス 」と「 Copilot オーケストレーターがアクションを選択する方法」を参照してください。 必要な動作が機能したら、オプションで ユーザー フィードバックを有効にし て 、コンテンツの取得を最適化できます。

次のステップ

残りのコンポーネントは 引き続きビルドまたは再利用します。 準備ができたら、「コンポーネントを統合してテスト & パッケージ」と入力します。