Skillsets - Create Or Update

Servizio:: Search Service

Versione API:: 2025-11-01-preview

Crea un nuovo set di competenze in un servizio di ricerca o aggiorna il set di competenze, se esiste già.

PUT {endpoint}/skillsets('{skillsetName}')?api-version=2025-11-01-preview

Con parametri facoltativi:

PUT {endpoint}/skillsets('{skillsetName}')?api-version=2025-11-01-preview&ignoreResetRequirements={ignoreResetRequirements}&disableCacheReprocessingChangeDetection={disableCacheReprocessingChangeDetection}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	URL dell'endpoint del servizio di ricerca.
skillsetName	path	True	string	Nome del set di competenze.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
disableCacheReprocessingChangeDetection	query		boolean	Disabilita il rilevamento delle modifiche di rielaborazione della cache.
ignoreResetRequirements	query		boolean	Ignora i requisiti di reimpostazione della cache.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Accept		Accept	L'intestazione Accetta.
If-Match		string	Definisce la condizione di If-Match. L'operazione verrà eseguita solo se l'ETag sul server corrisponde a questo valore.
If-None-Match		string	Definisce la condizione If-None-Match. L'operazione verrà eseguita solo se l'ETag sul server non corrisponde a questo valore.
Prefer	True	Prefer	Per le richieste HTTP PUT, indica al servizio di restituire la risorsa creata/aggiornata in caso di esito positivo.
x-ms-client-request-id		string (uuid)	Identificatore di stringa opaco, univoco a livello globale e generato dal client per la richiesta.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
name	True	string	Nome del set di competenze.
skills	True	SearchIndexerSkill[]: AzureMachineLearningSkill[] AzureOpenAIEmbeddingSkill[] ChatCompletionSkill[] ConditionalSkill[] ContentUnderstandingSkill[] CustomEntityLookupSkill[] DocumentExtractionSkill[] DocumentIntelligenceLayoutSkill[] EntityLinkingSkill[] EntityRecognitionSkillV3[] ImageAnalysisSkill[] KeyPhraseExtractionSkill[] LanguageDetectionSkill[] MergeSkill[] OcrSkill[] PIIDetectionSkill[] SentimentSkillV3[] ShaperSkill[] SplitSkill[] TextTranslationSkill[] VisionVectorizeSkill[] WebApiSkill[]	Elenco di competenze nel set di competenze.
@odata.etag		string	ETag del set di competenze.
cognitiveServices		CognitiveServicesAccount: AIServicesAccountIdentity AIServicesAccountKey CognitiveServicesAccountKey DefaultCognitiveServicesAccount	Dettagli sul servizio Azure AI da utilizzare durante l'esecuzione delle competenze.
description		string	Descrizione del set di competenze.
encryptionKey		SearchResourceEncryptionKey	Una descrizione di una chiave di crittografia che crei in Azure Key Vault. Questa chiave viene utilizzata per fornire un livello aggiuntivo di crittografia a riposo per la definizione del tuo set di competenze quando vuoi la piena garanzia che nessuno, nemmeno Microsoft, possa decifrare la definizione del tuo set di competenze. Dopo aver crittografato la definizione del set di competenze, rimarrà sempre crittografata. Il servizio di ricerca ignorerà i tentativi di impostare questa proprietà su null. È possibile modificare questa proprietà in base alle esigenze se si vuole ruotare la chiave di crittografia; La definizione del set di competenze non sarà influenzata. La crittografia con chiavi gestite dal cliente non è disponibile per i servizi di ricerca gratuiti ed è disponibile solo per i servizi a pagamento creati il 1° gennaio 2019.
indexProjections		SearchIndexerIndexProjection	Definizione di proiezioni aggiuntive in indici di ricerca secondari.
knowledgeStore		SearchIndexerKnowledgeStore	Definizione di proiezioni aggiuntive su blob, tabella o file Azure, di dati arricchiti.

Risposte

Nome	Tipo	Descrizione
200 OK	SearchIndexerSkillset	La richiesta ha avuto esito positivo.
201 Created	SearchIndexerSkillset	La richiesta ha avuto esito positivo e di conseguenza è stata creata una nuova risorsa.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

api-key

Tipo: apiKey
In: header

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Ambiti

Nome	Descrizione
https://search.azure.com/.default

Esempio

SearchServiceCreateOrUpdateSkillset

Esempio di richiesta

HTTP

PUT https://previewexampleservice.search.windows.net/skillsets('tempskillset')?api-version=2025-11-01-preview&ignoreResetRequirements=&disableCacheReprocessingChangeDetection=





{
  "name": "tempskillset",
  "description": "Skillset for extracting entities and more",
  "skills": [
    {
      "@odata.type": "#Microsoft.Skills.Text.LanguageDetectionSkill",
      "name": "skill2",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        },
        {
          "name": "countryHint",
          "source": "/document/countryHint"
        }
      ],
      "outputs": [
        {
          "name": "languageCode",
          "targetName": "languageCode"
        }
      ]
    },
    {
      "textSplitMode": "pages",
      "maximumPageLength": 4000,
      "unit": "azureOpenAITokens",
      "azureOpenAITokenizerParameters": {
        "encoderModelName": "cl100k_base",
        "allowedSpecialTokens": [
          "[START]",
          "[END]"
        ]
      },
      "@odata.type": "#Microsoft.Skills.Text.SplitSkill",
      "name": "skill3",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode"
        }
      ],
      "outputs": [
        {
          "name": "textItems",
          "targetName": "pages"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.KeyPhraseExtractionSkill",
      "name": "skill4",
      "context": "/document/pages/*",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode"
        }
      ],
      "outputs": [
        {
          "name": "keyPhrases",
          "targetName": "keyPhrases"
        }
      ]
    },
    {
      "uri": "https://contoso.example.org/",
      "httpMethod": "POST",
      "timeout": "PT5S",
      "@odata.type": "#Microsoft.Skills.Custom.WebApiSkill",
      "name": "skill5",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode"
        }
      ],
      "outputs": [
        {
          "name": "customresult",
          "targetName": "result"
        }
      ]
    },
    {
      "outputMode": "oneToMany",
      "markdownHeaderDepth": "h3",
      "@odata.type": "#Microsoft.Skills.Util.DocumentIntelligenceLayoutSkill",
      "name": "docIntelligenceLayoutSkill",
      "context": "/document",
      "inputs": [
        {
          "name": "file_data",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "markdown_document",
          "targetName": "markdown_document"
        }
      ]
    },
    {
      "outputFormat": "text",
      "outputMode": "oneToMany",
      "extractionOptions": [
        "images",
        "locationMetadata"
      ],
      "chunkingProperties": {
        "unit": "characters",
        "maximumLength": 500,
        "overlapLength": 50
      },
      "@odata.type": "#Microsoft.Skills.Util.DocumentIntelligenceLayoutSkill",
      "name": "docIntelligenceLayoutSkill#2",
      "context": "/document",
      "inputs": [
        {
          "name": "file_data",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "text_sections",
          "targetName": "text_sections"
        },
        {
          "name": "normalized_images",
          "targetName": "normalized_images"
        }
      ]
    },
    {
      "apiKey": "<api-key>",
      "commonModelParameters": {
        "model": "gpt-4o",
        "frequencyPenalty": 0,
        "presencePenalty": 0,
        "maxTokens": 0,
        "temperature": 0,
        "seed": 0,
        "stop": []
      },
      "extraParameters": {
        "safe_mode": true
      },
      "extraParametersBehavior": "error",
      "responseFormat": {
        "type": "jsonSchema",
        "jsonSchemaProperties": {
          "name": "Some Name",
          "description": "Some Description",
          "strict": true,
          "schema": {
            "type": "object",
            "properties": "{\"steps\": {\"type\": \"array\", \"description\": \"A list of reasoning steps.\", \"items\": {\"type\": \"string\"}}, \"answer\": {\"type\": \"string\", \"description\": \"The final answer.\"}}",
            "required": [
              "steps",
              "answer"
            ],
            "additionalProperties": false
          }
        }
      },
      "uri": "https://azs-grok-aoai.openai.azure.com/openai/deployments/azs-grok-gpt-4o/chat/completions",
      "timeout": "PT30S",
      "degreeOfParallelism": 5,
      "@odata.type": "#Microsoft.Skills.Custom.ChatCompletionSkill",
      "name": "chatCompletionSkill",
      "context": "/document/normalized_images/*",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        },
        {
          "name": "systemMessage",
          "source": "/document/system_message"
        },
        {
          "name": "userMessage",
          "source": "/document/user_message"
        },
        {
          "name": "image",
          "source": "/document/normalized_images/*"
        },
        {
          "name": "imageDetail",
          "source": "/document/detail"
        }
      ],
      "outputs": [
        {
          "name": "response",
          "targetName": "response"
        }
      ]
    },
    {
      "extractionOptions": [
        "images",
        "locationMetadata"
      ],
      "chunkingProperties": {
        "unit": "characters",
        "maximumLength": 500,
        "overlapLength": 50
      },
      "@odata.type": "#Microsoft.Skills.Util.ContentUnderstandingSkill",
      "name": "contentUnderstandingSKill",
      "context": "/document",
      "inputs": [
        {
          "name": "file_data",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "text_sections",
          "targetName": "text_sections2"
        },
        {
          "name": "normalized_images",
          "targetName": "normalized_images2"
        }
      ]
    }
  ],
  "cognitiveServices": {
    "key": "myKey",
    "subdomainUrl": "https://mySubdomainName.cognitiveservices.azure.com",
    "@odata.type": "#Microsoft.Azure.Search.AIServicesByKey",
    "description": "Description of the Azure AI service resource attached to a skillset"
  },
  "@odata.etag": "0x1234568AE7E58A1"
}

Risposta di esempio

Codice di stato:: 200

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "tempskillset",
  "description": "Skillset for extracting entities and more",
  "skills": [
    {
      "@odata.type": "#Microsoft.Skills.Text.LanguageDetectionSkill",
      "name": "skill2",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content",
          "inputs": []
        },
        {
          "name": "countryHint",
          "source": "/document/countryHint",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "languageCode",
          "targetName": "languageCode"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.SplitSkill",
      "name": "skill3",
      "textSplitMode": "pages",
      "maximumPageLength": 4000,
      "unit": "azureOpenAITokens",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content",
          "inputs": []
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "textItems",
          "targetName": "pages"
        }
      ],
      "azureOpenAITokenizerParameters": {
        "encoderModelName": "cl100k_base",
        "allowedSpecialTokens": [
          "[START]",
          "[END]"
        ]
      }
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.KeyPhraseExtractionSkill",
      "name": "skill4",
      "context": "/document/pages/*",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content",
          "inputs": []
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "keyPhrases",
          "targetName": "keyPhrases"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Custom.WebApiSkill",
      "name": "skill5",
      "uri": "https://contoso.example.org/",
      "httpMethod": "POST",
      "timeout": "PT5S",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content",
          "inputs": []
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "customresult",
          "targetName": "result"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Util.DocumentIntelligenceLayoutSkill",
      "name": "docIntelligenceLayoutSkill",
      "context": "/document",
      "outputMode": "oneToMany",
      "markdownHeaderDepth": "h3",
      "extractionOptions": [],
      "inputs": [
        {
          "name": "file_data",
          "source": "/document/content",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "markdown_document",
          "targetName": "markdown_document"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Util.DocumentIntelligenceLayoutSkill",
      "name": "docIntelligenceLayoutSkill#2",
      "context": "/document",
      "outputMode": "oneToMany",
      "outputFormat": "text",
      "extractionOptions": [
        "images",
        "locationMetadata"
      ],
      "inputs": [
        {
          "name": "file_data",
          "source": "/document/content",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "text_sections",
          "targetName": "text_sections"
        },
        {
          "name": "normalized_images",
          "targetName": "normalized_images"
        }
      ],
      "chunkingProperties": {
        "unit": "characters",
        "maximumLength": 500,
        "overlapLength": 50
      }
    },
    {
      "@odata.type": "#Microsoft.Skills.Custom.ChatCompletionSkill",
      "name": "chatCompletionSkill",
      "context": "/document/normalized_images/*",
      "uri": "https://azs-grok-aoai.openai.azure.com/openai/deployments/azs-grok-gpt-4o/chat/completions",
      "timeout": "PT30S",
      "degreeOfParallelism": 5,
      "apiKey": "<api-key>",
      "extraParametersBehavior": "error",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content",
          "inputs": []
        },
        {
          "name": "systemMessage",
          "source": "/document/system_message",
          "inputs": []
        },
        {
          "name": "userMessage",
          "source": "/document/user_message",
          "inputs": []
        },
        {
          "name": "image",
          "source": "/document/normalized_images/*",
          "inputs": []
        },
        {
          "name": "imageDetail",
          "source": "/document/detail",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "response",
          "targetName": "response"
        }
      ],
      "commonModelParameters": {
        "model": "gpt-4o",
        "frequencyPenalty": 0,
        "presencePenalty": 0,
        "maxTokens": 0,
        "temperature": 0,
        "seed": 0,
        "stop": []
      },
      "extraParameters": {
        "safe_mode": true
      },
      "responseFormat": {
        "type": "jsonSchema",
        "jsonSchemaProperties": {
          "name": "Some Name",
          "description": "Some Description",
          "strict": true,
          "schema": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "steps",
              "answer"
            ],
            "properties": "{\"steps\": {\"type\": \"array\", \"description\": \"A list of reasoning steps.\", \"items\": {\"type\": \"string\"}}, \"answer\": {\"type\": \"string\", \"description\": \"The final answer.\"}}"
          }
        }
      }
    },
    {
      "@odata.type": "#Microsoft.Skills.Util.ContentUnderstandingSkill",
      "name": "contentUnderstandingSKill",
      "context": "/document",
      "extractionOptions": [
        "images",
        "locationMetadata"
      ],
      "inputs": [
        {
          "name": "file_data",
          "source": "/document/content",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "text_sections",
          "targetName": "text_sections2"
        },
        {
          "name": "normalized_images",
          "targetName": "normalized_images2"
        }
      ],
      "chunkingProperties": {
        "unit": "characters",
        "maximumLength": 500,
        "overlapLength": 50
      }
    }
  ],
  "cognitiveServices": {
    "@odata.type": "#Microsoft.Azure.Search.AIServicesByKey",
    "description": "Description of the Azure AI service resource attached to a skillset",
    "key": "myKey",
    "subdomainUrl": "https://mySubdomainName.cognitiveservices.azure.com"
  }
}

Codice di stato:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "tempskillset",
  "description": "Skillset for extracting entities and more",
  "skills": [
    {
      "@odata.type": "#Microsoft.Skills.Text.LanguageDetectionSkill",
      "name": "skill2",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content",
          "inputs": []
        },
        {
          "name": "countryHint",
          "source": "/document/countryHint",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "languageCode",
          "targetName": "languageCode"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.SplitSkill",
      "name": "skill3",
      "textSplitMode": "pages",
      "maximumPageLength": 4000,
      "unit": "azureOpenAITokens",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content",
          "inputs": []
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "textItems",
          "targetName": "pages"
        }
      ],
      "azureOpenAITokenizerParameters": {
        "encoderModelName": "cl100k_base",
        "allowedSpecialTokens": [
          "[START]",
          "[END]"
        ]
      }
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.KeyPhraseExtractionSkill",
      "name": "skill4",
      "context": "/document/pages/*",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content",
          "inputs": []
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "keyPhrases",
          "targetName": "keyPhrases"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Custom.WebApiSkill",
      "name": "skill5",
      "uri": "https://contoso.example.org/",
      "httpMethod": "POST",
      "timeout": "PT5S",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content",
          "inputs": []
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "customresult",
          "targetName": "result"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Util.DocumentIntelligenceLayoutSkill",
      "name": "docIntelligenceLayoutSkill",
      "context": "/document",
      "outputMode": "oneToMany",
      "markdownHeaderDepth": "h3",
      "extractionOptions": [],
      "inputs": [
        {
          "name": "file_data",
          "source": "/document/content",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "markdown_document",
          "targetName": "markdown_document"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Util.DocumentIntelligenceLayoutSkill",
      "name": "docIntelligenceLayoutSkill#2",
      "context": "/document",
      "outputMode": "oneToMany",
      "outputFormat": "text",
      "extractionOptions": [
        "images",
        "locationMetadata"
      ],
      "inputs": [
        {
          "name": "file_data",
          "source": "/document/content",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "text_sections",
          "targetName": "text_sections"
        },
        {
          "name": "normalized_images",
          "targetName": "normalized_images"
        }
      ],
      "chunkingProperties": {
        "unit": "characters",
        "maximumLength": 500,
        "overlapLength": 50
      }
    },
    {
      "@odata.type": "#Microsoft.Skills.Custom.ChatCompletionSkill",
      "name": "chatCompletionSkill",
      "context": "/document/normalized_images/*",
      "uri": "https://azs-grok-aoai.openai.azure.com/openai/deployments/azs-grok-gpt-4o/chat/completions",
      "timeout": "PT30S",
      "degreeOfParallelism": 5,
      "apiKey": "<api-key>",
      "extraParametersBehavior": "error",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content",
          "inputs": []
        },
        {
          "name": "systemMessage",
          "source": "/document/system_message",
          "inputs": []
        },
        {
          "name": "userMessage",
          "source": "/document/user_message",
          "inputs": []
        },
        {
          "name": "image",
          "source": "/document/normalized_images/*",
          "inputs": []
        },
        {
          "name": "imageDetail",
          "source": "/document/detail",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "response",
          "targetName": "response"
        }
      ],
      "commonModelParameters": {
        "model": "gpt-4o",
        "frequencyPenalty": 0,
        "presencePenalty": 0,
        "maxTokens": 0,
        "temperature": 0,
        "seed": 0,
        "stop": []
      },
      "extraParameters": {
        "safe_mode": true
      },
      "responseFormat": {
        "type": "jsonSchema",
        "jsonSchemaProperties": {
          "name": "Some Name",
          "description": "Some Description",
          "strict": true,
          "schema": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "steps",
              "answer"
            ],
            "properties": "{\"steps\": {\"type\": \"array\", \"description\": \"A list of reasoning steps.\", \"items\": {\"type\": \"string\"}}, \"answer\": {\"type\": \"string\", \"description\": \"The final answer.\"}}"
          }
        }
      }
    },
    {
      "@odata.type": "#Microsoft.Skills.Util.ContentUnderstandingSkill",
      "name": "contentUnderstandingSKill",
      "context": "/document",
      "extractionOptions": [
        "images",
        "locationMetadata"
      ],
      "inputs": [
        {
          "name": "file_data",
          "source": "/document/content",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "text_sections",
          "targetName": "text_sections2"
        },
        {
          "name": "normalized_images",
          "targetName": "normalized_images2"
        }
      ],
      "chunkingProperties": {
        "unit": "characters",
        "maximumLength": 500,
        "overlapLength": 50
      }
    }
  ],
  "cognitiveServices": {
    "@odata.type": "#Microsoft.Azure.Search.AIServicesByKey",
    "description": "Description of the Azure AI service resource attached to a skillset",
    "key": "myKey",
    "subdomainUrl": "https://mySubdomainName.cognitiveservices.azure.com"
  }
}

Definizioni

