Vai al contenuto
Kaiross

Sviluppo

GitLab

Progetti, issue, merge request e file di GitLab.com o di un GitLab installato sui tuoi server.

  • Token o credenziali
  • Azioni con conferma
  • Anche via tunnel VPN

Strumenti per l’agente

L’agente sceglie da solo lo strumento adatto alla domanda. Nella scheda MCP e database dell’agente puoi disattivare quelli che non servono.

StrumentoCosa faTipo
search_projects Cerca progetti accessibili per nome. Lettura
list_issues Issue di un progetto (stato, etichette, testo). Lettura
get_issue Dettaglio di un’issue con descrizione e ultimi commenti. Lettura
list_merge_requests Merge request di un progetto. Lettura
read_file Legge un file del repository, o elenca una cartella se il percorso è una directory. Lettura
create_issue Crea un’issue in un progetto. Richiede conferma. Con conferma
add_comment Aggiunge un commento a un’issue. Richiede conferma. Con conferma

Le azioni che modificano dati sono spente di default. Si attivano nella connessione con l’opzione Consenti creazione di issue e commenti (con conferma); poi ogni azione mostra in chat un riepilogo e parte solo con Conferma ed esegui.

Configurazione passo per passo

In Kaiross apri Integrazioni, scegli GitLab e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.

  1. Preferisci un group o project access token (Settings → Access tokens) al token personale.
  2. Scope: read_api (sola lettura) oppure api se abiliti la scrittura; ruolo Reporter è sufficiente per leggere.
  3. Incolla il token: resta nel Vault. Imposta una scadenza.

Campi del modulo: URL di GitLab.

Da incollare (cifrato nel Vault, poi non più visibile): Access token.

Da sapere

  • Se il servizio è nella rete della tua azienda, crea prima un tunnel in Impostazioni → Rete / VPN e nella connessione scegli Raggiungibile tramite → il tunnel. Vedi Database e gestionali.

Collegarla a un agente

  1. Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
  2. In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
  3. Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
  4. Premi Prova in chat e fai una domanda che richiede i dati del servizio.

Errori frequenti

Credenziali non valide
Controlla token, password o chiave API: spesso manca un carattere o il token è scaduto. Creane uno nuovo e aggiorna la connessione.
Permessi insufficienti
All’account o al token mancano i permessi necessari: confrontali con la configurazione qui sopra (Guida e permessi consigliati nell’app) e, se serve, crea un token nuovo.
Servizio non raggiungibile
Controlla indirizzo, porta e firewall. Un server nella rete aziendale richiede un tunnel VPN; senza tunnel sono ammessi solo indirizzi pubblici.
Troppe richieste
Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.

Altre integrazioni della categoria Sviluppo

Tutte le integrazioni