Skillsets - Get

Recupera un set di competenze in un servizio di ricerca.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
endpoint
path True

string

URL dell'endpoint del servizio di ricerca.

skillsetName
path True

string

Nome del set di competenze da recuperare.

api-version
query True

string

Versione dell'API client.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
x-ms-client-request-id

string (uuid)

ID di rilevamento inviato con la richiesta di assistenza per il debug.

Risposte

Nome Tipo Descrizione
200 OK

SearchIndexerSkillset

Il set di competenze viene restituito correttamente.

Other Status Codes

ErrorResponse

Risposta di errore.

Esempio

SearchServiceGetSkillset

Esempio di richiesta

GET https://previewexampleservice.search.windows.net/skillsets('myskillset')?api-version=2025-08-01-preview

Risposta di esempio

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "myskillset",
  "description": "Skillset for extracting entities and more",
  "skills": [
    {
      "@odata.type": "#Microsoft.Skills.Text.LanguageDetectionSkill",
      "name": "skill2",
      "context": "/document",
      "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",
      "context": "/document",
      "defaultLanguageCode": "en",
      "textSplitMode": "pages",
      "maximumPageLength": 4000,
      "pageOverlapLength": 0,
      "maximumPagesToTake": 0,
      "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/*",
      "defaultLanguageCode": "en",
      "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",
      "context": "/document",
      "uri": "https://contoso.example.org/",
      "httpMethod": "POST",
      "timeout": "PT5S",
      "batchSize": 1000,
      "inputs": [
        {
          "name": "text",
          "source": "/document/content",
          "inputs": []
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode",
          "inputs": []
        }
      ],
      "outputs": [
        {
          "name": "customresult",
          "targetName": "result"
        }
      ],
      "httpHeaders": {}
    },
    {
      "@odata.type": "#Microsoft.Skills.Util.DocumentIntelligenceLayoutSkill",
      "name": "docIntelligenceLayoutSkill",
      "context": "/document",
      "outputMode": "oneToMany",
      "markdownHeaderDepth": "h3",
      "outputFormat": "markdown",
      "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",
      "httpMethod": "POST",
      "timeout": "PT30S",
      "batchSize": 1,
      "degreeOfParallelism": 5,
      "apiKey": "<redacted>",
      "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"
        }
      ],
      "httpHeaders": {},
      "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.\"}}"
          }
        }
      }
    }
  ]
}

Definizioni

Nome Descrizione
AIServicesAccountIdentity

Account in più aree di una risorsa del servizio Azure per intelligenza artificiale collegata a un set di competenze.

AIServicesAccountKey

Chiave dell'account di una risorsa del servizio Azure per intelligenza artificiale collegata a un set di competenze, da usare con il sottodominio della risorsa.

AmlSkill

La competenza AML consente di estendere l'arricchimento dell'intelligenza artificiale con un modello di Azure Machine Learning (AML) personalizzato. Una volta che un modello AML è stato addestrato e distribuito, una competenza AML lo integra nell'arricchimento dell'intelligenza artificiale.

AzureActiveDirectoryApplicationCredentials

Credenziali di un'applicazione registrata creata per il servizio di ricerca, usata per l'accesso autenticato alle chiavi di crittografia archiviate in Azure Key Vault.

AzureOpenAIEmbeddingSkill

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

AzureOpenAIModelName

Nome del modello Azure Open AI che verrà chiamato.

AzureOpenAITokenizerParameters
ChatCompletionCommonModelParameters

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

ChatCompletionExtraParametersBehavior

Specifica il modo in cui 'extraParameters' deve essere gestito 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. Valori possibili: 'text' (stringa normale), 'json_object' (JSON arbitrario) o 'json_schema' (aderisce allo schema fornito).

ChatCompletionSchema

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

ChatCompletionSkill

Una competenza che chiama un modello linguistico tramite l'endpoint di completamento chat 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.

CustomEntity

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

CustomEntityAlias

Un oggetto complesso che può essere utilizzato per specificare ortografie o sinonimi alternativi al nome dell'entità radice.

CustomEntityLookupSkill

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

CustomEntityLookupSkillLanguage

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

DefaultCognitiveServicesAccount

Oggetto vuoto che rappresenta la risorsa predefinita del servizio Azure AI 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 sul contenuto e sul layout, tramite Azure AI Services, dai file all'interno della pipeline di arricchimento.

DocumentIntelligenceLayoutSkillChunkingProperties

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

DocumentIntelligenceLayoutSkillChunkingUnit

Controlla la cardinalità dell'unità chunk. Il valore predefinito è 'characters'

DocumentIntelligenceLayoutSkillExtractionOptions

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

DocumentIntelligenceLayoutSkillMarkdownHeaderDepth

La profondità delle intestazioni nell'output del markdown. Il valore predefinito è h6.

DocumentIntelligenceLayoutSkillOutputFormat

Controlla la cardinalità del formato di output. Il valore predefinito è 'markdown'.

DocumentIntelligenceLayoutSkillOutputMode

Controlla la cardinalità dell'output prodotto dalla competenza. Il valore predefinito è 'oneToMany'.

EntityCategory

Stringa che indica le categorie di entità da restituire.

