Skillsets - Create

Servizio:: Search Service

Versione API:: 2026-04-01

Crea un nuovo set di competenze in un servizio di ricerca.

POST {endpoint}/skillsets?api-version=2026-04-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	URL dell'endpoint del servizio di ricerca.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Accept		Accept	L'intestazione Accetta.
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[]: AzureOpenAIEmbeddingSkill[] ChatCompletionSkill[] ConditionalSkill[] ContentUnderstandingSkill[] CustomEntityLookupSkill[] DocumentExtractionSkill[] DocumentIntelligenceLayoutSkill[] EntityLinkingSkill[] EntityRecognitionSkillV3[] ImageAnalysisSkill[] KeyPhraseExtractionSkill[] LanguageDetectionSkill[] MergeSkill[] OcrSkill[] PIIDetectionSkill[] SentimentSkillV3[] ShaperSkill[] SplitSkill[] TextTranslationSkill[] 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	Descrizione di una chiave di crittografia creata 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
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

SearchServiceCreateSkillset

Esempio di richiesta

HTTP

POST https://stableexampleservice.search.windows.net/skillsets?api-version=2026-04-01


{
  "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,
      "@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"
        }
      ]
    }
  ],
  "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:: 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,
      "inputs": [
        {
          "name": "text",
          "source": "/document/content",
          "inputs": []
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "textItems",
          "targetName": "pages"
        }
      ]
    },
    {
      "@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
      }
    }
  ],
  "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.
AzureOpenAIEmbeddingSkill	Consente di generare un'incorporamento vettoriale per un input di testo specificato usando la risorsa OpenAI di Azure.
AzureOpenAIModelName	Nome del modello Azure Open AI che verrà chiamato.
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	Chiave dell'account in più aree di una risorsa del servizio azure per intelligenza artificiale 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	Oggetto vuoto che rappresenta la risorsa predefinita del servizio di intelligenza artificiale di Azure per un set di competenze.
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	Usando l'API Analisi del testo, estrae le entità collegate dal testo.
EntityRecognitionSkillLanguage	I codici della lingua supportati per il testo di input da EntityRecognitionSkill.
EntityRecognitionSkillV3	Usando l'API Analisi del testo, estrae entità di tipi diversi dal testo.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. 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	Usando l'API Analisi del testo, estrae informazioni personali da un testo di input e offre la possibilità di mascherarla.
PIIDetectionSkillMaskingMode	Stringa che indica il metodo maskingMode da utilizzare per mascherare le informazioni personali rilevate nel testo di input.
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 i dati da archiviare in File di Azure.
SearchIndexerKnowledgeStoreObjectProjectionSelector	Definizione di proiezione per i dati da archiviare nel BLOB di Azure.
SearchIndexerKnowledgeStoreProjection	Oggetto contenitore per vari selettori di proiezione.
SearchIndexerKnowledgeStoreTableProjectionSelector	Descrizione dei dati da archiviare nelle tabelle di Azure.
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	Usando l'API Analisi del testo, valuta il testo non strutturato e per ogni record, fornisce etichette del sentiment (ad esempio "negative", "neutral" e "positive") in base al punteggio di attendibilità 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.
SplitSkillLanguage	I codici lingua supportati per il testo di input da SplitSkill.
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.
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.

AzureOpenAIEmbeddingSkill

Oggetto

Consente di generare un'incorporamento vettoriale per un input di testo specificato usando la risorsa OpenAI di Azure.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill	Il discriminare per i tipi derivati.
apiKey	string	Chiave API della risorsa OpenAI di Azure designata.
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 OpenAI di Azure nella risorsa designata.
description	string	Descrizione della competenza che descrive gli input, gli output e l'utilizzo della competenza.
dimensions	integer (int32)	Il numero di dimensioni che dovrebbero avere gli embedding 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)	URI della risorsa OpenAI di Azure.

AzureOpenAIModelName

Enumerazione

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-5-mini	Modello GPT5Mini.
gpt-5-nano	Modello Gpt5Nano.
gpt-5.4-mini	Modello Gpt54Mini.
gpt-5.4-nano	Modello Gpt54Nano.

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.
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.
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'.
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".
uri	string		URL per l'API Web.