Nome	Descrizione
Accept	L'intestazione Accetta.
AIServicesAccountIdentity	L'account multi-regione di una risorsa di servizio AI Azure collegata a un set di competenze.
AIServicesAccountKey	La chiave account di una risorsa di servizio AI di Azure che è collegata a un set di competenze, da usare con il sottodominio della risorsa.
AzureMachineLearningSkill	La competenza AML ti permette di estendere l'arricchimento dell'IA con un modello personalizzato di Azure Machine Learning (AML). Dopo aver eseguito il training e la distribuzione di un modello AML, una competenza AML lo integra nell'arricchimento tramite intelligenza artificiale.
AzureOpenAIEmbeddingSkill	Ti permette di generare un embedding vettoriale per un dato input di testo usando la risorsa Azure OpenAI.
AzureOpenAIModelName	Il nome del modello Azure Open AI che verrà chiamato.
AzureOpenAITokenizerParameters	Azure OpenAI Tokenizer parametri.
ChatCompletionCommonModelParameters	Parametri del modello linguistico comune per i completamenti della chat. Se omesso, vengono utilizzati i valori predefiniti.
ChatCompletionExtraParametersBehavior	Specifica come gli 'extraParameters' dovrebbero essere gestiti da Azure AI Foundry. Il valore predefinito è 'error'.
ChatCompletionResponseFormat	Determina la modalità di serializzazione della risposta del modello di linguaggio. Il valore predefinito è 'text'.
ChatCompletionResponseFormatType	Specifica il modo in cui l'LLM deve formattare la risposta.
ChatCompletionSchema	Oggetto che definisce lo schema personalizzato che il modello utilizzerà per strutturare l'output.
ChatCompletionSchemaProperties	Proprietà per il formato di risposta dello schema JSON.
ChatCompletionSkill	Una competenza che chiama un modello linguistico tramite l'endpoint Chat Completions di Azure AI Foundry.
CognitiveServicesAccountKey	La chiave account multi-regione di una risorsa di servizio IA Azure collegata a un set di competenze.
ConditionalSkill	Competenza che consente scenari che richiedono un'operazione booleana per determinare i dati da assegnare a un output.
ContentUnderstandingSkill	Una competenza che sfrutta Azure AI Content Understanding per elaborare ed estrarre insight strutturati dai documenti, consentendo contenuti arricchiti e ricercabili per un'indicizzazione e un recupero migliorati dei documenti.
ContentUnderstandingSkillChunkingProperties	Controlla la cardinalità per la suddivisione in blocchi del contenuto.
ContentUnderstandingSkillExtractionOptions	Controlla la cardinalità del contenuto estratto dal documento dalla competenza.
CustomEntity	Oggetto che contiene informazioni sulle corrispondenze trovate e sui metadati correlati.
CustomEntityAlias	Oggetto complesso che può essere usato per specificare ortografia o sinonimi alternativi per il nome dell'entità radice.
CustomEntityLookupSkill	Una competenza cerca testo da un elenco personalizzato definito dall'utente di parole e frasi.
CustomEntityLookupSkillLanguage	I codici lingua supportati per il testo di input da CustomEntityLookupSkill.
DefaultCognitiveServicesAccount	Un oggetto vuoto che rappresenta la risorsa predefinita del servizio Azure AI per un set di abilità.
DocumentExtractionSkill	Competenza che estrae il contenuto da un file all'interno della pipeline di arricchimento.
DocumentIntelligenceLayoutSkill	Una competenza che estrae informazioni su contenuti e layout, tramite Azure AI Services, dai file all'interno della pipeline di arricchimento.
DocumentIntelligenceLayoutSkillChunkingProperties	Controlla la cardinalità per la suddivisione in blocchi del contenuto.
DocumentIntelligenceLayoutSkillExtractionOptions	Controlla la cardinalità del contenuto estratto dal documento dalla competenza.
EntityCategory	Stringa che indica le categorie di entità da restituire.
EntityLinkingSkill	Utilizzando l'API Analisi del testo, estrae entità collegate dal testo.
EntityRecognitionSkillLanguage	I codici della lingua supportati per il testo di input da EntityRecognitionSkill.
EntityRecognitionSkillV3	Utilizzando l'API Analisi del testo, estrae entità di diversi tipi dal testo.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta comune all'errore per tutte le API di Azure Resource Manager per restituire dettagli di errore per operazioni fallite. Questo segue anche il formato di risposta di errore OData.
ImageAnalysisSkill	Competenza che analizza i file di immagine. Estrae un set completo di funzionalità visive in base al contenuto dell'immagine.
ImageAnalysisSkillLanguage	Codici della lingua supportati per l'input da ImageAnalysisSkill.
ImageDetail	Stringa che indica i dettagli specifici del dominio da restituire.
IndexProjectionMode	Definisce il comportamento delle proiezioni dell'indice in relazione al resto dell'indicizzatore.
InputFieldMappingEntry	Mapping dei campi di input per una competenza.
KeyPhraseExtractionSkill	Competenza che usa l'analisi del testo per l'estrazione di frasi chiave.
KeyPhraseExtractionSkillLanguage	I codici della lingua supportati per il testo di input da KeyPhraseExtractionSkill.
LanguageDetectionSkill	Competenza che rileva la lingua del testo di input e segnala un singolo codice linguistico per ogni documento inviato nella richiesta. Il codice della lingua è associato a un punteggio che indica l'attendibilità dell'analisi.
MergeSkill	Competenza per unire due o più stringhe in una singola stringa unificata, con un delimitatore facoltativo definito dall'utente che separa ogni parte del componente.
OcrLineEnding	Definisce la sequenza di caratteri da utilizzare tra le righe di testo riconosciute dalla competenza OCR. Il valore predefinito è "spazio".
OcrSkill	Competenza che estrae testo dai file di immagine.
OcrSkillLanguage	I codici lingua supportati per l'input da OcrSkill.
OutputFieldMappingEntry	Mapping dei campi di output per una competenza.
PIIDetectionSkill	Utilizzando l'API Analisi del testo, estrai informazioni personali da un testo di input e ti dà la possibilità di mascherarle.
PIIDetectionSkillMaskingMode	Stringa che indica il metodo maskingMode da utilizzare per mascherare le informazioni personali rilevate nel testo di input.
Prefer	Per le richieste HTTP PUT, indica al servizio di restituire la risorsa creata/aggiornata in caso di esito positivo.
SearchIndexerDataNoneIdentity	Cancella la proprietà Identity di un'origine dati.
SearchIndexerDataUserAssignedIdentity	Specifica l'identità di un'origine dati da usare.
SearchIndexerIndexProjection	Definizione di proiezioni aggiuntive agli indici di ricerca secondari.
SearchIndexerIndexProjectionSelector	Descrizione dei dati da archiviare nell'indice di ricerca designato.
SearchIndexerIndexProjectionsParameters	Dizionario delle proprietà di configurazione specifiche della proiezione dell'indice. Ogni nome è il nome di una proprietà specifica. Ogni valore deve essere di un tipo primitivo.
SearchIndexerKnowledgeStore	Definizione di proiezioni aggiuntive per BLOB, tabelle o file di azure di dati arricchiti.
SearchIndexerKnowledgeStoreFileProjectionSelector	Definizione di proiezione per quali dati memorizzare in File di Azure.
SearchIndexerKnowledgeStoreObjectProjectionSelector	Definizione di proiezione per quali dati memorizzare in Azure Blob.
SearchIndexerKnowledgeStoreParameters	Dizionario delle proprietà di configurazione specifiche dell'archivio conoscenze. Ogni nome è il nome di una proprietà specifica. Ogni valore deve essere di un tipo primitivo.
SearchIndexerKnowledgeStoreProjection	Oggetto contenitore per vari selettori di proiezione.
SearchIndexerKnowledgeStoreTableProjectionSelector	Descrizione di quali dati memorizzare in Azure Tables.
SearchIndexerSkillset	Elenco di competenze.
SearchResourceEncryptionKey	Una chiave di crittografia gestita dal cliente in Azure Key Vault. Le chiavi create e gestite dall'utente possono essere utilizzate per crittografare o decrittografare i dati inattivi, ad esempio indici e mappe di sinonimi.
SentimentSkillLanguage	I codici lingua supportati per il testo di input da SentimentSkill.
SentimentSkillV3	Utilizzando l'API Analisi del testo, valuta il testo non strutturato e per ogni record fornisce etichette di sentiment (come "negativo", "neutrale" e "positivo") basate sul punteggio di confidenza più alto trovato dal servizio a livello di frase e documento.
ShaperSkill	Competenza per la ridevisione degli output. Crea un tipo complesso per supportare i campi compositi (noti anche come campi multipart).
SplitSkill	Competenza per suddividere una stringa in blocchi di testo.
SplitSkillEncoderModelName	Un valore che indica quale tokenizzatore usare.
SplitSkillLanguage	I codici lingua supportati per il testo di input da SplitSkill.
SplitSkillUnit	Un valore che indica l'unità da utilizzare.
TextSplitMode	Valore che indica la modalità di divisione da eseguire.
TextTranslationSkill	Competenza per tradurre testo da una lingua a un'altra.
TextTranslationSkillLanguage	Codici lingua supportati per il testo di input da TextTranslationSkill.
VisionVectorizeSkill	Ti permette di generare un embedding vettoriale per un'immagine o un dato input di testo utilizzando l'API Azure AI Services Vision Vectorize.
VisualFeature	Stringhe che indicano i tipi di funzionalità visive da restituire.
WebApiSkill	Una competenza che può chiamare un endpoint API Web, consentendo di estendere un set di competenze tramite la chiamata al codice personalizzato.

Accept

Enumerazione

L'intestazione Accetta.

Valore	Descrizione
application/json;odata.metadata=minimal

AIServicesAccountIdentity

Oggetto

L'account multi-regione di una risorsa di servizio AI Azure collegata a un set di competenze.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Azure.Search.AIServicesByIdentity	Il discriminare per i tipi derivati.
description	string	Descrizione della risorsa di servizio Azure AI allegata a un set di competenze.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Identità gestita assegnata dall'utente usata per le connessioni al servizio di intelligenza artificiale. Se non specificato, viene usata l'identità gestita assegnata dal sistema. Negli aggiornamenti al set di competenze, se l'identità non è specificata, il valore rimane invariato. Se impostato su "none", il valore di questa proprietà viene cancellato.
subdomainUrl	string	L'URL dell'endpoint del sottodominio/Azure AI Services per il corrispondente AI Service.

AIServicesAccountKey

Oggetto

La chiave account di una risorsa di servizio AI di Azure che è collegata a un set di competenze, da usare con il sottodominio della risorsa.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Azure.Search.AIServicesByKey	Il discriminare per i tipi derivati.
description	string	Descrizione della risorsa di servizio Azure AI allegata a un set di competenze.
key	string	La chiave utilizzata per fornire la risorsa di servizio AI di Azure collegata a un set di competenze.
subdomainUrl	string	L'URL dell'endpoint del sottodominio/Azure AI Services per il corrispondente AI Service.

AzureMachineLearningSkill

Oggetto

