This is an automated email from the ASF dual-hosted git repository.
xtsong pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/flink-agents.git
The following commit(s) were added to refs/heads/main by this push:
new 059f93a4 [doc] Clarify Azure OpenAI vs Azure AI in documentation (#501)
059f93a4 is described below
commit 059f93a49d338495c288d71775601759db80ec64
Author: Weiqing Yang <[email protected]>
AuthorDate: Wed Jan 28 22:33:58 2026 -0800
[doc] Clarify Azure OpenAI vs Azure AI in documentation (#501)
---
docs/content/docs/development/chat_models.md | 12 ++++++++++--
docs/content/docs/faq/faq.md | 1 +
2 files changed, 11 insertions(+), 2 deletions(-)
diff --git a/docs/content/docs/development/chat_models.md
b/docs/content/docs/development/chat_models.md
index f379149a..69b60b83 100644
--- a/docs/content/docs/development/chat_models.md
+++ b/docs/content/docs/development/chat_models.md
@@ -144,12 +144,16 @@ public class MyAgent extends Agent {
### Azure AI
-Azure AI provides cloud-based chat models through Azure AI Inference API,
supporting various models including GPT-4, GPT-4o, and other Azure-hosted
models.
+Azure AI provides cloud-based chat models through Azure AI Inference API,
supporting various models including Llama, Mistral, Phi, and other models
deployed via Azure AI Studio.
{{< hint info >}}
Azure AI is only supported in Java currently. To use Azure AI from Python
agents, see [Using Cross-Language Providers](#using-cross-language-providers).
{{< /hint >}}
+{{< hint warning >}}
+**Azure AI vs OpenAI (Azure):** Azure AI uses the Azure AI Inference API to
access models deployed via Azure AI Studio (Llama, Mistral, Phi, etc.). If you
want to use OpenAI models (GPT-4, etc.) hosted on Azure, see [OpenAI
(Azure)](#openai-azure) instead.
+{{< /hint >}}
+
#### Prerequisites
1. Create an Azure AI resource in the [Azure Portal](https://portal.azure.com/)
@@ -686,12 +690,16 @@ Model availability and specifications may change. Always
check the official Open
### OpenAI (Azure)
-OpenAI (Azure) provides access to OpenAI models through Azure's cloud
infrastructure, using the same OpenAI SDK with Azure-specific authentication
and endpoints. This offers enterprise security, compliance, and regional
availability while using familiar OpenAI APIs.
+OpenAI (Azure) provides access to OpenAI models (GPT-4, GPT-4o, etc.) through
Azure's cloud infrastructure, using the same OpenAI SDK with Azure-specific
authentication and endpoints. This offers enterprise security, compliance, and
regional availability while using familiar OpenAI APIs.
{{< hint info >}}
OpenAI (Azure) is only supported in Python currently. To use OpenAI (Azure)
from Java agents, see [Using Cross-Language
Providers](#using-cross-language-providers).
{{< /hint >}}
+{{< hint warning >}}
+**OpenAI (Azure) vs Azure AI:** OpenAI (Azure) uses the OpenAI SDK to access
OpenAI models (GPT-4, etc.) hosted on Azure. If you want to use other models
like Llama, Mistral, or Phi deployed via Azure AI Studio, see [Azure
AI](#azure-ai) instead.
+{{< /hint >}}
+
#### Prerequisites
1. Create an Azure OpenAI resource in the [Azure
Portal](https://portal.azure.com/)
diff --git a/docs/content/docs/faq/faq.md b/docs/content/docs/faq/faq.md
index 643d9a4f..d86ada37 100644
--- a/docs/content/docs/faq/faq.md
+++ b/docs/content/docs/faq/faq.md
@@ -97,6 +97,7 @@ Flink Agents provides built-in integrations for many
ecosystem providers. Some i
| [Anthropic]({{< ref "docs/development/chat_models#anthropic" >}}) | ✅ | ❌ |
| [Ollama]({{< ref "docs/development/chat_models#ollama" >}}) | ✅ | ✅ |
| [Tongyi (DashScope)]({{< ref "docs/development/chat_models#tongyi-dashscope"
>}}) | ✅ | ❌ |
+| [OpenAI (Azure)]({{< ref "docs/development/chat_models#openai-azure" >}}) |
✅ | ❌ |
| [Azure AI]({{< ref "docs/development/chat_models#azure-ai" >}}) | ❌ | ✅ |
**Embedding Models**