CognitiveServicesAccountKey

Oggetto

Chiave dell'account in più aree di una risorsa del servizio azure per intelligenza artificiale 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 alla combinazione 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 usato per modificare il valore predefinito di tutti gli alias fuzzyEditDistance valori.
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 dell'entità nell'output della competenza.
fuzzyEditDistance	integer (int32)	Il valore predefinito è 0. Valore massimo di 5. Indica il numero accettabile di caratteri divergenti che costituiscono comunque una corrispondenza con il nome dell'entità. Viene restituita la minima confusione possibile per ogni corrispondenza specificata. 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 vengono conteggiate per la tolleranza di fuzzità, ma in caso contrario.
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 dell'entità nell'output della competenza.
name	string	Descrittore di entità di primo livello. Le corrispondenze nell'output della competenza 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 dell'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 dell'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	Portoghese

DefaultCognitiveServicesAccount

Oggetto

Oggetto vuoto che rappresenta la risorsa predefinita del servizio di intelligenza artificiale di Azure per un set di competenze.

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

Usando l'API Analisi del testo, estrae le 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	Versione del modello da usare 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

Usando l'API Analisi del testo, estrae entità di tipi diversi 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	Versione del modello da usare 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 di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. 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	Alfabeto latino bosniaco
ca	Catalano
cs	Ceco
cy	Gallese
da	Danese
de	Tedesco
el	Greco
en	English
es	Spagnolo
et	Estone
eu	Basco
fi	Finlandese
fr	Francese
ga	Irlandese
gl	Galiziano
he	Ebraico
hi	hindi
hr	Croato
hu	Ungherese
id	Indonesian
it	Italiano
ja	Giapponese
kk	Kazako
ko	Coreano
lt	Lituano
lv	Lettone
mk	lingua macedone
ms	Malese Malaysia
nb	Norvegese (Bokmål)
nl	Olandese
pl	Polacco
prs	Dari
pt-BR	Portuguese-Brazil
pt	Portuguese-Portugal
pt-PT	Portuguese-Portugal
ro	Romeno
ru	Russo
sk	Slovacco
sl	Sloveno
sr-Cyrl	Serbo - RS cirillico
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	Versione del modello da usare 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	Versione del modello da usare 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 di spazio.
carriageReturn	Le righe sono separate da un ritorno a capo ('\rcarattere ').
lineFeed	Le righe sono separate da un singolo avanzamento riga ('\n') carattere.
carriageReturnLineFeed	Le righe sono separate da un ritorno a capo e da un avanzamento riga ('\r\n') carattere.

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	Albanese
anp	Angika (Devanagari)
ar	Arabo
ast	Asturiano
awa	Awadhi-Hindi (Devanagari)
az	Azerbaigiano (alfabeto latino)
bfy	Bagheli
eu	Basco
be	Bielorusso (alfabeto cirillico e latino)
be-cyrl	Bielorusso (cirillico)
be-latn	Bielorusso (Latino)
bho	Bhojpuri-Hindi (Devanagari)
bi	Bislama
brx	Bodo (Devanagari)
bs	Alfabeto latino bosniaco
bra	Brajbha
br	Bretone
bg	Bulgaro
bns	Bundeli
bua	Buryat (cirillico)
ca	Catalano
ceb	Cebuano
rab	Chamling
ch	Chamorro
hne	Chhattisgarhi (Devanagari)
zh-Hans	Cinese semplificato
zh-Hant	Cinese tradizionale
kw	Cornish
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 (cirillico)
et	Estone
fo	Faeroese
fj	Fijian
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 (Devanagiri)
hni	Hani
bgc	Haryanvi
haw	Hawaiano
hi	hindi
mww	Hmong Daw (Latino)
hoc	Ho (Devana montana)
hu	Ungherese
is	Islandese
smn	Inari Sami
id	Indonesian
ia	Interlingua
iu	Inuktitut (Latino)
ga	Irlandese
it	Italiano
ja	Giapponese
Jns	Jaunsari (Devanagari)
jv	Giavanese
kea	Kabuverdianu
kac	Kachin (alfabeto latino)
xnr	Kangri (Devanagiri)
krc	Karachay-Balkar
kaa-cyrl	Kara-Kalpak (cirillico)
kaa	Kara-Kalpak (alfabeto latino)
csb	Kashubian
kk-cyrl	Kazakh (cirillico)
kk-latn	Kazako (alfabeto latino)
klr	Khaling
kha	Khasi
quc	K'iche'
ko	Coreano
kfq	paura
kpy	Koryak
kos	Kosraean
kum	Kumyk (cirillico)
ku-arab	Curdo (arabo)
ku-latn	Curdo (alfabeto latino)
kru	Kurukh (Devanagari)
ky	Kirghizistan (cirillico)
lkt	Lakota
la	Latino
lt	Lituano
dsb	Sorbiano inferiore
smj	Lule Sami
lb	Lussemburghese
bfz	Mahasu Pahari (Devanagari)
ms	Malese (latino)
mt	Maltese
kmj	Malto (Devanagari)
gv	Manx
mi	Maori
mr	Marathi
mn	Mongolo (cirillico)
cnr-cyrl	Montenegrino (cirillico)
cnr-latn	Montenegrino (latino)
nap	Napoletano
ne	nepalese
niu	Niuano
nog	Nogay
sme	Sami settentrionale (latino)
nb	Norvegese
no	Norvegese
oc	Occitano
os	Ossetico
ps	Pashto
fa	Farsi
pl	Polacco
pt	Portoghese
pa	Punjabi (arabo)
ksh	Ripuario
ro	Romeno
rm	Romancio
ru	Russo
sck	Sadri (Devanagiri)
sm	Samoa (alfabeto latino)
sa	Sanskrit (Devanasana)
sat	Santali (Devanasana)
sco	Scozzese
gd	Gaelico scozzese
sr	Serbo (scrittura latina)
sr-Cyrl	Serbo (alfabeto cirillico)
sr-Latn	Serbo (scrittura latina)
xsr	Sherpa (Devanagari)
srx	Sirmauri (Devanagari)
sms	Skolt Sami
sk	Slovacco
sl	Sloveno
so	Somali (arabo)
sma	Sami meridionale
es	Spagnolo
sw	Swahili (latino)
sv	Svedese
tg	Tagico (cirillico)
tt	Tataro (alfabeto latino)
tet	Tetum
thf	Thangmi
to	Tongan
tr	Turco
tk	Turkmeno (alfabeto latino)
tyv	Tuvan
hsb	Sorbiano superiore
ur	Urdu
ug	Uyghur (arabo)
uz-arab	Uzbeko (arabo)
uz-cyrl	Uzbeco (alfebeto cirillico)
uz	Uzbeco (alfabeto latino)
vo	Volapük
wae	Walser
cy	Gallese
fy	Frisiano occidentale
yua	Yucatechi Maya
za	Zhuang
zu	Zulù
unk	Sconosciuto (tutto)

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

Usando l'API Analisi del testo, estrae informazioni personali da un testo di input e offre la possibilità di mascherarla.

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	Versione del modello da usare 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 viene eseguita alcuna maschera e l'output maskedText non verrà restituito.
replace	Sostituisce le entità rilevate con il carattere specificato nel parametro maskingCharacter. Il carattere verrà ripetuto alla lunghezza dell'entità rilevata in modo che gli offset corrispondano correttamente sia al testo di input che all'output maskedText.

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	ID risorsa di Azure completo di un'identità gestita assegnata dall'utente in genere nel formato "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" che dovrebbe essere stato 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.
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 i dati da archiviare in File di Azure.

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

SearchIndexerKnowledgeStoreObjectProjectionSelector

Oggetto

Definizione di proiezione per i dati da archiviare nel BLOB di Azure.

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

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 dei dati da archiviare nelle tabelle di Azure.

Nome	Tipo	Descrizione
generatedKeyName	string	Nome della chiave generata in cui archiviare la proiezione.
inputs	InputFieldMappingEntry[]	Input annidati per proiezioni complesse.
referenceKeyName	string	Nome della chiave di riferimento a una proiezione diversa.
source	string	Dati di origine da proiettare.
sourceContext	string	Contesto di origine per proiezioni complesse.
tableName	string	Nome della tabella di Azure in cui archiviare 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	Descrizione di una chiave di crittografia creata 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[]: AzureOpenAIEmbeddingSkill[] ChatCompletionSkill[] ConditionalSkill[] ContentUnderstandingSkill[] CustomEntityLookupSkill[] DocumentExtractionSkill[] DocumentIntelligenceLayoutSkill[] EntityLinkingSkill[] EntityRecognitionSkillV3[] ImageAnalysisSkill[] KeyPhraseExtractionSkill[] LanguageDetectionSkill[] MergeSkill[] OcrSkill[] PIIDetectionSkill[] SentimentSkillV3[] ShaperSkill[] SplitSkill[] TextTranslationSkill[] 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	ID applicazione AAD a cui sono state concesse le autorizzazioni di accesso necessarie all'insieme di credenziali delle chiavi di Azure da usare durante la crittografia dei dati inattivi. 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	Nome della chiave di Azure Key Vault da usare per crittografare i dati inattivi.
keyVaultKeyVersion	string	Versione della chiave di Azure Key Vault da usare per crittografare i dati inattivi.
keyVaultUri	string	L'URI dell'insieme di credenziali delle chiavi di Azure, detto anche nome DNS, che contiene la chiave da usare per crittografare i dati inattivi. 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

