Menggunakan Asisten Databricks

Asisten Databricks adalah asisten AI sadar konteks yang dapat membantu Anda dengan notebook Databricks, editor SQL, pekerjaan, dasbor AI/BI, dan editor file. Asisten Databricks membantu Anda dengan data dan kode saat Anda meminta bantuan menggunakan antarmuka percakapan.

Untuk akun: Menonaktifkan atau mengaktifkan fitur Asisten Databricks

Fitur Asisten Databricks yang didukung Azure AI diaktifkan secara default. Namun, admin akun dapat menonaktifkan fitur Asisten yang didukung Azure AI untuk semua ruang kerja dalam akun. Admin akun juga dapat memberlakukan pengaktifan Asisten Databricks untuk seluruh akun:

Tip

Tindakan mengaktifkan atau menonaktifkan fitur Asisten Databricks yang didukung Azure AI untuk akun Anda diambil sebagai peristiwa akun di log audit Anda, lihat Peristiwa akun.

1. Sebagai admin akun, masuk ke konsol akun.

   Penting

   Jika belum ada pengguna di penyewa ID Microsoft Entra Anda yang masuk ke konsol akun, Anda atau pengguna lain di penyewa Anda harus masuk sebagai admin akun pertama. Untuk melakukan ini, Anda harus menjadi Administrator Global ID Microsoft Entra, tetapi hanya ketika Anda pertama kali masuk ke Konsol Akun Azure Databricks. Setelah masuk pertama kali, Anda menjadi admin akun Azure Databricks dan tidak lagi memerlukan peran Administrator Global ID Microsoft Entra untuk mengakses akun Azure Databricks. Sebagai admin akun pertama, Anda dapat menetapkan pengguna di penyewa ID Microsoft Entra sebagai admin akun tambahan (yang dapat menetapkan lebih banyak admin akun). Admin akun tambahan tidak memerlukan peran tertentu dalam ID Microsoft Entra. Lihat Mengelola pengguna, perwakilan layanan, dan grup.

2. Klik Pengaturan.

3. Klik tab Pengaktifan fitur.

4. Untuk opsi Aktifkan fitur yang didukung Azure AI, pilih Nonaktif atau Aktif.

5. Cegah penggantian ruang kerja dengan pengaturan Terapkan :

Untuk mempelajari tentang layanan yang digunakan untuk fitur Asisten Databricks yang didukung Azure AI, lihat Fitur yang diatur oleh pengaturan fitur bantuan AI yang didukung Mitra.

Untuk ruang kerja: Menonaktifkan atau mengaktifkan fitur Asisten

Jika admin akun Anda mengaktifkan Asisten, itu diaktifkan secara default di ruang kerja. Kecuali admin akun memilih untuk menerapkan pengaturan, admin ruang kerja dapat menonaktifkannya untuk ruang kerja mereka.

Untuk menonaktifkan Asisten Databricks di ruang kerja:

1. Klik nama pengguna Anda di bilah atas Pengaturan ruang >kerja Databricks.
2. Di panel kiri di bawah Admin ruang kerja, klik tab Tingkat Lanjut .
3. Untuk menonaktifkan Asisten, klik tombol Nonaktif untuk fitur bantuan AI yang didukung Azure AI.

Tur panel Asisten

Bagian ini menjelaskan pengalaman default panel Asisten.

Untuk membuka panel Asisten, klik di bar samping kiri.

Ketik pertanyaan dalam kotak teks di bagian bawah panel Asisten dan tekan Enter atau klik di sebelah kanan kotak teks. Asisten menampilkan jawabannya. Cuplikan layar berikut menunjukkan tindakan yang bisa Anda lakukan setelah Asisten membuat kode di panel Asisten.

Anda bisa menjalankan kueri yang sama lagi untuk menghasilkan jawaban lain. Untuk melakukannya, arahkan kursor Anda ke atas jawaban dan klik .

Untuk menutup panel, klik ikon lagi atau klik di sudut kanan atas sel. Anda bisa memperluas panel ke lebar penuh dengan mengklik ; klik untuk mengembalikan panel ke lebar default.

Panel Asisten melacak percakapan Anda meskipun Anda menutup panel atau buku catatan. Untuk menghapus percakapan sebelumnya, klik di kanan atas panel Asisten.

Utas dan riwayat perintah

Utas percakapan bertahan di berbagai konteks di mana Asisten Databricks tersedia. Dari panel Asisten, Anda bisa membuat utas percakapan baru, menampilkan riwayat pertanyaan dan permintaan, dan mengelola pengalaman Asisten Databricks Anda.

Asisten Databricks memberi judul utas berdasarkan konteks perintah Anda, sehingga Anda dapat menavigasi riwayat percakapan Asisten Anda. Contoh berikut berasal dari pertanyaan tentang buku catatan.

Menggunakan Asisten Databricks di sel buku catatan

Di buku catatan, Asisten Databricks tersedia di panel Asisten atau sebaris dalam sel kode.

