The agent engineering platform.
Python agentsaiai-agentsanthropicchatgptdeepagentsenterpriseframeworkgeminigenerative-ailangchainlanggraphllmmultiagentopen-sourceopenaipydanticpythonragtypescript
docs: add usage examples to core classes (#34841)
XXt6e307be10115
diff --git a/libs/core/langchain_core/caches.py b/libs/core/langchain_core/caches.pyindex 2f63941098..efeedea525 100644--- a/libs/core/langchain_core/caches.py+++ b/libs/core/langchain_core/caches.py@@ -153,7 +153,31 @@ class BaseCache(ABC):class InMemoryCache(BaseCache):- """Cache that stores things in memory."""+ """Cache that stores things in memory.++ Example:+ ```python+ from langchain_core.caches import InMemoryCache+ from langchain_core.outputs import Generation++ # Initialize cache+ cache = InMemoryCache()++ # Update cache+ cache.update(+ prompt="What is the capital of France?",+ llm_string="model='gpt-3.5-turbo', temperature=0.1",+ return_val=[Generation(text="Paris")],+ )++ # Lookup cache+ result = cache.lookup(+ prompt="What is the capital of France?",+ llm_string="model='gpt-3.5-turbo', temperature=0.1",+ )+ # result is [Generation(text="Paris")]+ ```+ """def __init__(self, *, maxsize: int | None = None) -> None:"""Initialize with empty cache.diff --git a/libs/core/langchain_core/example_selectors/length_based.py b/libs/core/langchain_core/example_selectors/length_based.pyindex aaa7291305..e60e47e891 100644--- a/libs/core/langchain_core/example_selectors/length_based.py+++ b/libs/core/langchain_core/example_selectors/length_based.py@@ -15,7 +15,38 @@ def _get_length_based(text: str) -> int:class LengthBasedExampleSelector(BaseExampleSelector, BaseModel):- """Select examples based on length."""+ r"""Select examples based on length.++ Example:+ ```python+ from langchain_core.example_selectors import LengthBasedExampleSelector+ from langchain_core.prompts import PromptTemplate++ # Define examples+ examples = [+ {"input": "happy", "output": "sad"},+ {"input": "tall", "output": "short"},+ {"input": "fast", "output": "slow"},+ ]++ # Create prompt template+ example_prompt = PromptTemplate(+ input_variables=["input", "output"],+ template="Input: {input}\nOutput: {output}",+ )++ # Create selector with max length constraint+ selector = LengthBasedExampleSelector(+ examples=examples,+ example_prompt=example_prompt,+ max_length=50, # Maximum prompt length+ )++ # Select examples for a new input+ selected = selector.select_examples({"input": "large", "output": "tiny"})+ # Returns examples that fit within max_length constraint+ ```+ """examples: list[dict]"""A list of the examples that the prompt template expects."""