Server perkakas tiruan

Agent 365 CLI menyertakan server perkakas tiruan untuk tujuan pengujian dan pengembangan. Server ini mensimulasikan interaksi server MCP (Model Context Protocol), sehingga Anda dapat menguji kemampuan tooling agen Anda secara lokal tanpa memerlukan implementasi server yang sebenarnya. Server ini tidak mencakup fungsionalitas Agent 365 lainnya.

Manfaat menggunakan server tiruan

Server tiruan menawarkan manfaat berikut untuk pengembangan dan pengujian lokal:

Pengembangan offline: Uji agen Anda tanpa konektivitas internet atau dependensi eksternal.
Pengujian yang konsisten: Dapatkan respons yang dapat diprediksi untuk pengujian kasus tepi.
Debugging: Melihat semua permintaan dan respons secara real-time
Iterasi cepat: Tidak perlu menunggu panggilan API eksternal atau menyiapkan lingkungan pengujian yang kompleks.

Prasyarat

Sebelum menggunakan server perkakas tiruan, pastikan Anda telah memenuhi persyaratan berikut:

Agent 365 CLI telah diinstal - Gunakan server perkakas tiruan bersamaan dengan CLI. Lihat Agent 365 CLI untuk petunjuk pemasangan.
- Anda harus memiliki setidaknya versi 1.1.25-preview untuk menggunakan server perkakas tiruan.
Proyek agen sampel - Proyek agen lokal yang dapat tersambung ke server MCP. Lihat repositori Agent365-Samples kami untuk berbagai contoh proyek awal yang tersedia.

Mulai server perkakas tiruan

Gunakan perintah a365 develop start-mock-tooling-server untuk memulai server perkakas tiruan.

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

# Short alias
a365 develop mts

Opsi perintah

Server perkakas tiruan mendukung opsi berikut:

Opsi	Deskripsi	Default
`-p, --port <port>`	Nomor port untuk server tiruan	5309
`-v, --verbose`	Aktifkan log berlebihan	false
`-?, -h, --help`	Menampilkan informasi bantuan dan penggunaan	-
`-bg`	Jalankan server di terminal baru	-

Contoh

Contoh berikut menunjukkan cara umum untuk memulai server perkakas tiruan:

Mulai dengan pengaturan default:

a365 develop start-mock-tooling-server

Mulai di port kustom:

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

Mulai dengan logging verbose:

a365 develop start-mock-tooling-server -v

Saat Anda menjalankan perintah, berarti:

Memulai server tiruan pada port yang ditentukan (default: localhost:5309).
Menampilkan log server dan permintaan masuk di terminal.

Menggunakan server tiruan dengan agen sampel

Untuk menyambungkan agen sampel Anda ke server perkakas tiruan:

Langkah 1: Mulai server tiruan

a365 develop start-mock-tooling-server

Server dimulai dan menampilkan output yang mirip dengan contoh berikut:

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

Langkah 2: Konfigurasikan agen Anda

Setel variabel lingkungan MCP_PLATFORM_ENDPOINT di agen sampel Anda agar mengarah ke server tiruan:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Jika Anda menggunakan port kustom, ganti 5309 dengan nomor port yang Anda pilih.

Langkah 3: Jalankan agen Anda

Mulai agen sampel Anda seperti biasa. Sekarang agen terhubung ke server tiruan, bukan server MCP yang sebenarnya.

Langkah 4: Pantau aktivitas server

Terminal server tiruan menampilkan:

Permintaan masuk dari agen Anda
Respons tiruan yang dikirim kembali
Status koneksi dan kesalahan (jika ada)

Contoh log server:

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

Menghentikan server tiruan

Untuk menghentikan server tiruan, gunakan Ctrl+C di terminal tempat server berjalan, atau tutup jendela terminal.

Pemecahan masalah

Bagian ini berisi informasi tentang cara mengatasi masalah umum pada server perkakas tiruan.

Kiat

Panduan Pemecahan Masalah Agent 365 berisi rekomendasi pemecahan masalah tingkat tinggi, praktik terbaik, dan tautan ke konten pemecahan masalah untuk setiap bagian dari siklus hidup pengembangan Agent 365.

Server tiruan gagal dimulai

Gejala:Error: Address already in use

Penyebab: Proses lain sudah menggunakan port default (5309) atau port yang Anda tentukan.

Solusi:

Gunakan port yang berbeda

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

Atau hentikan proses yang menggunakan port tersebut dan coba lagi.

Agen tidak dapat tersambung ke server tiruan

Gejala: Log agen menunjukkan kesalahan koneksi atau batas waktu saat mencoba menjangkau server tiruan.

Sebab:

Server tiruan tidak berjalan.
Variabel lingkungan MCP_PLATFORM_ENDPOINT salah.
Masalah firewall atau konfigurasi jaringan.