Sdílet prostřednictvím

Referenční informace k rozhraní REST API projektů Azure AI

Rozhraní REST API Azure AI Projects umožňuje pracovat s projekty AI, což je ústřední prostředek, který spojuje modely, data, nástroje a telemetrii v Azure AI Foundry. Pomocí známých příkazů HTTP můžete vytvořit projekt, nakonfigurovat zabezpečená připojení k dalším službám Azure a načíst koncové body připravené k použití pro odvozování, agenty, vyhodnocení a další. Vzhledem k tomu, že každá služba, kterou připojíte, je umístěna za jedním připojovacím řetězcem projektu, potřebují aplikace znát pouze jedno přihlašovací údaje a jednu základní adresu URL, aby se dostaly ke všemu, co potřebují.

Verzování

Azure AI Foundry API poskytuje dva typy správy verzí:

  1. Vyvíjející se verze: Tyto verze se řídí formátem v# (např. v1, v2, v3). Jak název napovídá, vyvíjející se verze zahrnují nerušitelné změny kontraktu, jako je přidání volitelných parametrů do požadavků nebo nové vlastnosti do odpovědí. Klienti používající tyto verze by měli být navrženi tak, aby zpracovávali aditivní změny.
  2. Připnutá verze: Jedná se o verze založené na datu, které nezahrnují změny smluv. Následující tabulka ukazuje, jak tyto verze fungují.
Časová osa Vyvíjející se verze Připnutá verze Poznámky
25-květen v1 5/1/2025 Zákazníci, kteří nechtějí ve smlouvě žádné změny, mohou využít verzi založenou na datu. Zákazníci, kteří chtějí všechny nejnovější změny, které nenarušují systém, mohou použít verzi v1.
Nezlomitelná změna 1 v1 není k dispozici Zákazníci používající v1 budou moci automaticky používat nezásadní změnu 1.
Nezlomná změna 2 v1 není k dispozici Zákazníci používající v1 budou moci automaticky používat nezásadní změnu 2.
Nezlomná změna 3 v1 není k dispozici Zákazníci používající verzi v1 budou moci automaticky používat nezásadní změnu 3.
Interval 3 měsíců v1 8/1/2025 Zákazníci, kteří potřebují nepodstatné změny 1, 2 a 3 bez dalších změn, mohou použít verzi 2025-08-01.
Nezlomitelná změna 4 v1 není k dispozici Zákazníci používající verzi v1 budou moci automaticky používat nezásadní změnu 4.
Nezlomitelná změna 5 v1 není k dispozici Zákazníci používající verzi v1 budou moci automaticky používat nezásadní změnu 5.
Nezlomná změna 6 v1 není k dispozici Zákazníci používající verzi v1 budou moci automaticky používat nezásadní změnu 6.
Interval 3 měsíců v1 11/1/2025 Zákazníci, kteří potřebují zásadní změny 4, 5 a 6 bez dalších změn, mohou použít verzi 2025-11-01.
(Hypotetické) Zásadní změna v lednu 2025 v2 1/1/2026 Vzhledem k tomu, že došlo k zásadní změně, budou zákazníci muset přejít na verzi v2 nebo 2026-01-01, aby měli přístup ke změnám.
Oznámení o ukončení podpory Všechny předchozí verze budou označeny jako zastaralé:
* 2025-05-01
* 2025-08-01
* 2025-11-01
* verze 1
Po jednom roce budou vyřazeni.
Nezlomná změna 7 v2 není k dispozici Zákazníci používající verzi 2 budou moci automaticky používat nezásadní změnu 7.
Zásadní změna 8 v2 není k dispozici Zákazníci používající verzi v2 budou moci automaticky používat nezásadní změnu 8.
Nezlomná změna 9 v2 není k dispozici Zákazníci používající verzi v2 budou moci automaticky používat nezásadní změnu 9.
Interval 3 měsíců v2 3/1/2026 Zákazníci, kteří potřebují nepodstatné změny 7, 8 a 9 bez dalších změn, mohou použít verzi 2026-03-01.

Změny, které nenarušují

Změny, které nejsou zásadní, jsou definovány následovně:

  • Přidání nových prostředků (adres URL) do rozhraní REST API a sad SDK
  • Přidání nových volitelných parametrů API
  • Přidání nových vlastností do objektů odpovědí JSON nebo dat událostí
  • Změna pořadí vlastností v objektu odpovědi JSON
  • Změna délky nebo formátu neprůhledných řetězců, jako jsou identifikátory prostředků a identifikátory UUID
  • Přidání nových typů událostí (buď ve streamingu nebo v Realtime API)

Viz také