Multica Docs

Agent'lar

Bir agent, bir çalışma alanında yeniden kullanılabilir bir kimlik, yetenek ve yürütme yapılandırması kümesidir.

Bir agent, bir Multica çalışma alanının bir iş birlikçisidir. Ona işler atayabilir, yorumlarda @ ile bahsedebilir veya doğrudan sohbet edebilirsiniz. Bağlı olduğu runtime üzerinden bir yapay zekâ kodlama aracını yönetir ve ilerlemeyi ve sonuçları çalışma alanına geri yazar.

Bir agent sürekli çalışan bir süreç değildir. Yeniden kullanılabilir bir kimlik ve yapılandırmadır; yalnızca iş geldiğinde somut çalıştırmalar üretir.

Agent yapılandırması

AyarNe yapar
Ad, avatar ve açıklamaEkibe agent'ın kim olduğunu ve neyde iyi olduğunu söyler. Açıklama yalnızca görüntüleme amaçlıdır ve asla yürütme prompt'una girmez.
TalimatlarSorumluluklarını, çalışma tarzını, sınırlarını ve teslimat gereksinimlerini tanımlar. Her çalıştırmada kullanılır.
Sohbet başlatıcılarıİnsanlara, agent'la yeni bir sohbet açtıklarında gösterilen en fazla üç agent'a özgü örnek verin. Birini seçmek, göndermeden düzenleyiciyi doldurur.
Skill'lerYeniden kullanılabilir yöntemler, referans materyali ve destekleyici dosyalar sağlar.
Runtime, model ve düşünme düzeyiHangi runtime, yapay zekâ kodlama aracı ve modelde çalışacağına karar verir; bazı araçlar (Codex gibi) bir hizmet katmanı da sunar.
ErişimHangi üyelerin onu çalıştırabileceğine karar verir.
Yürütme ayarlarıEşzamanlılık sınırını, ortam değişkenlerini, CLI argümanlarını, MCP'yi ve dış entegrasyonları içerir.

Modelleri değiştirmek veya talimatları düzenlemek yeni bir agent oluşturmaz; geçmiş işler, yorumlar ve çalıştırma geçmişi kaybolmaz.

Agent'lar, runtime'lar ve çalıştırmalar

KavramSorumluluk
Agentİşi kimin ve nasıl yapacağına karar verir
RuntimeHangi bilgisayarın ve hangi yapay zekâ kodlama aracının onu yürüteceğine karar verir
ÇalıştırmaBir çalıştırmanın sürecini ve sonucunu kaydeder

Bir runtime birden çok agent'ı barındırabilir ve bir agent zaman içinde birçok çalıştırmayı tamamlayabilir. Runtime çevrimdışıyken agent'ın kimliği ve geçmişi kalır, ama yeni çalıştırmalar runtime geri gelene kadar bekler.

Bir agent'ın katılım yolları

  • Bir işin sahibi olma — agent'ı atanan olarak ayarlayın; çalıştırma kuyruğa alındığında başlar.
  • Bir yorumu ele alma — işin atananını değiştirmeden bir yorumda agent'tan @ ile bahsedin.
  • Bir tartışmaya devam etme — agent'ın yorumuna yanıt verin; yeni bilgi sonraki çalıştırmalara girdi olur.
  • Doğrudan sohbet etme — bir işe bağlı olmayan bir konuşma başlatın.
  • Projelere ve ekiplere katılma — bir agent bir proje sorumlusu, bir ekip lideri veya bir ekip üyesi olabilir.
  • Otomasyonlar üzerinden çalışma — bir programa göre veya dış olaylardan önceden ayarlanmış işi tetikleyin, ya da elle çalıştırın.

Agent'lar iş oluşturabilir, yorum gönderebilir ve iş durumunu değiştirebilir, ama bir gelen kutuları yoktur ve @all'u almazlar. Bir agent'tan @ ile bahsetmek bir bildirim değil, bir yürütme tetikleyicisidir.

İzinler ve Erişim

Her agent'ın bir sahibi ve bir Erişim ayarı vardır:

ErişimKim çalıştırabilir
Yalnızca benYalnızca agent sahibi.
Tüm çalışma alanıÇalışma alanının her üyesi.
Belirli kişilerAgent sahibi ve seçilen üyeler.

Yeni agent'lar varsayılan olarak Yalnızca ben'dir.

Çalışma alanı owner'ları ve adminleri her agent'ı görebilir ve yönetebilir, ama başkasının "Yalnızca ben" agent'ını çalıştırmak için Erişimi atlayamazlar. Sıradan üyeler yalnızca sahip oldukları veya çalıştırmaya izinli oldukları agent'ları görür.

Bir agent'ı görebilmek sahiplik, çalışma alanı yönetici rolleri ve Erişim birlikte belirlenir; değiştirmek agent sahibine ve çalışma alanı owner'larına/admin'lerine açıktır, yalnızca Erişimin kendisi hariç — onu yalnızca agent sahibi değiştirebilir.

Ortam değişkenleri ve MCP gibi kimlik bilgileri içerebilecek yapılandırmalar için daha sıkı okuma kuralları vardır — bkz. Agent oluşturma ve yapılandırma.

Çevrimiçi, çevrimdışı ve iş yükü durumu

Agent listesi iki tür durumu yan yana gösterir:

  • Kullanılabilirlik, runtime'dan gelir — çevrimiçi, çevrimdışı veya kararsız.
  • İş yükü, çalıştırmalardan gelir — çalışıyor, kuyrukta veya boşta.

"Çevrimdışı", agent'ın silindiği anlamına gelmez. Zaten kuyruğa alınmış çalıştırmalar runtime'ın toparlanmasını bekler; yalnızca "arşivlendi" artık yeni iş alamayacağı anlamına gelir.

Arşivleme ve geri yükleme

Artık kullanmadığınız agent'lar arşivlenebilir. Arşivlenmiş bir agent artık seçicilerde görünmez ve atanamaz veya @ ile bahsedilemez; geçmişi korunur ve daha sonra geri yüklenebilir.

Arşivleme, agent'ın kuyruktaki ve çalışmakta olanlar dahil tüm bitmemiş çalıştırmalarını iptal eder.

Agent sahibi ve çalışma alanı owner'ları ve adminleri bir agent'ı arşivleyebilir veya geri yükleyebilir.

Sonraki adımlar