mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
1791e1377b
Generated-By: mintlify-agent Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
79 lines
4.8 KiB
Plaintext
79 lines
4.8 KiB
Plaintext
---
|
|
title: "Añade el agente a Slack"
|
|
description: "Añade el agente de Mintlify a Slack para crear actualizaciones de documentación a partir de conversaciones, capturar el conocimiento del equipo y mantener los documentos sincronizados."
|
|
keywords: ["Integración con Slack", "Bot de Slack", "Colaboración en equipo", "Integración del agente", "Captura de conocimiento"]
|
|
---
|
|
|
|
<Note>
|
|
Si el propietario de tu espacio de trabajo de Slack requiere aprobación de administrador para instalar aplicaciones, pídele que apruebe la aplicación de Mintlify antes de conectarla.
|
|
</Note>
|
|
|
|
<div id="connect-your-slack-workspace">
|
|
## Conecta tu espacio de trabajo de Slack
|
|
</div>
|
|
|
|
1. Ve a la página de [Agent](https://dashboard.mintlify.com/products/agent) en tu dashboard.
|
|
2. En la sección "Agent settings", haz clic en **Install Slack app**.
|
|
<Frame>
|
|
<img src="/images/agent/install-apps-light.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion." className="block dark:hidden" />
|
|
<img src="/images/agent/install-apps-dark.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion." className="hidden dark:block" />
|
|
</Frame>
|
|
3. Sigue las indicaciones de Slack para instalar la app `mintlify` en tu espacio de trabajo.
|
|
4. Sigue las indicaciones de Slack para vincular tu cuenta de Mintlify con tu espacio de trabajo de Slack.
|
|
5. Verifica que el agente esté funcionando y responda cuando:
|
|
- Le envíes un mensaje directo al agente.
|
|
- Menciones al agente con `@mintlify` en un canal.
|
|
|
|
<Tip>
|
|
Si tu organización tiene múltiples despliegues, el agente te pide que elijas con cuál despliegue trabajar la primera vez que envías una solicitud.
|
|
|
|
Tu despliegue preferido es personal de tu cuenta de Slack y no afecta
|
|
a otros miembros del equipo. Puedes cambiar a un despliegue diferente en cualquier
|
|
momento durante una conversación haciendo clic en el botón **Switch deployment** en
|
|
el mensaje de estado del agente en el hilo. El agente conserva tu historial de
|
|
conversación para que puedas continuar donde lo dejaste con el nuevo despliegue.
|
|
</Tip>
|
|
|
|
<div id="use-the-agent-in-slack">
|
|
## Usar el agente en Slack
|
|
</div>
|
|
|
|
Una vez conectado, puedes:
|
|
|
|
- Enviar mensajes directos al agente para usarlo en privado y actualizar tu documentación.
|
|
- Mencionar `@mintlify` en un canal para usarlo de forma pública y colaborativa.
|
|
- Adjuntar archivos e imágenes directamente a tus mensajes para que el agente los procese y los incluya en tu documentación.
|
|
- Continuar las conversaciones en hilos para iterar sobre los cambios.
|
|
- Compartir enlaces a solicitudes de extracción con el agente para actualizar la documentación relacionada.
|
|
|
|
<div id="update-documentation">
|
|
## Actualizar la documentación
|
|
</div>
|
|
|
|
Utiliza el agente para actualizar tu documentación mediante una nueva solicitud o en un hilo existente.
|
|
|
|
- **Nueva solicitud**: Envía un mensaje directo al agente o menciona `@mintlify` en un canal con instrucciones sobre qué actualizar.
|
|
- **Hilo existente**: Responde en el hilo y menciona `@mintlify` con instrucciones sobre qué actualizar.
|
|
- **Con archivos adjuntos**: Sube imágenes, diagramas, archivos de código u otros documentos junto con tu mensaje. El agente los procesa automáticamente y los incluye en tu documentación.
|
|
|
|
El agente lee el contexto de la solicitud o del hilo y crea una solicitud de extracción en tu repositorio conectado con las actualizaciones.
|
|
|
|
<div id="track-progress-in-real-time">
|
|
## Sigue el progreso en tiempo real
|
|
</div>
|
|
|
|
Mientras el agente trabaja en tu solicitud, proporciona retroalimentación en vivo en el hilo de Slack.
|
|
|
|
- **Actualizaciones de estado**: Un mensaje que se actualiza en vivo muestra lo que el agente está haciendo, como cuántos archivos ha buscado, leído y editado.
|
|
- **Progreso de las tareas**: Cuando el agente divide tu solicitud en varias tareas, muestra una lista de verificación para que puedas seguir el progreso de cada una.
|
|
- **Preguntas**: Si el agente necesita más información, presenta opciones para que selecciones o respondas en el hilo con una respuesta personalizada.
|
|
- **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.
|
|
|
|
<div id="best-practices">
|
|
## Mejores prácticas
|
|
</div>
|
|
|
|
- **Sé específico**: Indícale al agente exactamente qué quieres documentar y dónde debe ir.
|
|
- **Añade contexto**: Si un hilo no contiene toda la información necesaria, incluye detalles adicionales en tu mensaje al agente.
|
|
- **Revisa cuidadosamente**: Siempre debes revisar las solicitudes de extracción que genere el agente antes de fusionarlas. |