Editörde
VS Code için aimo
Editörün içinde, Bosphorus platformunuz üzerinde çalışan bir ajan. Kodunuzu okur ve değiştirir, komutlarınızı çalıştırır, kurumunuzun araç sunucularına ulaşır — sizin kimliğinizle oturum açar, bir şeyi değiştirmeden önce sorar ve herkesle aynı politika, kota ve denetim izi altında çalışır.
VS Code için aimo 1.2.1
- Dosya
aimo-1.2.1.vsix- Boyut
- 192 KB
- Sürüm
- 1.2.1
- Gereksinim
- VS Code 1.85 veya üstü
- Yayımlanma tarihi
- SHA-256 özeti
5e02b1489e2f3ffd26e46cf9a0e482a0bf61707ee7fe729d8d3f91b4abad207c
Eklenti bir Bosphorus kurulumuyla çalışır: kurumunuzun ağ geçidi adresine ve kurumsal hesabınıza ihtiyacınız vardır. İkisini de yöneticiniz verebilir.
Ne yapar
Platformun kurallarıyla çalışan bir kodlama ajanı
Editörün içinde bir ajan
Açık klasördeki dosyaları okur, arar ve düzenler; orada komut çalıştırır ve editörün bildirdiği sorunları okur. Açık dosya ve seçiminiz sorunuzla birlikte gider; görüntü okuyabilen bir model için ekran görüntüsü de yapıştırabilir ya da sürükleyip bırakabilirsiniz.
Arkanızdan hiçbir şey değişmez
Bir düzenleme uygulanmadan önce fark (diff) olarak, bir komut da çalışmadan önce gösterilir. Sonrasında bir turun değiştirdiği dosyaları gözden geçirip hepsini tek adımda eski hâline getirebilirsiniz.
Sizin kimliğinizle
Kurumsal hesabınızla oturum açar ve kendine ait kişisel bir anahtar alır. Her model isteği sizin kotanızdan ve hız limitlerinizden düşer, model profilinize uyar ve sizin adınızla kaydedilir.
Talep üzerine araç sunucuları
Kurumunuzun araç sunucularına, adreslerini ve kimlik bilgilerini saklayan platformun yönetişimli aktarıcısı üzerinden ulaşılır. Model ihtiyaç duyduğu aracı kendisi arar; bu yüzden büyük bir katalog hiçbir yük getirmez. Gün boyu kullandığınız bir iki sunucuyu sabitleyebilirsiniz.
Anahtarlarınız sizde kalır
Kurulumunuz kişilerin anahtarlarını OpenBao'da tutuyorsa eklenti kendi kasanızda oturum açmanızı sağlar. Araç sunucuları, terminaller ve çalıştırdığı komutlar değerleri alır; modele adları verilir ve bir komutun olduğu gibi yazdırdığı bir değer modele `[vault:NAME]` olarak ulaşır.
Bir depo onu yönlendiremez
Nerede oturum açacağı, anahtarınızın nereye gideceği ve önce sorup sormayacağı yalnızca sizin kendi ayarlarınızda belirlenebilir, bir projenin ayarlarında asla. Kısıtlı Mod'da otomatik onay kapanır; her düzenleme ve komut için size sorulur ve hiçbir komut kasadan değer almaz.
Kurmadan önce
Neye ihtiyacınız var
- VS Code 1.85 veya üstü.
- Kurumunuzun ağ geçidi adresi, örneğin
https://ai.corp.example. Bu adresi yöneticiniz verir. - Platformun kullandığı kimlik sağlayıcısında kurumsal hesabınız — Microsoft Entra ID ya da Keycloak gibi bir OpenID Connect sağlayıcısı.
- Ağ geçidine bir ağ yolu. Birçok kurulum yalnızca şirket ağında ya da VPN üzerinden yanıt verir.
Kurulum
VS Code'a kurun
Eklenti tek bir dosyadır. VS Code'un içinden ya da bir terminalden kurabilirsiniz.
VS Code'un içinden
- Yukarıdaki düğmeyle aimo-1.2.1.vsix dosyasını indirin.
- Uzantılar (Extensions) görünümünü açın: Ctrl+Shift+X, macOS'ta Cmd+Shift+X.
- Görünümün üstündeki … (Görünümler ve Diğer Eylemler) menüsünü açın ve VSIX'ten Yükle... (Install from VSIX…) seçeneğini seçin.
- İndirdiğiniz dosyayı seçin. VS Code kurulumun tamamlandığını bildirdiğinde etkinlik çubuğunda AIMO simgesi görünür. VS Code pencereyi yeniden yüklemenizi isterse Pencereyi Yeniden Yükle ile yükleyin.
Bir terminalden
Dosyayı indirdiğiniz klasörde:
code --install-extension aimo-1.2.1.vsixVS Code profilleri kullanıyorsanız komutta profilinizin adını belirtin. Uzantılar profil başına kurulur; yukarıdaki komut yalnızca Varsayılan profile kurar, bu yüzden başka bir profille açılan pencere AIMO'yu göstermez. Pencerenin içinden VSIX'ten yükleme ise o pencerenin profiline kurar.
code --install-extension aimo-1.2.1.vsix --profile "My Profile"macOS'ta code bulunamazsa önce Komut Paleti'nden Kabuk Komutu: 'code' komutunu PATH'e yükle (Shell Command: Install 'code' command in PATH) komutunu çalıştırın.
Dosyayı doğrulayın (isteğe bağlı)
Komutun yazdırdığı SHA-256 özeti, indirme düğmesinin yanında gösterilenle aynı olmalıdır. PowerShell onu büyük harflerle yazar; büyük-küçük harf farkı önemli değildir.
macOS, Linux
shasum -a 256 aimo-1.2.1.vsixWindows (PowerShell)
Get-FileHash .\aimo-1.2.1.vsix -Algorithm SHA256İlk çalıştırma
Bağlanın, oturum açın, sorun
Kurulumdan sonra AIMO aynı adımları izleyen kısa bir tanıtım sunar — Show me around.
Ağ geçidinize bağlanın
Komut Paleti'ni açın (Ctrl+Shift+P, macOS'ta Cmd+Shift+P), AIMO: Set Gateway URL komutunu çalıştırın ve yöneticinizin verdiği adresi girin. Adres sizin kendi kullanıcı ayarlarınızda tutulur.
Oturum açın
AIMO simgesine tıklayıp Sign in düğmesini seçin. Kısa bir kod panonuza kopyalanır ve oturum açma sayfası tarayıcınızda açılır: kodu yapıştırıp oturum açmayı tamamlayın. Eklenti ardından kişisel anahtarınızı alır ve VS Code'un gizli depolamasında saklar.
Bir model seçin — ya da seçmeyin
Siz seçmezseniz eklenti platformun size önerdiği modeli kullanır. AIMO: Select Model, kullanabileceğiniz her modeli, her birinin yapabildiği doğrulanmış işleri ve bağlam penceresinin büyüklüğünü listeler.
Sorun
Sohbeti Ctrl+Alt+A (macOS'ta Ctrl+Cmd+A) ile açın ve bir şeyi açıklamasını, yazmasını ya da düzeltmesini isteyin. Ona bir kod parçası vermek için kodu seçip editörün bağlam menüsünden AIMO ▸ Explain This ya da Fix This komutunu seçin.
Varsa kasanızı bağlayın
Platform kişilerin anahtarlarını OpenBao'da tutuyorsa AIMO Vault: Sign in to the Vault komutunu çalıştırın. Tarayıcınız oturumunuzu açar ve localhost:8250 üzerinden eklentiye geri döner. Kasanın adresi ağ geçidinin adresinden çıkarılır; sizinki başka bir yerdeyse aimo.vault.address ayarını girin.
Yönetişim
Diğer her istemci gibi yönetişim altında
- Her model isteği, sohbet çalışma alanı ve her ajanla aynı altı kapıdan geçer: kimlik, politika, kota, hız limiti, adil paylaşım kabulü ve denetim.
- Yöneticiler eklentinin isteklerini aynı etkinlik ve kullanım sayfalarında görür; her sohbet tek bir oturum olarak gruplanır.
- Araç çağrıları, her birini kaydeden platform aktarıcısından geçer: eklenti bir araç sunucusunun adresini ya da kimlik bilgilerini hiç öğrenmez; kasanızdaki değerler sohbete değil, araçlara ve komutlara gider.
- Genellikle kimlik bilgisi taşıyan dosyalar —
.env, özel anahtarlar,*.tfvarsve benzerleri — yalnızca siz onay verdikten sonra okunur.
Güncellemeler
Güncelleme ve kaldırma
- VS Code, bir dosyadan kurulan uzantıyı kendiliğinden güncellemez. Bu sayfada yeni bir sürüm çıktığında aynı yolla kurun: eskisinin yerini alır, ayarlarınızı ve oturumunuzu korur.
- AIMO: Sign out, kişisel anahtarınızı bu makineden siler ve sizi kasadan da çıkarır.
- Eklentiyi kaldırmak için önce oturumu kapatın, ardından Uzantılar görünümünde AIMO üzerinde Kaldır (Uninstall) seçeneğini seçin ya da
code --uninstall-extension morten.aimokomutunu çalıştırın.
Sorun giderme
Bir şey çalışmazsa
| Gördüğünüz | Yapmanız gereken |
|---|---|
| Kurulumdan sonra AIMO simgesi yok | Pencere, kurduğunuz profilden farklı bir VS Code profili kullanıyor ya da eklentinin uzak tarafta çalıştığı uzak bir pencere (SSH, WSL, konteyner). O pencereden VSIX'ten Yükle... ile yeniden kurun ya da komuta --profile ekleyin. |
could not reach …/api/identity/config hatası | Ağ geçidi adresi girilmemiş, yanlış yazılmış ya da buradan erişilemiyor. AIMO: Set Gateway URL komutunu yeniden çalıştırın ve şirket ağında ya da VPN'de olduğunuzu doğrulayın. |
| Oturum açma sayfası kodu kabul etmiyor ya da oturum açma hiç tamamlanmıyor | Yöneticinize, platformun kimlik sağlayıcısının editör eklentisi için cihaz koduyla oturum açmaya izin verip vermediğini sorun. |
Kasaya oturum açarken port 8250 is busy hatası | Başka bir kasa oturum açma işlemi o portta bekliyor. Onu tamamlayın ya da iptal edin, sonra yeniden deneyin. |
| Kasa oturum açma sayfası açılıyor ama ardından hiçbir şey olmuyor | Uzak bir penceredesiniz (SSH ya da bir konteyner). 8250 portunu kendi makinenize yönlendirin ya da yerel bir pencereden oturum açın. |
| Bir araç sunucusu görünmüyor | Size erişim verilmemiş ya da ekibiniz onu kullanamıyor. Yöneticinize sorun. |
| Diğer her şey | AIMO: Show Log komutunu çalıştırın: günlük, eklentinin ne denediğini ve ne yanıt aldığını gösterir. |
Henüz bir Bosphorus kurulumunuz yok mu?
Eklentinin konuşacağı bir platforma ihtiyacı vardır. Bir kavram kanıtı, Bosphorus'u sizin kümenizde, sizin kimlik sağlayıcınız ve kurallarınızla ayağa kaldırır ve sonunda kanıtı size teslim eder.