透過工具擴展代理能力

  • 9 分鐘

AI 代理最強大的功能之一是能使用工具，將能力擴展到文字生成之外。 工具使代理能執行動作、存取資料，並與外部系統整合。 Microsoft Foundry 提供內建工具並支援客製化整合，將代理從簡單的聊天介面轉變為先進的自動化系統。

了解代理程式工具

工具是代理可以調用以完成任務的程式化功能。 當代理判斷需要工具來回應使用者請求時，會自動呼叫相應工具，處理結果，並將其整合進回應中。 此功能使客服人員能即時處理資料、執行程式碼、搜尋知識庫，並與外部服務互動。

工具呼叫生命週期自動進行：

  1. 使用者向代理發送訊息
  2. 代理程式會分析請求並判斷需要哪些工具（如果有的話）
  3. 代理會呼叫適當的工具並附上相關參數
  4. 工具執行與回傳結果
  5. 代理人將結果整合進自然語言回應中
  6. 回應會回傳給使用者

這種無縫整合意味著你可以在不撰寫複雜協調程式碼的情況下，為代理增加強大功能。

內建工具概述

Microsoft Foundry 提供一個工具 目錄 ，將可用工具分為三類： 配置 型（即用內建工具）、 型錄 型（可從登錄檔新增的額外工具，包括 MCP 伺服器）及 自訂 型（透過 OpenAPI 規範或自訂實作建立自己的工具）。 你可以透過入口網站的 建置 > 工具 或 VS Code 擴充功能存取工具目錄。

以下是一些最常用的工具。

程式碼解譯器

Code Interpreter 讓代理能在安全的沙盒環境中撰寫並執行 Python 程式碼。 用於數學計算、資料分析、圖表製作、檔案處理及複雜問題解決。 例如，如果使用者要求代理人對一項 10,000 美元的投資，以 5% 的年利率計算 10 年的復利，代理人會撰寫並執行 Python 程式碼來計算精確結果。

檔案搜尋提供檢索增強生成（RAG），讓代理能搜尋您上傳的文件。 該工具會在 向量儲存 中索引你的文件，並在需要時擷取相關資訊，讓代理回應建立在你特定的知識庫中。

檔案搜尋支援 PDF、Word（.docx）、純文字（.txt）、Markdown（.md）及其他格式。 當你在代理中加入檔案搜尋時，你會建立或選擇向量儲存庫，上傳文件，系統會自動將它們索引進行語意搜尋。

Bing 網路搜尋讓您的客服人員連結到即時網路資訊，讓您能取得時事、熱門話題及超越訓練資料的資訊。 它包含自動引用產生功能，讓代理人能參考來源。

Azure AI Search 提供您現有搜尋索引中的進階知識檢索。 與支援直接上傳至代理文件的檔案搜尋不同，Azure AI Search 連接企業級索引資料來源，支援結構化與非結構化搜尋情境。

OpenAPI 工具

OpenAPI 工具允許代理程式與 OpenAPI 3.0 規範定義的外部 API 互動，將您的代理程式連接到網路服務及企業系統。 你提供規範，Microsoft Foundry 負責參數映射和回應解析。

額外內建工具

工具目錄包含更多專門情境的工具：

工具 說明
瀏覽器自動化 與網頁互動、填寫表單並擷取內容
電腦使用 與桌面應用程式互動
影像生成 根據文字描述創作圖片
SharePoint 存取 SharePoint 內容與文件庫
Microsoft Fabric 連接 Fabric 資料代理進行資料分析
深度研究 從多個來源進行深入研究
代理對代理 將任務委派給其他代理
自訂程式碼直譯器 針對專門環境的可自訂程式碼執行

工具目錄持續擴充。 請查看 Foundry 入口網站，獲取最新可用工具。

在 Visual Studio Code 中新增工具

Microsoft Foundry 擴充套件提供直覺式的介面，方便新增與設定工具。 你可以透過視覺設計器或直接編輯 YAML 檔案來新增工具。

使用視覺設計師

透過代理設計師新增工具：

  1. 在代理設計器中開啟你的代理
  2. 請前往設定面板中的 工具 區
  3. 選擇 新增工具 或 + 圖示
  4. 瀏覽工具庫中的可用工具
  5. 選擇你想新增的工具
  6. 如有需要，請設定工具專屬設定
  7. 儲存你的更改

Microsoft Foundry VS Code 擴充套件中工具目錄介面的截圖。

當你新增某些工具時，擴充功能會提示你設定相關資產。 例如，新增檔案搜尋功能，可以建立或選擇向量儲存庫來進行文件索引。

透過 YAML 新增工具

你也可以直接編輯代理的 YAML 檔案來新增工具。 當你清楚知道需要或想套用範本變更的工具時，這種方法效果很好。

這裡有一個包含多種工具的 YAML 設定範例：

version: 1.0.0
name: research-assistant
description: Helps with research tasks using code analysis and web search
model:
  id: 'gpt-4o-deployment'
instructions: |
  You're a research assistant helping users gather and analyze information.
  Use Code Interpreter for data analysis and Bing Search for current information.
tools:
  - type: code_interpreter
  - type: bing_grounding
    bing_grounding:
      connection_id: "your-connection-id"
  - type: file_search
    file_search:
      vector_store_ids:
        - "vectorstore-123"

工具陣列列出每個啟用工具及其配置。 有些工具需要額外參數，例如連線 ID 或向量儲存參考。

模型內容通訊協定 （MCP） 伺服器

模型情境協定（MCP）提供一種標準化的方式，讓客服人員能加入自訂工具。 MCP 伺服器可透過工具目錄的 目錄 區段取得，並提供可重複使用的工具介面，能在不同代理實作間穩定運作。

MCP 伺服器的類型

Foundry 工具目錄支援三種類型的 MCP 伺服器：

  • 遠端 MCP 伺服器 - 外部託管並透過網路存取。 這些是生產場景中最常見的類型。
  • 本地 MCP 伺服器 ——開發期間可在本地機器上執行。 對於部署前測試自訂工具很有用。
  • 自訂 MCP 伺服器 ——針對特定需求量身打造的自訂 MCP 伺服器實作。

MCP 伺服器的優點

MCP 伺服器提供多項優勢：

標準化協議 ——一致的工具通訊模式使整合可預測且可靠。

可重複使用的元件 ——先建構一次工具，並在多個代理和專案中使用。

社群驅動工具 - 透過 MCP 登錄系統存取社群所建置的工具，無需自訂開發即可擴展功能。

簡化整合 ——一致的介面可降低整合複雜度與維護負擔。

在 VS Code 中使用 MCP 伺服器

Microsoft Foundry 擴充套件支援 MCP 伺服器整合：

  1. 透過擴充功能的工具登錄檔瀏覽可用的 MCP 伺服器
  2. 將 MCP 伺服器加入你的代理程式設定
  3. 設定伺服器專屬設定與參數
  4. 在整合遊樂場測試 MCP 伺服器功能
  5. 部署具備 MCP 伺服器整合的代理程式至生產環境

MCP 伺服器透過專門功能擴展代理程式的能力，同時維持穩定的開發體驗。

工具配置最佳實務

有效的工具管理確保代理的可靠效能：

  • 先從內建工具開始 ，再打造客製化解決方案。 內建工具會經過測試、維護並針對平台進行優化。
  • 將工具與需求匹配 ——列出你的經紀人需要做什麼，並依此選擇工具。 不要在沒有明確目的的情況下新增工具，因為每個工具都會增加延遲。
  • 提供明確指示 ——告訴你的客服何時以及如何使用每個工具（例如「使用程式碼解譯器進行任何數學計算」）以及何時 不 該使用。
  • 保持知識庫最新 ——使用檔案搜尋時，請定期更新文件。 過時的資訊會導致錯誤的回應。
  • 徹底測試工具行為，使用整合的遊樂場。 發送消息旨在觸發工具的使用，確認正確的調用，並測試錯誤情境。

代理人可以同時使用多種工具來處理複雜的情境。 例如，研究代理可能會使用 Bing Web Search 收集最新資訊，使用 Code Interpreter 分析資料，並使用 File Search 查閱內部文件——這些皆會根據使用者的要求自動編排。

透過工具擴展客服人員的功能，將簡單的聊天介面轉變為強大的自動化系統。 透過結合內建工具與自訂整合與 MCP 伺服器，您可以創建能無縫與資料、系統及服務互動的代理，同時維持企業級安全性與可靠性。

關於工具與 MCP 伺服器的深入討論，可參考後續模組。