在 Microsoft Foundry 中使用 Claude 打造 AI agents（第 2/3 段） ☕ Buy me a coffee

🧑‍🏫 這段從「試用 Claude」一路做到「做出會查資料的 agent」。agent 是能照指令自己去查資料、完成任務的 AI 助手。講者先在微軟的 Foundry 平台直接跟 Claude 對話、換角色設定測試，再把 Claude 接進程式，做成杯子蛋糕店的助手。看完會知道從聊天走到 agent，中間實際要做哪幾步。

• 11:27 開啟 Foundry 後可以點進出現的 project，打開 project 空間；講者後來改回上一頁，從 start building 頁面開始
  ↳ Microsoft Foundry 是微軟放 AI 模型、讓人在上面做應用的雲端平台，project 是你在裡面的工作空間。講者本來點進去，後來退回上一頁，改從 start building 開始示範。
• 12:00 進入 start building 頁面後，切換到 build 分頁，側邊會出現幾個方塊，其中一個是 models
  ↳ start building 是入門頁面。切到 build 分頁後，旁邊會出現幾個功能方塊，要找的是 models，也就是放模型的地方。
• 12:31 點 build → models 後，頁面會列出可以使用的模型，已經有 Claude Sonnet 4.6
  ↳ 點進 models 會看到目前能用的模型清單，Claude Sonnet 4.6 已經在裡面，可以直接選來用。
• 12:31 點選模型會在 Foundry 裡開啟 playground 環境
  ↳ 點一下模型，就會打開 playground。它是 Foundry 內建的試用區，長得像聊天視窗，不用寫程式就能直接測模型。
• 13:01 在 playground 可以直接和模型對話；側邊有 custom instructions，預設是「你是幫人查資訊的 AI 助理」
  ↳ 在 playground 打字就能跟模型聊天。旁邊的 custom instructions（也叫 system prompt）是事先交代模型「你是誰、要怎麼回答」的設定，預設是查資訊的助理。
• 13:01 Foundry 很適合用來實驗、比較不同模型，看哪個模型好用，以及它們搭配不同 system prompt 的表現
  ↳ Foundry 最適合拿來「試」：同一個問題丟給不同模型，或換不同 system prompt，比比看誰的回答最合你要的，再決定用哪個。
• 13:32 測試問「Hello, who are you?」，模型回答自己是 Anthropic 開發的 AI 助理 Claude，代表運作正常
  ↳ 問一句「你是誰」是最簡單的檢查。它回答自己是 Anthropic 做的 Claude，就代表模型有接通、能正常回應。
• 14:02 更換 system prompt 的方法：刪掉目前的指令，按綠色按鈕自動填入。新的 prompt 是「你是一個有意識的杯子蛋糕，每題都用糖霜雙關語回答」
  ↳ 要換 system prompt，先把原本的指令刪掉，再按綠色按鈕自動填入新的。講者故意填了很誇張的角色：一顆有意識、每句話都講糖霜雙關語的杯子蛋糕。
• 14:32 問它怎麼看 Claude，模型用糖霜雙關語回答（例如說 Claude 是 AI 助理界的「icing on the cake」）
  ↳ 問它怎麼看 Claude，它真的照角色用糖霜雙關回答，說 Claude 是「icing on the cake」（錦上添花）。可見改 system prompt 會直接改掉模型說話的方式。
• 15:02 playground 可以用來測試各種問題和 system prompt，也能試更正式的 prompt 和不同功能
  ↳ 杯子蛋糕只是好玩的示範。實際上可以在這裡試正式的工作指令、各種問題和功能，確認效果以後再拿去用。
• 15:02 第三部分：把 Foundry 裡的模型帶進開發環境（IDE），示範用的是 VS Code
  ↳ 第三部分是把模型搬進寫程式的地方。IDE 是工程師寫程式用的整合工具，示範用的 VS Code 是微軟出的，很多人在用。
• 15:32 在 Foundry 點 details 分頁，取得 target URI 和 API key
  ↳ 到 Foundry 的 details 分頁拿兩樣東西。target URI 是模型的網址，程式要把問題送到這裡；API key 像一組密碼，證明你有權使用。
• 16:03 VS Code 裡已經有預先建好的檔案，第一步先改 .env 檔
  ↳ 講者事先準備好專案檔案。第一步是改 .env 檔，這個文字檔專門放網址、密碼這類設定，程式執行時會自動讀進去，不用寫死在程式裡。
• 16:35 容易出錯的地方：貼上 endpoint 後要刪掉結尾的 v1/messages，endpoint 必須以 Anthropic 結尾；檔案裡也有註解說明正確格式
  ↳ 最常出錯的一步：endpoint（程式要連過去的網址）貼上後，要刪掉結尾的 v1/messages，讓網址停在 anthropic。檔案裡的註解有寫正確格式，可以對照。
• 17:05 把 API key 貼進 .env（講者說理想上不該在台上公開貼）；模型已經設定為 Claude Sonnet 4.6
  ↳ 接著把 API key 貼進 .env。講者提醒其實不該在台上公開，因為它就像密碼。模型欄位已經設成 Claude Sonnet 4.6。
• 17:05 三個環境變數都設好後，就可以在本機測試 agent，接著打開 agent.py 檔
  ↳ .env 裡這三個設定值（網址、金鑰、模型）就叫環境變數。三個都填好，就能在自己電腦上試跑 agent，接著打開主程式 agent.py。
