> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Akses Agen AI: Biarkan Agen AI Pengguna Bertindak untuk Mereka

> Didit memungkinkan pengguna menyetujui agen AI mereka bertindak atas nama mereka dalam sesi terbatas yang berakhir otomatis dan dapat dicabut.

Akses agen di Didit Authentication memungkinkan pengguna aplikasi Anda menyetujui agen AI mereka sendiri untuk bertindak atas nama mereka.
Pengguna melihat apa yang diminta agen, menyetujuinya, lalu agen mendapatkan sesi terbatas miliknya sendiri yang berakhir secara otomatis dan dapat dicabut kapan saja oleh pengguna atau tim Anda.
Backend Anda membedakan permintaan agen dari permintaan pengguna melalui klaim `act` di dalam token.

Akses agen sudah termasuk di setiap paket, tanpa biaya terpisah.

## Cara kerjanya

1. Agen AI meminta untuk bertindak atas nama seseorang di aplikasi Anda, dengan menyebutkan scope yang dibutuhkannya.
2. Orang tersebut masuk di layar persetujuan yang di-hosting oleh aplikasi Anda, atau di layar persetujuan Anda sendiri, lalu melihat nama agen, apakah agen itu telah diverifikasi, dan scope yang diminta.
3. Orang tersebut dapat mempersempit permintaan (scope lebih sedikit, sesi lebih singkat, atau hanya sebagian [organisasi](https://docs.didit.me/id/authentication/organizations.md)-nya), lalu menyetujuinya, dengan passkey baru jika pengaturan Anda memintanya.
4. Agen menerima satu kode sekali pakai dan menukarkannya dengan token miliknya sendiri. Token aksesnya berlaku paling lama 5 menit, sama seperti token milik seseorang.
5. Setiap permintaan yang dikirim agen ke backend Anda membawa token yang klaim `act`-nya menyebutkan agen dan scope yang disetujui orang tersebut.

Sesi agen berakhir saat masa berlakunya habis, setelah batas waktu tidak aktif Anda terlampaui, atau saat orang tersebut atau tim Anda mencabutnya.

## Aktifkan dan pilih aturannya

Akses agen nonaktif untuk aplikasi baru.
Aktifkan di **Authentication > Agent access**, lalu pilih **Edit settings**:

| Pengaturan | Opsi | Default |
| - | - | - |
| Apa yang dapat dilakukan agen | **Read only** (`read`): melihat informasi akun pengguna. **Acts for them** (`act`): mengubah pengaturan dan preferensi akun pengguna. | Tidak ada sampai Anda memilih |
| Agen mana yang boleh meminta | Saat ini agen mana pun dapat meminta, dan layar persetujuan menampilkan apakah agen tersebut terverifikasi. Hanya mengizinkan agen terverifikasi belum tersedia. | Agen mana pun |
| Berapa lama sesi berlangsung | 1, 7, atau 30 hari. | 7 hari |
| Berakhir saat tidak aktif selama | 30 menit, 2 jam, atau 24 jam. | 2 jam |
| Cara pengguna menyetujui | **A passkey**, atau **Their usual sign-in**. | A passkey |
| Hanya pengguna yang menyetujui permintaan agen | Setiap persetujuan memerlukan asersi baru dari passkey milik pengguna yang menyetujui. | Nonaktif |

Pengguna hanya dapat menonaktifkan cakupan yang Anda tawarkan di layar persetujuan, tidak dapat mengaktifkannya.
Perubahan berlaku untuk persetujuan baru: sesi agen yang aktif tetap menggunakan apa yang sudah disetujui pengguna.

**Hanya pengguna yang menyetujui permintaan agen** (`agent_humans_only`) hanya dapat diubah oleh Owner atau Admin organisasi Didit Anda, yang terlebih dahulu memerlukan passkey pada akun konsol mereka sendiri.
Pengaturan ini membuktikan bahwa pengguna yang menyetujui menggunakan autentikator miliknya sendiri dengan verifikasi pengguna, dalam lima menit dan terikat pada permintaan tersebut. Pengaturan ini tidak mendeteksi otomatisasi secara umum.
Untuk layar persetujuan Anda sendiri, panggilannya terdapat di [persetujuan agen dengan passkey](https://docs.didit.me/id/authentication/sign-in-methods.md#persetujuan-agen-dengan-passkey).

## Tambahkan ke aplikasi Anda

Agen yang mendukungnya akan mengarahkan pengguna ke layar persetujuan Anda secara mandiri.
Aplikasi Anda melakukan dua hal:

**Biarkan pengguna melihat dan mencabut agen mereka.**
Di React, render `<ConnectedAgents />` pada halaman pengaturan akun: komponen ini menampilkan daftar agen yang disetujui pengguna, masing-masing dengan tombol **Revoke**.
Lihat [React quickstart](https://docs.didit.me/id/authentication/quickstarts/react.md).

**Periksa klaim `act` di backend Anda.**
Token akses agen ditandatangani dengan kunci yang sama dan memiliki `typ`, `iss` dan `aud` yang sama dengan token pengguna, sehingga hanya `act` yang membedakannya:

| `act` | Siapa yang memanggil | Yang diizinkan |
| - | - | - |
| `null` | Pengguna. | Hanya yang boleh dilakukan pengguna. |
| `{"sub", "agent", "scopes"}` | Agen AI yang bertindak atas nama pengguna. | Hanya tindakan yang diizinkan oleh `act.scopes`, pada rute yang Anda buka untuk agen. Tolak di semua tempat lain. |

`sid` pada token agen adalah ID akses yang diberikan pengguna, dan `GET /session/` selalu menolak token agen.
Lihat [verifikasi token di server Anda](https://docs.didit.me/id/authentication/tokens-and-jwks.md#verifikasi-token-di-server-anda) untuk pemeriksaan dalam kode.

## Pantau dan cabut di konsol

**Authentication > Agent access** menampilkan:

* **At a glance:** sesi agen yang aktif, sesi yang disetujui pengguna dalam 7 hari terakhir, pengguna yang memiliki agen, dan pencabutan bulan ini, menurut pengguna dan menurut tim Anda.
* **Active agent sessions:** setiap pengguna, agen beserta deskripsinya dan apakah agen tersebut diverifikasi, apa yang dapat dilakukannya, aktivitas terakhirnya, dan kapan sesinya berakhir, dengan tombol **Revoke**.

![Halaman Agent access di Didit Business Console, dengan pengaturan agen, metrik utama, dan sesi agen aktif beserta tombol Revoke](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-agent-access.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=7cc518e37e2ccafa5515eb22e6ef9b8d)

Authentication > Agent access.

Mencabut akses akan langsung mengakhiri sesi agen, dan Anda dapat mengirim email kepada pengguna untuk memberitahukan bahwa sesinya telah diakhiri.
Tim Anda juga dapat mengakhiri semua sesi agen milik satu pengguna: memblokir pengguna, mereset MFA-nya, atau mencabut sesinya dari **Users** juga mencabut akses agennya.

## Email dan event

Ketika tim Anda mencabut akses agen dari konsol, Anda dapat memilih untuk mengirim email kepada pengguna tersebut yang memberitahukan bahwa aksesnya telah dihentikan.
Email tersebut menggunakan merek Anda, sama seperti setiap [email login](https://docs.didit.me/id/authentication/branding-and-custom-domain.md#sign-in-emails).

Persetujuan dan pencabutan dicatat sebagai event `security.agent_access_approved` dan `security.agent_access_revoked` pada linimasa pengguna.
Didit mencatat persetujuan saat pengguna memberikan persetujuan, meskipun agen tidak pernah menukar kodenya.
Lihat [audit persetujuan agen](https://docs.didit.me/id/authentication/events-and-webhooks.md#audit-persetujuan-agen).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.