Tool call
Satu langkah yang diambil asisten untuk sampai pada jawabannya (mencari di catatan, membaca berkas, memeriksa kalender), ditampilkan sebagai <details> satu baris yang tenang dan bisa dibuka untuk melihat temuannya. Jawaban tetap yang utama.
Penggunaan
Pakai saat
- Jawaban asisten bergantung pada sesuatu yang dicari atau dijalankannya, dan orang mungkin ingin memeriksanya: pencarian, berkas yang dibaca, perhitungan, pengecekan kalender.
- Langkah masih berjalan: baris menampilkan spinner dan label berkilau sampai selesai.
- Beberapa langkah terjadi berurutan sebelum jawaban: tumpuk, satu baris per langkah.
Pakai yang lain saat
- Menunggu tanpa langkah yang bisa disebut: pakai Thinking.
- Sumber yang dikutip dalam jawaban: pakai Citation.
- Bagian konten halaman yang bisa dilipat (FAQ, rincian): pakai Accordion.
- Riwayat tindakan yang dilakukan seseorang: pakai Timeline.
- Kode yang perlu disalin orang: pakai Code block.
Letaknya. Di dalam chat message msg--ai, di atas .bubble yang berisi jawaban, sesuai urutan langkah dijalankan. Selebar kolom jawaban.
Contoh
Mencari "gaya total" di catatan Anda
Membaca latihan soal 3
<div class="msg msg--ai" style="max-width: 560px;"> <details class="toolcall"><summary><span class="ic" aria-hidden="true">search</span>Mencari "gaya total" di catatan Anda<span class="ic" aria-hidden="true">expand_more</span></summary><div class="toolcall__body">Menemukan 3 halaman: materi minggu 4, halaman 2; latihan soal 3, nomor 4; panduan praktikum 2.</div></details> <details class="toolcall"><summary><span class="ic" aria-hidden="true">description</span>Membaca latihan soal 3<span class="ic" aria-hidden="true">expand_more</span></summary><div class="toolcall__body">Nomor 4: kotak 7 kg didorong dengan 20 N melawan gesekan 6 N.</div></details> <div class="bubble">Gaya totalnya 14 N, jadi percepatan kotak 2 m/s². Jawaban Anda memakai 20 N, yaitu gaya dorongnya saja.</div> </div>
Memeriksa kalender Anda
Memesan ruang belajar
Memeriksa kalender Anda
Memesan ruang belajar
<details class="toolcall">
<summary>
<span class="spinner" aria-hidden="true"><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i></span>
<span class="shimmer">Memesan ruang belajar</span>
<span class="ic" aria-hidden="true">expand_more</span>
</summary>
<div class="toolcall__body">…</div>
</details>
<!-- Done: replace the spinner with <span class="ic" aria-hidden="true">check_circle</span>,
drop the shimmer class and name the result: "Ruang 2.14 sudah dipesan". -->Menjalankan query pada nilai Anda
SELECT AVG(score) FROM grades WHERE course = 'BIO101';
<details class="toolcall" open style="max-width: 560px; width: 100%;"><summary><span class="ic" aria-hidden="true">code</span>Menjalankan query pada nilai Anda<span class="ic" aria-hidden="true">expand_more</span></summary><div class="toolcall__body"><div class="codeblock"><pre>SELECT AVG(score) FROM grades WHERE course = 'BIO101';</pre></div></div></details>
Tidak bisa membuka laporan-praktikum.pdf
<div class="msg msg--ai" style="max-width: 560px;"> <details class="toolcall"><summary><span class="ic" aria-hidden="true">cloud_off</span>Tidak bisa membuka laporan-praktikum.pdf<span class="ic" aria-hidden="true">expand_more</span></summary><div class="toolcall__body">Ukuran berkas lebih dari 20 MB. Jawaban di bawah hanya memakai catatan Anda.</div></details> <div class="bubble">Menurut catatan Anda, kelompok kontrol harus mendapat cahaya dan air yang sama dengan kelompok uji.</div> </div>
Anatomi
| Bagian | Fungsinya |
|---|---|
details.toolcall | Wajib. <details> bawaan: isian tenang, radius 12 px. |
summary | Wajib. Satu baris, minimal 40 px: ikon di depan (atau spinner saat berjalan), langkahnya dalam kata-kata, lalu chevron expand_more sebagai ikon terakhir. |
.ic:last-child | Wajib. Chevron; berputar 180 derajat saat terbuka. Harus menjadi ikon terakhir di summary. |
.toolcall__body | Apa yang ditemukan atau dilakukan langkah itu: satu kalimat pendek, list, atau code block. |
Status
| Status | Caranya |
|---|---|
closed | Bawaan: satu baris, chevron mengarah ke bawah. |
open | [open]: isi langsung tampil; chevron berputar 180 derajat. |
running | .spinner menggantikan ikon depan dan label .shimmer. |
done | Ikon hasil (check_circle, search, description), label menyebut temuannya. |
failed | Ikon biasa (cloud_off, error) dan alasannya dalam kata-kata; tanpa isian merah. |
Gerak dan mikrointeraksi
- Chevron: berputar 180 derajat dengan
--spring-smooth(--d-smooth, 560 ms); berbalik dari posisinya saat itu jika diklik lagi. - Isi: muncul dan hilang seketika.
<details>bawaan tidak menganimasikan tingginya di sini; jika tinggi perlu bergerak, pakai accordion. - Berjalan: spinner berputar (800 ms per putaran) dan label berkilau dengan siklus 1,8 detik; saat langkah selesai, kilau mengendap menjadi teks solid selama
--d-standard. - Reduced motion: kilau berhenti (teks solid), chevron berputar dalam 120 ms; spinner tetap berputar karena melaporkan pekerjaan.
Aksesibilitas
<details>/<summary>bawaan: keyboard (Enter, Space) dan status terbuka sudah tersedia. Pertahankan.- Teks summary harus menyebut langkahnya sendiri ("Mencari gaya total di catatan Anda"), bukan hanya ikon.
- Ikon memakai
aria-hidden; spinner juga. Selama langkah berjalan, pesan diberiaria-busy="true".
Lakukan dan hindari
Lakukan
- Sebut langkah dan objeknya: "Membaca latihan soal 3".
- Biarkan langkah tertutup secara bawaan; jawaban yang utama.
- Susun langkah sesuai urutan jalannya, di atas jawaban.
Hindari
- Menampilkan nama tool mentah atau JSON di summary.
- Memakainya untuk konten halaman yang perlu dibaca orang; pakai accordion.
- Membiarkan spinner berputar setelah langkah selesai atau gagal.
Perilaku dan kode
HTML biasa. Tidak ada. Ini <details> bawaan. Perbarui summary sendiri saat langkah selesai.