Connect a DSW instance to an Agent through MCP - Platform For AI

Bir DSW örneğinde MCP hizmetini etkinleştirdikten sonra bu örneği bir Agent istemcisine bağlayabilirsiniz. Agent, bulut tabanlı geliştirme görevlerini yapay zekaya devretmenize olanak tanıyarak örnek içinde doğrudan komut çalıştırabilir, dosya okuyup yazabilir ve kod yürütebilir.

Ön koşullar

DSW örneği veya ait olduğu kaynak kotası için bir VPC ve güvenlik grubu yapılandırılmış olmalıdır.

Kullanım senaryoları

Bir DSW örneğini Agent'a bağladığınızda Agent, kullanıma hazır cloud geliştirme makinesine sahip olur. Kod okuyup yazabilir, komut çalıştırabilir ve denemeleri doğrudan örnek içinde yürüterek sizi tekrarlayan ortam işlemlerinden kurtarır. Tipik senaryolar şunlardır:

Uzaktan kod geliştirme ve hata ayıklama: Agent'ın örnek içinde kod oluşturmasını ve değiştirmesini sağlayın; kodu çalıştırın, hataları bulun, düzeltin ve tam bir geliştirme döngüsünü tamamlamak için yeniden çalıştırın.
Ortam hazırlığı ve bağımlılık yönetimi: Eksik Python veya sistem bağımlılıklarını yüklemesini, CUDA ve framework sürümlerini kontrol etmesini ve çalışma zamanı ortamını doğrulamasını isteyerek komutları tek tek yazmaktan kaçının.
Eğitim ve deney barındırma: Agent eğitim betiklerini başlatır ve eşzamansız olarak bekler; günlükleri ve çıktıları izler, eğitim tamamlandığında sonuçları otomatik olarak özetler.
Veri işleme ve belge düzenleme: Örnek içindeki veri dosyalarını toplu şekilde aratıp temizleyin veya web sayfalarını, PDF'leri ve Office belgelerini sonraki analizler için Markdown biçimine dönüştürün.

DSW örneğini MCP aracılığıyla bir Agent'a bağlama

Adım 1: DSW örneği oluşturun ve MCP hizmetini etkinleştirin

MCP hizmetini üç adımda etkinleştirin: hizmet anahtarını açın, erişim kimlik bilgilerini oluşturun ve güvenlik grubunda bağlantı noktasını açın. Bu işlemlerin ardından Agent, MCP protokolü üzerinden örneğe erişebilir.

MCP hizmet anahtarını etkinleştirin. Aşağıdaki örnekte genel kaynaklar kullanılarak bir örnek nasıl oluşturulacağı gösterilmektedir. Anahtar parametreleri bu bölümde açıklandığı gibi yapılandırın. Diğer parametreleri ihtiyacınıza göre ayarlayabilirsiniz.

Mevcut bir örnek için örnek listesine gidin, Actions sütununda Change Configuration seçeneğine tıklayın ve DSW örneğini yeniden yapılandırın.
- Resource Type: Genel kaynakları seçin.
- VPC Settings: Aynı bölgedeki bir VPC seçin. MCP hizmetini etkinleştirmek için VPC gereklidir.
- Security Group: Oluşturulan güvenlik grubunu seçin.
- VSwitch: Oluşturulan vSwitch'i seçin.
- Enable MCP Service: Anahtarı açın. Anahtar açıkken MCP adlı bir hizmet görünür ve varsayılan olarak örneğin 9806 numaralı bağlantı noktasında dinleme yapar.
DSW örneğine internet üzerinden (örneğin yerel bir Agent istemcisi aracılığıyla) erişmek istiyorsanız aşağıdaki parametreleri yapılandırın:
- Service Access and Port Configuration:
  - Access over Internet: Onay kutusunu seçin.
  - Internet Access Port: Örneğin 1078.
- Public Network Access: DNAT + EIP seçeneğini belirleyin
  - NAT Gateway: Aynı bölgede oluşturulan NAT ağ geçidini seçin.
  - EIP: NAT ağ geçidiyle ilişkilendirilen EIP'yi seçin.
    
    Önemli
    Önemli: DSW örneğinin internete erişmesine izin vermek için NAT ağ geçidine bir SNAT girişi yapılandırın. Daha fazla bilgi için bkz. Adanmış ağ geçidi aracılığıyla genel erişim hızını artırma.
Yapılandırmayı tamamladıktan sonra örneği oluşturmak için OK seçeneğine tıklayın.
Erişim kimlik bilgilerini oluşturun. DSW örneği oluşturulduktan sonra ayrıntılar sayfasına gitmek için örnek adına tıklayın. Access Configuration bölümünde Generate Access Credentials seçeneğine tıklayın. Bu kimlik bilgileri, Agent MCP hizmetini çağırırken kimlik doğrulaması yapmak için kullanılır. Kimlik bilgilerini istek üstbilgisinde Bearer Token olarak iletin.

Artık MCP erişim uç noktasına ve erişim kimlik bilgilerine sahipsiniz.

