Añade el agente a Slack

Usa el agente en Slack para actualizar tu contenido, hacer preguntas y capturar el conocimiento del equipo. Menciona al agente en un canal para usarlo de forma colaborativa, o envíale un mensaje directo para usarlo en privado. Las conversaciones con el agente en Slack son gratuitas y no cuentan para el saldo de créditos de tu organización.

1. Ve a la página de Agent en tu dashboard.
2. En la sección “Agent settings”, haz clic en Install Slack app.
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.

Para eliminar el agente de tu workspace de Slack:

1. Abre la página Automatizaciones en tu dashboard.
2. Haz clic en Disconnect Slack para revocar la conexión entre Mintlify y tu workspace.
3. En Slack, abre Settings & administration > Manage apps, busca la aplicación mintlify y haz clic en Remove.

Después de desconectarlo, el agente deja de responder a menciones y mensajes directos, y las automatizaciones que publican en Slack dejan de entregar notificaciones. Puedes volver a conectarlo en cualquier momento siguiendo los pasos de Conecta tu workspace de Slack. Si necesitas volver a autorizar el agente —por ejemplo, para otorgarle nuevos permisos tras una actualización de scopes de Slack o para recuperarte de un token revocado— reinstala la app desde tu panel de Mintlify. Cuando reinstalas el agente en un espacio de trabajo que ya está conectado a tu organización, Mintlify actualiza en su lugar el bot token almacenado. Tus canales e hilos existentes se conservan intactos. 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 o hacer preguntas de seguimiento. El agente reutiliza los archivos, las imágenes y las reacciones con emoji compartidos previamente en el hilo como contexto para las solicitudes posteriores, por lo que no es necesario que los vuelvas a cargar.
• Compartir enlaces a solicitudes de extracción con el agente para actualizar la documentación relacionada.

Hazle preguntas al agente sobre tu producto o documentación y recibe respuestas en el hilo.

• Nueva pregunta: Envía un mensaje directo al agente o menciona @mintlify en un canal con tu pregunta.
• Hilo existente: Responde en el hilo y menciona @mintlify con una pregunta de seguimiento.

Ejemplos de preguntas:

• «¿Qué páginas mencionan el límite de tasa de la API?»
• «¿Cómo configuro la autenticación?»
• «¿Cómo está estructurada nuestra navegación?»

El agente de Slack puede usar aplicaciones de terceros conectadas como herramientas de solo lectura mientras responde preguntas o actualiza tu documentación.

• Las integraciones compartidas están disponibles para toda la organización.
• Las integraciones personales usan la cuenta conectada por el miembro que está hablando con el agente.

No tienes que seleccionar integraciones para cada conversación. Incluye la aplicación en tu solicitud de forma natural, por ejemplo: «Compara esta incidencia de Linear con el plan de lanzamiento de mi Google Drive». Si una aplicación no está conectada, pide al agente que la conecte. Completa el enlace de autorización que devuelve y envía otro mensaje en el mismo hilo para que confirme la conexión. Consulta Integraciones para conocer las aplicaciones compatibles, los alcances de conexión y los permisos. 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, PDFs, SVGs, archivos de código u otros documentos junto con tu mensaje. El agente los procesa automáticamente y los incluye en tu documentación. En un hilo, el agente tiene acceso a las imágenes y archivos compartidos en mensajes anteriores, por lo que puedes hacer referencia a ellos en las solicitudes posteriores sin necesidad de volver a subirlos.

