Copilot SDK を設定する

Copilot SDK の BYOK (独自のキーを持ち込む) は静的 API キーを受け入れますが、Azureデプロイでは、有効期間の長いキーではなく、Managed Identity (Entra ID) が使用されることがよくあります。 SDK ではEntra ID認証がネイティブにサポートされていないため、bearer_token プロバイダー構成フィールドを介して有効期間の短いベアラー トークンを使用できます。

サーバー側アプリケーション (API、Web バックエンド、マイクロサービス、バックグラウンド ワーカー) で Copilot SDK を実行します。 CLI は、バックエンド コードがネットワーク経由で接続するヘッドレス サーバーとして実行されます。

Node.js、Python、および.NET SDK には、依存関係として Copilot CLI が含まれています。アプリには、追加のインストールや構成は必要なく、必要なものがすべて付属しています。

これらのガイドでは、個人側のプロジェクトから数千人のユーザーにサービスを提供する運用プラットフォームまで、特定のユース ケースに合わせて Copilot SDK を構成する手順について説明します。

ユーザーが自分のGitHub アカウントで認証を行い、アプリケーションでCopilotを使用できるようにします。 これにより、個々のアカウント、組織のメンバーシップ、およびエンタープライズ ID がサポートされます。

SDK のバンドルされた CLI の代わりに、特定の CLI バイナリを使用します。 これは高度なオプションです。CLI パスを明示的に指定し、SDK とのバージョンの互換性を確保する必要があります。

Copilot SDK は、状態、認証、およびツールのセッションごとの分離を使用して、マルチユーザー サーバーデプロイで実行します。

複数のユーザーにサービスを提供し、同時セッションを処理し、インフラストラクチャ全体で水平方向にスケーリングするように、Copilot SDK のデプロイを設計します。 このガイドでは、セッション分離パターン、スケーリング トポロジ、運用のベスト プラクティスについて説明します。