La competenza AML ti permette di estendere l'arricchimento dell'IA con un modello personalizzato di Azure Machine Learning (AML). Dopo aver eseguito il training e la distribuzione di un modello AML, una competenza AML lo integra nell'arricchimento tramite intelligenza artificiale.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Custom.AmlSkill	Il discriminare per i tipi derivati.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
degreeOfParallelism	integer (int32)	(Facoltativo) Se specificato, indica il numero di chiamate effettuate dall'indicizzatore in parallelo all'endpoint specificato. È possibile ridurre questo valore se l'endpoint non riesce con un carico eccessivo di una richiesta o generarlo se l'endpoint è in grado di accettare più richieste e si desidera un aumento delle prestazioni dell'indicizzatore. Se non è impostato, viene usato un valore predefinito pari a 5. Il degreeOfParallelism può essere impostato su un massimo di 10 e un minimo di 1.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
key	string	(Obbligatorio per l'autenticazione della chiave) Chiave per il servizio AML.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.
region	string	(Facoltativo per l'autenticazione del token). L'area in cui viene distribuito il servizio AML.
resourceId	string	(Obbligatorio per l'autenticazione del token). L'ID della risorsa Azure Resource Manager del servizio AML. Dovrebbe essere nel formato subscriptions/{guid}/resourceGroups/{resource-group-name}/Microsoft. MachineLearningServices/workspaces/{workspace-name}/services/{service_name}.
timeout	string (duration)	(facoltativo) Se specificato, indica il timeout per il client HTTP che effettua la chiamata API.
uri	string (uri)	(Obbligatorio per nessuna autenticazione o autenticazione della chiave) URI di assegnazione dei punteggi del servizio AML a cui verrà inviato il payload JSON. È consentito solo lo schema URI https.

AzureOpenAIEmbeddingSkill

Oggetto

Ti permette di generare un embedding vettoriale per un dato input di testo usando la risorsa Azure OpenAI.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill	Il discriminare per i tipi derivati.
apiKey	string	Chiave API della risorsa designata Azure OpenAI.
authIdentity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Identità gestita assegnata dall'utente usata per le connessioni in uscita.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
deploymentId	string	ID della distribuzione del modello Azure OpenAI sulla risorsa designata.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
dimensions	integer (int32)	Numero di dimensioni che devono essere presenti negli incorporamenti di output risultanti. Supportato solo nei modelli text-embedding-3 e versioni successive.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
modelName	AzureOpenAIModelName	Nome del modello di incorporamento distribuito nel percorso deploymentId specificato.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.
resourceUri	string (uri)	L'URI della risorsa Azure OpenAI.

AzureOpenAIModelName

Enumerazione

Il nome del modello Azure Open AI che verrà chiamato.

Valore	Descrizione
text-embedding-ada-002	Modello TextEmbeddingAda002.
text-embedding-3-large	TextEmbedding3Large model.
text-embedding-3-small	Modello Incorporato3Piccolo.
gpt-4o	Modello GPT4o.
gpt-4o-mini	Modello Gpt4oMini.
gpt-4.1	Modello GPT41.
gpt-4.1-mini	Modello GPT41Mini.
gpt-4.1-nano	Modello Gpt41Nano.
gpt-5	Modello GPT5.
gpt-5-mini	Modello GPT5Mini.
gpt-5-nano	Modello Gpt5Nano.

AzureOpenAITokenizerParameters

Oggetto

Azure OpenAI Tokenizer parametri.

Nome	Tipo	Descrizione
allowedSpecialTokens	string[]	(Facoltativo) Si applica solo se l'unità è impostata su azureOpenAITokens. Questo parametro definisce una raccolta di token speciali consentiti all'interno del processo di tokenizzazione.
encoderModelName	SplitSkillEncoderModelName	Si applica solo se l'unità è impostata su azureOpenAITokens. Le opzioni includono "R50k_base", "P50k_base", "P50k_edit" e "CL100k_base". Il valore predefinito è 'CL100k_base'.

ChatCompletionCommonModelParameters

Oggetto

Parametri del modello linguistico comune per i completamenti della chat. Se omesso, vengono utilizzati i valori predefiniti.

Nome	Tipo	Valore predefinito	Descrizione
frequencyPenalty	number (double)	0	Un float nell'intervallo [-2,2] che riduce o aumenta la probabilità di token ripetuti. Il valore predefinito è 0.
maxTokens	integer (int32)		Numero massimo di token da generare.
model	string		Il nome del modello da utilizzare (ad esempio, 'gpt-4o', ecc.). Il valore predefinito è null se non specificato.
presencePenalty	number (double)	0	Un float nell'intervallo [-2,2] che penalizza i nuovi token in base alla loro presenza esistente. Il valore predefinito è 0.
seed	integer (int32)		Seme casuale per il controllo di output deterministici. Se omesso, viene utilizzata la randomizzazione.
stop	string[]		Elenco delle sequenze di arresto che interromperanno la generazione di testo. Il valore predefinito è none.
temperature	number (double)	0.7	Temperatura di campionamento. Il valore predefinito è 0,7.

ChatCompletionExtraParametersBehavior

Enumerazione

Specifica come gli 'extraParameters' dovrebbero essere gestiti da Azure AI Foundry. Il valore predefinito è 'error'.

Valore	Descrizione
passThrough	Passa eventuali parametri aggiuntivi direttamente al modello.
drop	Elimina tutti i parametri extra.
error	Genera un errore se è presente un parametro aggiuntivo.

ChatCompletionResponseFormat

Oggetto

Determina la modalità di serializzazione della risposta del modello di linguaggio. Il valore predefinito è 'text'.

Nome	Tipo	Valore predefinito	Descrizione
jsonSchemaProperties	ChatCompletionSchemaProperties		Un dizionario aperto per le proprietà estese. Obbligatorio se 'type' == 'json_schema'
type	ChatCompletionResponseFormatType	text	Specifica il modo in cui l'LLM deve formattare la risposta.

ChatCompletionResponseFormatType

Enumerazione

Specifica il modo in cui l'LLM deve formattare la risposta.

Valore	Descrizione
text	Formato di risposta in testo semplice.
jsonObject	Formato arbitrario di risposta a oggetti JSON.
jsonSchema	Formato di risposta JSON che aderisce allo schema.

ChatCompletionSchema

Oggetto

Oggetto che definisce lo schema personalizzato che il modello utilizzerà per strutturare l'output.

Nome	Tipo	Valore predefinito	Descrizione
additionalProperties	boolean	False	Controlla se è consentito che un oggetto contenga chiavi/valori aggiuntivi che non sono stati definiti nello schema JSON. Il valore predefinito è false.
properties	string		Stringa in formato JSON che definisce le proprietà e i vincoli dello schema di output per il modello.
required	string[]		Matrice dei nomi delle proprietà che devono far parte della risposta del modello. Tutte le proprietà devono essere incluse per gli output strutturati.
type	string	object	Tipo di rappresentazione dello schema. Di solito "oggetto". Il valore predefinito è 'object'.

ChatCompletionSchemaProperties

Oggetto

Proprietà per il formato di risposta dello schema JSON.

Nome	Tipo	Valore predefinito	Descrizione
description	string		Descrizione dello schema JSON a cui aderirà il modello.
name	string		Nome dello schema json a cui il modello aderirà.
schema	ChatCompletionSchema		La definizione dello schema.
strict	boolean	True	Se la risposta del modello deve utilizzare o meno output strutturati. Il valore predefinito è vero.

ChatCompletionSkill

Oggetto

Una competenza che chiama un modello linguistico tramite l'endpoint Chat Completions di Azure AI Foundry.

Nome	Tipo	Valore predefinito	Descrizione
@odata.type	string: #Microsoft.Skills.Custom.ChatCompletionSkill		Il discriminare per i tipi derivati.
apiKey	string		Chiave API per l'autenticazione al modello. Non è possibile specificare contemporaneamente apiKey e authIdentity.
authIdentity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity		Identità gestita assegnata dall'utente usata per le connessioni in uscita. Se viene specificato un authResourceId e non viene specificato, viene usata l'identità gestita assegnata dal sistema. Negli aggiornamenti all'indicizzatore, se l'identità non è specificata, il valore rimane invariato. Se impostato su "none", il valore di questa proprietà viene cancellato.
authResourceId	string		Si applica alle abilità personalizzate che si collegano a codice esterno in una funzione Azure o in un'altra applicazione che fornisce le trasformazioni. Questo valore dovrebbe essere l'ID dell'applicazione creato per la funzione o l'app quando è stata registrata su Azure Active Directory. Se specificata, la competenza personalizzata si connette alla funzione o all'app usando un ID gestito (sistema o assegnato dall'utente) del servizio di ricerca e il token di accesso della funzione o dell'app, usando questo valore come ID risorsa per creare l'ambito del token di accesso.
batchSize	integer (int32)		Dimensione batch desiderata che indica il numero di documenti.
commonModelParameters	ChatCompletionCommonModelParameters		Parametri del modello di linguaggio comune che i clienti possono modificare. Se omesso, verranno applicate impostazioni predefinite ragionevoli.
context	string		Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
degreeOfParallelism	integer (int32)		Se impostato, numero di chiamate parallele che possono essere effettuate all'API Web.
description	string		Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
extraParameters			Dizionario di tipo aperto per i parametri specifici del modello che devono essere aggiunti alla chiamata di completamento della chat. Segue il modello di estensibilità di Azure AI Foundry.
extraParametersBehavior	ChatCompletionExtraParametersBehavior	error	Come vengono gestiti i parametri extra da Azure AI Foundry. Il valore predefinito è 'error'.
httpHeaders	object		Intestazioni necessarie per effettuare la richiesta HTTP.
httpMethod	string		Metodo per la richiesta HTTP.
inputs	InputFieldMappingEntry[]		Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
name	string		Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]		L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.
responseFormat	ChatCompletionResponseFormat		Determina il modo in cui l'LLM deve formattare la sua risposta. Il valore predefinito è il tipo di risposta "testo".
timeout	string (duration)		Timeout desiderato per la richiesta. Il valore predefinito è 30 secondi.
uri	string		URL per l'API Web.

CognitiveServicesAccountKey

Oggetto

La chiave account multi-regione di una risorsa di servizio IA Azure collegata a un set di competenze.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Azure.Search.CognitiveServicesByKey	Il discriminare per i tipi derivati.
description	string	Descrizione della risorsa di servizio Azure AI allegata a un set di competenze.
key	string	La chiave utilizzata per fornire la risorsa di servizio AI di Azure collegata a un set di competenze.

ConditionalSkill

Oggetto

Competenza che consente scenari che richiedono un'operazione booleana per determinare i dati da assegnare a un output.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Util.ConditionalSkill	Il discriminare per i tipi derivati.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.

ContentUnderstandingSkill

Oggetto

Una competenza che sfrutta Azure AI Content Understanding per elaborare ed estrarre insight strutturati dai documenti, consentendo contenuti arricchiti e ricercabili per un'indicizzazione e un recupero migliorati dei documenti.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Util.ContentUnderstandingSkill	Il discriminare per i tipi derivati.
chunkingProperties	ContentUnderstandingSkillChunkingProperties	Controlla la cardinalità per la suddivisione in blocchi del contenuto.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
extractionOptions	ContentUnderstandingSkillExtractionOptions[]	Controlla la cardinalità del contenuto estratto dal documento dalla competenza.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.

ContentUnderstandingSkillChunkingProperties

Oggetto

Controlla la cardinalità per la suddivisione in blocchi del contenuto.

Nome	Tipo	Valore predefinito	Descrizione
maximumLength	integer (int32)		Lunghezza massima del blocco in caratteri. Il valore predefinito è 500.
overlapLength	integer (int32)		La lunghezza della sovrapposizione fornita tra due blocchi di testo. Il valore predefinito è 0.
unit	enum: characters	characters	Unità del blocco.

ContentUnderstandingSkillExtractionOptions

Enumerazione

Controlla la cardinalità del contenuto estratto dal documento dalla competenza.

Valore	Descrizione
images	Specificare che il contenuto dell'immagine deve essere estratto dal documento.
locationMetadata	Specificare che i metadati della posizione devono essere estratti dal documento.

CustomEntity

Oggetto

Oggetto che contiene informazioni sulle corrispondenze trovate e sui metadati correlati.

Nome	Tipo	Descrizione
accentSensitive	boolean	Il valore predefinito è falso. Valore booleano che indica se i confronti con il nome dell'entità devono essere sensibili all'accento.
aliases	CustomEntityAlias[]	Matrice di oggetti complessi che possono essere utilizzati per specificare ortografie o sinonimi alternativi al nome dell'entità radice.
caseSensitive	boolean	Il valore predefinito è falso. Valore booleano che indica se i confronti con il nome dell'entità devono essere sensibili all'uso di maiuscole e minuscole. Esempi di corrispondenze insensitive a case insensitive di "Microsoft" potrebbero essere: Microsoft, microSoft, MICROSOFT.
defaultAccentSensitive	boolean	Modifica il valore predefinito di sensibilità non accentata per questa entità. Deve essere utilizzato per modificare il valore predefinito di tutti gli alias accentSensitive values.
defaultCaseSensitive	boolean	Modifica il valore predefinito di distinzione tra maiuscole e minuscole per questa entità. Deve essere utilizzato per modificare il valore predefinito di tutti gli alias valori caseSensitive.
defaultFuzzyEditDistance	integer (int32)	Modifica il valore predefinito della distanza di modifica fuzzy per questa entità. Può essere utilizzato per modificare il valore predefinito di tutti i valori fuzzyEditDistance degli alias.
description	string	Questo campo può essere utilizzato come passthrough per i metadati personalizzati relativi ai testi corrispondenti. Il valore di questo campo verrà visualizzato con ogni corrispondenza della relativa entità nell'output della competenza.
fuzzyEditDistance	integer (int32)	Il valore predefinito è 0. Valore massimo di 5. Indica il numero accettabile di caratteri divergenti che costituirebbero comunque una corrispondenza con il nome dell'entità. Viene restituita la minima sfocatura possibile per una determinata corrispondenza. Ad esempio, se la distanza di modifica è impostata a 3, "Windows10" corrisponderebbe comunque a "Windows", "Windows10" e "Windows 7". Quando la distinzione tra maiuscole e minuscole è impostata su false, le differenze tra maiuscole e minuscole NON contano ai fini della tolleranza alla sfocatura, ma per il resto lo fanno.
id	string	Questo campo può essere utilizzato come passthrough per i metadati personalizzati relativi ai testi corrispondenti. Il valore di questo campo verrà visualizzato con ogni corrispondenza della relativa entità nell'output della competenza.
name	string	Descrittore di entità di primo livello. Le corrispondenze nell'output dell'abilità verranno raggruppate in base a questo nome e dovrebbero rappresentare la forma "normalizzata" del testo trovato.
subtype	string	Questo campo può essere utilizzato come passthrough per i metadati personalizzati relativi ai testi corrispondenti. Il valore di questo campo verrà visualizzato con ogni corrispondenza della relativa entità nell'output della competenza.
type	string	Questo campo può essere utilizzato come passthrough per i metadati personalizzati relativi ai testi corrispondenti. Il valore di questo campo verrà visualizzato con ogni corrispondenza della relativa entità nell'output della competenza.

CustomEntityAlias

Oggetto

Oggetto complesso che può essere usato per specificare ortografia o sinonimi alternativi per il nome dell'entità radice.

Nome	Tipo	Descrizione
accentSensitive	boolean	Determinare se l'alias fa distinzione tra caratteri accentati e non accentati.
caseSensitive	boolean	Determinare se l'alias fa distinzione tra maiuscole e minuscole.
fuzzyEditDistance	integer (int32)	Determina la distanza di modifica fuzzy dell'alias.
text	string	Il testo dell'alias.

CustomEntityLookupSkill

Oggetto

Una competenza cerca testo da un elenco personalizzato definito dall'utente di parole e frasi.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Text.CustomEntityLookupSkill	Il discriminare per i tipi derivati.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
defaultLanguageCode	CustomEntityLookupSkillLanguage	Valore che indica il codice della lingua da utilizzare. Il valore predefinito è `en`.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
entitiesDefinitionUri	string	Percorso di un file JSON o CSV contenente tutto il testo di destinazione rispetto a cui trovare la corrispondenza. Questa definizione di entità viene letta all'inizio di un'esecuzione dell'indicizzatore. Eventuali aggiornamenti a questo file durante un'esecuzione dell'indicizzatore non avranno effetto fino alle esecuzioni successive. Questa configurazione deve essere accessibile tramite HTTPS.
globalDefaultAccentSensitive	boolean	Flag globale per AccentSensitive. Se AccentSensitive non è impostato in CustomEntity, questo valore sarà il valore predefinito.
globalDefaultCaseSensitive	boolean	Flag globale per CaseSensitive. Se CaseSensitive non è impostato in CustomEntity, questo valore sarà il valore predefinito.
globalDefaultFuzzyEditDistance	integer (int32)	Flag globale per FuzzyEditDistance. Se FuzzyEditDistance non è impostato in CustomEntity, questo valore sarà il valore predefinito.
inlineEntitiesDefinition	CustomEntity[]	Definizione di CustomEntity inline.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.

CustomEntityLookupSkillLanguage

Enumerazione

I codici lingua supportati per il testo di input da CustomEntityLookupSkill.

Valore	Descrizione
da	Danese
de	Tedesco
en	English
es	Spagnolo
fi	Finlandese
fr	Francese
it	Italiano
ko	Coreano
pt	Portuguese

DefaultCognitiveServicesAccount

Oggetto

Un oggetto vuoto che rappresenta la risorsa predefinita del servizio Azure AI per un set di abilità.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Azure.Search.DefaultCognitiveServices	Il discriminare per i tipi derivati.
description	string	Descrizione della risorsa di servizio Azure AI allegata a un set di competenze.

DocumentExtractionSkill

Oggetto

Competenza che estrae il contenuto da un file all'interno della pipeline di arricchimento.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Util.DocumentExtractionSkill	Il discriminare per i tipi derivati.
configuration		Dizionario delle configurazioni per la competenza.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
dataToExtract	string	Tipo di dati da estrarre per la competenza. Se non definito, verrà impostato su 'contentAndMetadata'.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.
parsingMode	string	ParsingMode per la competenza. Se non definito, verrà impostato su 'default'.

DocumentIntelligenceLayoutSkill

Oggetto

Una competenza che estrae informazioni su contenuti e layout, tramite Azure AI Services, dai file all'interno della pipeline di arricchimento.

Nome	Tipo	Valore predefinito	Descrizione
@odata.type	string: #Microsoft.Skills.Util.DocumentIntelligenceLayoutSkill		Il discriminare per i tipi derivati.
chunkingProperties	DocumentIntelligenceLayoutSkillChunkingProperties		Controlla la cardinalità per la suddivisione in blocchi del contenuto.
context	string		Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
description	string		Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
extractionOptions	DocumentIntelligenceLayoutSkillExtractionOptions[]		Controlla la cardinalità del contenuto estratto dal documento dalla competenza.
inputs	InputFieldMappingEntry[]		Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
markdownHeaderDepth	enum: h1 h2 h3 h4 h5 h6	h6	Profondità delle intestazioni nell'output markdown. Il valore predefinito è h6.
name	string		Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputFormat	enum: markdown text	markdown	Controlla il formato di output. Il valore predefinito è 'markdown'.
outputMode	enum: oneToMany	oneToMany	Controlla la cardinalità dell'output prodotto dalla competenza. Il valore predefinito è "oneToMany".
outputs	OutputFieldMappingEntry[]		L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.

DocumentIntelligenceLayoutSkillChunkingProperties

Oggetto

Controlla la cardinalità per la suddivisione in blocchi del contenuto.

Nome	Tipo	Valore predefinito	Descrizione
maximumLength	integer (int32)		Lunghezza massima del blocco in caratteri. Il valore predefinito è 500.
overlapLength	integer (int32)		La lunghezza della sovrapposizione fornita tra due blocchi di testo. Il valore predefinito è 0.
unit	enum: characters	characters	Unità del blocco.

DocumentIntelligenceLayoutSkillExtractionOptions

Enumerazione

Controlla la cardinalità del contenuto estratto dal documento dalla competenza.

Valore	Descrizione
images	Specificare che il contenuto dell'immagine deve essere estratto dal documento.
locationMetadata	Specificare che i metadati della posizione devono essere estratti dal documento.

EntityCategory

Enumerazione

Stringa che indica le categorie di entità da restituire.

Valore	Descrizione
location	Entità che descrivono una posizione fisica.
organization	Entità che descrivono un'organizzazione.
person	Entità che descrivono una persona.
quantity	Entità che descrivono una quantità.
datetime	Entità che descrivono una data e un'ora.
url	Entità che descrivono un URL.
email	Entità che descrivono un indirizzo di posta elettronica.

EntityLinkingSkill

Oggetto

Utilizzando l'API Analisi del testo, estrae entità collegate dal testo.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Text.V3.EntityLinkingSkill	Il discriminare per i tipi derivati.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
defaultLanguageCode	string	Valore che indica il codice della lingua da utilizzare. Il valore predefinito è `en`.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
minimumPrecision	number (double) minimum: 0 maximum: 1	Valore compreso tra 0 e 1 utilizzato per includere solo entità il cui punteggio di attendibilità è maggiore del valore specificato. Se non è impostato (impostazione predefinita) o se è impostato in modo esplicito su Null, verranno incluse tutte le entità.
modelVersion	string	La versione del modello da utilizzare quando si chiama il servizio Analisi del testo. L'impostazione predefinita sarà la versione più recente disponibile se non specificata. È consigliabile non specificare questo valore a meno che non sia assolutamente necessario.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.

EntityRecognitionSkillLanguage

Enumerazione

I codici della lingua supportati per il testo di input da EntityRecognitionSkill.

Valore	Descrizione
ar	Arabo
cs	Ceco
zh-Hans	Cinese (semplificato)
zh-Hant	Cinese tradizionale
da	Danese
nl	Olandese
en	English
fi	Finlandese
fr	Francese
de	Tedesco
el	Greco
hu	Ungherese
it	Italiano
ja	Giapponese
ko	Coreano
no	Norvegese (Bokmaal)
pl	Polacco
pt-PT	Portoghese (Portogallo)
pt-BR	Portoghese (Brasile)
ru	Russo
es	Spagnolo
sv	Svedese
tr	Turco

EntityRecognitionSkillV3

Oggetto

Utilizzando l'API Analisi del testo, estrae entità di diversi tipi dal testo.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Text.V3.EntityRecognitionSkill	Il discriminare per i tipi derivati.
categories	EntityCategory[]	Elenco di categorie di entità da estrarre.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
defaultLanguageCode	EntityRecognitionSkillLanguage	Valore che indica il codice della lingua da utilizzare. Il valore predefinito è `en`.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
minimumPrecision	number (double) minimum: 0 maximum: 1	Valore compreso tra 0 e 1 utilizzato per includere solo entità il cui punteggio di attendibilità è maggiore del valore specificato. Se non è impostato (impostazione predefinita) o se è impostato in modo esplicito su Null, verranno incluse tutte le entità.
modelVersion	string	La versione del modello da utilizzare quando si chiama l'API Analisi del testo. L'impostazione predefinita sarà la versione più recente disponibile se non specificata. È consigliabile non specificare questo valore a meno che non sia assolutamente necessario.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info		Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta comune all'errore per tutte le API di Azure Resource Manager per restituire dettagli di errore per operazioni fallite. Questo segue anche il formato di risposta di errore OData.

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ImageAnalysisSkill

Oggetto

Competenza che analizza i file di immagine. Estrae un set completo di funzionalità visive in base al contenuto dell'immagine.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Vision.ImageAnalysisSkill	Il discriminare per i tipi derivati.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
defaultLanguageCode	ImageAnalysisSkillLanguage	Valore che indica il codice della lingua da utilizzare. Il valore predefinito è `en`.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
details	ImageDetail[]	Stringa che indica i dettagli specifici del dominio da restituire.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.
visualFeatures	VisualFeature[]	Elenco di funzionalità visive.

ImageAnalysisSkillLanguage

Enumerazione

Codici della lingua supportati per l'input da ImageAnalysisSkill.

Valore	Descrizione
ar	Arabo
az	Azerbaigiano
bg	Bulgaro
bs	Bosniaco (alfabeto latino)
ca	Catalano
cs	Ceco
cy	Welsh
da	Danese
de	Tedesco
el	Greco
en	English
es	Spagnolo
et	Estone
eu	Basco
fi	Finlandese
fr	Francese
ga	Irish
gl	Galiziano
he	Ebraico
hi	hindi
hr	Croato
hu	Ungherese
id	Indonesian
it	Italiano
ja	Giapponese
kk	Kazakh
ko	Coreano
lt	Lituano
lv	Lettone
mk	Macedone
ms	Malese (Malaysia)
nb	Norvegese (Bokmål)
nl	Olandese
pl	Polacco
prs	Dari
pt-BR	Portoghese - Brasile
pt	Portoghese (Portogallo)
pt-PT	Portoghese (Portogallo)
ro	Rumeno
ru	Russo
sk	Slovacco
sl	Sloveno
sr-Cyrl	Serbo (alfabeto cirillico RS)
sr-Latn	Serbo (alfabeto latino RS)
sv	Svedese
th	Tailandese
tr	Turco
uk	Ucraino
vi	Vietnamita
zh	Cinese semplificato
zh-Hans	Cinese semplificato
zh-Hant	Cinese tradizionale

ImageDetail

Enumerazione

Stringa che indica i dettagli specifici del dominio da restituire.

Valore	Descrizione
celebrities	Dettagli riconosciuti come celebrità.
landmarks	Dettagli riconosciuti come punti di riferimento.

IndexProjectionMode

Enumerazione

Definisce il comportamento delle proiezioni dell'indice in relazione al resto dell'indicizzatore.

Valore	Descrizione
skipIndexingParentDocuments	Il documento di origine verrà ignorato dalla scrittura nell'indice di destinazione dell'indicizzatore.
includeIndexingParentDocuments	Il documento di origine verrà scritto nell'indice di destinazione dell'indicizzatore. Questo è il modello predefinito.

InputFieldMappingEntry

Oggetto

Mapping dei campi di input per una competenza.

Nome	Tipo	Descrizione
inputs	InputFieldMappingEntry[]	Input ricorsivi utilizzati durante la creazione di un tipo complesso.
name	string	Nome dell'input.
source	string	Origine dell'input.
sourceContext	string	Contesto di origine utilizzato per la selezione degli input ricorsivi.

KeyPhraseExtractionSkill

Oggetto

Competenza che usa l'analisi del testo per l'estrazione di frasi chiave.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Text.KeyPhraseExtractionSkill	Il discriminare per i tipi derivati.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
defaultLanguageCode	KeyPhraseExtractionSkillLanguage	Valore che indica il codice della lingua da utilizzare. Il valore predefinito è `en`.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
maxKeyPhraseCount	integer (int32)	Numero che indica il numero di frasi chiave da restituire. Se assente, verranno restituite tutte le frasi chiave identificate.
modelVersion	string	La versione del modello da utilizzare quando si chiama il servizio Analisi del testo. L'impostazione predefinita sarà la versione più recente disponibile se non specificata. È consigliabile non specificare questo valore a meno che non sia assolutamente necessario.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.

KeyPhraseExtractionSkillLanguage

Enumerazione

I codici della lingua supportati per il testo di input da KeyPhraseExtractionSkill.

Valore	Descrizione
da	Danese
nl	Olandese
en	English
fi	Finlandese
fr	Francese
de	Tedesco
it	Italiano
ja	Giapponese
ko	Coreano
no	Norvegese (Bokmaal)
pl	Polacco
pt-PT	Portoghese (Portogallo)
pt-BR	Portoghese (Brasile)
ru	Russo
es	Spagnolo
sv	Svedese

LanguageDetectionSkill

Oggetto

Competenza che rileva la lingua del testo di input e segnala un singolo codice linguistico per ogni documento inviato nella richiesta. Il codice della lingua è associato a un punteggio che indica l'attendibilità dell'analisi.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Text.LanguageDetectionSkill	Il discriminare per i tipi derivati.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
defaultCountryHint	string	Codice paese da usare come suggerimento per il modello di rilevamento della lingua se non può disambiguare la lingua.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
modelVersion	string	La versione del modello da utilizzare quando si chiama il servizio Analisi del testo. L'impostazione predefinita sarà la versione più recente disponibile se non specificata. È consigliabile non specificare questo valore a meno che non sia assolutamente necessario.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.

MergeSkill

Oggetto

Competenza per unire due o più stringhe in una singola stringa unificata, con un delimitatore facoltativo definito dall'utente che separa ogni parte del componente.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Text.MergeSkill	Il discriminare per i tipi derivati.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
insertPostTag	string	Il tag indica la fine del testo unito. Per impostazione predefinita, il tag è uno spazio vuoto.
insertPreTag	string	Il tag indica l'inizio del testo unito. Per impostazione predefinita, il tag è uno spazio vuoto.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.

OcrLineEnding

Enumerazione

Definisce la sequenza di caratteri da utilizzare tra le righe di testo riconosciute dalla competenza OCR. Il valore predefinito è "spazio".

Valore	Descrizione
space	Le righe sono separate da un singolo carattere spazio.
carriageReturn	Le righe sono separate da un carattere di ritorno a capo ('\r').
lineFeed	Le righe sono separate da un singolo carattere di avanzamento riga ('\n').
carriageReturnLineFeed	Le righe sono separate da un ritorno a capo e da un carattere di avanzamento riga ('\r\n').

OcrSkill

Oggetto

Competenza che estrae testo dai file di immagine.

Nome	Tipo	Valore predefinito	Descrizione
@odata.type	string: #Microsoft.Skills.Vision.OcrSkill		Il discriminare per i tipi derivati.
context	string		Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
defaultLanguageCode	OcrSkillLanguage		Valore che indica il codice della lingua da utilizzare. Il valore predefinito è `en`.
description	string		Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
detectOrientation	boolean	False	Valore che indica di attivare o meno il rilevamento dell'orientamento. Il valore predefinito è false.
inputs	InputFieldMappingEntry[]		Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
lineEnding	OcrLineEnding		Definisce la sequenza di caratteri da utilizzare tra le righe di testo riconosciute dalla competenza OCR. Il valore predefinito è "spazio".
name	string		Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]		L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.

