Configura i connettori esterni per le attività di arricchimento

I provider di autenticazione di terze parti ti consentono di connettere in modo sicuro le attività di arricchimento di Knowledge Studio a piattaforme esterne come GitHub, Microsoft SharePoint e Atlassian Confluence. Completa i passaggi di generazione delle credenziali e di configurazione del provider di autenticazione descritti in questo documento nell'ambito della configurazione dei prerequisiti.

Prima di iniziare

Prima di configurare i connettori esterni, assicurati di aver completato i seguenti prerequisiti:

  • Esamina il workflow di configurazione complessivo dell'arricchimento in Configura i prerequisiti per le attività di arricchimento.
  • Assicurati di disporre delle autorizzazioni di amministratore o sviluppatore necessarie nelle piattaforme di terze parti di destinazione (GitHub, Microsoft SharePoint o Atlassian Confluence) per generare token di accesso o registrare applicazioni.
  • Per archiviare in modo sicuro le credenziali e collegarle alle attività, assicurati di aver configurato correttamente il servizio Agent Identity. Per saperne di più, consulta Configura le autorizzazioni IAM per i provider di autenticazione.

Quando connetti l'agente di arricchimento a fonti di conoscenza di terze parti, devi utilizzare il servizio Google Cloud Agent Identity. L'identità dell'agente funge da gestore dell'autenticazione che archivia in modo sicuro le tue credenziali di terze parti e fornisce token di accesso di breve durata all'agente di arricchimento, in modo che gli operatori umani non debbano mai gestire direttamente i secret client non elaborati durante l'esecuzione delle attività.

Configura GitHub

Per connettere Knowledge Studio ai repository GitHub, devi creare un token di accesso personale (PAT) granulare in GitHub e archiviarlo in un provider di autenticazione con chiave API.

  1. Accedi a GitHub, fai clic sulla tua foto del profilo e poi su Impostazioni.
  2. Vai a Developer settings (Impostazioni sviluppatore) > Personal access tokens (Token di accesso personali) > Fine-grained tokens (Token granulari).
  3. Fai clic su Genera nuovo token.
  4. Configura le proprietà del token:
    • Nome token: inserisci un nome descrittivo (ad esempio, enrichment-agent).
    • Scadenza: imposta una data di scadenza appropriata.
    • Proprietario della risorsa: seleziona l'organizzazione o l'account utente proprietario dei repository di destinazione.
    • Accesso ai repository: seleziona Solo repository selezionati e scegli i repository che vuoi arricchire.
    • Autorizzazioni: concedi l'accesso specifico in Lettura o Lettura e scrittura per gli ambiti richiesti (ad esempio Problemi, Richieste di pull e Contenuti).
  5. Fai clic su Genera token e copia il token in modo sicuro.
  6. Registra un provider di autenticazione con chiave API in Google Cloud e fornisci il PAT come chiave API. Consulta Autenticati utilizzando una chiave API con Auth Manager.

Per saperne di più sulla creazione di un PAT, consulta Gestione dei token di accesso personale nella documentazione di GitHub.

Configura Microsoft SharePoint

Se ti connetti a Microsoft SharePoint, ottieni le credenziali OAuth da Microsoft Entra ID (in precedenza Azure Active Directory) utilizzando un flusso OAuth a due fattori.

  1. Registra una nuova applicazione nel centro di amministrazione di Microsoft Entra.
  2. Concedi le autorizzazioni API Microsoft Graph:
    1. Vai ad API permissions (Autorizzazioni API) > Add a permission (Aggiungi un'autorizzazione) > Microsoft Graph > Application permissions (Autorizzazioni applicazione) (non selezionare Delegated permissions (Autorizzazioni delegate)).
    2. Aggiungi gli ambiti Sites.Read.All e Files.Read.All.
    3. Fai clic su Concedi il consenso amministratore per il tuo tenant in modo che entrambe le autorizzazioni dell'applicazione vengano visualizzate come "Concesse".

  3. Crea un nuovo client secret. Registra immediatamente il suo valore, poiché viene mostrato una sola volta. Per saperne di più, consulta Crea un nuovo client secret.

  4. Copia i valori di configurazione dell'applicazione. Dopo la registrazione, raccogli i seguenti valori per la configurazione del provider di autenticazione:

    • ID client: l'ID applicazione (client) della panoramica dell'app.
    • URL token: nella pagina Panoramica, fai clic sulla scheda Endpoint. Copia l'URL con l'etichetta Endpoint del token OAuth 2.0 (v2).

  5. Registra un provider di autenticazione OAuth a due vie in Google Cloud utilizzando questi secret. Quando crei il provider, fornisci l'ambito predefinito al parametro --allowed-scopes:

    --allowed-scopes="https://graph.microsoft.com/.default"

    Per saperne di più, consulta Registrare un'applicazione con la piattaforma di identità Microsoft nella documentazione di Microsoft Entra.

Configura Atlassian Confluence

Poiché Confluence non supporta OAuth a due vie per gli agenti server-server, devi creare un account di servizio dedicato (o un account utente fittizio) in Atlassian, concedergli le autorizzazioni richieste e generare un PAT.

  1. Accedi al account di servizio specifico in Confluence.
  2. Fai clic sulla tua immagine del profilo nell'angolo in alto a destra dello schermo.
  3. Seleziona Impostazioni (o Impostazioni account) dal menu.
  4. Nella scheda Sicurezza, vai alla sezione Token API.
  5. Fai clic sul pulsante Create API token with scopes (Crea token API con ambiti). Non utilizzare un token senza ambito perché non recupererà tutti gli strumenti richiesti.
  6. Fornisci un nome descrittivo (ad esempio enrichment-agent), configura la data di scadenza e fai clic su Avanti.
  7. Nell'elenco Seleziona l'app, seleziona l'opzione Atlassian MCP e fai clic su Avanti.
  8. Seleziona tutti i seguenti ambiti di lettura e ricerca di Confluence:
    • read:page:confluence
    • read:space:confluence
    • search:confluence
    • read:confluence-content.all
    • read:confluence-content.summary
    • read:confluence-space.summary
    • search:rovo:mcp
    • read:jira-work
  9. Fai clic su Avanti e poi su Crea.
  10. Copia il token generato.
  11. Formatta la stringa delle credenziali per il provider di autenticazione Google Cloud come <ATLASSIAN_EMAIL>:<API_TOKEN>. Atlassian richiede la codifica dell'autenticazione di base HTTP (email:api_token) per utilizzare i token API personali in modo programmatico.
  12. Registra un provider di autenticazione delle chiavi API in Google Cloud e fornisci la stringa<ATLASSIAN_EMAIL>:<API_TOKEN> come chiave API. Consulta Autenticati utilizzando una chiave API con Auth Manager.

Per ulteriori informazioni sulla creazione di un PAT, consulta Gestisci i token API per il tuo account Atlassian nella documentazione di Atlassian.

Passaggi successivi