EntityLinkingSkill

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

EntityRecognitionSkill

Questa competenza è deprecata. Usa il V3. EntityRecognitionSkill invece.

EntityRecognitionSkillLanguage

Deprecated. 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

ImageAnalysisSkill

Competenza che analizza i file di immagine. Estrae un ricco set 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

Mappatura dei campi di input per una competenza.

JsonSchemaProperties

Un dizionario aperto per le proprietà estese. Obbligatorio se 'type' == 'json_schema'

KeyPhraseExtractionSkill

Una competenza che utilizza l'analisi del testo per l'estrazione di frasi chiave.

KeyPhraseExtractionSkillLanguage

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

LanguageDetectionSkill

Una competenza che rileva la lingua del testo di input e riporta un unico codice lingua per ogni documento inviato nella richiesta. Il codice della lingua è abbinato a un punteggio che indica l'attendibilità dell'analisi.

LineEnding

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

MergeSkill

Competenza per l'unione di due o più stringhe in un'unica stringa unificata, con un delimitatore facoltativo definito dall'utente che separa ogni parte del componente.

OcrSkill

Una competenza che estrae il testo dai file di immagine.

OcrSkillLanguage

I codici lingua supportati per l'input da OcrSkill.

OutputFieldMappingEntry

Mappatura dei campi di output per una competenza.

PIIDetectionSkill

L'uso dell'API Analisi del testo estrae le informazioni personali da un testo di input e offre la possibilità di mascherarle.

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à da utilizzare per un'origine dati.

SearchIndexerIndexProjections

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 tipo primitivo.

SearchIndexerKnowledgeStore

Definizione di proiezioni aggiuntive su BLOB, tabelle o file di Azure di dati arricchiti.

SearchIndexerKnowledgeStoreFileProjectionSelector

Definizione della proiezione per i dati da archiviare in File di Azure.

SearchIndexerKnowledgeStoreObjectProjectionSelector

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

SearchIndexerKnowledgeStoreParameters

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

SearchIndexerKnowledgeStoreProjection

Oggetto contenitore per vari selettori di proiezione.

SearchIndexerKnowledgeStoreTableProjectionSelector

Descrizione dei dati da archiviare in Tabelle di Azure.

SearchIndexerSkillset

Un 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.

SentimentSkill

Questa competenza è deprecata. Usa il V3. SentimentSkill.

SentimentSkillLanguage

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

SentimentSkillV3

L'uso dell'API Analisi del testo valuta il testo non strutturato e, per ogni record, fornisce etichette di valutazione (ad esempio "negativo", "neutro" e "positivo") in base al punteggio di attendibilità più alto trovato dal servizio a livello di frase e documento.

ShaperSkill

Un'abilità per rimodellare i risultati. Crea un tipo complesso per supportare i campi compositi (noti anche come campi multiparte).

SplitSkill

Un'abilità per dividere una stringa in blocchi di testo.

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'.

SplitSkillLanguage

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

SplitSkillUnit

Un valore che indica l'unità da utilizzare.

TextSplitMode

Un valore che indica la modalità di divisione da eseguire.

TextTranslationSkill

Un'abilità per tradurre il testo da una lingua all'altra.

TextTranslationSkillLanguage

Codici lingua supportati per il testo di input da TextTranslationSkill.

VisionVectorizeSkill

Consente di generare un incorporamento vettoriale per una determinata immagine o input di testo usando l'API Vettorizzazione visione di Azure AI Services.

VisualFeature

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

WebApiSkill

Una competenza in grado di chiamare un endpoint API Web, consentendo di estendere un set di competenze facendo in modo che chiami il codice personalizzato.

AIServicesAccountIdentity

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.AIServicesByIdentity

Frammento di URI che specifica il tipo di risorsa del servizio Azure AI collegata a un set di competenze.

description

string

Descrizione della risorsa del servizio Azure AI collegata a un set di competenze.

identity SearchIndexerDataIdentity:

Identità gestita assegnata dall'utente usata per le connessioni al servizio di intelligenza artificiale. Se non viene specificata, viene usata l'identità gestita assegnata dal sistema. Negli aggiornamenti del 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 del sottodominio per il servizio di intelligenza artificiale corrispondente.

AIServicesAccountKey

Chiave dell'account di una risorsa del servizio Azure per intelligenza artificiale collegata a un set di competenze, da usare con il sottodominio della risorsa.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Azure.Search.AIServicesByKey

Frammento di URI che specifica il tipo di risorsa del servizio Azure AI collegata a un set di competenze.

description

string

Descrizione della risorsa del servizio Azure AI collegata a un set di competenze.

key

string

Chiave usata per effettuare il provisioning della risorsa del servizio Azure AI collegata a un set di competenze.

subdomainUrl

string

L'URL del sottodominio per il servizio di intelligenza artificiale corrispondente.

AmlSkill

La competenza AML consente di estendere l'arricchimento dell'intelligenza artificiale con un modello di Azure Machine Learning (AML) personalizzato. Una volta che un modello AML è stato addestrato e distribuito, una competenza AML lo integra nell'arricchimento dell'intelligenza artificiale.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Custom.AmlSkill

