Agents API genel bakış
ajan workspace'inizde agent'ları programatik olarak oluşturun, yönetin ve sohbet edin
Agents API, ajan workspace'inizde agent'ları programatik olarak oluşturmanızı, yönetmenizi ve onlarla sohbet etmenizi sağlar. Completions endpoint'i Vercel AI SDK uyumlu mesaj biçimini kullanır; böylece agent'ları useChat hook'u ve diğer Vercel AI SDK özellikleriyle kullanabilirsiniz.
Başlamadan önce
- API key scope: Agent endpoint'leri Agent API kapsamına sahip bir API anahtarı gerektirir. Attachment endpoint'leri
KNOWLEDGE_FOLDER_APIkapsamı gerektirir. - Agent access: Mevcut bir agent'ı bir API anahtarıyla kullanmak için agent o anahtarla paylaşılmış olmalıdır. Bkz. Sharing Agents with API Keys.
- Legacy Assistants API: Bu, yerel Vercel AI SDK uyumluluğuna sahip yeni Agents API'dir. Eski Assistants API kullanıyorsanız migration guide sayfasına bakın.
Base URL
https://api.ajan.ioDedicated deployments Tüm isteklerde
api.ajan.com'u/api/publicile değiştirin.
Kullanılabilir endpoint'ler
Agents
| Method | Endpoint | Description |
|---|---|---|
POST | /agent/v1/chat/completions | Create a model response for an agent |
GET | /agent/v1/get | Get agent details |
POST | /agent/v1/create | Create a new agent |
PATCH | /agent/v1/update | Update an agent |
POST | /agent/v1/publish | Publish an agent's draft |
PATCH | /agent/v1/disable | Enable or disable an agent |
GET | /agent/v1/models | List available models |
Attachments
| Method | Endpoint | Description |
|---|---|---|
POST | /attachment/v1/upload | Upload files for agents |
DELETE | /attachment/v1/delete | Delete an uploaded attachment |
Kılavuzlar
- Sharing Agents with API Keys: API anahtarı oluşturun ve bir agent'ı onunla paylaşın
- Agent Migration Guide: Agents API ile agent'ları workspace'ler arasında taşıyın