Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion agent/slack.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,19 +34,23 @@

## Connect additional integrations from Slack

Once your Slack workspace is connected, you can ask the agent in Slack to set up any third-party integration that it should use as context. The agent uses [Composio](https://docs.composio.dev/toolkits) to support a broad catalog of third-party services, including issue trackers, knowledge bases, CRMs, and developer tools.

Check warning on line 37 in agent/slack.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

agent/slack.mdx#L37

In general, use active voice instead of passive voice ('is connected').

Check warning on line 37 in agent/slack.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

agent/slack.mdx#L37

Did you really mean 'CRMs'?

<Note>
GitHub and GitLab are not configured through Composio. Repository access is handled by the [Mintlify GitHub App](/deploy/github) or [GitLab integration](/deploy/gitlab) installed from your dashboard. Once installed, the agent can read source code from any repository the app has access to.

Check warning on line 40 in agent/slack.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

agent/slack.mdx#L40

In general, use active voice instead of passive voice ('is handled').
</Note>

To add a new integration from Slack:

1. In a direct message or a thread that mentions `@mintlify`, ask the agent to set up the integration. For example:
- "Set up the GitHub integration."
- "Connect Jira so you can read tickets."
- "Install the HubSpot integration."
- "Set up the Linear integration."
2. The agent replies with an authorization link.
3. Click the link, sign in to the third-party service, and approve the requested permissions.
4. Return to Slack. The agent confirms the connection and can immediately use the integration as context for future requests.

Integrations that you connect from Slack are scoped to individual Slack users, so each teammate sets up their own connections and the agent uses the connections of whoever sent the message. If a Slack user has not connected a service, the agent falls back to the organization-level integrations installed from the [Agent](https://dashboard.mintlify.com/products/agent) page in the dashboard.

Check warning on line 53 in agent/slack.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

agent/slack.mdx#L53

In general, use active voice instead of passive voice ('are scoped').

To remove or reauthorize an organization-level integration, use the **Agent settings** section of the [Agent](https://dashboard.mintlify.com/products/agent) page.

Expand All @@ -71,7 +75,7 @@

Example questions:
- "Which pages mention the API rate limit?"
- "How do I set up authentication?"

Check warning on line 78 in agent/slack.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

agent/slack.mdx#L78

Avoid first-person pronouns such as ' I '.
- "How is our navigation structured?"

## Update documentation
Expand All @@ -96,7 +100,7 @@
- "Document the new endpoints added in `acme/backend#1234`."
- "What repositories do you have access to?"

Cloned repositories are read-only. The agent uses them for context, but always opens pull requests against your documentation repository.

Check warning on line 103 in agent/slack.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

agent/slack.mdx#L103

In general, use active voice instead of passive voice ('are read').

## Track progress in real time

Expand Down
6 changes: 5 additions & 1 deletion es/agent/slack.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -40,12 +40,16 @@ conversación para que puedas continuar donde lo dejaste con el nuevo despliegue

Una vez conectado tu espacio de trabajo de Slack, puedes pedirle al agente en Slack que configure cualquier integración de terceros que deba usar como contexto. El agente utiliza [Composio](https://docs.composio.dev/toolkits) para admitir un amplio catálogo de servicios de terceros, incluidos sistemas de seguimiento de incidencias, bases de conocimiento, CRMs y herramientas para desarrolladores.

<Note>
GitHub y GitLab no se configuran a través de Composio. El acceso a los repositorios se gestiona mediante la [GitHub App de Mintlify](/es/deploy/github) o la [integración con GitLab](/es/deploy/gitlab) instalada desde tu panel. Una vez instalada, el agente puede leer el código fuente de cualquier repositorio al que la aplicación tenga acceso.
</Note>

Para añadir una nueva integración desde Slack:

1. En un mensaje directo o en un hilo que mencione `@mintlify`, pídele al agente que configure la integración. Por ejemplo:
- "Configura la integración con GitHub."
- "Conecta Jira para que puedas leer los tickets."
- "Instala la integración con HubSpot."
- "Configura la integración con Linear."
2. El agente responde con un enlace de autorización.
3. Haz clic en el enlace, inicia sesión en el servicio de terceros y aprueba los permisos solicitados.
4. Vuelve a Slack. El agente confirma la conexión y puede usar inmediatamente la integración como contexto para futuras solicitudes.
Expand Down
6 changes: 5 additions & 1 deletion fr/agent/slack.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,12 +41,16 @@ déploiement.

Une fois votre espace de travail Slack connecté, vous pouvez demander à l'agent dans Slack de configurer n'importe quelle intégration tierce qu'il doit utiliser comme contexte. L'agent s'appuie sur [Composio](https://docs.composio.dev/toolkits) pour prendre en charge un large catalogue de services tiers, notamment des outils de suivi des tickets, des bases de connaissances, des CRM et des outils pour développeurs.

<Note>
GitHub et GitLab ne sont pas configurés via Composio. L'accès aux référentiels est géré par la [GitHub App Mintlify](/fr/deploy/github) ou l'[intégration GitLab](/fr/deploy/gitlab) installée depuis votre tableau de bord. Une fois installée, l'agent peut lire le code source de tout référentiel auquel l'application a accès.
</Note>

Pour ajouter une nouvelle intégration depuis Slack :

1. Dans un message direct ou dans un fil qui mentionne `@mintlify`, demandez à l'agent de configurer l'intégration. Par exemple :
- « Configure l'intégration GitHub. »
- « Connecte Jira pour que tu puisses lire les tickets. »
- « Installe l'intégration HubSpot. »
- « Configure l'intégration Linear. »
2. L'agent répond avec un lien d'autorisation.
3. Cliquez sur le lien, connectez-vous au service tiers et approuvez les autorisations demandées.
4. Retournez dans Slack. L'agent confirme la connexion et peut immédiatement utiliser l'intégration comme contexte pour les futures demandes.
Expand Down
6 changes: 5 additions & 1 deletion zh/agent/slack.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,12 +37,16 @@ keywords: ["Slack 集成", "Slack 机器人", "团队协作", "agent 集成", "

连接好你的 Slack 工作区后,你可以在 Slack 中让 agent 设置它应当用作上下文的任意第三方集成。Agent 使用 [Composio](https://docs.composio.dev/toolkits) 来支持广泛的第三方服务,包括问题跟踪器、知识库、CRM 和开发者工具。

<Note>
GitHub 和 GitLab 不通过 Composio 配置。仓库访问由从控制台安装的 [Mintlify GitHub App](/zh/deploy/github) 或 [GitLab 集成](/zh/deploy/gitlab)管理。安装后,agent 可以读取该应用有权访问的任何仓库的源代码。
</Note>

要从 Slack 添加新的集成:

1. 在私信中,或在提及 `@mintlify` 的线程中,让 agent 设置该集成。例如:
- "设置 GitHub 集成。"
- "连接 Jira,以便你可以读取工单。"
- "安装 HubSpot 集成。"
- "设置 Linear 集成。"
2. Agent 会回复一个授权链接。
3. 点击该链接,登录第三方服务,并批准所请求的权限。
4. 返回 Slack。Agent 会确认连接成功,并立即可以将该集成用作后续请求的上下文。
Expand Down
Loading