Memulai
Quickstart
Install sideagent, pasang agent pada satu route, dan tampilkan chat di React.
Di halaman ini
Install paketnya:
npm i sideagent
Buat agent di server Anda dan pasang handler-nya pada satu route:
import { createAgent, honoHandler } from "sideagent/server";
const agent = await createAgent({
spec: "https://api.example.com/openapi.json",
baseUrl: "https://api.example.com",
llm: { baseUrl: "https://api.openai.com/v1", apiKey: process.env.LLM_API_KEY!, model: "gpt-4o-mini" },
allow: ["listInvoices", "createInvoice"],
allowedOrigins: ["https://app.example.com"],
getAuth: (req) => ({
userId: "user-123",
headers: { authorization: req.headers.get("authorization")! },
}),
});
app.on(["POST", "OPTIONS"], "/agent", honoHandler(agent));
Tampilkan chat di aplikasi React Anda:
import { AgentChat } from "sideagent";
<AgentChat endpoint="/agent" mode="floating" />
Coba tanpa API key
Clone repositorinya dan jalankan pnpm demo. Perintah ini menjalankan API faktur tiruan, agent dengan LLM tiruan, dan UI-nya.
Langkah berikutnya
- Sesuaikan opsinya: Server.
- Tentukan apa yang boleh dipanggil model: Operations dan allowlist.
- Ganti
userIdyang ditulis langsung di kode: User authentication. - Tanpa server sendiri: sideagent Cloud.