Untuk menggunakan Asisten Databricks langsung di sel kode, tekan Cmd + i di MacOS atau Ctrl + i di Windows. Kotak teks muncul di sel. Anda dapat mengetikkan pertanyaan atau komentar dalam bahasa Inggris lalu menekan Enter (bukan Shift+Enter, seperti Anda ingin menjalankan sel) agar Asisten menghasilkan respons.

Gunakan perintah garis miring untuk perintah

Perintah garis miring adalah pintasan untuk membuat perintah umum.

Teks perintah	Apa yang dilakukan Asisten
/	Menampilkan perintah umum
/doc	Mengomentari kode dalam tampilan berbeda
/explain	Memberikan penjelasan tentang kode dalam sel
/fix	Mengusulkan perbaikan untuk kesalahan kode apa pun dalam tampilan diff
/findTables	Mencari tabel yang relevan berdasarkan metadata Katalog Unity.
/findQueries	Mencari kueri yang relevan berdasarkan metadata Unity Catalog.
/optimize	Meningkatkan kueri SQL yang tidak efisien.
/prettify	Format kode untuk keterbacaan.
/rename	Menyarankan nama yang diperbarui ke sel buku catatan dan elemen lainnya, tergantung pada konteksnya.
/settings	Menyesuaikan pengaturan buku catatan Anda langsung dari Asisten.

Saat Anda menggunakan /fix atau /doc, di jendela diff pilih Terima untuk menerima perubahan yang diusulkan atau Tolak untuk menyimpan kode asli. Jika Anda menerima kode yang diusulkan, kode tidak berjalan secara otomatis. Anda dapat meninjau kode sebelum menjalankannya. Jika kode yang dihasilkan bukan yang Anda inginkan, coba lagi dengan menambahkan detail atau informasi selengkapnya ke komentar Anda. Lihat Tips untuk menggunakan Asisten Databricks.

Dapatkan penjelasan terperinci tentang cuplikan kode. /explain Gunakan perintah dan sertakan istilah seperti "ringkas" atau "jelaskan kode baris demi baris" untuk meminta tingkat detail yang Anda inginkan. Anda juga dapat meminta Asisten Databricks untuk menambahkan komentar ke kode.

Untuk pelengkapan otomatis kode, performa mungkin lebih baik menggunakan panel Asisten daripada di sel buku catatan.

Asisten ditutup secara otomatis jika Anda Menerima atau Menolak kode yang dihasilkannya.

Tabel referensi dalam perintah menggunakan @

Untuk mereferensikan tabel dengan cepat di perintah Asisten, gunakan @ simbol (di).

Mendapatkan bantuan dengan kode

Asisten Databricks membantu kode, baik SQL maupun Python:

• Pelengkapan otomatis berbasis AI di notebook Databricks, editor SQL, dan editor file.
• Pemfilteran data dengan perintah bahasa alami.
• Penelusuran kesalahan kode dengan Diagnosis Kesalahan (Pratinjau Umum).

Catatan

Saran kode sebaris tidak tersedia di wilayah atau ruang kerja Azure Government dengan kepatuhan FedRAMP.

Memfilter data dengan perintah bahasa alami

Gunakan Asisten Databricks untuk memfilter output data dengan perintah bahasa alami.

Untuk memfilter output dengan bahasa alami, klik ikon Filter di tabel output dan masukkan perintah. Misalnya, seperti dalam contoh animasi berikut, Anda dapat meminta "Tampilkan saya hanya laki-laki di atas 70."

Dapatkan saran kode sebaris: Contoh Python dan SQL

Saat Anda mengetik, saran akan muncul secara otomatis. Tekan Tab untuk menerima saran. Untuk memicu saran secara manual, tekan Option + Shift + Space (di macOS) atau Control + Shift + Space (di Windows).

Pelengkapan otomatis berbasis AI juga dapat menghasilkan kode dari komentar:

Kode debug: Contoh Python dan SQL

Penting

Fitur ini ada di Pratinjau Publik.

Untuk menggunakan Asisten Databricks untuk memperbaiki kode, lakukan salah satu hal berikut:

• Ajukan pertanyaan di panel Asisten.
• Klik tombol Diagnosis Kesalahan yang muncul di hasil sel saat terjadi kesalahan.
• Klik Debug untuk menelusuri baris demi baris kode secara interaktif, mengatur titik henti, memeriksa variabel, dan menganalisis eksekusi program.

Tab di bawah ini memperlihatkan contoh dalam kode Python dan SQL:

Python

SQL

Saat Anda mengklik Diagnosis kesalahan, Asisten secara otomatis menjalankan /fix.

Perbaikan Cepat

Saat kode mengembalikan kesalahan, Perbaikan Cepat secara otomatis merekomendasikan perbaikan untuk kesalahan dasar yang dapat diperbaiki dalam satu perubahan baris.

Klik Terima dan jalankan untuk membuat perbaikan yang direkomendasikan dan terus menjalankan kode Anda:

Mendiagnosis kesalahan dalam pekerjaan (Pratinjau Umum)

Penting

Fitur ini ada di Pratinjau Publik.

Asisten Databricks membantu mendiagnosis kesalahan dalam pekerjaan.

Untuk mendiagnosis pekerjaan dengan Asisten:

