uipath-langchain 0.0.87__tar.gz → 0.0.89__tar.gz

uipath_langchain-0.0.89/.github/workflows/commitlint.yml

@@ -0,0 +1,28 @@
+name: Commit Lint
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  commit-lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+
+      - name: Lint commits
+        uses: wagoid/commitlint-github-action@v3
+
+      - name: Block fixup commits
+        if: ${{ github.event_name != 'merge_group' }}
+        uses: 13rac1/block-fixup-merge-action@v2.0.0
+
+      - name: Block Merge Commits
+        if: ${{ github.event_name != 'merge_group' }}
+        uses: Morishiri/block-merge-commits-action@v1.0.1
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}

{uipath_langchain-0.0.87 → uipath_langchain-0.0.89}/PKG-INFO

@@ -1,14 +1,13 @@
 Metadata-Version: 2.4
 Name: uipath-langchain
-Version: 0.0.87
+Version: 0.0.89
 Summary: UiPath Langchain
 Project-URL: Homepage, https://uipath.com
-Project-URL: Repository, https://github.com/UiPath/uipath-python
+Project-URL: Repository, https://github.com/UiPath/uipath-langchain-python
 Maintainer-email: Marius Cosareanu <marius.cosareanu@uipath.com>, Cristian Pufu <cristian.pufu@uipath.com>
 License-File: LICENSE
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -26,7 +25,7 @@ Requires-Dist: pydantic-settings>=2.6.0
 Requires-Dist: python-dotenv>=1.0.1
 Requires-Dist: requests>=2.23.3
 Requires-Dist: types-requests>=2.32.0.20241016
-Requires-Dist: uipath==2.0.1
+Requires-Dist: uipath<2.1.0,>=2.0.7
 Provides-Extra: langchain
 Description-Content-Type: text/markdown
 

uipath_langchain-0.0.89/docs/chat_models.md

@@ -0,0 +1,91 @@
+# UiPath chat models
+
+UiPath provides two chat models `UiPathAzureChatOpenAI` and `UiPathNormalizedChatModel`. These are compatible with langgraph as drop in replacements. You do not need to add tokens from OpenAI or Anthropic, usage of these chat models will consume `AI Units` on your account.
+
+## UiPathAzureChatOpenAI
+
+`UiPathAzureChatOpenAI` can be used as a drop in replacement for `ChatOpenAI` or `AzureChatOpenAI`. 
+
+### Example usage
+
+Here is a code that is using `ChatOpenAI`
+```python
+from langchain_openai import ChatOpenAI
+
+llm = ChatOpenAI(
+    model="gpt-4o",
+    temperature=0,
+    max_tokens=None,
+    timeout=None,
+    max_retries=2,
+    # api_key="...",  # if you prefer to pass api key in directly instaed of using env vars
+    # base_url="...",
+    # organization="...",
+    # other params...
+)
+```
+
+You can simply change `ChatOpenAi` with `UiPathAzureChatOpenAI`, you don't have to provide an `OPEN_AI_TOKEN`
+
+
+```python
+from uipath_langchain.chat.models import UiPathAzureChatOpenAI
+
+llm = UiPathAzureChatOpenAI(
+    model="gpt-4o",
+    temperature=0,
+    max_tokens=None,
+    timeout=None,
+    max_retries=2,
+    # other params...
+)
+```
+
+Currently the following models can be used with `UiPathAzureChatOpenAI` (this list can be updated in the future): 
+- `gpt-4`, `gpt-4-1106-Preview`, `gpt-4-32k`, `gpt-4-turbo-2024-04-09`, `gpt-4-vision-preview`, `gpt-4o-2024-05-13`, `gpt-4o-2024-08-06`, `gpt-4o-mini-2024-07-18`, `o3-mini-2025-01-31`
+
+
+## UiPathNormalizedChatModel
+
+`UiPathNormalizedChatModel` is a more versatile clas that can suport models from diferent vendors including OpenAI.
+
+### Example usage
+
+Given the following code:
+
+```python
+from langchain_anthropic import ChatAnthropic
+
+llm = ChatAnthropic(
+    model="claude-3-5-sonnet-20240620",
+    temperature=0,
+    max_tokens=1024,
+    timeout=None,
+    max_retries=2,
+    # other params...
+)
+```
+
+You can replace it with `UiPathNormalizedChatModel` like so:
+
+```python
+from uipath_langchain.chat.models import UiPathNormalizedChatModel
+
+llm = UiPathNormalizedChatModel(
+    model="anthropic.claude-3-opus-20240229-v1:0",
+    temperature=0,
+    max_tokens=1024,
+    timeout=None,
+    max_retries=2,
+    # other params...
+)
+```
+
+Currently the following models can be used with `UiPathAzureChatOpenAI` (this list can be updated in the future): 
+- `anthropic.claude-3-5-sonnet-20240620-v1:0`, `anthropic.claude-3-5-sonnet-20241022-v2:0`, `anthropic.claude-3-7-sonnet-20250219-v1:0`, `anthropic.claude-3-haiku-20240307-v1:0`, `gemini-1.5-pro-001`, `gemini-2.0-flash-001`, `gpt-4o-2024-05-13`, `gpt-4o-2024-08-06`, `gpt-4o-2024-11-20`, `gpt-4o-mini-2024-07-18`, `o3-mini-2025-01-31`
+
+### Note 
+
+Please note that that you may get errors related to data residency, as some models are not available on all regions.
+
+Example: `[Enforced Region] No model configuration found for product uipath-python-sdk in EU using model anthropic.claude-3-opus-20240229-v1:0`.

uipath_langchain-0.0.89/docs/context_grounding_chain.md

@@ -0,0 +1,38 @@
+# ContextGroundingVectorStore
+
+`ContextGroundingVectorStore` is a vector store implementation designed for context-aware document retrieval. It allows you to perform semantic searches and create retrieval chains with language models.
+
+## Initialization
+
+You can initialize the vector store with an index name:
+
+```python
+    from uipath_langchain.vectorstores.context_grounding_vectorstore import ContextGroundingVectorStore
+
+    vectorstore = ContextGroundingVectorStore(index_name=index_name)
+```
+
+## Searching Documents
+
+The vector store supports various search methods:
+
+```python
+    # Perform semantic searches with distance scores
+    docs_with_scores = await vectorstore.asimilarity_search_with_score(query=query, k=5)
+
+    # Perform a similarity search with relevance scores
+    docs_with_relevance_scores = await vectorstore.asimilarity_search_with_relevance_scores(query=query, k=5)
+```
+
+## Creating a Retrieval Chain
+
+You can integrate the vector store into a retrieval chain with a language model:
+
+```python
+    # Run a retrieval chain
+    model = UiPathAzureChatOpenAI(model="gpt-4o-2024-08-06", max_retries=3)
+    retrieval_chain = create_retrieval_chain(vectorstore=vectorstore, model=model)
+
+    query = "What is the ECCN for a laptop?"
+    result = retrieval_chain(query)
+```

uipath_langchain-0.0.89/docs/context_grounding_retriever.md

@@ -0,0 +1,46 @@
+# Context Grounding Retriever
+
+The `ContextGroundingRetriever` is a document retrieval system that uses vector search to efficiently find and retrieve relevant information from your document store.
+
+## Overview
+
+`ContextGroundingRetriever` allows you to:
+- Search through indexed documents using natural language queries
+- Ground LLM responses in your organization's specific information
+- Retrieve context-relevant documents for various applications
+
+
+## Basic Usage
+
+Create a simple retriever by specifying an index name:
+
+```python
+from uipath_langchain.retrievers import ContextGroundingRetriever
+
+retriever = ContextGroundingRetriever(index_name = "Company Policy Context")
+pprint(retriever.invoke("What is the company policy on remote work?"))
+```
+
+## Integration with LangChain Tools
+
+You can easily integrate the retriever with LangChain's tool system:
+
+```python
+from langchain.tools.retriever import create_retriever_tool
+from uipath_langchain.retrievers import ContextGroundingRetriever
+
+retriever = ContextGroundingRetriever(index_name = "Company Policy Context")
+retriever_tool = create_retriever_tool(
+    retriever,
+    "ContextforInvoiceDisputeInvestigation",
+   """
+   Use this tool to search the company internal documents for information about policies around dispute resolution.
+   Use a meaningful query to load relevant information from the documents. Save the citation for later use.
+   """
+)
+```
+
+
+## Advanced Usage
+
+For complex applications, the retriever can be combined with other LangChain components to create robust document QA systems, agents, or knowledge bases.

{uipath_langchain-0.0.87 → uipath_langchain-0.0.89}/docs/interrupt_models.md

@@ -9,7 +9,9 @@ UiPath platform and the Langchain coded agents.
 
 ### 1. InvokeProcess
 
-The `InvokeProcess` model is utilized to invoke a process within UiPath cloud platform. Upon completion of the invoked process, the current agent will automatically resume execution.
+The `InvokeProcess` model is utilized to invoke a process within the UiPath cloud platform.
+This process can be of various types, including API workflows, Agents or RPA automation.
+Upon completion of the invoked process, the current agent will automatically resume execution.
 
 #### Attributes:
 - **name** (str): The name of the process to invoke.
@@ -20,6 +22,8 @@ The `InvokeProcess` model is utilized to invoke a process within UiPath cloud pl
 process_output = interrupt(InvokeProcess(name="MyProcess", input_arguments={"arg1": "value1"}))
 ```
 
+For a practical implementation of the `InvokeProcess` model, refer to the sample usage in the [planner.py](../../samples/multi-agent-planner-researcher-coder-distributed/src/multi-agent-distributed/planner.py#L184) file. This example demonstrates how to invoke a process with dynamic input arguments, showcasing the integration of the interrupt functionality within a multi-agent system or a system where an agent integrates with RPA processes and API workflows.
+
 ---
 
 ### 2. WaitJob

{uipath_langchain-0.0.87 → uipath_langchain-0.0.89}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "uipath-langchain"
-version = "0.0.87"
+version = "0.0.89"
 description = "UiPath Langchain"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"
 dependencies = [
-    "uipath==2.0.1",
+    "uipath>=2.0.7, <2.1.0",
     "langgraph>=0.2.70",
     "langchain-core>=0.3.34",
     "langgraph-checkpoint-sqlite>=2.0.3",
@@ -23,7 +23,6 @@ classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "Topic :: Software Development :: Build Tools",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -38,7 +37,7 @@ register = "uipath_langchain.middlewares:register_middleware"
 
 [project.urls]
 Homepage = "https://uipath.com"
-Repository = "https://github.com/UiPath/uipath-python"
+Repository = "https://github.com/UiPath/uipath-langchain-python"
 
 [build-system]
 requires = ["hatchling"]

{uipath_langchain-0.0.87 → uipath_langchain-0.0.89}/samples/company-research-agent/pyproject.toml

@@ -5,14 +5,13 @@ description = "Company research agent with Tavily web search"
 authors = [
     { name = "John Doe" }
 ]
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 dependencies = [
     "langgraph>=0.2.55",
     "langchain-community>=0.3.9",
     "langchain-anthropic>=0.3.8",
     "tavily-python>=0.5.0",
-    "uipath-sdk==0.0.110",
-    "uipath-langchain==0.0.81"
+    "uipath-langchain==0.0.88"
 ]
 
 [project.optional-dependencies]