diff --git a/agent/slack.mdx b/agent/slack.mdx index 5bf7c569b..7b8887133 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -66,6 +66,27 @@ To remove or reauthorize an organization-level integration, use the **Agent sett For the full list of supported services, see the [Composio toolkits catalog](https://docs.composio.dev/toolkits). +### Control who can use an organization-level integration + +Each organization-level integration has a **visibility** setting that controls which teammates the agent can use it on behalf of, and an **access level** setting that controls what the agent can do with it. Configure both on the [Agent](https://dashboard.mintlify.com/products/agent) page in the dashboard. + +New organization-level integrations default to **hidden** visibility and **read** access. The agent does not use a new integration until you make it available. + +**Visibility levels** + +- **Public**: Any teammate in your organization can have the agent use this integration. Use public for read-only utilities that are safe for the whole team, such as a shared knowledge base or status page. +- **Private**: Only teammates on the allowlist can have the agent use this integration. Use private when the integration is tied to a specific account or contains restricted data. You must add at least one user to the allowlist when you select private. +- **Hidden**: The agent never uses this integration, regardless of who sends the request. Use hidden to pause an integration without disconnecting it, or while you finish configuring it. + +**Access levels** + +- **Read**: The agent can call read-only actions, such as fetching tickets, listing messages, or searching records. The agent cannot create, update, or delete data through the integration. +- **Write**: The agent can call any action exposed by the integration, including actions that create, update, or send data. When you choose write, the agent still asks you to approve each write action in Slack before it runs. + +For example, set Linear to **read** if you want the agent to reference ticket context in documentation but never file new issues, and set Gmail to **public** + **write** so any teammate can ask the agent to draft and send email from a shared inbox. + +Personal integrations that teammates connect from Slack are always private to the user who created them and are not affected by these settings. + ### Expired or revoked connections Mintlify keeps the status of your connected services in sync with Composio. A connection is disconnected when: diff --git a/es/agent/slack.mdx b/es/agent/slack.mdx index 80b6f9803..054411056 100644 --- a/es/agent/slack.mdx +++ b/es/agent/slack.mdx @@ -60,6 +60,29 @@ Para eliminar o volver a autorizar una integración a nivel de organización, us Para ver la lista completa de servicios admitidos, consulta el [catálogo de toolkits de Composio](https://docs.composio.dev/toolkits). +
+ ### Controla quién puede usar una integración a nivel de organización +
+ +Cada integración a nivel de organización tiene un ajuste de **visibilidad** que controla en nombre de qué compañeros de equipo puede usarla el agente, y un ajuste de **nivel de acceso** que controla qué puede hacer el agente con ella. Configura ambos en la página [Agent](https://dashboard.mintlify.com/products/agent) del panel. + +Las nuevas integraciones a nivel de organización se establecen por defecto en visibilidad **hidden** y acceso **read**. El agente no usa una integración nueva hasta que la habilites. + +**Niveles de visibilidad** + +- **Public**: cualquier compañero de tu organización puede pedir al agente que use esta integración. Usa public para utilidades de solo lectura seguras para todo el equipo, como una base de conocimiento compartida o una página de estado. +- **Private**: solo los compañeros de la lista de permitidos pueden pedir al agente que use esta integración. Usa private cuando la integración esté ligada a una cuenta específica o contenga datos restringidos. Debes añadir al menos un usuario a la lista de permitidos cuando selecciones private. +- **Hidden**: el agente nunca usa esta integración, independientemente de quién envíe la solicitud. Usa hidden para pausar una integración sin desconectarla, o mientras terminas de configurarla. + +**Niveles de acceso** + +- **Read**: el agente puede invocar acciones de solo lectura, como obtener tickets, listar mensajes o buscar registros. El agente no puede crear, actualizar ni eliminar datos a través de la integración. +- **Write**: el agente puede invocar cualquier acción expuesta por la integración, incluidas las que crean, actualizan o envían datos. Cuando elijas write, el agente seguirá pidiéndote que apruebes cada acción de escritura en Slack antes de ejecutarla. + +Por ejemplo, configura Linear en **read** si quieres que el agente consulte el contexto de los tickets en la documentación pero nunca cree incidencias nuevas, y configura Gmail en **public** + **write** para que cualquier compañero pueda pedirle al agente que redacte y envíe correos desde un buzón compartido. + +Las integraciones personales que los compañeros conectan desde Slack son siempre privadas para el usuario que las creó y no se ven afectadas por estos ajustes. +
## Usar el agente en Slack
diff --git a/fr/agent/slack.mdx b/fr/agent/slack.mdx index 7119fbbb4..a3a67b0ae 100644 --- a/fr/agent/slack.mdx +++ b/fr/agent/slack.mdx @@ -61,6 +61,29 @@ Pour supprimer ou réautoriser une intégration au niveau de l'organisation, uti Pour la liste complète des services pris en charge, consultez le [catalogue des toolkits Composio](https://docs.composio.dev/toolkits). +
+ ### Contrôlez qui peut utiliser une intégration au niveau de l'organisation +
+ +Chaque intégration au niveau de l'organisation dispose d'un paramètre de **visibilité** qui contrôle pour le compte de quels coéquipiers l'agent peut l'utiliser, et d'un paramètre de **niveau d'accès** qui contrôle ce que l'agent peut en faire. Configurez les deux sur la page [Agent](https://dashboard.mintlify.com/products/agent) du tableau de bord. + +Les nouvelles intégrations au niveau de l'organisation sont définies par défaut sur la visibilité **hidden** et l'accès **read**. L'agent n'utilise pas une nouvelle intégration tant que vous ne l'avez pas rendue disponible. + +**Niveaux de visibilité** + +- **Public** : n'importe quel coéquipier de votre organisation peut demander à l'agent d'utiliser cette intégration. Utilisez public pour les utilitaires en lecture seule qui sont sûrs pour toute l'équipe, comme une base de connaissances partagée ou une page de statut. +- **Private** : seuls les coéquipiers figurant sur la liste d'autorisation peuvent demander à l'agent d'utiliser cette intégration. Utilisez private lorsque l'intégration est liée à un compte spécifique ou contient des données restreintes. Vous devez ajouter au moins un utilisateur à la liste d'autorisation lorsque vous sélectionnez private. +- **Hidden** : l'agent n'utilise jamais cette intégration, quelle que soit la personne qui envoie la requête. Utilisez hidden pour mettre en pause une intégration sans la déconnecter, ou pendant que vous terminez sa configuration. + +**Niveaux d'accès** + +- **Read** : l'agent peut appeler des actions en lecture seule, comme récupérer des tickets, lister des messages ou rechercher des enregistrements. L'agent ne peut pas créer, mettre à jour ni supprimer de données via l'intégration. +- **Write** : l'agent peut appeler toute action exposée par l'intégration, y compris celles qui créent, mettent à jour ou envoient des données. Lorsque vous choisissez write, l'agent vous demande quand même d'approuver chaque action d'écriture dans Slack avant de l'exécuter. + +Par exemple, réglez Linear sur **read** si vous voulez que l'agent référence le contexte des tickets dans la documentation mais ne crée jamais de nouveaux tickets, et réglez Gmail sur **public** + **write** pour que n'importe quel coéquipier puisse demander à l'agent de rédiger et d'envoyer des e-mails depuis une boîte de réception partagée. + +Les intégrations personnelles que les coéquipiers connectent depuis Slack sont toujours privées pour l'utilisateur qui les a créées et ne sont pas affectées par ces paramètres. +
## Utiliser l'agent dans Slack