Menghubungkan aplikasi

API perusahaan Anda

Biarkan AI memakai sistem milik perusahaan Anda lewat web API-nya dengan kunci, atau masuk dengan aplikasi yang Anda buat di layanan itu, seperti NAVER WORKS, langkah demi langkah.

Perusahaan Anda mungkin punya sistem sendiri: pelacak proyek, sistem pesanan, alat internal. Jika sistem itu punya web API, AI bisa memakainya. Owner atau admin menambahkannya sekali di Admin › Aplikasi terhubung, dengan alamatnya, sebuah kunci, dan beberapa baris tentang cara memakainya. Setelah itu AI hanya bisa memanggil alamat di bawah alamat tersebut.

Beberapa layanan, seperti NAVER WORKS, tidak memberikan kunci: orang masuk lewat aplikasi masuk yang dibuat perusahaan Anda di layanan itu. Itu dibahas di paruh kedua halaman ini.

Anda memerlukan orang yang memahami sistem itu (admin atau pengembangnya) untuk nilai-nilai di bawah. Tidak ada yang memerlukan kode di sini.

#Menghubungkan API dengan kunci

Tips

Yang Anda perlukan

  • Alamat: alamat dasar API, misalnya https://pm.acme.example/api/v1. Tanyakan ke admin sistem itu, atau cari di dokumentasi API-nya ("base URL").
  • Kunci: kunci API atau token untuk sistem itu. Buat satu khusus untuk Trina AX, dengan hak tidak lebih dari yang diperlukan AI.
  • Header untuk kunci: sebagian besar API menerima Authorization: Bearer <key>. Jika dokumentasi API menyebut header lain, seperti X-API-Key, catat namanya persis.
  • Catatan pemakaian: beberapa baris tentang alamat mana yang sebaiknya dipanggil AI. Dokumentasi API sistem itu memuatnya.
  1. Buka dialognya

    Di Admin › Aplikasi terhubung, pilih Tambahkan lewat alamatnya di bawah Jelajahi. Buka Lanjutan lalu atur Jenis ke API dan Cara masuk ke Kunci API.

  2. Isi kolom-kolomnya
    • Nama: nama yang dilihat orang di chat, misalnya "AI PM".
    • Alamat: alamat dasarnya. AI hanya bisa memanggil jalur di bawahnya.
    • Header untuk kunci: biarkan Authorization: Bearer (bawaan), atau pilih Header lain dan ketik Nama header persis seperti yang tertulis di dokumentasi.
    • Kunci: tempel kuncinya.
    • Catatan pemakaian: jalur utama, nilai yang diperlukan, dan apa pun yang tidak boleh dilakukan AI. Paling banyak 4.000 karakter.
    API dengan kunci
  3. Pilih siapa yang boleh memakainya, lalu simpan

    Untuk: Semua orang di tim · Ubah memilih grup atau orang. Biarkan Menulis, menghapus, dan mengirim pada Selalu tanya untuk awalnya. Pilih Simpan: Trina AX memeriksa alamat dan kuncinya, dan barisnya menampilkan Terhubung.

Catatan pemakaian yang baik terlihat seperti ini:

List projects with GET /projects.
Create a task with POST /tasks and a JSON body {"projectId", "title", "dueDate"}.
Dates are YYYY-MM-DD. Never call DELETE.

AI membaca catatan ini setiap kali memakai API, jadi buat singkat dan tepat.

#Masuk dengan aplikasi Anda sendiri

Beberapa layanan mengizinkan orang masuk (OAuth) tetapi hanya lewat aplikasi yang terdaftar di layanan itu: NAVER WORKS, dan MCP server milik Google sendiri. Anda membuat aplikasi itu sekali di konsol pengembang layanan tersebut, lalu menempelkan nilainya ke Trina AX. Biasanya Anda menambahkannya sebagai templat, agar setiap anggota masuk dengan akunnya sendiri.

Tips

Yang Anda perlukan, dari konsol pengembang layanan itu

  • Client ID dan Client secret dari aplikasi yang Anda buat di sana.
  • Alamat login dan Alamat token (untuk API; MCP server menemukannya sendiri).
  • Cakupan (scope): izin yang diperlukan AI, dipisahkan dengan spasi.

