Mengonfigurasi konektor eksternal untuk tugas pengayaan

Penyedia autentikasi pihak ketiga memungkinkan Anda menghubungkan tugas pengayaan Knowledge Studio dengan aman ke platform eksternal seperti GitHub, Microsoft SharePoint, dan Atlassian Confluence. Selesaikan langkah-langkah pembuatan kredensial dan konfigurasi penyedia autentikasi dalam dokumen ini sebagai bagian dari penyiapan prasyarat Anda.

Sebelum memulai

Sebelum mengonfigurasi konektor eksternal, pastikan Anda telah menyelesaikan prasyarat berikut:

  • Tinjau keseluruhan alur kerja konfigurasi pengayaan di Mengonfigurasi prasyarat untuk tugas pengayaan.
  • Pastikan Anda memiliki izin administrator atau developer yang diperlukan di platform pihak ketiga target (GitHub, Microsoft SharePoint, atau Atlassian Confluence) untuk membuat token akses atau mendaftarkan aplikasi.
  • Untuk menyimpan kredensial dengan aman dan melampirkannya ke tugas, pastikan Anda telah mengonfigurasi layanan Agent Identity dengan benar. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan izin IAM untuk penyedia auth.

Saat menghubungkan agen pengayaan ke sumber pengetahuan pihak ketiga, Anda harus menggunakan layanan Google Cloud Identitas Agen. Identitas Agen bertindak sebagai pengelola autentikasi yang menyimpan kredensial pihak ketiga Anda dengan aman dan menyediakan token akses berumur pendek ke agen pengayaan sehingga operator manusia tidak perlu mengelola rahasia klien mentah secara langsung selama eksekusi tugas.

Konfigurasikan GitHub

Untuk menghubungkan Knowledge Studio ke repositori GitHub, Anda harus membuat Token Akses Pribadi (PAT) terperinci di GitHub dan menyimpannya di penyedia autentikasi kunci API.

  1. Login ke GitHub, klik foto profil Anda, lalu klik Settings.
  2. Buka Developer settings > Personal access tokens > Fine-grained tokens.
  3. Klik Buat token baru.
  4. Konfigurasi properti token:
    • Token name: Masukkan nama deskriptif (misalnya, enrichment-agent).
    • Masa berlaku: Tetapkan tanggal habis masa berlaku yang sesuai.
    • Resource owner: Pilih organisasi atau akun pengguna yang memiliki repositori target.
    • Repository access: Pilih Only select repositories dan pilih repositori yang ingin Anda perkaya.
    • Permissions: Berikan akses Read atau Read and Write tertentu untuk cakupan yang diperlukan (seperti Issues, permintaan pull, dan Contents).
  5. Klik Generate token dan salin token dengan aman.
  6. Daftarkan penyedia autentikasi kunci API di Google Cloud dan berikan PAT sebagai kunci API. Lihat Melakukan autentikasi menggunakan kunci API dengan pengelola autentikasi.

Untuk mengetahui informasi selengkapnya tentang cara membuat PAT, lihat Mengelola token akses pribadi Anda dalam dokumentasi GitHub.

Mengonfigurasi Microsoft SharePoint

Jika Anda terhubung ke Microsoft SharePoint, dapatkan kredensial OAuth dari Microsoft Entra ID (sebelumnya Azure Active Directory) menggunakan alur OAuth 2-Legged.

  1. Daftarkan aplikasi baru di Microsoft Entra admin center.
  2. Berikan izin Microsoft Graph API:
    1. Buka API permissions > Add a permission > Microsoft Graph > Application permissions (jangan pilih Delegated permissions).
    2. Tambahkan cakupan Sites.Read.All dan Files.Read.All.
    3. Klik Grant admin consent untuk tenant Anda sehingga kedua izin Aplikasi ditampilkan sebagai "Granted".

  3. Buat rahasia klien baru. Segera catat nilainya, karena hanya ditampilkan sekali. Untuk mengetahui informasi selengkapnya, lihat Membuat rahasia klien baru.

  4. Salin nilai konfigurasi aplikasi Anda. Setelah pendaftaran, kumpulkan nilai berikut untuk konfigurasi penyedia autentikasi Anda:

    • Client ID: ID Aplikasi (klien) dari ringkasan aplikasi Anda.
    • Token URL: Saat berada di halaman Overview, klik tab Endpoints. Salin URL berlabel OAuth 2.0 token endpoint (v2).

  5. Daftarkan penyedia autentikasi OAuth 2-legged di Google Cloud menggunakan rahasia ini. Saat membuat penyedia, berikan cakupan default ke parameter --allowed-scopes:

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

    Untuk mengetahui informasi selengkapnya, lihat Register an application with the Microsoft identity platform dalam dokumentasi Microsoft Entra.

Mengonfigurasi Atlassian Confluence

Karena Confluence tidak mendukung 2-Legged OAuth untuk agen server ke server, Anda harus membuat akun layanan khusus (atau akun pengguna dummy) di Atlassian, memberinya izin yang diperlukan, dan membuat PAT.

  1. Login ke akun layanan tertentu di Confluence.
  2. Klik Foto profil Anda di pojok kanan atas layar.
  3. Pilih Setelan (atau Setelan akun) dari menu.
  4. Di tab Security, buka bagian API tokens.
  5. Klik tombol Create API token with scopes. Jangan gunakan token tanpa cakupan karena token tersebut tidak akan mengambil semua alat yang diperlukan.
  6. Berikan nama deskriptif (misalnya, enrichment-agent), konfigurasikan tanggal habis masa berlaku, lalu klik Next.
  7. Dalam daftar Select the app, pilih opsi Atlassian MCP, lalu klik Next.
  8. Pilih semua cakupan baca dan penelusuran Confluence berikut:
    • 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. Klik Next, lalu klik Create.
  10. Salin token yang dihasilkan.
  11. Format string kredensial untuk penyedia autentikasi Google Cloud sebagai <ATLASSIAN_EMAIL>:<API_TOKEN>. Atlassian memerlukan encoding autentikasi dasar HTTP (email:api_token) untuk menggunakan token API pribadi secara terprogram.
  12. Daftarkan penyedia autentikasi kunci API di Google Cloud dan berikan string <ATLASSIAN_EMAIL>:<API_TOKEN> sebagai kunci API. Lihat Melakukan autentikasi menggunakan kunci API dengan pengelola autentikasi.

Untuk mengetahui informasi selengkapnya tentang cara membuat PAT, lihat Manage API tokens for your Atlassian account dalam dokumentasi Atlassian.

Langkah berikutnya