Colaboración con otros creadores y editores

Colabore con otros creadores y editores mediante el control de acceso basado en rol de Azure (RBAC de Azure) colocado en el recurso de QnA Maker.

Nota

El servicio QnA Maker se retirará del mercado el 31 de marzo de 2025. Ya hay disponible una versión más reciente de la funcionalidad de preguntas y respuestas como parte de Lenguaje de Azure AI. Para más información sobre las funcionalidades de respuesta a preguntas en el servicio de lenguaje, consulte Respuesta a preguntas. A partir del 1 de octubre de 2022 no podrá crear nuevos recursos de QnA Maker. Para obtener información sobre la migración de knowledge bases existentes de QnA Maker a respuesta a preguntas, consulte la guía de migración.

El acceso se proporciona en el recurso de QnA Maker

Todos los permisos se controlan mediante los permisos colocados en el recurso de QnA Maker. Estos permisos se alinean con el acceso de lectura, escritura, publicación y completo. Puede permitir la colaboración entre varios usuarios mediante la actualización del acceso a RBAC para el recurso QnA Maker.

Esta característica de RBAC de Azure incluye lo siguiente:

• Microsoft Entra ID ofrece una compatibilidad con versiones anteriores total con la autenticación basada en claves para propietarios y colaboradores. Los clientes pueden usar la autenticación basada en claves o en RBAC de Azure en sus solicitudes.
• Agregue creadores y editores rápidamente a todas las bases de conocimiento del recurso, ya que el control se encuentra en el nivel de recursos, no en el de base de conocimiento.

Nota

Asegúrese de agregar un subdominio personalizado al recurso. El subdominio personalizado debe estar presente de forma predeterminada pero, si no es así, agréguelo.

El acceso lo proporciona un rol definido

Se proporcionan los siguientes roles para la colaboración:

Role	Funcionalidades	Acceso de API	Permisos de API
Propietario	All	Clave de autenticación	All
Colaborador de Cognitive Services	Todas, excepto la capacidad de agregar nuevos miembros a los roles	Clave de autenticación	Todas, excepto la capacidad de agregar nuevos miembros a los roles
Lector de QnA Maker de Cognitive Services (lectura)	Exportar/Descargar Prueba	Token de portador	1. Descargar API de KB 2. Lista de KB para la API de usuario 3. Obtención de los detalles de la base de conocimientos 4. Descargar modificaciones Generar respuestas
Editor de QnA Maker de Cognitive Services (lectura/escritura)	Exportar/Descargar Prueba Actualizar KB Exportar KB Importar KB Reemplazar KB Crear una base de conocimiento	Token de portador	1. Crear API de KB 2. Actualizar API de KB 3. Reemplazar API de KB 4. Reemplazar modificaciones 5. "Entrenar API" [en el nuevo modelo de servicio v5]
Usuario de Cognitive Services (lectura, escritura y publicación)	All	Clave de autenticación	Todo el acceso al recurso de servicios de Azure AI, excepto la capacidad de: 1. Agregar nuevos miembros a roles. 2. Crear nuevos recursos.

Flujo de autenticación

En el diagrama siguiente se muestra el flujo, desde la perspectiva del creador, para iniciar sesión en el portal de QnA Maker y usar las API de creación.

Pasos	Descripción
1	El portal adquiere el token para el recurso de QnA Maker.
2	El portal llama a la API de creación de QnA Maker (APIM) apropiada y pasa el token en lugar de las claves.
3	La API de QnA Maker valida el token.
4	La API de QnA Maker llama al servicio QnAMaker.

Si tiene previsto llamar a las API de creación, obtenga más información sobre cómo configurar la autenticación.

Autenticación mediante el portal de QnA Maker

Si crea y colabora con el portal de QnA Maker, después de agregar el rol adecuado al recurso para un colaborador, en el portal de QnA Maker se administran todos los permisos de acceso.

Autenticación mediante API y SDK de QnA Maker

Si crea y colabora mediante API, ya sea a través de REST o los SDK, tendrá que crear una entidad de servicio para administrar la autenticación.

Paso siguiente

• Diseño de una base de conocimiento para lenguajes o aplicaciones cliente