LangChain4j项目中为Azure OpenAI Spring Boot Starter添加自定义HTTP头支持

在LangChain4j项目的Spring Boot Starter模块中，开发者最近为Azure OpenAI集成添加了一个重要的新特性——支持自定义HTTP头。这个功能对于那些需要向公司内部托管的OpenAI实例传递特殊认证头或其他元数据的应用场景特别有价值。

背景与需求

在企业级应用中，访问云服务时经常需要传递额外的安全令牌或认证信息。这些信息通常通过HTTP头传递。在之前的LangChain4j版本中，Azure OpenAI Starter虽然提供了基本的配置选项，如API密钥和端点URL，但缺少直接配置自定义HTTP头的能力。

技术实现

该功能通过在ChatModelProperties配置类中添加一个Map类型的customHeaders属性来实现。开发者可以像这样在application.properties或application.yml中配置自定义头：

langchain4j.azure-openai.chat-model.customHeaders.custom-key=${CUSTOM_AZURE_KEY}

在底层实现上，这些自定义头会在创建AzureOpenAiChatModel实例时被传递给HTTP客户端，确保每个请求都携带必要的额外信息。

临时解决方案与最终方案

在功能实现前，开发者不得不采用手动创建ChatLanguageModel Bean的方式来传递自定义头：

@Bean
ChatLanguageModel chatLanguageModel() {
    return AzureOpenAiChatModel.builder()
        .deploymentName("gpt-4o")
        .endpoint(System.getenv("AZURE_OPENAI_ENDPOINT"))
        .apiKey(System.getenv("AZURE_OPENAI_KEY"))
        .customHeaders(Map.of("custom-key", System.getenv("CUSTOM_AZURE_KEY")))
        .logRequestsAndResponses(true)
        .build();
}

现在，通过标准的Spring Boot配置属性即可实现相同功能，大大简化了配置过程并保持了与其他配置项的一致性。

技术意义

这一改进体现了LangChain4j项目对实际企业需求的响应能力。它不仅解决了特定场景下的技术难题，还保持了框架的简洁性和一致性。自定义HTTP头支持是构建安全、可扩展AI应用的重要基础功能，特别是在需要与企业安全基础设施集成的场景中。

后续发展

随着这一功能的合并，项目维护者还计划对Azure OpenAI Starter进行进一步的代码优化，包括移除Lombok依赖等改进，以提升代码的可读性和维护性。这些持续改进展示了LangChain4j项目对代码质量和开发者体验的关注。