Documentación de la plataformaDocumentos

GitHub y Discord

Recibe los resultados de compilación de un repositorio de GitHub en una conversación de Agora y deja que un agente responda a /ask en tu servidor de Discord.

Para propietarios y administradoresConecta tus herramientas · página 6 de 35

GitHub y Discord son conexiones del espacio de trabajo: un administrador las configura una vez, para todo el mundo. Con GitHub CI, los resultados de compilación de un repositorio llegan a la conversación de Agora a la que le interesan. Con Discord, un agente responde a /ask donde tu equipo ya conversa. Esta página ayuda a los administradores a configurar ambas y muestra a los miembros lo que verán.

Antes de empezar

Necesitas ser administrador para configurar GitHub CI y Discord.
Abre Gobernanza › Configuración › Integraciones y baja hasta la franja Espacio de trabajo, marcada como Solo admins · compartido por todo el espacio de trabajo. Los miembros no ven esta franja.
Discord está en todos los planes, incluido el gratuito.

Configuración › Integraciones tal como la ve Tom Becker, administrador, en la franja Espacio de trabajo con Discord y GitHub CI, y «Solo admins · compartido por todo el espacio de trabajo» resaltado. — 01Las conexiones del espacio de trabajo se configuran una vez, para todo el mundo.

Vincula un repositorio de GitHub a una conversación

Los resultados de compilación llegan como notas breves de estado que publica Gitta the Hub: iniciada, correcta o fallida. Son dos pasos: un webhook en GitHub, que avisa a Nexa Agora cuando hay una ejecución, y una vinculación aquí.

En la franja Espacio de trabajo, busca GitHub CI y haz clic en Vincular un repositorio.
Haz clic en Crear el secreto.
Aparece el cuadro El secreto de tu webhook: se muestra una sola vez. Haz clic en Copiar.
En GitHub, abre los ajustes del repositorio y después Webhooks › Add webhook. Pega la dirección que muestra la página y el secreto, elige el tipo de contenido application/json y el evento Workflow runs, y guarda.
De vuelta en la página, escribe el Repositorio como owner/name, por ejemplo harbor-pine/oceanic-site.
Elige la Conversación, por ejemplo #client-oceanic.
Opcional: marca Notificar también los check runs. Los workflow runs se notifican siempre.
Haz clic en Vincular.
La página dice Vinculado. La próxima ejecución se notificará en «…».

El formulario Vincular un repositorio con el cuadro «El secreto de tu webhook: se muestra una sola vez», el repositorio harbor-pine/oceanic-site y la conversación #client-oceanic. — 02Pega el secreto en GitHub antes de salir de la página.

Gestiona una vinculación

Cada vinculación muestra owner/name → conversación, con Notificaciones o En pausa. Unas etiquetas indican qué se notifica: Workflow runs, Check runs si los elegiste y Secreto configurado.

Una fila de repositorio vinculado, harbor-pine/oceanic-site → #client-oceanic, con Notificaciones, Pausar y Sustituir el secreto. — 03Cada vinculación muestra su estado y lo que notifica.

Pausar detiene las notificaciones. Reanudar las vuelve a poner en marcha.
Sustituir el secreto crea un secreto nuevo. Actualízalo también en GitHub, o la próxima ejecución se rechaza.
Eliminar esta vinculación deja de notificar las ejecuciones de ese repositorio. Confírmalo con Eliminar.

Consulta los resultados de compilación en Agora

Abre en Agora la conversación vinculada.
Lee las notas de estado de Gitta the Hub: cada ejecución llega como iniciada, correcta o fallida.

Los agentes de esa conversación ven cada resultado en cuanto llega.

La conversación #client-oceanic en Agora con las notas de compilación de Gitta the Hub agrupadas en «Build · 2 / 2 passed». — 04Los resultados de compilación llegan a la conversación como notas breves.

Conecta tu servidor de Discord

En la franja Espacio de trabajo, abre Discord y haz clic en Añadir a Discord.
Opcional: escribe un Título de la tarjeta, el nombre con el que tu equipo llama al servidor.
Opcional: escribe un Nombre de la sala, el nombre que usan los agentes para el canal que elijas. Si lo dejas vacío, es «general».
Haz clic en Continuar en Discord.
En Discord, elige tu servidor y el canal que recibe los anuncios, y autoriza el bot.
Discord añade /ask allí y te devuelve a la página.
De vuelta en la página, ves Conectado a Discord.

La tarjeta Añadir a Discord con Título de la tarjeta «Harbor & Pine» y Nombre de la sala «general». — 05Pon nombre al servidor y a su sala de anuncios antes de ir a Discord.

Elige el agente y quién puede preguntar

Abre la Configuración del servidor.
En Agente que responde a /ask, elige el agente.
En Quién puede preguntar, elige una opción:
Todos en el servidor.
Miembros con estos roles
escribe los ID de los roles de Discord, separados por comas. En Discord, abre Ajustes del servidor › Roles, haz clic derecho en un rol y elige Copiar ID del rol; para ello necesitas tener activado el modo desarrollador.
Solo estas personas
escribe los ID de usuario de Discord, separados por comas.
Fija Preguntas al día por miembro y Preguntas al día para el servidor.
Haz clic en Guardar.

Los ajustes del servidor de Discord con Agente que responde a /ask, Quién puede preguntar en Miembros con estos roles, las dos cifras diarias y Estantería para Discord en el estante Studio. — 06Elige el agente, quién puede preguntar, los límites diarios y lo que lee el agente.

Los límites diarios impiden que un servidor con mucha actividad gaste todos los créditos del espacio de trabajo. El día vuelve a empezar a las 00:00 UTC.

Elige lo que lee el agente en Discord

En los ajustes del servidor, abre Qué lee en Discord y después Estantería para Discord.
Elige un estante de la Biblioteca, o Solo la web.
La línea confirma que el agente responde en Discord solo a partir de este estante y de la web.

Si la Biblioteca todavía no tiene estantes, crea uno en la Biblioteca y archiva en él lo que Discord puede leer.

Añade salas de anuncios

Los agentes pueden publicar anuncios en los canales de Discord que añadas como salas.

En Salas que reciben avisos, haz clic en Añadir una sala.
Pega la dirección del webhook de la sala, que encontrarás en los ajustes del canal de Discord › Integraciones. Se guarda cifrada y no se vuelve a mostrar.
Haz clic en Añadir.
Haz clic en Probar en la sala.
Ves Hemos publicado un mensaje de prueba en #…. o Discord rechazó el mensaje de prueba.

Salas que reciben avisos con una sala y la línea con el resultado de su mensaje de prueba. — 07Prueba cada sala antes de que le llegue nada real.

Para quitar una sala, haz clic en Quitar #….

Pausa o quita un servidor de Discord

Pausar, en la fila del servidor, detiene las respuestas. Reanudar las vuelve a poner en marcha.
Quitar este servidor hace que /ask deje de responder allí y que sus salas dejen de recibir avisos. Confírmalo con Quitar.

Pregunta en Discord

En el servidor de Discord, escribe /ask y tu pregunta.
El agente elegido responde donde preguntaste, indicando que es una IA, para que todo el servidor sepa que está hablando con un agente.

Si no tienes permiso, has agotado las preguntas del día o se han acabado los créditos del espacio de trabajo, solo tú ves la respuesta. Te dice el motivo, cuándo puedes volver a preguntar y quién puede cambiarlo.

Lo que verás

Próximamente. GitHub aún no está activado en este espacio de trabajo. y Próximamente. Discord aún no está activado en este espacio de trabajo.
Aún no hay nada vinculado y Aún no hay nada conectado.
Crea primero el secreto y pégalo en GitHub., Escribe el repositorio como owner/name., No se ha podido vincular el repositorio.
Aún no hay salas: los agentes no tienen dónde publicar anuncios hasta que añadas una.
… responde a todos en el servidor. o Todavía nadie: añade en los ajustes los ID de los roles que pueden preguntar.
Hasta … preguntas al día por miembro y … para el servidor. Cada pregunta usa los créditos del workspace.
No se eligió ningún canal en la pantalla de Discord. Vuelve a intentarlo y elige el canal que recibe los anuncios.
Un servidor ya vinculado a otro espacio de trabajo devuelve ese error. Un servidor se vincula a un solo espacio de trabajo: el primero que llega.

Conviene saber

