Bir agent oluşturma ve yapılandırma

Bir agent oluşturmak önce çalışan bir runtime gerektirir. Runtime, agent'ın hangi bilgisayarı ve hangi yapay zekâ kodlama aracını kullanacağını belirler; agent ise uzun ömürlü kimliği, talimatları ve yetenekleri barındırır.

Çalışma alanının Agent'lar sayfasında Yeni agent'a tıklayın.

Başlangıç noktaları

Oluşturma sayfası iki seçenek sunar:

Yapay zekâ ile oluştur, Builder sohbeti için çevrimiçi bir runtime gerektirir. Hangi yolu seçerseniz seçin, oluşturmadan önce nihai yapılandırmayı gözden geçirip düzenleyebilirsiniz.

Zorunlu alanlar

Bir agent oluşturmak yalnızca iki şey gerektirir:

• Ad — çalışma alanı içinde benzersiz olmalıdır.
• Runtime — çalıştırmaları fiilen yürüten ortam.

Diğer her alan varsayılanıyla başlayabilir ve oluşturduktan sonra ayarlanabilir. Varsayılan olarak yeni bir agent'ı yalnızca oluşturan kişi çalıştırabilir.

Açıklama ve talimatlar

Açıklama, takım için kısa bir tanıtımdır. Yalnızca agent listesinde ve detay sayfasında görünür, yapay zekâ kodlama aracının promptuna asla girmez.

Talimatlar, her çalıştırmada agent'a sağlanır ve genellikle şunları kapsar:

• neyden sorumlu olduğu ve olmadığı;
• iş geldiğinde önce neyi kontrol edeceği;
• neyi değiştirmesine izin verildiği;
• sonuçları nasıl teslim edeceği;
• devam etmeden önce ne zaman bir üyeyle kontrol edeceği.

Örneğin:

You review frontend pull requests.

Read the diff and related tests first, and check only:
- React and TypeScript correctness
- Accessibility
- Consistency with existing component patterns

Do not modify code directly. Post findings in an issue comment,
ordered by severity; when nothing blocks, state clearly that the change can merge.

Skill ekleme

Oluşturma sırasında çalışma alanından bir veya daha fazla skill seçebilirsiniz.

Skill'ler, agent'lar arasında yeniden kullanılan yöntemler ve materyaller için uygundur; yalnızca bu agent'a özgü uzun ömürlü gereksinimler talimatlara girer.

Konuşma başlatıcılar

İnsanlara ilk sohbet mesajını göndermeden önce bu agent'ın ne konuda iyi olduğunu göstermek için en fazla üç konuşma başlatıcı ekleyin. Biri agent'la yeni bir sohbet açtığında, yazı kutusunun üzerinde görünürler. Her başlatıcının kısa bir etiketi ve eksiksiz bir promptu vardır. Birini seçmek yazı kutusunu doldurur, böylece kullanıcı gözden geçirip düzenleyebilir; hiçbir zaman otomatik olarak bir çalıştırma başlatmaz.

Düzenleyici, yeni bir sohbetin tam olarak neyi göstereceğini önizler; agent'ı düzenleyebilen herkes, o boş durumda buraya derin bağlantı veren bir Başlatıcıları özelleştir bağlantısı görür.

Listeyi boş bırakırsanız Sohbet, yerelleştirilmiş genel amaçlı varsayılanları gösterir. Agent'a özgü örnekler genellikle daha kullanışlıdır çünkü talimatlardaki rolü ve sınırları yansıtabilirler.

Runtime, model ve düşünme düzeyi

Her runtime zaten bir yapay zekâ kodlama aracıyla eşleşir. Bir runtime seçtikten sonra aracın desteklediği bir model ve düşünme düzeyi seçebilirsiniz; bazı araçlar (Codex gibi) bir hizmet katmanı da sunar:

• Boş bırakılırsa runtime'ın veya yerel CLI'ın varsayılanı uygulanır.
• Bir model ayarlandığında agent, o andan sonra devraldığı çalıştırmalar için bu geçersiz kılmayı kullanır.
• Bazı runtime'lar modelleri kendileri yönetir, bu yüzden bir model seçici gösterilmez.

Araçlar; desteklenen modeller, oturum sürdürme, skill'ler ve MCP yetenekleri açısından farklılık gösterir — bkz. Yapay zekâ kodlama araçları karşılaştırması.

