Skip to content
Merged
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
10 changes: 2 additions & 8 deletions ai/assistant.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,15 +21,15 @@ The assistant uses agentic RAG (retrieval-augmented generation) with tool callin
* **Generates copyable code examples** to help users implement solutions from your documentation.
* **Supports multiple modalities** by allowing users to add text, images, and other files as context.

You can view assistant usage through your dashboard to understand user behavior and documentation effectiveness. Export and analyze query data to help identify:
View assistant usage through your dashboard to understand user behavior and documentation effectiveness. Export and analyze query data to help identify:

* Frequently asked questions that might need better coverage.
* Content gaps where users struggle to find answers.
* Popular topics that could benefit from additional content.

### How indexing works

The assistant automatically indexes your published documentation and API specifications to answer questions accurately. When you publish changes, the assistant immediately indexes new, updated, or deleted content. The assistant does not index draft branches or preview deployments.
The assistant indexes your published documentation and API specifications to answer questions accurately. When you publish changes, the assistant immediately indexes new, updated, or deleted content. The assistant does not index draft branches or preview deployments.

By default, the assistant does not index hidden pages. To include hidden pages in the assistant's index, set `seo.indexing: "all"` in your `docs.json`. See [Hidden pages](/organize/hidden-pages#search-seo-and-ai-indexing) for more information.

Expand Down Expand Up @@ -171,10 +171,6 @@ If you want to disallow overages, disable them in the **Billing Controls** secti

In the Billing Controls section, set usage alerts to receive an email when you reach a certain percentage of your message allowance.

## Connect apps

In the connect apps section, add the assistant to your [Discord](/ai/discord) server and [Slack](/ai/slack-bot) workspace to allow users to get answers from your documentation on those platforms.

## Assistant insights

Use assistant insights to understand how users interact with your documentation and identify improvement opportunities.
Expand Down Expand Up @@ -206,8 +202,6 @@ Structure your documentation to help the assistant provide accurate, relevant an

Users have multiple ways to start a conversation with the assistant. Each method opens a chat panel on the right side of your docs. Users can ask any question and the assistant searches your documentation for an answer. If the assistant cannot retrieve relevant information, the assistant responds that it cannot answer the question.

Add the assistant as a bot to your [Slack workspace](/ai/slack-bot) or [Discord server](/ai/discord) so that your community can ask questions without leaving their preferred platform.

### UI placement

The assistant appears in two locations: as a button next to the search bar and as a bar at the bottom of the page.
Expand Down
37 changes: 5 additions & 32 deletions ai/discord.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,47 +4,20 @@
keywords: ["Discord", "bot", "Q&A", "customer support"]
---