1. Buka pekerjaan yang gagal dari antarmuka pengguna Pekerjaan.
2. Pilih Diagnosis Kesalahan.

Mendapatkan jawaban dari dokumentasi Azure Databricks

Di editor buku catatan, Asisten Databricks dapat menjawab pertanyaan berdasarkan dokumentasi Databricks. Ketik pertanyaan atau perintah Anda ke dalam kotak perintah.

Tips untuk menggunakan Asisten Databricks

Bagian ini mencakup beberapa tips umum dan praktik terbaik saat menggunakan Asisten Databricks.

Asisten Databricks menggunakan konteks untuk memberikan jawaban yang lebih baik

Asisten Databricks memiliki akses ke skema dan metadata tabel dan kolom. Ini memungkinkan Anda menggunakan bahasa alami dan menghasilkan kueri yang lebih akurat. Misalnya, jika tabel memiliki kolom yang disebut Status, Anda dapat meminta Asisten Databricks untuk menghasilkan daftar pengguna yang tinggal di Michigan.

Asisten Databricks menggunakan konteks berikut:

• Kode atau kueri di sel buku catatan saat ini atau tab editor Databricks SQL.
• Nama dan deskripsi Tabel dan Kolom.
• Pertanyaan permintaan sebelumnya.
• Tabel favorit dan aktif.
• Untuk fitur diagnosis kesalahan, pelacakan tumpukan dari output kesalahan.

Saat memilih kolom dari DataFrame, Anda bisa mendapatkan hasil yang lebih akurat dengan menyediakan kueri awal. Misalnya, berikan pernyataan seperti SELECT * FROM <table_name>. Ini memungkinkan Asisten Databricks untuk mendapatkan nama kolom dan tidak perlu menebak.

Karena Asisten Databricks menggunakan riwayat percakapan Anda untuk memberikan jawaban yang lebih baik dan lebih akurat, Anda dapat meminta Asisten Databricks untuk mengubah output respons sebelumnya tanpa harus menulis ulang seluruh perintah. Gunakan riwayat obrolan Asisten untuk membersihkan, menjelajahi, memfilter, dan menggoreng DataFrame secara berulang di panel Asisten.

Membuatnya spesifik

Struktur dan detail yang disediakan Asisten Databricks bervariasi dari waktu ke waktu, bahkan untuk permintaan yang sama. Cobalah untuk memberikan panduan sebanyak mungkin kepada Asisten untuk membantunya mengembalikan informasi yang Anda inginkan dalam format yang diinginkan, tingkat detail, dan sebagainya. Contohnya:

• "Jelaskan kode ini dalam beberapa kalimat" atau "Jelaskan kode ini baris demi baris".
• "Buat visualisasi menggunakan MatPlotLib" atau "Buat visualisasi menggunakan Seaborn".

Memberikan contoh nilai data tingkat baris

Karena Asisten Databricks tidak menggunakan data tingkat baris, Anda mungkin perlu memberikan detail lebih lanjut untuk meminta mendapatkan jawaban yang paling akurat. Gunakan komentar tabel atau kolom di Catalog Explorer untuk menambahkan baris data sampel. Misalnya, kolom tinggi Anda dalam format feet-inches. Untuk membantu Asisten menginterpretasikan data, tambahkan komentar seperti "Kolom tinggi dalam format string dan dipisahkan oleh tanda hubung. Contoh: '6-2'." Untuk informasi tentang komentar tabel dan kolom, lihat Menambahkan komentar ke data dan aset AI.

Jika Anda perlu menggunakan konversi jenis data kolom untuk menjalankan operasi, Anda mungkin perlu memberikan detail. Misalnya: "konversi kode ini dari panda ke PySpark, termasuk kode yang diperlukan untuk mengonversi pandas DataFrame menjadi PySpark DataFrame dan mengubah jenis data churn kolom dari boolean menjadi bilangan bulat".

Gunakan Shift+Enter untuk menambahkan baris baru di kotak teks obrolan

Gunakan Shift+Enter untuk menambahkan baris baru di kotak teks Obrolan asisten. Ini memudahkan untuk memformat dan mengatur pesan Anda ke Asisten Databricks.

Mengedit dan menjalankan kode di panel obrolan Asisten Databricks

Jalankan kode di panel Asisten untuk memvalidasinya atau menggunakannya sebagai scratchpad. Untuk menjalankan kode, klik di sudut kiri atas kotak kode di panel Asisten.

Tab di bawah ini memperlihatkan contoh untuk kode Python dan SQL:

Python

SQL

Saat Anda menjalankan kode di panel Asisten, output ditampilkan dan variabel menjadi dapat digunakan di buku catatan.

Anda juga dapat mengedit kode yang dihasilkan Asisten Databricks secara langsung di kotak obrolan Asisten sebelum memindahkan kode ke buku catatan.

Informasi Tambahan

Artikel berikut berisi informasi tambahan tentang menggunakan Asisten Databricks:

• Apa itu Asisten Databricks?
• Kepercayaan dan keamanan DatabricksIQ
• Mengukur dampak Asisten Databricks