OcrSkillLanguage

Enumerazione

I codici lingua supportati per l'input da OcrSkill.

Valore	Descrizione
af	Afrikaans
sq	Albanian
anp	Angika (Devanagari)
ar	Arabo
ast	Asturiano
awa	Awadhi-Hindi (Devanagari)
az	Azerbaigiano (alfabeto latino)
bfy	Bagheli
eu	Basco
be	Bielorusso (cirillico e latino)
be-cyrl	Bielorusso (alfabeto cirillico)
be-latn	Bielorusso (alfabeto latino)
bho	Bhojpuri-Hindi (Devanagari)
bi	Bislama
brx	Bodo (Devanagari)
bs	Bosniaco (alfabeto latino)
bra	Brajbha
br	Bretone
bg	Bulgaro
bns	Bundeli
bua	Buriato (alfabeto cirillico)
ca	Catalano
ceb	cebuano
rab	Chamling
ch	Chamorro
hne	Chhattisgarhi (Devanagari)
zh-Hans	Cinese semplificato
zh-Hant	Cinese tradizionale
kw	Cornico
co	Corso
crh	Tataro di Crimea (alfabeto latino)
hr	Croato
cs	Ceco
da	Danese
prs	Dari
dhi	Dhimal (Devanagari)
doi	Dogri (Devanagari)
nl	Olandese
en	English
myv	Erzya (alfabeto cirillico)
et	Estone
fo	Faeroese
fj	Figiano
fil	Filipino
fi	Finlandese
fr	Francese
fur	Fruliano
gag	Gagauz (alfabeto latino)
gl	Galiziano
de	Tedesco
gil	Gilbertese
gon	Gondi (Devanagari)
el	Greco
kl	Groenlandese
gvr	Gurung (Devanagari)
ht	Creolo haitiano
hlb	Halbi (Devanasana)
hni	Hani
bgc	Haryanvi
haw	Hawaiano
hi	hindi
mww	Hmong Daw (alfabeto latino)
hoc	Ho (Devanagiri)
hu	Ungherese
is	Icelandic
smn	Inari Sami
id	Indonesian
ia	Interlingua
iu	Inuktitut (alfabeto latino)
ga	Irish
it	Italiano
ja	Giapponese
Jns	Jaunsari (Devanagari)
jv	Giavanese
kea	Kabuverdiano
kac	Kachin (alfabeto latino)
xnr	Kangri (Devana montana)
krc	Karachay-Balkar
kaa-cyrl	Kara-Kalpak (alfabeto cirillico)
kaa	Kara-Kalpak (alfabeto latino)
csb	Kashubian
kk-cyrl	Kazaco (alfabeto cirillico)
kk-latn	Kazaco (alfabeto latino)
klr	Khaling
kha	Khasi
quc	K'iche'
ko	Coreano
kfq	paura
kpy	Koryak
kos	Kosrae
kum	Cumucco (alfabeto cirillico)
ku-arab	Curdo (paesi arabi)
ku-latn	Curdo (Latino)
kru	Kurukh (Devanagari)
ky	Kirghiso (alfabeto cirillico)
lkt	Lakota
la	Latino
lt	Lituano
dsb	Basso sorabo
smj	Lule Sami
lb	Luxembourgish
bfz	Mahasu Pahari (Devanagari)
ms	Malese (alfabeto latino)
mt	Maltese
kmj	Malto (Devanagari)
gv	Mannese
mi	Maori
mr	Marathi
mn	Mongolo (alfabeto cirillico)
cnr-cyrl	Montenegrino (alfabeto cirillico)
cnr-latn	Montenegrino (alfabeto latino)
nap	Napoletano
ne	Nepalese
niu	niueano
nog	Nogay
sme	Sami settentrionale (alfabeto latino)
nb	Norvegese
no	Norvegese
oc	Occitano
os	Ossetico
ps	Pashto
fa	Persian
pl	Polacco
pt	Portuguese
pa	Punjabi (alfabeto arabo)
ksh	Ripuario
ro	Rumeno
rm	Romancio
ru	Russo
sck	Sadri (Devana institute)
sm	Samoano (alfabeto latino)
sa	Sanscrito (Devanagiri)
sat	Santali (Devanagiri)
sco	Scozzese
gd	Scozzese Gaelico
sr	Serbo in caratteri latini
sr-Cyrl	Serbo (alfabeto cirillico)
sr-Latn	Serbo in caratteri latini
xsr	Sherpa (Devanagari)
srx	Sirmauri (Devanagari)
sms	Skolt Sami
sk	Slovacco
sl	Sloveno
so	Somalo (alfabeto arabo)
sma	Sami meridionale
es	Spagnolo
sw	Swahili (alfabeto latino)
sv	Svedese
tg	Tagico (alfabeto cirillico)
tt	Tataro (alfabeto latino)
tet	Tetum
thf	Thangmi
to	Tongano
tr	Turco
tk	Turcomanno (alfabeto latino)
tyv	Tuvan
hsb	Alto sorabo
ur	Urdu
ug	Uiguro (alfabeto arabo)
uz-arab	Uzbeko (alfabeto arabo)
uz-cyrl	Uzbeco (alfabeto cirillico)
uz	Uzbeco (alfabeto latino)
vo	Volapük
wae	Walser
cy	Welsh
fy	Frisone occidentale
yua	Yucatechi Maya
za	Zhuang
zu	Zulù
unk	Sconosciuto (tutti)