Frammento URI che specifica il tipo di 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.

degreeOfParallelism

integer (int32)

(Facoltativo) Se specificato, indica il numero di chiamate che l'indicizzatore effettuerà in parallelo all'endpoint fornito. È possibile ridurre questo valore se l'endpoint ha esito negativo con un carico di richieste troppo elevato oppure aumentarlo se l'endpoint è in grado di accettare più richieste e si desidera un aumento delle prestazioni dell'indicizzatore. Se non è impostato, viene utilizzato il valore predefinito 5. Il grado di parallelismo può essere impostato su un massimo di 10 e un minimo di 1.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

key

string

(Obbligatorio per l'autenticazione con chiave) La chiave per il servizio AML.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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 con token). L'area in cui viene distribuito il servizio AML.

resourceId

string

(Obbligatorio per l'autenticazione del token). ID risorsa Azure Resource Manager del servizio AML. Deve 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 l'assenza di autenticazione o per l'autenticazione con chiave) URI di assegnazione dei punteggi del servizio AML a cui verrà inviato il payload JSON. È consentito solo lo schema URI https.

AzureActiveDirectoryApplicationCredentials

Credenziali di un'applicazione registrata creata per il servizio di ricerca, usata per l'accesso autenticato alle chiavi di crittografia archiviate in Azure Key Vault.

Nome Tipo Descrizione
applicationId

string

Un ID applicazione AAD a cui sono state concesse le autorizzazioni di accesso necessarie per Azure Key Vault che deve essere usato per crittografare i dati inattivi. L'ID applicazione non deve essere confuso con l'ID oggetto per l'applicazione AAD.

applicationSecret

string

Chiave di autenticazione dell'applicazione AAD specificata.

AzureOpenAIEmbeddingSkill

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

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill

Frammento URI che specifica il tipo di competenza.

apiKey

string

Chiave API della risorsa Azure OpenAI designata.

authIdentity SearchIndexerDataIdentity:

Identità gestita assegnata dall'utente utilizzata 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 nella risorsa designata.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

dimensions

integer (int32)

Numero di dimensioni che devono essere presenti negli incorporamenti di output risultanti. Supportato solo nei modelli text-embedding-3 e successivi.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

modelName

AzureOpenAIModelName

Nome del modello di incorporamento distribuito nel percorso deploymentId specificato.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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 Azure OpenAI.

AzureOpenAIModelName

Nome del modello Azure Open AI che verrà chiamato.

Valore Descrizione
text-embedding-ada-002
text-embedding-3-large
text-embedding-3-small
gpt-4o
gpt-4o-mini
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano

AzureOpenAITokenizerParameters

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

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

Nome Tipo Valore predefinito Descrizione
frequencyPenalty

number

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

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

0.7

Temperatura di campionamento. Il valore predefinito è 0,7.

ChatCompletionExtraParametersBehavior

Specifica il modo in cui 'extraParameters' deve essere gestito da Azure AI Foundry. Il valore predefinito è 'error'.

Valore Descrizione
pass-through
drop

Elimina tutti i parametri extra.

error

Genera un errore se è presente un parametro aggiuntivo.

ChatCompletionResponseFormat

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

Nome Tipo Valore predefinito Descrizione
jsonSchemaProperties

JsonSchemaProperties

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. Valori possibili: 'text' (stringa normale), 'json_object' (JSON arbitrario) o 'json_schema' (aderisce allo schema fornito).

ChatCompletionResponseFormatType

Specifica il modo in cui l'LLM deve formattare la risposta. Valori possibili: 'text' (stringa normale), 'json_object' (JSON arbitrario) o 'json_schema' (aderisce allo schema fornito).

Valore Descrizione
text
jsonObject
jsonSchema

ChatCompletionSchema

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'.

ChatCompletionSkill

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

Nome Tipo Valore predefinito Descrizione
@odata.type string:

#Microsoft.Skills.Custom.ChatCompletionSkill

Frammento URI che specifica il tipo di competenza.

apiKey

string

Chiave API per l'autenticazione al modello. Non è possibile specificare contemporaneamente apiKey e authIdentity.

authIdentity SearchIndexerDataIdentity:

Identità gestita assegnata dall'utente utilizzata per le connessioni in uscita. Se viene fornito un authResourceId che non viene specificato, viene usata l'identità gestita assegnata dal sistema. Quando si aggiorna l'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 al codice esterno in una funzione di Azure o in un'altra applicazione che fornisce le trasformazioni. Questo valore deve essere l'ID applicazione creato per la funzione o l'app quando è stata registrata con Azure Active Directory. Se specificata, la competenza personalizzata si connette alla funzione o all'app usando un ID gestito (assegnato dal sistema o dall'utente) del servizio di ricerca e il token di accesso della funzione o dell'app, usando questo valore come ID risorsa per la creazione dell'ambito del token di accesso.

batchSize

integer (int32)

La dimensione del 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, il numero di chiamate parallele che possono essere effettuate all'API Web.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

extraParameters

object

Dizionario di tipo aperto per i parametri specifici del modello che devono essere aggiunti alla chiamata di completamento della chat. Segue il modello di estendibilità di Azure AI Foundry.

extraParametersBehavior

ChatCompletionExtraParametersBehavior

error

Modalità di gestione dei parametri aggiuntivi da Azure AI Foundry. Il valore predefinito è 'error'.

httpHeaders

object

Le intestazioni necessarie per effettuare la richiesta http.

httpMethod

string

Il 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 a monte.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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)

