Frontier Tuning CLI (frontier-tuning、または短いエイリアス ftune) は、チューニング環境を構築および運用するためのコマンドラインツールです。 チューニング環境のプロビジョニング、スキルと評価基準の定義、サンプルのアップロードに使用します。 クエリを実行し、評価および微調整ジョブを開始することもできます。 すべてのコマンドで 1 つの Microsoft 365 サインインを使用します。
GitHub Copilot 用の Frontier チューニング プラグインやその他のコーディング エージェントも、CLI を使用してサービスに対して操作を実行します。
重要
Frontier チューニングはパブリック プレビュー段階です。 機能、制限、可用性は変更される可能性があり、一部の機能はテナントごとまたは環境ごとに有効になります。
前提条件
- Frontierチューニングへのアクセス。 パブリック プレビュー中に、管理者はあなたをテナントの Copilot Frontier 対象ユーザーに含める必要があり、Microsoft 365 Copilot ライセンスが必要です。 管理手順については、「 Frontier チューニングの有効化」を参照してください。
- サポートされているオペレーティング システム。 Windows、macOS、Linux、または Linux 用 Windows サブシステム (WSL)。
- Python 3.10 以降。 インストーラーは、必要に応じて Python を設定します。 Windows の自動セットアップには、winget が必要です。
- Microsoft 365 サインイン用の対話型ターミナル。
- パッケージフィードアクセス (organization が内部フィード経由で Python パッケージのインストールをルーティングする場合)。 インストールする前に、アクセスを構成します。
CLI をインストールするのに管理者権限は必要ありません。
CLI のインストール
お使いのオペレーティング システム用のインストーラーを選択します。
Windows に CLI をインストールするには、次の手順を実行します。
PowerShell を開き、CLI をインストールします。
irm https://aka.ms/ft-cli/v1/ps1 | iexインストールが完了するまで待ちます。 インストーラーは、ダウンロードされたパッケージのチェックサムをチェックします。
更新された
PATHが有効になるように新しいターミナルを開くか、インストーラーが出力するダイレクト コマンド パスを使用します。
Windows インストーラーは、 %LOCALAPPDATA%\frontier-tuning\v1\env の下にプライベートなユーザーごとの Python 環境を作成し、CLI コマンドのみをユーザー PATHに追加します。 既存の Python パッケージは変更されません。 互換性のある Python が利用できない場合は、管理者アクセスなしで winget を使用して現在のユーザーの Python をインストールできます。
注
Windows on Arm デバイスでは、x64 Python を使用します。 ネイティブ Arm64 Python は、Windows インストーラーではサポートされていません。
CLI のバージョンを確認して、CLI がインストールされていることを確認します。
frontier-tuning --version
サインインしてアクセスを確認する
organization の Microsoft 365 アカウントを使用してサインインし、アクセスをチェックします。
対話型ターミナルで、organization の Microsoft 365 アカウントでサインインします。
frontier-tuning auth loginインストールされている CLI バージョンごとの最初のサインインで、Frontier チューニング プレビュー通知が表示されます。 サインインを開始する前に、 Microsoft 365 補足条 項の確認を求めるメッセージが表示されます。
アカウントが Frontier チューニングにアクセスできることを確認します。
frontier-tuning auth checkアクセスが拒否された場合は、チェック コマンドに表示されるガイダンスに従います。 管理者は、同意またはアクセス権を付与する必要がある場合があります。
その他のサインイン コマンド:
| コマンド | それを使用して |
|---|---|
frontier-tuning auth login --interactive |
もう一度サインインするか、別のアカウントを選択します。 |
frontier-tuning auth whoami |
すべてのコマンドで使用されるサインイン ID を表示します。 |
frontier-tuning auth refresh |
認証を更新します。 |
frontier-tuning auth logout |
保存されている CLI 資格情報をサインアウトしてクリアします。 |
frontier-tuning auth probe |
サインインと、選択したチューニング環境へのアクセスを確認します。 |
ヒント
GitHub Copilot アプリなどのエージェント ホストから CLI を使用する前に、ターミナルからサインインします。 エージェント ホストは対話型ターミナルなしでコマンドを実行するため、既存のサインインを再利用できますが、サインイン プロンプトを表示することはできません。
無人自動化の場合は、 --accept-preview-terms を使用するか、 FRONTIER_TUNING_ACCEPT_PREVIEW_TERMS=trueを設定することで、プレビュー条件に同意できます。 条件に同意しても、資格情報が提供されたり、同意が付与されたり、Microsoft Entra 条件付きアクセスがバイパスされたりすることはありません。 organization のサインイン ポリシーがシナリオをサポートしていることを確認します。 マネージド デバイス ポリシーにより、デバイス コード サインインがブロックされる場合があります。
コマンドで使用するチューニング環境を選択します
frontier-tuning environments create を使用してチューニング環境を作成すると、CLI はその ID をデフォルトとして自動的に保存します。 選択されているチューニング環境をチェックするには、次を実行します。
frontier-tuning config show
別のチューニング環境に対してコマンドを実行するには、その ID を -e (または --env-id) で渡します。
frontier-tuning -e <env-id> skills list
-o json を任意のコマンドに追加して機械で読み取り可能な出力を取得し、任意のコマンドで --help を使用してオプションを表示します。
CLI を最新の状態に保つ
自動更新は既定でオンになっています。 CLI は、多くても 2 時間ごとに新しい v1 リリースをチェックし、次のコマンドが完了した後にインストールします。
| タスク | コマンド |
|---|---|
| インストールせずに新しいバージョンが存在するかどうかを確認する | frontier-tuning update --check |
| 今すぐ更新 | frontier-tuning update |
| 自動更新をオフにする |
frontier-tuning config set auto_update false、または FRONTIER_TUNING_AUTO_UPDATE=false |
Windows では、更新プログラムの終了コード 0 は、更新プログラムが完了したことではなく、スケジュールされたことを意味します。 コマンドが出力するパスの status.json ファイルを読み取り、 "state": "succeeded" 待ってから再度 CLI を実行してください。 macOS と Linux では、コマンドが返される前に更新が完了します。
注
CLI バージョン 1.0.21 以降では、 public 接続設定のみがサポートされています。 構成、プロファイル、または FRONTIER_TUNING_TRANSPORT 環境変数が引き続き legacy または workiq を使用している場合、コマンドは停止し、移行方法を説明します。
frontier-tuning config set transport public を実行し、残っているプロファイルまたは環境変数を更新してから、frontier-tuning auth login を実行してfrontier-tuning auth checkします。
マネージド ネットワークで CLI を使用する
- 内部パッケージ フィード。 どちらのインストーラーも pip 構成と
FRONTIER_TUNING_PIP_INDEX_URL設定を尊重するため、承認済みの内部フィードを介してインストールをルーティングできます。 フィード認証エラーは、非表示の資格情報プロンプトを開くのではなく、インストールを停止します。 - 企業プロキシ。 CLI は、プロキシの証明書を含むオペレーティング システムの証明書ストア内の証明書を信頼し、
HTTPS_PROXY、HTTP_PROXY、またはオペレーティング システムのプロキシ設定を使用します。 代わりに CLI のバンドルされた証明書リストに対して検証するには、FRONTIER_TUNING_SYSTEM_TRUST=0を設定します。 - カスタム要求ヘッダー。
--headerオプションは、サービス管理者が使用するヘッダーを提供する場合にのみ使用してください。
コーディング エージェントで CLI を使用する
Microsoft は、Markdown を読み取って CLI を実行できるコーディング エージェント向けのガイダンスを公開しています。 これには、 SKILL.md エントリ ポイントに加えて、オンボード、作成、準備、評価、チューニングのためのプレイブックが含まれています。 このガイダンスは、ツールをインストールしたり、アクセス許可を付与したりするものではありません。 これは、リソースを変更したり、有給の作業を開始したりする前に、エージェントに尋ねるように指示します。 GitHub Copilot でのパッケージ化されたエクスペリエンスについては、「GitHub Copilot の Frontier チューニング プラグインを使用する」を参照してください。
インストールとサインインのトラブルシューティング
| 問題 | 操作 |
|---|---|
| インストール後にコマンドが見つかりません。 | 新しいターミナルを開いて更新された PATHを取得するか、インストーラーが印刷したダイレクト コマンド パスを使用します。 |
| パッケージ フィード アクセス エラーが発生してインストールが失敗する。 | パッケージ フィードへのアクセスを構成してから、再試行します。 Windows では、依存関係解決エラーにより、既存の CLI インストールがそのままになります。 |
Windows は WinError 32 (ロックされた実行可能ファイル) を報告します。 |
実行中のFrontier Tuning CLIプロセスをすべて閉じてから、インストーラを再試行します。 |
auth check アクセスが拒否されたことを報告します。 |
表示されたガイダンスに従います。 管理者は、同意を与えるか、Copilot Frontier の対象ユーザーに含めるか、ライセンスを割り当てる必要がある場合があります。 |
| 別のアカウントを使用する必要があります。 | ターミナルで frontier-tuning auth login --interactive を実行します。 Windows では、アカウント ピッカーがターミナル ウィンドウの背後に表示される場合があります。 |
サポートに問い合わせる際は、アクセス トークンや資格情報キャッシュ ファイルを含めないでください。 CLI コマンドとオプションについては、 Frontier Tuning CLI クイックリファレンスを参照してください。