langchain-dev-utils 1.3.3__tar.gz → 1.3.5__tar.gz

{langchain_dev_utils-1.3.3 → langchain_dev_utils-1.3.5}/.gitignore

@@ -1,16 +1,16 @@
-# Python-generated files
-__pycache__/
-*.py[oc]
-build/
-dist/
-wheels/
-*.egg-info
-
-# Virtual environments
-.venv
-.env
-.benchmarks
-data/
-node_modules
-dist
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.env
+.benchmarks
+data/
+node_modules
+dist
 site/

{langchain_dev_utils-1.3.3 → langchain_dev_utils-1.3.5}/.python-version

@@ -1 +1 @@
-3.11
+3.11

{langchain_dev_utils-1.3.3 → langchain_dev_utils-1.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langchain-dev-utils
-Version: 1.3.3
+Version: 1.3.5
 Summary: A practical utility library for LangChain and LangGraph development
 Project-URL: Source Code, https://github.com/TBice123123/langchain-dev-utils
 Project-URL: repository, https://github.com/TBice123123/langchain-dev-utils

{langchain_dev_utils-1.3.3 → langchain_dev_utils-1.3.5}/README_cn.md

@@ -1,86 +1,86 @@
-# 🦜️🧰 langchain-dev-utils
-
-<p align="center">
-    <em>🚀 专为 LangChain 和 LangGraph 开发者打造的高效工具库</em>
-</p>
-
-<p align="center">
-  📚 <a href="https://tbice123123.github.io/langchain-dev-utils/">English</a> • 
-  <a href="https://tbice123123.github.io/langchain-dev-utils/zh/">中文</a>
-</p>
-
-[![PyPI](https://img.shields.io/pypi/v/langchain-dev-utils.svg?color=%2334D058&label=pypi%20package)](https://pypi.org/project/langchain-dev-utils/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Python](https://img.shields.io/badge/python-3.11|3.12|3.13|3.14-%2334D058)](https://www.python.org/downloads)
-[![Downloads](https://static.pepy.tech/badge/langchain-dev-utils/month)](https://pepy.tech/project/langchain-dev-utils)
-[![Documentation](https://img.shields.io/badge/docs-latest-blue)](https://tbice123123.github.io/langchain-dev-utils/zh/)
-
-> 当前为中文版，英文版请访问[English Version](https://github.com/TBice123123/langchain-dev-utils/blob/master/README.md)
-
-## ✨ 为什么选择 langchain-dev-utils？
-
-厌倦了在 LangChain 开发中编写重复代码？`langchain-dev-utils` 正是您需要的解决方案！这个轻量但功能强大的工具库专为提升 LangChain 和 LangGraph 开发体验而设计，帮助您：
-
-- ⚡ **提升开发效率** - 减少样板代码，让您专注于核心功能
-- 🧩 **简化复杂流程** - 轻松管理多模型、多工具和多智能体应用
-- 🔧 **增强代码质量** - 提高一致性和可读性，减少维护成本
-- 🎯 **加速原型开发** - 快速实现想法，更快迭代验证
-
-
-## 🎯 核心功能
-
-- **🔌 统一的模型管理** - 通过字符串指定模型提供商，轻松切换和组合不同模型
-- **💬 灵活的消息处理** - 支持思维链拼接、流式处理和消息格式化
-- **🛠️ 强大的工具调用** - 内置工具调用检测、参数解析和人工审核功能
-- **🤖 高效的 Agent 开发** - 简化智能体创建流程，扩充更多的常用中间件
-- **📊 灵活的状态图组合** - 支持串行和并行方式组合多个 StateGraph
-
-## ⚡ 快速开始
-
-**1. 安装 `langchain-dev-utils`**
-
-```bash
-pip install -U "langchain-dev-utils[standard]"
-```
-
-**2. 开始使用**
-
-```python
-from langchain.tools import tool
-from langchain_core.messages import HumanMessage
-from langchain_dev_utils.chat_models import register_model_provider, load_chat_model
-from langchain_dev_utils.agents import create_agent
-
-# 注册模型提供商
-register_model_provider("vllm", "openai-compatible", base_url="http://localhost:8000/v1")
-
-@tool
-def get_current_weather(location: str) -> str:
-    """获取指定地点的当前天气"""
-    return f"25度，{location}"
-
-# 使用字符串动态加载模型
-model = load_chat_model("vllm:qwen3-4b")
-response = model.invoke("你好")
-print(response)
-
-# 创建智能体
-agent = create_agent("vllm:qwen3-4b", tools=[get_current_weather])
-response = agent.invoke({"messages": [HumanMessage(content="今天纽约的天气如何？")]})
-print(response)
-```
-
-**获取更多的本库功能，请访问[完整文档](https://tbice123123.github.io/langchain-dev-utils/zh/)**
-
-
-## 🛠️ GitHub 仓库
-
-访问 [GitHub 仓库](https://github.com/TBice123123/langchain-dev-utils) 查看源代码和问题。
-
-
----
-
-<div align="center">
-  <p>由 ❤️ 和 ☕ 驱动开发</p>
-  <p>如果这个项目对您有帮助，请给我们一个 ⭐️</p>
+# 🦜️🧰 langchain-dev-utils
+
+<p align="center">
+    <em>🚀 专为 LangChain 和 LangGraph 开发者打造的高效工具库</em>
+</p>
+
+<p align="center">
+  📚 <a href="https://tbice123123.github.io/langchain-dev-utils/">English</a> • 
+  <a href="https://tbice123123.github.io/langchain-dev-utils/zh/">中文</a>
+</p>
+
+[![PyPI](https://img.shields.io/pypi/v/langchain-dev-utils.svg?color=%2334D058&label=pypi%20package)](https://pypi.org/project/langchain-dev-utils/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/badge/python-3.11|3.12|3.13|3.14-%2334D058)](https://www.python.org/downloads)
+[![Downloads](https://static.pepy.tech/badge/langchain-dev-utils/month)](https://pepy.tech/project/langchain-dev-utils)
+[![Documentation](https://img.shields.io/badge/docs-latest-blue)](https://tbice123123.github.io/langchain-dev-utils/zh/)
+
+> 当前为中文版，英文版请访问[English Version](https://github.com/TBice123123/langchain-dev-utils/blob/master/README.md)
+
+## ✨ 为什么选择 langchain-dev-utils？
+
+厌倦了在 LangChain 开发中编写重复代码？`langchain-dev-utils` 正是您需要的解决方案！这个轻量但功能强大的工具库专为提升 LangChain 和 LangGraph 开发体验而设计，帮助您：
+
+- ⚡ **提升开发效率** - 减少样板代码，让您专注于核心功能
+- 🧩 **简化复杂流程** - 轻松管理多模型、多工具和多智能体应用
+- 🔧 **增强代码质量** - 提高一致性和可读性，减少维护成本
+- 🎯 **加速原型开发** - 快速实现想法，更快迭代验证
+
+
+## 🎯 核心功能
+
+- **🔌 统一的模型管理** - 通过字符串指定模型提供商，轻松切换和组合不同模型
+- **💬 灵活的消息处理** - 支持思维链拼接、流式处理和消息格式化
+- **🛠️ 强大的工具调用** - 内置工具调用检测、参数解析和人工审核功能
+- **🤖 高效的 Agent 开发** - 简化智能体创建流程，扩充更多的常用中间件
+- **📊 灵活的状态图组合** - 支持串行和并行方式组合多个 StateGraph
+
+## ⚡ 快速开始
+
+**1. 安装 `langchain-dev-utils`**
+
+```bash
+pip install -U "langchain-dev-utils[standard]"
+```
+
+**2. 开始使用**
+
+```python
+from langchain.tools import tool
+from langchain_core.messages import HumanMessage
+from langchain_dev_utils.chat_models import register_model_provider, load_chat_model
+from langchain_dev_utils.agents import create_agent
+
+# 注册模型提供商
+register_model_provider("vllm", "openai-compatible", base_url="http://localhost:8000/v1")
+
+@tool
+def get_current_weather(location: str) -> str:
+    """获取指定地点的当前天气"""
+    return f"25度，{location}"
+
+# 使用字符串动态加载模型
+model = load_chat_model("vllm:qwen3-4b")
+response = model.invoke("你好")
+print(response)
+
+# 创建智能体
+agent = create_agent("vllm:qwen3-4b", tools=[get_current_weather])
+response = agent.invoke({"messages": [HumanMessage(content="今天纽约的天气如何？")]})
+print(response)
+```
+
+**获取更多的本库功能，请访问[完整文档](https://tbice123123.github.io/langchain-dev-utils/zh/)**
+
+
+## 🛠️ GitHub 仓库
+
+访问 [GitHub 仓库](https://github.com/TBice123123/langchain-dev-utils) 查看源代码和问题。
+
+
+---
+
+<div align="center">
+  <p>由 ❤️ 和 ☕ 驱动开发</p>
+  <p>如果这个项目对您有帮助，请给我们一个 ⭐️</p>
 </div>

{langchain_dev_utils-1.3.3 → langchain_dev_utils-1.3.5}/pyproject.toml

@@ -1,47 +1,47 @@
-[project]
-name = "langchain-dev-utils"
-version = "1.3.3"
-description = "A practical utility library for LangChain and LangGraph development"
-readme = "README.md"
-authors = [{ name = "tiebingice", email = "tiebingice123@outlook.com" }]
-requires-python = ">=3.11"
-dependencies = ["langchain>=1.2.0", "langchain-core>=1.2.5", "langgraph>=1.0.0"]
-
-[project.urls]
-"Source Code" = "https://github.com/TBice123123/langchain-dev-utils"
-repository = "https://github.com/TBice123123/langchain-dev-utils"
-documentation = "https://tbice123123.github.io/langchain-dev-utils"
-
-
-[project.optional-dependencies]
-standard = ["json-repair>=0.53.1", "langchain-openai"]
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[tool.hatch.build]
-exclude = ["/data", "/docs", "mkdocs.yml"]
-
-[tool.pytest.ini_options]
-asyncio_mode = "auto"
-testpaths = ["tests"]
-python_files = ["test_*.py"]
-python_functions = ["test_*"]
-
-[dependency-groups]
-dev = ["langchain-model-profiles>=0.0.5", "ruff>=0.14.5"]
-docs = ["mkdocs-material>=9.7.0", "mkdocs-static-i18n>=1.3.0"]
-tests = [
-    "python-dotenv>=1.1.1",
-    "langchain-tests>=1.0.0",
-    "langchain-deepseek>=1.0.0",
-    "langchain-qwq>=0.3.0",
-    "langchain-ollama>=1.0.0",
-    "langchain-community>=0.4.1",
-]
-
-
-[tool.ruff.lint]
-select = ["E", "F", "I", "PGH003", "T201"]
-ignore = ["E501"]
+[project]
+name = "langchain-dev-utils"
+version = "1.3.5"
+description = "A practical utility library for LangChain and LangGraph development"
+readme = "README.md"
+authors = [{ name = "tiebingice", email = "tiebingice123@outlook.com" }]
+requires-python = ">=3.11"
+dependencies = ["langchain>=1.2.0", "langchain-core>=1.2.5", "langgraph>=1.0.0"]
+
+[project.urls]
+"Source Code" = "https://github.com/TBice123123/langchain-dev-utils"
+repository = "https://github.com/TBice123123/langchain-dev-utils"
+documentation = "https://tbice123123.github.io/langchain-dev-utils"
+
+
+[project.optional-dependencies]
+standard = ["json-repair>=0.53.1", "langchain-openai"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build]
+exclude = ["/data", "/docs", "mkdocs.yml"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+
+[dependency-groups]
+dev = ["langchain-model-profiles>=0.0.5", "ruff>=0.14.5"]
+docs = ["mkdocs-material>=9.7.0", "mkdocs-static-i18n>=1.3.0"]
+tests = [
+    "python-dotenv>=1.1.1",
+    "langchain-tests>=1.0.0",
+    "langchain-deepseek>=1.0.0",
+    "langchain-qwq>=0.3.0",
+    "langchain-ollama>=1.0.0",
+    "langchain-community>=0.4.1",
+]
+
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "PGH003", "T201"]
+ignore = ["E501"]

langchain_dev_utils-1.3.5/src/langchain_dev_utils/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.3.5"

langchain_dev_utils-1.3.5/src/langchain_dev_utils/_utils.py

@@ -0,0 +1,126 @@
+from importlib import util
+from typing import Literal, Optional
+
+from pydantic import BaseModel
+
+
+def _check_pkg_install(
+    pkg: Literal["langchain_openai", "json_repair"],
+) -> None:
+    if not util.find_spec(pkg):
+        if pkg == "langchain_openai":
+            msg = "Please install langchain_dev_utils[standard],when use 'openai-compatible'"
+        else:
+            msg = "Please install langchain_dev_utils[standard] to use ToolCallRepairMiddleware."
+        raise ImportError(msg)
+
+
+def _get_base_url_field_name(model_cls: type[BaseModel]) -> str | None:
+    """
+    Return 'base_url' if the model has a field named or aliased as 'base_url',
+    else return 'api_base' if it has a field named or aliased as 'api_base',
+    else return None.
+    The return value is always either 'base_url', 'api_base', or None.
+    """
+    model_fields = model_cls.model_fields
+
+    # try model_fields first
+    if "base_url" in model_fields:
+        return "base_url"
+
+    if "api_base" in model_fields:
+        return "api_base"
+
+    # then try aliases
+    for field_info in model_fields.values():
+        if field_info.alias == "base_url":
+            return "base_url"
+
+    for field_info in model_fields.values():
+        if field_info.alias == "api_base":
+            return "api_base"
+
+    return None
+
+
+def _validate_base_url(base_url: Optional[str] = None) -> None:
+    """Validate base URL format.
+
+    Args:
+        base_url: Base URL to validate
+
+    Raises:
+        ValueError: If base URL is not a valid HTTP or HTTPS URL
+    """
+    if base_url is None:
+        return
+
+    from urllib.parse import urlparse
+
+    parsed = urlparse(base_url.strip())
+
+    if not parsed.scheme or not parsed.netloc:
+        raise ValueError(
+            f"base_url must be a valid HTTP or HTTPS URL. Received: {base_url}"
+        )
+
+    if parsed.scheme not in ("http", "https"):
+        raise ValueError(
+            f"base_url must use HTTP or HTTPS protocol. Received: {parsed.scheme}"
+        )
+
+
+def _validate_model_cls_name(model_cls_name: str) -> None:
+    """Validate model class name follows Python naming conventions.
+
+    Args:
+        model_cls_name: Class name to validate
+
+    Raises:
+        ValueError: If class name is invalid
+    """
+    if not model_cls_name:
+        raise ValueError("model_cls_name cannot be empty")
+
+    if not model_cls_name[0].isalpha():
+        raise ValueError(
+            f"model_cls_name must start with a letter. Received: {model_cls_name}"
+        )
+
+    if not all(c.isalnum() or c == "_" for c in model_cls_name):
+        raise ValueError(
+            f"model_cls_name can only contain letters, numbers, and underscores. Received: {model_cls_name}"
+        )
+
+    if model_cls_name[0].islower():
+        raise ValueError(
+            f"model_cls_name should start with an uppercase letter (PEP 8). Received: {model_cls_name}"
+        )
+
+
+def _validate_provider_name(provider_name: str) -> None:
+    """Validate provider name follows Python naming conventions.
+
+    Args:
+        provider_name: Provider name to validate
+
+    Raises:
+        ValueError: If provider name is invalid
+    """
+    if not provider_name:
+        raise ValueError("provider_name cannot be empty")
+
+    if not provider_name[0].isalnum():
+        raise ValueError(
+            f"provider_name must start with a letter. Received: {provider_name}"
+        )
+
+    if not all(c.isalnum() or c == "_" for c in provider_name):
+        raise ValueError(
+            f"provider_name can only contain letters, numbers, underscores. Received: {provider_name}"
+        )
+
+    if len(provider_name) > 20:
+        raise ValueError(
+            f"provider_name must be 20 characters or fewer. Received: {provider_name}"
+        )

{langchain_dev_utils-1.3.3 → langchain_dev_utils-1.3.5}/src/langchain_dev_utils/agents/middleware/format_prompt.py

@@ -11,7 +11,7 @@ def format_prompt(request: ModelRequest) -> str:
     Variables are first resolved from the state, then from the context if not found.
 
     Example:
-        >>> from langchain_dev_utils.agents.middleware.format_prompt import format_prompt
+        >>> from langchain_dev_utils.agents.middleware import format_prompt
         >>> from langchain.agents import create_agent
         >>> from langchain_core.messages import HumanMessage
         >>> from dataclasses import dataclass

{langchain_dev_utils-1.3.3 → langchain_dev_utils-1.3.5}/src/langchain_dev_utils/agents/wrap.py

@@ -171,7 +171,7 @@ def wrap_all_agents_as_tool(
     Example:
         >>> from langchain_dev_utils.agents import wrap_all_agents_as_tool, create_agent
         >>>
-        >>> call_time_agent_tool = wrap_all_agents_as_tool(
+        >>> call_agent_tool = wrap_all_agents_as_tool(
         ...     [time_agent,weather_agent],
         ...     tool_name="call_sub_agents",
         ...     tool_description="Used to invoke the sub-agents to perform tasks"

langchain_dev_utils-1.3.5/src/langchain_dev_utils/chat_models/adapters/__init__.py

@@ -0,0 +1,3 @@
+from .create_utils import create_openai_compatible_model
+
+__all__ = ["create_openai_compatible_model"]

langchain_dev_utils-1.3.5/src/langchain_dev_utils/chat_models/adapters/create_utils.py

@@ -0,0 +1,53 @@
+from typing import Any, Optional, cast
+
+from langchain_core.utils import from_env
+
+from langchain_dev_utils._utils import _check_pkg_install
+
+from ..types import CompatibilityOptions
+
+
+def create_openai_compatible_model(
+    model_provider: str,
+    base_url: Optional[str] = None,
+    compatibility_options: Optional[CompatibilityOptions] = None,
+    model_profiles: Optional[dict[str, dict[str, Any]]] = None,
+    chat_model_cls_name: Optional[str] = None,
+):
+    """Factory function for creating provider-specific OpenAI-compatible model classes.
+
+    Dynamically generates model classes for different OpenAI-compatible providers,
+    configuring environment variable mappings and default base URLs specific to each provider.
+
+    Args:
+        model_provider (str): Identifier for the OpenAI-compatible provider (e.g. `vllm`, `moonshot`)
+        base_url (Optional[str], optional): Default API base URL for the provider. Defaults to None. If not provided, will try to use the environment variable.
+        compatibility_options (Optional[CompatibilityOptions], optional): Optional configuration for compatibility options with the provider. Defaults to None.
+        model_profiles (Optional[dict[str, dict[str, Any]]], optional): Optional model profiles for the provider. Defaults to None.
+        chat_model_cls_name (Optional[str], optional): Optional custom class name for the generated model. Defaults to None.
+    Returns:
+        Type[_BaseChatOpenAICompatible]: Configured model class ready for instantiation with provider-specific settings
+
+    Examples:
+        >>> from langchain_dev_utils.chat_models.adapters import create_openai_compatible_chat_model
+        >>> ChatVLLM = create_openai_compatible_chat_model(
+        ...     "vllm",
+        ...     base_url="http://localhost:8000",
+        ...     chat_model_cls_name="ChatVLLM",
+        ... )
+        >>> model = ChatVLLM(model="qwen3-4b")
+        >>> model.invoke("hello")
+    """
+    _check_pkg_install("langchain_openai")
+    from .openai_compatible import _create_openai_compatible_model
+
+    base_url = (
+        base_url or from_env(f"{model_provider.upper()}_API_BASE", default=None)()
+    )
+    return _create_openai_compatible_model(
+        chat_model_cls_name=chat_model_cls_name,
+        provider=model_provider,
+        base_url=cast(str, base_url),
+        compatibility_options=compatibility_options,
+        profiles=model_profiles,
+    )

{langchain_dev_utils-1.3.3 → langchain_dev_utils-1.3.5}/src/langchain_dev_utils/chat_models/adapters/openai_compatible.py

@@ -12,6 +12,7 @@ from typing import (
     Type,
     TypeVar,
     Union,
+    cast,
 )
 
 import openai
@@ -19,7 +20,11 @@ from langchain_core.callbacks import (
     AsyncCallbackManagerForLLMRun,
     CallbackManagerForLLMRun,
 )
-from langchain_core.language_models import LangSmithParams, LanguageModelInput
+from langchain_core.language_models import (
+    LangSmithParams,
+    LanguageModelInput,
+    ModelProfile,
+)
 from langchain_core.messages import (
     AIMessage,
     AIMessageChunk,
@@ -45,12 +50,21 @@ from pydantic import (
 )
 from typing_extensions import Self
 
+from ..._utils import (
+    _validate_base_url,
+    _validate_model_cls_name,
+    _validate_provider_name,
+)
 from ..types import (
     CompatibilityOptions,
     ReasoningKeepPolicy,
     ResponseFormatType,
     ToolChoiceType,
 )
+from .register_profiles import (
+    _get_profile_by_provider_and_model,
+    _register_profile_with_provider,
+)
 
 _BM = TypeVar("_BM", bound=BaseModel)
 _DictOrPydanticClass = Union[dict[str, Any], type[_BM], type]
@@ -152,7 +166,7 @@ class _BaseChatOpenAICompatible(BaseChatOpenAI):
     Note: This is a template class and should not be exported or instantiated
     directly. Instead, use it as a base class and provide the specific provider
     name through inheritance or the factory function
-    `_create_openai_compatible_model()`.
+    `create_openai_compatible_model()`.
     """
 
     model_name: str = Field(alias="model", default="openai compatible model")
@@ -283,7 +297,10 @@ class _BaseChatOpenAICompatible(BaseChatOpenAI):
     def _set_model_profile(self) -> Self:
         """Set model profile if not overridden."""
         if self.profile is None:
-            self.profile = {}
+            self.profile = cast(
+                ModelProfile,
+                _get_profile_by_provider_and_model(self._provider, self.model_name),
+            )
         return self
 
     def _create_chat_result(
@@ -574,10 +591,57 @@ class _BaseChatOpenAICompatible(BaseChatOpenAI):
         )
 
 
+def _validate_compatibility_options(
+    compatibility_options: Optional[CompatibilityOptions] = None,
+) -> None:
+    """Validate provider configuration against supported features.
+
+    Args:
+        compatibility_options: Optional configuration for the provider
+
+    Raises:
+        ValueError: If provider configuration is invalid
+    """
+    if compatibility_options is None:
+        compatibility_options = {}
+
+    if "supported_tool_choice" in compatibility_options:
+        _supported_tool_choice = compatibility_options["supported_tool_choice"]
+        for tool_choice in _supported_tool_choice:
+            if tool_choice not in ["auto", "none", "required", "specific"]:
+                raise ValueError(
+                    f"Unsupported tool_choice: {tool_choice}. Please choose from 'auto', 'none', 'required','specific'."
+                )
+
+    if "supported_response_format" in compatibility_options:
+        _supported_response_format = compatibility_options["supported_response_format"]
+        for response_format in _supported_response_format:
+            if response_format not in ["json_schema", "json_mode"]:
+                raise ValueError(
+                    f"Unsupported response_format: {response_format}. Please choose from 'json_schema', 'json_mode'."
+                )
+
+    if "reasoning_keep_policy" in compatibility_options:
+        _reasoning_keep_policy = compatibility_options["reasoning_keep_policy"]
+        if _reasoning_keep_policy not in ["never", "current", "all"]:
+            raise ValueError(
+                f"Unsupported reasoning_keep_policy: {_reasoning_keep_policy}. Please choose from 'never', 'current', 'all'."
+            )
+
+    if "include_usage" in compatibility_options:
+        _include_usage = compatibility_options["include_usage"]
+        if not isinstance(_include_usage, bool):
+            raise ValueError(
+                f"include_usage must be a boolean value. Received: {_include_usage}"
+            )
+
+
 def _create_openai_compatible_model(
     provider: str,
     base_url: str,
     compatibility_options: Optional[CompatibilityOptions] = None,
+    profiles: Optional[dict[str, dict[str, Any]]] = None,
+    chat_model_cls_name: Optional[str] = None,
 ) -> Type[_BaseChatOpenAICompatible]:
     """Factory function for creating provider-specific OpenAI-compatible model classes.
 
@@ -588,14 +652,27 @@ def _create_openai_compatible_model(
         provider: Provider identifier (e.g.`vllm`)
         base_url: Default API base URL for the provider
         compatibility_options: Optional configuration for the provider
+        profiles: Optional profiles for the provider
+        chat_model_cls_name: Optional name for the model class
 
     Returns:
         Configured model class ready for instantiation with provider-specific settings
     """
-    chat_model_cls_name = f"Chat{provider.title()}"
+    chat_model_cls_name = chat_model_cls_name or f"Chat{provider.title()}"
     if compatibility_options is None:
         compatibility_options = {}
 
+    if profiles is not None:
+        _register_profile_with_provider(provider, profiles)
+
+    _validate_compatibility_options(compatibility_options)
+
+    _validate_provider_name(provider)
+
+    _validate_model_cls_name(chat_model_cls_name)
+
+    _validate_base_url(base_url)
+
     return create_model(
         chat_model_cls_name,
         __base__=_BaseChatOpenAICompatible,