Použití Azure OpenAI s copilotem v SSMS

Copilot v sadě SQL Server Management Studio (SSMS) používá koncový bod a nasazení v Azure OpenAI. Tento článek obsahuje postup vytvoření nezbytných prostředků Azure OpenAI. Další informace najdete v tématu Vytvoření a nasazení azure OpenAI v prostředku Azure AI Foundry Models.

Přístup k nasazením je možné poskytnout pomocí ověřování Microsoft Entra nebo klíčů rozhraní API. Ověřování Microsoft Entra se doporučuje jako bezpečnější možnost.

Náklady na Copilot v SSMS závisí na využití zřízených prostředků Azure OpenAI a vybraném modelu. Náklady budou účtovány na předplatné Azure, které hostuje prostředky. Další informace najdete v přehledu cen služby Azure OpenAI.

Vytvoření koncového bodu

Vytvoření koncového bodu se provádí na webu Azure Portal.

1. Přihlaste se k portálu Azure.

2. Přejděte na Služby.

3. Vyberte služby Azure AI, které jsou uvedené v části AI + Machine Learning.

4. V rámci služeb Azure AI*vyberte účet Azure OpenAI.

5. Vyberte + Vytvořit a vytvořte novou službu Azure OpenAI.

6. Na stránce Základy vyplňte všechny požadované podrobnosti.

   1. Název se používá v adrese URL koncového bodu.
   2. Jedinou možností, která je aktuálně dostupná pro cenovou úroveň , je Standard S0.

7. Vyberte Další.

8. Na stránce Síť vyberte Všechny sítě , pokud nenastavíte síť VPN. SQL Server Management Studio (SSMS) musí mít přístup ke koncovému bodu, aby funkce Copilot v SSMS fungovala.

9. Vyberte Další.

10. Na stránce Značky nastavte všechny značky, které vaše organizace používá. Značky nejsou vyžadovány pro Copilot v SSMS, ale měly by být nastavené podle zásad vaší společnosti. Vaše společnost může například vyžadovat, aby všechny prostředky používaly značku Vlastník.

11. Vyberte Další.

12. Na stránce Zkontrolovat a odeslat zkontrolujte informace a pak vyberte Vytvořit.

13. Zobrazí se zpráva Nasazení probíhá, a po zřízení je vaše nasazení dokončeno.

14. Vyberte Přejít na zdroj.

15. V rámci prostředku rozbalte Správu prostředků a pak vyberte Klíče a Koncový bod.

16. Poznamenejte si hodnotu koncového bodu na stránce Klíče a koncový bod , protože se použije při konfiguraci Copilotu v SSMS.

    Poznámka:

    Během počáteční konfigurace Copilotu v SSMS zadejte koncový bod do dialogového okna Koncový bod Azure OpenAI .

17. Pokud používáte přístup ke klíči rozhraní API, můžete použít klíč 1 nebo klíč 2 při konfiguraci Copilotu v SSMS. Přístup ke klíči rozhraní API je volitelný; Ověřování Microsoft Entra se doporučuje jako bezpečnější možnost.

    Poznámka:

    Během počáteční konfigurace Copilotu v SSMS zadejte klíč 1 nebo klíč 2 v dialogovém okně Klíč rozhraní API Azure OpenAI , pokud používáte přístup ke klíči rozhraní API.

Použití ID Microsoft Entra pro přístup

Pokud chcete použít Microsoft Entra k ověření ve službě Azure OpenAI for Copilot v SSMS, je potřeba provést následující kroky.

1. V rámci prostředku koncového bodu vyberte Řízení přístupu (IAM).

2. Na stránce Řízení přístupu vyberte + Přidat a přidejte přiřazení role.

3. Na stránce Role v seznamu rolí funkcí úloh vyhledejte uživatele OpenAI služeb Cognitive Services a vyberte ho a pak vyberte Další.

4. Na stránce Členové přidejte příslušné členy zadáním uživatele, skupiny, instančního objektu nebo spravované identity.

5. Pomocí +Vybrat členy otevřete podokno Vybrat členy .

6. Ze seznamu vyberte příslušné ID a pak vyberte.

7. Vyberte možnost Zkontrolovat a přiřadit, na stránce Zkontrolovat a přiřadit zkontrolujte členy a poté znovu vyberte Zkontrolovat a přiřadit pro přiřazení členů k nasazení.

