Crea una fonte di conoscenza Work IQ (anteprima)

Note

Azure AI Search è disponibile tramite il portale di Azure, le API REST e Azure SDK. È inoltre alla base di Foundry IQ, il livello di conoscenza gestito che trasforma il contenuto aziendale in knowledge base riutilizzabili e con riconoscimento delle autorizzazioni per gli agenti nel portale di Microsoft Foundry.

Importante

Queste funzionalità e funzionalità fanno parte dell'API REST 2026-05-01-preview. L'anteprima 2026-05-01-preview è concessa in licenza all'utente come parte della sottoscrizione Azure ed è soggetta ai termini applicabili alle "Anteprime" nei Microsoft Product Terms, nel Microsoft Products and Services Data Protection Addendum ("DPA") e nei Supplemental Terms of Use for Microsoft Azure Previews.

La versione 2026-05-01-preview supporta le connessioni ad altri servizi di servizi Microsoft e di terze parti. L'utilizzo di questi servizi è soggetto alle rispettive condizioni e potrebbe comportare l'elaborazione o l'archiviazione dei dati al di fuori del limite di conformità Azure, nonché il flusso dei dati nel limite di conformità Azure.

Quando ci si connette all'IQ aziendale, è possibile che si verifichino costi e che i dati vengano inviati al di fuori del limite di conformità Azure e elaborati in base ai criteri di gestione dei dati e alle condizioni di servizio applicabili. È tua responsabilità gestire l'eventuale trasferimento dei tuoi dati al di fuori dei confini di conformità e geografici della tua organizzazione e le relative implicazioni, nonché garantire che siano predisposte le autorizzazioni, i limiti e le approvazioni appropriati.

L'utente è responsabile di esaminare e testare attentamente le applicazioni compilate nel contesto dei casi d'uso specifici e di prendere tutte le decisioni e le personalizzazioni appropriate. Ciò include l'implementazione di mitigazioni di intelligenza artificiale responsabili, ad esempio metaprompt, filtri di contenuto o altri sistemi di sicurezza, e garantire che le applicazioni soddisfino gli standard di qualità, affidabilità, sicurezza e attendibilità appropriati. Per altre informazioni, vedere la nota sulla trasparenza Azure AI Search.

Una fonte di conoscenza Work IQ (anteprima) collega Work IQ a una pipeline di recupero agentico in Azure AI Search. Le origini delle informazioni vengono create in modo indipendente, a cui viene fatto riferimento in una Knowledge Base e usate come dati di base quando viene eseguita una query sulla Knowledge Base in fase di esecuzione.

L'IQ aziendale espone l'intelligenza organizzativa dal contenuto Microsoft 365, inclusi documenti, messaggi di posta elettronica, riunioni e attività nelle app Microsoft 365.

A differenza delle fonti di conoscenza indicizzate, le fonti di conoscenza di Work IQ interrogano direttamente i dati in tempo reale al momento del recupero. Non è necessaria alcuna pipeline di inserimento. Le interrogazioni richiedono un token di accesso per l'utente finale, che il motore di recupero dati utilizza per chiamare Work IQ per conto del chiamante.

Avvertimento

In questa anteprima, una fonte di conoscenza di Work IQ potrebbe utilizzare funzionalità di Work IQ che eseguono azioni, non solo recuperano informazioni. Usarlo con attenzione, limitare l'accesso a applicazioni e utenti attendibili ed esaminare le autorizzazioni e i controlli di governance dello scenario prima di abilitarlo.

Supporto per l'utilizzo

Portale di Azure Portale di Microsoft Foundry .NET SDK PYTHON SDK JAVA SDK JavaScript SDK API REST
❌ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

Prerequisiti

  • Servizio di Ricerca con intelligenza artificiale di Azure disponibile in qualsiasi area che supporta il recupero tramite agenti autonomi.

  • Ogni utente finale che interroga tramite questa origine dati di conoscenza deve disporre di una licenza Microsoft 365 Copilot.

  • Il servizio Azure AI Search, l'ambiente di IQ aziendale e gli utenti finali devono trovarsi nello stesso tenant Microsoft Entra. Il recupero tra tenant non è supportato.

  • È stato autorizzato l'accesso al recupero dei dati da Work IQ tramite Azure AI Search. Per ulteriori informazioni, vedi Richiedere l'accesso al recupero di Work IQ.

  • Autorizzazioni per la creazione di origini delle informazioni. Configurare l'autenticazione senza chiave con il ruolo Collaboratore servizio di ricerca assegnato all'account utente (scelta consigliata) o usare una chiave API.

  • Pacchetto di anteprima Azure.Search.Documents più recente: dotnet add package Azure.Search.Documents --prerelease

Richiedi l'accesso a Work IQ Retrieval

Il recupero di Work IQ con Azure AI Search è disattivato per impostazione predefinita e richiede una richiesta approvata da Microsoft prima dell'utilizzo.

Per richiedere l'accesso:

  1. Registra il flag di funzionalità EnableFoundryIQWithWorkIQ per la tua sottoscrizione di Azure.

    az feature register --namespace Microsoft.Search --name EnableFoundryIQWithWorkIQ --subscription "<your-subscription-guid>"

  2. Registrare nuovamente il provider di risorse Microsoft.Search.

    az provider register -n Microsoft.Search --subscription "<your-subscription-guid>"

  3. Chiedere a un amministratore di Microsoft Entra per il tenant di inviare il modulo di richiesta di accesso Work IQ access request form.

  4. Attendere che Microsoft abiliti l'accesso dopo aver esaminato e approvato la richiesta.

    Tip

    La registrazione di una funzionalità di anteprima richiede il ruolo predefinito Owner o Contributor per la sottoscrizione, distinto dal ruolo dell'amministratore Microsoft Entra che invia il modulo. Le due responsabilità possono essere tenute da persone diverse nell'organizzazione. Per altre informazioni sul meccanismo di registrazione, vedere Impostare le funzionalità di anteprima nella sottoscrizione Azure.

Governance e conformità dei dati

Work IQ opera interamente all'interno del confine di trust di Microsoft 365. Gli impegni seguenti si applicano quando si instradano le richieste dell'agente tramite IQ aziendale.

Residenza dei dati

Work IQ recupera i dati dal tenant Microsoft 365 dell'organizzazione. Durante il recupero dei dati, questi non escono dal tuo tenant né superano i confini regionali. La posizione dei dati segue la configurazione di residenza dei dati del tenant Microsoft 365, non l'area del servizio Azure AI Search. Per informazioni dettagliate, vedere Data, privacy e sicurezza per Microsoft 365 Copilot.

Privacy e gestione dei dati

Tutte le richieste IQ aziendali sono regolate da Data, privacy e sicurezza per Microsoft 365 Copilot. Impegni chiave:

  • Work IQ non utilizza i contenuti dei clienti per addestrare o migliorare i modelli di IA sottostanti.

Controllo dell'accesso e autorizzazioni

L'IQ aziendale applica automaticamente le autorizzazioni Microsoft 365 per ogni richiesta. Gli agenti possono accedere solo ai dati che l'utente connesso è già autorizzato a visualizzare. Non è possibile elevare i privilegi.

  • Vengono rispettati il controllo degli accessi in base al ruolo, le etichette di riservatezza e le barriere informative definite in Microsoft 365.

Certificazioni per la conformità

Work IQ eredita le certificazioni di conformità di Microsoft 365. Per informazioni dettagliate, vedere Data, privacy e sicurezza per Microsoft 365 Copilot.

Verificare la presenza di fonti di conoscenza esistenti

Un'origine delle conoscenze è un oggetto riutilizzabile di primo livello. Conoscere le origini conoscenze esistenti è utile per riutilizzare o denominare nuovi oggetti.

Eseguire il codice seguente per elencare le origini delle informazioni in base al nome e al tipo.

// List knowledge sources by name and type
using Azure.Search.Documents.Indexes;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);
var knowledgeSources = indexClient.GetKnowledgeSourcesAsync();

Console.WriteLine("Knowledge Sources:");

await foreach (var ks in knowledgeSources)
{
    Console.WriteLine($"  Name: {ks.Name}, Type: {ks.GetType().Name}");
}

Reference:SearchIndexClient

# List knowledge sources by name and type
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))

for ks in index_client.list_knowledge_sources():
    print(f"  - {ks.name} ({ks.kind})")

Reference:SearchIndexClient

### List knowledge sources by name and type
GET {{search-url}}/knowledgesources?api-version={{api-version}}&$select=name,kind
api-key: {{api-key}}

Reference:Knowledge Sources - List

Puoi anche restituire una singola fonte di conoscenza per nome per esaminarne la definizione JSON.

using Azure.Search.Documents.Indexes;
using System.Text.Json;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);

// Specify the knowledge source name to retrieve
string ksNameToGet = "earth-knowledge-source";

// Get its definition
var knowledgeSourceResponse = await indexClient.GetKnowledgeSourceAsync(ksNameToGet);
var ks = knowledgeSourceResponse.Value;

// Serialize to JSON for display
var jsonOptions = new JsonSerializerOptions 
{ 
    WriteIndented = true,
    DefaultIgnoreCondition = System.Text.Json.Serialization.JsonIgnoreCondition.Never
};
Console.WriteLine(JsonSerializer.Serialize(ks, ks.GetType(), jsonOptions));

Reference:SearchIndexClient

# Get a knowledge source definition
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient
import json

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))

ks = index_client.get_knowledge_source("knowledge_source_name")
print(json.dumps(ks.as_dict(), indent = 2))

Reference:SearchIndexClient

### Get a knowledge source definition
GET {{search-url}}/knowledgesources/{{knowledge-source-name}}?api-version={{api-version}}
api-key: {{api-key}}

Reference:Fonti di Conoscenza - Ottieni

Il seguente JSON è un esempio di risposta per una fonte di conoscenza di Work IQ.

{
  "name": "my-workiq-ks",
  "kind": "workIQ",
  "description": "A sample Work IQ knowledge source.",
  "encryptionKey": null
}

Creare una fonte di conoscenza

Esegui il codice seguente per creare una fonte di conoscenza Work IQ.

using Azure;
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;

Uri searchEndpoint = new Uri("<search-service-url>");
AzureKeyCredential credential = new AzureKeyCredential("<api-key>");
var indexClient = new SearchIndexClient(searchEndpoint, credential);

var knowledgeSource = new WorkIQKnowledgeSource(name: "my-workiq-ks")
{
    Description = "A sample Work IQ knowledge source."
};

await indexClient.CreateOrUpdateKnowledgeSourceAsync(knowledgeSource);
Console.WriteLine($"Knowledge source '{knowledgeSource.Name}' created or updated successfully.");

Reference:SearchIndexClient

from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import WorkIQKnowledgeSource

index_client = SearchIndexClient(
    endpoint="<search-service-url>",
    credential=AzureKeyCredential("<api-key>")
)

knowledge_source = WorkIQKnowledgeSource(
    name="my-workiq-ks",
    description="A sample Work IQ knowledge source."
)

index_client.create_or_update_knowledge_source(knowledge_source=knowledge_source)
print(f"Knowledge source '{knowledge_source.name}' created or updated successfully.")

Reference:SearchIndexClient

### Create a Work IQ knowledge source
PUT {{search-url}}/knowledgesources/my-workiq-ks?api-version=2026-05-01-preview
api-key: {{api-key}}
Content-Type: application/json

{
  "name": "my-workiq-ks",
  "kind": "workIQ",
  "description": "A sample Work IQ knowledge source."
}

Riferimento:Fonti di conoscenza - Crea o Aggiorna

Assegnare a una knowledge base

Se si è soddisfatti dell'origine delle informazioni, aggiungerla a una Knowledge Base.

Eseguire una query su una base di conoscenza

Dopo aver configurato la base di conoscenza, richiamare l'azione retrieve o l'endpoint MCP per interrogare i contenuti di Work IQ. Questa fonte di conoscenza presenta caratteristiche specifiche nell'applicazione delle autorizzazioni al momento della query e nella risposta.

Importante

L'IQ aziendale può richiedere 40-60 secondi o più per rispondere. Per evitare errori di timeout, impostare maxRuntimeInSeconds nella richiesta di recupero su 120 o superiore.

Applicare le autorizzazioni al tempo di interrogazione

