Foundry Toolkit + Foundry Hosted Agents dirbtuvės

Kurkite, testuokite ir diekite DI agentus į Microsoft Foundry Agent Service kaip Hosted Agents – visiškai naudodami VS Code su Microsoft Foundry plėtiniu ir Foundry Toolkit.

Hosted Agents šiuo metu yra peržiūros stadijoje. Palaikomos regionų apribotos - žr. regionų prieinamumą.

Kiekvieno laboratorinio darbo aplanke agent/ yra automatiškai sukurta Foundry plėtinio – jūs tuomet suasmeninate kodą, testuojate vietoje ir diegiate.

🌐 Daugiakalbė palaikymas

Palaikoma per GitHub veiksmą (Automatizuota ir visada atnaujinta)

Norite kopijuoti vietoje?

Šis saugykla turi daugiau nei 50 kalbų vertimų, kurie žymiai padidina atsisiuntimo dydį. Norėdami nukopijuoti be vertimų, naudokite ribotą atsisiuntimą:

Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Lab
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'
CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Lab
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"
Tai suteikia viską, ko reikia kursui užbaigti, su daug greitesniu atsisiuntimu.

Architektūra

flowchart TB
    subgraph Local["Vietinis kūrimas (VS Code)"]
        direction TB
        FE["Microsoft Foundry
        Extension"]
        FoundryToolkit["Foundry Toolkit
        Extension"]
        Scaffold["Scaffolded Agent Code
        (main.py · agent.yaml · Dockerfile)"]
        Inspector["Agent Inspector
        (Local Testing)"]
        FE -- "Create New
        Hosted Agent" --> Scaffold
        Scaffold -- "F5 derinimas" --> Inspector
        FoundryToolkit -.- Inspector
    end

    subgraph Cloud["Microsoft Foundry"]
        direction TB
        ACR["Azure Container
        Registry"]
        AgentService["Foundry Agent Service
        (Hosted Agent Runtime)"]
        Model["Azure OpenAI
        (gpt-4.1 / gpt-4.1-mini)"]
        Playground["Foundry Playground
        & VS Code Playground"]
        ACR --> AgentService
        AgentService -- "/responses API" --> Model
        AgentService --> Playground
    end

    Scaffold -- "Deploy
    (Docker build + push)" --> ACR
    Inspector -- "POST /responses
    (localhost:8088)" --> Šablonas
    Playground -- "Testo užklausos" --> AgentService

    style Local fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
    style Cloud fill:#fff4e6,stroke:#f59e0b,stroke-width:2px

Srautas: Foundry plėtinys sukuria agentą → jūs suasmeninate kodą ir nurodymus → testuojate vietoje su Agent Inspector → diegiate į Foundry (Docker atvaizdas siunčiamas į ACR) → patikrinimas Playground.

Ką kursite

Darbas	Aprašymas	Būsena
Laboratorija 01 - Vienas agentas	Sukurkite „Paaiškinkite kaip vadovui“ agentą, testuokite jį vietoje ir diegkite į Foundry	✅ Galima
Laboratorija 02 - Daugiagentinis darbas	Sukurkite „CV → Darbo tinkamumo vertintojas“ - 4 agentai bendradarbiauja vertindami CV tinkamumą ir generuodami mokymosi planą	✅ Galima

Susipažinkite su Executive agentu

Šiose dirbtuvėse kursite „Paaiškinkite kaip vadovui“ agentą – DI agentą, kuris sudėtingą techninį žargoną verčia į ramius, tinkamus valdybos posėdžiui santraukas. Nes, tiesą sakant, niekas C-lygyje nenori girdėti apie „vijos valdymo išsekimą, kurį sukėlė sinchroniniai kvietimai, pridėti v3.2 versijoje“.

Šį agentą sukūriau po dar vieno incidento, kai mano kruopščiai paruoštą postmortem atsakymas buvo: „Tai... ar svetainė neveikia ar veikia?“

Kaip tai veikia

Įvedate techninį atnaujinimą. Agentas grąžina vadovo santrauką - tris punktus, be žargono, be steko išklotinės, be egzistencinio nerimo. Tik kas nutiko, verslo poveikis ir kitas žingsnis.

Pamatykite veikiant

Jūs sakote:

„API vėlavimas padidėjo dėl vijos valdymo išsekimo, kurį sukėlė sinchroniniai kvietimai pridėti v3.2 versijoje.“

Agentas atsako:

Vadybinio lygmens santrauka:

Kas nutiko: Po naujausio išleidimo sistema sulėtėjo.

Verslo poveikis: Kai kurie naudotojai patyrė vėlavimus naudodamiesi paslauga.

Kitas žingsnis: Pakeitimas buvo atšauktas ir ruošiamas taisymas prieš pakartotinį diegimą.

Kodėl šis agentas?

Tai paprastas, vienos paskirties agentas – puikus būdas išmokti hostingų agentų darbo eigą nuo pradžios iki pabaigos be sudėtingų priemonių grandinių. Ir tiesą sakant? Kiekviena inžinerinė komanda galėtų tokį turėti.

Dirbtuvių struktūra

📂 Foundry_Toolkit_for_VSCode_Lab/
├── 📄 README.md                      ← You are here
└── 📂 workshop/
    ├── 📂 lab01-single-agent/        ← Full lab: docs + agent code
    │   ├── README.md                 ← Hands-on lab instructions
    │   ├── 📂 docs/                  ← Step-by-step tutorial modules
    │   │   ├── 00-prerequisites.md
    │   │   ├── 01-setup.md
    │   │   ├── 02-create-hosted-agent.md
    │   │   ├── 03-configure-and-code.md
    │   │   ├── 04-test-locally.md
    │   │   ├── 05-deploy-to-foundry.md
    │   │   ├── 06-verify-in-playground.md
    │   │   ├── 07-summary.md
    │   │   └── 08-troubleshooting.md
    │   └── 📂 agent/                 ← Reference solution (auto-scaffolded by Foundry extension)
    │       ├── agent.yaml
    │       ├── Dockerfile
    │       ├── main.py
    │       └── requirements.txt
    └── 📂 lab02-multi-agent/         ← Resume → Job Fit Evaluator
        ├── README.md                 ← Hands-on lab instructions (end-to-end)
        ├── 📂 docs/                  ← Step-by-step tutorial modules
        │   ├── 00-prerequisites.md
        │   ├── 01-understand-multi-agent.md
        │   ├── 02-scaffold-multi-agent.md
        │   ├── 03-configure-agents.md
        │   ├── 04-orchestration-patterns.md
        │   ├── 05-test-locally.md
        │   ├── 06-deploy-to-foundry.md
        │   ├── 07-verify-in-playground.md
        │   └── 08-troubleshooting.md
        └── 📂 PersonalCareerCopilotCompleted/ ← Reference solution (multi-agent workflow)
            ├── agent.yaml
            ├── Dockerfile
            ├── main.py
            └── requirements.txt

Pastaba: Kiekvienos laboratorijos aplanke agent/ yra tai, ką sugeneruoja Microsoft Foundry plėtinys, kai vykdote komandą Microsoft Foundry: Create a New Hosted Agent Komandų paletėje. Failai tuomet suasmeninami su jūsų agento nurodymais, įrankiais ir konfigūracija. Laboratorija 01 žingsnis po žingsnio padeda sukurti tai iš naujo.

Pradžia

1. Nukopijuokite saugyklą

git clone https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Lab

2. Sukurkite Python virtualią aplinką

python -m venv venv

Aktyvuokite ją:

Windows (PowerShell):
```
.\venv\Scripts\Activate.ps1
```
macOS / Linux:
```
source venv/bin/activate
```

3. Įdiekite priklausomybes

pip install -r workshop/lab01-single-agent/agent/requirements.txt

4. Sukonfigūruokite aplinkos kintamuosius

Nukopijuokite pavyzdinį .env failą agento aplanke ir užpildykite savo reikšmes:

cp workshop/lab01-single-agent/agent/.env.example workshop/lab01-single-agent/agent/.env

Redaguokite workshop/lab01-single-agent/agent/.env:

AZURE_AI_PROJECT_ENDPOINT=https://<your-account>.services.ai.azure.com/api/projects/<your-project>
AZURE_AI_MODEL_DEPLOYMENT_NAME=<your-model-deployment-name>

5. Sekite dirbtuvių laboratorijomis

Kiekviena laboratorija yra savarankiška su savo moduliais. Pradėkite nuo Laboratorijos 01, kad išmoktumėte pagrindus, tada pereikite prie Laboratorijos 02 daugiaagentėms darbo eigoms.

Laboratorija 01 - Vienas agentas (pilnos instrukcijos)

#	Modulis	Nuoroda
1	Perskaitykite išankstines sąlygas	00-prerequisites.md
2	Įdiekite Foundry Toolkit ir Foundry plėtinį	01-setup.md
3	Sukurkite Foundry projektą	01-setup.md
4	Sukurkite hostingų agentą	02-create-hosted-agent.md
5	Sukonfigūruokite nurodymus ir aplinką	03-configure-and-code.md
6	Testuokite vietoje	04-test-locally.md
7	Diegkite į Foundry	05-deploy-to-foundry.md
8	Patikrinkite Playground	06-verify-in-playground.md
9	Gedimų šalinimas	08-troubleshooting.md

Laboratorija 02 - Daugiagentinis darbas (pilnos instrukcijos)

#	Modulis	Nuoroda
1	Išankstinės sąlygos (Laboratorija 02)	00-prerequisites.md
2	Supraskite daugiagentės architektūrą	01-understand-multi-agent.md
3	Sukurkite daugiaagentį projektą	02-scaffold-multi-agent.md
4	Suprogramuokite agentus ir aplinką	03-configure-agents.md
5	Orkestracijos modeliai	04-orchestration-patterns.md
6	Testuokite vietoje (daugiagentis)	05-test-locally.md

Priežiūros asmuo

_{Shivam Goyal}

Reikalingos teisės (greita nuoroda)

Scenarijus	Reikalingos rolės
Sukurti naują Foundry projektą	Azure AI Owner prie Foundry ištekliaus
Diegti į esamą projektą (nauji ištekliai)	Azure AI Owner + Contributor prenumeratoje
Diegti į visiškai sukonfigūruotą projektą	Reader paskyroje + Azure AI User projekte

Svarbu: Azure Owner ir Contributor rolės apima tik valdymo teises, ne kūrimo (duomenų veiksmų) teises. Jums reikia Azure AI User arba Azure AI Owner teisių, kad galėtumėte kurti ir diegti agentus.

Nuorodos

Greitas startas: Diegti savo pirmąjį talpinamą agentą (VS Code)
Kas yra talpinami agentai?
Kurti talpinamų agentų darbo eigas VS Code
Diegti talpinamą agentą
RBAC Microsoft Foundry
Architektūros peržiūros agente pavyzdys - realaus pasaulio talpinamas agentas su MCP įrankiais, Excalidraw diagramomis ir dvigubu diegimu

Licencija

MIT

Atsakomybės apribojimas: Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą Co-op Translator. Nors siekiame tikslumo, prašome atkreipti dėmesį, kad automatiniai vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas jo gimtąja kalba laikomas autoritetingu šaltiniu. Svarbiai informacijai rekomenduojama naudoti profesionalų žmogiškąjį vertimą. Mes neatsakome už jokius nesusipratimus ar neteisingą interpretaciją, kilusią naudojantis šiuo vertimu.

FilesExpand file tree

README.md

Latest commit

History