Erişim

Erişim, hangi üyelerin bu agent'ı çalıştırabileceğine (atama, @-bahsetme veya sohbet) karar verir:

Erişimi yalnızca agent sahibi değiştirebilir — çalışma alanı yöneticileri değiştiremez. Çalışma alanı ownerları ve adminleri yapılandırmanın geri kalanını yönetebilir, ama yönetici rollerini kendilerine verilmemiş agent'ları çalıştırmak için kullanamazlar.

Oluşturduktan sonra yapılandırma

Agent'ın detay sayfasında şunları ayarlamaya devam edebilirsiniz:

Runtime'ı barındıran daemon'ın da genel bir eşzamanlılık üst sınırı vardır (varsayılan 20); geçerli eşzamanlılık bu ikisinden küçük olanıdır.

Yapılandırmayı düzenlemek zaten çalışmakta olan çalıştırmaları değiştirmez. Sonraki çalıştırmalar, runtime onları devraldığı andaki kaydedilmiş agent yapılandırmasını kullanır.

Ortam değişkenleri ve kimlik bilgileri

Ortam değişkenleri, agent'ın çalışma zamanında ihtiyaç duyduğu sınırlı yetkili kimlik bilgileri için uygundur — salt okunur bir API anahtarı veya tek kapsamlı bir token gibi.

Üretim veritabanı yönetici parolalarını veya diğer yüksek değerli, uzun ömürlü kimlik bilgilerini kullanmayın.

PATH, HOME ve MULTICA_* gibi kritik runtime değişkenleri burada geçersiz kılınamaz.

Özel argümanlar ve MCP

Özel argümanlar, yapay zekâ kodlama aracına bir dizi olarak, tek tek ve kabuk (shell) genişletmesi olmadan geçirilir. Bir argümanın geçerli olup olmadığı aracın kendisine bağlıdır; zaten kendine özel bir alanı olan model yapılandırmasının burada tekrarlanmasına gerek yoktur.

MCP yapılandırması token içerebilir; saklama ve görüntüleme kuralları ortam değişkenleriyle aynıdır. Bu bölüm yalnızca yönetilen MCP yapılandırmasını destekleyen runtime'larda görünür; MCP desteği olmayan araçlar, bir yapılandırma kaydedilmiş olsa bile bu desteği kazanmaz.

Bir agent'ı çoğaltma

Çoğaltma, ad hariç çoğu çalışan yapılandırmayı taşır: talimatlar, konuşma başlatıcılar, skill'ler, özel argümanlar, avatar, eşzamanlılık sınırı ve Erişim ayarları dahil. Model, düşünme düzeyi ve hizmet katmanı da birlikte gelir; orijinal runtime kullanılamıyorsa ve kopya başka bir runtime'a zorlanıyorsa bu üçü temizlenir ve yeniden seçilmesi gerekir.

Ortam değişkeni değerleri ve MCP yapılandırması hiçbir zaman kopyalanmaz ve yeni agent'ta yeniden ayarlanmalıdır. Çoğaltma, orijinal agent'ın runtime bağını ve Erişim ayarlarını korur.

CLI ile oluşturma

multica agent create \
  --name "Frontend Reviewer" \
  --runtime-id <runtime-id> \
  --description "Reviews frontend pull requests" \
  --instructions "Read the diff and tests first; post review conclusions only as issue comments."

Komut satırı argümanlarındaki düz metin shell geçmişinde kalır; stdin ve izinle sınırlandırılmış dosyalar kalmaz.

Benzer şekilde yapılandırılmış bir agent zaten varsa, doğrudan onu kopyalayın:

multica agent copy <agent-id>

Varsayılan olarak kopya aynı runtime'da kalır; başka bir runtime'a taşımak için --runtime-id ekleyin, bu da --model gerektirir. Ortam değişkenleri, MCP yapılandırması ve runtime_config hiçbir zaman kopyalanmaz; runtime bağının kendisi korunur. Tam bayraklar için CLI'ı kullanma.

Sonraki adımlar

• İşleri agent'lara atama — yapılandırmayı gerçek bir işle doğrulayın.
• Skill'ler — takım yöntemlerini oluşturun, içe aktarın ve yeniden kullanın.
• Daemon ve runtime'lar — çevrimiçi durumu ve çalıştırmanın nerede gerçekleştiğini sorun giderin.