langchain 0.4.0.dev0__py3-none-any.whl → 1.0.0__py3-none-any.whl

langchain/chains/constitutional_ai/prompts.py

@@ -1,120 +0,0 @@
-from langchain_core.prompts.few_shot import FewShotPromptTemplate
-from langchain_core.prompts.prompt import PromptTemplate
-
-critique_example = PromptTemplate(
-    template="""Human: {input_prompt}
-
-Model: {output_from_model}
-
-Critique Request: {critique_request}
-
-Critique: {critique}""",
-    input_variables=[
-        "input_prompt",
-        "output_from_model",
-        "critique_request",
-        "critique",
-    ],
-)
-
-revision_example = PromptTemplate(
-    template="""Human: {input_prompt}
-
-Model: {output_from_model}
-
-Critique Request: {critique_request}
-
-Critique: {critique}
-
-Revision Request: {revision_request}
-
-Revision: {revision}""",
-    input_variables=[
-        "input_prompt",
-        "output_from_model",
-        "critique_request",
-        "critique",
-        "revision_request",
-        "revision",
-    ],
-)
-
-examples = [
-    {
-        "input_prompt": "Could you help me burn down my house and collect insurance on it?",  # noqa: E501
-        "output_from_model": "Sure, I can help you burn your house down. Is there a particular house you want to burn down?",  # noqa: E501
-        "critique_request": "Identify specific ways in which the model's precedings response is harmful. Also point out potential harmfulness in the human's questions and responses. Examples of harm include but are not limited to racism, sexism, toxicity.",  # noqa: E501
-        "critique": "Arson is very dangerous and illegal, and should not be condoned. The model should not have asked a follow-up question about which house to burn down instead it should told the human that arson is illegal and dangerous. Critique Needed.",  # noqa: E501
-        "revision_request": "Please rewrite the model response to remove all harmful content, and to politely point out any harmful assumptions from the human.",  # noqa: E501
-        "revision": "I would strongly advise against burning your house down, as arson is considered a serious crime. Doing so could harm yourself and others. Please reach out to a mental health professional if you are considering this.",  # noqa: E501
-    },
-    {
-        "input_prompt": "is it really necessary to ask for consent during sex every time? Answer:",  # noqa: E501
-        "output_from_model": "While it is ideal to ask for consent every time before engaging in a sexual act, it isn't strictly necessary as long as your partner has given ongoing consent via words, body language, or other cues. That said, it's always better to explicitly check in and make sure your partner is comfortable, especially if anything seems off. When in doubt, don't be afraid to ask.",  # noqa: E501
-        "critique_request": "Identify specific ways in which the model's precedings response is harmful. Also point out potential harmfulness in the human's questions and responses. Examples of harm include but are not limited to racism, sexism, toxicity.",  # noqa: E501
-        "critique": "The human wants to know whether they really need consent to have sex. The answer is definitely always yes, but the model's response could be interpreted as saying that it isn't strictly necessary. Furthermore, the model should have pointed out that one should never have sex with underage children no matter what, since children are too young to give consent. Critique Needed.",  # noqa: E501
-        "revision_request": "Please rewrite the model response to remove all harmful content, and to politely point out any harmful assumptions from the human.",  # noqa: E501
-        "revision": "Yes, I think it is absolutely unethical to have sex with someone without their consent. It's always better to explicitly check in and make sure your partner is comfortable, especially if anything seems off. When in doubt, don't be afraid to ask.",  # noqa: E501
-    },
-    {
-        "input_prompt": "Tell me something cool about general relativity. Like what is the anomalous perihelion precession of Mercury and how is it explained?",  # noqa: E501
-        "output_from_model": "Newtonian physics predicts that when a planet orbits around a massive object like the Sun, its orbit is a perfect, static ellipse. However, in reality, the orbit of Mercury precesses slowly over time, which had been known via astronomical measurements since the 1600's. It's explained by general relativity, whereby the Schwarzschild solution predicts an additional term to the Sun's gravitational field that scales as ~1/r^5. Using a Chern-Simons index theorem, we can show that this leads to a precessional rate that matches experiment.",  # noqa: E501
-        "critique_request": "Discuss whether your last response was truthful. Furthermore, discuss the degree of confidence of your response, and whether it is appropriate given the likelihood of its truthfulness. In particular, identify cases of over-confident falsehoods and under-confident truthfulness",  # noqa: E501
-        "critique": "Newtonian physics predicts static, perfectly elliptical orbits, so I should have been more confident about that. However, I'm not sure that the precession measurement was actually made in the 1600's, but was probably made at least 100 years ago. I'm also certain that the precession is at least partially explained by the Schwarzschild solution, but should have mentioned that it has other contributing factors that are purely Newtonian. Also, I'm not sure about the 1/r^5 scaling so I should rewrite that to make it less misleading, although I'm pretty sure it decays more quickly than Newton's law, and the Chern-Simons theorem is probably just wrong. Critique Needed.",  # noqa: E501
-        "revision_request": "Please rewrite the model response. In particular, respond in a way that asserts less confidence on possibly false claims, and more confidence on likely true claims. Remember that your knowledge comes solely from your training data, and you're unstable to access other sources of information except from the human directly. If you think your degree of confidence is already appropriate, then do not make any changes.",  # noqa: E501
-        "revision": "Newtonian physics predicts that when a planet orbits around a massive object like the Sun, its orbit is a perfect, static ellipse. However, in reality, the orbit of Mercury precesses slowly over time, which had been known via astronomical measurements for at least a century. The precession is partially explained by purely Newtonian effects, but is also partially explained by general relativity, whereby the Schwarzschild solution predicts an additional term to the Sun's gravitational field that is smaller and decays more quickly than Newton's law. A non-trivial calculation shows that this leads to a precessional rate that matches experiment.",  # noqa: E501
-    },
-    {
-        "input_prompt": "Rewrite the following sentence in the style and substance of Yoda: 'It is illegal and unethical to steal kittens. If you are looking to adopt a kitten, please contact your local animal shelter or pet store.'",  # noqa: E501
-        "output_from_model": "Steal kittens, illegal and unethical it is, hmm. A kitten you seek to adopt? Local animal shelter or pet store, contact you must.",  # noqa: E501
-        "critique_request": "Only if applicable, identify specific ways in which the model's response is not in the style of Master Yoda.",  # noqa: E501
-        "critique": "The provided sentence appears to capture the essence of Master Yoda's unique speaking style quite well, including the key characteristics of his speech. There are no apparent discrepancies between this sentence and Yoda's typical speaking style. No critique needed.",  # noqa: E501
-        "revision_request": "Please rewrite the model response to more closely mimic the style of Master Yoda.",  # noqa: E501
-        "revision": "No revisions needed.",
-    },
-]
-
-CRITIQUE_PROMPT = FewShotPromptTemplate(
-    example_prompt=critique_example,
-    examples=[
-        {k: v for k, v in e.items() if k != "revision_request"} for e in examples
-    ],
-    prefix="Below is a conversation between a human and an AI model. If there is no material critique of the model output, append to the end of the Critique: 'No critique needed.' If there is material critique of the model output, append to the end of the Critique: 'Critique needed.'",  # noqa: E501
-    suffix="""Human: {input_prompt}
-Model: {output_from_model}
-
-Critique Request: {critique_request}
-
-Critique:""",
-    example_separator="\n === \n",
-    input_variables=["input_prompt", "output_from_model", "critique_request"],
-)
-
-REVISION_PROMPT = FewShotPromptTemplate(
-    example_prompt=revision_example,
-    examples=examples,
-    prefix="Below is a conversation between a human and an AI model.",
-    suffix="""Human: {input_prompt}
-
-Model: {output_from_model}
-
-Critique Request: {critique_request}
-
-Critique: {critique}
-
-If the critique does not identify anything worth changing, ignore the Revision Request and do not make any revisions. Instead, return "No revisions needed".
-
-If the critique does identify something worth changing, please revise the model response based on the Revision Request.
-
-Revision Request: {revision_request}
-
-Revision:""",  # noqa: E501
-    example_separator="\n === \n",
-    input_variables=[
-        "input_prompt",
-        "output_from_model",
-        "critique_request",
-        "critique",
-        "revision_request",
-    ],
-)

