Keep public API DTOs separate from domain entities
Use explicit request and response contracts so persistence fields and domain state do not become part of the public API accidentally.
Dotnet
Microsoft Foundry: When Agent Framework Agents Become Managed Resources
How to host a Microsoft Agent Framework agent in Foundry while keeping authorization, conversation ownership, identity, and governance boundaries explicit.
Choose rate-limiting policies by endpoint cost
Apply different ASP.NET Core rate limits to cheap reads and expensive AI or data-processing endpoints.
Design queue handlers for duplicate delivery
Assume a queue message can arrive more than once and make the handler’s business effects safe to repeat.
Use Aspire service discovery instead of hardcoded ports
Let Aspire pass service discovery information so application code can use logical service names instead of local port numbers.
When an AI Request Should Become a Background Job
How to decide when a .NET AI request should stay synchronous, stream its response, or move to a durable background job with HTTP 202 and a status resource.
Do not page without deterministic ordering
Give paged database queries a fully unique order so rows with the same sort value cannot move unpredictably between pages.
Validate structured model output before using it
Treat deserialized model output as untrusted data and apply normal business validation before it drives application behavior.
Use PeriodicTimer for cancellable asynchronous loops
Use PeriodicTimer when a background loop needs an awaitable cadence, cooperative shutdown, and sequential executions.
Testing Microsoft Agent Framework Applications
How to test Microsoft Agent Framework applications with fake model clients, tool contract tests, structured output tests, routing tests, workflow tests, and eval-style regression checks.