El agente lee el contexto de la solicitud o del hilo y actualiza tu repositorio conectado. Según tu ajuste de proceso de revisión, el agente abre una solicitud de extracción o realiza confirmaciones directamente en tu branch de despliegue. Pídele al agente que apunte a un branch específico si quieres que los cambios lleguen a otro lugar distinto de tu branch de despliegue. Por ejemplo, «abre la PR contra el branch staging» o «envía estos commits a docs-refresh». El agente crea la solicitud de extracción contra el branch que indiques, o envía commits directamente a él cuando ese branch ya existe. Cuando una automatización publica una notificación de Slack sobre una solicitud de extracción que ha abierto, responde en ese hilo y menciona a @mintlify para continuar el trabajo. El agente recoge todo el contexto de la ejecución, hace checkout del mismo branch y publica los cambios que solicites como commits de seguimiento en la misma solicitud de extracción, en lugar de abrir una nueva. También puedes compartir un enlace a cualquier solicitud de extracción de Mintlify directamente con el agente para continuarla desde un nuevo hilo. Cuando una automatización de cambios de código abre una solicitud de extracción de documentación, publica un comentario en la solicitud de extracción de código que la desencadenó, enlazando a la solicitud de extracción de documentación que creó, y asigna un revisor probando en orden al autor y los committers de la solicitud de extracción de código hasta que uno acepte. El agente de Slack y las Automatizaciones usan ambos el agente de Mintlify. Pídele al agente que cree, configure, ejecute o solucione problemas de cualquier automatización. Puede realizar todas las acciones disponibles para ti en la página Automatizaciones de tu dashboard. Ejemplos de prompts:

• «Crea una automatización que redacte una entrada del changelog cada vez que fusionemos en main.»
• «Configura una automatización que actualice la documentación cada vez que se cierre una incidencia de Jira.»
• «Desactiva la automatización semanal del changelog.»
• «Ejecuta la automatización de cambios de código sobre la PR #123.»
• «Revisa las fusiones del último mes y actualiza el changelog.»

También puedes preguntarle al agente sobre la actividad de las automatizaciones, como ejecuciones recientes, fallos o consumo de créditos.

• «¿Cómo puedo hacer que mis automatizaciones sean más eficientes en el uso de créditos?»
• «¿Por qué falló la última ejecución de la automatización de cambios de código?»

​

Activar automatizaciones desde mensajes de Slack

Puedes configurar una automatización personalizada para que se ejecute cuando alguien publique un mensaje de nivel superior en un canal de Slack elegido. El agente lee cada mensaje, decide si justifica una actualización de la documentación y abre una solicitud de extracción cuando corresponde. Configúralo cuando crees o edites la automatización en la página Automatizaciones. La app mintlify debe ser miembro del canal que elijas. Invítala con /invite @mintlify antes de guardar la automatización. El agente puede leer el código fuente de cualquier repositorio conectado mediante la GitHub app o la integración con GitLab, incluso si no es tu repositorio de documentación. Esto le permite construir un contexto más profundo para guiar las actualizaciones de la documentación. Cuando mencionas otro repositorio en tu solicitud, el agente lo clona bajo demanda e inspecciona los archivos relevantes antes de redactar los cambios. Ejemplos de prompts:

• “Actualiza la guía de autenticación según los cambios en acme/api-server/src/auth.ts.”
• “Documenta los nuevos endpoints añadidos en acme/backend#1234.”
• “¿A qué repositorios tienes acceso?”

Los repositorios clonados son de solo lectura. El agente los utiliza como contexto, pero solo escribe cambios en tu repositorio de documentación. 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 o al commit y un enlace para abrir los cambios en el editor web.

Las capacidades del agente en Slack coinciden con el rol de la cuenta de Mintlify vinculada:

• Administradores y editores: Pueden hacer preguntas y aplicar cambios en la documentación. El agente tiene acceso a las herramientas de edición de archivos y de pull requests.
• Lectores: Solo pueden hacer preguntas. El agente siempre se ejecuta en modo de solo lectura para las herramientas de Mintlify, independientemente de la solicitud.

Para cambiar los permisos de un compañero, actualiza su rol desde la página Members de tu dashboard.

​

Usar el agente en el panel lateral de Slack

Chatea con @mintlify en el panel lateral de Slack para hacer preguntas o solicitar actualizaciones de la documentación sin publicar en un canal. El agente del panel lateral se comporta como el agente de Slack: mismos permisos, mismas herramientas y el mismo proceso de revisión para los cambios que realiza.

• 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.