在 Visual Studio Code 中配置與管理代理程式

一旦你有了宣告式代理（在 Foundry 入口網站或透過 SDK 建立），真正的工作就開始了——配置它的行為、指令和屬性以符合你的需求。 Microsoft Foundry VS Code 擴充功能透過視覺化 Agent Designer 與直接 YAML 檔案編輯，提供完整的設定選項，讓你在工作方式上有彈性。

配置代理屬性

代理人設計器提供直覺介面，幫助設定代理人的核心屬性。 這些設定定義了經紀人行為與表現的基本面向。

基本配置選項

在代理設計器中，你可以設定幾個關鍵屬性：

代理人名稱 - 輸入一個明確說明代理人目的的描述性名稱。 這個名字會出現在清單、日誌中，以及其他開發人員與你的代理人合作時。

模型選擇 - 從下拉選單選擇您的模型部署。 這個選擇決定了哪種 AI 模型能驅動你的代理人的回應。 下拉選單只會顯示你已經部署在專案中的模型。

說明 - 加入一份清晰且簡潔的經紀人工作描述。 良好的描述幫助團隊成員理解客服的目的，而不必閱讀其指示或程式碼。

系統指令 - 定義代理人的行為、個性與反應風格。 這時你塑造代理人如何理解自己的角色並與使用者互動。

代理 ID - 由擴充功能在建立代理時自動產生。 這個唯一識別碼用於透過 API 呼叫你的客服人員。

模型配置選項

除了選擇模型外，你還可以透過額外參數微調其行為：

溫度 ——控制反應、創造力與隨機性。 較低的數值（0.1-0.3）產生一致且聚焦的輸出。 數值越高（0.7-1.0）能產生更有創意且多變的回應。 對於處理結構化任務的業務代理來說，0.3 到 0.7 之間的數值通常效果良好。

頂尖P - 透過限制生成時的詞彙選擇來控制多樣性。 大多數情境在預設值 1.0 下運作良好，但你可以降低它以獲得更受限且可預測的輸出。

這些設定同時出現在 Designer 介面和 YAML 檔案中，並在兩個視圖間保持同步。

理解代理 YAML 結構

YAML 檔案包含了你所有宣告代理的設定，並以結構化且可讀的形式呈現。 理解這種結構有助於你在視覺介面不合時做出精確調整並高效工作。

完整 YAML 範例

這裡有一個完整設定的代理 YAML 檔案：

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: healthcare-assistant
description: Assists healthcare staff with patient appointment scheduling and information retrieval
id: 'agent-abc123xyz'
metadata:
  authors:
    - developer-name
  tags:
    - healthcare
    - customer-service
    - scheduling
model:
  id: 'gpt-4.1'
  options:
    temperature: 0.5
    top_p: 1
instructions: |
  You're a healthcare assistant helping staff schedule patient appointments and retrieve information.

  Your responsibilities:
  - Help staff find available appointment slots
  - Answer questions about patient scheduling policies
  - Provide information about different appointment types
  - Assist with rescheduling and cancellations

  Important guidelines:
  - Never access or share patient medical information
  - Always verify appointment details before confirming
  - Be professional but friendly in all interactions
  - If you're unsure about policies, advise staff to check with management
tools: []

YAML 結構自然分為多個區塊：元資料、模型設定、指令與工具。 這種組織讓你很容易找到並修改特定設定。

YAML 配置的優點

直接 YAML 編輯具有多項優點：

• 版本控制 - 在 Git 中追蹤變更與應用程式代碼並列
• 批量更新 - 同時自信地進行多項變更
• 範本 - 建立可重複使用的代理範本以實現一致的設定
• 程式碼審查 ——將代理設定納入標準程式碼審查流程中
• 自動化 - 建立程式化的腳本，產生或修改代理設定

擴充功能即時驗證 YAML 語法，並在你輸入時標示錯誤並提供建議。

代理程式設定的最佳實務

隨著你打造更複雜的代理人，以下做法有助於維持品質與可靠性：

對你的 YAML 檔案進行版本控制 ——將代理程式設定與應用程式代碼一起提交到 Git。 這能實現回退、程式碼審查及變更追蹤。

使用描述性名稱和標籤 ——清晰的命名與標籤，隨著收藏的增加，更容易找到並辨識代理人。

記錄複雜指令 ——在你的 YAML 檔案中加入註解，說明你為何選擇特定的指令模式或配置。

每次變更後測試 - 使用整合的遊樂場驗證設定修改後的行為。 小改變可能帶來意想不到的影響。

從簡單開始，然後反覆練習 ——從基本指示開始，根據測試結果增加複雜度。 過於複雜的初始指令較難除錯。

保持指示聚焦 ——每位代理人都應該有明確且具體的目的。 代理程式嘗試做太多事，表現不穩定。

在 Visual Studio Code 中配置代理提供強大的功能，有助於建立複雜的自動化。 視覺設計工具與直接 YAML 編輯的結合，使開發能快速進行，同時維持生產部署所需的精確度。