OutputFieldMappingEntry

Oggetto

Mapping dei campi di output per una competenza.

Nome	Tipo	Descrizione
name	string	Nome dell'output definito dalla competenza.
targetName	string	Nome di destinazione dell'output. È facoltativo e predefinito per il nome.

PIIDetectionSkill

Oggetto

Utilizzando l'API Analisi del testo, estrai informazioni personali da un testo di input e ti dà la possibilità di mascherarle.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Text.PIIDetectionSkill	Il discriminare per i tipi derivati.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
defaultLanguageCode	string	Valore che indica il codice della lingua da utilizzare. Il valore predefinito è `en`.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
domain	string	Se specificato, imposta il dominio delle informazioni personali in modo da includere solo un subset delle categorie di entità. I valori possibili includono: 'phi', 'none'. Il valore predefinito è 'none'.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
maskingCharacter	string maxLength: 1	Carattere utilizzato per mascherare il testo se il parametro maskingMode è impostato per sostituire. Il valore predefinito è '*'.
maskingMode	PIIDetectionSkillMaskingMode	Parametro che fornisce vari modi per mascherare le informazioni personali rilevate nel testo di input. Il valore predefinito è 'none'.
minimumPrecision	number (double) minimum: 0 maximum: 1	Valore compreso tra 0 e 1 utilizzato per includere solo entità il cui punteggio di attendibilità è maggiore del valore specificato. Se non è impostato (impostazione predefinita) o se è impostato in modo esplicito su Null, verranno incluse tutte le entità.
modelVersion	string	La versione del modello da utilizzare quando si chiama il servizio Analisi del testo. L'impostazione predefinita sarà la versione più recente disponibile se non specificata. È consigliabile non specificare questo valore a meno che non sia assolutamente necessario.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.
piiCategories	string[]	Elenco di categorie di entità PII che devono essere estratte e mascherate.

