QuickAgent Kullanım Kılavuzu
QuickAgent yerel öncelikli bir AI aracı çalışma alanıdır. Bir hedefi kalıcı bir Run'a dönüştürür, bu Run'ı bir Workspace Profile ile sınırlar, hassas işlemlerden önce inceleme ister ve doğrulanmış sonuçları Artifacts'ta tutar.
Başlarken
- Şunu açın: Settings > AI, bir sağlayıcı ekleyin ve bağlantı testini çalıştırın.
- Şunu açın: Settings > Workspace Profiles. Hangi sağlayıcının, araçların, bağlantıların, dosya köklerinin, Knowledge kaynaklarının ve Memory kapsamlarının kullanılabileceğini seçin.
- Seçin New Chat, profili seçin ve konuşmanın üstünde gösterilen sağlayıcı hedefini onaylayın.
- Bir sonuç tanımlayın. Bu Run için yalnızca gereken dosyaları, klasörleri, medyayı, Knowledge'ı veya Memory'yi ekleyin.
- Göründüklerinde planı, onayları, Critical onayını ve Data Send Preview'u inceleyin.
- Çalışmayı Timeline'da izleyin. Tamamlanan çıktıyı şuradan açın: Artifacts ve denetim izini şurada inceleyin: Geçmiş.
Arayüze Genel Bakış
| Bölüm | Ne için kullanılır |
|---|---|
| Sohbetler | Konuşmalar, sağlayıcı hedefi, Context Tray, planlar, onaylar ve etkin Run Timeline. |
| Çalıştırmalar | Planlanan, çalışan, duraklatılan, zamanlanan, başarısız olan veya tamamlanan her görev. |
| Onay Gelen Kutusu | Kararınızı bekleyen bekleyen işlem, Critical ve Data Send incelemeleri. |
| Artifacts | Run'lar tarafından oluşturulan doğrulanmış dosyalar, raporlar, günlükler, medya, tablolar ve işlem bildirimleri. |
| Otomasyonlar | Zamanlamalar, izleyiciler, web kancaları, uygulama etkinlikleri ve Shortcut/App Intent tetikleyicileri. |
| Skills | Türü belirlenmiş girdiler, izin verilen araçlar, gerekli bağlantılar, risk ve çıktılar içeren yeniden kullanılabilir talimatlar. |
| Bağlantılar | Sağlayıcılar, tarayıcı profilleri, dosya/VFS kökleri, SSH, MCP, HTTP/SaaS, ev köprüleri ve bildirim kanalları. |
| Knowledge | Dizinlenmiş klasörler, QuickNote içeriği, web klipleri, PDF'ler ve Office kaynakları. |
| Geçmiş | Salt eklemeli güvenlik kararları, araç işlemleri, hedefler ve zaman damgaları. |
| Ayarlar | Görünüm, dil, AI, araçlar, güvenlik, Workspace Profiles, kısayollar, izinler, Help ve Pro. |
Sağlayıcılar ve Workspace Profiles
QuickAgent, işletim sistemi uyumlu bir yetenek sunduğunda System AI'ı; Ollama, LM Studio veya DeskLLM gibi yerel sağlayıcıları; LAN ya da özel OpenAI uyumlu uç noktaları; ayrıca Anthropic veya Gemini gibi yapılandırılmış bulut sağlayıcılarını kullanabilir. Kullanılabilirlik canlı yetenek testiyle belirlenir; tek başına sağlayıcı adı, hazır olduğu anlamına gelmez.
Workspace Profile, Run'ın izin çerçevesidir. Seçili sağlayıcı/modeli, izin verilen araçları, bağlantıları, dosya köklerini, Knowledge kaynaklarını, Memory kapsamlarını, güvenlik geçersiz kılmalarını ve bütçeyi anlık olarak kaydeder. Sonraki bir yapılandırma değişikliği bu anlık görüntüyü güncelliğini yitirmiş hâle getirir ve inceleme gerektirir.
Run'lar, Onaylar ve Kurtarma
Run denetimleri
- Duraklat kalıcı bir denetim noktasında işbirlikçi bir durdurma isteğinde bulunur.
- Sürdür aynı Run'ı ve tamamlanan işi sürdürür.
- Durdur sağlayıcı ve araç çalışmasını iptal eder. Durdurulmuş veya belirsiz bir harici etki başarı olarak bildirilmez.
- Yeniden dene yalnızca QuickAgent güvenli bir yeniden deneme sınırı belirleyebildiğinde kullanılabilir.
Güvenlik seviyeleri
| Seviye | Anlamı |
|---|---|
| Güvenli | Etkin profil içinde okuyun, inceleyin veya dönüştürün. |
| Onayla | Normal bir yazma ya da harici eylemi inceleyin. |
| Şunun açık olduğunu doğrulayın: | Etkisi daha yüksek veya geri alınması daha zor bir değişikliği inceleyin. |
| Kritik | Her seferinde güçlü onay gerekir; kurallar bunu asla otomatik onaylamaz. |
Onay, tam hedefi, hedef yeri, önerilen bağımsız değişkenleri, riski ve Geri Al durumunu gösterir. Bir bağımsız değişkeni düzenlerseniz QuickAgent düzenlenen eylemi yeniden doğrular ve risk kontrolünden geçirir.
Çoklu Aracı Run'ları
Karmaşık hedeflerde bir planlayıcı, tür tanımlı uzman çalışanlar, bir gözden geçiren ve bir güvenlik gözden geçireni kullanılabilir. Timeline her devri, incelemeyi, yeniden denemeyi, geri dönüşü ve nihai yanıt sınırını gösterir. Çalışanlar yalnızca Skill araçları, Workspace Profile araçları, rol araçları ve o anda etkin olan araçların dört yönlü kesişimini alır.
Genel ve rol başına bütçeler çağrıları, süreyi, maliyeti, ağ baytlarını ve belirteçleri sınırlar. Bütçeye ulaşıldığında QuickAgent duraklar. Geçerli ve önerilen sınırları gösterir ve bunları yalnızca açık incelemeden sonra artırır. Onaylanan bütçe ve tamamlanan rol geçmişi yeniden başlatmadan sonra korunur.
Bağlam, Knowledge ve AI Memory
Context Tray
Dosyalar, klasörler, görseller, video kareleri, ses, sesli notlar, QuickNote içeriği, Knowledge veya Workspace Memory ekleyin. QuickAgent desteklenen içeriği çıkarır ya da özetler ve bir ekin doğrudan sağlayıcıya gönderilip gönderilmeyeceğini gösterir.
Knowledge
Knowledge kaynakları sohbetten ayrı dizine eklenir. Bir Run yalnızca Workspace Profile tarafından izin verilen kaynaklarda arama yapabilir ve alıntılar kaynak kimliğini korur.
Memory
Memory, otomatik sohbet geçmişi değil, bilinçli bir tercihtir. User, Workspace, Project ve Tool/Connection kapsamları ayrıdır. Her oluşturma, düzenleme veya silme isteği yeni bir onay alır; onay önizlemesi kapsamı ve önerilen değeri tam olarak gösterir.
Araçlar ve Bağlantılar
Canlı katalog; dosya/VFS işlemlerini; Office, PDF ve yapılandırılmış veriyi; medya ve OCR'yi; tarayıcı ve bilgisayar kullanımını; geliştirme komutlarını; SSH'yi; MCP'yi; HTTP ve SaaS'ı; akıllı ev köprülerini; bildirimleri; zamanlamaları; izleyicileri ve otomasyon denetimini kapsar. Bağlı MCP sunucuları, şema doğrulaması ve QuickAgent risk yeniden değerlendirmesinden sonra dinamik araçlar ekleyebilir.
Settings > Tools bir aracın neden hazır ya da devre dışı olduğunu gösterir. Yaygın nedenler eksik bağlantı, işletim sistemi izni, desteklenmeyen platform, Workspace Profile kısıtlaması, test edilmemiş uç nokta veya kullanılamayan sağlayıcı yeteneğidir.
Otomasyonlar
Platform desteklediğinde otomasyonlar zaman, dosya/klasör, web, webhook, e-posta, takvim, ağ, ana bilgisayar, cihaz, sensör, konum, uygulama olayı, Shortcut/App Intent, komut veya manuel tetikleyicilerden başlayabilir. Tetikleyici sıradan bir Run oluşturur; Workspace Profile, onay, Critical veya Data Send kontrollerini atlamaz.
- Masaüstü izleme yalnızca uygulama işlemi çalışırken sürer.
- Mobil platformlar, uygulama ön plana döndüğünde gecikmiş işi kurtarır.
- İşletim sistemi teslimi gerektiğinde Shortcut/App Intent veya güvenilir bir olay aktarıcısı kullanın.
- Kuyruktaki olaylar, duraklatma, iptal ve silme açık kalır; böylece olaylar sessizce atılmaz.
Skills ve Skill Packs
Bir Skill; sonuç odaklı istemi, tür tanımlı değişkenleri, sağlayıcı önerisini, izin verilen araçları, gerekli bağlantı ve yetenekleri, azami riski ve beklenen Artifacts'ı saklar. Kullanımdan önce QuickAgent girdileri ve etkin izinleri gösterir; önizleme kendi başına izin vermez.
Yedi yerleşik Pack; Office, Coding, Smart Home, Research, Browser Automation, Personal Admin ve Incident Response için gerçek Skills sunar. Skills'i yükleyebilir, güncelleyebilir, kaldırabilir, özelleştirebilir, çoğaltabilir, içe ve dışa aktarabilirsiniz. İçe aktarılan JSON; güven, yayıncı, imza, izin, risk, platform ve çakışma önizlemesi alır. “Her ikisini de tut”, başka bir yayıncının güvenini devralmak yerine imzasız yerel bir türev oluşturur.
Artifacts, Geçmiş ve Geri Al
Artifacts; çıktı baytlarını, meta verileri, sürümleri, köken bilgilerini, kaynak Run'ı ve işlem bildirimlerini saklar. Platform yeteneğine bağlı olarak bunları açabilir, paylaşabilir, dışa aktarabilir veya gösterebilirsiniz. Uygun işlemler incelenmiş bir Geri Al sunar; yıkıcı veya belirsiz işler asla otomatik olarak yeniden oynatılmaz.
Geçmiş yalnızca eklemelidir. Safe, Approve, Confirm veya Critical ile filtreleyin ve harici bir kayda ihtiyacınız olduğunda denetim kaydını dışa aktarın.
Ayarlar
- Genel: görünüm, dil, Workspace Profiles, kısayollar, Help ve izinler.
- AI: sağlayıcılar, uç noktalar, modeller, kimlik bilgileri ve canlı testler.
- Tools: katalog hazırlığı, platform desteği ve kurulum nedenleri.
- Safety: onay kuralları, Data Send davranışı, cihaz kimlik doğrulaması ve kapsamlı Memory ilkesi.
- Advanced: sorun giderme için tasarlanmış kurtarma ve tanılama.
Klavye Kısayolları
macOS'te uygulama, gösterilen Ctrl kısayollarını uygun olduğunda platformun Command tuşuna eşler. Uygulama içi Shortcuts sayfası yetkili kaynaktır ve özelleştirmeyi destekler.
| Kısayol | Eylem |
|---|---|
| Ctrl + N | New Chat |
| Ctrl + L | Oluşturucuya odaklan |
| Ctrl + Shift + Space | Etkin Run'ı duraklatın veya sürdürün |
| Ctrl + . | Etkin Run'ı durdurun |
| Ctrl + 1 … 9 | History üzerinden Chats'i açın |
| Ctrl + , | Settings'i açın |
| F1 | Help & Privacy'ı açın |
| Esc | Bir iletişim kutusunu kapatın veya mevcut yıkıcı olmayan etkileşimi iptal edin |
Platform Notları
| Platform | Önemli sınırlar |
|---|---|
| macOS | Debug ve Release'te sandbox'lıdır. Dosya erişimi seçili kökleri/güvenlik kapsamlı yer imlerini kullanır. Screen Recording ve Accessibility ayrı sistem izinleridir. Yerel işlem ve Shortcut entegrasyonları yetenek testine bağlı kalır. |
| Windows | Dosya, Office/PDF/veri, tarayıcı, geliştirme, uzak ve masaüstü denetim özellikleri yüklü çalışma zamanına ve izinlere bağlıdır. Yalnızca Apple'a özgü entegrasyonlar görünür bir nedenle kullanılamaz. |
| iPhone / iPad | Dosyalar sistem seçicisini kullanır. Kamera, mikrofon, konuşma, fotoğraflar, yerel ağ ve bildirimler bağlam içinde istenir. Arka plan izleme garanti edilmez; Shortcuts/App Intents veya ön plan telafisi kullanın. |
| Android | Dosyalar ve klasörler Storage Access Framework'ü kullanır. Arka plan çalışması Android kısıtlamalarına uyar. Erişilebilirlik tabanlı girdi denetimi, yalnızca bir hizmet bildirildi diye asla verilmiş sayılmaz. |
| Web | Yerel kalıcılık gerektiren özellikler için yalnızca oturumluk depolama kullanır ve desteklenmeyen cihaz, dosya kökü, yerel işlem ve arka plan yeteneklerini açıkça devre dışı bırakır. |
İpuçları & Püf Noktaları
Sorun Giderme
| Sorun | Kontrol edilecekler |
|---|---|
| Sağlayıcı çalışamıyor | Settings > AI'ı açın. Yapılandırmayı, kimlik doğrulamayı, model yeteneğini, uç nokta erişilebilirliğini, zaman aşımı ve hız sınırı ayrıntılarını kontrol edin; ardından bağlantı testini çalıştırın. |
| Bir araç devre dışı | Settings > Tools'u açın ve canlı nedeni okuyun. Geçerli platformu, izni, bağlantı testini, Workspace Profile'ı ve seçili kökü inceleyin. |
| Bir Run takılmış görünüyor | Runs ve Timeline'ı açın. Duraklatılmış, girdi, onay, Critical onayı, Data Send incelemesi veya bütçe incelemesi bekliyor olabilir. Stop kullanılabilir kalır. |
| Bir izin değişti | Help > Overview veya Settings'i açın, ardından sistem ayarlarını açın. Döndükten sonra etkilenen bağlantıyı veya aracı yeniden test edin. |
| Bir harici eylem belirsiz | Hedef sistemi kontrol edin. Yeniden denemenin uygun olduğunu doğrulamadıysanız Run'ı duraklatılmış tutun veya Stop edin. |
| Bir Automation arka planda tetiklenmedi | Mobil işletim sistemleri keyfi yoklamayı garanti etmez. Telafi için ön plana dönün veya bir Shortcut/App Intent ya da güvenilir olay kaynağı yapılandırın. |
| Bir Artifact açılamıyor veya dışa aktarılamıyor | Baytlarının hâlâ kullanılabilir olup olmadığını, platformun eylemi destekleyip desteklemediğini ve seçilen hedef izninin hâlâ geçerli olup olmadığını kontrol edin. |
Gizlilik, İzinler ve Lisanslar
QuickAgent; konuşmaları, Run'ları, onayları, Knowledge meta verilerini, Skills'i ve ayarları yerel olarak saklar. Kimlik bilgileri platform tarafından korunan depolamayı kullanır. İçerik, yalnızca yapılandırdığınız bir sağlayıcı veya bağlı hizmet aracılığıyla cihazdan ayrılır ve harici gönderimler hedefe duyarlı önizleme alır.
İzinler bağlam içinde istenir: dosyalar/klasörler, fotoğraflar, kamera, mikrofon, konuşma tanıma, yerel ağ, bildirimler, ekran kaydı ve erişilebilirlik/girdi denetimi bağımsızdır. Bir iznin kaldırılması, sahte başarı üretmek yerine etkilenen yeteneği kullanılamaz hâle getirir.
Şunu açın: Settings > Help & Privacy geçerli platform yetenek tablosu için ve Açık kaynak lisansları paket ve paketlenmiş yerel bildirimler için.