Konfigurera din Azure AI-sökning-tjänst i Azure-portalen

Att konfigurera din nya Azure AI-sökning-tjänsten omfattar flera uppgifter för att optimera säkerhet, åtkomst och prestanda. Den här artikeln innehåller en checklista för dag ett som hjälper dig att konfigurera tjänsten i Azure-portalen.

När du har skapat en söktjänst rekommenderar vi att du:

Konfigurera rollbaserad åtkomst

Portalåtkomst baseras på rolltilldelningar. Som standard har nya söktjänster minst en tjänstadministratör eller ägare. Tjänstadministratörer, medadministratörer och ägare har behörighet att skapa fler administratörer och tilldela andra roller. De har också åtkomst till alla portalsidor och åtgärder på standardsöktjänster.

Varje söktjänst levereras med API-nycklar och använder nyckelbaserad autentisering som standard. Vi rekommenderar dock att du använder Microsoft Entra ID och rollbaserad åtkomstkontroll (RBAC) för bättre säkerhet. RBAC eliminerar behovet av att lagra och skicka API-nycklar i oformaterad text.

När du byter från nyckelbaserad autentisering till nyckellös autentisering måste tjänstadministratörer tilldela sig själva dataplansroller för fullständig åtkomst till objekt och data. De här rollerna inkluderar Search Service-bidragsgivare, Search Index Data-bidragsgivare och Search Index Data-läsare.

Så här konfigurerar du rollbaserad åtkomst:

1. Aktivera roller i söktjänsten. Vi rekommenderar att du använder både API-nycklar och roller.

2. Tilldela dataplansroller för att ersätta de funktioner som förlorats när du inaktiverar API-nycklar. En ägare behöver bara Search Index Data Reader, men utvecklare behöver fler roller.

   Rolltilldelningar kan ta flera minuter att börja gälla. Tills dess visar portalsidor som används för dataplansåtgärder följande meddelande:

   

3. Tilldela fler roller för lösningsutvecklare och appar.

Konfigurera en hanterad identitet

Om du planerar att använda indexerare för automatisk indexering, tillämpad AI eller integrerad vektorisering bör du konfigurera söktjänsten så att den använder en hanterad identitet. Du kan sedan tilldela roller på andra Azure tjänster som ger söktjänsten åtkomst till data och åtgärder.

För integrerad vektorisering behöver din söktjänstidentitet följande roller:

• Storage Blob Data Reader på Azure Storage
• Cognitive Services-dataanvändare på en Microsoft Foundry-resurs

Rolltilldelningar kan ta flera minuter att börja gälla.

Innan du går vidare till nätverkssäkerhet bör du överväga att testa alla anslutningsplatser för att verifiera rolltilldelningar. Kör en importguide för att testa behörigheter.

Konfigurera nätverkssäkerhet

Som standard accepterar en söktjänst autentiserade och auktoriserade begäranden via offentliga Internetanslutningar. Du har två alternativ för att förbättra nätverkssäkerheten:

• Konfigurera brandväggsregler för att begränsa nätverksåtkomsten med IP-adress.
• Konfigurera en privat slutpunkt för att endast tillåta trafik från Azure virtuella nätverk. Observera att guiden Importera data inte kommer att köras när du stänger av den offentliga slutpunkten.

Mer information om inkommande och utgående anrop i Azure AI-sökning finns i Förstå nätverkstrafikmönster.

Kontrollera kapacitet och förstå fakturering

Som standard skapas en söktjänst med en replik och en partition. Du kan lägga till kapacitet genom att lägga till repliker och partitioner, men vi rekommenderar att du väntar tills volymerna kräver det. Många kunder kör produktionsarbetsbelastningar med minsta möjliga konfiguration.

Semantisk ranker och agentisk hämtning är premiumfunktioner som är standard för den kostnadsfria planen. Om du behöver betald användning utöver den kostnadsfria ersättningen kan du läsa Aktivera eller inaktivera semantisk rankningsfakturering och Aktivera eller inaktivera fakturering för agentisk hämtning.

Mer information om andra funktioner som påverkar fakturering finns i Planera och hantera kostnader för en Azure AI-sökning tjänst.

Aktivera diagnostikloggning

Aktivera diagnostikloggning för att spåra användaraktivitet. Om du hoppar över det här steget får du fortfarande aktivitetsloggar och plattformsmått automatiskt. Men om du vill ha information om index- och frågeanvändning bör du aktivera diagnostikloggning och välja ett mål för loggade åtgärder. Vi rekommenderar Log Analytics Arbetsyta för varaktig lagring så att du kan köra systemfrågor i Azure portalen.

Internt samlar Microsoft in telemetridata om din tjänst och plattformen. Mer information om datakvarhållning finns i Kvarhållning av mått.

Mer information om dataplats och sekretess finns i Datahemvist.

Ange anslutningsinformation till utvecklare

För att ansluta till Azure AI-sökning behöver utvecklare:

• En slutpunkt eller URL från översiktssidan .
• En API-nyckel från sidan Nycklar eller en rolltilldelning. Vi rekommenderar Search Service Contributor, Search Index Data Contributor och Search Index Data Reader.

Vi rekommenderar portalåtkomst för guiden Importera data och Sökutforskaren. Du måste ha en roll som bidragsgivare eller högre för att kunna köra guiden.

Relaterat innehåll

Programmatiskt stöd för tjänstadministration finns i följande API:er och moduler:

• Rest API-referens för hantering
• Az.Search PowerShell-modul
• az search Azure CLI modul

Du kan också använda hanteringsklientbiblioteken i Azure-SDK:er för .NET, Python, Java och JavaScript.

Det finns funktionsparitet för alla modaliteter och språk, förutom funktioner för förhandsversionshantering. Som en allmän regel släpps förhandsversionshanteringsfunktionerna först via REST API för hantering.