Task API
Buka di CMSLayar Task API memungkinkan sistem Anda sendiri menjalankan agent ini sebagai pelaksana satu tugas: kirim satu input lewat REST dengan API key dan terima hasil lengkapnya di response. Ada di sidebar agent pada Channels → Task API. Fitur ini hanya untuk service agent; di personal agent, kontrolnya tetap mati.
Halaman ini punya tiga tab: Access, Settings, dan Test. Switch dan key langsung berlaku. Perubahan di tab Settings berlaku untuk task baru beberapa detik setelah disimpan, tanpa publish. Panggilan menjalankan agent yang sudah di-publish, jadi perubahan pada agent itu sendiri berlaku setelah Anda publish agent.
Tab Access
| Switch API | Mati secara default. Jika mati, setiap panggilan ditolak, meskipun key-nya valid. Mematikannya berlaku dalam hitungan detik. |
| Endpoint | Alamat tujuan sistem Anda mengirim tugas (POST), dengan ID agent ini sudah terisi. |
| Contoh kode | Contoh siap pakai dalam Node.js, C#, Python, dan Java. |
| Keep the key on your server | Panggil API hanya dari back-end Anda sendiri, jangan pernah dari browser atau aplikasi mobile. |
Key Primary dan Secondary
Dua slot, supaya Anda bisa merotasi key tanpa downtime.
| Create key | Membuat key yang diawali qta_. Pilih Expiry: 7, 14, 30, 90, 180, atau 365 hari, atau tanpa expiry. |
| Copy your new key | Ditampilkan satu kali setelah key dibuat. Salin sebelum menutup: key tidak bisa ditampilkan lagi. |
| Revoke | Menghentikan key dalam hitungan detik. Key yang sudah dicabut tidak bisa dinyalakan lagi. |
Tab Settings
| Additional prompt | Instruksi tugas yang ditambahkan ke setiap panggilan, maksimal 20.000 karakter. Instruksi ini diutamakan jika bertentangan dengan instruksi agent lainnya. input di request adalah data yang dikerjakan. |
| Response format | Markdown (default), Plain text (tanpa Markdown), JSON (satu objek JSON, juga dikembalikan dalam bentuk ter-parse di result), atau JSON schema (satu objek yang harus sesuai dengan schema Anda; divalidasi, dengan satu kali percobaan perbaikan otomatis). |
| JSON schema | Muncul untuk format JSON schema. Root harus "type": "object", maksimal 20.000 karakter. Generate from example membuat schema dari contoh JSON. Lihat Format response untuk keyword yang didukung. |
| Include personality | Menambahkan kepribadian agent ke instruksi tugas. Mati secara default. |
| Include interaction style | Menambahkan gaya interaksi agent. Mati secara default. |
| Include mission | Menambahkan misi agent. Menyala secara default. |
| Use knowledge | Mengizinkan agent mencari di knowledge-nya. Menyala secara default. |
| Use tools | Mengizinkan agent memakai plugin, MCP server, custom API, web search, dan skill. Menyala secara default. |
| Keep tasks for | 7, 30 (default), atau 90 hari. Percakapan tugas dihapus setelah periode ini. |
Tab Test
Menjalankan tugas dari CMS tanpa key, pada draf agent, memakai pengaturan sebagaimana adanya di form (juga sebelum disimpan). Pengujian dikenai biaya seperti chat di Preview.
| Input | Data untuk tugas, seperti input di request. |
| Output | Hasil dalam bentuk teks. |
| Result | Objek JSON yang sudah di-parse, untuk format JSON dan JSON schema. |
| Validation | Apakah hasil sesuai dengan schema, dan bagian mana yang tidak sesuai. |
| Tools called | Tool yang dipakai agent selama tugas. |
| Repair | Apakah perbaikan otomatis dibutuhkan agar sesuai dengan schema. |
Panduan terkait: Task API