Integración con GitHub
Responde preguntas en Issues y Discussions a partir de tu documentación
Descripción general
La app de GitHub de Asyntai responde las preguntas que la gente hace en tus repositorios. Cuando alguien abre una Discussion en una categoría Q&A, o un Issue con tu etiqueta de pregunta, Asyntai lee tu documentación y publica la respuesta como comentario. Tus mantenedores conservan su tiempo para los informes de errores y el código.
Está pensada para proyectos que tienen su documentación en Asyntai: un sitio de documentación, un README, un centro de ayuda o archivos subidos. Las respuestas salen de ese contenido, la misma base de conocimiento que usa el chat de tu web.
Cómo funciona
La app responde en tres lugares:
- Discussions: cada nueva discusión en una categoría que acepta respuestas, como Q&A.
- Issues: cada nuevo issue que lleve la etiqueta que elijas. La etiqueta por defecto es
question. Los informes de errores y las peticiones de funciones se quedan con tu equipo. - Seguimiento: cualquiera puede mencionar
@asyntai-ai-agenten un comentario para preguntar más. La app recuerda el hilo, así que las preguntas de seguimiento se entienden en contexto.
Cada respuesta se basa en tu documentación. Una pregunta fuera de la documentación queda abierta para un mantenedor, así que puedes confiar en cada comentario que escribe la app.
Requisitos
- Una cuenta de Asyntai con tu documentación en la base de conocimiento. El plan gratuito basta para empezar.
- Un repositorio de GitHub, en una cuenta personal o en una organización, donde puedas instalar apps.
- Para Discussions, una categoría que acepte respuestas. GitHub la llama categoría Q&A.
Instalación
Sigue estos pasos para añadir Asyntai a tus repositorios:
Instala la app en GitHub
Abre la app de Asyntai en el GitHub Marketplace y pulsa Install. Elige la cuenta y los repositorios donde puede responder. Puedes cambiar los repositorios más tarde en tu configuración de GitHub.
https://github.com/apps/asyntai-ai-agent
Conecte su cuenta de Asyntai
GitHub te envía a Asyntai cuando termina la instalación. Inicia sesión, o crea una cuenta gratuita, y elige el sitio web cuya base de conocimiento usará la app para responder. Solo hay que hacerlo una vez.
Elige dónde responde
En la página GitHub de tu panel de Asyntai, activa o desactiva Discussions e Issues, y define la etiqueta que marca un issue como pregunta. La configuración se aplica a todos los repositorios de la instalación.
Haz una pregunta
Abre una discusión en tu categoría Q&A, o un issue con la etiqueta de pregunta. La respuesta aparece como comentario en menos de un minuto. Menciona la app en una respuesta para hacer una pregunta de seguimiento.
Consejo: Añade tu sitio de documentación, README y changelog a la base de conocimiento en tu panel de Asyntai. Cuanta más documentación tenga la app, más preguntas responde.
Qué puede hacer la app
- Responder preguntas de instalación, configuración y uso a partir de tu documentación, día y noche
- Escribir en GitHub Markdown, con bloques de código para comandos y configuración
- Enlazar a la página de documentación de la que sale la respuesta
- Mantener el contexto de cada hilo para las preguntas de seguimiento
- Responder en el idioma en que se hizo la pregunta
- Dejar los informes de errores, las peticiones de funciones y los pull requests a tu equipo
Permisos
La app pide acceso de lectura y escritura a Issues y Discussions, para leer la pregunta y publicar la respuesta, y acceso de lectura a los metadatos del repositorio.
Privacidad
Asyntai recibe el texto de la pregunta, el nombre del repositorio y el nombre de usuario de GitHub de quien pregunta. Cada hilo respondido se guarda como conversación en tu panel de Asyntai, como un chat en tu web.
Planes y precios
La integración con GitHub está disponible en todos los planes de Asyntai, incluido el gratuito. Cada respuesta cuenta como un mensaje de tu cuota mensual, compartida entre todos tus canales e integraciones. Ver precios.
Desinstalación
Abre tu configuración de GitHub, luego Applications, luego Installed GitHub Apps, y desinstala Asyntai. La app deja de responder al instante. También puedes pulsar Desconectar en la página GitHub de tu panel de Asyntai.
¿Necesita ayuda?
Si tiene alguna pregunta o encuentras problemas, contáctanos en [email protected].