Geliştiriciler artık akıllı agent'larla doğrudan editörleri içinde çalışabildiğinden AI ile kodlama giderek kolaylaşıyor. Zed ACP, AI kodlama agent'larını Zed ile bağlayarak bunu mümkün kılıyor; böylece farklı araçlar arasında sürekli geçiş yapmadan yardım alabilirsiniz. Bu da kod yazma, görevleri yönetme ve AI ile çalışma şeklinizi seçmenizde size daha fazla esneklik sağlar. Bu kılavuzda, Zed ACP'nin nasıl çalıştığını ve editörünüzde nasıl kullanabileceğinizi açıklayacağız.
Zed ACP nedir?
Zed ACP, AI kodlama agent'larının doğrudan Zed editörüyle bağlanmasını sağlayan açık bir protokol olan Agent Client Protocol'ün kısaltmasıdır. AI kodlama agent'larının editörle iletişim kurması için standartlaştırılmış bir yol sağlar; böylece agent'lar proje bağlamına erişebilir, değişiklikler önerebilir ve editör arayüzü üzerinden kodlama görevlerinde yardımcı olabilir. Ayrı bir araç kullanmak yerine, AI agent'larıyla aynı arayüz üzerinden çalışabilirsiniz. Bu, geliştiricilere ihtiyaçlarına göre agent seçme ve agent'lar arasında geçiş yapma konusunda daha fazla özgürlük tanır.
Agent Client Protocol (ACP) nasıl çalışır?
AI agent'larının görevleri anlaması, doğru bağlama erişebilmesi ve gerektiğinde değişiklik yapabilmesi için editörle iletişim kuracak açık bir yola sahip olması gerekir. ACP, standartlaştırılmış bir iletişim süreciyle bu bağlantıyı sağlayarak AI agent'larının ve editörlerin bilgi alışverişi yapmasını ve birlikte çalışmasını kolaylaştırır. Agent Client Protocol'ün nasıl çalıştığı şu şekildedir.
ACP, AI agent'larını ve kodlama ortamlarını birbirine bağlar
ACP mimarisi, ACP protokolü üzerinden geliştirici, Zed Editor ve bir AI kodlama agent'ı arasında bir bağlantı oluşturur. Zed, istemci olarak görev alır ve görevleri ile bağlamı agent'a gönderir; agent da işi tamamlamak için bir LLM, araçlar ve kod tabanını kullanabilir. Bu yapı, editör ile agent arasındaki iletişimi düzenli tutarak kodlama görevlerinin tek bir yerden yönetilmesini kolaylaştırır.
Developer
↓
Zed Editor (ACP Client)
↓
ACP Protocol
↓
AI Coding Agent
↓
LLM + Tools + CodebaseACP ile MCP: Arasındaki fark nedir?
ACP ve MCP, her ikisi de AI sistemlerinin diğer bileşenlerle etkileşim kurmasına yardımcı olduğu için benzer görünebilir, ancak farklı roller üstlenirler. ACP, AI kodlama agent'larını editörler ve geliştirme ortamlarıyla bağlamaya odaklanırken, MCP AI uygulamalarını harici araçlar, veri kaynakları ve hizmetlerle bağlar. İki protokol arasındaki farklar şu şekildedir:
| Protokol | Temel amaç |
|---|---|
| ACP | AI agent'larını kodlama ortamlarıyla bağlar |
| MCP | AI modellerini/agent'larını harici araçlar ve veri kaynaklarıyla bağlar |
Zed'de ACP neden kullanılır?
ACP, AI agent'larını geliştiricilerin zaten kullandığı araçlara ve dosyalara yaklaştırarak kodlama deneyimini daha esnek hale getirebilir. Agent'ların editörle nasıl etkileşim kurduğunu basitleştirebilir ve farklı uygulamalar arasında geçiş yapma ihtiyacını azaltmaya yardımcı olabilir. Zed'de ACP kullanmanın başlıca nedenleri şunlardır:
Bir editörde farklı AI kodlama agent'ları kullanın
ACP, Zed'in aynı protokol üzerinden birden fazla AI kodlama agent'ıyla çalışmasını sağlar. Geliştiriciler artık belirli bir editöre yerleşik AI özellikleriyle sınırlı değildir veya farklı kodlama ortamları arasında geçiş yapmak zorunda değildir.
ACP uyumlu agent'lar sayesinde geliştiriciler şunları yapabilir:
Farklı kodlama görevlerine göre AI agent'ları seçme
Editör iş akışını değiştirmeden agent'lar arasında geçiş yapma
Yeni AI kodlama araçlarını kullanıma sunuldukça test etme
Örneğin, geliştiriciler Kimi Code CLI'yi ACP üzerinden Zed'e bağlayabilir ve Kimi Code CLI'nin kodlama yeteneklerini doğrudan Zed ortamı içinde kullanabilir.
AI yardımını kodlama iş akışının içinde tutun
ACP'nin en büyük avantajlarından biri, AI agent'larını geliştirme sürecine daha da yaklaştırmasıdır. Geliştiriciler, bir sohbet botu ile editör arasında kod kopyalamak yerine, AI agent'larıyla doğrudan Zed içinde etkileşime girebilir.
ACP, AI agent'larının şunlarla etkileşime girmesini sağlar:
Editör tarafından sağlanan proje bağlamı
Açık dosyalar ve kod bilgileri
Editörden gelen geliştirici talimatları
Bu, şu gibi görevler için daha akıcı bir iş akışı oluşturur:
Tanıdık olmayan kodu açıklama
Yeni özellikler oluşturma
Mevcut dosyaları yeniden düzenleme
Proje genelinde hataları ayıklama
Editörü AI agent'ından ayırın
ACP, kodlama ortamı ile agent'ı çalıştıran AI modeli arasında net bir ayrım oluşturur.
Bu mimariyle:
Zed, hızlı ve verimli bir geliştirme arayüzü sağlamaya odaklanır
AI agent'ları akıl yürütme, kod üretimi ve görev yürütmeyi üstlenir
Geliştiriciler, editörü değiştirmeden agent'ları değiştirebilir veya ekleyebilir
Bu esneklik, geliştiricilerin tek bir AI kodlama çözümüne bağımlı kalmasını önlemeye yardımcı olur ve daha açık bir AI geliştirme ekosistemini destekler.
Agent tabanlı daha esnek bir geliştirme iş akışı kurun
Modern AI kodlama, basit kod tamamlamadan; projeleri anlayabilen, görevleri planlayabilen ve çok adımlı değişiklikleri yürütebilen otonom agent'lara doğru evriliyor.
ACP, Zed'de bu iş akışları için gereken bağlantı katmanını sağlar. MCP (Model Context Protocol) gibi araçlarla birleştiğinde, AI agent'ları editör iş akışına bağlı kalarak ek araçlara, harici kaynaklara ve geliştirme hizmetlerine erişebilir.
Geliştiriciler için bu, Zed'in farklı AI agent'larının kod, araçlar ve proje bağlamıyla iş birliği yaptığı merkezi bir çalışma alanına dönüşebileceği anlamına gelir.
Zed, ACP uyumlu agent'larla nasıl çalışır?
Zed, standartlaştırılmış bir arayüz üzerinden harici AI kodlama agent'larını bağlamak için ACP (Agent Client Protocol) kullanır. Bu kurulumda Zed, ACP istemcisi olarak; bağlanan AI kodlama aracı da ACP agent'ı olarak çalışır.
Geliştiriciler Zed'de bir AI kodlama oturumu başlattığında, editör agent ile ACP üzerinden iletişim kurar. Bu sayede agent, kodlama isteklerini alabilir, ilgili proje bağlamına erişebilir ve yanıtları veya kod değişikliklerini editöre geri gönderebilir.
Bu mimari, editörü AI agent'ından ayrı tutarak farklı ACP uyumlu agent'ların her araç için özel bir entegrasyon gerektirmeden Zed'e bağlanabilmesini sağlar.
ACP desteğiyle geliştiriciler, Kimi Code CLI gibi AI kodlama agent'larını Zed'e bağlayabilir ve AI destekli kodlama yardımını doğrudan mevcut geliştirme iş akışları içinde kullanabilir.
Kimi Code CLI, ACP ile Zed'e nasıl bağlanır?
Kimi Code CLI, ACP entegrasyonunu destekler ve geliştiricilerin Kimi'nin AI kodlama yeteneklerini doğrudan Zed içinde kullanmasına olanak tanır. Kurulum için yalnızca Kimi Code CLI'yi yüklemeniz, kimlik doğrulamayı tamamlamanız ve Zed'de bir ACP agent yapılandırması eklemeniz gerekir.
Ön koşullar
Kimi Code CLI'yi Zed'e bağlamadan önce şunlara sahip olduğunuzdan emin olun:
Kimi Code CLI yüklenmiş olmalı
Kimi Code CLI oturum açma kurulumu tamamlanmış olmalı
ACP desteğine sahip Zed'in en güncel sürümü yüklenmiş olmalı
Kimi Code CLI, CLI'yi ACP modunda başlatan kimi acp komutunu sunar. Zed bu komutu bir ACP agent'ı olarak başlatır ve protokol üzerinden onunla iletişim kurar.
Adım 1: Kimi Code CLI yolunu bulun (İsteğe bağlı)
Çoğu durumda yapılandırmada doğrudan kimi kullanabilirsiniz. Zed komutu bulamazsa yükleme yolunu kontrol edin:
which kimiDöndürülen yolu daha sonra kullanmak üzere kopyalayın.
Bu özellikle macOS'ta yararlıdır, çünkü masaüstünden başlatılan uygulamalar terminalin PATH ortam değişkenlerini miras almayabilir.
Adım 2: Kimi Code CLI'yi Zed'de yapılandırın
Zed yapılandırma dosyasını açın:
~/.config/zed/settings.jsonAşağıdaki agent_servers yapılandırmasını ekleyin:
{
"agent_servers": {
"Kimi Code CLI": {
"type": "custom",
"command": "kimi",
"args": ["acp"],
"env": {}
}
}
}Yapılandırma ayrıntıları:
type: Özel bir ACP agent'ı için"custom"olarak ayarlanırcommand: Kimi Code CLI çalıştırılabilir dosyasının yoluargs: Kimi Code CLI'yi ACP modunda başlatmak içinacpkullanılırenv: İsteğe bağlı ortam değişkenleri, genellikle boş bırakılır
kimi, sisteminizin PATH değişkeninde yoksa, bunun yerine tam yolu kullanın:
"command": "/your/path/to/kimi""command": "/your/path/to/kimi"Adım 3: Zed'de Kimi Code CLI'yi Başlatın
Yapılandırmayı kaydettikten sonra:
Zed'i açın
Agent Panelini açın
Yeni bir konuşma oluşturun
Agent olarak Kimi Code CLI'yi seçin
Zed, Kimi Code CLI'yi otomatik olarak bir ACP alt süreci olarak başlatacak ve bağlantıyı kuracaktır. Terminalde kimi acp komutunu manuel olarak çalıştırmanıza gerek yoktur.
Adım 4: Zed'de Kimi ile Kodlamaya Başlayın
Bağlantı kurulduktan sonra, Zed içinde Kimi Code CLI'yi şu gibi görevler için kullanabilirsiniz:
Proje kodunu anlama
Yeni özellikler oluşturma
Dosyaları yeniden düzenleme
Sorunları hata ayıklama
Proje bağlamıyla birden fazla dosya üzerinde çalışma
ACP ile Kimi Code CLI, Zed içinde entegre bir kodlama agent'ı olarak çalışır ve Zed'in düzenleme deneyimini Kimi'nin yapay zeka destekli geliştirme yetenekleriyle birleştirir.
Zed'de Kimi Code kullanmanın avantajları
Kimi Code, kodlama ortamlarından ayrılmadan yapay zeka desteği almak isteyen geliştiriciler için Zed'i daha kullanışlı hale getirebilir. Agent'ı ACP üzerinden bağlayarak geliştiriciler, kodlama görevlerini yönetebilir, mevcut projelerle çalışabilir ve doğal dil kullanarak yardım alabilir. İşte Zed'de Kimi Code kullanmanın temel avantajları:
Büyük kod tabanlarını anlama ve içinde gezinme
Kimi Code, proje dosyalarını analiz edebilir ve bir kod tabanının farklı kısımlarının nasıl bağlantılı olduğunu anlayabilir. Bu, geliştiricilerin ilgili dosyaları, fonksiyonları ve mantığı daha hızlı bulmasına yardımcı olur. Özellikle büyük veya alışılmadık projelerle çalışırken oldukça faydalı olabilir.
Doğal dille kod oluşturma ve düzenleme
Geliştiriciler, her değişikliği manuel olarak yazmak yerine ne istediklerini basit bir dille tarif edebilir. Kimi Code, verilen talimatlara göre yeni kod oluşturabilir veya mevcut kodu düzenleyebilir. Bu, yaygın geliştirme görevlerini daha hızlı ve daha kolay hale getirir.
Çok dosyalı kodlama görevlerine yardımcı olma
Birçok geliştirme görevi, tek bir yerde değil, birden fazla dosyada değişiklik gerektirir. Kimi Code, görevin genel kapsamını anlayabilir ve gerekli güncellemeleri yapmak için ilgili dosyalar üzerinde çalışabilir. Bu, proje boyunca ilgili değişikliklerin tutarlı kalmasına yardımcı olur.
Mevcut kodda hata ayıklama ve geliştirme
Kimi Code, mevcut kodu inceleyerek olası sorunları belirlemeye ve bir sorunun nedenini açıklamaya yardımcı olabilir. Ayrıca düzeltmeler önerebilir, kod yapısını iyileştirebilir ve geliştiricinin talimatlarına göre değişiklikler yapabilir. Bu, hataları manuel olarak bulup çözmek için harcanan zamanı azaltabilir.
Agent tabanlı bir geliştirme iş akışı oluşturma
Kimi Code'u Zed ile kullanmak, geliştiricilerin bir yapay zeka agent'ını düzenli geliştirme sürecinin bir parçası olarak dahil etmelerine olanak tanır. Agent, editör içinden kodlama ve proje değişiklikleri gibi görevleri destekleyebilir. Bu, geliştiricilerin bir yapay zeka agent'ını ayrı bir araç olarak kullanmak yerine onunla birlikte çalışabildikleri esnek bir iş akışı oluşturur.
Zed ACP entegrasyonunda sorun giderme
Birkaç kurulum veya yapılandırma sorunu, ACP agent'larının Zed'de düzgün çalışmasını engelleyebilir. Sorunların çoğu agent yapılandırması, komut yolu, kimlik doğrulama veya bağlantıyla ilgilidir ve genellikle birkaç basit kontrolle çözülebilir. İşte yaygın sorunlar ve çözümleri:
| Sorun | Olası neden | Çözüm |
|---|---|---|
| Kimi Code CLI, Zed'de görünmüyor | agent_servers yapılandırması eksik veya sözdizimi hataları içeriyor | settings.json dosyasını kontrol edin ve Kimi Code CLI yapılandırmasının doğru şekilde eklendiğinden emin olun |
| Zed, kimi komutunu bulamıyor | Kimi Code CLI, sistem PATH değişkeninde bulunmuyor | Yürütülebilir dosyanın yolunu bulmak için which kimi komutunu çalıştırın, ardından "command": "kimi" kısmını tam yol ile değiştirin |
| ACP agent başlıyor ama hemen kapanıyor | Kimi Code CLI kurulumu veya kimlik doğrulaması tamamlanmamış | ACP modunun doğru şekilde başladığını doğrulamak için terminalde kimi acp komutunu çalıştırın, gerekiyorsa oturum açma işlemini tamamlayın |
| Agent başlatılırken kimlik doğrulama hataları oluşuyor | Kimi Code CLI hesap kimlik doğrulaması süresi dolmuş veya yapılandırılmamış | Kimi Code CLI'da yeniden oturum açın ve Zed'i yeniden başlatın |
| settings.json'daki değişiklikler etkili olmuyor | Zed, güncellenen yapılandırmayı yeniden yüklememiş | Yapılandırma dosyasını değiştirdikten sonra Zed'i yeniden başlatın |
| Kodlama görevleri sırasında agent yanıtları yavaş veya başarısız oluyor | Ağ bağlantısı sorunları veya büyük proje bağlamı | Ağ bağlantınızı kontrol edin ve daha küçük bir proje kapsamıyla çalışmayı deneyin |
Sonuç
Zed ACP, geliştiricilere yapay zeka desteğini günlük kodlama iş akışlarına dahil etmek için esnek bir yol sunar. Ayrıca farklı agent'larla çalışmayı kolaylaştırırken editörü geliştirme sürecinin merkezinde tutar. Yapay zeka destekli kodlama gelişmeye devam ederken, bu yaklaşım geliştirmeyi daha verimli ve uyarlanabilir hale getirmeye yardımcı olabilir. Bu iş akışını denemek isterseniz, Kimi Code'u Zed ile kullanmayı deneyin ve kodlama ihtiyaçlarınıza nasıl uyduğunu görün. Daha doğal bir yapay zeka destekli geliştirme iş akışı yaşamak için Kimi'yi bugün kullanmaya başlayın.