# Ikhtisar

> Apa itu sideagent dan dua cara menjalankannya: library open source atau sideagent Cloud.

Source: https://sideagent.dev/id/docs

sideagent meng-embed chat agent di aplikasi Anda. Anda memberinya OpenAPI spec serta host LLM yang kompatibel dengan OpenAI beserta API key-nya. Sebagai gantinya, Anda mendapatkan endpoint agent yang aman dan React chat UI. Agent memanggil API Anda atas nama pengguna yang sedang masuk, dengan kredensial milik pengguna itu sendiri.

## Dua cara menjalankannya

- **sideagent** (open source, MIT): library TypeScript yang Anda jalankan di server Anda sendiri. Lihat [Server](https://sideagent.dev/id/docs/server.md) dan [Chat UI](https://sideagent.dev/id/docs/chat-ui.md).
- **sideagent Cloud**: agent yang sama, di-hosting untuk Anda. Anda mengonfigurasinya di dasbor dan meng-embed-nya dengan publishable key. Lihat [sideagent Cloud](https://sideagent.dev/id/docs/cloud.md).

## Alur sebuah request

1. Browser mengirim pesan chat ke endpoint agent, beserta header `Authorization` milik pengguna.
2. Server memverifikasi pengguna ([User authentication](https://sideagent.dev/id/docs/auth.md)) dan memuat agent.
3. Model memilih operation dari allowlist Anda ([Operations](https://sideagent.dev/id/docs/operations.md)).
4. Panggilan yang mengubah data berhenti sejenak untuk menunggu approval pengguna ([Approvals](https://sideagent.dev/id/docs/approvals.md)).
5. Panggilan yang diizinkan dikirim ke API Anda dengan kredensial milik pengguna, dan hasilnya dialirkan kembali ke chat.

## Langkah selanjutnya

- Baru mengenal sideagent: [Quickstart](https://sideagent.dev/id/docs/quickstart.md).
- Penyiapan ter-hosting, tanpa kode server: [sideagent Cloud](https://sideagent.dev/id/docs/cloud.md).
- Apa yang melindungi Anda dan pengguna Anda: [Security model](https://sideagent.dev/id/docs/security.md).
- Membangun klien sendiri: [Wire protocol](https://sideagent.dev/id/docs/protocol.md).

## Untuk LLM dan tool

Setiap halaman di sini juga tersedia sebagai Markdown: tambahkan `.md` ke URL halaman, misalnya `/id/docs/quickstart.md`. [`/llms.txt`](https://sideagent.dev/llms.txt) mendaftar semua halaman (dalam bahasa Inggris). [`/llms-full.txt`](https://sideagent.dev/llms-full.txt) berisi seluruh dokumentasi bahasa Inggris dalam satu file.