Migrieren des Agent-Abrufcodes zur aktuellen Version

Wenn Sie von 2025-08-01-Preview migrieren, wird "Wissens-Agent" in "Knowledge Base" umbenannt, und mehrere Eigenschaften werden in verschiedene Objekte und Ebenen innerhalb einer Objektdefinition verschoben.

1. Aktualisieren sie searchIndex-Wissensquellen.
2. Aktualisieren Sie azureBlob-Wissensquellen.
3. Ersetzen Sie den Wissensagenten durch die Wissensbasis.
4. Aktualisieren Sie die Abrufanforderung, und senden Sie eine Abfrage, um Ihre Updates zu testen.
5. Clientcode aktualisieren.

Aktualisieren einer SearchIndex-Wissensquelle

Dieses Verfahren erstellt eine neue Kenntnisquelle für die Vorschauversion vom 2025-11-01 searchIndex auf derselben funktionalen Ebene wie die vorherige Version vom 2025-08-01. Der zugrunde liegende Index selbst erfordert keine Aktualisierungen.

1. Auflisten aller Wissensquellen anhand des Namens, um Ihre Wissensquelle zu finden.

   ### List all knowledge sources by name
   GET {{search-endpoint}}/knowledge-sources?api-version=2025-08-01-preview&$select=name
   api-key: {{api-key}}
   Content-Type: application/json
   

2. Rufen Sie die aktuelle Definition ab, um vorhandene Eigenschaften zu überprüfen.

   ### Get a specific knowledge source
   GET {{search-endpoint}}/knowledge-sources/search-index-ks?api-version=2025-08-01-preview
   api-key: {{api-key}}
   Content-Type: application/json
   

   Die Antwort sollte dem folgenden Beispiel ähneln.

   {
        "name": "search-index-ks",
        "kind": "searchIndex",
        "description": "This knowledge source pulls from a search index created using the 2025-08-01-preview.",
        "encryptionKey": null,
        "searchIndexParameters": {
        "searchIndexName": "earth-at-night-idx",
        "sourceDataSelect": "id, page_chunk, page_number"
        },
        "azureBlobParameters": null
   }
   

3. Formulieren Sie eine Anforderung zum Erstellen von Wissensquellen als Grundlage für Ihre Migration.

   Beginnen Sie mit der 08-01-preview JSON.

   POST {{url}}/knowledge-sources/search-index-ks?api-version=2025-08-01-preview
   api-key: {{key}}
   Content-Type: application/json
   
   {
       "name": "search-index-ks",
       "kind": "searchIndex",
       "description": "A sample search index knowledge source",
       "encryptionKey": null,
       "searchIndexParameters": {
           "searchIndexName": "my-search-index",
           "sourceDataSelect": "id, page_chunk, page_number"
     }
   }
   

   Nehmen Sie die folgenden Updates für eine 2025-11-01-Vorschaumigration vor:

   • Geben Sie der Wissensquelle einen neuen Namen.

   • Ändern Sie die API-Version in 2025-11-01-preview.

   • Benennen Sie sourceDataSelect in sourceDataFields um und ändern Sie die Zeichenfolge in ein Array mit Namen-Wert-Paaren für jedes abrufbare Feld, das Sie abfragen möchten. Dies sind die Felder, die in den Suchergebnissen zurückgegeben werden sollen, ähnlich einer select Klausel in einer klassischen Abfrage.

4. Überprüfen Sie Ihre Aktualisierungen, und senden Sie dann die Anforderung, um das Objekt zu erstellen.

   PUT {{url}}/knowledge-sources/search-index-ks-11-01?api-version=2025-11-01-preview
   api-key: {{key}}
   Content-Type: application/json
   
   {
       "name": "search-index-ks-11-01",
       "kind": "searchIndex",
       "description": "knowledge source migrated to 2025-11-01-preview",
       "encryptionKey": null,
       "searchIndexParameters": {
           "searchIndexName": "my-search-index",
           "sourceDataFields": [
               { "name": "id" }, { "name": "page_chunk" }, { "name": "page_number" }
           ]
       }
   }
   

Sie verfügen jetzt über eine migrierte searchIndex Wissensquelle, die abwärtskompatibel mit der vorherigen Version ist, indem Sie die richtigen Eigenschaftenspezifikationen für die Vorschau 2025-11-01 verwenden.

Die Antwort enthält die vollständige Definition des neuen Objekts. Weitere Informationen zu neuen Eigenschaften, die diesem Wissensquelltyp zur Verfügung stehen, den Sie jetzt über Updates ausführen können, finden Sie unter How to create a search index knowledge source.

Aktualisieren einer AzureBlob-Wissensquelle

Dieses Verfahren erstellt eine neue Kenntnisquelle für die Vorschauversion vom 2025-11-01 azureBlob auf derselben funktionalen Ebene wie die vorherige Version vom 2025-08-01. Es erstellt eine neue Gruppe von generierten Objekten: Datenquelle, Skillset, Indexer, Index.

1. Auflisten aller Wissensquellen anhand des Namens, um Ihre Wissensquelle zu finden.

   ### List all knowledge sources by name
   GET {{search-endpoint}}/knowledge-sources?api-version=2025-08-01-preview&$select=name
   api-key: {{api-key}}
   Content-Type: application/json
   

2. Rufen Sie die aktuelle Definition ab, um vorhandene Eigenschaften zu überprüfen.

   ### Get a specific knowledge source
   GET {{search-endpoint}}/knowledge-sources/azure-blob-ks?api-version=2025-08-01-preview
   api-key: {{api-key}}
   Content-Type: application/json
   

   Die Antwort sieht möglicherweise ähnlich aus wie im folgenden Beispiel, wenn Ihr Workflow ein Modell enthält. Beachten Sie, dass eine Antwort die Namen der generierten Objekte enthält. Diese Objekte sind vollständig unabhängig von der Wissensquelle und bleiben auch dann funktionsfähig, wenn Sie deren Wissensquelle aktualisieren oder löschen.

    {
      "name": "azure-blob-ks",
      "kind": "azureBlob",
      "description": "A sample azure blob knowledge source.",
      "encryptionKey": null,
      "searchIndexParameters": null,
      "azureBlobParameters": {
        "connectionString": "<redacted>",
        "containerName": "blobcontainer",
        "folderPath": null,
        "disableImageVerbalization": false,
        "identity": null,
        "embeddingModel": {
          "name": "embedding-model",
          "kind": "azureOpenAI",
          "azureOpenAIParameters": {
            "resourceUri": "<redacted>",
            "deploymentId": "text-embedding-3-large",
            "apiKey": "<redacted>",
            "modelName": "text-embedding-3-large",
            "authIdentity": null
          },
          "customWebApiParameters": null,
          "aiServicesVisionParameters": null,
          "amlParameters": null
        },
        "chatCompletionModel": {
          "kind": "azureOpenAI",
          "azureOpenAIParameters": {
            "resourceUri": "<redacted>",
            "deploymentId": "gpt-4o-mini",
            "apiKey": "<redacted>",
            "modelName": "gpt-4o-mini",
            "authIdentity": null
          }
    },
        "ingestionSchedule": null,
        "createdResources": {
          "datasource": "azure-blob-ks-datasource",
          "indexer": "azure-blob-ks-indexer",
          "skillset": "azure-blob-ks-skillset",
          "index": "azure-blob-ks-index"
        }
      }
    }
   

3. Formulieren Sie eine Anforderung zum Erstellen von Wissensquellen als Grundlage für Ihre Migration.

   Beginnen Sie mit der 08-01-preview JSON.

   POST {{url}}/knowledge-sources/azure-blob-ks?api-version=2025-08-01-preview
   api-key: {{key}}
   Content-Type: application/json
   
   {
       "name": "azure-blob-ks",
       "kind": "azureBlob",
       "description": "A sample azure blob knowledge source.",
       "encryptionKey": null,
       "azureBlobParameters": {
           "connectionString": "<redacted>",
           "containerName": "blobcontainer",
           "folderPath": null,
           "disableImageVerbalization": false,
           "identity": null,
           "embeddingModel": {
               "name": "embedding-model",
               "kind": "azureOpenAI",
               "azureOpenAIParameters": {
               "resourceUri": "<redacted>",
               "deploymentId": "text-embedding-3-large",
               "apiKey": "<redacted>",
               "modelName": "text-embedding-3-large",
               "authIdentity": null
               },
               "customWebApiParameters": null,
               "aiServicesVisionParameters": null,
               "amlParameters": null
           },
           "chatCompletionModel": null,
           "ingestionSchedule": null
     }
   }
   

   Nehmen Sie die folgenden Updates für eine 2025-11-01-Vorschaumigration vor:

   • Geben Sie der Wissensquelle einen neuen Namen.

   • Ändern Sie die API-Version in 2025-11-01-preview.

   • Fügen Sie ingestionParameters als Container für die folgenden untergeordneten Eigenschaften hinzu: "embeddingModel", "chatCompletionModel", "ingestionSchedule", "contentExtractionMode".

4. Überprüfen Sie Ihre Aktualisierungen, und senden Sie dann die Anforderung, um das Objekt zu erstellen. Neue generierte Objekte werden für die Indexerpipeline erstellt.

   PUT {{url}}/knowledge-sources/azure-blob-ks-11-01?api-version=2025-11-01-preview
   api-key: {{key}}
   Content-Type: application/json
   
   {
       "name": "azure-blob-ks",
       "kind": "azureBlob",
       "description": "A sample azure blob knowledge source",
       "encryptionKey": null,
       "azureBlobParameters": {
           "connectionString": "{{blob-connection-string}}",
           "containerName": "blobcontainer",
           "folderPath": null,
           "ingestionParameters": {
               "embeddingModel": {
                   "kind": "azureOpenAI",
                   "azureOpenAIParameters": {
                       "deploymentId": "text-embedding-3-large",
                       "modelName": "text-embedding-3-large",
                       "resourceUri": "{{aoai-endpoint}}",
                       "apiKey": "{{aoai-key}}"
                   }
               },
               "chatCompletionModel": null,
               "disableImageVerbalization": false,
               "ingestionSchedule": null,
               "contentExtractionMode": "minimal"
           }
       }
   }
   

Sie verfügen jetzt über eine migrierte azureBlob Wissensquelle, die abwärtskompatibel mit der vorherigen Version ist, wobei die richtigen Eigenschaftsspezifikationen für die Vorschau 2025-11-01 verwendet werden.

Die Antwort enthält die vollständige Definition des neuen Objekts. Weitere Informationen zu neuen Eigenschaften, die diesem Wissensquelltyp zur Verfügung stehen, den Sie jetzt über Updates ausführen können, finden Sie unter How to create an Azure Blob knowledge source.

Ersetzen von Wissensagenten durch Knowledge Base

1. Wissensbasen erfordern eine Wissensquelle. Stellen Sie sicher, dass Sie über eine Wissensquelle verfügen, die auf 2025-11-01-preview ausgerichtet ist, bevor Sie beginnen.

2. Rufen Sie die aktuelle Definition ab, um vorhandene Eigenschaften zu überprüfen.

   ### Get a knowledge agent by name
   GET {{search-endpoint}}/agents/earth-at-night?api-version=2025-08-01-preview
   api-key: {{api-key}}
   Content-Type: application/json
   

   Die Antwort sieht möglicherweise ähnlich wie im folgenden Beispiel aus.

   {
     "name": "earth-at-night",
     "description": "A sample knowledge agent that retrieves from the earth-at-night knowledge source.",
     "retrievalInstructions": null,
     "requestLimits": null,
     "encryptionKey": null,
     "knowledgeSources": [
       {
         "name": "earth-at-night",
         "alwaysQuerySource": null,
         "includeReferences": null,
         "includeReferenceSourceData": null,
         "maxSubQueries": null,
         "rerankerThreshold": 2.5
       }
     ],
     "models": [
       {
         "kind": "azureOpenAI",
         "azureOpenAIParameters": {
           "resourceUri": "<redacted>",
           "deploymentId": "gpt-5-mini",
           "apiKey": "<redacted>",
           "modelName": "gpt-5-mini",
           "authIdentity": null
         }
       }
     ],
     "outputConfiguration": {
       "modality": "answerSynthesis",
       "answerInstructions": null,
       "attemptFastPath": false,
       "includeActivity": null
     }
   }
   

3. Formulieren Sie eine Create Knowledge Base-Anforderung als Grundlage für Ihre Migration.

   Beginnen Sie mit der 08-01-preview JSON.

   PUT {{url}}/knowledgebases/earth-at-night?api-version=2025-08-01-preview  HTTP/1.1
   api-key: {{key}}
   Content-Type: application/json
   
   {
       "name": "earth-at-night",
       "description": "A sample knowledge agent that retrieves from the earth-at-night knowledge source.",
       "retrievalInstructions": null,
       "encryptionKey": null,
       "knowledgeSources": [
           {
             "name": "earth-at-night",
             "alwaysQuerySource": null,
             "includeReferences": null,
             "includeReferenceSourceData": null,
             "maxSubQueries": null,
             "rerankerThreshold": 2.5
           }
       ],
       "models": [
           {
               "kind": "azureOpenAI",
               "azureOpenAIParameters": {
                   "resourceUri": "<redacted>",
                   "apiKey": "<redacted>",
                   "deploymentId": "gpt-5-mini",
                   "modelName": "gpt-5-mini"
               }
           }
       ],
       "outputConfiguration": {
           "modality": "answerSynthesis"
       }
   }
   

   Nehmen Sie die folgenden Updates für eine 2025-11-01-Vorschaumigration vor:

   • Ersetzen Sie den Endpunkt: /knowledgebases/{{your-object-name}}. Geben Sie der Wissensbasis einen eindeutigen Namen.

   • Ändern Sie die API-Version in 2025-11-01-preview.

   • requestLimitslöschen . Die maxRuntimeInSeconds Eigenschaften und maxOutputSize Eigenschaften werden jetzt direkt für das Abrufanforderungsobjekt angegeben.

   • Aktualisieren Sie knowledgeSources:

     • Löschen Sie maxSubQueries und ersetzen Sie es durch „retrievalReasoningEffort“ (siehe Festlegen des Abrufbegründungsaufwands).

     • Verschieben Sie alwaysQuerySource, includeReferenceSourceData, includeReferences und rerankerThreshold in den knowledgeSourcesParams-Abschnitt einer Abrufaktion.

   • Keine Änderungen für models.

   • Aktualisieren Sie outputConfiguration:

     • Ersetzen Sie outputConfiguration durch outputMode.

     • attemptFastPathlöschen . Es ist nicht mehr vorhanden. Das entsprechende Verhalten wird durch Festlegen von retrievalReasoningEffort auf ein Minimum implementiert (siehe Festlegen des Abrufbegründungsaufwands).

     • Wenn die Modalität auf answerSynthesis festgelegt ist, stellen Sie sicher, dass der Abrufbegründungsaufwand auf "Niedrig" (Standard) oder "Medium" festgelegt ist.

   • Fügen Sie ingestionParameters als Anforderung zum Erstellen einer Azure Blob-Wissensquelle in „2025-11-01-preview“ hinzu.

4. Überprüfen Sie Ihre Aktualisierungen, und senden Sie dann die Anforderung, um das Objekt zu erstellen. Neue generierte Objekte werden für die Indexerpipeline erstellt.

    PUT {{url}}/knowledgebases/earth-at-night-11-01?api-version={{api-version}}
    api-key: {{key}}
    Content-Type: application/json
   
    {
      "name": "earth-at-night-11-01",
      "description": "A sample knowledge base at the same functional level as the previous knowledge agent.",
      "retrievalInstructions": null,
      "encryptionKey": null,
      "knowledgeSources": [
        {
            "name": "earth-at-night-ks"
        }
      ],
      "models": [
        {
          "kind": "azureOpenAI",
          "azureOpenAIParameters": {
              "resourceUri": "<redacted>",
              "apiKey": "<redacted>",
              "deploymentId": "gpt-5-mini",
              "modelName": "gpt-5-mini"
            }
        }
      ],
      "retrievalReasoningEffort": null,
      "outputMode": "answerSynthesis",
      "answerInstructions": "Provide a concise and accurate answer based on the retrieved information.",
   
    }
   

Sie verfügen jetzt über eine Wissensbasis anstelle eines Wissens-Agents, und das Objekt ist abwärtskompatibel mit der vorherigen Version.

Die Antwort enthält die vollständige Definition des neuen Objekts. Weitere Informationen zu neuen Eigenschaften, die einer Knowledge Base zur Verfügung stehen, die Sie jetzt über Updates ausführen können, finden Sie unter How to create a knowledge base.

Aktualisieren und Testen der Abruffunktion für 2025-11-01-Vorschauversion-Updates

Die Abrufanforderung wurde für „2025-11-01-preview“ geändert, um mehr Formen zu unterstützen, einschließlich einer einfacheren Anforderung, die die LLM-Verarbeitung minimiert. Weitere Informationen zum Abrufen in dieser Vorschau finden Sie unter Abrufen von Daten mithilfe einer Knowledge Base. In diesem Abschnitt wird erläutert, wie Sie Ihren Code aktualisieren.

1. Ändern Sie den /agents/retrieve Endpunkt in /knowledgebases/retrieve.

2. Ändern Sie die API-Version in 2025-11-01-preview.

3. Es sind keine Änderungen an messages erforderlich, wenn Sie low oder medium als „retrievalReasoningEffort“ verwenden. Ersetzen Sie Nachrichten durch intent, wenn Sie minimal Raisonnement verwenden (siehe Einstellung des Abrufansatzes).

4. Ändern Sie knowledgeSourceParams, um alle Eigenschaften einzuschließen, die aus dem Agenten entfernt wurden: rerankerThreshold, alwaysQuerySource, includeReferenceSourceData, includeReferences.

5. Fügen Sie die Einstellung retrievalReasoningEffort zu minimum hinzu, wenn Sie attemptFastPath verwendet haben. Wenn Sie maxSubQueries verwendet haben, ist es nicht mehr vorhanden. Verwenden Sie die retrievalReasoningEffort Einstellung, um die Verarbeitung von Unterabfragen anzugeben (siehe Festlegen der Bemühung für die Abrufbegründung).

Um die Ausgabe Ihrer Wissensdatenbank mit einer Abfrage zu testen, verwenden Sie Version „2025-11-01-preview“ der Retrieve-Methode für den Wissensabruf (REST-API).

### Send a query to the knowledge base
POST {{url}}/knowledgebases/earth-at-night-11-01/retrieve?api-version=2025-11-01-preview
api-key: {{key}}
Content-Type: application/json

{
    "messages": [
        {
            "role": "user",
            "content": [
                { "type": "text", "text": "What are some light sources on the ocean at night" }
            ]
        }
    ],
    "includeActivity": true,
    "retrievalReasoningEffort": { "kind": "medium" },
    "outputMode": "answerSynthesis",
    "maxRuntimeInSeconds": 30,
    "maxOutputSize": 6000
}

Wenn die Antwort über einen 200 OK HTTP-Code verfügt, hat Ihre Wissensdatenbank Inhalte erfolgreich aus der Wissensquelle abgerufen.

Aktualisieren Sie den Code und die Clients für 2025-11-01-preview

Führen Sie die folgenden Bereinigungsschritte aus, um die Migration abzuschließen:

1. Aktualisieren Sie Clients nur für Azure Blob-Wissensquellen, um den neuen Index zu verwenden. Wenn Sie Über Code oder Skript verfügen, der einen Indexer ausführt oder auf eine Datenquelle, einen Index oder ein Skillset verweist, stellen Sie sicher, dass Sie die Verweise auf die neuen Objekte aktualisieren.

2. Ersetzen Sie alle Agentverweise durch knowledgeBases in Konfigurationsdateien, Code, Skripts und Tests.

3. Aktualisieren Sie die Client-Anforderungen, um die Vorschauversion vom 2025-11-01 zu verwenden.

4. Löschen oder generieren Sie zwischengespeicherte Definitionen, die mit den alten Shapes erstellt wurden.

Wenn Sie einen Wissens-Agent mit 2025-05-01-preview erstellt haben, enthält die Definition Ihres Agents ein Inlinearray targetIndexes und eine optionale defaultMaxDocsForReranker-Eigenschaft.

Ab 2025-08-01-preview wird targetIndexes durch wiederverwendbare Wissensquellen ersetzt und defaultMaxDocsForReranker nicht mehr unterstützt. Aufgrund dieser Breaking Changes müssen Sie folgende Schritte ausführen:

1. Rufen Sie die aktuelle targetIndexes-Konfiguration ab.
2. Erstellen Sie eine gleichwertige Wissensquelle.
3. Aktualisieren Sie den Agent, damit er knowledgeSources anstelle von targetIndexes verwendet.
4. Senden Sie eine Abfrage, um den Abruf zu testen.
5. Entfernen Sie Code, der targetIndexes verwendet, und aktualisieren Sie Clients.

Erhalten der aktuellen Konfiguration

Um die Definition Ihres Agents abzurufen, verwenden Sie die Version 2025-05-01-preview der Get-Methode für Wissens-Agents (REST-API).

@search-url = <YourSearchServiceUrl>
@agent-name = <YourAgentName>
@api-key = <YourApiKey>

### Get agent definition
GET https://{{search-url}}/agents/{{agent-name}}?api-version=2025-05-01-preview  HTTP/1.1
    api-key: {{api-key}}

Die Antwort sollte dem folgenden Beispiel ähneln. Kopieren Sie die Werte indexName, defaultRerankerThreshold und defaultIncludeReferenceSourceData zur Verwendung in den nächsten Schritten. defaultMaxDocsForReranker ist veraltet, sodass Sie den Wert ignorieren können.

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "my-knowledge-agent",
  "description": "My description of the agent",
  "targetIndexes": [
    {
      "indexName": "my-index", // Copy this value
      "defaultRerankerThreshold": 2.5, // Copy this value
      "defaultIncludeReferenceSourceData": true, // Copy this value
      "defaultMaxDocsForReranker": 100
    }
  ],
  ... // Redacted for brevity
}

Erstellen einer Wissensquelle

Verwenden Sie zum Erstellen einer searchIndex-Wissensquelle die Version 2025-08-01-preview der Create-Methode für Wissensquellen (REST-API). Legen Sie searchIndexName auf den Wert fest, den Sie zuvor kopiert haben.

@source-name = <YourSourceName>

### Create a knowledge source
PUT https://{{search-url}}/knowledgeSources/{{source-name}}?api-version=2025-08-01-preview  HTTP/1.1
    Content-Type: application/json
    api-key: {{api-key}}
    
    {
        "name": "{{source-name}}",
        "description": "My description of the knowledge source",
        "kind": "searchIndex",
        "searchIndexParameters": {
            "searchIndexName": "my-index" // Use the previous value
        }
    }

In diesem Beispiel wird eine Wissensquelle erstellt, die einen Index darstellt. Sie können jedoch auch mehrere Indizes oder einen Azure-Blob als Ziel auswählen. Weitere Informationen finden Sie unter Erstellen einer Wissensquelle.

Aktualisieren des Agents

Um targetIndexes in der Definition Ihres Agents durch knowledgeSources zu ersetzen, verwenden Sie die Version 2025-08-01-preview der Create- oder Update-Methode für Wissensquellen (REST-API). Legen Sie rerankerThreshold und includeReferenceSourceData auf die Werte fest, die Sie zuvor kopiert haben.

### Replace targetIndexes with knowledgeSources
POST https://{{search-url}}/agents/{{agent-name}}?api-version=2025-08-01-preview  HTTP/1.1
    Content-Type: application/json
    api-key: {{api-key}}

    { 
        "name": "{{agent-name}}", 
        "knowledgeSources": [  
            {  
                "name": "{{source-name}}",
                "rerankerThreshold": 2.5, // Use the previous value
                "includeReferenceSourceData": true // Use the previous value
            }
        ]
    } 

In diesem Beispiel wird die Definition so aktualisiert, dass sie auf eine Wissensquelle verweist, Sie können jedoch mehrere Wissensquellen als Ziel auswählen. Sie können auch andere Eigenschaften verwenden, um das Abrufverhalten zu steuern, z. B. alwaysQuerySource. Weitere Informationen finden Sie unter Erstellen eines Wissens-Agents.

Abruf der 2025-08-01-Preview-Updates testen

Um die Ausgabe Ihres Agents mit einer Abfrage zu testen, verwenden Sie die Version 2025-08-01-preview der Retrieve-Methode für den Wissensabruf (REST-API).

### Send a query to the agent
POST https://{{search-url}}/agents/{{agent-name}}/retrieve?api-version=2025-08-01-preview  HTTP/1.1
    Content-Type: application/json
    api-key: {{api-key}}
        
    {
      "messages": [
            {
                "role": "user",
                "content" : [
                    {
                        "text": "<YourQueryText>",
                        "type": "text"
                    }
                ]
            }
        ]
    }

Wenn die Antwort den HTTP-Code 200 OK enthält, hat Ihr Agent erfolgreich Inhalte aus der Wissensquelle abgerufen.

Aktualisierung von Code und Clients für 2025-08-01-Preview

Führen Sie die folgenden Bereinigungsschritte aus, um die Migration abzuschließen:

• Ersetzen Sie in Konfigurationsdateien, Code, Skripts und Tests alle Verweise auf targetIndexes durch knowledgeSources.
• Aktualisieren Sie Clientaufrufe zur Verwendung von 2025-08-01-preview.
• Löschen Sie zwischengespeicherte Agentdefinitionen, die mit der alten Form erstellt wurden, oder generieren Sie sie erneut.

• Der Wissens-Agent wird in die Knowledge Base umbenannt.

  Vorherige Route	Neue Route
  /agents	/knowledgebases
  /agents/agent-name	/knowledgebases/knowledge-base-name
  /agents/agent-name/retrieve	/knowledgebases/knowledge-base-name/retrieve

• Der Wissens-Agent (Basis) outputConfiguration wird in outputMode umbenannt und von einem Objekt in einen Zeichenfolgen-Enumerator geändert. Mehrere Eigenschaften sind betroffen:

  • includeActivity wird von outputConfiguration direkt auf das Abrufanforderungsobjekt verschoben.
  • attemptFastPath in outputConfiguration wird vollständig entfernt. Der neue minimal-Begründungsaufwand ist der Ersatz.

• Wissens-Agent (Basis) requestLimits wird entfernt. Die untergeordneten Eigenschaften von maxRuntimeInSeconds und maxOutputSize werden direkt in das Abrufanforderungsobjekt verschoben.

• Wissens-Agent-Parameter (Basisparameter) knowledgeSources listen jetzt nur die Namen der von einer Wissensdatenbank verwendeten Wissensquelle auf. Andere untergeordnete Eigenschaften, die sich zuvor unter knowledgeSources befanden, werden in die Eigenschaften knowledgeSourceParams des Abrufanforderungsobjekts verschoben.

  • rerankerThreshold
  • alwaysQuerySource
  • includeReferenceSourceData
  • includeReferences

  Die maxSubQueries Eigenschaft ist nicht mehr vorhanden. Sein Ersatz ist die neue Abrufbegründungsaufwands-Eigenschaft.

• Abrufanforderungsobjekt des Wissens-Agents (Basis): Der semanticReranker Aktivitätsdatensatz wird durch den agenticReasoning Aktivitätsdatensatztyp ersetzt.

• Wissensquellen für beide azureBlob und searchIndex: Eigenschaften auf oberster Ebene für identity, embeddingModel, chatCompletionModel, disableImageVerbalizationund ingestionSchedule sind jetzt Teil eines ingestionParameters Objekts der Wissensquelle. Alle Wissensquellen, die aus einem Suchindex abgerufen werden, weisen ein ingestionParameters Objekt auf.

• Nur für searchIndex Wissensquellen: sourceDataSelect wird in sourceDataFields umbenannt und ist ein Array, das fieldName und fieldToSearch akzeptiert.

• Fügt Wissensquellen für OneLake, SharePoint (lokal), und SharePoint (remote) hinzu, die Inhalte direkt aus SharePoint, Web (Bing) abrufen, das Bing-Indizes verwendet.

• Alle Wissensquellen, die aus einem Suchindex abgerufen werden, verfügen über neue Erfassungsoptionen: ingestionPermissionOptions zur Unterstützung quellspezifischer Zugriffsmodelle, contentExtractionMode zur Aktivierung der Azure Content Understanding-Integration in Foundry Tools, aiServices-Endpunkt für Azure Content Understanding, wenn "contentExtractionMode": "minimal".

• Alle Wissensquellen, die aus einem Suchindex abgerufen werden, verfügen über einen status Vorgang, der den Synchronisierungsstatus der Wissensquelle mit ihrer Datenquelle zurückgibt.

• Die searchIndex-Wissensquelle fügt semanticConfigurationName hinzu, sodass die standardmäßige semantische Konfiguration außer Kraft gesetzt wird, die von der Abrufanforderung verwendet wird.

• Die searchIndex Wissensquelle fügt sourceDataFields hinzu und searchDataFields gibt an, welche Felder zur Abfragezeit verwendet und auch in einer Antwort zurückgegeben werden.

• Die Abfrageantworten der Basis-Wissens-Agenten geben jetzt HTTP 206-Statuscodes für Teil-Erfolg zurück. Abrufanforderungen haben jetzt eine optionale retrievalReasoningEffort-Eigenschaft, die die Ebenen der LLM-Verarbeitung angibt (siehe Festlegen des Abrufbegründungsaufwands).

• Der Wissens-Agent (Basis) fügt ein neues intent-Objekt für den minimal-Abrufbegründungsaufwand hinzu, wobei intent für das LLM messages ersetzt. Ein intent ist eine Abfragezeichenfolge, die direkt an die Suchmaschine übergeben wird, ohne dass ein Zwischenschritt für die LLM-Abfrageplanung erforderlich ist.

• Aktivitätsdatensätze in der Abrufantwort verfügen jetzt über eine optionale error Ausgabe, die angibt, ob die Aktivität einen fehlgeschlagenen Vorgang darstellt.

• Wissensquellen werden als neue Methode zum Definieren von Datenquellen eingeführt, und es werden sowohl searchIndex (ein oder mehrere Indizes) als auch azureBlob-Varianten unterstützt. Weitere Informationen finden Sie unter Erstellen einer Suchindex-Wissensquelle und Erstellen einer Blob-Wissensquelle.

• Anstelle von knowledgeSources muss targetIndexes in Agentdefinitionen verwendet werden. Die Migrationsschritte finden Sie unter Vorgehensweise zum Migrieren.

• defaultMaxDocsForReranker wird nicht mehr unterstützt. Diese Eigenschaft war zuvor in targetIndexes vorhanden, aber es gibt keinen Ersatz in knowledgeSources.

• Agentdefinitionen werden die Eigenschaften knowledgeSources, outputConfiguration und retrievalInstructions hinzugefügt. Informationen zu unterstützten Eigenschaften finden Sie unter Erstellen eines Wissens-Agents.

• defaultRerankerThreshold wird in rerankerThreshold und defaultIncludeReferenceSourceData in includeReferenceSourceData umbenannt. Diese Eigenschaften waren zuvor in targetIndexes vorhanden, werden jetzt jedoch in den einzelnen Wissensquellenverweisen in knowledgeSources angegeben.