Il timeout desiderato per la richiesta. Il valore predefinito è 30 secondi.

uri

string

URL per l'API Web.

CognitiveServicesAccountKey

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

Frammento di URI che specifica il tipo di risorsa del servizio Azure AI collegata a un set di competenze.

description

string

Descrizione della risorsa del servizio Azure AI collegata a un set di competenze.

key

string

Chiave usata per effettuare il provisioning della risorsa del servizio Azure AI 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.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Util.ConditionalSkill

Frammento URI che specifica il tipo di 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.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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.

CustomEntity

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 senza distinzione tra maiuscole e minuscole 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 su 3, "Windows10" corrisponderà 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

Un oggetto complesso che può essere utilizzato per specificare ortografie o sinonimi alternativi al 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

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

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Text.CustomEntityLookupSkill

Frammento URI che specifica il tipo di 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.

defaultLanguageCode

CustomEntityLookupSkillLanguage

Valore che indica il codice della lingua da utilizzare. Il valore predefinito è en.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

entitiesDefinitionUri

string

Percorso di un file JSON o CSV contenente tutto il testo di destinazione con cui confrontare. Questa definizione di entità viene letta all'inizio dell'esecuzione di un indicizzatore. Eventuali aggiornamenti a questo file durante l'esecuzione di un 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 la distinzione tra maiuscole e minuscole. Se CaseSensitive non è impostato in CustomEntity, questo valore sarà il valore predefinito.

globalDefaultFuzzyEditDistance

integer (int32)

Un flag globale per FuzzyEditDistance. Se FuzzyEditDistance non è impostato in CustomEntity, questo valore sarà il valore predefinito.

inlineEntitiesDefinition

CustomEntity[]

Definizione CustomEntity inline.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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

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 vuoto che rappresenta la risorsa predefinita del servizio Azure AI per un set di competenze.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Azure.Search.DefaultCognitiveServices

Frammento di URI che specifica il tipo di risorsa del servizio Azure AI collegata a un set di competenze.

description

string

Descrizione della risorsa del servizio Azure AI collegata a un set di competenze.

DocumentExtractionSkill

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

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Util.DocumentExtractionSkill

Frammento URI che specifica il tipo di competenza.

configuration

object

Un dizionario di configurazioni per l'abilità.

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. Verrà impostato su 'contentAndMetadata' se non definito.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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. Verrà impostato su "predefinito" se non definito.

DocumentIntelligenceLayoutSkill

Una competenza che estrae informazioni sul contenuto e sul 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

Frammento URI che specifica il tipo di competenza.

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

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

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 a monte.

markdownHeaderDepth

DocumentIntelligenceLayoutSkillMarkdownHeaderDepth

h6

La profondità delle intestazioni nell'output del markdown. Il valore predefinito è h6.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, preceduto dal carattere '#'.

outputFormat

DocumentIntelligenceLayoutSkillOutputFormat

markdown

Controlla la cardinalità del formato di output. Il valore predefinito è 'markdown'.

outputMode

DocumentIntelligenceLayoutSkillOutputMode

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

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

DocumentIntelligenceLayoutSkillChunkingUnit

characters

Unità del blocco.

DocumentIntelligenceLayoutSkillChunkingUnit

Controlla la cardinalità dell'unità chunk. Il valore predefinito è 'characters'

Valore Descrizione
characters

Specifica il blocco in base ai caratteri.

DocumentIntelligenceLayoutSkillExtractionOptions

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.

DocumentIntelligenceLayoutSkillMarkdownHeaderDepth

La profondità delle intestazioni nell'output del markdown. Il valore predefinito è h6.

Valore Descrizione
h1

Livello di intestazione 1.

h2

Livello di intestazione 2.

h3

Livello di intestazione 3.

h4

Livello di intestazione 4.

h5

Livello di intestazione 5.

h6

Livello di intestazione 6.

DocumentIntelligenceLayoutSkillOutputFormat

Controlla la cardinalità del formato di output. Il valore predefinito è 'markdown'.

Valore Descrizione
text

Specificare il formato dell'output come testo.

markdown

Specificare il formato dell'output come markdown.

DocumentIntelligenceLayoutSkillOutputMode

Controlla la cardinalità dell'output prodotto dalla competenza. Il valore predefinito è 'oneToMany'.

Valore Descrizione
oneToMany

Specificare che l'output deve essere analizzato come 'oneToMany'.

EntityCategory

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

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

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Text.V3.EntityLinkingSkill

Frammento URI che specifica il tipo di 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.

defaultLanguageCode

string

Valore che indica il codice della lingua da utilizzare. Il valore predefinito è en.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

minimumPrecision

number (double)

minimum: 0
maximum: 1

