Skills & eksekusi kode

segera Belum dibuka. Endpoint Skills (/v1/skills) dan eksekusi kode belum tersedia. Hari ini request yang memakai tool code_execution_*, parameter container, atau shell dengan container hosted ditolak 400 (unsupported_tool / unsupported_parameter), dan capabilities.code_execution serta capabilities.skills di GET /v1/models bernilai false. Halaman ini menjelaskan bentuk yang direncanakan supaya kamu bisa siap-siap; detailnya bisa berubah sebelum dibuka.

Eksekusi kode akan berjalan di sandbox milik Ngoding, tidak diteruskan ke container pihak lain. Skill adalah paket file berisi instruksi dan skrip yang bisa dipakai model saat menjawab, misalnya konverter dokumen internal atau linter gaya penulisanmu.

Sandbox

• Setiap container terisolasi dan tanpa akses jaringan keluar.
• Batas per container: 1 vCPU, 2 GiB RAM, 5 GiB disk. Satu perintah maks 120 detik.
• Container yang menganggur 30 menit diarsipkan; umur maksimal 4 jam.
• Image dasar: Python 3.12 dengan pustaka umum untuk dokumen dan data.
• File keluaran disimpan ke Files milikmu dan dikembalikan sebagai file_id.

Format yang direncanakan

• Messages: code_execution_20250825 dan versi sesudahnya, dengan sub-tool bash_code_execution dan text_editor_code_execution; blok hasil mengikuti dokumentasi Anthropic. code_execution_20250522 hanya Python.
• Responses: code_interpreter (item code_interpreter_call) dan shell dengan container_auto (shell_call / shell_call_output).
• Loop-nya sama dengan server tools: api menjalankan tool, lalu mengeluarkan blok standar tiap format.

Skills API (direncanakan)

• POST /v1/skills: unggah multipart field files[] dan display_title; wajib ada SKILL.md di akar paket.
• GET /v1/skills: daftar skill milikmu.
• GET /v1/skills/{id} dan DELETE /v1/skills/{id}: detail dan hapus.
• POST /v1/skills/{id}/versions dan GET /v1/skills/{id}/versions: buat dan daftar versi. GET / DELETE /v1/skills/{id}/versions/{version} untuk satu versi.
• Objek mengikuti bentuk Anthropic (type: "skill", source: "custom", latest_version, created_at, updated_at).

Memakai skill (direncanakan)

Pada request Messages, cantumkan skill kustom plus tool eksekusi:

{
  "model": "claude-opus-5-5",
  "max_tokens": 512,
  "container": {
    "skills": [{ "type": "custom", "skill_id": "skill_01JABCD", "version": "latest" }]
  },
  "tools": [{ "type": "code_execution_20250825", "name": "code_execution" }],
  "messages": [{ "role": "user", "content": "Rapikan tabel di laporan.docx" }]
}

Aturan main:

• Skill kustom milikmu dipasang read-only di /skills/<nama> di dalam sandbox. Nama dan deskripsi dari SKILL.md ditambahkan ke instruksi sistem, lalu model membaca isinya lewat bash, seperti mekanisme Anthropic.
• Skill bawaan Anthropic (type: "anthropic", mis. pptx, xlsx) → 400. Berkasnya tidak boleh didistribusikan ulang, jadi baru tersedia bila ada pengganti milik kami.
• container berisi id sandbox milikmu. Container milik akun lain → 404.

Tagihan container (direncanakan)

• Per container: ceil(jam aktif) × tarif resmi per jam × multiplier region, hasilnya dalam credit. Jam aktif = last_seen_at − created_at, minimal 1 jam, dihitung saat container kedaluwarsa atau berganti.
• Token input/output tetap ditagih per token seperti biasa, di atas biaya jam container.
• Tarif per jam diterbitkan sebelum fitur dibuka. Selama tarif belum ada, semua request container tetap 400; container tidak pernah jalan gratis.

Contoh: container aktif 20 menit → ditagih 1 jam. Aktif 1 jam 5 menit → ditagih 2 jam. Lihat dasar harga di Credit & harga.