Yang Anda berikan ke layanan itu

  • Alamat pengalihan yang ditampilkan Trina AX: https://<your team address>/api/integrations/oauth/callback.
  1. Buka dialognya di Trina AX lebih dulu

    Di Admin › Aplikasi terhubung, pilih Tambahkan lewat alamatnya, buka Lanjutan, atur Siapa yang menghubungkan ke Milik tiap anggota, Jenis ke API (atau Server MCP), dan Cara masuk ke Masuk (OAuth). Untuk MCP server, nyalakan juga Login dengan aplikasi saya. Dialog sekarang menampilkan Alamat pengalihan untuk didaftarkan di aplikasi Anda pada layanan dengan tombol salin. Salin alamat itu.

  2. Buat aplikasinya di layanan

    Di konsol pengembang layanan itu, buat aplikasi (mungkin disebut "OAuth app", "client", atau "integration"). Tempel alamat pengalihan di bagian redirect URL-nya, pilih cakupannya, lalu salin Client ID dan Client secret-nya.

  3. Isi sisanya dan simpan

    Kembali di Trina AX, isi Nama, Alamat, Client ID, Client secret, Alamat login dan Alamat token (untuk API), serta Cakupan (scope). Pilih Buat templat. Anggota lalu melihatnya di Pengaturan › Konektor dan masuk dengan akunnya sendiri.

    Masuk dengan aplikasi Anda sendiri
Di Trina AXNilai
JenisAPI
Alamathttps://www.worksapis.com/v1.0
Alamat loginhttps://auth.worksmobile.com/oauth2/v2.0/authorize
Alamat tokenhttps://auth.worksmobile.com/oauth2/v2.0/token
Client ID, Client secretDari aplikasi Anda di NAVER WORKS Developer Console
Cakupan (scope)Yang diperlukan AI, misalnya calendar mail file user.read
Catatan pemakaianAlamat API yang sebaiknya dipanggil AI, dari dokumentasi API NAVER WORKS

Di NAVER WORKS Developer Console, buka aplikasi Anda (atau tambahkan di bawah API 2.0), atur Redirect URL-nya ke alamat yang ditampilkan Trina AX, centang OAuth Scopes yang sama, lalu salin Client ID dan Client Secret. NAVER WORKS menjelaskan proses masuknya di panduan OAuth miliknya.

#MCP server milik Google

Google juga menyediakan MCP server untuk Gmail, Calendar, Drive, dan lainnya (https://gmailmcp.googleapis.com/mcp/v1 dan sejenisnya), dalam program pratinjau Google. Server ini memerlukan aplikasi masuk Google milik Anda sendiri, yang dibuat seperti di Aplikasi Google milik perusahaan Anda tetapi dengan alamat pengalihan di atas. Untuk pemakaian sehari-hari, aplikasi Google bawaan tidak memerlukan aplikasi milik Anda sendiri.

#Masalah

Yang Anda lihatYang perlu dilakukan
Layanan tidak menerima Client ID atau Secret aplikasi ini.Client ID atau secret tersalin keliru, atau secret diperbarui di layanan. Edit koneksinya, masukkan lagi secret di bawah Lanjutan, lalu masuk lagi.
Layanan mengatakan alamat pengalihan salah (redirect_uri_mismatch, "invalid redirect")Redirect URL di konsol layanan berbeda dari yang ditampilkan Trina AX. Salin lagi dengan tombol salin; periksa https, alamat tim, dan pastikan tidak ada garis miring di akhir.
Client secret yang tersimpan tidak ikut ke alamat baru. Masukkan lagi.Anda mengubah alamat atau alamat login. Demi keamanan, secret tidak dipakai ulang: tempel lagi.
Panggilan menjawab 401 atau 403Kunci kedaluwarsa, kekurangan izin, atau tersalin dengan spasi. Buat kunci baru, atau tambahkan cakupan yang kurang di layanan lalu masuk lagi.
AI memanggil jalur yang salahBuat Catatan pemakaian lebih tepat: cantumkan setiap jalur beserta metodenya.

Detail lengkap untuk pengembang: Integrations (bahasa Inggris).

Trina AX adalah perangkat lunak bebas dengan lisensi AGPL-3.0-only. Ikon: Lucide (ISC). Edit halaman ini