Penulisan AI dan autopost

Hanya draf

Setiap aksi AI menyimpan hasilnya sebagai revisi draf baru dari sebuah entri, bertanda sumber ai. Tidak ada yang diterbitkan, dijadwalkan, atau disetujui oleh panggilan AI. Seseorang membuka draf, membaca diff, lalu memutuskan.

Model tidak punya tool sendiri. Ia tidak bisa memanggil API Anda, menjelajah, atau menulis sendiri. ATLAS memvalidasi apa yang dikembalikan, dan menolak jawaban dengan bentuk yang salah, memakai block atau media yang tidak dimiliki entri, berisi tautan tidak aman, atau memakai kata dari daftar terlarang Anda. Jawaban yang ditolak tidak menyimpan apa pun.

Ada satu pengecualian yang harus dinyalakan admin: autopost dengan terbit otomatis (lihat bagian Autopost di bawah). Semua aksi manual tetap hanya draf.

Aksi pada entri

Panggilan ini butuh sesi dashboard yang sedang masuk dan header X-Brand-Id. Anggota mana pun yang boleh mengedit entri bisa menjalankannya, dan tipe konten dengan min_role lebih tinggi tetap memblokir peran yang lebih rendah.

Menulis atau menulis ulang halaman. Body berisi brief (3 sampai 4000 karakter) dan mode: draft, rewrite, atau continue.

{
  "brief": "A short intro to our repair service for small shops.",
  "mode": "draft"
}

Jawabannya 201 dengan data.run (run AI), data.revision (draf baru), dan data.diff (diff kata terhadap versi sebelumnya).

Body dan izin yang sama, dijawab sebagai server sent events. Anda menerima potongan event: delta berisi {text} (JSON mentah yang dihasilkan model), lalu event: done berisi {data: {run, revision, diff}} setelah draf tersimpan, atau event: error berisi {status, message}. Bacalah dengan fetch dan stream reader: EventSource tidak bisa mengirim POST.

Membuat terjemahan entri sebagai draf. Body berisi locale tujuan (salah satu bahasa lain milik brand) dan path opsional. Jawabannya juga membawa entry yang baru.

Menyarankan judul dan deskripsi SEO sebagai revisi draf. Tanpa body.

Melihat gambar pada entri dan mengembalikan saran teks alt di run AI (201, data.run). Belum ada yang masuk ke pustaka media.

Editor menerima saran dari run teks alt yang sudah selesai, dan baru saat itu teks alt disimpan pada aset media. Butuh izin membuat media.

Gaya brand dan kuota

Anggota mana pun bisa membaca profil AI. Admin menyimpannya dengan PUT /v1/manage/ai/profile. Penulis AI memakainya di setiap panggilan.

Mengembalikan used_tokens, quota, remaining, cost, dan runs bulan ini. Sebelum setiap panggilan, ATLAS menahan estimasi dari kuota lalu menyelesaikannya sesudahnya, sehingga dua panggilan bersamaan tidak bisa melampaui kuota. Jika tidak ada sisa, panggilan ditolak dengan 429.

GET /v1/manage/ai/runs mendaftar run AI (hanya admin, 50 per halaman, filter feature dan status). Setiap run mencatat fitur, model, token, biaya, status, dan diff.

Arti kode error

Endpoint streaming mengirim kode yang sama di event: error.

Provider

ATLAS bertanya ke Gemini lebih dulu. Jika provider itu gagal atau tidak punya key, ATLAS mencoba OpenRouter. Provider tanpa key dilewati. Anda tidak memilih model per permintaan, dan tidak bisa membawa key sendiri di dashboard: operator instalasi yang mengonfigurasi provider. Key tidak pernah dikembalikan atau dicatat di log.

Autopost

Autopost menulis artikel baru untuk Anda sesuai jadwal. Admin menyalakannya per brand.

Anggota mana pun bisa membaca pengaturannya. Admin menyimpannya dengan PUT /v1/manage/ai/autopost/settings.

{
  "enabled": true,
  "auto_publish": false,
  "content_type_key": "post",
  "term_id": null,
  "locale": "en",
  "posts_per_day": 2,
  "hours": ["09:00", "15:00"],
  "topic_source": "both",
  "topics": ["How to choose a laptop for your shop"],
  "trends_geo": "ID",
  "trends_keywords": ["laptop"],
  "cover_image": true,
  "author_id": 12
}

• content_type_key saat ini hanya bisa post.
• posts_per_day bernilai 1 sampai 24. hours berisi 1 sampai 24 slot berformat HH:MM dalam zona waktu brand.
• topic_source adalah manual, trends, atau both. Daftar manual atau campuran butuh minimal satu topik (hingga 500). Dengan trends, ATLAS mengambil dari topik tren yang tersimpan untuk trends_geo, opsional disaring dengan trends_keywords (hingga 20).
• cover_image membuat satu gambar sampul dan menjadikannya gambar sosial artikel. Jika gambar gagal, artikel tetap tersimpan.
• author_id harus anggota aktif brand.

Setiap slot yang jatuh tempo menulis satu artikel baru. Artikel direncanakan lalu ditulis bagian demi bagian, jadi satu run memakan beberapa menit dan menghabiskan puluhan ribu token dari kuota Anda. Artikel yang terlalu pendek ditolak. Slot yang gagal dicoba lagi setelah sepuluh menit.

Secara default artikel disimpan sebagai draf dan permintaan tinjauan dibuka untuk publisher Anda. Mereka menyetujuinya seperti tinjauan lain.

GET /v1/manage/ai/autopost/runs mendaftar slot terbaru dengan topic, status (pending, success, failed), reason singkat, dan entry_id.

Admin bisa mengantrekan satu slot sekarang (10 per menit). Jawabannya 202 berisi {"data": {"queued": true}}. Autopost yang mati dijawab 422.

Instalasi juga menjalankan perintah atlas:ai-autopost setiap menit, yang mengambil slot jatuh tempo untuk setiap brand yang aktif.

Terbit otomatis

Satu-satunya pengecualian

auto_publish mati secara default dan hanya admin yang bisa menyalakannya. Saat menyala, autopost menerbitkan artikel yang baru ditulisnya lewat jalur terbit yang normal, sebagai aktor sistem dengan penulis yang Anda pilih, dan menulis baris audit (autopost.published). Langkah tinjauan dilewati. Biarkan mati kecuali Anda siap menayangkan teks AI yang belum ditinjau di situs Anda.

Perubahan pada pengaturan autopost diaudit sebagai autopost.settings_updated.

Backfill

Mengisi judul SEO, deskripsi, dan teks alt gambar yang kosong pada entri Anda yang sudah terbit, hanya sebagai draf. Hanya admin (3 per menit) dan butuh pengaturan brand ai_backfill menyala, jika tidak dijawab 409 backfill_disabled. limit opsional (1 sampai 50, default 10).

Jawabannya {data: {entries, totals, stopped, next_cursor}}. Run berhenti saat kuota hampir habis, saat mencapai limit, setelah sekitar 25 detik, atau setelah tiga kegagalan provider. Kirim next_cursor kembali sebagai after untuk melanjutkan. Entri yang sudah punya draf lebih baru dilewati. Teks alt tetap berupa saran sampai editor menerimanya.

Untuk peran dan tinjauan, lihat peran dan izin. Untuk agen yang memanggil ATLAS dari luar, lihat MCP dan akses agen.