Compartir a través de

Solución de problemas de la API de Windows AI

Importante

Las aplicaciones que usan Phi Silica APIs pueden experimentar problemas con la compatibilidad con características de acceso limitado (consulte LimitedAccessFeatures).

En este momento, se recomienda usar versiones experimentales , ya que no requieren tokens LAF.

Requisitos

Equipamiento

Las características de Phi Silica requieren un ordenador Copilot+ (los teclados portátiles tienen una tecla Copilot dedicada). Consulte la guía del desarrollador para PC Copilot+ para obtener una lista de los dispositivos recomendados.

Programas informáticos

Windows 11, versión 25H2 (compilación 10.0.26200.7309) o posterior debe instalarse en el equipo Copilot+. Para comprobarlo, abra el menú Inicio, escriba "winver" y presione Entrar (un cuadro de diálogo con los detalles del sistema operativo, similar al siguiente, debería aparecer).

Captura de pantalla del cuadro de diálogo versión de Windows que se muestra escribiendo

Asegúrese de que puede usar características de PhiLice:

  1. Descargue e instale la aplicación ai Dev Gallery desde Microsoft Store.
  2. Ejecute la aplicación.
  3. Seleccione IA APIs en el panel izquierdo.
  4. Haga clic en Phi Silica>Text Generation.
  5. Confirme que PhiLice responde a un aviso (la aplicación de ejemplo comienza con un mensaje predeterminado).

Captura de pantalla de la aplicación de ejemplo ai Dev Gallery que muestra un ejemplo básico de la característica Generación de texto.

Otras recomendaciones

Habilite Modo desarrollador en Configuración>Sistema>Para desarrolladores>Modo desarrollador.

Instale Visual Studio con las cargas de trabajo y los componentes necesarios para desarrollar con WinUI y Windows App SDK. Para más información, consulte Cargas de trabajo y componentes necesarios.

Depuración

Si PhiLice no parece estar trabajando en su sistema, hay algunas cosas que puede hacer.

  1. Compruebe que tiene todos los modelos necesarios instalados; para ello, vaya a Configuración componentes > de IA del sistema>, que muestra los modelos de IA disponibles en el sistema. Si el modelo necesario no aparece en la lista, vaya a Configuración > de Windows Update y haga clic en "Buscar actualizaciones" (es posible que se requiera un reinicio).

  2. Compruebe que la aplicación usa una versión mínima de WinAppSDK válida.

    • Estable: 1.8.3
    • Experimental: 2.0-Exp3

  3. Compruebe Actualizaciones de configuración>para asegurarse de que las actualizaciones de Windows no están en pausa.

  4. Recopile registros a través de la aplicación Centro de comentarios de Windows y compártalos con el equipo de Windows para revisarlos.

    1. Abra la aplicación Centro de opiniones (clave de Windows + F).
    2. Inicie sesión con su cuenta preferida.
    3. Escriba los detalles del error en la sección 1 (prefijo del título del error con "[Windows AI APIs]").
    4. En la sección 2, haga clic en Problema, seleccione Plataforma para desarrolladores en la primera lista desplegable y, a continuación, seleccione Windows AI Foundry en la segunda lista desplegable.
    5. La sección 3 mostrará los comentarios existentes similares a los suyos. Si no se encuentra ningún comentario existente, seleccione Nuevo comentario y haga clic en Siguiente.
    6. En la sección 4 puede:
      1. Haga clic en Volver a crear mi problema y, a continuación, haga clic en Iniciar grabación, ejecute ai Dev Gallery, reproduzca el problema y detenga la grabación.
      2. Incluya información adicional y datos adjuntos (como imágenes). Proporcione tantos detalles como sea posible, incluidos los pasos de reproducción y los mensajes de error.
    7. Envíe los comentarios.

Otras instrucciones

  • Las aplicaciones que usan Windows AI APIs deben concederse identidades de paquete en tiempo de ejecución. Para obtener más información, consulta Ventajas y desventajas del empaquetado de la aplicación. Si ve un error UnauthorizedAccessException (o tiene otros problemas de acceso), asegúrese de que la aplicación está empaquetada y de que la funcionalidad systemAIModels se agregó al archivo de manifiesto (consulte Introducción a la creación de una aplicación con Windows AI APIs).

  • Requisitos de la Funcionalidad de Acceso Limitado (LAF):

  • Las aplicaciones independientes no se pueden ejecutar desde la carpeta Descargas (o desde cualquier lugar de la C:\Users carpeta). Para obtener más información, consulte Ventajas y desventajas del empaquetado de la aplicación y la introducción a la implementación de Windows App SDK.

  • El canal experimental del SDK de aplicaciones de Windows incluye APIs y características en etapas tempranas de desarrollo. Todo APIs en el canal experimental está sujeto a revisiones extensas y cambios importantes y se puede quitar de las versiones posteriores en cualquier momento. Las características experimentales no se admiten para su uso en entornos de producción y las aplicaciones que las usan no se pueden publicar en Microsoft Store.

  • Proporcione comentarios sobre estas APIs y su funcionalidad creando un nuevo problema en el repositorio de GitHub del SDK de aplicaciones de Windows (incluya PhiLice en el título) o respondiendo a un problema existente.

Consulte también

  • Last updated on