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.
Conecta tu espacio de trabajo de Slack
- Ve a la página de Agent en tu dashboard.
- En la sección “Agent settings”, haz clic en Install Slack app.
- Sigue las indicaciones de Slack para instalar la app
mintlifyen tu espacio de trabajo. - Sigue las indicaciones de Slack para vincular tu cuenta de Mintlify con tu espacio de trabajo de Slack.
- Verifica que el agente esté funcionando y responda cuando:
- Le envíes un mensaje directo al agente.
- Menciones al agente con
@mintlifyen un canal.
Usar el agente en Slack
- Enviar mensajes directos al agente para usarlo en privado y actualizar tu documentación.
- Mencionar
@mintlifyen 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.
Actualizar la documentación
- Nueva solicitud: Envía un mensaje directo al agente o menciona
@mintlifyen un canal con instrucciones sobre qué actualizar. - Hilo existente: Responde en el hilo y menciona
@mintlifycon 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.
Mejores prácticas
- 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.