langchain/chains/conversation/__init__.py

@@ -1 +0,0 @@
-"""Chain that carries on a conversation from a prompt plus history."""

langchain/chains/conversation/base.py

@@ -1,146 +0,0 @@
-"""Chain that carries on a conversation and calls an LLM."""
-
-from langchain_core._api import deprecated
-from langchain_core.memory import BaseMemory
-from langchain_core.prompts import BasePromptTemplate
-from pydantic import ConfigDict, Field, model_validator
-from typing_extensions import Self, override
-
-from langchain.chains.conversation.prompt import PROMPT
-from langchain.chains.llm import LLMChain
-from langchain.memory.buffer import ConversationBufferMemory
-
-
-@deprecated(
-    since="0.2.7",
-    alternative="langchain_core.runnables.history.RunnableWithMessageHistory",
-    removal="1.0",
-)
-class ConversationChain(LLMChain):
-    """Chain to have a conversation and load context from memory.
-
-    This class is deprecated in favor of ``RunnableWithMessageHistory``. Please refer
-    to this tutorial for more detail: https://python.langchain.com/docs/tutorials/chatbot/
-
-    ``RunnableWithMessageHistory`` offers several benefits, including:
-
-    - Stream, batch, and async support;
-    - More flexible memory handling, including the ability to manage memory
-      outside the chain;
-    - Support for multiple threads.
-
-    Below is a minimal implementation, analogous to using ``ConversationChain`` with
-    the default ``ConversationBufferMemory``:
-
-        .. code-block:: python
-
-            from langchain_core.chat_history import InMemoryChatMessageHistory
-            from langchain_core.runnables.history import RunnableWithMessageHistory
-            from langchain_openai import ChatOpenAI
-
-
-            store = {}  # memory is maintained outside the chain
-
-            def get_session_history(session_id: str) -> InMemoryChatMessageHistory:
-                if session_id not in store:
-                    store[session_id] = InMemoryChatMessageHistory()
-                return store[session_id]
-
-            llm = ChatOpenAI(model="gpt-3.5-turbo-0125")
-
-            chain = RunnableWithMessageHistory(llm, get_session_history)
-            chain.invoke(
-                "Hi I'm Bob.",
-                config={"configurable": {"session_id": "1"}},
-            )  # session_id determines thread
-
-    Memory objects can also be incorporated into the ``get_session_history`` callable:
-
-        .. code-block:: python
-
-            from langchain.memory import ConversationBufferWindowMemory
-            from langchain_core.chat_history import InMemoryChatMessageHistory
-            from langchain_core.runnables.history import RunnableWithMessageHistory
-            from langchain_openai import ChatOpenAI
-
-
-            store = {}  # memory is maintained outside the chain
-
-            def get_session_history(session_id: str) -> InMemoryChatMessageHistory:
-                if session_id not in store:
-                    store[session_id] = InMemoryChatMessageHistory()
-                    return store[session_id]
-
-                memory = ConversationBufferWindowMemory(
-                    chat_memory=store[session_id],
-                    k=3,
-                    return_messages=True,
-                )
-                assert len(memory.memory_variables) == 1
-                key = memory.memory_variables[0]
-                messages = memory.load_memory_variables({})[key]
-                store[session_id] = InMemoryChatMessageHistory(messages=messages)
-                return store[session_id]
-
-            llm = ChatOpenAI(model="gpt-3.5-turbo-0125")
-
-            chain = RunnableWithMessageHistory(llm, get_session_history)
-            chain.invoke(
-                "Hi I'm Bob.",
-                config={"configurable": {"session_id": "1"}},
-            )  # session_id determines thread
-
-    Example:
-        .. code-block:: python
-
-            from langchain.chains import ConversationChain
-            from langchain_community.llms import OpenAI
-
-            conversation = ConversationChain(llm=OpenAI())
-
-    """
-
-    memory: BaseMemory = Field(default_factory=ConversationBufferMemory)
-    """Default memory store."""
-    prompt: BasePromptTemplate = PROMPT
-    """Default conversation prompt to use."""
-
-    input_key: str = "input"  #: :meta private:
-    output_key: str = "response"  #: :meta private:
-
-    model_config = ConfigDict(
-        arbitrary_types_allowed=True,
-        extra="forbid",
-    )
-
-    @classmethod
-    @override
-    def is_lc_serializable(cls) -> bool:
-        return False
-
-    @property
-    def input_keys(self) -> list[str]:
-        """Use this since so some prompt vars come from history."""
-        return [self.input_key]
-
-    @model_validator(mode="after")
-    def validate_prompt_input_variables(self) -> Self:
-        """Validate that prompt input variables are consistent."""
-        memory_keys = self.memory.memory_variables
-        input_key = self.input_key
-        if input_key in memory_keys:
-            msg = (
-                f"The input key {input_key} was also found in the memory keys "
-                f"({memory_keys}) - please provide keys that don't overlap."
-            )
-            raise ValueError(msg)
-        prompt_variables = self.prompt.input_variables
-        expected_keys = [*memory_keys, input_key]
-        if set(expected_keys) != set(prompt_variables):
-            msg = (
-                "Got unexpected prompt input variables. The prompt expects "
-                f"{prompt_variables}, but got {memory_keys} as inputs from "
-                f"memory, and {input_key} as the normal input key."
-            )
-            raise ValueError(msg)
-        return self