Un valore compreso tra 0 e 1 che deve essere utilizzato solo per includere le 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 utilizzare quando si chiama il servizio Analisi del testo. Per impostazione predefinita, verrà utilizzata l'ultima versione disponibile quando non specificata. Si consiglia di non specificare questo valore a meno che non sia assolutamente necessario.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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.

EntityRecognitionSkill

Questa competenza è deprecata. Usa il V3. EntityRecognitionSkill invece.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Text.EntityRecognitionSkill

Frammento URI che specifica il tipo di competenza.

categories

EntityCategory[]

Elenco delle categorie di entità che devono essere estratte.

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

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

includeTypelessEntities

boolean

Determina se includere o meno entità note ma non conformi a un tipo predefinito. Se questa configurazione non è impostata (impostazione predefinita), su null o impostata su false, le entità che non sono conformi a uno dei tipi predefiniti non verranno visualizzate.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

minimumPrecision

number (double)

Un valore compreso tra 0 e 1 che deve essere utilizzato solo per includere le 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à.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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

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

Valore Descrizione
ar

Arabo

cs

Ceco

zh-Hans

Chinese-Simplified

zh-Hant

Chinese-Traditional

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

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

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Text.V3.EntityRecognitionSkill

Frammento URI che specifica il tipo di competenza.

categories

string[]

Elenco delle categorie di entità che devono essere estratte.

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

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

minimumPrecision

number (double)

minimum: 0
maximum: 1

Un valore compreso tra 0 e 1 che deve essere utilizzato solo per includere le 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. Per impostazione predefinita, verrà utilizzata l'ultima versione disponibile quando non specificata. Si consiglia di non specificare questo valore a meno che non sia assolutamente necessario.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

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

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

ImageAnalysisSkill

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

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Vision.ImageAnalysisSkill

Frammento URI che specifica il tipo di 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.

defaultLanguageCode

ImageAnalysisSkillLanguage

Valore che indica il codice della lingua da utilizzare. Il valore predefinito è en.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

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 a monte.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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[]

Un elenco di funzionalità visive.

ImageAnalysisSkillLanguage

Codici della lingua supportati per l'input da ImageAnalysisSkill.

Valore Descrizione
ar

Arabo

az

Azero

bg

Bulgaro

bs

Bosniaco Latino

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

Macedone

ms

Malesia malese

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 - Cirillico RS

sr-Latn

Serbo - Latino RS

sv

Svedese

th

Tailandese

tr

Turco

uk

Ucraino

vi

Vietnamita

zh

Cinese Semplificato

zh-Hans

Cinese Semplificato

zh-Hant

Cinese tradizionale

ImageDetail

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

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

Mappatura 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.

JsonSchemaProperties

Un dizionario aperto per le proprietà estese. Obbligatorio se 'type' == 'json_schema'

Nome Tipo Valore predefinito Descrizione
description

string

Descrizione dello schema JSON a cui aderirà il modello.

name

string

Nome dello schema JSON a cui aderirà il modello

schema

ChatCompletionSchema

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

strict

boolean

True

Se la risposta del modello deve utilizzare o meno output strutturati. Il valore predefinito è true

KeyPhraseExtractionSkill

Una competenza che utilizza l'analisi del testo per l'estrazione di frasi chiave.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Text.KeyPhraseExtractionSkill

Frammento URI che specifica il tipo di 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.

defaultLanguageCode

KeyPhraseExtractionSkillLanguage

Valore che indica il codice della lingua da utilizzare. Il valore predefinito è en.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

maxKeyPhraseCount

integer (int32)

Un numero che indica il numero di frasi chiave da restituire. Se assenti, verranno restituite tutte le frasi chiave identificate.

modelVersion

string

Versione del modello da utilizzare quando si chiama il servizio Analisi del testo. Per impostazione predefinita, verrà utilizzata l'ultima versione disponibile quando non specificata. Si consiglia di non specificare questo valore a meno che non sia assolutamente necessario.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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

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

Una competenza che rileva la lingua del testo di input e riporta un unico codice lingua per ogni documento inviato nella richiesta. Il codice della lingua è abbinato a un punteggio che indica l'attendibilità dell'analisi.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Text.LanguageDetectionSkill

Frammento URI che specifica il tipo di 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.

defaultCountryHint

string

Codice paese da utilizzare come suggerimento per il modello di rilevamento della lingua se non è in grado di distinguere l'ambiguità della lingua.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

modelVersion

string

Versione del modello da utilizzare quando si chiama il servizio Analisi del testo. Per impostazione predefinita, verrà utilizzata l'ultima versione disponibile quando non specificata. Si consiglia di non specificare questo valore a meno che non sia assolutamente necessario.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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.

LineEnding

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').

MergeSkill

Competenza per l'unione di due o più stringhe in un'unica stringa unificata, con un delimitatore facoltativo definito dall'utente che separa ogni parte del componente.

Nome Tipo Valore predefinito Descrizione
@odata.type string:

#Microsoft.Skills.Text.MergeSkill

Frammento URI che specifica il tipo di 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.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

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

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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.

OcrSkill

Una competenza che estrae il testo dai file di immagine.

Nome Tipo Valore predefinito Descrizione
@odata.type string:

#Microsoft.Skills.Vision.OcrSkill

