Schémas de réponse aux outils MCP et conception de l'agent

Réponses JSON prises en charge

La prise en charge d'Agentforce Builder est plus forte pour les valeurs primitives et l'accès aux champs peu profonds. Choisissez donc des outils serveur MCP avec de simples réponses JSON structurées ou ajustez vos réponses pour exposer des valeurs importantes en tant que champs primitifs ou simples champs de niveau supérieur, si possible. Les réponses JSON prises en charge comprennent les objets de niveau supérieur, les propriétés des objets de niveau supérieur et les tableaux d'objets de niveau supérieur. Actuellement, les formes plus complexes ne sont pas prises en charge de bout en bout, notamment les propriétés imbriquées, les tableaux d'objets et les charges utiles d'objets dynamiques.

De la même façon que les autres actions de l'agent, si une entrée ou une sortie d'action d'outil MCP contient plusieurs niveaux de propriétés (par exemple, propriétés imbriquées, tableaux d'objets ou charges de travail d'objet dynamiques), l'agent peut utiliser uniquement le premier niveau de propriétés dans des entrées d'action, des sorties d'action et des mappages de variables.

{"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": {}
      }
    }
  }
}

Types Lightning

Toutes les actions des agents utilisent des types Lightning pour définir la structure, valider et afficher les données dans les entrées et les sorties. Les schémas d'entrée et de sortie des outils MCP ne sont pas toujours mappés avec des types Lightning, car le type de données est défini par le serveur et le protocole prend en charge un large éventail de types de données. Par exemple, lorsqu'un type de données contient un opérateur, par exemple any/or. Apprenez-en plus sur les types Lightning standard et comment les types Lightning sont utilisés dans les actions des agents.

Lorsque les données ne peuvent pas être résolues dans un type Lightning, vous pouvez afficher le schéma d'entrée et de sortie de l'outil dans la page d'enregistrement du serveur MCP dans le Registre Agentforce. Cependant, l'entrée ou la sortie est vide pour l'action d'outil MCP associée dans la bibliothèque d'actifs et dans votre agent.

Vous pouvez toujours utiliser l'action de l'outil MCP avec votre agent, mais l'entrée ou la sortie ne peut pas être stockée dans une variable ni utilisée dans une logique ou des instructions en aval.

• L'action ne peut pas être enchaînée à une autre action de façon déterministe. Cependant, dans le raisonnement, l'agent peut choisir des entrées et des sorties pertinentes.
• L'action ne peut pas être exécutée de façon déterministe dans des instructions de raisonnement, car chaque entrée et sortie doit être mappée avec une variable.
• Vous ne pouvez pas utiliser des sorties qui ne sont pas résolues en types Lightning dans des instructions conditionnelles ou des filtres.

Pour de meilleurs résultats, planifiez le raisonnement des agents sur le comportement déterministe dans la conception de vos agents et configurez des instructions simples et en langage naturel pour les sous-agents.

Voici un exemple d'outil MCP avec une sortie qui n'est pas mappée avec un type Lightning.

• Schémas d'entrée et de sortie dans la page d'enregistrement du serveur MCP :
  
• Une sortie vide pour l'action d'outil MCP associée dans la bibliothèque d'actifs :
  
• Une sortie vide pour l'action d'outil MCP associée dans un agent :