Le fonti di conoscenza di Work IQ utilizzano un flusso di token "on-behalf-of" (OBO). Si passa il token di accesso dell'utente finale nell'intestazione x-ms-query-source-authorization della richiesta di recupero. Il token deve essere associato al pubblico di Azure AI Search (https://search.azure.com/.default). Il motore di recupero scambia questo token con un token con ambito Work IQ e lo utilizza per eseguire query su Work IQ per conto dell'utente finale.

Per la richiesta di recupero è necessaria anche l'autenticazione standard Azure AI Search. Il x-ms-query-source-authorization token viene passato separatamente e non sostituisce l'autenticazione del servizio.

Per istruzioni sul passaggio del token, vedere Applicare le autorizzazioni in fase di query (anteprima).

Campi di risposta specifici dell'IQ di lavoro

Le fonti di conoscenza di Work IQ restituiscono i risultati nell'array references e la diagnostica delle query nell'array activity. Ogni voce di riferimento contiene:

  • sourceData.extracts[].text: Passaggi di testo basati su dati di Work IQ.
  • attributions[].seeMoreWebUrl: collegamento al documento di origine in Microsoft 365.

Nell'esempio seguente viene illustrata una risposta di recupero contenente un riferimento all'origine della knowledge base work IQ e il relativo record di attività corrispondente. Per indicazioni più ampie sull'interpretazione delle risposte recuperate, vedere Esaminare la risposta.

Tip

Per ottenere sourceData per i riferimenti, imposta includeReferenceSourceData su true nella voce dell'origine della conoscenza all'interno di knowledgeSourceParams nella richiesta di recupero.

{
  "response": [
      // ... Response omitted for brevity
  ],
  "activity": [
    {
      "type": "workIQ",
      "id": 0,
      "knowledgeSourceName": "my-workiq-ks",
      "queryTime": "2026-05-01T19:25:23.683Z",
      "count": 1,
      "elapsedMs": 1137,
      "workIQArguments": {
        "search": "my query"
      }
    },
    {
       // ... Additional activity records omitted for brevity       
    }
  ],
  "references": [
    {
      "type": "workIQ",
      "id": "83dd7d40",
      "activitySource": 0,
      "rerankerScore": 3.5,
      "attributions": [
        {
          "seeMoreWebUrl": "https://..."
        }
      ],
      "sourceData": {
        "extracts": [
          {
            "text": "Have your VPN username and password ready."
          }
        ]
      }
    },
    {
      // ... Additional references omitted for brevity
    }
  ]
}

Eliminare una fonte di conoscenza

Prima di poter eliminare una fonte di conoscenza, è necessario eliminare qualsiasi base di conoscenza che vi faccia riferimento o aggiornare la definizione della base di conoscenza per rimuovere il riferimento. Per le fonti di conoscenza che generano un indice e una pipeline di indicizzazione, vengono eliminati anche tutti gli oggetti generati. Tuttavia, se è stato usato un indice esistente per creare un'origine conoscenze, l'indice non viene eliminato.

Se si tenta di eliminare una fonte di conoscenza attualmente in uso, l'azione fallisce e restituisce un elenco delle basi di conoscenza interessate.

Per eliminare una fonte di conoscenza:

  1. Ottenere un elenco di tutte le knowledge base nel servizio di ricerca.

    using Azure.Search.Documents.Indexes;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);
var knowledgeBases = indexClient.GetKnowledgeBasesAsync();

Console.WriteLine("Knowledge Bases:");

await foreach (var kb in knowledgeBases)
{
    Console.WriteLine($"  - {kb.Name}");
}

    Reference:SearchIndexClient

    Una risposta di esempio potrebbe essere simile alla seguente:

     {
     "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
     "value": [
     {
         "name": "my-kb"
     },
     {
         "name": "my-kb-2"
     }
     ]
 }

  2. Ottenere una singola definizione della Knowledge Base per verificare la presenza di riferimenti all'origine della knowledge base.

    using Azure.Search.Documents.Indexes;
using System.Text.Json;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);

// Specify the knowledge base name to retrieve
string kbNameToGet = "earth-knowledge-base";

// Get a specific knowledge base definition
var knowledgeBaseResponse = await indexClient.GetKnowledgeBaseAsync(kbNameToGet);
var kb = knowledgeBaseResponse.Value;

// Serialize to JSON for display
string json = JsonSerializer.Serialize(kb, new JsonSerializerOptions { WriteIndented = true });
Console.WriteLine(json);

    Reference:SearchIndexClient

    Una risposta di esempio potrebbe essere simile alla seguente:

     {
   "Name": "earth-knowledge-base",
   "KnowledgeSources": [
     {
       "Name": "earth-knowledge-source"
     }
   ],
   "Models": [
     {}
   ],
   "RetrievalReasoningEffort": {},
   "OutputMode": {},
   "ETag": "\u00220x8DE278629D782B3\u0022",
   "EncryptionKey": null,
   "Description": null,
   "RetrievalInstructions": null,
   "AnswerInstructions": null
 }

  3. Eliminare la Knowledge Base o, se si dispone di più origini informazioni, aggiornare la Knowledge Base per rimuovere l'origine. Questo esempio mostra l'eliminazione.

    using Azure.Search.Documents.Indexes;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);

await indexClient.DeleteKnowledgeBaseAsync(knowledgeBaseName);
System.Console.WriteLine($"Knowledge base '{knowledgeBaseName}' deleted successfully.");

    Reference:SearchIndexClient

  4. Eliminare l'origine delle informazioni.

    await indexClient.DeleteKnowledgeSourceAsync(knowledgeSourceName);
System.Console.WriteLine($"Knowledge source '{knowledgeSourceName}' deleted successfully.");

    Reference:SearchIndexClient

  1. Ottenere un elenco di tutte le knowledge base nel servizio di ricerca.

    # Get knowledge bases
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))

print("Knowledge Bases:")
for kb in index_client.list_knowledge_bases():
    print(f"  - {kb.name}")

    Reference:SearchIndexClient

    Una risposta di esempio potrebbe essere simile alla seguente:

     {
     "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
     "value": [
     {
         "name": "my-kb"
     },
     {
         "name": "my-kb-2"
     }
     ]
 }

  2. Ottenere una singola definizione della Knowledge Base per verificare la presenza di riferimenti all'origine della knowledge base.

    # Get a knowledge base definition
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))
kb = index_client.get_knowledge_base("knowledge_base_name")
print(kb)

    Reference:SearchIndexClient

    Una risposta di esempio potrebbe essere simile alla seguente:

     {
   "name": "my-kb",
   "description": null,
   "retrievalInstructions": null,
   "answerInstructions": null,
   "outputMode": null,
   "knowledgeSources": [
     {
       "name": "my-blob-ks",
     }
   ],
   "models": [],
   "encryptionKey": null,
   "retrievalReasoningEffort": {
     "kind": "low"
   }
 }

  3. Eliminare la Knowledge Base o, se si dispone di più origini informazioni, aggiornare la Knowledge Base per rimuovere l'origine. Questo esempio mostra l'eliminazione.

    # Delete a knowledge base
from azure.core.credentials import AzureKeyCredential 
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))
index_client.delete_knowledge_base("knowledge_base_name")
print(f"Knowledge base deleted successfully.")

    Reference:SearchIndexClient

  4. Eliminare l'origine delle informazioni.

    # Delete a knowledge source
from azure.core.credentials import AzureKeyCredential 
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))
index_client.delete_knowledge_source("knowledge_source_name")
print(f"Knowledge source deleted successfully.")

    Reference:SearchIndexClient

  1. Ottenere un elenco di tutte le knowledge base nel servizio di ricerca.

    ### Get knowledge bases
GET {{search-url}}/knowledgebases?api-version={{api-version}}&$select=name
api-key: {{api-key}}

    Reference:Knowledge Bases - List

    Una risposta di esempio potrebbe essere simile alla seguente:

     {
     "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
     "value": [
     {
         "name": "my-kb"
     },
     {
         "name": "my-kb-2"
     }
     ]
 }

  2. Ottenere una singola definizione della Knowledge Base per verificare la presenza di riferimenti all'origine della knowledge base.

    ### Get a knowledge base definition
GET {{search-url}}/knowledgebases/{{knowledge-base-name}}?api-version={{api-version}}
api-key: {{api-key}}

    Riferimento:Basi di conoscenza - Get

    Una risposta di esempio potrebbe essere simile alla seguente:

     {
   "name": "my-kb",
   "description": null,
   "retrievalInstructions": null,
   "answerInstructions": null,
   "outputMode": null,
   "knowledgeSources": [
     {
       "name": "my-blob-ks",
     }
   ],
   "models": [],
   "encryptionKey": null,
   "retrievalReasoningEffort": {
     "kind": "low"
   }
 }

  3. Eliminare la Knowledge Base o, se si dispone di più origini informazioni, aggiornare la Knowledge Base per rimuovere l'origine. Questo esempio mostra l'eliminazione.

    ### Delete a knowledge base
DELETE {{search-url}}/knowledgebases/{{knowledge-base-name}}?api-version={{api-version}}
api-key: {{api-key}}

    Reference:Basi di conoscenza - Elimina

  4. Eliminare l'origine delle informazioni.

    ### Delete a knowledge source
DELETE {{search-url}}/knowledgesources/{{knowledge-source-name}}?api-version={{api-version}}
api-key: {{api-key}}

    Riferimento:Fonti di Conoscenza - Elimina

Contenuti correlati

  • Last updated on