8. Zobrazí se oznámení o přidání role.

9. Opakujte kroky 2 až 8 pro přispěvatele OpenAI služeb Cognitive Services. Do obou rolí musí být přidáni všichni členové, ať už uživatel, skupina, instanční objekt nebo spravovaná identita.

Role Přispěvatel Cognitive Services OpenAI má oprávnění ke čtení a zápisu a schopnost upravovat koncový bod. Případně můžete přiřadit roli Přispěvatel OpenAI služeb Cognitive Services osobě, která spravuje koncový bod (měla by být přiřazena alespoň jedné osobě) a přiřadit jenom roli uživatele OpenAI služeb Cognitive Services jiným členům. Role uživatele OpenAI služeb Cognitive Services má nižší oprávnění a poskytuje přístup ke koncovému bodu jen pro čtení.

Vytvořte nasazení

Posledním krokem je vytvoření nasazení aplikace.

1. V rámci prostředku koncového bodu přejděte na stránku Přehled .

2. Vyberte Prozkoumat portál Azure AI Foundry, který spustí samostatný portál.

3. Zobrazí se upozornění, že opouštíte Azure Portal. Zvolte Pokračovat.

4. V portálu Azure AI Foundry vyberte Nasazení v části Sdílené prostředky.

5. Vyberte + Nasadit model a pak vyberte Nasadit základní model.

6. V podokně Vybrat model vyberte model gpt-4o (dokončení chatu) a pak vyberte Potvrdit.

   Poznámka:

   gpt-4o je jediným modelem podporovaným ve verzi Preview.

7. Na stránce Nasadit model vyberte Přizpůsobit.

8. V dialogovém okně přizpůsobení zadejte hodnotu pro název nasazení.

9. Poznamenejte si hodnotu pro název nasazení , protože se použije při konfiguraci Copilotu v nástroji SSMS.

   Poznámka:

   Během počáteční konfigurace Copilot v SSMS zadejte název Nasazení v dialogovém okně Nasazení Azure OpenAI.

10. Nastavte typ nasazení. Každý typ nasazení obsahuje popis výkonu a rezidence dat. Nasazení se slovem „standard“ v názvu se doporučuje pro verzi Preview. Pokud rezidence dat není problém, nabízí Global Standard nejlepší výkon. Standard Data Zone poskytuje vyvážený kompromis, zatímco režim Standard optimalizuje konkrétní oblast, což může vést k vyšší latenci.

11. Verze modelu by měla být 2024-11-20a umístění prostředku by mělo být nastavené ve výchozím nastavení (zděděno z již vytvořeného koncového bodu).

12. Nastavte limit rychlosti tokenů za minutu na maximální dostupnou hodnotu. Můžete ho kdykoli upravit na portálu Azure AI Foundry, pokud se rozhodnete limit snížit. Čím nižší je hodnota, tím méně otázek za minutu může Copilot odpovědět. Další informace najdete v tématu Správa kvóty a limitů Azure OpenAI Service.

13. Pokud vaše společnost nemá vlastní zásady týkající se filtrů obsahu AI, ponechte filtr obsahu na výchozí hodnotu DefaultV2.

14. Vyberte Vytvořit prostředek a nasadit.

15. Po dokončení nasazení se zobrazí stránka podrobností. V části Začínáme najdete koncový bod a nasazení v kódu pro spustit základní ukázku kódu:

    

16. Při konfiguraci Copilotu v SSMS použijte následující hodnoty a koncový bod:

    

17. Pokud potřebujete upravit nastavení nasazení, jako je limit rychlosti (tokeny za minutu), přejděte na stránku podrobností nasazení.

Monitorování nákladů

Náklady na Copilot v SSMS se liší podle použití a řídí se fakturačním modelem průběžných plateb. Vzhledem k tomu, že náklady nejsou fixní, opakovaná hodnota, doporučujeme pravidelně monitorovat výdaje na prostředky, aby se zmírnila překvapení ve fakturaci. Další informace najdete v tématu Plánování správy nákladů na službu Azure OpenAI.

Související obsah

• Řešení potíží s Copilotem v "SQL Server Management Studio"
• Co je služba Azure OpenAI?
• Použití okna chatu pro Copilot v aplikaci SQL Server Management Studio
• Pomoc s kódem pro Copilot v aplikaci SQL Server Management Studio