Yönergeler, onaylar ve yapılandırma

Asistana net yazım tercihleri verin ve değişiklikleri nasıl ele alacağını seçin. Yönergeler istediğiniz işi tanımlar; onay denetimleri hangi araç eylemlerinin devam edebileceğine karar verir.

Ayarlar → Yapay Zeka Asistanı → Yönergeler. Varsayılan modeli ayarlayın, yönergelerinizi yazın, sonra Yönergeleri kaydet'i kullanın. PDF sayfa yakalama, metin alanının altındadır. Tam ekran görüntüsünü aç

Varsayılan sohbet modeli

Ayarlar → Yapay Zeka Asistanı → Yönergeler bölümünü açın. Yeni bir sohbette kullanılacak modeli belirlemek için Varsayılan sohbet modeli’ni seçin. Liste, yapılandırdığınız sağlayıcılardaki etkin modelleri içerir. Tek bir konuşmada modeli yine de değiştirebilirsiniz.

Özel yönergeler

Tercihlerinizi Özel yönergeler altına yazın, sonra Yönergeleri kaydet’e tıklayın. Bir araştırma makalesi için yararlı bir başlangıç noktası:

Örnek yazma yönergeleri

Use British English and preserve the terminology already used in the paper.
Keep citation keys, labels, equations, and numerical results unchanged unless
I explicitly ask you to edit them.
When a statement needs evidence, mark it for a source check. Do not invent
references or results.
Explain substantive changes briefly so I can review them.

Bu yönergeleri, tüm proje isteklerinizi yinelemeden bir gözden geçirmeye yön verecek kadar somut yazın. Bunlar asistanın yerleşik davranışına eklenir ve araç izinlerini değiştirmez.

Yönergeleri kaydet

Düzenlemeden sonra Yönergeleri kaydet’e tıklayın. Kaydedildi göstergesi kalıcılığı onaylar. Bu alandaki kaydedilmemiş bir düzenleme yeni varsayılanınız olmaz.

Yapay zeka için PDF sayfa yakalamaya izin ver

Asistanın derlenmiş sayfaları görü destekli bir modelle incelemesine izin vermek için Yapay zeka için PDF sayfa yakalamaya izin ver’i etkinleştirin. verify_pdf_pages aracı, düzen denetimleri için derlenmiş sayfaları görsele çevirir. Sayfa görsellerinin yapılandırılan sağlayıcıya gönderilmesini istemiyorsanız bu denetimi kapatın.

Araç kataloğunu inceleyin

Yönergeler sekmesindeki Asistan şu anda bu araçları destekliyor bölümünü genişletin. Asistanın yapabileceği işleri görmek için bunu kullanın; sonra bir bölümü derlemek, PDF’i incelemek ya da çözülmemiş bir başvuru bulmak gibi bir sonuç isteyin.

Personalar

Ayarlar → Yapay Zeka Asistanı → Personalar. Persona oluştur listenin üstündedir; düzenleme ve silme denetimleri her personanın yanında durur. Tam ekran görüntüsünü aç

Persona, adlandırılmış bir yönerge hazır ayarıdır. Ayarlar → Yapay Zeka Asistanı → Personalar altında bir tane oluşturun, sonra belirli bir iş türü için onu ileti alanından seçin. Örneğin, kısa bir redaksiyon personası ve ayrı bir inceleyici persona bulundurun.

Etkin bir persona, konuşmanın yönerge hazır ayarını varsayılan özel yönerge metni yerine sağlar. Personanın da gereksinim duyduğu kalıcı tercihleri içine yazın. Persona yönlendirmeyi değiştirir; araç izni vermez.

Bir onay kipi seçin

İleti alanının altındaki onay menüsünü açın. Seçili kip onay işaretiyle gösterilir; projeniz için istediğiniz ilkeyi seçin. Tam ekran görüntüsünü aç

İleti alanındaki onay seçicisini kullanın. Seçim geçerli proje için kaydedilir.