Not
Kimlik bilgileri varsayılan olarak 7 gün geçerlidir. Süre dolduğunda aynı konumdan yeniden oluşturun. Yeniden oluşturduktan sonra Agent yapılandırmasındaki kimlik bilgilerini güncelleyin.

Adım 2: Güvenlik grubunda bağlantı noktasını ve IP adresini açın

DSW ayrıntılar sayfasında Network Information bölümünde güvenlik grubu adına tıklayarak güvenlik grubu ayrıntıları sayfasına gidin. Inbound sekmesinde Add Rule seçeneğine tıklayın. Aşağıdaki parametreleri yapılandırın. Diğer parametreler için varsayılan değerleri kullanabilirsiniz.

Source: Agent dağıtım konumunun IP adresini girin (örneğin Agent'ı çalıştıran yerel bilgisayarın genel IP adresi).
Destination (this instance): 9806 numaralı bağlantı noktasını girin.

Adım 3: Agent'ı DSW örneğine bağlayın

DSW MCP hizmeti standart Streamable HTTP protokolünü kullanır ve yaygın Agent istemcileriyle uyumludur. Agent istemcisini (Open Code veya Qoder CLI gibi) açın ve aşağıdaki istemi Agent'a gönderin; <MCP access endpoint> ve <access credentials> ifadelerini gerçek değerlerle değiştirin. Agent, MCP bağlantısını otomatik olarak tamamlayacaktır.

Yerel bir Agent istemcisi kullanarak bir DSW örneğine bağlanıyorsanız genel erişim uç noktasını kullanın.

Add an MCP server named dsw-mcp with the Streamable HTTP protocol, endpoint http://<MCP access endpoint>, and request header Authorization: Bearer <access credentials>. Complete the setup automatically using your MCP configuration method.

Bağlantı kurulduktan sonra bağlantıyı test etmek için Agent istemcisinde aşağıdaki komutu girin.

Create a hello_world Python file in the /mnt/workspace directory on the DSW instance.

Komut çalıştırıldıktan sonra DSW örneğini açın. Çalışma alanında hello_world.py dosyası görünür.

Desteklenen araçlar

DSW MCP hizmeti, standart Streamable HTTP protokolü üzerinden bir dizi araç sunar. Agent bağlandıktan sonra araç listesini otomatik olarak yükler. Araçlar; Shell, File, System, Format conversion ve Code olmak üzere beş kategoride gruplandırılır ve toplam 16 araç bulunur.

Shell araçları

Örnek içinde komut çalıştırın. Ardışık komutlar çalışma dizinini paylaşır; bu özellik betikleri çalıştırmak, bağımlılıkları yüklemek ve eğitim işlerini başlatmak için kullanışlıdır.

Tool	Function	Key parameters
`shell_exec`	Kabuk komutu çalıştırma	cmd (zorunlu), cwd, new_session, timeout
`shell_view`	Bir oturumun birikmiş çıktısını ve durumunu görüntüleme	session_id, limit
`shell_wait`	Eşzamansız bir komutun tamamlanmasını bekleme	session_id, seconds
`shell_write`	Çalışan bir sürece giriş gönderme	session_id, input, press_enter
`shell_kill`	Bir oturumu sonlandırma ve temizleme	session_id

File araçları

Örnek içindeki dosyaları okuma, yazma, arama ve düzenleme işlemlerini gerçekleştirin.

Tool	Function	Key parameters
`file_read`	Dosya içeriğini okuma (satır aralığına göre)	path (zorunlu), start_line, end_line, sudo
`file_write`	Dosyaya yazma veya ekleme; base64 ikili veriyi destekler	path, content, encoding, append
`file_str_replace`	Bir dosya içinde dizeleri genel olarak değiştirme	path, old_str, new_str
`file_search`	Düzenli ifadeyle dosya içeriği arama	path, regex
`file_find`	Glob kalıbıyla dosya bulma	path, pattern
`file_list`	Dizinleri listeleme (özyinelemeli, türe göre filtreleme)	path, recursive, file_types
`file_edit`	Geri alınabilen düzenleyici	command (view/create/str_replace/insert/undo_edit), path vb.

System araçları

Örnek ortamını ve yüklü bağımlılıkları sorgulayın.

Tool	Function	Key parameters
`system_info`	Örnek ortamını sorgulama (işletim sistemi, Python, Node, kullanılabilir araçlar)	Yok
`system_packages`	Yüklü Python veya Node.js paketlerini listeleme	language

Format conversion araçları

Tool	Function	Key parameters
`util_to_markdown`	Web sayfalarını, PDF'leri, Office dosyalarını, görüntüleri vb. Markdown biçimine dönüştürme	uri

Code araçları

Tool	Function	Key parameters
`code_run`	Kod çalıştırma (şu anda Python desteklenir)	code, language, timeout

MCP hizmeti etkinleştirildikten sonra araçlar hemen kullanılabilir hale gelir. Ek yapılandırma gerekmez.