> ## Documentation Index > Fetch the complete documentation index at: https://nvd-54.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Azure OpenAI 集成 > 使用 LangChain JavaScript 集成 Azure OpenAI LLM。 **You are currently on a page documenting the use of Azure OpenAI text completion models. The latest and most popular Azure OpenAI models are [chat completion models](/oss/javascript/langchain/models).** Unless you are specifically using `gpt-3.5-turbo-instruct`, you are probably looking for [this page instead](/oss/javascript/integrations/chat/azure/). **Previously, LangChain.js supported integration with Azure OpenAI using the dedicated [Azure OpenAI SDK](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/openai/openai). This SDK is now deprecated in favor of the new Azure integration in the OpenAI SDK, which allows to access the latest OpenAI models and features the same day they are released, and allows seamless transition between the OpenAI API and Azure OpenAI.** If you are using Azure OpenAI with the deprecated SDK, see the [migration guide](#migration-from-azure-openai-sdk) to update to the new API. [Azure OpenAI](https://learn.microsoft.com/en-us/azure/ai-services/openai/) is a Microsoft Azure service that provides powerful language models from OpenAI. This will help you get started with AzureOpenAI completion models (LLMs) using LangChain. For detailed documentation on `AzureOpenAI` features and configuration options, please refer to the [API reference](https://reference.langchain.com/javascript/langchain-openai/AzureOpenAI). ## 概述 ### 集成详情 | Class | Package | Local | Serializable | [PY support](https://python.langchain.com/docs/integrations/llms/azure_openai) | Downloads | Version | | :--------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- | :---: | :----------: | :----------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | | [`AzureOpenAI`](https://reference.langchain.com/javascript/langchain-openai/AzureOpenAI) | [`@langchain/openai`](https://www.npmjs.com/package/@langchain/openai) | ❌ | ✅ | ✅ | ![NPM - Downloads](https://img.shields.io/npm/dm/@langchain/openai?style=flat-square\&label=%20&) | ![NPM - Version](https://img.shields.io/npm/v/@langchain/openai?style=flat-square\&label=%20&) | ## 设置 要访问 AzureOpenAI models，你需要create an Azure account, get an API key, and install the `@langchain/openai` integration package. ### 凭证 前往 [azure.microsoft.com](https://azure.microsoft.com/) 注册 AzureOpenAI 并生成 API 密钥。 You'll also need to have an Azure OpenAI instance deployed. You can deploy a version on Azure Portal following [this guide](https://learn.microsoft.com/azure/ai-services/openai/how-to/create-resource?pivots=web-portal). Once you have your instance running, make sure you have the name of your instance and key. You can find the key in the Azure Portal, under the "Keys and Endpoint" section of your instance. If you're using Node.js, you can define the following environment variables to use the service: ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} AZURE_OPENAI_API_INSTANCE_NAME= AZURE_OPENAI_API_DEPLOYMENT_NAME= AZURE_OPENAI_API_KEY= AZURE_OPENAI_API_VERSION="2024-02-01" ``` Alternatively, you can pass the values directly to the `AzureOpenAI` constructor. 如果你想要自动追踪模型调用，还可以设置你的 [LangSmith](/langsmith/home) API 密钥，取消注释以下内容： ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} # export LANGSMITH_TRACING="true" # export LANGSMITH_API_KEY="your-api-key" ``` ### 安装 LangChain 的 AzureOpenAI 集成位于 `@langchain/openai` 包中： ```bash npm theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} npm install @langchain/openai @langchain/core ``` ```bash yarn theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} yarn add @langchain/openai @langchain/core ``` ```bash pnpm theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} pnpm add @langchain/openai @langchain/core ``` ## 实例化 现在我们可以实例化模型对象并生成聊天补全： ```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} import { AzureOpenAI } from "@langchain/openai" const llm = new AzureOpenAI({ model: "gpt-3.5-turbo-instruct", azureOpenAIApiKey: "", // In Node.js defaults to process.env.AZURE_OPENAI_API_KEY azureOpenAIApiInstanceName: "", // In Node.js defaults to process.env.AZURE_OPENAI_API_INSTANCE_NAME azureOpenAIApiDeploymentName: "", // In Node.js defaults to process.env.AZURE_OPENAI_API_DEPLOYMENT_NAME azureOpenAIApiVersion: "", // In Node.js defaults to process.env.AZURE_OPENAI_API_VERSION temperature: 0, maxTokens: undefined, timeout: undefined, maxRetries: 2, // 其他参数... }) ``` ## 调用 ```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} const inputText = "AzureOpenAI is an AI company that " const completion = await llm.invoke(inputText) completion ``` ```text theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} provides AI solutions to businesses. They offer a range of services including natural language processing, computer vision, and machine learning. Their solutions are designed to help businesses automate processes, gain insights from data, and improve decision-making. AzureOpenAI also offers consulting services to help businesses identify and implement the best AI solutions for their specific needs. They work with a variety of industries, including healthcare, finance, and retail. With their expertise in AI and their partnership with Microsoft Azure, AzureOpenAI is a trusted provider of AI solutions for businesses looking to stay ahead in the rapidly evolving world of technology. ``` ## Using Azure Managed identity If you're using Azure Managed Identity, you can configure the credentials like this: ```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} import { DefaultAzureCredential, getBearerTokenProvider, } from "@azure/identity"; import { AzureOpenAI } from "@langchain/openai"; const credentials = new DefaultAzureCredential(); const azureADTokenProvider = getBearerTokenProvider( credentials, "https://cognitiveservices.azure.com/.default" ); const managedIdentityLLM = new AzureOpenAI({ azureADTokenProvider, azureOpenAIApiInstanceName: "", azureOpenAIApiDeploymentName: "", azureOpenAIApiVersion: "", }); ``` ## Using a different domain If your instance is hosted under a domain other than the default `openai.azure.com`, you'll need to use the alternate `AZURE_OPENAI_BASE_PATH` environment variable. For example, here's how you would connect to the domain `https://westeurope.api.microsoft.com/openai/deployments/{DEPLOYMENT_NAME}`: ```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} import { AzureOpenAI } from "@langchain/openai"; const differentDomainLLM = new AzureOpenAI({ azureOpenAIApiKey: "", // In Node.js defaults to process.env.AZURE_OPENAI_API_KEY azureOpenAIApiDeploymentName: "", // In Node.js defaults to process.env.AZURE_OPENAI_API_DEPLOYMENT_NAME azureOpenAIApiVersion: "", // In Node.js defaults to process.env.AZURE_OPENAI_API_VERSION azureOpenAIBasePath: "https://westeurope.api.microsoft.com/openai/deployments", // In Node.js defaults to process.env.AZURE_OPENAI_BASE_PATH }); ``` ## Migration from Azure OpenAI SDK If you are using the deprecated Azure OpenAI SDK with the `@langchain/azure-openai` package, you can update your code to use the new Azure integration following these steps: 1. Install the new `@langchain/openai` package and remove the previous `@langchain/azure-openai` package: ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} npm install @langchain/openai npm uninstall @langchain/azure-openai ``` 2. Update your imports to use the new `AzureOpenAI` and [`AzureChatOpenAI`](https://reference.langchain.com/javascript/langchain-openai/AzureChatOpenAI) classes from the `@langchain/openai` package: ```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} import { AzureOpenAI } from "@langchain/openai"; ``` 3. Update your code to use the new `AzureOpenAI` and [`AzureChatOpenAI`](https://reference.langchain.com/javascript/langchain-openai/AzureChatOpenAI) classes and pass the required parameters: ```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} const model = new AzureOpenAI({ azureOpenAIApiKey: "", azureOpenAIApiInstanceName: "", azureOpenAIApiDeploymentName: "", azureOpenAIApiVersion: "", }); ``` Notice that the constructor now requires the `azureOpenAIApiInstanceName` parameter instead of the `azureOpenAIEndpoint` parameter, and adds the `azureOpenAIApiVersion` parameter to specify the API version. * If you were using Azure Managed Identity, you now need to use the `azureADTokenProvider` parameter to the constructor instead of `credentials`, see the [Azure Managed Identity](#using-azure-managed-identity) section for more details. * If you were using environment variables, you now have to set the `AZURE_OPENAI_API_INSTANCE_NAME` environment variable instead of `AZURE_OPENAI_API_ENDPOINT`, and add the `AZURE_OPENAI_API_VERSION` environment variable to specify the API version. *** ## API 参考 有关所有 `AzureOpenAI` 功能和配置的详细文档，请前往 [API 参考](https://reference.langchain.com/javascript/langchain-openai/AzureOpenAI)。 ***
[将这些文档连接到](/use-these-docs) Claude、VSCode 等工具，通过 MCP 获取实时答案。 [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/javascript/integrations/llms/azure.mdx) 或 [提交 issue](https://github.com/langchain-ai/docs/issues/new/choose)。