Gitta the Hub solo informa del estado de las compilaciones. No inicia ejecuciones. Un repositorio no se puede vincular a un proyecto.
Los límites diarios predeterminados son 20 preguntas por miembro y 150 para todo el servidor. Un administrador puede cambiar ambos, y quién puede preguntar, en cualquier momento.
Las respuestas de Discord se pagan con los créditos compartidos del espacio de trabajo, nunca con la licencia de la persona que conectó el servidor.
Desde Discord, el agente solo lee el estante elegido, que contiene documentos de Equipo y nunca correo, y la web. Nunca lee documentos privados, memorias, correo, calendario ni proyectos de nadie, ni el Cerebro de la empresa.
El agente no puede crear, cambiar ni eliminar nada desde Discord. Si se le pide más, lo dice y remite a la app de Nexa Agora. Sin estante, responde solo a partir de la web y dice que un administrador puede elegir uno.
Desde /ask, el agente no publica nada en otros canales.
Los miembros ven los resultados de GitHub en las conversaciones vinculadas que pueden abrir.

Salas de Agora — las conversaciones a las que llegan los resultados de GitHub.
Biblioteca — los estantes, y el estante que lee Discord.
Buzones y calendarios — la franja Para ti de la misma página.
Facturación — los créditos del espacio de trabajo que usan las respuestas de Discord.
Organización — quiénes son los administradores.
Tu agente externo — otra forma de llegar a Nexa Agora desde fuera de la app.

GitHub y Discord

Recibe los resultados de compilación de un repositorio de GitHub en una conversación de Agora y deja que un agente responda a /ask en tu servidor de Discord.

Para propietarios y administradoresConecta tus herramientas · página 6 de 35

Antes de empezar

Necesitas ser administrador para configurar GitHub CI y Discord.
Abre Gobernanza › Configuración › Integraciones y baja hasta la franja Espacio de trabajo, marcada como Solo admins · compartido por todo el espacio de trabajo. Los miembros no ven esta franja.
Discord está en todos los planes, incluido el gratuito.

Vincula un repositorio de GitHub a una conversación

En la franja Espacio de trabajo, busca GitHub CI y haz clic en Vincular un repositorio.
Haz clic en Crear el secreto.
Aparece el cuadro El secreto de tu webhook: se muestra una sola vez. Haz clic en Copiar.
En GitHub, abre los ajustes del repositorio y después Webhooks › Add webhook. Pega la dirección que muestra la página y el secreto, elige el tipo de contenido application/json y el evento Workflow runs, y guarda.
De vuelta en la página, escribe el Repositorio como owner/name, por ejemplo harbor-pine/oceanic-site.
Elige la Conversación, por ejemplo #client-oceanic.
Opcional: marca Notificar también los check runs. Los workflow runs se notifican siempre.
Haz clic en Vincular.
La página dice Vinculado. La próxima ejecución se notificará en «…».

Gestiona una vinculación

Pausar detiene las notificaciones. Reanudar las vuelve a poner en marcha.
Sustituir el secreto crea un secreto nuevo. Actualízalo también en GitHub, o la próxima ejecución se rechaza.
Eliminar esta vinculación deja de notificar las ejecuciones de ese repositorio. Confírmalo con Eliminar.

Consulta los resultados de compilación en Agora

Abre en Agora la conversación vinculada.
Lee las notas de estado de Gitta the Hub: cada ejecución llega como iniciada, correcta o fallida.

Los agentes de esa conversación ven cada resultado en cuanto llega.

Conecta tu servidor de Discord

En la franja Espacio de trabajo, abre Discord y haz clic en Añadir a Discord.
Opcional: escribe un Título de la tarjeta, el nombre con el que tu equipo llama al servidor.
Opcional: escribe un Nombre de la sala, el nombre que usan los agentes para el canal que elijas. Si lo dejas vacío, es «general».
Haz clic en Continuar en Discord.
En Discord, elige tu servidor y el canal que recibe los anuncios, y autoriza el bot.
Discord añade /ask allí y te devuelve a la página.
De vuelta en la página, ves Conectado a Discord.

Elige el agente y quién puede preguntar

Abre la Configuración del servidor.
En Agente que responde a /ask, elige el agente.
En Quién puede preguntar, elige una opción:
Todos en el servidor.
Miembros con estos roles
escribe los ID de los roles de Discord, separados por comas. En Discord, abre Ajustes del servidor › Roles, haz clic derecho en un rol y elige Copiar ID del rol; para ello necesitas tener activado el modo desarrollador.
Solo estas personas
escribe los ID de usuario de Discord, separados por comas.
Fija Preguntas al día por miembro y Preguntas al día para el servidor.
Haz clic en Guardar.

Los límites diarios impiden que un servidor con mucha actividad gaste todos los créditos del espacio de trabajo. El día vuelve a empezar a las 00:00 UTC.

Elige lo que lee el agente en Discord

En los ajustes del servidor, abre Qué lee en Discord y después Estantería para Discord.
Elige un estante de la Biblioteca, o Solo la web.
La línea confirma que el agente responde en Discord solo a partir de este estante y de la web.

Si la Biblioteca todavía no tiene estantes, crea uno en la Biblioteca y archiva en él lo que Discord puede leer.

Añade salas de anuncios

Los agentes pueden publicar anuncios en los canales de Discord que añadas como salas.

En Salas que reciben avisos, haz clic en Añadir una sala.
Pega la dirección del webhook de la sala, que encontrarás en los ajustes del canal de Discord › Integraciones. Se guarda cifrada y no se vuelve a mostrar.
Haz clic en Añadir.
Haz clic en Probar en la sala.
Ves Hemos publicado un mensaje de prueba en #…. o Discord rechazó el mensaje de prueba.

Para quitar una sala, haz clic en Quitar #….

Pausa o quita un servidor de Discord

Pausar, en la fila del servidor, detiene las respuestas. Reanudar las vuelve a poner en marcha.
Quitar este servidor hace que /ask deje de responder allí y que sus salas dejen de recibir avisos. Confírmalo con Quitar.

Pregunta en Discord

En el servidor de Discord, escribe /ask y tu pregunta.
El agente elegido responde donde preguntaste, indicando que es una IA, para que todo el servidor sepa que está hablando con un agente.

Lo que verás

Próximamente. GitHub aún no está activado en este espacio de trabajo. y Próximamente. Discord aún no está activado en este espacio de trabajo.
Aún no hay nada vinculado y Aún no hay nada conectado.
Crea primero el secreto y pégalo en GitHub., Escribe el repositorio como owner/name., No se ha podido vincular el repositorio.
Aún no hay salas: los agentes no tienen dónde publicar anuncios hasta que añadas una.
… responde a todos en el servidor. o Todavía nadie: añade en los ajustes los ID de los roles que pueden preguntar.
Hasta … preguntas al día por miembro y … para el servidor. Cada pregunta usa los créditos del workspace.
No se eligió ningún canal en la pantalla de Discord. Vuelve a intentarlo y elige el canal que recibe los anuncios.
Un servidor ya vinculado a otro espacio de trabajo devuelve ese error. Un servidor se vincula a un solo espacio de trabajo: el primero que llega.

Conviene saber

Gitta the Hub solo informa del estado de las compilaciones. No inicia ejecuciones. Un repositorio no se puede vincular a un proyecto.
Los límites diarios predeterminados son 20 preguntas por miembro y 150 para todo el servidor. Un administrador puede cambiar ambos, y quién puede preguntar, en cualquier momento.
Las respuestas de Discord se pagan con los créditos compartidos del espacio de trabajo, nunca con la licencia de la persona que conectó el servidor.
Desde Discord, el agente solo lee el estante elegido, que contiene documentos de Equipo y nunca correo, y la web. Nunca lee documentos privados, memorias, correo, calendario ni proyectos de nadie, ni el Cerebro de la empresa.
El agente no puede crear, cambiar ni eliminar nada desde Discord. Si se le pide más, lo dice y remite a la app de Nexa Agora. Sin estante, responde solo a partir de la web y dice que un administrador puede elegir uno.
Desde /ask, el agente no publica nada en otros canales.
Los miembros ven los resultados de GitHub en las conversaciones vinculadas que pueden abrir.

Salas de Agora — las conversaciones a las que llegan los resultados de GitHub.
Biblioteca — los estantes, y el estante que lee Discord.
Buzones y calendarios — la franja Para ti de la misma página.
Facturación — los créditos del espacio de trabajo que usan las respuestas de Discord.
Organización — quiénes son los administradores.
Tu agente externo — otra forma de llegar a Nexa Agora desde fuera de la app.