Définir le schéma de compétence personnalisé

Effectué

Votre compétence personnalisée doit implémenter le schéma attendu pour les données d’entrée et de sortie prévu par les compétences dans un ensemble de compétences de Recherche Azure AI.

Schéma d’entrée

Le schéma d’entrée d’une compétence personnalisée définit une structure JSON contenant un enregistrement pour chaque document à traiter. Chaque document a un identificateur unique et une charge utile de données avec une ou plusieurs entrées, comme suit :

{
    "values": [
      {
        "recordId": "<unique_identifier>",
        "data":
           {
             "<input1_name>":  "<input1_value>",
             "<input2_name>": "<input2_value>",
             ...
           }
      },
      {
        "recordId": "<unique_identifier>",
        "data":
           {
             "<input1_name>":  "<input1_value>",
             "<input2_name>": "<input2_value>",
             ...
           }
      },
      ...
    ]
}

Schéma de sortie

Le schéma des résultats retournés par votre compétence personnalisée reflète le schéma d’entrée. Il est supposé que la sortie contient un enregistrement pour chaque enregistrement d’entrée, soit avec les résultats produits par la compétence, soit avec les détails des erreurs qui se sont produites.

{
    "values": [
      {
        "recordId": "<unique_identifier_from_input>",
        "data":
           {
             "<output1_name>":  "<output1_value>",
              ...
           },
         "errors": [...],
         "warnings": [...]
      },
      {
        "recordId": "< unique_identifier_from_input>",
        "data":
           {
             "<output1_name>":  "<output1_value>",
              ...
           },
         "errors": [...],
         "warnings": [...]
      },
      ...
    ]
}

La valeur de sortie dans ce schéma est un jeu de propriétés qui peut contenir n’importe quelle structure JSON, reflétant le fait que les champs d’index ne sont pas nécessairement de simples valeurs de données, mais peuvent contenir des types complexes.