

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Pemecahan Masalah
<a name="desktop-troubleshooting"></a>

Bagian berikut menjelaskan masalah umum yang mungkin Anda temui saat menggunakan aplikasi desktop Amazon Quick dan cara mengatasinya.

## Masalah instalasi dan peluncuran
<a name="desktop-ts-install"></a>

macOS menampilkan peringatan “pengembang tak dikenal”  
Jika macOS mencegah Anda membuka aplikasi desktop Amazon Quick karena berasal dari pengembang yang tidak dikenal, gunakan prosedur berikut untuk mengizinkannya.  

1. Buka **Pengaturan Sistem** di Mac Anda.

1. Pilih **Privasi & Keamanan**.

1. Gulir ke bagian Keamanan dan pilih **Buka Pokoknya** di sebelah pesan tentang Cepat.

1. Konfirmasikan bahwa Anda ingin membuka aplikasi.
Pada peluncuran pertama, sistem operasi Anda mungkin meminta Anda untuk mengonfirmasi bahwa Anda ingin membuka aplikasi. Pilih **Buka** untuk melanjutkan.

Aplikasi tidak diluncurkan  
Jika aplikasi desktop Amazon Quick tidak diluncurkan, coba langkah-langkah berikut.  

1. Nyalakan kembali komputer Anda dan coba buka aplikasi lagi.

1. Verifikasi bahwa sistem operasi Anda memenuhi persyaratan minimum.

1. Periksa apakah Anda memiliki ruang disk yang cukup.

1. Jika masalah berlanjut, hapus `~/.quickwork/` direktori (macOS) `%USERPROFILE%\.quickwork\` atau direktori (Windows) dan instal ulang aplikasi.
Menghapus direktori `~/.quickwork/` (macOS) `%USERPROFILE%\.quickwork\` atau (Windows) akan menghapus semua data lokal, termasuk percakapan, grafik pengetahuan, memori, dan kredensi yang disimpan. Gunakan langkah ini hanya sebagai upaya terakhir.

## Masalah koneksi
<a name="desktop-ts-connections"></a>

Slack atau koneksi Outlook gagal  
Jika koneksi ke Slack atau Microsoft Outlook gagal, coba langkah-langkah berikut.  

1. Putuskan sambungan layanan di **Pengaturan** > **Kemampuan** > **Koneksi**.

1. Sambungkan kembali layanan dengan memilih **Masuk** dan menyelesaikan alur otentikasi.

1. Verifikasi bahwa akun Anda memiliki izin yang diperlukan di layanan pihak ketiga.

1. Pastikan koneksi internet Anda aktif dan stabil.

Koneksi Microsoft Teams gagal  
Jika koneksi ke Microsoft Teams gagal, ikuti langkah yang sama seperti untuk Slack atau Outlook. Pastikan administrator organisasi Anda tidak membatasi akses aplikasi pihak ketiga.

Koneksi menunjukkan status “Tidak disinkronkan”  
Jika koneksi menunjukkan status “Tidak disinkronkan”, coba langkah-langkah berikut.  

1. Pastikan Anda memiliki koneksi internet aktif.

1. **Putuskan sambungan dan sambungkan kembali layanan di **Pengaturan** > **Kemampuan > Koneksi**.**

1. Jika masalah berlanjut, layanan pihak ketiga mungkin mengalami pemadaman. Periksa halaman status layanan.

Koneksi Google Workspace gagal  
Jika koneksi ke layanan Google (Gmail, Google Kalender, Google Drive, Google Documents, Google Sheets, Google Slides, Google Meet, atau Google Analytics) gagal, verifikasi hal berikut.  

1. Akun Google Anda tidak dibatasi oleh kebijakan admin organisasi Anda.

1. Anda telah memberikan izin OAuth yang diperlukan selama alur masuk.

1. Anda masuk dengan akun Google yang benar.

## Masalah kinerja
<a name="desktop-ts-performance"></a>

Respons lambat  
Jika respons cepat lambat, coba langkah-langkah berikut.  

1. Beralih ke mode model AI **Cepat** untuk respons yang lebih cepat. Pilih pemilih model di area input obrolan dan pilih **Cepat**.

1. Kurangi tingkat **upaya berpikir**. Upaya berpikir yang lebih rendah (Off atau Low) menghasilkan respons yang lebih cepat.

1. Tutup aplikasi yang tidak digunakan untuk membebaskan sumber daya sistem.

1. Periksa kecepatan koneksi internet Anda. Permintaan model AI memerlukan koneksi jaringan ke API Gateway.

Penggunaan memori tinggi  
Jika aplikasi desktop Amazon Quick menggunakan memori berlebihan, coba langkah-langkah berikut.  

1. Kurangi jumlah folder yang diindeks di **Pengaturan > Komputer** **saya**. Nonaktifkan **pencarian semantik** untuk folder yang tidak memerlukannya, karena pencarian semantik menggunakan lebih banyak sumber daya daripada pencarian kata kunci.

1. Turunkan slider **tugas paralel Max** di **Settings** > **Customization** > **Performance**. Nilai default adalah 50. Mengurangi nilai ini membatasi jumlah operasi latar belakang bersamaan.

1. Mulai ulang aplikasi untuk menghapus data yang di-cache.

1. Sesuaikan batas pengindeksan pencarian di **Pengaturan>** **Komputer saya>** **Pengindeksan pencarian**. Turunkan **batas Penyimpanan**, **Ukuran file maks untuk pengindeksan**, atau **ukuran folder Maks untuk pengindeksan slider**.
Pengindeksan pencarian secara otomatis berhenti ketika ruang disk kosong turun di bawah 8,0 GiB.

## Masalah akses file
<a name="desktop-ts-file-access"></a>

Quick tidak dapat menemukan file  
Jika Quick tidak dapat menemukan file yang Anda referensikan dalam obrolan, verifikasi yang berikut ini.  

1. Folder induk file ditambahkan di **Pengaturan>** **Komputer saya>** **Folder lokal**. Quick hanya dapat mengakses file dalam folder yang Anda berikan akses secara eksplisit.

1. Pilih **\+ Tambahkan folder** untuk memberikan akses ke folder tambahan.

1. Setelah menambahkan folder, Quick dapat langsung membaca file di dalamnya. Pengindeksan untuk pencarian terjadi di latar belakang.

Pencarian tidak mengembalikan hasil  
Jika pencarian file tidak mengembalikan hasil, coba langkah-langkah berikut.  

1. Verifikasi bahwa **pencarian Kata Kunci** diaktifkan untuk folder di **Pengaturan>** **Komputer saya>** Folder **lokal**. Perluas folder untuk melihat sakelar pengindeksan.

1. Periksa status pengindeksan. Status **Siap** dengan jumlah file dan entri mengonfirmasi pengindeksan selesai.

1. Jika Anda baru saja menambahkan folder baru, tunggu hingga pengindeksan selesai. Status menunjukkan kemajuan.

1. Periksa apakah file tidak lebih besar dari **ukuran file Max untuk batas pengindeksan** di **Pengaturan>** **Komputer saya>** **Pengindeksan pencarian**. File yang lebih besar dari batas ini dilewati selama pengindeksan tetapi masih tersedia untuk agen melalui akses file langsung.

1. Untuk pencarian yang lebih luas, aktifkan **pencarian Semantik** pada folder untuk memungkinkan kueri bahasa alami.

## Masalah otomatisasi browser
<a name="desktop-ts-browser"></a>

Otomatisasi browser tidak berfungsi  
Jika Quick tidak dapat menelusuri halaman web, coba langkah-langkah berikut.  

1. Verifikasi bahwa **Otomatisasi Browser** diaktifkan di **Pengaturan>** **Kemampuan** > **Sistem**.

1. Jika menggunakan mode “Gunakan Chrome saya”, verifikasi pengaturan di **Pengaturan** > **Kustomisasi** > **Browser**. Buka Chrome dan navigasikan ke`chrome://inspect/#remote-debugging`. Pilih **Aktifkan debugging jarak jauh**. Kembali ke Cepat dan pilih **Uji Koneksi** untuk memverifikasi koneksi.

1. Jika menggunakan mode default, Quick meluncurkan instance Chrome terpisah dengan salinan profil Anda. Pastikan Chrome diinstal pada sistem Anda.

## Masalah agen terjadwal
<a name="desktop-ts-agents"></a>

Agen terjadwal tidak berjalan  
Agen terjadwal berjalan secara lokal di komputer Anda. Jika agen tidak berjalan pada waktu yang dijadwalkan, verifikasi yang berikut ini.  

1. Komputer Anda dihidupkan dan terjaga pada waktu yang dijadwalkan.

1. Aplikasi desktop Amazon Quick sedang berjalan.

1. Agen diaktifkan. Periksa sakelar di **Pengaturan** > **Kemampuan** > **Tugas terjadwal**, atau buka panel **Agen** dari bilah atas.

