Alur Tugas

Empat tugas pertama yang biasanya dilakukan saat memakai Ranya.

Tugas 1: Call Jalan (Twilio + Provider)

1. Pilih provider untuk Transport, STT, TTS, dan LLM.
2. Set env var dan mulai dari examples/hvac/config.yaml.
3. Jalankan contoh HVAC.
4. Pastikan call end‑to‑end selesai.
5. Jika gagal, gunakan timeline artifacts untuk mencari stage terakhir.

Related:

• Tugas 1: Call Jalan
• Mulai di Sini
• Konfigurasi
• Penyedia
• Contoh
• Observabilitas

Tugas 2: Tambah Tools (Aksi Bisnis)

1. Definisikan schema tool dengan llm.Tool.
2. Implement llm.ToolRegistry di aplikasi.
3. Aktifkan konfirmasi untuk aksi berisiko.
4. Atur timeout dan retry.
5. Pastikan frame tool_call dan tool_result muncul.

Related:

• Tugas 2: Tambah Tools
• Tools dan Konfirmasi
• Modul
• Contoh

Tugas 3: Routing dan Bahasa

1. Pilih router.mode (off, bootstrap, full).
2. Wire RouterStrategy (LLM router atau custom).
3. Tambah LanguageDetector jika perlu multi‑bahasa.
4. Pastikan final STT memakai is_final=true.

Related:

• Tugas 3: Routing + Bahasa
• Routing dan Bahasa
• Frame dan Metadata
• Konfigurasi

Tugas 4: Aktifkan Observabilitas dan Debugging

1. Set observability.artifacts_dir ke folder yang bisa ditulis.
2. Gunakan log JSON agar cepat mencari trace_id.
3. Buka timeline JSONL dan cari frame_out terakhir.
4. Gunakan event biaya dan latensi untuk validasi performa.

Related:

• Tugas 4: Observabilitas
• Observabilitas
• Pemecahan Masalah