Kip	Davranış
Onay iste	Okuma sınıfındaki araçlar çalışabilir; diğer eylemler önce sorar
Benim için onayla	Okuma ve ağ araçları çalışabilir; dosya değişiklikleri ve kabuk komutları önce sorar
Tam erişim	Bir deny kuralının engellediği araçlar dışında, araç eylemleri onay istemeden devam edebilir
Özel	Kayıtlı allow ve deny kuralları uygulanır; kuralı olmayan araçlar standart risk ilkesini kullanır

Varsayılan kip Benim için onayla’dır. Bazı araçların bir işlem içinde kendi denetimleri vardır. PDF derlemek ve incelemek, bir kaynak dosya yazmaktan ya da kabuk komutu yürütmekten farklı ele alınır.

Önerilen bir eylemi onaylayın

Onay kartındaki araç adını ve önerilen işlemi okuyun. Bu eylemi çalıştırmak için onaylayın ya da önerilen değişikliğin uygulanmaması için reddedin. İstenen eylem fazla genişse, konuşmaya daha dar bir yönergeyle devam edin.

Bu projede her zaman

Özel kipte, bir araç için kural kaydetmek üzere onay istemindeki Bu projede her zaman seçeneğini kullanın. Bir kuralın sonraki çalıştırmayı etkilemesini bekliyorsanız seçili kipi denetleyin.

Bir kuralı gözden geçirin ya da kaldırın

Proje açıkken Ayarlar → Yapay Zeka Asistanı → Sağlayıcılar ve anahtarlar bölümüne gidin ve Araç onayları’na inin. Her satır, araç adını ve her zaman izinli mi yoksa reddedilmiş mi olduğunu gösterir. Bir aracı Özel kipte standart risk ilkesine döndürmek için kuralını kaldırın.

approvals.toml dosyasını düzenleyin

Araç onayları’nın altındaki Onay kuralları dosyası, ~/.oleafly/approvals.toml dosyasını düzenler. Geçerli dosyayı okumak için Yeniden yükle’yi, kaydedilmemiş düzenlemeleri bırakmak için Değişiklikleri at’ı, örnek bir yapılandırmayla başlamak için Bir örnek ekle’yi kullanın. Dosya nasıl çalışır biçimi açıklar ve açık projenin kimliğini gösterir. Kaydetme, uygulamadan önce TOML’u doğrular; kurallar bir sonraki araç çağrısından itibaren geçerli olur.

Dosya, bir kip tablosu ve görünen ad yerine proje klasörü kimliğiyle anahtarlanmış araç kuralı tabloları içerir:

~/.oleafly/approvals.toml

["$approval_modes"]
"my-project-folder-id" = "custom"

["my-project-folder-id"]
write_file = "allow"
replace_in_file = "allow"
run_command = "deny"
delete_file = "deny"

my-project-folder-id yerine projenizin gerçek klasör kimliğini yazın. Proje kimlikleri, ~/.oleafly/projects altındaki klasör adlarıdır. Kip değerleri ask-for-approval, approve-for-me, full-access ve custom’dur. Listede olmayan bir proje Benim için onayla’yı kullanır. Araç kuralı değerleri allow ve deny’dir. Bir deny kuralı Tam erişim dahil her kipte geçerlidir; bu yüzden reddedilen bir araç hiç çalışmaz. Bir allow kuralı yalnızca Özel kipte geçerlidir. Kuralı olmayan bir araç normal risk ilkesini kullanır.

# ile başlayan açıklamalar Ayarlar’dan yapılan bir kayıtta korunur; ancak bir onay kartında Bu projede her zaman’ı seçmek dosyayı onlarsız yeniden yazar.

Katalogdaki tam araç adlarını kullanın. Sık kullanılan adlar arasında write_file, replace_in_file, create_file, rename_file, delete_file, run_command, compile, insert_figure ve set_main_doc vardır.

Hangi yapılandırma dosyasını kullanmalıyım?

Dosya	Amaç
~/.oleafly/config.json	Ayarlar üzerinden yönetilen uygulama yapılandırması
~/.oleafly/approvals.toml	Proje onay kipleri ve araç başına kurallar
~/.oleafly/agent.toml	İleri düzey çoklu ajan sınırları ve yönergeleri
Dış ajanınızın yapılandırması, örneğin ~/.codex/config.toml	O ajanın kendi ayarları ve MCP bağlantıları

Oleafly, tüm bu ayarlar için tek bir config.toml kullanmaz. Sağlayıcı anahtarları ve uygulama tercihleri için Ayarlar arayüzünü kullanın; kimlik bilgilerinin ayrı, şifrelenmiş bir deposu vardır. Uygulamanızın tüm yapılandırmasını kısa bir örnekle değiştirmeyin.

agent.toml dosyasını yapılandırın

İleri düzey kullanıcılar, asistanın çoklu ajan ayarlarını ince ayarlamak için ~/.oleafly/agent.toml oluşturabilir. Bu ayarlar, bağlı bir CLI ajanının yapılandırmasından ayrı olarak Oleafly’nin kendi ajan çalışma zamanını yönetir.

~/.oleafly/agent.toml

maxAgentDepth = 2
maxConcurrentSubagents = 8
minWaitTimeoutMs = 1000
maxWaitTimeoutMs = 300000
defaultWaitTimeoutMs = 120000
waitAgentEnabled = true

usageHintText = """
Delegate independent checks with clear scopes. Keep writing decisions with
the parent agent, and close completed agents when their work is collected.
"""

subagentDeveloperInstructions = """
Work only on the assigned task. Report the files and evidence you inspected.
Do not spawn additional agents.
"""

maxAgentDepth

İç içe derinliği sınırlar. Varsayılan 2’dir: bir çalıştırmanın alt öğeleri daha fazla iş devretmez. Kabul edilen en küçük değer 1’dir.

maxConcurrentSubagents

Bir oturumdaki eşzamanlı alt ajanları sınırlar. Varsayılan 8, en küçük değer 1’dir. Daha çok ajan model kullanımını artırabilir; gerçekten bağımsız yürüyebilen işler için sınırı yükseltin.

minWaitTimeoutMs

Bir ajan bekleme süresinin alt sınırını milisaniye cinsinden belirler. Varsayılan 1000’dir.

maxWaitTimeoutMs

Bir ajan bekleme süresinin üst sınırını belirler. Varsayılan 300000’dir, yani beş dakika. Bu değer minimumda ya da üzerinde tutulur.

defaultWaitTimeoutMs

Varsayılan bekleme süresini belirler. Varsayılan 120000’dir, yani iki dakika. Değerler, yapılandırılmış alt ve üst sınırlara göre kısıtlanır.

waitAgentEnabled

Bekleme ajanı yeteneğinin kullanılabilirliğini denetler. Varsayılan true’dur.

usageHintText

Ana ajana iş devretme rehberliği sağlar. Yukarıdaki örnek, varsayılan rehberliği kendi metninizle değiştirir.

subagentDeveloperInstructions

Alt ajanlara yönergeler sağlar. Kapsamı, raporlama beklentilerini ve daha fazla iş devretmenin uygun olup olmadığını belirtmek için kullanın.

Çalışma zamanı bu anahtarların max_agent_depth gibi snake_case sürümlerini de kabul eder. Atlanan alanlar varsayılanları kullanır. Eksik ya da bozuk bir dosya varsayılanlara döner; bu yüzden söz dizimini dikkatle denetleyin ve yapılandırmayı değiştirdikten sonra yeni bir çalıştırma başlatın.

Bir kuralı küçük bir görevle sınayın

1. Bir alıştırma projesi açın ve Onay iste’yi seçin.
2. Şunu isteyin: “Ana belgeyi oku ve daha net bir başlık öner. Dosyayı değiştirmeden önce sor.”
3. Önerilen değişikliği inceleyin ve onaylayın ya da reddedin.
4. Özel kipe geçmeden önce kayıtlı kuralları Ayarlar’da gözden geçirin.
5. Düzenlemeler başlamadan önce birkaç adım üzerinde anlaşmak istediğinizde Plan kipi özelliğini kullanın.

Oleafly MCP üzerinden bağlanan dış asistanlar, ayrıca yapılandırılan MCP sunucusunun ilkesini kullanır.