langchain 1.0.2__py3-none-any.whl → 1.0.3__py3-none-any.whl

langchain/embeddings/__init__.py

@@ -1,4 +1,4 @@
-"""Embeddings.
+"""Embeddings models.
 
 !!! warning "Reference docs"
     This page contains **reference documentation** for Embeddings. See

langchain/embeddings/base.py

@@ -126,26 +126,27 @@ def init_embeddings(
     provider: str | None = None,
     **kwargs: Any,
 ) -> Embeddings:
-    """Initialize an embeddings model from a model name and optional provider.
+    """Initialize an embedding model from a model name and optional provider.
 
     !!! note
-        Must have the integration package corresponding to the model provider
-        installed.
+        Requires the integration package for the chosen model provider to be installed.
 
-    Args:
-        model: Name of the model to use.
+        See the `model_provider` parameter below for specific package names
+        (e.g., `pip install langchain-openai`).
 
-            Can be either:
+        Refer to the [provider integration's API reference](https://docs.langchain.com/oss/python/integrations/providers)
+        for supported model parameters to use as `**kwargs`.
 
-            - A model string like `"openai:text-embedding-3-small"`
-            - Just the model name if the provider is specified separately or can be
-                inferred.
+    Args:
+        model: The name of the model, e.g. `'openai:text-embedding-3-small'`.
 
-            See supported providers under the `provider` arg description.
-        provider: Optional explicit provider name. If not specified, will attempt to
-            parse from the model string in the `model` arg.
+            You can also specify model and model provider in a single argument using
+            `'{model_provider}:{model}'` format, e.g. `'openai:text-embedding-3-small'`.
+        provider: The model provider if not specified as part of the model arg
+            (see above).
 
-            Supported providers:
+            Supported `provider` values and the corresponding integration package
+            are:
 
             - `openai`                  -> [`langchain-openai`](https://docs.langchain.com/oss/python/integrations/providers/openai)
             - `azure_openai`            -> [`langchain-openai`](https://docs.langchain.com/oss/python/integrations/providers/openai)
@@ -157,7 +158,10 @@ def init_embeddings(
             - `ollama`                  -> [`langchain-ollama`](https://docs.langchain.com/oss/python/integrations/providers/ollama)
 
         **kwargs: Additional model-specific parameters passed to the embedding model.
-            These vary by provider, see the provider-specific documentation for details.
+
+            These vary by provider. Refer to the specific model provider's
+            [integration reference](https://reference.langchain.com/python/integrations/)
+            for all available parameters.
 
     Returns:
         An `Embeddings` instance that can generate embeddings for text.
@@ -166,9 +170,11 @@ def init_embeddings(
         ValueError: If the model provider is not supported or cannot be determined
         ImportError: If the required provider package is not installed
 
-    ???+ note "Example Usage"
+    ???+ example
 
         ```python
+        # pip install langchain langchain-openai
+
         # Using a model string
         model = init_embeddings("openai:text-embedding-3-small")
         model.embed_query("Hello, world!")

langchain/messages/__init__.py

@@ -1,4 +1,4 @@
-"""Message types.
+"""Message and message content types.
 
 Includes message types for different roles (e.g., human, AI, system), as well as types
 for message content blocks (e.g., text, image, audio) and tool calls.
@@ -21,10 +21,12 @@ from langchain_core.messages import (
     FileContentBlock,
     HumanMessage,
     ImageContentBlock,
+    InputTokenDetails,
     InvalidToolCall,
     MessageLikeRepresentation,
     NonStandardAnnotation,
     NonStandardContentBlock,
+    OutputTokenDetails,
     PlainTextContentBlock,
     ReasoningContentBlock,
     RemoveMessage,
@@ -36,6 +38,7 @@ from langchain_core.messages import (
     ToolCall,
     ToolCallChunk,
     ToolMessage,
+    UsageMetadata,
     VideoContentBlock,
     trim_messages,
 )
@@ -52,10 +55,12 @@ __all__ = [
     "FileContentBlock",
     "HumanMessage",
     "ImageContentBlock",
+    "InputTokenDetails",
     "InvalidToolCall",
     "MessageLikeRepresentation",
     "NonStandardAnnotation",
     "NonStandardContentBlock",
+    "OutputTokenDetails",
     "PlainTextContentBlock",
     "ReasoningContentBlock",
     "RemoveMessage",
@@ -67,6 +72,7 @@ __all__ = [
     "ToolCall",
     "ToolCallChunk",
     "ToolMessage",
+    "UsageMetadata",
     "VideoContentBlock",
     "trim_messages",
 ]