• 17:35 目標是做一個協助杯子蛋糕店的 agent，使用 Microsoft Agent Framework；有 Python 版，講者說可能也有 TypeScript 版
  ↳ 目標是做一個替杯子蛋糕店服務的 agent，用 Microsoft Agent Framework：幫你搭好 agent 骨架的程式工具包。它有 Python 版，講者說可能也有 TypeScript 版，這兩個都是程式語言。
• 18:05 Microsoft Agent Framework 由 Microsoft 開發、開源，是開始建 agent 的好方法；有一些相依套件，可以透過 SDK 安裝
  ↳ 這套框架是微軟做的，而且開源，程式碼公開、誰都能用，很適合入門。要先裝相依套件，也就是它運作需要的其他零件，用 SDK（官方的開發工具包）就能安裝。
• 18:05 要記得把 terminal 打開
  ↳ terminal 是用打字下指令來操作電腦的視窗。後面安裝、啟動 agent、跟 agent 對話都在這裡進行，所以要先打開。
• 18:36 複製貼上一段程式碼，就是用 Agent Framework 執行 Sparkles agent 所需的全部程式碼：先 import agent，再初始化 chat client
  ↳ 講者貼上一段現成程式碼，讓 Sparkles agent 跑起來只需要這些，份量不多。先 import（把工具載入進來），再初始化 chat client，也就是負責跟模型對話的連線元件。
• 18:36 chat client 會讀取 .env 裡的環境變數，也就是 deployment、key、endpoint
  ↳ chat client 會自己去 .env 讀 deployment（你在 Foundry 部署的模型）、key 和 endpoint。所以前面 .env 要填對，這裡才連得上。
• 19:07 在 Python 程式碼裡定義 agent，命名為 cupcake agent；把指定指令貼進 terminal 執行，就會啟動 agent
  ↳ 在程式裡定義這個 agent，取名 cupcake agent。再把指定的執行指令貼進 terminal 執行，agent 就啟動了。
• 19:38 在 terminal 跟 agent 打招呼，它會回應問候並詢問需要什麼幫忙；這就是 Microsoft Agent Framework 的基本 hello world
  ↳ 在 terminal 跟它打招呼，它會回問候，再問你需要什麼幫忙。這就是 hello world，寫程式的慣例：第一個最簡單、只用來證明「會動」的範例。
• 19:38 想多了解 Microsoft Agent Framework，可以放慢步調多讀相關資料
  ↳ 這段講得很快，只帶過最基本的用法。講者建議，想真的搞懂這套框架，就自己放慢腳步多看相關資料。
• 20:08 下一步：連接 cupcake store 的 MCP server
  ↳ 現在的 agent 只會聊天，不知道店裡的實際狀況。下一步要接上蛋糕店的 MCP server，讓它查得到真資料。
• 20:08 MCP 是 Model Context Protocol，是讓 AI agent 和外部系統溝通的開放標準
  ↳ MCP 全名 Model Context Protocol，是一套公開的共通規則。AI agent 照同一種方式就能跟外部系統溝通，不用每接一個系統就另外寫一套接法。
• 20:40 MCP server 可以提供三種東西：tools（agent 可以呼叫的函式）、prompts（可重複使用的指令片段）、resources（透過 HTTP、用 agent 預期的格式傳送的資料）
  ↳ MCP server 是照這套規則提供服務的一端，可以給 agent 三樣東西：tools 是可以叫用的功能，prompts 是可重複套用的指令範本，resources 是用 agent 看得懂的格式透過網路送來的資料。
• 20:40 MCP 的好處是只需要一個 URL 就能接上，並用 agent 容易讀的格式取得完整 API
  ↳ 好處是接起來很簡單，給 agent 一個網址就好。對方整套 API（程式之間互相要資料、下指令的管道）都會用 agent 好讀的格式送過來。
• 21:11 有些人對 MCP 處理 context 的方式有疑慮，但可以用 context engineering 的多種方法處理
  ↳ 有人對 MCP 處理 context（模型當下看得到的資訊）的方式有疑慮。講者只說可以用 context engineering（安排要給模型哪些資訊的技巧）處理，沒有細講。
• 21:11 拉出 terminal，清掉目前的內容，換成新的程式碼區塊，這段程式碼會連接 cupcake store MCP server
  ↳ 回到 terminal，清掉原本的內容，把程式換成新的一段。新的這段多了連接蛋糕店 MCP server 的部分。
• 21:41 這個 MCP server 有店裡的資訊，例如還有多少杯子蛋糕、有哪些口味，全部透過一個 URL 取得
  ↳ 這個 MCP server 裡有店裡的實際資訊，像還剩幾個杯子蛋糕、有哪些口味，全部從同一個網址就拿得到。
• 22:11 程式碼裡有 MCP server 之後，把它當成 tool 提供給 agent，agent 就能存取這個 server 的資訊
  ↳ 光連上還不夠，要在程式裡把 MCP server 當成 tool 交給 agent，agent 才能去查 server 上的資訊，像庫存和口味。
• 22:11 重新啟動 agent：按 Ctrl+C 或輸入 exit 關掉，再執行同樣的指令
  ↳ 改了程式要重新啟動才會生效。先按 Ctrl+C（強制停止）或輸入 exit 關掉 agent，再執行一次同樣的啟動指令。

在 VS Code 的 .env 檔貼上 Foundry 的 endpoint 時，講者提醒要注意什麼？