Entri dan Pendaftaran

activate(api)

Fungsi yang diekspor oleh file entri Anda. Cowork memanggilnya sekali setiap kali menjalankan proses Extension.

export function activate(api) {
  api.registerService({ id: 'sync', start: 'auto', async run(ctx) { /* ... */ } });
  return () => { /* optional cleanup */ };
}

Parameter

Nama	Tipe	Deskripsi
api	DozinAPI	Fungsi-fungsi pendaftaran di bawah ini

Nilai kembalian

Tidak ada, atau fungsi pembersihan (boleh async), atau promise dari salah satunya. Fungsi pembersihan berjalan saat proses berhenti dan harus aman dipanggil lebih dari sekali.

Batasan

• activate punya waktu 5 detik. Jalankan timer dan koneksi di start milik Connector atau run milik tugas, bukan di sini.
• Jika melempar error atau melewati batas waktu, Extension ditampilkan gagal di Pengaturan › Ekstensi.

api.registerConnector(definition)

Mendaftarkan Connector: bagian yang mengirim dan menerima pesan antara kanal luar dan Gateway Cowork.

Parameter

Nama	Tipe	Wajib	Deskripsi
definition	ConnectorDefinition	Ya	Lihat Connector

Nilai kembalian

Tidak ada.

Melempar

Error	Kapan
TypeError	start, stop, atau send tidak ada; id bukan huruf kecil, angka, dan tanda hubung; systemPrompt lebih dari 4000 karakter; chat tidak valid
CapabilityDeniedError	Dipanggil setelah activate selesai; dozin.connectors mencantumkan ID dan id ini tidak termasuk di dalamnya; id yang sama dua kali; lebih dari 16 Connector jika dozin.connectors tidak diberikan

Di 0.1.41, id harus tercantum di dozin.connectors (daftar kosong menolak semua Connector), dan systemPrompt serta chat belum ada.

Contoh

api.registerConnector({ id: 'demo', start(ctx) {}, stop() {}, async send() { return { ok: true }; } });

api.registerService(definition) Belum dirilis

Mendaftarkan tugas latar belakang. Tugas ini muncul di bawah Extension di Pengaturan › Ekstensi, tempat pengguna (atau AI dengan local_service) bisa menjalankan dan menghentikannya.

Parameter

Nama	Tipe	Wajib	Deskripsi
definition	ServiceDefinition	Ya	Lihat Tugas Latar Belakang

Nilai kembalian

Tidak ada.

Melempar

Error	Kapan
TypeError	Tidak ada fungsi run, atau ada field definisi yang tidak valid (pesannya menyebutkan yang mana)
CapabilityDeniedError	Dipanggil setelah activate selesai; service tidak ada di dozin.capabilities; id yang sama dua kali; lebih dari 8 tugas

Contoh

api.registerService({ id: 'sync', name: 'Sync', start: 'auto', async run(ctx) { /* ... */ } });

api.log(text)

Menulis satu baris ke log Extension, yang dibuka pengguna dari Pengaturan › Ekstensi.

Nama	Tipe	Wajib	Deskripsi
text	string	Ya	Barisnya

Tidak mengembalikan apa pun.

api.log('activated');

Terkait

• Connector Definisi yang diberikan ke registerConnector
• Tugas Latar Belakang Definisi yang diberikan ke registerService