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 유형을 확인하지 않는 출력을 조건부 문 또는 필터에서 사용할 수 없습니다.

최상의 결과를 얻으려면 에이전트의 설계에서 결정적 동작에 대한 에이전트 사유를 계획하고 자연어 하위 에이전트 지침을 구성합니다.

다음은 Lightning 유형에 매핑되지 않는 출력이 있는 MCP 도구의 예입니다.

• MCP 서버 레코드 페이지의 입력 및 출력 스키마:
  
• 자산 라이브러리의 관련 MCP 도구 작업에 대한 빈 출력:
  
• 에이전트의 연결된 MCP 도구 작업에 대한 빈 출력: