Προσομοιωμένος διακομιστής εργαλείων

Το Agent 365 CLI περιλαμβάνει έναν προσομοιωμένο διακομιστή εργαλείων για σκοπούς δοκιμής και ανάπτυξης. Αυτός ο διακομιστής προσομοιώνει τις αλληλεπιδράσεις διακομιστή MCP (Model Context Protocol), ώστε να μπορείτε να δοκιμάσετε τις δυνατότητες εργαλείων του παράγοντα σας τοπικά χωρίς να χρειάζεστε πραγματικές υλοποιήσεις διακομιστή. Δεν καλύπτει άλλες δυνατότητες του Agent 365.

Πλεονεκτήματα της χρήσης του δοκιμαστικού διακομιστή

Ο δοκιμαστικός διακομιστής προσφέρει τα ακόλουθα οφέλη για τοπική ανάπτυξη και δοκιμές:

Ανάπτυξη εκτός σύνδεσης: Δοκιμάστε τον παράγοντα σας χωρίς σύνδεση στο διαδίκτυο ή εξωτερικές εξαρτήσεις.
Συνεπείς δοκιμές: Λάβετε προβλέψιμες απαντήσεις για τη δοκιμή ακραίων περιπτώσεων.
Εντοπισμός σφαλμάτων: Προβολή όλων των αιτημάτων και των απαντήσεων σε πραγματικό χρόνο
Ταχεία επαναληπτική ανάπτυξη: Δεν χρειάζεται να περιμένετε για εξωτερικές κλήσεις API ή να ρυθμίσετε σύνθετα περιβάλλοντα δοκιμών.

Προαπαιτούμενα στοιχεία

Πριν χρησιμοποιήσετε τον δοκιμαστικό διακομιστή εργαλείων, βεβαιωθείτε ότι έχετε τις ακόλουθες προϋποθέσεις:

Έχετε εγκαταστήσει το Agent 365 CLI - Χρησιμοποιήστε τον δοκιμαστικό διακομιστή εργαλείων παράλληλα με το CLI. Ανατρέξτε στο Agent 365 CLI για οδηγίες εγκατάστασης.
- Θα πρέπει να έχετε τουλάχιστον την έκδοση 1.1.25-preview για να χρησιμοποιήσετε τον δοκιμαστικό διακομιστή εργαλείων.
Δείγμα έργου παράγοντα - Ένα έργο τοπικού παράγοντα που μπορεί να συνδεθεί με διακομιστές MCP. Δείτε το αποθετήριο Agent365-Samples για διαθέσιμα πρότυπα έργα.

Εκκίνηση του δοκιμαστικού διακομιστή εργαλείων

Χρησιμοποιήστε την εντολή a365 develop start-mock-tooling-server για να ξεκινήσετε τον δοκιμαστικό διακομιστή εργαλείων

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

# Short alias
a365 develop mts

Επιλογές εντολής

Ο δοκιμαστικός διακομιστής εργαλείων υποστηρίζει τις ακόλουθες επιλογές:

Επιλογή	Περιγραφή	Προεπιλογή
`-p, --port <port>`	Αριθμός θύρας για τον δοκιμαστικό διακομιστή	5309
`-v, --verbose`	Εναλλαγή λεπτομερούς σύνδεσης	ψευδής
`-?, -h, --help`	Εμφάνιση βοήθειας και οδηγιών χρήσης	-
`-bg`	Εκτελέστε τον διακομιστή σε ένα νέο τερματικό	-

Παραδείγματα

Τα ακόλουθα παραδείγματα δείχνουν συνήθεις τρόπους εκκίνησης του δοκιμαστικού διακομιστή εργαλείων:

Ξεκινήστε με τις προεπιλεγμένες ρυθμίσεις:

a365 develop start-mock-tooling-server

Ξεκινήστε σε προσαρμοσμένη θύρα:

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

Ξεκινήστε με αναλυτική καταγραφή:

a365 develop start-mock-tooling-server -v

Όταν εκτελείτε την εντολή:

Εκκινεί τον δοκιμαστικό διακομιστή στην καθορισμένη θύρα (προεπιλογή: localhost:5309).
Εμφανίζει τα αρχεία καταγραφής του διακομιστή και τα εισερχόμενα αιτήματα στο τερματικό.

Χρήση δοκιμαστικού διακομιστή με δείγματα παραγόντων

Για να συνδέσετε το δείγμα παράγοντα στον δοκιμαστικό διακομιστή εργαλείων:

Βήμα 1: Ξεκινήστε τον δοκιμαστικό διακομιστή

a365 develop start-mock-tooling-server

Ο διακομιστής ξεκινά και εμφανίζει έξοδο παρόμοια με το ακόλουθο παράδειγμα:

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: Ρυθμίστε τον παράγοντά σας

Ορίστε τη μεταβλητή περιβάλλοντος MCP_PLATFORM_ENDPOINT στο δείγμα παράγοντα ώστε να δείχνει στον δοκιμαστικό διακομιστή:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Αν χρησιμοποιείτε προσαρμοσμένη θύρα, αντικαταστήστε το 5309 με τον αριθμό θύρας που έχετε επιλέξει.

Βήμα 3: Εκκινήστε τον παράγοντα σας

Ξεκινήστε τον παράγοντα δειγμάτων σας όπως κάνετε συνήθως. Ο παράγοντας συνδέεται τώρα με τον δοκιμαστικό διακομιστή αντί για τους πραγματικούς διακομιστές MCP.

Βήμα 4: Παρακολουθήστε τη δραστηριότητα του διακομιστή

Το τερματικό του δοκιμαστικού διακομιστή εμφανίζει:

Εισερχόμενα αιτήματα από τον παράγοντά σας
Προσομοιωμένες απαντήσεις που στέλνονται πίσω
Κατάσταση σύνδεσης και σφάλματα (εάν υπάρχουν)

Παραδείγματα καταγραφών διακομιστή:

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

Διακοπή του δοκιμαστικού διακομιστή

Για να διακόψετε τον δοκιμαστικό διακομιστή, χρησιμοποιήστε Ctrl+C στο τερματικό όπου εκτελείται ο διακομιστής ή κλείστε το παράθυρο του τερματικού.

Αντιμετώπιση προβλημάτων

Αυτή η ενότητα περιέχει πληροφορίες σχετικά με την αντιμετώπιση συνηθισμένων προβλημάτων με τον δοκιμαστικό διακομιστή εργαλείων.

Φιλοδώρημα

Ο Οδηγός αντιμετώπισης προβλημάτων του Agent 365 περιλαμβάνει συστάσεις αντιμετώπισης προβλημάτων υψηλού επιπέδου, βέλτιστες πρακτικές και συνδέσμους για περιεχόμενο αντιμετώπισης προβλημάτων για κάθε μέρος του κύκλου ζωής ανάπτυξης του Agent 365.

Ο δοκιμαστικός διακομιστής δεν ξεκινάει

Σύμπτωμα:Error: Address already in use

Αιτία: Μια άλλη διεργασία χρησιμοποιεί ήδη την προεπιλεγμένη θύρα (5309) ή την καθορισμένη θύρα.

Λύση:

Χρήση διαφορετικής θύρας.

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

Ή σταματήστε τη διαδικασία που χρησιμοποιεί τη θύρα και δοκιμάστε ξανά.

Ο παράγοντας δεν μπορεί να συνδεθεί σε δοκιμαστικό διακομιστή

Σύμπτωμα: Τα αρχεία καταγραφής του παράγοντα εμφανίζουν σφάλματα σύνδεσης ή χρονικά όρια κατά την προσπάθεια σύνδεσης με τον δοκιμαστικό διακομιστή.

Αιτία:

Ο δοκιμαστικός διακομιστής δεν εκτελείται.
Λανθασμένη μεταβλητή περιβάλλοντος MCP_PLATFORM_ENDPOINT.
Προβλήματα ρύθμισης παραμέτρων τείχους προστασίας ή δικτύου.