Ajanlar ve karakterler — AiHummer Belgeler

Bir ajan bir konuşmanın önüne AiHummer tarafından konulan birimdir. Her ajanın bir kişiliği, kendi modeli, yapılandırılmış bir yönlendirmesi ve bir beceri seti vardır ve ona yapılan her değişiklik sürümlenir. Ajanlar web yönetici arayüzünden ve yönetici API’si üzerinden yönetilir. /v1/admin/agents/*.

Bu sayfa, bir ajanın ne ile yapıldığını, yapılandırılmış ‘G3’ komutunun nasıl oluşturulduğunu ve bir ajanın kendi profilini güvenli bir şekilde nasıl düzenleyebileceğini kapsar.

Ajan kaydı

Kayıt, ajanların tam CRUD kataloğudur. Her ajan için bir kimlik, bir kişilik, çalıştığı model ve kullanabileceği becerileri tanımlarsınız. Geçit çok kiracılı olduğundan, ajanlar bir çalışma alanı içinde yaşar ve diğer kiracı verileri gibi izole edilirler.

Kişilik — ajanın sesi ve davranışı, sabit bir şekilde aktarıldı, sistem isteminin önbelleğe dost katmanı.
Ajan başına model — her ajan kendi modelini ve sağlayıcısını sabitleyebilir, böylece Ucuz bir ajan ve bir amiral gemisi ajanı aynı çalışma alanında bir arada bulunabilir.
Beceriler — ajan başına ve paylaşılan beceriler, bir “Beceriler” bloğunu şuna dönüştürür istem; bunlar ağırlıkları değil, yetenekleri tanımlar.

[!NOTE] Bir ajan başına model yönlendirmeden bağımsızdır. Model katmanı yönlendirmesi (basit / standard / complex) bir tur için bir model sınıfı seçer, oysa her ajan için model, ajanının kendi varsayılanıdır. Bakınız Yönlendirme.

Sürümler, geri alma ve klonlama

Bir ajan üzerindeki her anlamlı değişiklik olarak yakalanır sürüm. Bu, ajan yapılandırmasının denetlenebilir ve geri alınabilir olmasını sağlar: nelerin değiştiğini gözden geçirebilirsiniz, geri almak daha önceki bir sürüme veya klon bunu yeni bir tane başlatmak için başlangıç noktası olarak kullanacak bir ajan. Versiyon ve profil kaynakları altında bulunur /v1/admin/agents/* (profil, bölümler, beceriler, sürümler).

[!TIP] Büyük bir kişilik veya istem yeniden yazımından önce çalışan bir ajanı klonlayın. Eğer yeni yön işe yaramazsa, orijinal hâlâ bir geri alma uzaklıktadır.

Yapılandırılmış “G3” istemi

Tek bir serbest metin sistemi istemi yerine, AiHummer bir yapılandırılmış ajan profili (dahili olarak “G3”). Kimlik alanlara ayrılmış düz yazıya gömülmek yerine ve promptun geri kalanı isimlendirilmiş öğelerden oluşturulmuştur bölümler artı bir işe alıştırma blok. Orkestratör bunları katmanlı sistem istemine dönüştürür, sabit parçaları (kimlik, kişilik, bölümler) önbelleğe alınabilir bir önek olarak tutar ve değişken verileri en sona ekler.

Yapı, bir profili alan bazında kolayca düzenlemeyi, sürümler arasında farkı kolayca görmeyi ve tahmin edilebilir biçimde görüntülemeyi sağlar — gizli bir istem karışımı yoktur.

G3 profile
├── identity fields   (decomposed: name, role, ...)
├── sections          (named, ordered prompt blocks)
└── onboarding        (first-run guidance)

Bir onay kapısının arkasında kendi kendini düzenleme

Bir ajana izin verilebilir kendi profilini düzenle kendi düzenleme araçlarını kullanmak — örneğin bir bölümü geliştirmek veya onboarding’ini güncellemek için. Bu kasıtlı olarak korunmuştur:

Kendi kendine yapılan düzenlemeler şuradan geçer onay geçidi: önerilen bir değişiklik kaydedilir ve yürürlüğe girmeden önce bir insan tarafından onaylanmalıdır. Reddedilen bir değişiklik asla uygulandı.
Değişiklik yeni bir şekilde yakalanır sürüm, bu nedenle kendi kendine yapılan bir düzenleme de denetlenebilir niteliktedir ve herhangi bir manuel düzenleme kadar tersine çevrilebilir.

[!WARNING] Kendi kendine düzenleme güçlüdür. Bir ajan yapamasın diye onu onay kapısının arkasında tut. kendi kimliğini sessizce yeniden yaz. Önerilen kendi düzenlemelerini senin yaptığın gibi gözden geçir Herhangi bir ayrıcalıklı değişikliği gözden geçirin.

E-posta şifreleri kasaya gider

Eğer bir ajanın yapılandırması posta kimlik bilgilerini içeriyorsa (için mail araç), şifre şuraya yazılır şifrelenmiş kimlik bilgisi deposu, profilde saklanmaz veya isteme eklenmez. Sırlar hiçbir zaman model bağlamına girmez.

Çalışma politikası: bağlam, oturumlar ve alt ajanlar

1.3 sürümünden itibaren bir ajanın çalışma politikası vardır — yönetim API’sindeki runtime_policy alanı (oluşturma ve güncellemede /v1/admin/agents). Bu, "version": 1 içeren sıkı doğrulanan bir JSON nesnesidir: boş {} varsayılanları geri getirir, güncellemede alanın atlanması önceki politikayı korur; bilinmeyen alanlar ve izin verilen sınırlar dışındaki değerler reddedilir. Politika araç vermez ve hakları genişletmez — yalnızca bütçeleri ve süreleri belirler. Ajanın klonu ve ona tur devri bunu miras alır.

context — geçmiş bütçesi: max_tokens, reserve_tokens ve history_share isteğe ne kadar geçmişin gireceğini belirler; max_history_messages mesaj penceresini, bootstrap_max_chars profil bloğunun boyutunu sınırlar. Bağlam açıkça belirlendiğinde eski mesajlar, geçerli istek oluşturulmadan önce parçalar halinde özete sıkıştırılır.
- pruning — eskimiş araç sonuçlarının temizlenmesi: süreye göre (ttl_seconds), son yanıtlar korunarak (keep_last_assistants), yumuşak kırpma (soft_trim_ratio, head_chars, tail_chars) ve hard_clear_ratio aşıldığında placeholder metniyle tam değiştirme. Kullanıcı metni, görseller ve veritabanındaki tam geçmişe dokunulmaz.
- memory_flush — sıkıştırmadan önce araçsız ajan hedefler, kararlar ve bitmemiş işler hakkında kısa bir not yazar (soft_threshold_tokens); aynı diyaloğun son üç notu doğrulanmamış referans olarak bağlama katılır.
session — diyaloğun yaşam döngüsü: idle_reset_minutes aradan sonra yeni bağlam başlatır (ham geçmiş korunur), index_prune_after_days ve index_max_entries eski diyalogları silmeden varsayılan listeden çıkarır. scope = per-peer (tüm kanallarda doğrulanmış kullanıcı başına tek diyalog) veya per-channel-peer (kanal başına ayrı diyalog).
children — alt ajanlar: max_depth (en çok 4), max_concurrent (çalıştırma ağacı başına en çok 8), max_per_parent (en çok 5), timeout_seconds (en çok 48 saat, ancak üst öğeden uzun değil) ve archive_after_minutes — tamamlanan çalıştırmaların varsayılan listeden ne zaman çıkacağı. Değerler bu ajan için genel AIHUMMER_SUBAGENT_MAX_DEPTH ve AIHUMMER_SUBAGENT_TIMEOUT_SEC ayarlarını geçersiz kılar.
max_iterations (1–256) — çok sayıda devir içeren doğrulanmış senaryolar için işlev çağrısı döngüsünün adım sınırı.
app — yalnızca AiHummer uygulaması için: reasoning_effort, service_tier ve kısa yanıt modu direct_completion (auto veya always; max_tokens en çok 4096 ve timeout_ms en çok 60 000).
interaction — oturumlarla çalışmak için açık izinler: user_ids, session_agent_ids, spawn_agent_ids, session_visibility görünürlüğü (self, agent veya granted), session_send, alt çağrılar için araç yasakları (child_tool_deny, child_leaf_tool_deny) ve elevated_telegram_user_ids — açıkça yükseltilmiş code_exec çalıştırması isteyebilen user_ids alt kümesi (onaylar atlanmaz). Joker karakter ve tüm kiracı için izin yoktur.

Yönetici API

Ajanlar ve onların yapılandırılmış profilleri, OIDC ile korunan ve denetlenen yönetici API’si altında yönetilir:

Kaynak	Amaç
`/v1/admin/agents`	Temsilcileri listele, oluştur, güncelle, sil (CRUD)
`/v1/admin/agents/.../profile`	Yapılandırılmış G3 profili (kimlik alanları)
`/v1/admin/agents/.../sections`	Adlandırılmış istem bölümleri
`/v1/admin/agents/.../skills`	Ajan başına beceriler
`/v1/admin/agents/.../versions`	Sürüm geçmişi, geri alma ve klonlama

Sonra nereye?

Ajanların bir turu nasıl yürüttüğünü ve yardımcıları nasıl oluşturduğunu anlayın Orkestrasyon ve alt ajanlar.
Gelen bir mesajın belirli bir ajana nasıl ulaştığını görün Yönlendirme.
Ajanlarınıza uzun vadeli hafıza kazandırın Bellek (Einstein).