Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La CLI de Frontier Tuning esfrontier-tuningftune la herramienta de línea de comandos para crear y operar entornos de ajuste. Úselo para aprovisionar un entorno de ajuste, definir habilidades y criterios de evaluación, y cargar muestras. También puede ejecutar consultas e iniciar trabajos de evaluación y ajuste. Cada comando usa un inicio de sesión de Microsoft 365.
El complemento Frontier Tuning para GitHub Copilot y otros agentes de codificación también usan la CLI para realizar operaciones en el servicio.
Importante
Frontier Tuning está disponible en versión preliminar pública. Las características, los límites y la disponibilidad pueden cambiar, y algunas funcionalidades están habilitadas por inquilino o por entorno.
Requisitos previos
- Acceso a Frontier Tuning. Durante la versión preliminar pública, el administrador debe incluirte en la audiencia de Copilot Frontier del inquilino y necesitas una licencia de Microsoft 365 Copilot. Para ver los pasos de administración, consulta Habilitar el ajuste de Frontier.
- Un sistema operativo compatible. Windows, macOS, Linux, o Subsistema de Windows para Linux (WSL).
- Python 3.10 o posterior. Los instaladores configuran Python cuando es necesario. La configuración automática en Windows requiere winget.
- Un terminal interactivo para el inicio de sesión de Microsoft 365.
- Acceso a la fuente de paquetes, si su organización enruta la instalación del paquete Python a través de una fuente interna. Configure el acceso antes de instalar.
No necesita derechos de administrador para instalar la CLI.
Instalación de la CLI
Elija el instalador de su sistema operativo.
Para instalar la CLI en Windows, siga estos pasos:
Abra PowerShell e instale la CLI:
irm https://aka.ms/ft-cli/v1/ps1 | iexEspere a que finalice la instalación. El instalador comprueba la suma de comprobación del paquete descargado.
Abra un nuevo terminal para que la actualización
PATHsurta efecto, o use la ruta de comando directa que imprime el instalador.
El instalador de Windows crea un entorno de Python privado por usuario y %LOCALAPPDATA%\frontier-tuning\v1\env agrega solo los comandos de la CLI al usuario PATH. No cambia los paquetes de Python existentes. Si no hay una Python compatible, puede instalar Python para el usuario actual a través de winget, sin acceso de administrador.
Nota
En Windows en dispositivos Arm, use Python x64. Nativo Arm64 Python no es compatible con Windows Installer.
Compruebe su versión para confirmar que la CLI está instalada:
frontier-tuning --version
Iniciar sesión y confirmar el acceso
Use la cuenta de Microsoft 365 de su organización para iniciar sesión y comprobar el acceso:
En un terminal interactivo, inicie sesión con la cuenta de Microsoft 365 de su organización:
frontier-tuning auth loginEl primer inicio de sesión de cada versión de CLI instalada muestra el aviso de vista previa de Frontier Tuning. Le pide que acepte los términos complementarios de Microsoft 365 antes de iniciar el inicio de sesión.
Confirma que tu cuenta puede acceder a Frontier Tuning:
frontier-tuning auth checkSi se deniega el acceso, siga las instrucciones que muestra el comando check. Es posible que un administrador tenga que conceder consentimiento o acceso.
Otros comandos de inicio de sesión:
| Comando | Úselo para |
|---|---|
frontier-tuning auth login --interactive |
Vuelva a iniciar sesión o elija otra cuenta. |
frontier-tuning auth whoami |
Mostrar la identidad de inicio de sesión que usa cada comando. |
frontier-tuning auth refresh |
Actualice la autenticación. |
frontier-tuning auth logout |
Cerrar sesión y borrar las credenciales de CLI guardadas. |
frontier-tuning auth probe |
Compruebe el inicio de sesión y el acceso al entorno de ajuste seleccionado. |
Sugerencia
Inicie sesión desde un terminal antes de usar la CLI desde un host de agente, como la aplicación GitHub Copilot. Los hosts de agente ejecutan comandos sin un terminal interactivo, por lo que pueden reutilizar un inicio de sesión existente, pero no pueden mostrar un mensaje de inicio de sesión.
Para la automatización desatendida, puede aceptar los términos de la versión preliminar con --accept-preview-terms o estableciendo FRONTIER_TUNING_ACCEPT_PREVIEW_TERMS=true. Aceptar los términos no proporciona credenciales, no otorga consentimiento ni omite el acceso condicional de Microsoft Entra. Confirme que la directiva de inicio de sesión de su organización admite el escenario. Las directivas de dispositivo administrado pueden bloquear el inicio de sesión con código de dispositivo.
Seleccione el entorno de ajuste que usan los comandos
Al crear un entorno de ajuste con frontier-tuning environments create, la CLI guarda su identificador como predeterminado automáticamente. Para comprobar qué entorno de ajuste está seleccionado, ejecute:
frontier-tuning config show
Para ejecutar un comando en un entorno de ajuste diferente, pase su identificador con -e (o --env-id):
frontier-tuning -e <env-id> skills list
Agregue -o json a cualquier comando para obtener una salida legible mediante máquina y úselo --help en cualquier comando para ver sus opciones.
Mantener la CLI actualizada
Las actualizaciones automáticas están activadas de forma predeterminada. La CLI busca una versión v1 más reciente cada dos horas como máximo y la instala una vez finalizado el siguiente comando.
| Tarea | Comando |
|---|---|
| Compruebe si existe una versión más reciente sin instalarla | frontier-tuning update --check |
| Actualizar ahora | frontier-tuning update |
| Desactivar las actualizaciones automáticas |
frontier-tuning config set auto_update false, o bien FRONTIER_TUNING_AUTO_UPDATE=false |
En Windows, el código de salida 0 de una actualización significa que la actualización se programó, no que finalizó. Lea el status.json archivo cuya ruta imprime el comando y espere a "state": "succeeded" que se vuelva a ejecutar la CLI. En macOS y Linux, las actualizaciones se completan antes de que regrese el comando.
Nota
A partir de la versión 1.0.21 de la CLI, solo se admite la configuración de public conexión. Si la configuración, un perfil o la variable de FRONTIER_TUNING_TRANSPORT entorno sigue usando legacy o workiq, los comandos detienen y explican cómo migrar. Ejecute frontier-tuning config set transport public, actualice cualquier variable de perfil o entorno restante y, a continuación, ejecute frontier-tuning auth login y frontier-tuning auth check.
Uso de la CLI en una red administrada
- Alimentación interna del paquete. Ambos instaladores respetan la configuración y la configuración de Pip, para que pueda enrutar la
FRONTIER_TUNING_PIP_INDEX_URLinstalación a través de una fuente interna aprobada. Los errores de autenticación de fuente detienen la instalación en lugar de abrir un mensaje de credenciales ocultas. - Poder corporativo. La CLI confía en los certificados del almacén de certificados del sistema operativo, incluidos los certificados del proxy, y usa
HTTPS_PROXY,HTTP_PROXYo la configuración de proxy del sistema operativo. Para comprobarlo con la lista de certificados agrupados de la CLI, establezcaFRONTIER_TUNING_SYSTEM_TRUST=0. - Encabezados de solicitud personalizados. Use la opción solo cuando el
--headeradministrador de servicios proporcione encabezados para usar.
Uso de la CLI con un agente de codificación
Microsoft publica instrucciones para los agentes de codificación que pueden leer Markdown y ejecutar la CLI. Incluye un punto de entrada más libros SKILL.md de jugadas para la incorporación, creación, preparación, evaluación y ajuste. La guía no instala herramientas ni concede permisos. Le dice al agente que pregunte antes de cambiar recursos o comenzar un trabajo remunerado. Para obtener una experiencia empaquetada en GitHub Copilot, consulta Uso del complemento Frontier Tuning para GitHub Copilot.
Solución de problemas de instalación e inicio de sesión
| Problema | Qué hacer |
|---|---|
| No se encuentra el comando después de la instalación. | Abra un nuevo terminal para recoger el PATHarchivo actualizado o use la ruta de comando directa que imprimió el instalador. |
| Error en la instalación con un error de acceso a la fuente de paquetes. | Configura el acceso a la fuente del paquete y vuelve a intentarlo. En Windows, un error de resolución de dependencias deja una instalación de CLI existente en su lugar. |
Informes de WinError 32 Windows (un archivo ejecutable bloqueado). |
Cierre todos los procesos de la CLI de Frontier Tuning en ejecución y, luego, vuelva a intentar instalar. |
auth check Informa de que se ha denegado el acceso. |
Siga las instrucciones que se muestran. Es posible que un administrador tenga que otorgar consentimiento, incluirte en la audiencia de Copilot Frontier o asignar una licencia. |
| Necesita usar una cuenta diferente. | Ejecutar frontier-tuning auth login --interactive en una terminal. En Windows, el selector de cuentas puede aparecer detrás de la ventana del terminal. |
Cuando se ponga en contacto con el soporte técnico, nunca incluya tokens de acceso o archivos de caché de credenciales. Para ver los comandos y las opciones de la CLI, consulte la referencia rápida de la CLI de Frontier Tuning.