Frammento URI che specifica il tipo di 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.

defaultLanguageCode

OcrSkillLanguage

Valore che indica il codice della lingua da utilizzare. Il valore predefinito è en.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

detectOrientation

boolean

False

Un valore che indica se 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 a monte.

lineEnding

LineEnding

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

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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

I codici lingua supportati per l'input da OcrSkill.

Valore Descrizione
af

Afrikaans

sq

Albanese

anp

Angika (Devanagiri)

ar

Arabo

ast

Asturiano

awa

Awadhi-Hindi (Devanagiri)

az

Azero (alfabeto latino)

bfy

Bagheli

eu

Basco

be

Bielorusso (cirillico e latino)

be-cyrl

Bielorusso (cirillico)

be-latn

Bielorusso (alfabeto latino)

bho

Bhojpuri-Hindi (Devanagiri)

bi

Bislama

brx

Bodo (Devanagiri)

bs

Bosniaco Latino

bra

Brajbha

br

Bretone

bg

Bulgaro

bns

Bundeli

bua

Buriato (cirillico)

ca

Catalano

ceb

Cebuano

rab

Screpolatura

ch

Chamorro

hne

Chhattisgarhi (Devanagiri)

zh-Hans

Cinese Semplificato

zh-Hant

Cinese tradizionale

kw

Cornico

co

Corso

crh

Tataro di Crimea (Latino)

hr

Croato

cs

Ceco

da

Danese

prs

Dari

dhi

Dhimal (Devanagiri)

doi

Dogri (Devanagiri)

nl

Olandese

en

English

myv

Erzya (cirillico)

et

Estone

fo

Faeroese

fj

Figiano

fil

Filippino

fi

Finlandese

fr

Francese

fur

Fruliano

gag

Gagauzo (Latino)

gl

Galiziano

de

Tedesco

gil

Gilbertino

gon

Gondi (Devanagiri)

el

Greco

kl

Groenlandese

gvr

Gurung (Devanagiri)

ht

Creolo haitiano

hlb

Halbi (Devanagiri)

hni

Hani

bgc

Haryanvi

haw

Hawaiano

hi

hindi

mww

Hmong Daw (Latino)

hoc

Ho (Devanagiri)

hu

Ungherese

is

Icelandic

smn

Inari Sami

id

Indonesian

ia

Interlingua

iu

Inuktitut (Latino)

ga

Irlandese

it

Italiano

ja

Giapponese

Jns

Jaunsari (Devanagiri)

jv

Giavanese

kea

Kabuverdianu

kac

Kachin (Latino)

xnr

Kangri (Devanagiri)

krc

Karachay-Balkar

kaa-cyrl

Kara-Kalpak (cirillico)

kaa

Kara-Kalpak (Latino)

csb

Casciubico

kk-cyrl

Kazako (cirillico)

kk-latn

Kazako (alfabeto latino)

klr

Khaling

kha

Khasi

quc

K'iche'

ko

Coreano

kfq

Korku

kpy

Koryak

kos

Kosraean

kum

Kumyk (cirillico)

ku-arab

Curdo (Arabo)

ku-latn

Curdo (Latino)

kru

Kurukh (Devanagiri)

ky

Kirghiso (cirillico)

lkt

Lakota

la

Latino

lt

Lituano

dsb

Sorabo inferiore

smj

Lule Sami

lb

Lussemburghese

bfz

Mahasu Pahari (Devanagiri)

ms

Malese (Latino)

mt

Maltese

kmj

Malto (Devanagiri)

gv

Mannese

mi

Maori

mr

Marathi

mn

Mongolo (cirillico)

cnr-cyrl

Montenegrino (cirillico)

cnr-latn

Montenegrino (Latino)

nap

Napoletano

ne

Nepalese

niu

Niueano

nog

Nogay

sme

Sami del Nord (Latino)

nb

Norvegese

no

Norvegese

oc

Occitano

os

Ossetico

ps

Pashto

fa

Persiano

pl

Polacco

pt

Portuguese

pa

Punjabi (Arabo)

ksh

Ripuario

ro

Romeno

rm

Romancio

ru

Russo

sck

Sadri (Devanagiri)

sm

Samoano (Latino)

sa

Sanscrito (Devanagiri)

sat

Santali (Devanagiri)

sco

Scozzese

gd

Scozzese Gaelico

sr

Serbo (alfabeto latino)

sr-Cyrl

Serbo (alfabeto cirillico)

sr-Latn

Serbo (alfabeto latino)

xsr

Sherpa (Devanagiri)

srx

Sirmauri (Devanagiri)

sms

Skolt Sami

sk

Slovacco

sl

Sloveno

so

Somalo (Arabo)

sma

Sami del sud

es

Spagnolo

sw

Swahili (Latino)

sv

Svedese

tg

Tagico (cirillico)

tt

Tartaro (Latino)

tet

Tetum

thf

Thangmi

to

Tongano

tr

Turco

tk

Turkmeno (latino)

tyv

Tuvano

hsb

Alto sorabo

ur

Urdu

ug

Uiguro (Arabo)

uz-arab

uzbeco (arabo)

uz-cyrl

