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