Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

V2: Make Azure OpenAI v1 routing and API-version guidance consistent

Đang mở
  • Có gì không ổn?
#1,845 0 bình luận 0 reaction 1 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@paullizer đang làm issue này rồi.

Từ ngày 27/10/2026.

Đánh giá

Issue này chưa được đánh giá.

Mô tả

bug P1

Issue

Make model connection setup and runtime routing clearly distinguish Azure OpenAI's v1 protocol from the dated api-version used by the legacy Azure client. A customer reports that Endpoint default (v1) does not work while 2024-10-01-preview returns a response. Their exact connection metadata and error are not yet available, so the customer-specific root cause remains unconfirmed.

The application currently chooses a wire protocol using provider/API type/endpoint shape, not just the API-version selector. A literal v1 on a legacy Azure connection is not a switch to the v1 protocol. Conversely, the normalized Foundry/OpenAI-style /openai/v1/ client deliberately omits all dated api-version query values. Switching the version selector can therefore mean different things on different connection paths.

Steps to Reproduce

  1. Construct the legacy AzureOpenAI client with a resource-root endpoint and api_version="v1", using a mocked HTTP transport.
  2. Observe the SDK request shape /openai/deployments/<deployment>/chat/completions?api-version=v1.
  3. Construct the OpenAI-style client with a /openai/v1/ base URL.
  4. Observe /openai/v1/chat/completions with no dated version query.
  5. Trace the relevant SimpleChat connection/provider/protocol configuration into those builders and compare the guidance shown in the connection editor.

The two SDK wire shapes were reproduced offline. No live assertion was made about the customer's Azure deployment.

Expected Behavior

An admin can tell which inference protocol is selected, enter only settings valid for that protocol, and understand which field controls inference versus Foundry project discovery. Selecting endpoint-default v1 must either select a valid v1 route or be rejected clearly for a dated-version connection.

Actual Behavior

The shared version wording allows v1 to be read as a universal API-version value. An apparently reasonable setting can remain on a legacy Azure SDK path, while dated selections on a normalized v1 path are intentionally not forwarded. A successful basic completion also does not validate every model/tool feature.

Impact

Admins can change versions without changing the actual inference protocol, receive confusing errors, or assume a React UI upgrade alone fixes model/API compatibility.

Acceptance Criteria

  • Document and validate the provider/API-type/endpoint/version combinations for legacy Azure inference and OpenAI-style v1 inference. Keep project discovery versions separate.
  • Prevent literal api-version=v1 from being mistaken for /openai/v1/ routing. Preserve valid existing dated-version configurations and require an explicit supported migration rather than silently rewriting connections.
  • Make V2 connection labels, help, test-connection diagnostics, and runtime construction agree on the effective protocol and version behavior.
  • Surface safe, actionable configuration errors without exposing credentials, raw settings, internal URLs, or provider response secrets to ordinary users.
  • Add mocked SDK request tests for actual paths/query parameters, selected deployment identity, API-key and managed-identity authentication, and relevant custom/APIM prefix behavior.
  • Clearly state that an API-version change does not bypass GPT-5.6's Chat Completions reasoning-plus-tools restriction; coordinate with #472 and the explicit-None compatibility work.
  • Publish route-specific current-main and V2 guidance. For the reported legacy setup, the currently working 2024-10-01-preview is an interim configuration, not a universal recommended default; true v1 inference uses its v1 path without a dated query.
  • Update tests/documentation and the application version when implementing.

Notes

Target: paullizer-react-v2-ui. Priority: P1. Assignee: @paullizer. Roadmap size: M.

Reviewed main: f5bcae7a4 (0.261.027). Reviewed latest V2: 11daaaa85. The newer V2 timeout/resilience changes do not replace the protocol inference rules.

Relevant areas: connection editor/modal and provider descriptors, model_endpoint_clients.py, functions_model_endpoint_runtime.py, model endpoint validation, and connection documentation. Related configuration/routing work: #1436 and #1518; do not duplicate or regress that work.

Official v1 contract: https://learn.microsoft.com/en-us/azure/foundry/openai/api-version-lifecycle

Ngôn ngữ chính
Python
Star
157
Fork
117
Merge trung bình
3 giờ 6 phút
Pull request đã merge (30 ngày)
219

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của microsoft/simplechat

Tất cả issue của microsoft/simplechat

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.