MORATUS Desktop
Desktop ajanı klasöründeki dosyaları okumak, değiştirmek, belge üretmek ve komut çalıştırmak için aşağıdaki araçları kullanır. Araçlar bilgisayarında, yerel çalışma zamanı tarafından yürütülür; her araç kullanımı sohbette ayrı bir adım olarak görünür.
Q3 büyüme raporunu güncelle ve yönetim için kısa bir Word özeti hazırla.
Önce klasördeki raporu ve verileri inceleyip bir plan çıkarıyorum, sonra güncellemeleri uygulayacağım.
Dosyalar listelendi list_files · 14 dosya
Veriler okundu read_file · q3-veriler.xlsx · 3 sayfa
Rapor okundu read_file · buyume-raporu.md · 248 satır
Rapor güncellendi edit_file · buyume-raporu.md · +36 −12
Özet hazır create_document · Q3-yonetici-ozeti.docx
Q3 rakamlarını güncelledim: gelir ve aktif kullanıcı tablolarını yeni verilerle değiştirdim, eskiyen iki paragrafı çıkardım. Yönetici özetini Q3-yonetici-ozeti.docx olarak çalışma klasörüne kaydettim.
Desktop'a bir görev verin
Okuma
| Araç | Ne yapar? |
|---|---|
list_files | Klasördeki dosyaları listeler. |
read_file | Metin, kod, PDF, Word ve Excel/CSV içeriğini okur; formüller ve hücre adresleri korunur. |
vision_analysis | Eklenen veya klasördeki görselleri, içlerindeki yazılarla birlikte analiz eder. |
Yazma
| Araç | Ne yapar? |
|---|---|
write_file | Yeni dosya oluşturur. |
edit_file | Mevcut dosyada hedefli değişiklik yapar. |
delete_file | Dosya veya boş klasör siler. |
Belgeler
| Araç | Ne yapar? |
|---|---|
create_document | Word, Excel ve PDF üretir; mevcut .docx dosyalarında biçimi bozmadan metin değiştirir; .xlsx, .csv ve .tsv dosyalarında hücre ve formülleri günceller. |
Komutlar ve terminal
| Araç | Ne yapar? |
|---|---|
run_command | Biten işler için PowerShell komutu çalıştırır (test, derleme, git, kurulum). Varsayılan zaman aşımı 120 sn, en fazla 600 sn. |
terminal_run, terminal_read, terminal_stop | Yan panel terminalinde sürekli çalışan süreçleri (geliştirme sunucusu, izleyici) başlatır, çıktısını okur ve durdurur. |
Planlama, devretme ve web
| Araç | Ne yapar? |
|---|---|
update_todos | Çok adımlı işlerde yapılacaklar listesini günceller (bkz. Plan modu ve yapılacaklar listesi). |
delegate | Geniş okuma işlerini işçi modele devreder (bkz. Beyin ve işçi mimarisi). |
web_search, read_webpage | Web araştırması: arama yapar ve sayfaları okur. |
Hangi araçlar onay ister?
| Araç türü | Onay iste | Benim için onayla | Tam erişim |
|---|---|---|---|
| Okuma ve web | Sorar | Otomatik | Otomatik |
| Dosya yazma, düzenleme ve belgeler | Sorar | Otomatik | Otomatik |
Dosya silme (delete_file) | Sorar | Sorar | Otomatik |
| Terminal komutları | Sorar | Sorar | Otomatik |
Komut mu, terminal mi?
| `run_command` | Terminal araçları | |
|---|---|---|
| Ne için? | Biten işler: test, derleme, git, kurulum | Sürekli çalışan süreçler: geliştirme sunucusu, izleyici |
| Süre | Varsayılan 120 sn, en fazla 600 sn | Sen ya da ajan durdurana kadar |
| Nerede görünür? | Sohbette bir adım olarak | Yan paneldeki terminalde ve yazma alanının yanındaki ▶/■ düğmesinde |
| Geri alınabilir mi? | Hayır; kontrol noktalarına dahil değil | Hayır; kontrol noktalarına dahil değil |
Desteklenen dosya türleri
| Tür | Okuma | Oluşturma ve düzenleme |
|---|---|---|
| Metin ve kod | read_file | write_file, edit_file |
read_file | create_document ile yeni PDF | |
| Word (.docx) | read_file | create_document: yeni belge ya da mevcut belgede biçimi bozmadan metin değişikliği |
| Excel ve tablolar (.xlsx, .csv, .tsv) | read_file: formüller ve hücre adresleri korunur | create_document: yeni dosya ya da hücre ve formül güncellemesi |
| Görseller | vision_analysis | — |
Not
Ağır araç setleri her adımda gönderilmez; ihtiyaç anında yüklenir (read_skill). Bu, token kullanımını düşürür (bkz. Ajan becerileri).
Örnek istekler ve kullanılan araçlar
| İstek | Kullanılan araçlar |
|---|---|
| “Bu klasördeki sözleşmeleri özetle.” | list_files, read_file |
| “Ekran görüntüsündeki hatayı açıkla.” | vision_analysis |
| “Teklif belgesindeki fiyatları güncelle.” | read_file, create_document |
| “Testleri çalıştır ve başarısız olanları düzelt.” | run_command, read_file, edit_file |
| “Geliştirme sunucusunu başlat ve adresini söyle.” | terminal_run, terminal_read |
| “Rakiplerin fiyatlarını araştır ve tabloya ekle.” | web_search, read_webpage, create_document |
Sık sorulan sorular
- Ajan hangi aracı kullanacağına nasıl karar verir? İsteğine ve klasöründeki dosyalara göre adımları kendisi planlar; her araç kullanımı sohbette ayrı bir adım olarak görünür, böylece neyin neden yapıldığını izleyebilirsin.
- Excel'deki formüller bozulur mu? Hayır.
read_fileformülleri ve hücre adreslerini korur;create_documenthücreleri ve formülleri güncelleyebilir. - Word belgemin biçimi değişir mi? Mevcut .docx dosyalarında metin, biçim bozulmadan değiştirilir.