Azure - Foundry IQ
Maak verbinding met Foundry IQ Knowledge Bases, mogelijk gemaakt door Azure AI Zoeken. Foundry IQ is een beheerde kennislaag die agents machtigingsbewuste, geciteerde antwoorden van de gegevens van uw organisatie biedt in Azure, SharePoint, OneLake en het web.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Alle Power Automate-regio's |
| Logic-apps | Standard | Alle Logic Apps-regio's |
| Power Apps | Standard | Alle Power Apps-regio's |
| Power Automate | Standard | Alle Power Automate-regio's |
| Contact | |
|---|---|
| Naam | Microsoft |
| URL | https://support.microsoft.com/ |
| abapi@microsoft.com |
| Connectormetagegevens | |
|---|---|
| Publisher | Microsoft |
| Website | https://learn.microsoft.com/en-us/azure/search/ |
| Privacybeleid | https://privacy.microsoft.com/en-us/privacystatement |
| Categorieën | AI |
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| API-sleutel | Geef een API-sleutel op voor toegang tot uw Foundry IQ-zoekservice. | Alle regio's | Deelbaar |
| Verificatie van clientcertificaat | Geef Microsoft Entra ID referenties op met behulp van een PFX-certificaat en -wachtwoord. | Alle regio's | Deelbaar |
| Beheeridentiteit | Maak een verbinding met behulp van een beheerde identiteit. | Alleen LOGICAPPS | Deelbaar |
| Geïntegreerde Microsoft Entra ID | Gebruik Microsoft Entra ID om toegang te krijgen tot uw Foundry IQ-zoekservice. | Alle regio's | Niet deelbaar |
| Service-principal (Microsoft Entra ID-toepassing) | Gebruik een Microsoft Entra ID-toepassing voor toegang tot uw Foundry IQ-zoekservice. | Alle regio's | Niet deelbaar |
| Standaard [AFGESCHAFT] | Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies. | Alle regio's | Niet deelbaar |
API-sleutel
Verificatie-id: apiKeyAuth
Van toepassing: Alle regio's
Geef een API-sleutel op voor toegang tot uw Foundry IQ-zoekservice.
Dit is deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt de verbinding ook gedeeld. Zie het overzicht van connectors voor canvas-apps - Power Apps | Microsoft Docs
| Naam | Typ | Beschrijving | Required |
|---|---|---|---|
| Foundry IQ Search Service-eindpunt | touw | Het Azure AI Zoeken-eindpunt | True |
| Foundry IQ Search Service-API-sleutel | beveiligde string | De Azure AI Zoeken API-sleutel | True |
Verificatie van clientcertificaat
Verificatie-id: certOauth
Van toepassing: Alle regio's
Geef Microsoft Entra ID referenties op met behulp van een PFX-certificaat en -wachtwoord.
Dit is deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt de verbinding ook gedeeld. Zie het overzicht van connectors voor canvas-apps - Power Apps | Microsoft Docs
| Naam | Typ | Beschrijving | Required |
|---|---|---|---|
| Foundry IQ Search Service-eindpunt | touw | Het Azure AI Zoeken-eindpunt | True |
| Tenant | touw | True | |
| Client-ID | touw | De client-id van de Microsoft Entra ID-toepassing | |
| Clientcertificaatgeheim | clientcertificaat | Het clientcertificaatgeheim dat door deze toepassing is toegestaan | True |
Beheerde identiteit
Verificatie-id: managedIdentityAuth
Van toepassing: alleen LOGICAPPS
Maak een verbinding met behulp van een beheerde identiteit.
Dit is deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt de verbinding ook gedeeld. Zie het overzicht van connectors voor canvas-apps - Power Apps | Microsoft Docs
| Naam | Typ | Beschrijving | Required |
|---|---|---|---|
| Beheerde identiteit | managedIdentity | Aanmelden met een beheerde identiteit | True |
| Foundry IQ Search Service-eindpunt | touw | Het Azure AI Zoeken-eindpunt | True |
Microsoft Entra ID geïntegreerd
Verificatie-id: oauth
Van toepassing: Alle regio's
Gebruik Microsoft Entra ID om toegang te krijgen tot uw Foundry IQ-zoekservice.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typ | Beschrijving | Required |
|---|---|---|---|
| Foundry IQ Search Service-eindpunt | touw | Het Azure AI Zoeken-eindpunt | True |
Service principal (Microsoft Entra ID-applicatie)
Verificatie-id: oauthSP
Van toepassing: Alle regio's
Gebruik een Microsoft Entra ID-toepassing voor toegang tot uw Foundry IQ-zoekservice.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typ | Beschrijving | Required |
|---|---|---|---|
| Foundry IQ Search Service-eindpunt | touw | Het Azure AI Zoeken-eindpunt | True |
| Tenant | touw | True | |
| Client-ID | touw | True | |
| Clientgeheim | beveiligde string | True |
Standaard [AFGESCHAFT]
Van toepassing: Alle regio's
Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typ | Beschrijving | Required |
|---|---|---|---|
| Foundry IQ Search Service-eindpunt | touw | Het Azure AI Zoeken-eindpunt | True |
| Foundry IQ Search Service-API-sleutel | beveiligde string | De Azure AI Zoeken API-sleutel | True |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 5000 | 60 seconden |
Acties
| Foundry IQ Knowledge Retrieval API (afgeschaft) [AFGESCHAFT] |
Microsoft Foundry IQ Knowledge Base ophalen. Grond uw agent met behulp van de Foundry IQ Knowledge Base voor het ophalen van hoge kwaliteit, op verbruik gebaseerd ophalen, waarbij machtigingenbewuste, geciteerde antwoorden worden geleverd. (deprecated) |
| Foundry IQ Knowledge Retrieval MCP |
Microsoft Foundry IQ Knowledge Base ophalen via MCP-protocol. Grond uw agent met behulp van de Foundry IQ Knowledge Base voor het ophalen van hoge kwaliteit, op verbruik gebaseerd ophalen, waarbij machtigingenbewuste, geciteerde antwoorden worden geleverd. |
Foundry IQ Knowledge Retrieval API (afgeschaft) [AFGESCHAFT]
Microsoft Foundry IQ Knowledge Base ophalen. Grond uw agent met behulp van de Foundry IQ Knowledge Base voor het ophalen van hoge kwaliteit, op verbruik gebaseerd ophalen, waarbij machtigingenbewuste, geciteerde antwoorden worden geleverd. (deprecated)
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Naam van knowledge base
|
knowledgeBaseName | True | string |
De naam van de Foundry IQ Knowledge Base om een query uit te voeren. |
|
API-versie
|
api-version | True | string |
API-versie voor de Azure AI Zoeken Knowledge Base-service. |
|
Autorisatietoken voor querybron
|
x-ms-query-source-authorization | string |
Het gebruikerstoken is doorgegeven aan Azure AI Zoeken voor autorisatie op documentniveau. |
|
|
role
|
role | string |
De rol van de afzender van het bericht (bijvoorbeeld 'gebruiker', 'assistent'). |
|
|
type
|
type | string |
Het type inhoud (bijvoorbeeld 'tekst'). |
|
|
tekst
|
text | string |
De tekstinhoud van het bericht. |
Retouren
- Body
- RetrieveResponse
Foundry IQ Knowledge Retrieval MCP
Microsoft Foundry IQ Knowledge Base ophalen via MCP-protocol. Grond uw agent met behulp van de Foundry IQ Knowledge Base voor het ophalen van hoge kwaliteit, op verbruik gebaseerd ophalen, waarbij machtigingenbewuste, geciteerde antwoorden worden geleverd.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Naam van knowledge base
|
knowledgeBaseName | True | string |
De naam van de Foundry IQ Knowledge Base om een query uit te voeren. |
|
API-versie
|
api-version | True | string |
API-versie voor de Azure AI Zoeken Knowledge Base-service. |
Definities
RetrieveResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
response
|
response | array of RetrieveResponseItem |
Het antwoord voor het ophalen met geciteerde inhoud uit de Knowledge Base. |
|
activity
|
activity | array of RetrieveActivity |
Activiteitenlogboek met queryplanning, zoekindexoproepen en redeneringsstappen. |
|
references
|
references | array of RetrieveReference |
Brondocumentverwijzingen met relevantiescores en metagegevens. |
RetrieveResponseItem
| Name | Pad | Type | Description |
|---|---|---|---|
|
inhoud
|
content | array of object |
De inhoudsitems in het antwoord. |
|
type
|
content.type | string |
Het type inhoud (bijvoorbeeld 'tekst'). |
|
tekst
|
content.text | string |
De opgehaalde tekstinhoud met geciteerde resultaten uit de Knowledge Base. |
RetrieveActivity
| Name | Pad | Type | Description |
|---|---|---|---|
|
type
|
type | string |
Het activiteitstype (bijvoorbeeld 'modelQueryPlanning', 'searchIndex', 'agenticReasoning'). |
|
Id
|
id | integer |
De id van de activiteitsstap. |
|
knowledgeSourceName
|
knowledgeSourceName | string |
De naam van de query op de kennisbron. |
|
verstreken vm's
|
elapsedMs | integer |
De tijd die is verstreken in milliseconden voor deze activiteitsstap. |
|
inputTokens
|
inputTokens | integer |
Het aantal invoertokens dat wordt gebruikt in de planningsstap voor modelquery's. |
|
outputTokens
|
outputTokens | integer |
Het aantal uitvoertokens dat is geproduceerd in de planningsstap voor modelquery's. |
|
queryTime
|
queryTime | date-time |
De tijdstempel toen de zoekindexquery werd uitgevoerd. |
|
count
|
count | integer |
Het aantal resultaten dat wordt geretourneerd door de zoekindexquery. |
|
searchIndexArguments
|
searchIndexArguments | SearchIndexArguments |
De argumenten die zijn doorgegeven aan de zoekindexquery. |
|
Soort
|
retrievalReasoningEffort.kind | string |
Het niveau van de toegepaste redeneringsinspanning (bijvoorbeeld 'laag', 'gemiddeld', 'hoog'). |
|
reasoningTokens
|
reasoningTokens | integer |
Het aantal tokens dat wordt gebruikt in de agentische redeneringsstap. |
SearchIndexArguments
De argumenten die zijn doorgegeven aan de zoekindexquery.
| Name | Pad | Type | Description |
|---|---|---|---|
|
search
|
search | string |
De zoekquerytekst die naar de index is verzonden. |
|
filter
|
filter | string |
De OData-filterexpressie die is toegepast op de zoekquery. |
|
sourceDataFields
|
sourceDataFields | array of object |
De brongegevensvelden die zijn aangevraagd in de zoekindex. |
|
name
|
sourceDataFields.name | string |
De naam van het brongegevensveld. |
|
zoekvelden
|
searchFields | array of string |
De specifieke velden die moeten worden gezocht in de index. |
|
semanticConfigurationName
|
semanticConfigurationName | string |
De naam van de semantische configuratie die wordt gebruikt voor classificatie. |
RetrieveReference
| Name | Pad | Type | Description |
|---|---|---|---|
|
type
|
type | string |
Het verwijzingstype (bijvoorbeeld 'searchIndex'). |
|
Id
|
id | string |
De referentie-id. |
|
activitySource
|
activitySource | integer |
De id van de activiteitsstap die deze verwijzing heeft geproduceerd. |
|
sourceData
|
sourceData | object |
Aanvullende brongegevens die aan de verwijzing zijn gekoppeld. |
|
docKey
|
docKey | string |
De brondocumentsleutel in de zoekindex. |
|
titel
|
title | string |
De titel van het brondocument waarnaar wordt verwezen. |
|
rerankerScore
|
rerankerScore | float |
De semantische relevantiescore voor deze verwijzing. |