Mock tooling sunucusu

Agent 365 CLI, test ve geliştirme amaçlı bir sanal araç sunucusu içerir. Bu sunucu, MCP (Model Bağlam Protokolü) sunucu etkileşimlerini simüle eder; böylece, aracınızın araçlandırma yeteneklerini yerel olarak, gerçek sunucu uygulamalarına ihtiyaç duymadan test edebilirsiniz. Diğer Agent 365 işlevlerini kapsamıyor.

Mock sunucu kullanımının avantajları

Mock sunucu, yerel geliştirme ve test için aşağıdaki avantajları sunar:

Çevrimdışı geliştirme: Aracınızı internet bağlantısı veya harici bağımlılıklar olmadan test edin.
Tutarlı testler: Uç durumları test ederken öngörülebilir yanıtlar alın.
Hata ayıklama: Tüm istek ve yanıtları gerçek zamanlı görüntüleyin
Hızlı yineleme: Harici API çağrılarını beklemenize veya karmaşık test ortamları oluşturmanıza gerek yok.

Ön koşullar

Mock tooling sunucusunu kullanmadan önce, aşağıdaki ön koşullara sahip olduğunuzdan emin olun:

Agent 365 CLI kurulu - CLI ile birlikte mock tooling sunucusunu kullanın. Kurulum talimatları için Agent 365 CLI'ye başvurun.
- Sahte araç sunucusunu kullanabilmek için en az 1.1.25-preview sürümüne sahip olmalısınız.
Örnek aracı projesi - MCP sunucularına bağlanabilen yerel bir aracı projesi. Mevcut başlangıç noktaları için Agent365-Samples deposuna bakınız.

Mock tooling sunucusunu başlatın

a365 develop start-mock-tooling-server komutunu kullanarak mock tooling sunucusunu başlatın.

# Full command
a365 develop start-mock-tooling-server

# Short alias
a365 develop mts

Komut seçenekleri

Mock tooling sunucusu aşağıdaki seçenekleri destekler:

Seçenek	Açıklama	Varsayılan
`-p, --port <port>`	Mock sunucu için bağlantı noktası numarası	5309
`-v, --verbose`	Ayrıntılı günlük kaydını etkinleştirme	yanlış
`-?, -h, --help`	Yardım ve kullanım bilgilerini göster	-
`-bg`	Sunucuyu yeni bir terminalde çalıştırın	-

Örnekler

Aşağıdaki örnekler, mock sunucusunu başlatmanın yaygın yollarını gösterir:

Varsayılan ayarlarla başlayın:

a365 develop start-mock-tooling-server

Özel bir portta başlatın:

a365 develop start-mock-tooling-server -p 8080

Uzun ve ayrıntılı kayıtlarla başlayın:

a365 develop start-mock-tooling-server -v

Komutu çalıştırdığınızda:

Mock sunucuyu belirtilen portta başlatır (varsayılan: localhost:5309).
Terminalde sunucu kayıtlarını ve gelen istekleri gösterir.

Mock sunucuyu örnek aracılarla kullanın

Örnek aracınızı mock tooling sunucusuna bağlamak için:

Adım 1: Mock sunucuyu başlatın

a365 develop start-mock-tooling-server

Sunucu başlatılır ve aşağıdaki örneğe benzer bir çıktı gösterir:

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5309
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.

2. Adım: Aracınızı yapılandırma

Örnek aracınızda MCP_PLATFORM_ENDPOINT ortam değişkenini mock sunucuya işaret edecek şekilde ayarlayın:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Özel bir port kullanıyorsanız, 5309 yerine seçtiğiniz port numarasını yazın.

3. Adım: Aracınızı başlatın

Örnek aracınızı her zamanki gibi başlatın. Aracı artık gerçek MCP sunucuları yerine mock sunucuya bağlanıyor.

Adım 4: Sunucu aktivitesini izleyin

Mock sunucu konsolu aşağıdakileri görüntüler:

Aracınızdan gelen istekler
Geri gönderilen alaycı yanıtlar
Bağlantı durumu ve hatalar (varsa)

Örnek sunucu günlükleri:

info: Microsoft.AspNetCore.Hosting.Diagnostics[1]
      Request starting HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - application/json 351
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0]
      Executing endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Http.Result.JsonResult[3]
      Writing value of type '<>f__AnonymousType14`3' as Json.
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[1]
      Executed endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Hosting.Diagnostics[2]
      Request finished HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - 200 - application/json;+charset=utf-8 399.1814ms

Mock sunucuyu durdurmak

Mock sunucuyu durdurmak için, sunucunun çalıştığı terminalde Ctrl+C tuşlarına basın veya terminal penceresini kapatın.

Sorun giderme

Bu bölümde mock tooling sunucusu ile ilgili yaygın sorunların nasıl giderileceğine dair bilgiler bulunmaktadır.

İpucu

Agent 365 Sorun Giderme Kılavuzu yüksek seviyeli sorun giderme önerileri, en iyi uygulamalar ve Agent 365 geliştirme yaşam döngüsünün her aşamasına yönelik sorun giderme içeriğine bağlantılar sunar.

Mock sunucu başlatılamıyor

Belirti:Error: Address already in use

Sebep: Başka bir süreç zaten varsayılan portu (5309) veya belirlediğiniz portu kullanıyor.

Çözüm:

Farklı bir port kullanın.

a365 develop start-mock-tooling-server -p 8080

Ya da portu kullanan süreci sonlandırıp tekrar deneyin.

Aracı mock sunucuya bağlanamıyor

Belirti: Aracı logları, mock sunucuya ulaşmaya çalışırken bağlantı hataları veya zaman aşımları gösteriyor.

Nedeni:

Mock sunucu çalışmıyor.
Yanlış MCP_PLATFORM_ENDPOINT ortam değişkeni.
Güvenlik duvarı veya ağ yapılandırma sorunları.