diff --git a/automations/index.mdx b/automations/index.mdx index fb2e5e27c..7a3a8cfc1 100644 --- a/automations/index.mdx +++ b/automations/index.mdx @@ -27,7 +27,7 @@ Automations support four trigger types. - **Content update**: Runs when content changes push to your Mintlify project repository, including pull request merges and direct pushes. - **Code change**: Runs when a pull request merges in a connected source code repository. - **Custom schedule**: Runs on a recurring schedule. Automations queue within 10 minutes of the scheduled time. -- **Integration**: Runs when a selected event occurs in a connected shared integration. Requires an [Enterprise plan](https://mintlify.com/pricing?ref=automations). +- **Integration**: Runs when a selected event occurs in a connected shared integration or when a new message posts to a selected Slack channel. Requires an [Enterprise plan](https://mintlify.com/pricing?ref=automations). Each automation has exactly one trigger. You cannot combine trigger types in a single automation. diff --git a/automations/integrations.mdx b/automations/integrations.mdx index f751ea97c..e99ca266d 100644 --- a/automations/integrations.mdx +++ b/automations/integrations.mdx @@ -11,10 +11,10 @@ Integrations connect the Mintlify agent to other tools your team uses. The agent | --- | --- | | **Slack agent** | Uses shared integrations and the personal integrations of the teammate who is chatting with the agent as context. | | **Automation tool** | Gives an automation read-only context from the shared integrations selected in its **Tools** setting. | -| **Automation trigger** | Starts a custom automation when a selected event occurs in a supported shared integration. | +| **Automation trigger** | Starts a custom automation when a selected event occurs in a supported shared integration or when a new message posts to a selected Slack channel. | - The [Mintlify Slack app](/agent/slack) is separate from the integrations on this page. Installing the Slack app adds the agent to your workspace and gives the agent and automation runs access to Slack content that the app can read. You do not connect Slack from the **Integrations** settings page or select it in an automation's **Tools** field. + The [Mintlify Slack app](/agent/slack) is separate from the third-party integrations on this page. Installing the Slack app adds the agent to your workspace and gives it access to Slack content that the app can read. You do not connect Slack from the **Integrations** settings page or select it in an automation's **Tools** field, but you can select it as a custom automation trigger once you install the Slack app. ## Connection scope @@ -101,7 +101,7 @@ If an integration is an automation trigger, it is always a tool for that automat ## Trigger an automation from an integration -Custom automations can run when an event occurs in a supported shared integration. +Custom automations can run when an event occurs in a supported shared integration or when a new message posts to a selected Slack channel. 1. Create or open a custom automation. 2. For **Trigger**, select **Integration**. @@ -118,11 +118,14 @@ The supported events depend on the integration: | Jira | Issue created; issue updated; project created | | Linear | Issue created; issue updated; project created; project update posted | | Notion | Page created; page content updated | +| Slack | New message in a selected channel | | Stripe | Product created | | Zendesk | Ticket created | When the event occurs, Mintlify starts the automation and includes the event payload as context for the agent. Duplicate deliveries of the same event do not start duplicate runs. +When you use Slack messages as a trigger, only new top-level messages in selected channels start a run. Automations cannot trigger off of thread replies. + ## Permissions and access The agent has read-only access through third-party integration tools. It can search and retrieve content, but it cannot use these tools to create, edit, or delete data in the connected app. diff --git a/automations/manage.mdx b/automations/manage.mdx index 0a0784aa4..1a77b21a7 100644 --- a/automations/manage.mdx +++ b/automations/manage.mdx @@ -44,7 +44,7 @@ Each automation has a default trigger that controls when it runs. To change the - **Content update**: Runs whenever you push content to your project repository, including pull request merges and direct pushes. - **Code change**: Runs when a pull request merges in a connected source code repository. You must specify at least one source repository. - **Custom schedule**: Runs on a recurring schedule you define. Automations queue within 10 minutes of the scheduled time. -- **Integration**: Runs when a selected event occurs in a connected shared integration. Available for custom automations. Select the integration and event, then complete any additional event fields that appear. +- **Integration**: Runs when a selected event occurs in a connected shared integration or when a new message posts to a selected Slack channel. Available for custom automations. Select the integration and event, then complete any additional event fields that appear. For Slack triggers, pick one or more channels that you have added the [Mintlify Slack app](/agent/slack) to. ### Update mode diff --git a/es/automations/index.mdx b/es/automations/index.mdx index f42b3bf29..cae40b527 100644 --- a/es/automations/index.mdx +++ b/es/automations/index.mdx @@ -29,7 +29,7 @@ Las automatizaciones admiten cuatro tipos de activadores. - **Actualización de contenido**: se ejecuta cuando se hacen pushes con cambios de contenido al repositorio de tu proyecto de Mintlify, incluidas las fusiones de pull requests y los pushes directos. - **Cambio de código**: se ejecuta cuando se fusiona una pull request en un repositorio de código fuente conectado. - **Programación personalizada**: se ejecuta de forma recurrente. Las automatizaciones se ponen en cola dentro de los 10 minutos siguientes a la hora programada. -- **Integración**: se ejecuta cuando ocurre un evento seleccionado en una integración compartida conectada. Está disponible para automatizaciones personalizadas. +- **Integración**: se ejecuta cuando ocurre un evento seleccionado en una integración compartida conectada, o cuando se publica un nuevo mensaje de nivel superior en un canal de Slack seleccionado. Está disponible para automatizaciones personalizadas. Cada automatización tiene exactamente un activador. No puedes combinar tipos de activadores en una sola automatización. diff --git a/es/automations/integrations.mdx b/es/automations/integrations.mdx index ee3893fde..89e80e9ef 100644 --- a/es/automations/integrations.mdx +++ b/es/automations/integrations.mdx @@ -11,10 +11,10 @@ Las integraciones conectan el agente de Mintlify con las herramientas que ya usa | --- | --- | | **Agente de Slack** | Usa las integraciones compartidas y las integraciones personales del miembro que habla con el agente. | | **Herramienta de automatización** | Proporciona contexto de solo lectura desde las integraciones compartidas seleccionadas en **Tools**. | -| **Activador de automatización** | Inicia una automatización personalizada cuando ocurre un evento compatible en una integración compartida. | +| **Activador de automatización** | Inicia una automatización personalizada cuando ocurre un evento compatible en una integración compartida, o cuando se publica un nuevo mensaje de nivel superior en un canal de Slack seleccionado. | - La [app de Mintlify para Slack](/es/agent/slack) es independiente de las integraciones de esta página. Instalarla añade el agente a tu espacio de trabajo y da al agente y a las ejecuciones de automatizaciones acceso al contenido de Slack que la app puede leer. Slack no se conecta desde **Integrations** ni se selecciona en **Tools**. + La [app de Mintlify para Slack](/es/agent/slack) es independiente de las integraciones de terceros de esta página. Instalarla añade el agente a tu espacio de trabajo y da al agente y a las ejecuciones de automatizaciones acceso al contenido de Slack que la app puede leer. Slack no se conecta desde **Integrations** ni se selecciona en **Tools**, pero puedes seleccionarlo como activador de una automatización personalizada una vez instalada la app de Slack.
@@ -116,7 +116,7 @@ La integración utilizada como activador se incluye automáticamente como herram 1. Crea o abre una automatización personalizada. 2. En **Trigger**, selecciona **Integration**. -3. Selecciona o conecta una integración compartida. +3. Selecciona o conecta una integración compartida, o selecciona **Slack**. 4. Selecciona el **Trigger event** y completa los campos adicionales. 5. Guarda y activa la automatización. @@ -128,11 +128,22 @@ Cada automatización tiene un solo activador. Seleccionar **Integration** reempl | Jira | Incidencia creada; incidencia actualizada; proyecto creado | | Linear | Incidencia creada; incidencia actualizada; proyecto creado; actualización de proyecto publicada | | Notion | Página creada; contenido de página actualizado | +| Slack | Nuevo mensaje en un canal seleccionado | | Stripe | Producto creado | | Zendesk | Ticket creado | Cuando ocurre el evento, Mintlify inicia la automatización e incluye los datos del evento como contexto. +
+ ### Activadores por mensaje de canal de Slack +
+ +Selecciona **Slack** como integración de activador para ejecutar una automatización personalizada cuando alguien publique un nuevo mensaje en un canal que elijas. Requiere que la [app de Mintlify para Slack](/es/agent/slack) esté instalada y añadida a cada canal seleccionado. + +- Solo los mensajes de nivel superior en los canales seleccionados inician una ejecución. Se ignoran las respuestas en hilos y los mensajes que mencionan al agente de Mintlify. +- El agente recibe el texto del mensaje, el canal, el remitente y un enlace permanente como contexto, y luego decide si el mensaje justifica una acción como actualizar la documentación. No todos los mensajes generan un cambio. +- Puedes seleccionar varios canales en una misma automatización. Cada canal debe ser público o un canal privado al que se haya añadido la app de Mintlify. +
## Permisos y acceso
diff --git a/es/automations/manage.mdx b/es/automations/manage.mdx index e6662886d..7b072fa1c 100644 --- a/es/automations/manage.mdx +++ b/es/automations/manage.mdx @@ -52,7 +52,7 @@ Cada automatización tiene un activador predeterminado que controla cuándo se e - **Actualización de contenido**: se ejecuta cada vez que envías contenido al repositorio de tu proyecto, incluidas las fusiones de pull requests y los pushes directos. - **Cambio de código**: se ejecuta cuando se fusiona una pull request en un repositorio de código fuente conectado. Debes especificar al menos un repositorio de origen. - **Programación personalizada**: se ejecuta de forma recurrente según la programación que definas. Las automatizaciones se ponen en cola dentro de los 10 minutos siguientes a la hora programada. -- **Integración**: se ejecuta cuando ocurre un evento seleccionado en una integración compartida conectada. Está disponible para automatizaciones personalizadas. Selecciona la integración y el evento y completa los campos adicionales que aparezcan. +- **Integración**: se ejecuta cuando ocurre un evento seleccionado en una integración compartida conectada, o cuando se publica un nuevo mensaje de nivel superior en un canal de Slack seleccionado. Está disponible para automatizaciones personalizadas. Selecciona la integración y el evento y completa los campos adicionales que aparezcan. Para activadores de Slack, elige uno o más canales a los que se haya añadido la [app de Mintlify para Slack](/es/agent/slack).
### Modo de actualización diff --git a/fr/automations/index.mdx b/fr/automations/index.mdx index 45da11140..9725b1105 100644 --- a/fr/automations/index.mdx +++ b/fr/automations/index.mdx @@ -29,7 +29,7 @@ Les automatisations prennent en charge quatre types de déclencheurs. - **Mise à jour de contenu** : s'exécute lorsque des modifications de contenu sont poussées vers le dépôt de votre projet Mintlify, y compris les fusions de pull requests et les pushes directs. - **Modification de code** : s'exécute lorsqu'une pull request est fusionnée dans un dépôt de code source connecté. - **Calendrier personnalisé** : s'exécute selon un calendrier récurrent. Les automatisations sont mises en file d'attente dans les 10 minutes suivant l'heure planifiée. -- **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée. Disponible pour les automatisations personnalisées. +- **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée, ou lorsqu'un nouveau message de premier niveau est publié dans un canal Slack sélectionné. Disponible pour les automatisations personnalisées. Chaque automatisation possède exactement un déclencheur. Vous ne pouvez pas combiner plusieurs types de déclencheurs dans une seule automatisation. diff --git a/fr/automations/integrations.mdx b/fr/automations/integrations.mdx index 93102b845..cf5dba0c5 100644 --- a/fr/automations/integrations.mdx +++ b/fr/automations/integrations.mdx @@ -11,10 +11,10 @@ Les intégrations connectent l'agent Mintlify aux outils déjà utilisés par vo | --- | --- | | **Agent Slack** | Utilise les intégrations partagées et les intégrations personnelles de la personne qui discute avec l'agent. | | **Outil d'automatisation** | Fournit un contexte en lecture seule depuis les intégrations partagées sélectionnées dans **Tools**. | -| **Déclencheur d'automatisation** | Lance une automatisation personnalisée lorsqu'un événement pris en charge se produit dans une intégration partagée. | +| **Déclencheur d'automatisation** | Lance une automatisation personnalisée lorsqu'un événement pris en charge se produit dans une intégration partagée, ou lorsqu'un nouveau message de premier niveau est publié dans un canal Slack sélectionné. | - L'[application Slack Mintlify](/fr/agent/slack) est distincte des intégrations de cette page. Son installation ajoute l'agent à votre espace de travail et donne à l'agent et aux exécutions d'automatisations accès au contenu Slack que l'application peut lire. Slack ne se connecte pas depuis **Integrations** et ne se sélectionne pas dans **Tools**. + L'[application Slack Mintlify](/fr/agent/slack) est distincte des intégrations tierces de cette page. Son installation ajoute l'agent à votre espace de travail et donne à l'agent et aux exécutions d'automatisations accès au contenu Slack que l'application peut lire. Slack ne se connecte pas depuis **Integrations** et ne se sélectionne pas dans **Tools**, mais vous pouvez le sélectionner comme déclencheur d'une automatisation personnalisée une fois l'application Slack installée.
@@ -116,7 +116,7 @@ L'intégration utilisée comme déclencheur est automatiquement incluse comme ou 1. Créez ou ouvrez une automatisation personnalisée. 2. Pour **Trigger**, sélectionnez **Integration**. -3. Sélectionnez ou connectez une intégration partagée. +3. Sélectionnez ou connectez une intégration partagée, ou sélectionnez **Slack**. 4. Sélectionnez le **Trigger event** et remplissez les champs supplémentaires. 5. Enregistrez et activez l'automatisation. @@ -128,11 +128,22 @@ Chaque automatisation possède un seul déclencheur. **Integration** remplace un | Jira | Ticket créé ; ticket mis à jour ; projet créé | | Linear | Ticket créé ; ticket mis à jour ; projet créé ; mise à jour de projet publiée | | Notion | Page créée ; contenu de page mis à jour | +| Slack | Nouveau message dans un canal sélectionné | | Stripe | Produit créé | | Zendesk | Ticket créé | Lorsque l'événement se produit, Mintlify lance l'automatisation et inclut les données de l'événement comme contexte. +
+ ### Déclencheurs sur message de canal Slack +
+ +Sélectionnez **Slack** comme intégration de déclenchement pour exécuter une automatisation personnalisée lorsqu'une personne publie un nouveau message dans un canal que vous choisissez. Requiert l'installation de l'[application Mintlify pour Slack](/fr/agent/slack) et son ajout à chaque canal sélectionné. + +- Seuls les messages de premier niveau dans les canaux sélectionnés déclenchent une exécution. Les réponses dans un fil et les messages qui mentionnent l'agent Mintlify sont ignorés. +- L'agent reçoit le texte du message, le canal, l'expéditeur et un lien permanent comme contexte, puis décide si le message justifie une action telle qu'une mise à jour de la documentation. Tous les messages ne produisent pas de modification. +- Vous pouvez sélectionner plusieurs canaux dans une même automatisation. Chaque canal doit être public ou un canal privé auquel l'application Mintlify a été ajoutée. +
## Autorisations et accès
diff --git a/fr/automations/manage.mdx b/fr/automations/manage.mdx index 80123fd6a..e33efa0d9 100644 --- a/fr/automations/manage.mdx +++ b/fr/automations/manage.mdx @@ -52,7 +52,7 @@ Chaque automatisation possède un déclencheur par défaut qui contrôle son mom - **Mise à jour de contenu** : s'exécute chaque fois que vous poussez du contenu vers le dépôt de votre projet, y compris les fusions de pull requests et les pushes directs. - **Modification de code** : s'exécute lorsqu'une pull request est fusionnée dans un dépôt de code source connecté. Vous devez spécifier au moins un dépôt source. - **Calendrier personnalisé** : s'exécute selon un calendrier récurrent que vous définissez. Les automatisations sont mises en file d'attente dans les 10 minutes suivant l'heure planifiée. -- **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée. Disponible pour les automatisations personnalisées. Sélectionnez l'intégration et l'événement, puis remplissez les champs supplémentaires affichés. +- **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée, ou lorsqu'un nouveau message de premier niveau est publié dans un canal Slack sélectionné. Disponible pour les automatisations personnalisées. Sélectionnez l'intégration et l'événement, puis remplissez les champs supplémentaires affichés. Pour les déclencheurs Slack, choisissez un ou plusieurs canaux auxquels l'[application Mintlify pour Slack](/fr/agent/slack) a été ajoutée.
### Mode de mise à jour diff --git a/zh/automations/index.mdx b/zh/automations/index.mdx index 0b0eaf285..c3c635d51 100644 --- a/zh/automations/index.mdx +++ b/zh/automations/index.mdx @@ -29,7 +29,7 @@ boost: 5 - **内容更新（Content update）**：当内容推送到你的 Mintlify 项目仓库时运行，包括 pull request 合并和直接推送。 - **代码变更（Code change）**：当已连接的源代码仓库中有 pull request 合并时运行。 - **自定义计划（Custom schedule）**：按周期性计划运行。自动化会在预定时间的 10 分钟内进入队列。 -- **集成（Integration）**：当已连接的共享集成中发生所选事件时运行。此选项适用于自定义自动化。 +- **集成（Integration）**：当已连接的共享集成中发生所选事件时运行，或当在所选 Slack 频道中发布新的顶层消息时运行。此选项适用于自定义自动化。 每个自动化只能有一个触发器。你无法在单个自动化中组合多种触发器类型。 diff --git a/zh/automations/integrations.mdx b/zh/automations/integrations.mdx index c20674f4a..8ad8acc36 100644 --- a/zh/automations/integrations.mdx +++ b/zh/automations/integrations.mdx @@ -11,10 +11,10 @@ keywords: ["集成", "Slack agent", "Notion", "Linear", "Jira", "LaunchDarkly", | --- | --- | | **Slack agent** | 使用组织的共享集成，以及正在与 agent 对话的团队成员所连接的个人集成。 | | **自动化工具** | 从自动化 **Tools** 设置中选择的共享集成获取只读上下文。 | -| **自动化触发器** | 当受支持的共享集成中发生所选事件时，启动自定义自动化。 | +| **自动化触发器** | 当受支持的共享集成中发生所选事件时，或当在所选 Slack 频道中发布新的顶层消息时，启动自定义自动化。 | - [Mintlify Slack 应用](/zh/agent/slack)与本页中的集成相互独立。安装 Slack 应用会将 agent 添加到工作区，并让 agent 和自动化运行访问该应用获准读取的 Slack 内容。你不需要在 **Integrations** 中连接 Slack，也不需要在自动化的 **Tools** 中选择它。 + [Mintlify Slack 应用](/zh/agent/slack)与本页中的第三方集成相互独立。安装 Slack 应用会将 agent 添加到工作区，并让 agent 和自动化运行访问该应用获准读取的 Slack 内容。你不需要在 **Integrations** 中连接 Slack，也不需要在自动化的 **Tools** 中选择它，但在安装 Slack 应用后，你可以将其选为自定义自动化的触发器。
@@ -116,7 +116,7 @@ Agent 仅在集成数据与请求相关时访问这些数据。 1. 创建或打开自定义自动化。 2. 在 **Trigger** 中选择 **Integration**。 -3. 选择或连接一个共享集成。 +3. 选择或连接一个共享集成，或选择 **Slack**。 4. 选择 **Trigger event**，并填写出现的其他事件字段。 5. 保存并启用自动化。 @@ -128,11 +128,22 @@ Agent 仅在集成数据与请求相关时访问这些数据。 | Jira | Issue 创建；issue 更新；项目创建 | | Linear | Issue 创建；issue 更新；项目创建；项目更新发布 | | Notion | 页面创建；页面内容更新 | +| Slack | 所选频道中的新消息 | | Stripe | 产品创建 | | Zendesk | Ticket 创建 | 事件发生时，Mintlify 会启动自动化，并将事件数据作为 agent 的上下文。 +
+ ### Slack 频道消息触发器 +
+ +将 **Slack** 选为触发器集成，可在有人在你选择的频道中发布新消息时运行自定义自动化。需要安装 [Mintlify Slack 应用](/zh/agent/slack)，并已将其添加到你选择的每个频道。 + +- 仅所选频道中的顶层消息会启动运行。会忽略线程回复以及提及 Mintlify agent 的消息。 +- Agent 会将消息文本、频道、发送者和永久链接作为上下文，然后判断该消息是否值得采取某种操作，例如更新文档。并非每条消息都会产生变更。 +- 你可以在一个自动化中选择多个频道。每个频道必须是公开频道，或是已添加 Mintlify 应用的私有频道。 +
## 权限与访问
diff --git a/zh/automations/manage.mdx b/zh/automations/manage.mdx index 94297e7d5..b5d5e849b 100644 --- a/zh/automations/manage.mdx +++ b/zh/automations/manage.mdx @@ -52,7 +52,7 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; - **内容更新（Content update）**：每当你向项目仓库推送内容时运行，包括 pull request 合并和直接推送。 - **代码变更（Code change）**：当已连接的源代码仓库中有 pull request 合并时运行。你必须至少指定一个源仓库。 - **自定义计划（Custom schedule）**：按你定义的周期性计划运行。自动化会在预定时间的 10 分钟内进入队列。 -- **集成（Integration）**：当已连接的共享集成中发生所选事件时运行。此选项适用于自定义自动化。请选择集成和事件，并填写出现的任何其他事件字段。 +- **集成（Integration）**：当已连接的共享集成中发生所选事件时运行，或当在所选 Slack 频道中发布新的顶层消息时运行。此选项适用于自定义自动化。请选择集成和事件，并填写出现的任何其他事件字段。对于 Slack 触发器，请选择一个或多个已添加 [Mintlify Slack 应用](/zh/agent/slack)的频道。
### 更新模式