PIIDetectionSkillMaskingMode

Enumerazione

Stringa che indica il metodo maskingMode da utilizzare per mascherare le informazioni personali rilevate nel testo di input.

Valore	Descrizione
none	Non si verifica alcun mascheramento e l'output maskedText non verrà restituito.
replace	Sostituisce le entità rilevate con il carattere specificato nel parametro maskingCharacter. Il carattere verrà ripetuto fino alla lunghezza dell'entità rilevata in modo che gli offset corrispondano correttamente sia al testo di input che all'output maskedText.

Prefer

Enumerazione

Per le richieste HTTP PUT, indica al servizio di restituire la risorsa creata/aggiornata in caso di esito positivo.

Valore	Descrizione
return=representation

SearchIndexerDataNoneIdentity

Oggetto

Cancella la proprietà Identity di un'origine dati.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Azure.Search.DataNoneIdentity	Frammento di URI che specifica il tipo di identità.

SearchIndexerDataUserAssignedIdentity

Oggetto

Specifica l'identità di un'origine dati da usare.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Azure.Search.DataUserAssignedIdentity	Frammento di URI che specifica il tipo di identità.
userAssignedIdentity	string	L'ID della risorsa Azure completamente qualificato di un'identità gestita assegnata dall'utente, tipicamente nella forma "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft. Managed Identity/userAssignedIdentities/myId" che avrebbe dovuto essere assegnato al servizio di ricerca.

SearchIndexerIndexProjection

Oggetto

Definizione di proiezioni aggiuntive agli indici di ricerca secondari.

Nome	Tipo	Descrizione
parameters	SearchIndexerIndexProjectionsParameters	Dizionario delle proprietà di configurazione specifiche della proiezione dell'indice. Ogni nome è il nome di una proprietà specifica. Ogni valore deve essere di un tipo primitivo.
selectors	SearchIndexerIndexProjectionSelector[]	Elenco delle proiezioni da eseguire negli indici di ricerca secondari.

SearchIndexerIndexProjectionSelector

Oggetto

Descrizione dei dati da archiviare nell'indice di ricerca designato.

Nome	Tipo	Descrizione
mappings	InputFieldMappingEntry[]	Mapping per la proiezione o quale origine deve essere mappata a quale campo nell'indice di destinazione.
parentKeyFieldName	string	Nome del campo nell'indice di ricerca a cui mappare il valore della chiave del documento principale. Deve essere un campo stringa filtrabile e non il campo chiave.
sourceContext	string	Contesto di origine per le proiezioni. Rappresenta la cardinalità in base alla quale il documento verrà suddiviso in più sottodocumenti.
targetIndexName	string	Nome dell'indice di ricerca in cui proiettare. Deve avere un campo chiave con l'analizzatore 'keyword' impostato.

SearchIndexerIndexProjectionsParameters

Oggetto

Dizionario delle proprietà di configurazione specifiche della proiezione dell'indice. Ogni nome è il nome di una proprietà specifica. Ogni valore deve essere di un tipo primitivo.

Nome	Tipo	Descrizione
projectionMode	IndexProjectionMode	Definisce il comportamento delle proiezioni dell'indice in relazione al resto dell'indicizzatore.

SearchIndexerKnowledgeStore

Oggetto

Definizione di proiezioni aggiuntive per BLOB, tabelle o file di azure di dati arricchiti.

Nome	Tipo	Descrizione
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	L'identità gestita assegnata dall'utente utilizzata per le connessioni ad Archiviazione di Azure durante la scrittura di proiezioni del knowledge store. Se la stringa di connessione indica un'identità (ResourceId) e non viene specificata, viene utilizzata l'identità gestita assegnata dal sistema. Negli aggiornamenti all'indicizzatore, se l'identità non è specificata, il valore rimane invariato. Se impostato su "none", il valore di questa proprietà viene cancellato.
parameters	SearchIndexerKnowledgeStoreParameters	Dizionario delle proprietà di configurazione specifiche dell'archivio conoscenze. Ogni nome è il nome di una proprietà specifica. Ogni valore deve essere di un tipo primitivo.
projections	SearchIndexerKnowledgeStoreProjection[]	Elenco di proiezioni aggiuntive da eseguire durante l'indicizzazione.
storageConnectionString	string	La stringa di connessione alle proiezioni del conto di memoria sarà memorizzata.

SearchIndexerKnowledgeStoreFileProjectionSelector

Oggetto

Definizione di proiezione per quali dati memorizzare in File di Azure.

Nome	Tipo	Descrizione
generatedKeyName	string	Nome della chiave generata per memorizzare la proiezione sotto.
inputs	InputFieldMappingEntry[]	Input nidificati per proiezioni complesse.
referenceKeyName	string	Nome della chiave di riferimento per una proiezione diversa.
source	string	Dati di origine per il progetto.
sourceContext	string	Contesto di origine per proiezioni complesse.
storageContainer	string	Contenitore BLOB in cui archiviare le proiezioni.

SearchIndexerKnowledgeStoreObjectProjectionSelector

Oggetto

Definizione di proiezione per quali dati memorizzare in Azure Blob.

Nome	Tipo	Descrizione
generatedKeyName	string	Nome della chiave generata per memorizzare la proiezione sotto.
inputs	InputFieldMappingEntry[]	Input nidificati per proiezioni complesse.
referenceKeyName	string	Nome della chiave di riferimento per una proiezione diversa.
source	string	Dati di origine per il progetto.
sourceContext	string	Contesto di origine per proiezioni complesse.
storageContainer	string	Contenitore BLOB in cui archiviare le proiezioni.

SearchIndexerKnowledgeStoreParameters

Oggetto

Dizionario delle proprietà di configurazione specifiche dell'archivio conoscenze. Ogni nome è il nome di una proprietà specifica. Ogni valore deve essere di un tipo primitivo.

Nome	Tipo	Valore predefinito	Descrizione
synthesizeGeneratedKeyName	boolean	False	Se le proiezioni devono sintetizzare o meno un nome di chiave generato se non è già presente.

SearchIndexerKnowledgeStoreProjection

Oggetto

Oggetto contenitore per vari selettori di proiezione.

Nome	Tipo	Descrizione
files	SearchIndexerKnowledgeStoreFileProjectionSelector[]	Proiezioni su archiviazione file Azure.
objects	SearchIndexerKnowledgeStoreObjectProjectionSelector[]	Proiezioni su Azure Blob storage.
tables	SearchIndexerKnowledgeStoreTableProjectionSelector[]	Proiezioni su archiviazione Azure Table.

SearchIndexerKnowledgeStoreTableProjectionSelector

Oggetto

Descrizione di quali dati memorizzare in Azure Tables.

Nome	Tipo	Descrizione
generatedKeyName	string	Nome della chiave generata per memorizzare la proiezione sotto.
inputs	InputFieldMappingEntry[]	Input nidificati per proiezioni complesse.
referenceKeyName	string	Nome della chiave di riferimento per una proiezione diversa.
source	string	Dati di origine per il progetto.
sourceContext	string	Contesto di origine per proiezioni complesse.
tableName	string	Nome della tabella Azure in cui memorizzare i dati proiettati.

SearchIndexerSkillset

Oggetto

Elenco di competenze.

Nome	Tipo	Descrizione
@odata.etag	string	ETag del set di competenze.
cognitiveServices	CognitiveServicesAccount: AIServicesAccountIdentity AIServicesAccountKey CognitiveServicesAccountKey DefaultCognitiveServicesAccount	Dettagli sul servizio Azure AI da utilizzare durante l'esecuzione delle competenze.
description	string	Descrizione del set di competenze.
encryptionKey	SearchResourceEncryptionKey	Una descrizione di una chiave di crittografia che crei in Azure Key Vault. Questa chiave viene utilizzata per fornire un livello aggiuntivo di crittografia a riposo per la definizione del tuo set di competenze quando vuoi la piena garanzia che nessuno, nemmeno Microsoft, possa decifrare la definizione del tuo set di competenze. Dopo aver crittografato la definizione del set di competenze, rimarrà sempre crittografata. Il servizio di ricerca ignorerà i tentativi di impostare questa proprietà su null. È possibile modificare questa proprietà in base alle esigenze se si vuole ruotare la chiave di crittografia; La definizione del set di competenze non sarà influenzata. La crittografia con chiavi gestite dal cliente non è disponibile per i servizi di ricerca gratuiti ed è disponibile solo per i servizi a pagamento creati il 1° gennaio 2019.
indexProjections	SearchIndexerIndexProjection	Definizione di proiezioni aggiuntive in indici di ricerca secondari.
knowledgeStore	SearchIndexerKnowledgeStore	Definizione di proiezioni aggiuntive su blob, tabella o file Azure, di dati arricchiti.
name	string	Nome del set di competenze.
skills	SearchIndexerSkill[]: AzureMachineLearningSkill[] AzureOpenAIEmbeddingSkill[] ChatCompletionSkill[] ConditionalSkill[] ContentUnderstandingSkill[] CustomEntityLookupSkill[] DocumentExtractionSkill[] DocumentIntelligenceLayoutSkill[] EntityLinkingSkill[] EntityRecognitionSkillV3[] ImageAnalysisSkill[] KeyPhraseExtractionSkill[] LanguageDetectionSkill[] MergeSkill[] OcrSkill[] PIIDetectionSkill[] SentimentSkillV3[] ShaperSkill[] SplitSkill[] TextTranslationSkill[] VisionVectorizeSkill[] WebApiSkill[]	Elenco di competenze nel set di competenze.

SearchResourceEncryptionKey

Oggetto

Una chiave di crittografia gestita dal cliente in Azure Key Vault. Le chiavi create e gestite dall'utente possono essere utilizzate per crittografare o decrittografare i dati inattivi, ad esempio indici e mappe di sinonimi.

Nome	Tipo	Descrizione
accessCredentials.applicationId	string	Un ID di applicazione AAD che ha ricevuto i permessi di accesso necessari a Azure Key Vault, da utilizzare durante la crittografia dei dati a riposo. L'ID applicazione non deve essere confuso con l'ID oggetto per l'applicazione AAD.
accessCredentials.applicationSecret	string	Chiave di autenticazione dell'applicazione AAD specificata.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Identità gestita esplicita da usare per questa chiave di crittografia. Se non specificato e la proprietà delle credenziali di accesso è Null, viene usata l'identità gestita assegnata dal sistema. Se l'identità esplicita non viene specificata, l'aggiornamento alla risorsa rimane invariato. Se si specifica "none", il valore di questa proprietà viene cancellato.
keyVaultKeyName	string	Il nome della tua chiave Azure Key Vault da usare per criptare i tuoi dati a riposo.
keyVaultKeyVersion	string	La versione della tua chiave Azure Key Vault da usare per criptare i tuoi dati a riposo.
keyVaultUri	string	L'URI del tuo Azure Key Vault, noto anche come nome DNS, contiene la chiave da utilizzare per criptare i tuoi dati a riposo. Un URI di esempio potrebbe essere `https://my-keyvault-name.vault.azure.net`.

