Azure AI Search-verktyg

Azure AI Search-verktyget i Azure AI Foundry Agent Service ansluter en agent till ett nytt eller befintligt sökindex. Du kan använda det här verktyget för att hämta och sammanfatta dina indexerade dokument, med agentens svar som grund i ditt upphovsrättsskyddade innehåll.

Den här artikeln beskriver hur du konfigurerar Azure AI Search-verktyget, inklusive att skapa en projektanslutning och lägga till verktyget i din agent.

Förutsättningar

• En agent för Azure AI Foundry.

• Ett Azure AI Search-index som konfigurerats för vektorsökning. Indexet måste innehålla:

  • Ett eller flera Edm.String fält (text) markerade som sökbara och hämtningsbara.

  • Ett eller flera (vektor)fält Collection(Edm.Single) som betecknas som sökbara.

Användningsstöd

Begränsningar

• Om du vill använda Azure AI Search-verktyget i Azure AI Foundry-portalen bakom ett virtuellt nätverk måste du skapa en agent med hjälp av SDK eller REST API. När du har skapat agenten programmatiskt kan du sedan använda den i portalen.

• Azure AI Search-verktyget kan bara rikta in sig på ett index. Om du vill använda flera index bör du överväga att använda anslutna agenter, var och en med ett konfigurerat index.

• En Azure AI Foundry-resurs med grundläggande agentdistributioner stöder inte privata Azure AI Search-resurser eller Azure AI Search med offentlig nätverksåtkomst inaktiverad och en privat slutpunkt. Om du vill använda ett privat Azure AI Search-verktyg med dina agenter distribuerar du standardagenten med virtuell nätverksinmatning.

Setup

I det här avsnittet skapar du en anslutning mellan Azure AI Foundry-projektet som innehåller din agent och Azure AI Search-tjänsten som innehåller ditt index.

Om du redan har anslutit projektet till söktjänsten hoppar du över det här avsnittet.

Hämta anslutningsinformation för söktjänsten

Projektanslutningen kräver slutpunkten för söktjänsten och antingen nyckelbaserad autentisering eller nyckellös autentisering med Microsoft Entra-ID.

För nyckellös autentisering måste du aktivera rollbaserad åtkomstkontroll (RBAC) och tilldela roller till projektets hanterade identitet. Även om den här metoden omfattar extra steg, förbättrar den säkerheten genom att eliminera behovet av hårdkodade API-nycklar.

Välj fliken för önskad autentiseringsmetod.

Skapa projektanslutningen

Nästa steg är att skapa projektanslutningen med hjälp av söktjänstens information som du har samlat in. Anslutningsnamnet måste vara namnet på ditt sökindex. Mer information om det här steget finns i Lägga till en ny anslutning till projektet.

Välj fliken för önskad användningsmetod.

name: my_project_acs_connection_keys
type: azure_ai_search
endpoint: https://contoso.search.windows.net/
api_key: XXXXXXXXXXXXXXX

name: my_project_acs_connection_keyless
type: azure_ai_search
endpoint: https://contoso.search.windows.net/

az ml connection create --file {connection.yml} --resource-group {my_resource_group} --workspace-name {my_project_name}

from azure.ai.ml.entities import AzureAISearchConnection

# Create an Azure AI Search project connection
my_connection_name = "my-connection-name"
my_endpoint = "my-endpoint" # This could also be called target
my_api_keys = None # Leave blank for Authentication type = AAD

my_connection = AzureAISearchConnection(name=my_connection_name,
                                    endpoint=my_endpoint, 
                                    api_key= my_api_keys)

# Create the connection
ml_client.connections.create_or_update(my_connection)

Lägg till verktyget i en agent

Du kan lägga till Azure AI Search-verktyget i en agent programmatiskt eller via Azure AI Foundry-portalen. Programmässiga exempel finns i Använda ett befintligt index med Azure AI Search-verktyget.

Så här lägger du till verktyget via portalen:

1. I den vänstra rutan väljer du Agenter.

2. Välj din agent i listan och välj sedan Kunskap>Lägg till.

   

3. Välj Azure AI Search.

   

4. Under Anslut till ett index väljer du Index som inte ingår i det här projektet.

5. Under Azure AI Search-resursanslutning väljer du den projektanslutning som du skapade i föregående avsnitt.

6. Under Azure AI Search-index väljer du ditt vektorindex.

   Tip

   Om du inte har något index väljer du Skapa ett nytt index. Du uppmanas sedan att namnge indexet, ansluta till en datakälla, välja en befintlig inbäddningsmodelldistribution och godkänna villkoren.

   När du har skapat indexet kan du använda det både i och utanför din agent. Du kan till exempel använda indexet med REST API:er eller SDK:er för Azure AI Search.

7. Under Visningsnamn anger du namnet på ditt index.

8. Beroende på indexkonfigurationen väljer du någon av följande söktyper:

   • Simple
   • Semantisk
   • Vektor
   • Hybrid (vektor + nyckelord)
   • Hybrid + semantisk

   Som standard kör Azure AI Search-verktyget en hybridsökning (vektor + nyckelord) i alla textfält.

9. Välj Anslut för att lägga till Azure AI Search-verktyget i din agent.

   

Nästa steg

Prova några programmatiska exempel på hur du konfigurerar och använder Azure AI Search-verktyget: