Collega il tuo account GitHub a Goodweek per gestire repository, issue, pull request e flussi di lavoro direttamente dal tuo spazio di lavoro IA.
ℹ️ Nota sulla governance
Goodweek non supererà mai i livelli di accesso concessi all'utente all'interno di GitHub, garantendo così la conformità con le politiche di governance della tua organizzazione. I risultati e le funzionalità disponibili possono variare in base alle autorizzazioni specifiche e all'accesso autenticato di ciascun utente.
📋 Prerequisiti
Prima che un utente possa vedere e collegare l'integrazione GitHub, l'amministratore della tua organizzazione deve prima abilitarla dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.
Configurazione amministratore
L'integrazione GitHub utilizza OAuth 2.0 e non richiede alcuna approvazione a livello di amministratore per i repository personali. Tuttavia, l'accesso alle risorse di un'organizzazione GitHub potrebbe richiedere passaggi aggiuntivi.
⚠️ Restrizioni delle app OAuth per le organizzazioni GitHub
Le organizzazioni GitHub possono limitare quali app OAuth di terze parti hanno accesso ai dati dell'organizzazione. Se la tua organizzazione ha abilitato le restrizioni di accesso delle app OAuth, un proprietario dell'organizzazione GitHub deve approvare Composio prima che gli utenti possano accedere ai repository e alle risorse dell'organizzazione:
Vai alla tua organizzazione GitHub → Impostazioni → Accesso di terze parti → Policy delle app OAuth.
Trova l'app Composio e fai clic su Approva per concedere l'accesso all'organizzazione.
Questa restrizione è abilitata per impostazione predefinita nelle nuove organizzazioni GitHub. Senza approvazione, gli utenti possono collegare il proprio account GitHub personale ma non potranno accedere ai repository di proprietà dell'organizzazione.
Connessione utente
In Goodweek, vai su Integrazioni.
Trova GitHub e fai clic su Connetti.
Verrai reindirizzato a GitHub, dove ti verrà chiesto di accedere e autorizzare l'accesso.
Fai clic su Autorizza per concedere l'accesso e tornare a Goodweek.
Note importanti
Ogni utente deve collegare il proprio account individualmente.
Goodweek può accedere solo ai repository e alle risorse che il tuo account GitHub individuale ha l'autorizzazione a visualizzare.
L'accesso ai repository di proprietà dell'organizzazione richiede che il proprietario dell'organizzazione approvi Composio come descritto sopra.
Puoi revocare l'accesso di Goodweek in qualsiasi momento da GitHub → Impostazioni → Applicazioni → App OAuth autorizzate → Composio → Revoca.
Strumenti disponibili
Strumento | Descrizione | Tipo |
Get a Repository | Recupera informazioni dettagliate su un repository GitHub specifico. | Lettura |
List Repositories for User | Elenca i repository di un utente specificato o dell'utente autenticato. | Lettura |
List Organization Repositories | Elenca i repository di un'organizzazione GitHub specificata. | Lettura |
Search Repositories | Cerca repository GitHub utilizzando la sintassi di ricerca di GitHub. | Lettura |
Create a Repository | Crea un nuovo repository GitHub per l'utente autenticato o l'organizzazione. | Scrittura |
Get Repository Content | Recupera il contenuto di un file o di una directory in un repository. | Lettura |
Create or Update File Contents | Crea un nuovo file o aggiorna il contenuto di un file esistente in un repository. | Scrittura |
Get an Issue | Recupera un issue GitHub specifico in base a repository e numero dell'issue. | Lettura |
List Repository Issues | Elenca gli issue di un repository con filtro facoltativo per stato, etichette e assegnatario. | Lettura |
Create an Issue | Crea un nuovo issue in un repository specificato. | Scrittura |
Update an Issue | Aggiorna titolo, corpo, stato, etichette o assegnatari di un issue esistente. | Scrittura |
Add Labels to an Issue | Aggiunge una o più etichette a un issue GitHub. | Scrittura |
Add Assignees to an Issue | Assegna uno o più utenti a un issue GitHub. | Scrittura |
Create Issue Comment | Aggiunge un commento a un issue GitHub esistente. | Scrittura |
List Issue Comments | Elenca tutti i commenti di un issue GitHub specifico. | Lettura |
Get a Pull Request | Recupera i dettagli di una pull request specifica. | Lettura |
List Pull Requests | Elenca le pull request di un repository con filtro facoltativo per stato e branch. | Lettura |
Create a Pull Request | Crea una nuova pull request da un branch di origine a un branch di base. | Scrittura |
Update a Pull Request | Aggiorna titolo, corpo, stato o branch di base di una pull request. | Scrittura |
Create a Review Comment on a Pull Request | Aggiunge un commento di revisione a una riga specifica di una pull request. | Scrittura |
Merge a Pull Request | Unisce una pull request al suo branch di base. | Scrittura |
List Repository Commits | Elenca i commit di un repository con filtro facoltativo per autore, percorso o intervallo di date. | Lettura |
Get a Commit | Recupera i dettagli di un commit specifico tramite il suo SHA. | Lettura |
List Repository Branches | Elenca i branch di un repository specificato. | Lettura |
Create a Branch | Crea un nuovo branch in un repository a partire da uno SHA o branch specificato. | Scrittura |
Get a Workflow Run | Recupera i dettagli di un'esecuzione specifica di un flusso di lavoro GitHub Actions. | Lettura |
List Workflow Runs for a Workflow | Elenca le esecuzioni di un flusso di lavoro specificato con filtro facoltativo per stato. | Lettura |
Re-run a Workflow | Riesegue tutti i job di un'esecuzione di flusso di lavoro specificata. | Scrittura |
Search Code | Cerca codice nei repository GitHub utilizzando la sintassi di ricerca del codice di GitHub. | Lettura |
Search Issues and Pull Requests | Cerca issue e pull request di GitHub utilizzando la sintassi di ricerca di GitHub. | Lettura |
Get a User | Recupera le informazioni pubbliche di un utente GitHub specificato. | Lettura |
Get the Authenticated User | Recupera il profilo dell'utente GitHub autenticato. | Lettura |
List Organization Members | Elenca i membri di un'organizzazione GitHub. | Lettura |
Close an Issue | Chiude un issue GitHub specificato. | ⚠️ Distruttivo |
Close a Pull Request | Chiude una pull request specificata senza unirla. | ⚠️ Distruttivo |
Delete a File | Elimina un file da un repository. Questa azione è irreversibile senza la cronologia del controllo versione. | ⚠️ Distruttivo |
Casi d'uso
Crea e gestisci issue dalle conversazioni. Registra nuovi issue GitHub con titolo, descrizione, etichette e assegnatari direttamente da una conversazione Goodweek, utile per catturare bug o richieste di funzionalità senza passare a GitHub.
Rivedi pull request e cronologia dei commit. Recupera i dettagli di una PR, elenca i commit recenti o controlla lo stato di un'esecuzione di flusso di lavoro da Goodweek per rimanere aggiornato sull'attività del repository.
Cerca codice e issue in tutti i repository. Usa la sintassi di ricerca di GitHub direttamente da Goodweek per trovare codice, issue o PR specifici nei tuoi repository senza aprire l'interfaccia di GitHub.
Crea e aggiorna file nei repository. Leggi il contenuto dei file o invia piccoli aggiornamenti dei file direttamente da Goodweek, utile per aggiornare documentazione, file di configurazione o contenuti README.
Risoluzione dei problemi
Connessione riuscita ma mancano i repository dell'organizzazione
La tua organizzazione GitHub ha le restrizioni di accesso delle app OAuth abilitate. Un proprietario dell'organizzazione GitHub deve approvare Composio dalle Impostazioni dell'organizzazione → Accesso di terze parti → Policy delle app OAuth.
Integrazione non visibile in Goodweek
Assicurati che l'amministratore della tua organizzazione abbia abilitato l'integrazione GitHub dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.