Uzbeco (alfebeto cirillico)

uz

Uzbeco (alfabeto latino)

vo

Volapük

wae

Walser

cy

Gallese

fy

Frisone occidentale

yua

Yucatechi Maya

za

Zhuang

zu

Zulù

unk

Sconosciuto (tutti)

OutputFieldMappingEntry

Mappatura 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

L'uso dell'API Analisi del testo estrae le informazioni personali da un testo di input e offre la possibilità di mascherarle.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Text.PIIDetectionSkill

Frammento URI che specifica il tipo di 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.

defaultLanguageCode

string

Valore che indica il codice della lingua da utilizzare. Il valore predefinito è en.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

domain

string

Se specificato, imposterà il dominio PII in modo che includa solo un sottoinsieme 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 a monte.

maskingCharacter

string

maxLength: 1

Carattere utilizzato per mascherare il testo se il parametro maskingMode è impostato su replace. Il valore predefinito è '*'.

maskingMode

PIIDetectionSkillMaskingMode

Un 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

Un valore compreso tra 0 e 1 che deve essere utilizzato solo per includere le 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 utilizzare quando si chiama il servizio Analisi del testo. Per impostazione predefinita, verrà utilizzata l'ultima versione disponibile quando non specificata. Si consiglia di non specificare questo valore a meno che non sia assolutamente necessario.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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[]

Un elenco di categorie di entità PII che devono essere estratte e mascherate.

PIIDetectionSkillMaskingMode

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.

SearchIndexerDataNoneIdentity

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

Specifica l'identità da utilizzare per un'origine dati.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Azure.Search.DataUserAssignedIdentity

Frammento di URI che specifica il tipo di identità.

userAssignedIdentity

string

L'ID risorsa di Azure completo di un'identità gestita assegnata all'utente, in genere nel formato "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" che avrebbe dovuto essere assegnato al servizio di ricerca.

SearchIndexerIndexProjections

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 tipo primitivo.

selectors

SearchIndexerIndexProjectionSelector[]

Elenco delle proiezioni da eseguire negli indici di ricerca secondari.

SearchIndexerIndexProjectionSelector

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

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

Nome Tipo Descrizione
projectionMode

IndexProjectionMode

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

SearchIndexerKnowledgeStore

Definizione di proiezioni aggiuntive su BLOB, tabelle o file di Azure di dati arricchiti.

Nome Tipo Descrizione
identity SearchIndexerDataIdentity:

Identità gestita assegnata dall'utente usata per le connessioni ad Archiviazione di Azure durante la scrittura delle proiezioni dell'archivio conoscenze. Se la stringa di connessione indica un'identità (ResourceId) e non è specificata, viene usata l'identità gestita assegnata dal sistema. Quando si aggiorna l'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 tipo primitivo.

projections

SearchIndexerKnowledgeStoreProjection[]

Elenco di proiezioni aggiuntive da eseguire durante l'indicizzazione.

storageConnectionString

string

La stringa di connessione alle proiezioni dell'account di archiviazione verrà archiviata in.

SearchIndexerKnowledgeStoreFileProjectionSelector

Definizione della proiezione per i dati da archiviare 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

Definizione della proiezione per i dati da archiviare nel BLOB 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.

SearchIndexerKnowledgeStoreParameters

Dizionario delle proprietà di configurazione specifiche dell'archivio conoscenze. Ogni nome è il nome di una proprietà specifica. Ogni valore deve essere di 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 contenitore per vari selettori di proiezione.

Nome Tipo Descrizione
files

SearchIndexerKnowledgeStoreFileProjectionSelector[]

Proiezioni nell'archiviazione file di Azure.

objects

SearchIndexerKnowledgeStoreObjectProjectionSelector[]

Proiezioni nell'archiviazione BLOB di Azure.

tables

SearchIndexerKnowledgeStoreTableProjectionSelector[]

Proiezioni nell'archiviazione tabelle di Azure.

SearchIndexerKnowledgeStoreTableProjectionSelector

Descrizione dei dati da archiviare in Tabelle 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.

tableName

string

Nome della tabella di Azure in cui archiviare i dati proiettati.

SearchIndexerSkillset

Un elenco di competenze.

Nome Tipo Descrizione
@odata.etag

string

L'ETag del set di competenze.

cognitiveServices CognitiveServicesAccount:

Dettagli sul servizio Azure AI da usare durante l'esecuzione delle competenze.

description

string

La descrizione del set di competenze.

encryptionKey

SearchResourceEncryptionKey

Descrizione di una chiave di crittografia creata in Azure Key Vault. Questa chiave viene usata per fornire un livello aggiuntivo di crittografia dei dati inattivi per la definizione del set di competenze quando si desidera la certezza completa che nessuno, nemmeno Microsoft, possa decrittografare la definizione del set di competenze. Una volta crittografata, 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 desidera 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 a partire dal 1° gennaio 2019.

indexProjections

SearchIndexerIndexProjections

Definizione di proiezioni aggiuntive per gli indici di ricerca secondari.

knowledgeStore

SearchIndexerKnowledgeStore

Definizione di proiezioni aggiuntive in BLOB, tabelle o file di Azure di dati arricchiti.

