diff --git a/agent/slack.mdx b/agent/slack.mdx index 0f2898250..3ea646f25 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -113,6 +113,15 @@ When the agent is making changes to your documentation, it provides live feedbac - **Interruptions**: If you send a follow-up message while the agent is still working, it stops the current task and starts on the new one. - **Completion**: When the agent finishes, it posts a summary with a link to the pull request and a link to open the changes in the web editor. +## Roles and permissions + +The agent's capabilities in Slack match users' [roles](/dashboard/roles). + +- **Admins and editors**: Can ask questions and make documentation changes. The agent has access to file editing and pull request tools. +- **Viewers**: Can ask questions only. The agent runs in read-only mode for Mintlify tools and third-party integrations. + +To change a teammate's permissions, update their role on the [Members](https://dashboard.mintlify.com/settings/organization/members) page of your dashboard. + ## Best practices - **Be specific**: Tell the agent exactly what you want to know or what you want changed and where. diff --git a/dashboard/roles.mdx b/dashboard/roles.mdx index 41367cb43..dcf1697cc 100644 --- a/dashboard/roles.mdx +++ b/dashboard/roles.mdx @@ -16,6 +16,8 @@ Mintlify provides three dashboard access levels: viewer, editor, and admin. | View content in the editor | ✅ | ✅ | ✅ | | Leave comments and suggestions | ✅ | ✅ | ✅ | | View dashboard and analytics | ✅ | ✅ | ✅ | +| Ask the [Slack agent](/agent/slack) questions | ✅ | ✅ | ✅ | +| Make changes with the Slack agent | ❌ | ✅ | ✅ | | Edit content in the web editor | ❌ | ✅ | ✅ | | Publish changes | ❌ | ✅ | ✅ | | Create, rename, and delete pages | ❌ | ✅ | ✅ | diff --git a/es/agent/slack.mdx b/es/agent/slack.mdx index 00382e80e..80b6f9803 100644 --- a/es/agent/slack.mdx +++ b/es/agent/slack.mdx @@ -113,6 +113,17 @@ Mientras el agente trabaja en tu solicitud, proporciona retroalimentación en vi - **Interrupciones**: Si envías un mensaje de seguimiento mientras el agente aún está trabajando, detiene la tarea actual y comienza con la nueva. - **Finalización**: Cuando el agente termina, publica un resumen con un enlace a la solicitud de extracción y un enlace para abrir los cambios en el editor web. +
+ ## Roles y permisos +
+ +Las capacidades del agente en Slack coinciden con el [rol](/es/dashboard/roles) de la cuenta de Mintlify vinculada: + +- **Administradores y editores**: Pueden hacer preguntas y aplicar cambios en la documentación. El agente tiene acceso a las herramientas de edición de archivos y de pull requests. +- **Lectores**: Solo pueden hacer preguntas. El agente se ejecuta en modo de solo lectura, por lo que las herramientas de edición de archivos, de commit y de pull request no están disponibles. Las integraciones de terceros se filtran a acciones de solo lectura. Si un lector le pide al agente que haga un cambio, el agente explica la limitación y sugiere contactar a un compañero editor o administrador. + +Para cambiar los permisos de un compañero, actualiza su rol desde la página [Members](https://dashboard.mintlify.com/settings/organization/members) de tu dashboard. +
## Mejores prácticas
diff --git a/es/dashboard/roles.mdx b/es/dashboard/roles.mdx index 0a170b616..99c0b8076 100644 --- a/es/dashboard/roles.mdx +++ b/es/dashboard/roles.mdx @@ -16,7 +16,9 @@ Mintlify ofrece tres niveles de acceso al dashboard: lector, editor y administra | Ver contenido en el editor | ✅ | ✅ | ✅ | | Dejar comentarios y sugerencias | ✅ | ✅ | ✅ | | Ver el dashboard y Analytics | ✅ | ✅ | ✅ | +| Hacer preguntas al [Slack agent](/es/agent/slack) | ✅ | ✅ | ✅ | | Editar contenido en el editor web | ❌ | ✅ | ✅ | +| Realizar cambios en la documentación con el [Slack agent](/es/agent/slack) | ❌ | ✅ | ✅ | | Publicar cambios | ❌ | ✅ | ✅ | | Crear, renombrar y eliminar páginas | ❌ | ✅ | ✅ | | Reordenar la navegación | ❌ | ✅ | ✅ | diff --git a/fr/agent/slack.mdx b/fr/agent/slack.mdx index c41462777..7119fbbb4 100644 --- a/fr/agent/slack.mdx +++ b/fr/agent/slack.mdx @@ -114,6 +114,17 @@ Pendant que l'agent travaille sur votre demande, il fournit un retour en direct - **Interruptions** : Si vous envoyez un message de suivi pendant que l'agent travaille encore, il arrête la tâche en cours et commence la nouvelle. - **Achèvement** : Lorsque l'agent a terminé, il publie un résumé avec un lien vers la pull request (demande de fusion) et un lien pour ouvrir les modifications dans l'éditeur web. +
+ ## Rôles et autorisations +
+ +Les capacités de l'agent dans Slack correspondent au [rôle](/fr/dashboard/roles) du compte Mintlify associé : + +- **Administrateurs et éditeurs** : Peuvent poser des questions et apporter des modifications à la documentation. L'agent a accès aux outils d'édition de fichiers et de pull requests. +- **Lecteurs** : Peuvent uniquement poser des questions. L'agent fonctionne en mode lecture seule, donc les outils d'édition de fichiers, de commit et de pull request ne sont pas disponibles. Les intégrations tierces sont filtrées sur les actions en lecture seule. Si un lecteur demande à l'agent d'apporter une modification, celui-ci explique la limitation et suggère de demander à un coéquipier éditeur ou administrateur. + +Pour modifier les autorisations d'un coéquipier, mettez à jour son rôle depuis la page [Members](https://dashboard.mintlify.com/settings/organization/members) de votre Dashboard. +
## Bonnes pratiques
diff --git a/fr/dashboard/roles.mdx b/fr/dashboard/roles.mdx index 8fc021845..d903488de 100644 --- a/fr/dashboard/roles.mdx +++ b/fr/dashboard/roles.mdx @@ -16,7 +16,9 @@ Mintlify propose trois niveaux d'accès au Dashboard : lecteur, éditeur et admi | Voir le contenu dans l'éditeur | ✅ | ✅ | ✅ | | Laisser des commentaires et suggestions | ✅ | ✅ | ✅ | | Voir le Dashboard et les Analytics | ✅ | ✅ | ✅ | +| Poser des questions au [Slack agent](/fr/agent/slack) | ✅ | ✅ | ✅ | | Modifier le contenu dans l'éditeur web | ❌ | ✅ | ✅ | +| Modifier la documentation avec le [Slack agent](/fr/agent/slack) | ❌ | ✅ | ✅ | | Publier les modifications | ❌ | ✅ | ✅ | | Créer, renommer et supprimer des pages | ❌ | ✅ | ✅ | | Réorganiser la navigation | ❌ | ✅ | ✅ | diff --git a/zh/agent/slack.mdx b/zh/agent/slack.mdx index eee48b75c..ad0271e44 100644 --- a/zh/agent/slack.mdx +++ b/zh/agent/slack.mdx @@ -110,6 +110,17 @@ keywords: ["Slack 集成", "Slack 机器人", "团队协作", "agent 集成", " - **中断**：如果你在智能体仍在工作时发送后续消息，它会停止当前任务并开始处理新任务。 - **完成**：当智能体完成后，它会发布一份摘要，其中包含指向拉取请求（PR）的链接和在 Web 编辑器中打开更改的链接。 +
+ ## 角色与权限 +
+ +智能体在 Slack 中的能力与已关联的 Mintlify 账号的[角色](/zh/dashboard/roles)保持一致： + +- **管理员和编辑者**：可以提问并对文档进行修改。智能体可以使用文件编辑和拉取请求工具。 +- **查看者**：仅能提问。智能体以只读模式运行，无法使用文件编辑、提交和拉取请求工具。第三方集成会被过滤为只读操作。如果查看者请求智能体进行修改，智能体会说明该限制，并建议联系编辑者或管理员同事。 + +如需更改同事的权限，请在控制台的 [成员](https://dashboard.mintlify.com/settings/organization/members) 页面更新其角色。 +
## 最佳实践
diff --git a/zh/dashboard/roles.mdx b/zh/dashboard/roles.mdx index c60c82cab..b5dfa4812 100644 --- a/zh/dashboard/roles.mdx +++ b/zh/dashboard/roles.mdx @@ -16,7 +16,9 @@ Mintlify 提供三种控制台访问级别：查看者、编辑者和管理员 | 在编辑器中查看内容 | ✅ | ✅ | ✅ | | 留下评论和建议 | ✅ | ✅ | ✅ | | 查看控制台和数据分析 | ✅ | ✅ | ✅ | +| 向 [Slack agent](/zh/agent/slack) 提问 | ✅ | ✅ | ✅ | | 在网页编辑器中编辑内容 | ❌ | ✅ | ✅ | +| 通过 [Slack agent](/zh/agent/slack) 修改文档 | ❌ | ✅ | ✅ | | 发布更改 | ❌ | ✅ | ✅ | | 创建、重命名和删除页面 | ❌ | ✅ | ✅ | | 调整导航顺序 | ❌ | ✅ | ✅ |