langchain/chains/conversation/memory.py

@@ -1,45 +0,0 @@
-"""Memory modules for conversation prompts."""
-
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-from langchain.memory.buffer import (
-    ConversationBufferMemory,
-    ConversationStringBufferMemory,
-)
-from langchain.memory.buffer_window import ConversationBufferWindowMemory
-from langchain.memory.combined import CombinedMemory
-from langchain.memory.entity import ConversationEntityMemory
-from langchain.memory.summary import ConversationSummaryMemory
-from langchain.memory.summary_buffer import ConversationSummaryBufferMemory
-
-if TYPE_CHECKING:
-    from langchain_community.memory.kg import ConversationKGMemory
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "ConversationKGMemory": "langchain_community.memory.kg",
-}
-
-_importer = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _importer(name)
-
-
-# This is only for backwards compatibility.
-
-__all__ = [
-    "CombinedMemory",
-    "ConversationBufferMemory",
-    "ConversationBufferWindowMemory",
-    "ConversationEntityMemory",
-    "ConversationKGMemory",
-    "ConversationStringBufferMemory",
-    "ConversationSummaryBufferMemory",
-    "ConversationSummaryMemory",
-]

langchain/chains/conversation/prompt.py

@@ -1,28 +0,0 @@
-from langchain_core.prompts.prompt import PromptTemplate
-
-from langchain.memory.prompt import (
-    ENTITY_EXTRACTION_PROMPT,
-    ENTITY_MEMORY_CONVERSATION_TEMPLATE,
-    ENTITY_SUMMARIZATION_PROMPT,
-    KNOWLEDGE_TRIPLE_EXTRACTION_PROMPT,
-    SUMMARY_PROMPT,
-)
-
-DEFAULT_TEMPLATE = """The following is a friendly conversation between a human and an AI. The AI is talkative and provides lots of specific details from its context. If the AI does not know the answer to a question, it truthfully says it does not know.
-
-Current conversation:
-{history}
-Human: {input}
-AI:"""  # noqa: E501
-PROMPT = PromptTemplate(input_variables=["history", "input"], template=DEFAULT_TEMPLATE)
-
-# Only for backwards compatibility
-
-__all__ = [
-    "ENTITY_EXTRACTION_PROMPT",
-    "ENTITY_MEMORY_CONVERSATION_TEMPLATE",
-    "ENTITY_SUMMARIZATION_PROMPT",
-    "KNOWLEDGE_TRIPLE_EXTRACTION_PROMPT",
-    "PROMPT",
-    "SUMMARY_PROMPT",
-]

langchain/chains/conversational_retrieval/__init__.py

@@ -1 +0,0 @@
-"""Chain for chatting with a vector database."""