name

string

Nome del set di competenze.

skills SearchIndexerSkill[]:

Un elenco di competenze nel set 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.

Nome Tipo Descrizione
accessCredentials

AzureActiveDirectoryApplicationCredentials

Credenziali facoltative di Azure Active Directory usate per l'accesso ad Azure Key Vault. Non necessario se si usa l'identità gestita.

identity SearchIndexerDataIdentity:

Un'identità gestita esplicita da usare per questa chiave di crittografia. Se non viene specificata e la proprietà delle credenziali di accesso è null, viene usata l'identità gestita assegnata dal sistema. Al momento dell'aggiornamento della risorsa, se l'identità esplicita non è specificata, rimane invariata. 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

URI dell'insieme di credenziali delle chiavi di Azure, noto anche come 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.

SentimentSkill

Questa competenza è deprecata. Usa il V3. SentimentSkill.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Text.SentimentSkill

Frammento URI che specifica il tipo di 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.

defaultLanguageCode

SentimentSkillLanguage

Valore che indica il codice della lingua da utilizzare. Il valore predefinito è en.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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.

SentimentSkillLanguage

Deprecated. 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

L'uso dell'API Analisi del testo valuta il testo non strutturato e, per ogni record, fornisce etichette di valutazione (ad esempio "negativo", "neutro" e "positivo") 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

Frammento URI che specifica il tipo di 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.

defaultLanguageCode

string

Valore che indica il codice della lingua da utilizzare. Il valore predefinito è en.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

includeOpinionMining

boolean

False

Se impostato su true, l'output della competenza includerà le informazioni di Analisi del testo per l'estrazione di opinioni, ovvero gli obiettivi (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 a monte.

modelVersion

string

Versione del modello da utilizzare quando si chiama il servizio Analisi del testo. Per impostazione predefinita, verrà utilizzata l'ultima versione disponibile quando non specificata. Si consiglia di non specificare questo valore a meno che non sia assolutamente necessario.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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

Un'abilità per rimodellare i risultati. Crea un tipo complesso per supportare i campi compositi (noti anche come campi multiparte).

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Util.ShaperSkill

Frammento URI che specifica il tipo di 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.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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

Un'abilità per dividere una stringa in blocchi di testo.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Text.SplitSkill

Frammento URI che specifica il tipo di competenza.

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

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

maximumPageLength

integer (int32)

La 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

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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

Un 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

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'.

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

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

Valore Descrizione
am

Amharico

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

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

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

Un 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

Un'abilità per tradurre il testo da una lingua all'altra.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Text.TranslationSkill

Frammento URI che specifica il tipo di 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.

defaultFromLanguageCode

TextTranslationSkillLanguage

Codice della lingua da cui tradurre i documenti per i documenti che non specificano in modo esplicito la lingua del mittente.

defaultToLanguageCode

TextTranslationSkillLanguage

Codice della lingua in cui tradurre i documenti per i documenti che non specificano in modo esplicito la lingua a.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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

Codice della lingua 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

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

Filippino

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

Persiano

pl

Polacco

pt

Portuguese

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 (alfabeto latino)

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

Gallese

yua

Yucatechi Maya

ga

Irlandese

kn

Kannada

mi

Maori

ml

Malayalam

pa

Punjabi

VisionVectorizeSkill

Consente di generare un incorporamento vettoriale per una determinata immagine o input di testo usando l'API Vettorizzazione visione di Azure AI Services.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Vision.VectorizeSkill

Frammento URI che specifica il tipo di 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.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

inputs

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

modelVersion

string

Versione del modello da usare quando si chiama il servizio Visione artificiale dei servizi di intelligenza artificiale. Per impostazione predefinita, verrà utilizzata l'ultima versione disponibile quando non specificata.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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

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

Una competenza in grado di chiamare un endpoint API Web, consentendo di estendere un set di competenze facendo in modo che chiami il codice personalizzato.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Skills.Custom.WebApiSkill

Frammento URI che specifica il tipo di competenza.

authIdentity SearchIndexerDataIdentity:

Identità gestita assegnata dall'utente utilizzata per le connessioni in uscita. Se viene fornito un authResourceId che non viene specificato, viene usata l'identità gestita assegnata dal sistema. Quando si aggiorna l'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 al codice esterno in una funzione di Azure o in un'altra applicazione che fornisce le trasformazioni. Questo valore deve essere l'ID applicazione creato per la funzione o l'app quando è stata registrata con Azure Active Directory. Se specificata, la competenza personalizzata si connette alla funzione o all'app usando un ID gestito (assegnato dal sistema o dall'utente) del servizio di ricerca e il token di accesso della funzione o dell'app, usando questo valore come ID risorsa per la creazione dell'ambito del token di accesso.

batchSize

integer (int32)

La dimensione del 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, il numero di chiamate parallele che possono essere effettuate all'API Web.

description

string

La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità.

httpHeaders

object

Le intestazioni necessarie per effettuare la richiesta http.

httpMethod

string

Il 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 a monte.

name

string

Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, 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)

Il timeout desiderato per la richiesta. Il valore predefinito è 30 secondi.

uri

string

URL per l'API Web.