<Info>
Discord integrations are available on [Pro and Enterprise plans](https://mintlify.com/pricing?ref=discord) with access to the assistant.
</Info>
<Warning>
The Discord bot is deprecated.

Check warning on line 8 in ai/discord.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/discord.mdx#L8

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

New Discord bot installations are not available. Existing Discord bot integrations continue to work.
</Warning>

The Discord bot supports your community with real-time answers from your documentation. The bot uses the Mintlify assistant to search your docs and provide accurate, cited responses, so it is always up-to-date.

The Discord bot only works in public channels. It replies to `@` mentions or to all messages in a specific channel.

Each message sent by the Discord bot counts toward your assistant message usage.

## Add the Discord bot to your server

<Note>
You must have the "Manage Server" permission in Discord to add the bot.
</Note>

1. Navigate to the [Assistant](https://dashboard.mintlify.com/products/assistant) page in your dashboard.
1. In the Discord card, click **Configure**. This opens Discord.
<Frame>
<img src="/images/assistant/connected-apps-light.png" alt="The connected apps section of the assistant page." className="block dark:hidden" />
<img src="/images/assistant/connected-apps-dark.png" alt="The connected apps section of the assistant page." className="hidden dark:block" />
</Frame>
1. In Discord, select the server you want to add the bot to.
1. Authorize the bot to access your server.
1. Mention the bot to add it to a channel. The bot's default name is `@Mintlify Bot`.

## Create an `#ask-ai` channel

To help your community quickly get answers to their questions, the bot can reply to every message in a channel that you choose. By default, the bot replies to every message in channels named `#ask-ai`. Create an `#ask-ai` channel and let your community know that the bot replies to messages in that channel.

If you want the bot to reply to messages in a different channel, select a channel in the Discord bot [configuration menu](https://dashboard.mintlify.com/products/assistant/settings/integrations).

<Frame>
<img src="/images/assistant/discord-configure-light.png" alt="The Discord configuration panel in light mode." className="block dark:hidden" />
<img src="/images/assistant/discord-configure-dark.png" alt="The Discord configuration panel in dark mode." className="hidden dark:block" />
</Frame>

See [Starting Your First Discord Server](https://discord.com/blog/starting-your-first-discord-server) on the Discord blog for more information on creating a channel.

## Manage the Discord bot

After you add the Discord bot to your server, you can manage or remove the bot from the [Integrations](https://dashboard.mintlify.com/products/assistant/settings/integrations) tab in your dashboard.

In the Discord bot configuration menu, customize the bot by changing its avatar or name, and choose which channel it automatically replies to all messages in.
38 changes: 5 additions & 33 deletions ai/slack-bot.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,11 @@
keywords: ["bot", "workspace", "Q&A", "Slack", "app"]
---

<Info>
The Slack app is available for [Pro and Custom plans](https://mintlify.com/pricing?ref=slack-app) with access to the assistant.
</Info>
<Warning>
The Slack bot is deprecated.

Check warning on line 8 in ai/slack-bot.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/slack-bot.mdx#L8

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

New Slack bot installations are not available. Existing Slack bot integrations continue to work.
</Warning>

The Slack app adds a bot to your workspace that supports your community with real-time answers. The bot uses the Mintlify assistant to search your docs and provide accurate, cited responses, so it is always up-to-date.

Expand All @@ -16,36 +18,6 @@

Each message sent by the bot counts toward your assistant message usage.

## Set up the Slack app

<Note>
You can only install the Slack app once per workspace. If you have multiple Mintlify deployments, you can only connect one deployment at a time to a workspace. You must disconnect the app from one deployment before connecting it to another.
</Note>

If your Slack Workspace Owner requires admin approval to install apps, ask them to approve the Mintlify Slack app before you add it.

1. Navigate to the [Assistant](https://dashboard.mintlify.com/products/assistant) page in your dashboard.
1. In the Slack card, click **Configure**. This opens Slack.
<Frame>
<img src="/images/assistant/connected-apps-light.png" alt="The connected apps section of the assistant page." className="block dark:hidden" />
<img src="/images/assistant/connected-apps-dark.png" alt="The connected apps section of the assistant page." className="hidden dark:block" />
</Frame>
1. Follow the Slack prompts to add the app to your workspace.
1. Mention the bot to add it to a channel. The bot's default name is `@mintlify-assistant`.

## Create an `#ask-ai` channel

To help your users quickly get answers to their questions, the bot can reply to every message in a channel that you choose. By default, the bot replies to every message in channels named `#ask-ai`. Create an `#ask-ai` channel and let your users know that the bot replies to messages in that channel. See [Create a channel](https://slack.com/help/articles/201402297-Create-a-channel) in the Slack Help Center for more information.

If you want the bot to reply to messages in a different channel, select a channel in the Slack bot [configuration menu](https://dashboard.mintlify.com/products/assistant/settings/integrations).

<Frame>
<img src="/images/assistant/slack-configure-light.png" alt="The Slack configuration panel in light mode." className="block dark:hidden" />
<img src="/images/assistant/slack-configure-dark.png" alt="The Slack configuration panel in dark mode." className="hidden dark:block" />
</Frame>

## Manage the Slack app

After you add the app to your workspace, you can manage or remove the app from the [Integrations](https://dashboard.mintlify.com/products/assistant/settings/integrations) tab.

In the Slack bot configuration menu, customize the bot by changing its avatar or name, and choose which channel it automatically replies to all messages in.
2 changes: 1 addition & 1 deletion dashboard/audit-logs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Filter audit logs to find specific activities.
| API key | API key and discovery API key creation and deletion. |
| Assistant | Assistant setting updates like deflection email, web search sites, and starter questions. |
| PDF export | PDF export generation and deletion. |
| Integration | GitHub, Slack, Discord, Linear, and Notion installations and removals. |
| Integration | GitHub, Slack, Linear, and Notion installations and removals. |
| Billing | Subscription updates, add-on purchases, and invoice views. |
| Quota | Overage policy and alert configuration changes. |
| User | Individual user notification settings. |
Expand Down
8 changes: 0 additions & 8 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -198,8 +198,6 @@
"icon": "wrench",
"pages": [
"ai/assistant",
"ai/discord",
"ai/slack-bot",
"ai/contextual-menu",
"optimize/analytics",
"optimize/feedback",
Expand Down Expand Up @@ -577,8 +575,6 @@
"icon": "wrench",
"pages": [
"fr/ai/assistant",
"fr/ai/discord",
"fr/ai/slack-bot",
"fr/ai/contextual-menu",
"fr/optimize/analytics",
"fr/optimize/feedback",
Expand Down Expand Up @@ -951,8 +947,6 @@
"icon": "wrench",
"pages": [
"es/ai/assistant",
"es/ai/discord",
"es/ai/slack-bot",
"es/ai/contextual-menu",
"es/optimize/analytics",
"es/optimize/feedback",
Expand Down Expand Up @@ -1325,8 +1319,6 @@
"icon": "wrench",
"pages": [
"zh/ai/assistant",
"zh/ai/discord",
"zh/ai/slack-bot",
"zh/ai/contextual-menu",
"zh/optimize/analytics",
"zh/optimize/feedback",
Expand Down
8 changes: 0 additions & 8 deletions es/ai/assistant.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -203,12 +203,6 @@ Si no quieres permitir excedentes, desactívalos en la sección **Billing Contro

En la sección Billing Controls, configura alertas de uso para recibir un correo electrónico cuando alcances cierto porcentaje de tu cupo de mensajes.

<div id="connect-apps">
## Conectar aplicaciones
</div>

En la sección Conectar aplicaciones, agrega el assistant a tu servidor de [Discord](/es/ai/discord) y al espacio de trabajo de [Slack](/es/ai/slack-bot) para que los usuarios puedan obtener respuestas de tu documentación en esas plataformas.

<div id="assistant-insights">
## Información del assistant
</div>
Expand Down Expand Up @@ -246,8 +240,6 @@ Estructura tu documentación para ayudar al assistant a ofrecer respuestas preci

Los usuarios tienen varias formas de iniciar una conversación con el assistant. Cada método abre un panel de chat en el lado derecho de tu documentación. Los usuarios pueden hacer cualquier pregunta y el assistant busca una respuesta en tu documentación. Si el assistant no puede recuperar información relevante, el assistant indica que no puede responder a la pregunta.

Añade el assistant como bot a tu [espacio de trabajo de Slack](/es/ai/slack-bot) o [servidor de Discord](/es/ai/discord) para que tu comunidad pueda hacer preguntas sin salir de su plataforma preferida.

<div id="ui-placement">
### Ubicación en la interfaz de usuario
</div>
Expand Down
41 changes: 4 additions & 37 deletions es/ai/discord.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,53 +4,20 @@ description: "Configura un bot de Discord que responda preguntas de la comunidad
keywords: ["Discord", "bot", "Q&A", "customer support"]
---

<Info>
Las integraciones de Discord están disponibles en los [planes Pro y Enterprise](https://mintlify.com/pricing?ref=discord), que incluyen acceso al assistant.
</Info>
<Warning>
Las nuevas instalaciones del bot de Discord ya no están disponibles a través del dashboard. Las integraciones existentes del bot de Discord continúan funcionando.
</Warning>

El bot de Discord ayuda a tu comunidad con respuestas en tiempo real basadas en tu documentación. El bot utiliza el assistant de Mintlify para buscar en tu documentación y proporcionar respuestas precisas con citas, de modo que siempre esté actualizada.

El bot solo funciona en canales públicos. Responde a menciones con `@` o a todos los mensajes en un canal específico.

Cada mensaje enviado por el bot de Discord se contabiliza dentro del uso de mensajes de tu assistant.

<div id="add-the-discord-bot-to-your-server">
## Agregar el bot de Discord a tu servidor
</div>

<Note>
Debes tener el permiso «Manage Server» en Discord para agregar el bot.
</Note>

1. Ve a la página [Assistant](https://dashboard.mintlify.com/products/assistant) en tu dashboard.
1. En la tarjeta de Discord, haz clic en **Configure**. Se abrirá Discord.
<Frame>
<img src="/images/assistant/connected-apps-light.png" alt="La sección Connected apps de la página del assistant." className="block dark:hidden" />
<img src="/images/assistant/connected-apps-dark.png" alt="La sección Connected apps de la página del assistant." className="hidden dark:block" />
</Frame>
1. En Discord, selecciona el servidor al que quieres agregar el bot.
1. Autoriza al bot para acceder a tu servidor.
1. Menciona al bot para agregarlo a un canal. El nombre predeterminado del bot es `@Mintlify Bot`.

<div id="create-an-ask-ai-channel">
## Crear un canal `#ask-ai`
</div>

Para ayudar a tu comunidad a obtener rápidamente respuestas a sus preguntas, el bot puede responder a cada mensaje en el canal que elijas. Por defecto, el bot responde a todos los mensajes en canales llamados `#ask-ai`. Crea un canal `#ask-ai` y avisa a tu comunidad de que el bot responde a los mensajes en ese canal.

Si quieres que el bot responda a mensajes en un canal diferente, selecciona un canal en el [menú de configuración](https://dashboard.mintlify.com/products/assistant/settings/integrations) del bot de Discord.

<Frame>
<img src="/images/assistant/discord-configure-light.png" alt="El panel de configuración de Discord en modo claro." className="block dark:hidden" />
<img src="/images/assistant/discord-configure-dark.png" alt="El panel de configuración de Discord en modo oscuro." className="hidden dark:block" />
</Frame>
Para ayudar a tu comunidad a obtener rápidamente respuestas a sus preguntas, el bot puede responder a cada mensaje en el canal que elijas. Por defecto, el bot responde a todos los mensajes en canales llamados `#ask-ai`. Crea un canal `#ask-ai` e indica a tu comunidad que el bot responde a los mensajes en ese canal.

Consulta [Starting Your First Discord Server](https://discord.com/blog/starting-your-first-discord-server) en el blog de Discord para obtener más información sobre cómo crear un canal.

<div id="manage-the-discord-bot">
## Administrar el bot de Discord
</div>

Después de agregar el bot de Discord a tu servidor, puedes administrar o eliminar el bot desde la pestaña [Integrations](https://dashboard.mintlify.com/products/assistant/settings/integrations) en tu dashboard.

En el menú de configuración del bot de Discord, puedes personalizarlo cambiando su avatar o nombre y elegir en qué canal responderá automáticamente a todos los mensajes.
Loading
Loading