1. Koneksi internet Anda aktif. Agen yang mengakses layanan terhubung atau model AI memerlukan koneksi jaringan.
Jika komputer Anda mati atau aplikasi ditutup ketika agen dijadwalkan untuk berjalan, agen tidak berjalan sampai waktu yang dijadwalkan berikutnya.

Agen menghasilkan hasil yang tidak terduga  
Jika agen terjadwal menghasilkan hasil yang tidak terduga, coba langkah-langkah berikut.  

1. Buka **Pengaturan** > **Kemampuan** > **Tugas terjadwal** dan pilih agen.

1. Tinjau tab **Prompt** untuk memverifikasi instruksi agen sudah benar.

1. Periksa tab **Kemampuan** untuk memverifikasi server MCP yang benar terpasang.

1. Pertimbangkan untuk mengubah **Model** di tab **Ikhtisar**. Gunakan **Balanced** atau **Smart** untuk tugas agen yang lebih kompleks.

1. Pilih tombol **Run** (ikon putar) untuk memicu agen secara manual dan amati hasilnya.

## Masalah server MCP
<a name="desktop-ts-mcp"></a>

Server MCP gagal terhubung  
Jika server MCP gagal terhubung, coba langkah-langkah berikut berdasarkan jenis koneksi.  
**Server MCP lokal:**  

1. Verifikasi bahwa perintahnya benar dan executable diinstal pada sistem Anda.

1. Periksa apakah argumen dipisahkan spasi dan diformat dengan benar.

1. Tingkatkan nilai **Timeout** jika server membutuhkan waktu lebih dari 30 detik untuk memulai (dapat dikonfigurasi dari 5 hingga 300 detik).

1. Verifikasi bahwa setiap **variabel Lingkungan** yang diperlukan diatur dengan benar.
**Server MCP jarak jauh:**  

1. Verifikasi bahwa URL sudah benar dan server sedang berjalan.

1. Jika otentikasi diperlukan, verifikasi bahwa nilai **Token** adalah token pembawa yang valid.

1. Periksa koneksi jaringan Anda dan pengaturan firewall apa pun.
**Server MCP yang diimpor:**  

1. Verifikasi bahwa jalur file konfigurasi sudah benar.

1. Pastikan aplikasi sumber (Kiro, Claude Code, AIM, dan sebagainya) diinstal dengan benar.

## Mengekspor diagnostik
<a name="desktop-ts-diagnostics"></a>

Jika Anda perlu berbagi informasi diagnostik untuk pemecahan masalah, Anda dapat mengekspor log diagnostik dari aplikasi.

1. Buka **Pengaturan>** **Kustomisasi**.

1. Gulir ke bagian **Pemecahan Masalah**.

1. Pilih rentang waktu dari dropdown (misalnya, **2 jam terakhir**).

1. Pilih **Ekspor Diagnostik** untuk menyimpan log diagnostik ke desktop Anda.

## Mengatur ulang aplikasi
<a name="desktop-ts-reset"></a>

Jika langkah pemecahan masalah lainnya tidak menyelesaikan masalah Anda, Anda dapat mengatur ulang aplikasi dengan menghapus semua data.

**Awas**  
Tindakan ini tidak dapat diubah. Ini menghapus semua data Cepat, termasuk percakapan, pesan cache, grafik pengetahuan, kredensi tersimpan, dan preferensi pengguna. Aplikasi berhenti setelah pembersihan.

1. Buka **Pengaturan>** **Kustomisasi**.

1. Gulir ke bagian **zona Bahaya**.

1. Pilih **Hapus semua data**.

1. Konfirmasikan tindakan.

1. Untuk menghapus instalasi sepenuhnya di macOS, `Amazon Quick.app` seret ke Sampah. Di Windows, buka **Pengaturan** > **Aplikasi > Aplikasi** yang **diinstal**, temukan Amazon Quick, dan pilih **Uninstall**.

## Mendapatkan bantuan tambahan
<a name="desktop-ts-help"></a>

Jika langkah pemecahan masalah sebelumnya tidak menyelesaikan masalah, Anda dapat menggunakan sumber daya berikut.
+ **Ekspor diagnostik** dan bagikan dengan tim dukungan Anda.
+ **Menu pengembang** - Pilih titik status koneksi (titik hijau di sudut kanan atas) untuk mengakses Mission Control, Metrics overlay, panel Debug, dan panel Memori untuk diagnostik lanjutan.
+ Hubungi administrator TI organisasi Anda untuk masalah akun perusahaan.
+ Kunjungi dokumentasi Amazon Quick untuk panduan terbaru.