SentimentSkillLanguage

Enumerazione

I codici lingua supportati per il testo di input da SentimentSkill.

Valore	Descrizione
da	Danese
nl	Olandese
en	English
fi	Finlandese
fr	Francese
de	Tedesco
el	Greco
it	Italiano
no	Norvegese (Bokmaal)
pl	Polacco
pt-PT	Portoghese (Portogallo)
ru	Russo
es	Spagnolo
sv	Svedese
tr	Turco

SentimentSkillV3

Oggetto

Utilizzando l'API Analisi del testo, valuta il testo non strutturato e per ogni record fornisce etichette di sentiment (come "negativo", "neutrale" e "positivo") basate sul punteggio di confidenza più alto trovato dal servizio a livello di frase e documento.

Nome	Tipo	Valore predefinito	Descrizione
@odata.type	string: #Microsoft.Skills.Text.V3.SentimentSkill		Il discriminare per i tipi derivati.
context	string		Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
defaultLanguageCode	SentimentSkillLanguage		Valore che indica il codice della lingua da utilizzare. Il valore predefinito è `en`.
description	string		Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
includeOpinionMining	boolean	False	Se impostata su vera, l'output delle competenze includerà informazioni da Analisi del testo per l'opinion mining, ovvero obiettivi (sostantivi o verbi) e la loro valutazione associata (aggettivo) nel testo. Il valore predefinito è false.
inputs	InputFieldMappingEntry[]		Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
modelVersion	string		La versione del modello da utilizzare quando si chiama il servizio Analisi del testo. L'impostazione predefinita sarà la versione più recente disponibile se non specificata. È consigliabile non specificare questo valore a meno che non sia assolutamente necessario.
name	string		Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]		L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.

ShaperSkill

Oggetto

Competenza per la ridevisione degli output. Crea un tipo complesso per supportare i campi compositi (noti anche come campi multipart).

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Util.ShaperSkill	Il discriminare per i tipi derivati.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.

SplitSkill

Oggetto

Competenza per suddividere una stringa in blocchi di testo.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Text.SplitSkill	Il discriminare per i tipi derivati.
azureOpenAITokenizerParameters	AzureOpenAITokenizerParameters	Si applica solo se l'unità è impostata su azureOpenAITokens. Se specificato, splitSkill utilizzerà questi parametri durante l'esecuzione della tokenizzazione. I parametri sono un 'encoderModelName' valido e una proprietà facoltativa 'allowedSpecialTokens'.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
defaultLanguageCode	SplitSkillLanguage	Valore che indica il codice della lingua da utilizzare. Il valore predefinito è `en`.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
maximumPageLength	integer (int32)	Lunghezza massima della pagina desiderata. Il valore predefinito è 10000.
maximumPagesToTake	integer (int32)	Applicabile solo quando textSplitMode è impostato su 'pages'. Se specificato, SplitSkill interromperà la suddivisione dopo l'elaborazione delle prime pagine 'maximumPagesToTake', al fine di migliorare le prestazioni quando sono necessarie solo poche pagine iniziali da ciascun documento.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.
pageOverlapLength	integer (int32)	Applicabile solo quando textSplitMode è impostato su 'pages'. Se specificato, n+1° blocco inizierà con questo numero di caratteri/token dalla fine dell'ennesimo blocco.
textSplitMode	TextSplitMode	Valore che indica la modalità di divisione da eseguire.
unit	SplitSkillUnit	Si applica solo se textSplitMode è impostato su pages. Ci sono due valori possibili. La scelta dei valori deciderà la misura della lunghezza (maximumPageLength e pageOverlapLength). Il valore predefinito è "caratteri", il che significa che la lunghezza sarà misurata in base al carattere.

SplitSkillEncoderModelName

Enumerazione

Un valore che indica quale tokenizzatore usare.

Valore	Descrizione
r50k_base	Si riferisce a un modello di base addestrato con un vocabolario di 50.000 token, spesso utilizzato in attività generali di elaborazione del linguaggio naturale.
p50k_base	Un modello base con un vocabolario di 50.000 token, ottimizzato per le attività basate su prompt.
p50k_edit	Simile a p50k_base ma messo a punto per attività di modifica o riformulazione con un vocabolario di 50.000 token.
cl100k_base	Un modello base con un vocabolario di 100.000 token.

SplitSkillLanguage

Enumerazione

I codici lingua supportati per il testo di input da SplitSkill.

Valore	Descrizione
am	Amharic
bs	Bosnian
cs	Ceco
da	Danese
de	Tedesco
en	English
es	Spagnolo
et	Estone
fi	Finlandese
fr	Francese
he	Ebraico
hi	hindi
hr	Croato
hu	Ungherese
id	Indonesian
is	Icelandic
it	Italiano
ja	Giapponese
ko	Coreano
lv	Lettone
nb	Norvegese
nl	Olandese
pl	Polacco
pt	Portoghese (Portogallo)
pt-br	Portoghese (Brasile)
ru	Russo
sk	Slovacco
sl	Sloveno
sr	Serbo
sv	Svedese
tr	Turco
ur	Urdu
zh	Cinese (semplificato)

SplitSkillUnit

Enumerazione

Un valore che indica l'unità da utilizzare.

Valore	Descrizione
characters	La lunghezza sarà misurata in base al carattere.
azureOpenAITokens	La lunghezza verrà misurata da un tokenizer AzureOpenAI dalla libreria tiktoken.

TextSplitMode

Enumerazione

Valore che indica la modalità di divisione da eseguire.

Valore	Descrizione
pages	Dividi il testo in singole pagine.
sentences	Dividi il testo in singole frasi.

TextTranslationSkill

Oggetto

Competenza per tradurre testo da una lingua a un'altra.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Text.TranslationSkill	Il discriminare per i tipi derivati.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
defaultFromLanguageCode	TextTranslationSkillLanguage	Codice linguistico da cui tradurre documenti per documenti che non specificano in modo esplicito la lingua da .
defaultToLanguageCode	TextTranslationSkillLanguage	Codice linguistico in cui tradurre documenti per documenti che non specificano in modo esplicito la lingua.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.
suggestedFrom	TextTranslationSkillLanguage	Il codice linguistico da cui tradurre i documenti quando non vengono forniti né l'input fromLanguageCode né il parametro defaultFromLanguageCode e il rilevamento automatico della lingua non riesce. Il valore predefinito è `en`.

TextTranslationSkillLanguage

Enumerazione

Codici lingua supportati per il testo di input da TextTranslationSkill.

Valore	Descrizione
af	Afrikaans
ar	Arabo
bn	Bengalese
bs	Bosniaco (alfabeto latino)
bg	Bulgaro
yue	Cantonese (tradizionale)
ca	Catalano
zh-Hans	Cinese semplificato
zh-Hant	Cinese tradizionale
hr	Croato
cs	Ceco
da	Danese
nl	Olandese
en	English
et	Estone
fj	Figiano
fil	Filipino
fi	Finlandese
fr	Francese
de	Tedesco
el	Greco
ht	Creolo haitiano
he	Ebraico
hi	hindi
mww	Hmong Daw
hu	Ungherese
is	Icelandic
id	Indonesian
it	Italiano
ja	Giapponese
sw	Kiswahili
tlh	Klingon
tlh-Latn	Klingon (alfabeto latino)
tlh-Piqd	Klingon (scrittura Klingon)
ko	Coreano
lv	Lettone
lt	Lituano
mg	Malgascio
ms	Malese
mt	Maltese
nb	Norvegese
fa	Persian
pl	Polacco
pt	Portuguese
pt-br	Portoghese (Brasile)
pt-PT	Portoghese (Portogallo)
otq	Queretaro Otomi
ro	Rumeno
ru	Russo
sm	Samoano
sr-Cyrl	Serbo (alfabeto cirillico)
sr-Latn	Serbo in caratteri latini
sk	Slovacco
sl	Sloveno
es	Spagnolo
sv	Svedese
ty	Tahitiano
ta	Tamil
te	Telugu
th	Tailandese
to	Tongano
tr	Turco
uk	Ucraino
ur	Urdu
vi	Vietnamita
cy	Welsh
yua	Yucatechi Maya
ga	Irish
kn	Kannada
mi	Maori
ml	Malayalam
pa	Punjabi

VisionVectorizeSkill

Oggetto

Ti permette di generare un embedding vettoriale per un'immagine o un dato input di testo utilizzando l'API Azure AI Services Vision Vectorize.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Vision.VectorizeSkill	Il discriminare per i tipi derivati.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
modelVersion	string	Versione del modello da usare quando si chiama il servizio Visione dei servizi di intelligenza artificiale. L'impostazione predefinita sarà la versione più recente disponibile se non specificata.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.

VisualFeature

Enumerazione

Stringhe che indicano i tipi di funzionalità visive da restituire.

Valore	Descrizione
adult	Caratteristiche visive riconosciute come persone adulte.
brands	Caratteristiche visive riconosciute come marchi commerciali.
categories	Categorie.
description	Description.
faces	Caratteristiche visive riconosciute come volti di persone.
objects	Funzioni visive riconosciute come oggetti.
tags	Tag.

WebApiSkill

Oggetto

Una competenza che può chiamare un endpoint API Web, consentendo di estendere un set di competenze tramite la chiamata al codice personalizzato.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Custom.WebApiSkill	Il discriminare per i tipi derivati.
authIdentity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Identità gestita assegnata dall'utente usata per le connessioni in uscita. Se viene specificato un authResourceId e non viene specificato, viene usata l'identità gestita assegnata dal sistema. Negli aggiornamenti all'indicizzatore, se l'identità non è specificata, il valore rimane invariato. Se impostato su "none", il valore di questa proprietà viene cancellato.
authResourceId	string	Si applica alle abilità personalizzate che si collegano a codice esterno in una funzione Azure o in un'altra applicazione che fornisce le trasformazioni. Questo valore dovrebbe essere l'ID dell'applicazione creato per la funzione o l'app quando è stata registrata su Azure Active Directory. Se specificata, la competenza personalizzata si connette alla funzione o all'app usando un ID gestito (sistema o assegnato dall'utente) del servizio di ricerca e il token di accesso della funzione o dell'app, usando questo valore come ID risorsa per creare l'ambito del token di accesso.
batchSize	integer (int32)	Dimensione batch desiderata che indica il numero di documenti.
context	string	Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento, ad esempio /document o /document/content. Il valore predefinito è /document.
degreeOfParallelism	integer (int32)	Se impostato, numero di chiamate parallele che possono essere effettuate all'API Web.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
httpHeaders	object	Intestazioni necessarie per effettuare la richiesta HTTP.
httpMethod	string	Metodo per la richiesta HTTP.
inputs	InputFieldMappingEntry[]	Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza upstream.
name	string	Nome della competenza che lo identifica in modo univoco all'interno del set di competenze. A una competenza senza nome definito verrà assegnato un nome predefinito del relativo indice basato su 1 nella matrice di competenze, preceduto dal carattere '#'.
outputs	OutputFieldMappingEntry[]	L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza.
timeout	string (duration)	Timeout desiderato per la richiesta. Il valore predefinito è 30 secondi.
uri	string	URL per l'API Web.