İşi ajanlara devretme

Bu kılavuz, işi üzerinizden alıp bir ajana yüklemenin ve ajanların işi kendi aralarında aktarması durumunda ne olduğunu ele alır.

Bir bileti bir ajana verme

Üzerinden çalışılabilecek kadar net bir başlık ve açıklamayla bileti oluşturun.
Atanan alanını ajana ayarlayın; böylece sahiplik kayda geçsin.
Bir alan açın (veya oluşturun) ve o ajanı @ ile anın.
İletinizde bilete # anmasıyla başvurun — ileti alanı çalışma alanı biletlerini otomatik tamamlar — ve ne yapılmasını istediğinizi söyleyin.

Ajan işi konuşmadan alır. İlerlemesi o alana akar.

Ajanın aldıkları

İletiniz; etiketlediğiniz bilet referansı dahil.
İçinde çalışıp rapor vereceği alan.
Çalışma alanının bağlı depolarından yalıtılmış bir çalışma ağacı.
Alanın modu; çalıştırmanın araç yüzeyini yöneten şey budur.

Mod bir alanın özelliğidir, biletin değil — bir biletin modu yoktur. Bu nedenle tek bir ajan bir alanda chat, bir başkasında plan olabilir. Modu ileti alanındaki mod açılır menüsünden seçin (Agent, Plan veya Orchestrate); review PR inceleme alanları tarafından ayarlanır ve seçilemez. Bkz. Modlar.

Yapılandırılmış bir sonuç zorunlu tutma

Çıktı sözleşmesi bilette değil gönderimde bildirilir: expected_output_schema ve output_contract_mode (varsayılan olarak katı). Ajan bunu submit_output çağırarak karşılar; bu çağrı yükü şemaya göre doğrular ve uymayanı reddeder.

Kabul edilen çıktı da olası retler de ajan çalıştırma günlüğüne düşer. Biletin kendi durumu bundan etkilenmez — başarısız bir sözleşme bileti başarısız kılmaz.

İlerlemeyi izleme

Alan — canlı ajan etkinliği, birincil görünüm.
Bilet — durumu, onu ilerleten kimse onun belirlediği gibi.
Gözlemlenebilirlik → Canlı (/workspaces/<workspace-id>/observability) — canlı ajan kadrosu.
Gözlemlenebilirlik → İçgörüler — maliyet ve süreyle birlikte çalıştırma günlüğü.

Bir gösterge paneli ekranı yoktur; yalın bir çalışma alanı URL’si gelen kutusuna yönlendirir.

Ajanların birbirine devretmesine izin verme

Bir alt sorunla karşılaşan ajan, delegate_task MCP aracıyla devreder. Bu araç başka bir ajana atanmış bir alt bilet oluşturur ve parent_ticket_id verdiğinizde, korumaların görebilmesi için zinciri kaydeder.

İki yapısal koruma biletleme darboğazında her zaman çalışır, asla istem talimatıyla değil:

Derinlik sınırı — 3 atlamadan daha derin bir zincir reddedilir.
Döngü algılama — zincirde zaten bulunan bir ajana geri atlama reddedilir.

from_agent_id verdiğinizde iki koruma daha çalışır (üretim her zaman çözümleyici portlarını sağlar):

Özerklik tavanı — devredilenin alandaki etkin düzeyi, devredenin düzeyini aşmamalıdır.
Bütçe zarfı — devretme, devredenin kalan sert durdurma bütçesinden faturalandırır ve daha fazlasını üretemez. Politika yoksa ya da politika sınırsızsa geçer.

Bir ret yüksek seslidir: araç, korumanın gerekçesini birebir döndürür; böylece devreden ajan nedenini tam olarak görür. delegatedByAgentId alanı kimin devrettiğini kaydeder ve bir devretme ağacı oluşturur.

Devretme derinlik sınırı (3), yerleşik harness’ın alt ajan iç içe geçme sınırından (2) farklı bir sınırdır — biri ajanlar arasındaki biletleri, diğeri tek bir çalıştırma içindeki alt ajanları sınırlar.

Bir bilete birkaç ajan koyma

Onları bilete işbirlikçi olarak ekleyin (roller: atanan, işbirlikçi, inceleyen). Bu bir kadrodur — kimin dahil olduğunun kaydı — ve kendi başına hiçbir şey vermez.

Ajanları gerçekten aynı konuşmaya koymak için onları alan başlığından katılımcı olarak ekleyin. Ardından orada birbirlerini @ ile anabilirler. Bkz. Alanlar.

Otomatik bilet oluşturma

Pipeline paletindeki hiçbir düğüm bilet oluşturmaz; dolayısıyla bir pipeline işi atanmış biletler hâlinde dağıtamaz.

Var olan yol orkestrasyondur: bir öneriyi onaylamak bir proje ve bir ekip oluşturur, önerinin alt bilet DAG’ını bir pipeline şablonuna derler (her alt bilet için bir promptAgent adımı, her biri için bir Ticket satırı değil) ve o çalıştırmayı başlatır. Bkz. Bir orkestrasyon çalıştırma.