Azure - IQ foundry (anteprima)
Connettersi alle knowledge base IQ foundry basate su Azure AI Search. Foundry IQ è un livello di conoscenza gestito che fornisce agli agenti le risposte con riconoscimento delle autorizzazioni, menzionate dai dati dell'organizzazione in Azure, SharePoint, OneLake e il Web. Questo connettore è in anteprima.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Classe | Regions |
|---|---|---|
| Copilot Studio | Standard | Tutte le aree di Power Automate |
| App per la logica | Standard | Tutte le aree di App per la logica |
| Power Apps | Standard | Tutte le aree di Power Apps |
| Power Automate | Standard | Tutte le aree di Power Automate |
| Contatto | |
|---|---|
| Name | Microsoft |
| URL | https://support.microsoft.com/ |
| abapi@microsoft.com |
| Metadati del connettore | |
|---|---|
| Editore | Microsoft |
| Sito web | https://learn.microsoft.com/en-us/azure/search/ |
| Informativa sulla privacy | https://privacy.microsoft.com/en-us/privacystatement |
| Categorie | AI |
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Si tratta di una connessione condivisibile. Se l'app per l'alimentazione viene condivisa con un altro utente, anche la connessione viene condivisa. Per altre informazioni, vedere Panoramica dei connettori per le app canvas - Power Apps | Microsoft Docs
| Name | Tipo | Descrizione | Obbligatorio |
|---|---|---|---|
| URL del servizio di ricerca IQ foundry | string | L'endpoint Azure AI Search che ospita la Knowledge Base di IQ Foundry | Vero |
| Chiave API IQ Foundry | securestring | Chiave API per il servizio di ricerca IQ Foundry | Vero |
| Foundry IQ Knowledge Base Name | string | Nome della Knowledge Base di IQ Foundry su cui eseguire una query | Vero |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 5000 | 60 secondi |
Azioni
| Foundry IQ Knowledge Retrieval (API) |
Microsoft recupero della knowledge base di IQ Foundry. Basare l'agente usando la Knowledge Base di IQ Foundry per il recupero basato sul consumo di alta qualità, fornendo risposte con riconoscimento delle autorizzazioni e citate. |
| Foundry IQ Knowledge Retrieval (MCP) |
Microsoft recupero della Knowledge Base IQ Foundry tramite il protocollo MCP. Basare l'agente usando la Knowledge Base di IQ Foundry per il recupero basato sul consumo di alta qualità, fornendo risposte con riconoscimento delle autorizzazioni e citate. |
Foundry IQ Knowledge Retrieval (API)
Microsoft recupero della knowledge base di IQ Foundry. Basare l'agente usando la Knowledge Base di IQ Foundry per il recupero basato sul consumo di alta qualità, fornendo risposte con riconoscimento delle autorizzazioni e citate.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Versione dell'API
|
api-version | True | string |
Versione dell'API per il servizio knowledge base Azure AI Search. |
|
Token di autorizzazione query
|
x-ms-query-authorization | string |
Token utente passato a Azure AI Search per l'autorizzazione a livello di documento. |
|
|
Ruolo
|
role | string |
Ruolo del mittente del messaggio ,ad esempio 'utente', 'assistente'. |
|
|
type
|
type | string |
Tipo di contenuto ,ad esempio 'text'. |
|
|
text
|
text | string |
Contenuto di testo del messaggio. |
Valori restituiti
- Corpo
- RetrieveResponse
Foundry IQ Knowledge Retrieval (MCP)
Microsoft recupero della Knowledge Base IQ Foundry tramite il protocollo MCP. Basare l'agente usando la Knowledge Base di IQ Foundry per il recupero basato sul consumo di alta qualità, fornendo risposte con riconoscimento delle autorizzazioni e citate.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Versione dell'API
|
api-version | True | string |
Versione dell'API per il servizio knowledge base Azure AI Search. |
|
Token di autorizzazione query
|
x-ms-query-authorization | string |
Token utente passato a Azure AI Search per l'autorizzazione a livello di documento. |
Definizioni
RetrieveResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
response
|
response | array of RetrieveResponseItem |
Risposta di recupero contenente contenuto citato dalla Knowledge Base. |
|
activity
|
activity | array of RetrieveActivity |
Log attività che mostra la pianificazione delle query, le chiamate all'indice di ricerca e i passaggi di ragionamento. |
|
references
|
references | array of RetrieveReference |
Riferimenti al documento di origine con punteggi e metadati di pertinenza. |
RetrieveResponseItem
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
contenuto
|
content | array of object |
Elementi di contenuto nella risposta. |
|
type
|
content.type | string |
Tipo di contenuto ,ad esempio 'text'. |
|
text
|
content.text | string |
Contenuto di testo recuperato con i risultati citati dalla Knowledge Base. |
RetrieveActivity
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
type
|
type | string |
Tipo di attività , ad esempio 'modelQueryPlanning', 'searchIndex', 'agenticReasoning'. |
|
id
|
id | integer |
Identificatore del passaggio dell'attività. |
|
knowledgeSourceName
|
knowledgeSourceName | string |
Nome dell'origine della knowledge base su cui è stata interrogata. |
|
Ms trascorsi
|
elapsedMs | integer |
Tempo trascorso in millisecondi per questo passaggio dell'attività. |
|
inputTokens
|
inputTokens | integer |
Numero di token di input usati nel passaggio di pianificazione delle query del modello. |
|
outputTokens
|
outputTokens | integer |
Numero di token di output prodotti nel passaggio di pianificazione delle query del modello. |
|
queryTime
|
queryTime | date-time |
Timestamp quando è stata eseguita la query sull'indice di ricerca. |
|
count
|
count | integer |
Numero di risultati restituiti dalla query sull'indice di ricerca. |
|
searchIndexArguments
|
searchIndexArguments | SearchIndexArguments |
Argomenti passati alla query dell'indice di ricerca. |
|
kind
|
retrievalReasoningEffort.kind | string |
Livello di sforzo di ragionamento applicato (ad esempio, 'basso', 'medio', 'alto'). |
|
reasoningTokens
|
reasoningTokens | integer |
Numero di token usati nel passaggio di ragionamento agentico. |
SearchIndexArguments
Argomenti passati alla query dell'indice di ricerca.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
search
|
search | string |
Testo della query di ricerca inviato all'indice. |
|
filter
|
filter | string |
Espressione di filtro OData applicata alla query di ricerca. |
|
sourceDataFields
|
sourceDataFields | array of object |
Campi dati di origine richiesti dall'indice di ricerca. |
|
name
|
sourceDataFields.name | string |
Nome del campo dati di origine. |
|
searchFields
|
searchFields | array of string |
Campi specifici da cercare all'interno dell'indice. |
|
semanticConfigurationName
|
semanticConfigurationName | string |
Nome della configurazione semantica utilizzata per la classificazione. |
RetrieveReference
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
type
|
type | string |
Tipo di riferimento , ad esempio 'searchIndex'. |
|
id
|
id | string |
Identificatore di riferimento. |
|
activitySource
|
activitySource | integer |
Identificatore del passaggio dell'attività che ha prodotto questo riferimento. |
|
sourceData
|
sourceData | object |
Dati di origine aggiuntivi associati al riferimento. |
|
docKey
|
docKey | string |
Chiave del documento di origine nell'indice di ricerca. |
|
Titolo
|
title | string |
Titolo del documento di origine a cui si fa riferimento. |
|
rerankerScore
|
rerankerScore | float |
Punteggio di pertinenza del reranker semantico per questo riferimento. |