azure_ai extensie in Azure Database voor PostgreSQL

De extensie azure_ai in Azure Database for PostgreSQL maakt in-databasegebruik van grote taalmodellen (LLM's) mogelijk om generatieve AI-toepassingen te bouwen. Hiermee kan de database Azure OpenAI aanroepen in Microsoft Foundry-modellen, Azure OpenAI Service, Azure Cognitive Services (Azure Language in Foundry Tools) en Azure Machine Learning Services vereenvoudigen de ontwikkeling door naadloze integratie met deze services.

De azure_ai-extensie inschakelen

Voordat u de azure_ai-extensie kunt gebruiken, moet u deze toestaan en vervolgens installeren in uw Azure Database for PostgreSQL exemplaar. Volg de onderstaande stappen om aan de slag te gaan.

De extensie op de toelatingslijst plaatsen

Voeg azure_ai toe aan de acceptatielijst van uw Azure Database for PostgreSQL flexibele server, zoals beschreven in hoe u PostgreSQL-extensies gebruikt. Controleer of deze correct is toegevoegd door de query uit te SHOW azure.extensions; voeren.

De extensie installeren

Maak verbinding met uw database en voer de CREATE EXTENSION opdracht uit:

CREATE EXTENSION IF NOT EXISTS azure_ai;

Herhaal deze opdracht voor elke database waarvoor de extensie is vereist.

Wanneer u installeert azure_ai, worden de volgende schema's gemaakt:

• azure_ai: principal-schema voor configuratie en gerelateerde functies
• azure_openai: functies en typen voor Azure OpenAI in Foundry-modellen en OpenAI-modellen in Microsoft Foundry
• azure_cognitive: functies en typen voor Azure Cognitive Services (Azure Language in Foundry Tools)
• azure_ml: functies en typen voor Azure Machine Learning Services

De azure_ai-extensie configureren

Als u de extensie wilt configureren, geeft u eindpunten en verificatiedetails (API-sleutel of beheerde identiteit) op voor de Azure AI + machine learning-services die u wilt gebruiken. Gebruik de azure_ai.set_setting configuratiefunctie met verschillende configuratiesleutels om deze waarden op te slaan.

Permissions

De extensie definieert een rol azure_ai_settings_manager die machtigingen verleent voor het lezen en schrijven van configuratie-instellingen met behulp van de azure_ai.set_getting en azure_ai.set_setting functies. Alleen supergebruikers en leden van deze rol kunnen deze functies aanroepen. In Azure Database for PostgreSQL Flexible Server verleent de rol azure_pg_admin standaard deze rol.

Configuratiefuncties

azure_ai_set_setting

Hiermee stelt u de AI + machine learning-configuratie in.

Gebruik:

-- Syntax
azure_ai.set_setting(key TEXT, value TEXT)

-- Usage example: Set the Endpoint and an API Key for Azure OpenAI
select azure_ai.set_setting('azure_openai.endpoint','https://<endpoint>.openai.azure.com');
select azure_ai.set_setting('azure_openai.subscription_key', '<API Key>');

Lijst met ondersteunde configuratiesleutels en -waarden:

azure_ai.get_setting

Hiermee worden de huidige configuratiewaarden voor een bepaalde waarde key opgehaald (zie ondersteunde sleutels in de bovenstaande lijst). Retourneert TEXT de huidige waarde van de geselecteerde instelling.

Gebruik:

-- Syntax
azure_ai.get_setting(key TEXT)

-- Usage example: Get the Endpoint and API Key for Azure OpenAI
select azure_ai.get_setting('azure_openai.endpoint');
select azure_ai.get_setting('azure_openai.subscription_key');

azure_ai.version

Retourneert TEXT de huidige versie van de azure_ai extensie.

Gebruik:

SELECT azure_ai.version()

Verificatie van beheerde identiteit inschakelen

De azure_ai-extensie voor Azure Database for PostgreSQL ondersteunt door het systeem toegewezen beheerde identiteit (SAMI), dat verbeterde beveiligingsvoordelen biedt. Met behulp van Microsoft Entra ID kunt u verifiëren zonder toegangssleutels, waardoor het risico op onbevoegde toegang wordt beperkt en het beheer van referenties wordt vereenvoudigd.

Raadpleeg deze handleiding om verificatie van beheerde identiteiten in te schakelen.

Mogelijkheden van de azure_ai extensie

AI-functies

Met de extensie azure_ai kunnen in-database-aanroepen worden uitgevoerd naar modellen die worden gehost in Foundry en Azure OpenAI via de volgende AI-functies (preview):

• Generate vector embeddings with Azure OpenAI in Azure Database for PostgreSQL: Hiermee maakt u vector embeddings voor een bepaalde invoertekst.
• azure_ai.generate(): genereert tekst of gestructureerde uitvoer met behulp van grote taalmodellen (LLM's).
• azure_ai.is_true(): Evalueert de kans dat een gegeven verklaring waar is.
• azure_ai.extract(): extraheert gestructureerde functies of entiteiten uit tekst.
• azure_ai.rank(): hiermee wordt een lijst met documenten opnieuw geherrankt op basis van relevantie voor een bepaalde query.

Aanvullende mogelijkheden

De extensie biedt ook ondersteuning voor aanroepen

• Integrate Azure Database for PostgreSQL met Azure Cognitive Services: hiermee schakelt u taken zoals sentimentanalyse rechtstreeks in de database in.
• Integrate Azure Database for PostgreSQL with Azure Machine Learning Services: Hiermee kunt u modellen aanroepen vanuit de Machine Learning-catalogus of aangepaste implementaties.

De AI + machine learning-extensie upgraden

Voer de volgende opdracht uit om de geïnstalleerde versie en beschikbare upgrades te controleren:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Als u de extensie wilt bijwerken naar de meest recente ondersteunde versie, voert u het volgende uit:

ALTER EXTENSION azure_ai UPDATE;

Verwante inhoud

• AI-functies in de azure_ai-extensie (Preview)
• Vector embeddings genereren met Azure OpenAI in Azure Database for PostgreSQL
• Pgvector inschakelen en gebruiken in Azure Database for PostgreSQL
• Zelfstudie: Een semantische zoekopdracht maken met Azure Database for PostgreSQL en Azure OpenAI
• Azure Database for PostgreSQL integreren met Azure Machine Learning Services