MCP 工具回應結構描述和工作人員設計

支援的 JSON 回應

Agentforce Builder 對原始值與淺欄位存取權的支援最為強大,因此請選擇具有簡單結構化 JSON 回應的 MCP 伺服器工具,或盡可能調整您的回應,以將重要值公開為原始欄位或簡單最上層欄位。支援的 JSON 回應包含最上層物件、最上層物件內容,以及物件的最上層陣列。目前不支援端對端更複雜的形式,包括巢狀內容、物件陣列和動態物件裝載。

如同其他工作人員動作,如果 MCP 工具動作輸入或輸出包含多個層級的內容 (例如巢狀內容、物件陣列或動態物件裝載),則工作人員只能在動作輸入、動作輸出和變數對應中使用第一個層級的內容。

{"type": "object"} 

{"type": "object", "properties": {}}

{
  "type": "object",
  "properties": {
    "prop1": {
      "type": "object"
    }
  }
} 

{
  "type": "object",
  "properties": {
    "prop1": {
      "type": "object",
      "properties": {}
    }
  }
}

{
  "type": "object",
  "properties": {
    "prop1": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  }
}

{
  "type": "object",
  "properties": {
    "prop1": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {}
      }
    }
  }
}

Lightning 類型

所有工作人員動作都使用 Lightning 類型來定義結構、驗證和顯示輸入和輸出的資料。MCP 工具的輸入與輸出結構描述不會一律對應至 Lightning 類型,因為資料類型是由伺服器定義,且通訊協定支援各種資料類型。例如,當資料類型包含運算子時,例如 any/or。深入瞭解 標準 Lightning 類型,以及 Lightning 類型如何用於工作人員動作。

當資料無法解析為 Lightning 類型時,您可以在 Agentforce 登錄中的 MCP 伺服器記錄頁面上檢視工具的輸入和輸出結構描述。但針對資產庫和您的工作人員中相關聯的 MCP 工具動作,輸入或輸出會顯示空白。

您仍可將 MCP 工具動作與工作人員搭配使用,但輸入或輸出無法儲存在變數中,或用於下游邏輯或指示中。

• 動作無法依序決定性地鏈結至另一個動作。不過,在推理中,工作人員可以選擇相關的輸入與輸出。
• 動作無法在推斷指示中決定性執行,因為每個輸入和輸出都必須對應至變數。
• 您無法在條件陳述式或 篩選條件中使用未解析為 Lightning 類型的輸出。

為獲得最佳結果,請規劃工作人員在工作人員設計中考量決定性行為,並設定簡單的自然語言子代理程式指示。

以下是 MCP 工具的範例,其中輸出未對應至 Lightning 類型。

• MCP 伺服器記錄頁面上的輸入與輸出結構描述:
  
• 資產庫中相關聯 MCP 工具動作的空白輸出:
  
• 工作人員中相關聯 MCP 工具動作的空白輸出: