feat: add attachments support for coded conversational agents

Author: GabrielVasilescu04

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath-langchain"
-version = "0.7.7"
+version = "0.7.8"
 description = "Python SDK that enables developers to build and deploy LangGraph agents to the UiPath Cloud Platform"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"

samples/chat-hitl-agent/graph.py

@@ -1,7 +1,7 @@
 from langchain_anthropic import ChatAnthropic
 from langchain_tavily import TavilySearch
 from langchain.agents import create_agent
-from uipath_langchain.chat import requires_approval
+from uipath_langchain.chat.tools import requires_approval
 
 tavily_tool = TavilySearch(max_results=5)
 

samples/file-attachments-chat-agent/.env.example

@@ -0,0 +1,3 @@
+UIPATH_ACCESS_TOKEN=YOUR TOKEN HERE
+UIPATH_URL=https://alpha.uipath.com/<organization>/<tenant>
+OPENAI_API_KEY=your_openai_api_key

samples/file-attachments-chat-agent/README.md

@@ -0,0 +1,42 @@
+# File Attachments Chat Agent
+
+An AI assistant that reads and analyzes file attachments shared in the conversation.
+
+## Requirements
+
+- Python 3.11+
+- OpenAI API key
+
+## Installation
+
+```bash
+uv venv -p 3.11 .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+uv sync
+```
+
+Set your API key as an environment variable in .env
+
+```bash
+OPENAI_API_KEY=your_openai_api_key
+```
+
+## Usage
+
+**1.** Upload the file to Orchestrator using the [attachments API](https://uipath.github.io/uipath-python/core/attachments/).
+
+**2.** Run the agent, passing the attachment ID and file metadata returned by the upload:
+
+```bash
+uipath run agent '{
+  "messages": [
+    {
+      "type": "human",
+      "content": [
+        { "type": "text", "text": "Summarize this document." },
+        { "type": "text", "text": "<uip:attachments>[{\"id\": \"{orchestrator_attachment_id}\", \"full_name\": \"{file_name}\", \"mime_type\": \"{file_mime_type}\"}]</uip:attachments>" }
+      ]
+    }
+  ]
+}'
+```

samples/file-attachments-chat-agent/agent.mermaid

@@ -0,0 +1,9 @@
+flowchart TB
+  __start__(__start__)
+  model(model)
+  tools(tools)
+  __end__(__end__)
+  __start__ --> model
+  model --> __end__
+  model --> tools
+  tools --> model

samples/file-attachments-chat-agent/langgraph.json

@@ -0,0 +1,5 @@
+{
+    "graphs": {
+      "agent": "./main.py:graph"
+    }
+}

samples/file-attachments-chat-agent/main.py

@@ -0,0 +1,32 @@
+from langchain.agents import create_agent
+from langchain_openai import ChatOpenAI
+
+from uipath_langchain.chat.tools import AnalyzeAttachmentsTool
+
+system_prompt = """
+You are an AI assistant specialized in analyzing user-provided files using the available file analysis tool.
+Always use the provided tool to read and analyze any uploaded or referenced file. Never guess or fabricate file contents. If a file is missing or inaccessible, ask the user to upload it again.
+
+When a file is received:
+    1.Identify the file type.
+    2.Provide a clear, concise summary.
+    3.Extract key information relevant to the user’s request.
+    4.Highlight important patterns, issues, or insights when applicable.
+    5.If the user’s request is unclear, ask a focused clarification question before proceeding.
+
+For follow-up questions:
+    1.Base all answers strictly on the file contents.
+    2.Maintain context across the conversation.
+    3.Perform deeper analysis, comparisons, transformations, or extractions as requested.
+    4.Clearly distinguish between observed facts and inferred insights. If something cannot be determined from the file, state that explicitly.
+
+Keep responses structured, concise, and professional. Treat all file data as sensitive and do not retain or reuse it outside the current conversation.
+"""
+
+llm = ChatOpenAI(model="gpt-4.1")
+
+graph = create_agent(
+    llm,
+    tools=[AnalyzeAttachmentsTool(llm=llm)],
+    system_prompt=system_prompt,
+)

samples/file-attachments-chat-agent/pyproject.toml

@@ -0,0 +1,10 @@
+[project]
+name = "file-attachments-chat-agent"
+version = "0.0.1"
+description = "file-attachments-chat-agent"
+authors = [{ name = "John Doe", email = "john.doe@myemail.com" }]
+dependencies = [
+    "langchain-openai>=1.1.9",
+    "uipath-langchain",
+]
+requires-python = ">=3.11"

samples/file-attachments-chat-agent/uipath.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://cloud.uipath.com/draft/2024-12/uipath",
+  "runtimeOptions": {
+    "isConversational": true
+  },
+  "packOptions": {
+    "fileExtensionsIncluded": [],
+    "filesIncluded": [],
+    "filesExcluded": [],
+    "directoriesExcluded": [],
+    "includeUvLock": true
+  },
+  "functions": {}
+}

src/uipath_langchain/chat/__init__.py

@@ -26,9 +26,13 @@ def __getattr__(name):
 
         return UiPathChatOpenAI
     if name == "requires_approval":
-        from .hitl import requires_approval
+        from .tools.hitl import requires_approval
 
         return requires_approval
+    if name == "AnalyzeAttachmentsTool":
+        from .tools.attachments import AnalyzeAttachmentsTool
+
+        return AnalyzeAttachmentsTool
     if name in ("OpenAIModels", "BedrockModels", "GeminiModels"):
         from . import supported_models
 
@@ -50,4 +54,6 @@ def __getattr__(name):
     "requires_approval",
     "LLMProvider",
     "APIFlavor",
+    "requires_approval",
+    "AnalyzeAttachmentsTool",
 ]