Usando l'API Analisi del testo, valuta il testo non strutturato e per ogni record, fornisce etichette del sentiment (ad esempio "negative", "neutral" e "positive") in base al punteggio di attendibilità 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 impostato su true, l'output della competenza includerà informazioni di Analisi del testo per il opinion mining, ovvero destinazioni (sostantivi o verbi) e la relativa 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		Versione del modello da usare 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.
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.

SplitSkillLanguage

Enumerazione

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

Valore	Descrizione
am	Amharic
bs	Bosniaco
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	Islandese
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)

TextSplitMode

Enumerazione

Valore che indica la modalità di divisione da eseguire.

Valore	Descrizione
pages	Dividere il testo in singole pagine.
sentences	Dividere 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	Cantonse (tradizionale)
ca	Catalano
zh-Hans	Cinese semplificato
zh-Hant	Cinese tradizionale
hr	Croato
cs	Ceco
da	Danese
nl	Olandese
en	English
et	Estone
fj	Fijian
fil	Filipino
fi	Finlandese
fr	Francese
de	Tedesco
el	Greco
ht	Creolo haitiano
he	Ebraico
hi	hindi
mww	Hmong Daw
hu	Ungherese
is	Islandese
id	Indonesian
it	Italiano
ja	Giapponese
sw	Kiswahili
tlh	Klingon
tlh-Latn	Klingon (alfabeto latino)
tlh-Piqd	Klingon (script Klingon)
ko	Coreano
lv	Lettone
lt	Lituano
mg	Malgascio
ms	Malese
mt	Maltese
nb	Norvegese
fa	Farsi
pl	Polacco
pt	Portoghese
pt-br	Portoghese (Brasile)
pt-PT	Portoghese (Portogallo)
otq	Queretaro Otomi
ro	Romeno
ru	Russo
sm	Samoano
sr-Cyrl	Serbo (alfabeto cirillico)
sr-Latn	Serbo (scrittura latina)
sk	Slovacco
sl	Sloveno
es	Spagnolo
sv	Svedese
ty	Tahitiano
ta	Tamil
te	Telugu
th	Tailandese
to	Tongan
tr	Turco
uk	Ucraino
ur	Urdu
vi	Vietnamita
cy	Gallese
yua	Yucatechi Maya
ga	Irlandese
kn	Kannada
mi	Maori
ml	Malayalam
pa	Punjabi

VisualFeature

Enumerazione

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

Valore	Descrizione
adult	Caratteristiche visive riconosciute come persone adulte.
brands	Funzionalità visive riconosciute come marchi commerciali.
categories	Categorie.
description	Descrizione.
faces	Funzionalità visive riconosciute come visi di persone.
objects	Funzionalità visive riconosciute come oggetti.
tags	Categorie.

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 competenze personalizzate che si connettono a codice esterno in una funzione di Azure o a un'altra applicazione che fornisce le trasformazioni. Questo valore deve essere l'ID applicazione creato per la funzione o l'app quando è stato registrato con 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.