Frontier Tuning CLI (プレビュー) をインストールして設定する

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 をインストールするには、次の手順を実行します。

  1. PowerShell を開き、CLI をインストールします。

    irm https://aka.ms/ft-cli/v1/ps1 | iex
    
  2. インストールが完了するまで待ちます。 インストーラーは、ダウンロードされたパッケージのチェックサムをチェックします。

  3. 更新された 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 アカウントを使用してサインインし、アクセスをチェックします。

  1. 対話型ターミナルで、organization の Microsoft 365 アカウントでサインインします。

    frontier-tuning auth login
    

    インストールされている CLI バージョンごとの最初のサインインで、Frontier チューニング プレビュー通知が表示されます。 サインインを開始する前に、 Microsoft 365 補足条 項の確認を求めるメッセージが表示されます。

  2. アカウントが Frontier チューニングにアクセスできることを確認します。

    frontier-tuning auth check
    
  3. アクセスが拒否された場合は、チェック コマンドに表示されるガイダンスに従います。 管理者は、同意またはアクセス権を付与する必要がある場合があります。

その他のサインイン コマンド:

コマンド それを使用して
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 クイックリファレンスを参照してください。