Yetkiler ve ön ayarlar

Yetki nedir

Yetki, shell.full ya da git.commit gibi domain.grade biçiminde tek bir addır. Bir preset bu adlardan bir küme tanımlar; ivralo da her birine karşılık gelen araçları bağlar. Böylece "bu uzmanın hangi araçları var" sorusunun cevabı tek satırlık bir veridir.

Yetki hiçbir zaman kuralları atlatmak demek değildir. shell.full'a sahip olmak, uzmanın shell aracını taşıdığı anlamına gelir, o kadar; her komutu yine shell politikası değerlendirir. Neyin bağlanacağına yetkiler karar verir, neye izin verileceğine araçlar karar verir; onay isteyen şeyi de yine bir insan onaylar.

Her yetkinin pratikte önemli olan üç özelliği vardır:

• Koşul. Bazı yetkiler yalnızca bir ayar onları desteklediği sürece geçerlidir; örneğin bir anahtar ayarlanmışsa ya da çalışma alanı bir git repo'suysa. Google ve GitHub'ın yazma seviyeleri ayrıca onaylayacak birinin başta olmasını gerektirir.
• Onay. Her kullanımda "evet" diyen kim: hiç kimse (none), shell politikasının o komut için verdiği karar (verdict), her çağrıda onay veren ve bunu oturum boyunca kaldırabilen bir kişi (call) ya da her çağrıda, kaldırma imkânı olmadan onay veren bir kişi (always).
• Strict. strict profilinin bu yetkiyi kaldırıp kaldırmadığı.

Yetki listesi

ivralo doctor bu tabloyu, her uzmanın yapılandırmanıza göre sahip olduğu yetkileri ve ana ajanın nelere sahip olduğunu yazdırır.

Temel küme

Her uzman sekiz yetkiyi tanımlamaya gerek kalmadan alır:

Bir preset temel kümedeki bazı yetkilerden vazgeçebilir. Incident Investigator Python'dan, yazmadan, ekip arkadaşına soru sormaktan, veritabanlarından ve fotoğraflardan vazgeçer; böylece kanıtın içine gizlenmiş bir talimatın kullanabileceği hiçbir aracı olmaz.

Strict profili

IVRALO_PROFILE=strict ya da bir komuttaki --profile strict, çalışma alanının dışına uzanan ya da repo'nuzu değiştiren her şeyi kaldırır: shell.full, network.web, mail.send, message.send, google.write, github.write, code.edit, git.commit ve git.push. MCP sunucuları da bağlanmaz. code.read kalır; yani strict bir ekip kodu yine okuyabilir.

Profil, kapsanan yetkiler eklendikten sonra ad ad uygulanır; bu yüzden google.write kaldırılınca onun kapsadığı google.read yerinde kalır. Profil yalnızca kısıtlar. Yapacak işi kalmayan bir uzman ekipten çıkar; strict altında Courier'nin çıkması gibi.

database.read ve photos.fetch temel kümenin parçası olduğu için şimdilik kaldırılamaz.

Başında kimse olmayan run'lar ve sunucu modu

Başında kimsenin olmadığı bir run'a, örneğin bir pipe'a, bir zamanlamaya, bir job'a ya da bu şekilde gönderilmiş bir API isteğine, onay isteyecek hiçbir yetki verilmez. İstisnaları mod belirler:

permissions.json içindeki allow_tools de, adı yazılan düzenleme ve git araçlarını bu tür run'lar için açar. Ayrıntılar Sunucu modu sayfasında.

Preset'ler

Preset, bir uzmanın kurulduğu tanımdır: bir anahtar, görünen bir ad, temel kümenin dışında sahip olduğu yetkiler, ne işe yaradığını anlatan tek bir cümle ve bir araç çağrısı sınırı. Kendine ait bir prompt'u yoktur. Her uzman skill rafının tamamıyla kurulur; kendi sahip olduğu skill'ler en önde gelir ve /skill <name> bir isteği bu sahibe gönderir.

20 araç çağrısı IVRALO_TOOL_CALL_LIMIT'in varsayılanıdır; tek bir uzmanın sınırını IVRALO_TOOL_CALL_LIMIT_<KEY>, modelini IVRALO_MODEL_<KEY> belirler. Code Engineer'ın Python kodu dosya yazamaz: değişiklikleri, her değişikliği gösterip onay isteyen düzenleme araçlarından geçer.

Koşullu yetkiler tanımlayan bir uzman, bunlardan en az biri geçerli olduğu sürece ekipte kalır; shell.full gibi koşulsuz bir yetki onu ekipte tutmaya yetmez. Bu yüzden dizin ve web ikisi de kapalıysa Librarian, e-posta altyapısı ya da sohbet kanalı yoksa Courier, Google hizmeti yoksa Secretary, token yoksa GitHub Clerk, git repo'sunun dışındaysanız Code Engineer ekipten çıkar.

Ana ajan

Konuştuğunuz ajan ana ajandır. Bir uzman gibi kurulur: main preset'inden, aynı araç setleri, onaylar ve sınırlarla. İşin çoğunu kendisi yapar: dosyaları ve kodu okur, yalnızca okuyan Python çalıştırır, kodu onay isteyen düzenleme araçlarıyla değiştirir ve projenin kontrollerini çalıştırır. Temiz bir bağlam ya da daha dar bir yetki gerektiğinde işi bir uzmana devreder.

Yetkileri miras alınmaz, tek tek tanımlanır. Preset'lerin tanımladığı bütün yetkilerin birleşimine ve temel kümeye sahip olabilir; şunlar hariç:

• hesaplarınızdan birini okuyan bütün yetkiler: google.read, google.write, github.read, github.write ve database.read. Bunlar sizin onayladığınız uzmanda kalır;
• team.ask, çünkü ana ajan soru sormak yerine işi devreder;
• incident.read ve incident.report, çünkü incident raporunu yalnızca Investigator yazar.

Geriye şunlar kalır: python.run, filesystem.read, filesystem.write, user.ask, team.run, photos.fetch, shell.full, index.search, network.web, mail.send, message.send, code.read, code.edit, git.commit ve git.push. Her biri yine kendi koşuluna, profile ve onay kuralına tabidir.

IVRALO_MAIN_GRANTS bu kümeyi daraltır: virgül ya da boşlukla ayrılmış yetki adları ya da none. Tanımlı kümenin dışındaki ya da var olmayan bir ad kümeyi hiçbir zaman genişletmez; hangi adların yok sayıldığını ivralo doctor söyler. Küme ne kadar daraltılırsa daraltılsın ana ajan team.run'ı korur; böylece işi her zaman bir uzmana devredebilir.

# Ana ajan yalnızca okur; yazmayı uzmanlar yapar.
IVRALO_MAIN_GRANTS="filesystem.read code.read python.run"

ivralo incident ve POST /incident, iş devretmekten başka hiçbir yetkisi olmayan bir ana ajan kurar; böylece incelemeyi Investigator yapar.