Step 1 of 16
Prepare .NET 10, Foundry, Agent Framework packages, credentials, and the target architecture.
เริ่มจาก architecture และ environment ก่อนครับ เพื่อให้ทุกบทต่อจาก baseline ชุดเดียวกัน
Level: Intermediate
Path นี้พาคุณสร้าง Knowledge Support Agent ด้วย .NET 10 และ Microsoft Agent Framework โดยเพิ่ม capability ตามลำดับที่ระบบต้องใช้ครับ เราจะเริ่มจาก agent ตัวเดียว แล้วค่อยเพิ่ม session, tool, approval, memory, workflow, MCP และ RAG หลังจากเส้นทางหลักทำงานแล้ว
คุณจะได้ solution ที่ build ผ่าน, pin package versions และแยก API, application, infrastructure, ingestion กับ tests ตั้งแต่วันแรกครับ
Loading diagram...
เริ่มด้วย Console app เพื่อให้เห็น agent loop ชัด จากนั้นบทท้ายจะย้ายส่วนประกอบไปอยู่ใน ASP.NET Core และ background worker ครับ
mkdir TPCoder.KnowledgeAgent && cd TPCoder.KnowledgeAgent
dotnet new sln -n TPCoder.KnowledgeAgent
dotnet new webapi -n TPCoder.KnowledgeAgent.Api -o src/TPCoder.KnowledgeAgent.Api -f net10.0
dotnet new classlib -n TPCoder.KnowledgeAgent.Application -o src/TPCoder.KnowledgeAgent.Application -f net10.0
dotnet new classlib -n TPCoder.KnowledgeAgent.Infrastructure -o src/TPCoder.KnowledgeAgent.Infrastructure -f net10.0
dotnet new worker -n TPCoder.KnowledgeAgent.Ingestion -o src/TPCoder.KnowledgeAgent.Ingestion -f net10.0
dotnet new xunit -n TPCoder.KnowledgeAgent.Tests -o tests/TPCoder.KnowledgeAgent.Tests -f net10.0
dotnet sln add src/*/*.csproj tests/*/*.csproj
Pin the reviewed package pair instead of taking two unrelated latest versions:
dotnet add src/TPCoder.KnowledgeAgent.Infrastructure package Microsoft.Agents.AI --version 1.17.0
dotnet add src/TPCoder.KnowledgeAgent.Infrastructure package Microsoft.Agents.AI.Foundry --version 1.17.0-preview.260804.1
dotnet add src/TPCoder.KnowledgeAgent.Infrastructure package Azure.AI.Projects --version 2.1.0-beta.4
dotnet add src/TPCoder.KnowledgeAgent.Infrastructure package Azure.Identity --version 1.21.0
ตั้งค่า Foundry project และ model deployment ผ่าน environment variables:
export FOUNDRY_PROJECT_ENDPOINT=https://YOUR-PROJECT.services.ai.azure.com/api/projects/YOUR-PROJECT
export FOUNDRY_MODEL=gpt-5.4-mini
az login
Microsoft Agent Framework ยังพัฒนาเร็วครับ ก่อนอัปเกรด package ให้เช็ก release notes และ build ทั้ง solution เสมอ ตัวอย่างใน path นี้ยึด API ปัจจุบันจาก repository ณ วันที่ 10 August 2026 โดยใช้ AIAgent, AgentSession, AIContextProvider และ Microsoft.Extensions.AI เป็นแกน
Microsoft.Agents.AI มี stable 1.17.0 แต่ Foundry package ที่จับคู่กันยังเป็น preview ณ วันที่ตรวจครับ ดังนั้น production approval ต้องรวม preview dependency review และ rollback plan
อย่าเพิ่ม Azure.AI.Projects แบบไม่ระบุ version ใน package set นี้ครับ NuGet จะเลือก stable 2.0.1 ซึ่งต่ำกว่า 2.1.0-beta.4 ที่ Foundry 1.17.0-preview.260804.1 ต้องใช้ และ restore จะ fail ด้วย NU1605
DefaultAzureCredential ตอน local development และเลือก credential ที่จำกัดขอบเขตบน productionบทถัดไปจะสร้าง agent ตัวแรกและทดสอบทั้ง response แบบปกติกับ streaming ครับ
dotnet restore --use-lock-file
dotnet build --no-restore --warnaserror
dotnet test --no-build
Commit global.json, Directory.Packages.props, package lock files และ architecture decision ที่อธิบายว่าทำไมเลือก Foundry provider ครับ
CI ต้อง restore จาก lock file และ fail เมื่อ package version drift ตรวจด้วยว่า repository ไม่มี endpoint, API key หรือ local session file ก่อน merge
ส่ง solution skeleton, version-pinning files, CI build และ setup notes ที่ developer อีกคนทำตามบนเครื่องใหม่ได้