Usar el área de juegos de PII de documento en Microsoft Foundry

Note

Este contenido hace referencia al nuevo portal de Foundry , que solo admite proyectos de Foundry y proporciona acceso simplificado a modelos, agentes y herramientas. Para confirmar que está usando el nuevo Foundry, asegúrese de que el selector de versión del banner del portal esté en la posición activada.

El entorno de pruebas de PII para documentos de Microsoft Foundry te permite detectar y ocultar información de identificación personal (PII) en documentos nativos de forma interactiva, sin necesidad de escribir código. El entorno de pruebas incluye documentos de ejemplo seleccionados y resultados esperados, por lo que puede evaluar la detección de tipos de entidades comunes —como nombres, direcciones, identificadores financieros e identificadores sanitarios— sin necesidad de cargar sus propios datos. Después, puede pasar a cargar sus propios .pdfarchivos , .docxo .txt cuando esté listo para probar con contenido real.

El procesamiento se controla mediante la canalización PII asincrónica basada en documentos nativos existente: el mismo flujo de trabajo descrito en Detección y redacción de PII en documentos nativos. El entorno de pruebas usa el mismo modelo de PII de documentos y las mismas directivas que la API de producción, por lo que los resultados coinciden con el comportamiento en producción.

Cuando finaliza la tarea, el playground muestra el resultado anonimizado junto al documento de origen. Una sola vista le permite comparar los resultados de detección entre categorías de entidad, revisar las puntuaciones de confianza y evaluar la salida de fidelidad de archivos antes de integrar la API.

Prerrequisitos

Tip

• Si ya tiene un lenguaje de Azure en Foundry Tools o un recurso de varios servicios( ya sea por su cuenta o a través de Language Studio), puede seguir usando esos recursos de lenguaje existentes en el portal de Microsoft Foundry.
• Para obtener más información, consulte Conexión de servicios en el portal de Microsoft Foundry.
• Considere la posibilidad de usar un recurso Foundry para obtener la mejor experiencia. También puede seguir estas instrucciones utilizando un recurso lingüístico.

• Suscripción de Azure. Si no tiene una, puede crear una de forma gratuita.
• Permisos necesarios. Asegúrese de que a la persona que crea la cuenta y el proyecto se le asigne el rol de Propietario de la cuenta de Foundry en el nivel de la suscripción. Como alternativa, tener el rol Colaborador o Colaborador de Cognitive Services en el ámbito de la suscripción también cumple este requisito. Para obtener más información, consulte Control de acceso basado en rol (RBAC).
• Recurso de Foundry. Cree un recurso foundry o consulte Configuración de un recurso foundry. Como alternativa, puede usar un recurso de idioma.
• Un proyecto de fundición. Para obtener más información, vea Create a Foundry project.

Requisitos de control de acceso basado en rol (RBAC)

Asigne los roles correctos a la entidad de seguridad de usuario y la identidad administrada del proyecto para acceder al área de juegos de PII de documento. Microsoft recomienda usar la autenticación Microsoft Entra ID, que exige restricciones basadas en roles. La autenticación basada en claves concede acceso completo sin comprobaciones de roles y debe evitarse en entornos de producción.

Importante

Recientemente se cambió el nombre de los roles RBAC de Foundry. Foundry User, Foundry Owner, Foundry Account Owner y Foundry Project Manager se llamaban anteriormente Usuario de Azure AI, Propietario de Azure AI, Propietario de la cuenta de Azure AI y Administrador de proyectos de Azure AI. Es posible que siga viendo los nombres anteriores en algunos lugares mientras se implementa el cambio de nombre. Los identificadores de rol y los permisos principales no se modifican.

• Asigne los roles mínimos necesarios tanto a su entidad de seguridad de usuario como a la identidad administrada del proyecto para que puedan acceder a las características de Foundry.

• Verifique las asignaciones actuales con Comprobar el acceso de un usuario a un único recurso de Azure.

Vaya al área de juegos.

El proyecto activo aparece en la esquina superior izquierda. Para crear un nuevo proyecto:

1. Abra el menú desplegable del proyecto.

2. Escriba un nombre de proyecto o seleccione uno existente.

3. Seleccione Crear proyecto.

   

Hay dos maneras de acceder a la interfaz PII del documento:

• Seleccione la pestaña Detectar en la barra de navegación superior derecha:

  1. En la barra de búsqueda, escriba Azure y presione Enter.
  2. Seleccione Redacción de PII de documento de idioma de Azure en los resultados.
  3. Seleccione Abrir en área de juegos.

• Seleccione la pestaña Compilar en la barra de navegación superior derecha:

  1. En la barra de navegación izquierda, seleccione Modelos.
  2. Seleccione la pestaña Servicios de IA .
  3. Seleccione Azure-Language-Document-PII redaction para ir directamente al área de juegos.

Ocultar información de identificación personal en documentos

El modelo Azure-Language-Document-PII redaction identifica y redacta información de identificación personal en archivos de documentos nativos, incluidos .pdf, .docx y .txt archivos. El área de juegos conserva el diseño y el formato del documento en la salida redactada.

1. En la pestaña Zona de pruebas, seleccione Azure Language: ocultación de PII en documentos en el menú desplegable.

2. Use el documento de ejemplo preparado que se carga de forma predeterminada o use el icono de paperclip para cargar su propio .pdfdocumento , .docxo .txt .

3. En el panel Configurar , establezca las siguientes opciones:

   Opción	Description
   Versión de API	Seleccione la versión de API que prefiera usar.
   Versión del modelo	Seleccione la versión del modelo que prefiera usar.
   Language	Seleccione el idioma en el que se escribe el documento.
   Selección de tipos que se van a incluir	Seleccione los tipos de Información de Identificación Personal (IIP) que desea redactar.
   Tipo de directiva	Elija el tipo de política de redacción que se va a aplicar (máscara de caracteres, máscara de entidad o sin máscaras).

4. Seleccione Detectar. La solicitud se envía a través de la canalización de PII existente, asíncrona y basada en documentos de archivos nativos. Una vez completado el procesamiento, el documento redactado se muestra en paralelo con el documento de origen para la comparación. Puede revisar las entidades detectadas en el panel Detalles .

   Campo	Description
   Tipo	Tipo de entidad detectado (categoría).
   Confianza	El nivel de certeza del modelo con respecto a si identificó correctamente un tipo de entidad.
   Desplazamiento	Posición de la entidad dentro del documento.
   Longitud	La longitud del carácter de la entidad.

   La vista lado a lado también refleja los resultados de fidelidad del archivo, mostrando hasta qué punto la versión censurada conserva el diseño y formato del documento original. Utilícelo para evaluar tanto la precisión de la anonimización como la calidad del renderizado de documentos antes de integrar la API.

Compruebe que las entidades detectadas coinciden con el PII en el documento de entrada. Use el botón Editar para modificar los parámetros Configurar y volver a enviar el documento según sea necesario.