add bindings

Author: GabrielVasilescu04

samples/email-triage-agent/README.md

@@ -37,12 +37,12 @@ The agent takes a single required input at job start:
 
 ## Connection (binding)
 
-The Outlook connection used by the agent is declared as a **binding** in `bindings.json` rather than passed in as input. The code references placeholder identifiers (`<your-outlook-connection>` / `<your-folder>`) which Orchestrator resolves to the deployer-selected connection at run time, via the binding-overwrite mechanism.
+The Outlook connection used by the agent is declared as a **binding** in `bindings.json` rather than passed in as input. The code references a placeholder connection key (`<your-outlook-connection>`) and calls `sdk.connections.retrieve_async(OUTLOOK_CONNECTION_KEY)`. That method is decorated with `@resource_override("connection", resource_identifier="key")`, which inspects the runtime's binding-overwrite context and substitutes the deployer-selected connection's real key before the HTTP call. The agent then reads `connection.name` and `connection.folder.path` from the resolved connection and feeds them into `WaitIntegrationEvent`.
 
 To run the agent:
 
-- **In Orchestrator (deployed)**: pick the actual Outlook 365 connection when configuring the agent — Orchestrator's binding UI presents the deployer with the list of available `uipath-microsoft-outlook365` connections and overwrites the placeholders.
-- **Locally**: edit the `CONNECTION_NAME` / `CONNECTION_FOLDER` constants at the top of `graph.py` to point at a real connection in your tenant, or pass a resource-overwrites file via `--resource-overwrites`.
+- **In Orchestrator (deployed)**: pick the actual Outlook 365 connection when configuring the agent — Orchestrator's binding UI presents the deployer with the list of available `uipath-microsoft-outlook365` connections and overwrites the placeholder key.
+- **Locally**: edit the `OUTLOOK_CONNECTION_KEY` constant at the top of `graph.py` to a real connection key in your tenant, or pass a resource-overwrites file via `--resource-overwrites`.
 
 The connector key (`uipath-microsoft-outlook365`) is hardcoded.
 

samples/email-triage-agent/bindings.json

@@ -3,21 +3,16 @@
     "resources": [
         {
             "resource": "connection",
-            "key": "<your-outlook-connection>.<your-folder>",
+            "key": "<your-outlook-connection>",
             "value": {
-                "name": {
+                "ConnectionId": {
                     "defaultValue": "<your-outlook-connection>",
                     "isExpression": false,
-                    "displayName": "Connection Name"
-                },
-                "folderPath": {
-                    "defaultValue": "<your-folder>",
-                    "isExpression": false,
-                    "displayName": "Folder Path"
+                    "displayName": "Outlook Connection"
                 }
             },
             "metadata": {
-                "connector": "uipath-microsoft-outlook365",
+                "Connector": "uipath-microsoft-outlook365",
                 "useConnectionService": "true",
                 "BindingsVersion": "2.2"
             }

samples/email-triage-agent/graph.py

@@ -38,10 +38,11 @@
 GRAPH_API_BASE = "https://graph.microsoft.com/v1.0"
 OUTLOOK_CONNECTOR = "uipath-microsoft-outlook365"
 
-# Placeholders bound to the actual connection via bindings.json. Orchestrator
-# substitutes these with the deployer-selected connection at run time.
-CONNECTION_NAME = "<your-outlook-connection>"
-CONNECTION_FOLDER = "<your-folder>"
+# Placeholder connection key bound to a real connection via bindings.json.
+# `connections.retrieve_async` is decorated with @resource_override("connection",
+# resource_identifier="key"), so at run time the decorator inspects the binding
+# overwrite context and substitutes the deployer-selected connection's real key.
+OUTLOOK_CONNECTION_KEY = "<your-outlook-connection>"
 
 
 class Severity(str, Enum):
@@ -108,19 +109,10 @@ async def _send_outlook_reply(message_id: str, body: str) -> None:
     issued for the UiPath Outlook connection that received the trigger.
     """
     sdk = UiPath()
-    connections = await sdk.connections.list_async(
-        name=CONNECTION_NAME,
-        folder_path=CONNECTION_FOLDER,
-        connector_key=OUTLOOK_CONNECTOR,
-    )
-    connection = next(
-        (c for c in connections if c.name == CONNECTION_NAME),
-        None,
-    )
-    if connection is None or connection.id is None:
+    connection = await sdk.connections.retrieve_async(OUTLOOK_CONNECTION_KEY)
+    if connection.id is None:
         raise RuntimeError(
-            f"Outlook connection {CONNECTION_NAME!r} not found in "
-            f"folder {CONNECTION_FOLDER!r}."
+            f"Outlook connection {OUTLOOK_CONNECTION_KEY!r} could not be resolved."
         )
 
     token = await sdk.connections.retrieve_token_async(connection.id)
@@ -138,18 +130,23 @@ async def _send_outlook_reply(message_id: str, body: str) -> None:
 
 
 async def wait_for_email(state: GraphState) -> dict[str, Any]:
+    sdk = UiPath()
+    connection = await sdk.connections.retrieve_async(OUTLOOK_CONNECTION_KEY)
+    folder_path = (
+        connection.folder.get("path") if isinstance(connection.folder, dict) else None
+    )
     logger.info(
         "Waiting for next email on '%s' (folder='%s') with subject=%r (triaged so far: %d)...",
-        CONNECTION_NAME,
-        CONNECTION_FOLDER,
+        connection.name,
+        folder_path,
         state.subject,
         state.triage_count,
     )
     email = interrupt(
         WaitIntegrationEvent(
             connector=OUTLOOK_CONNECTOR,
-            connection_name=CONNECTION_NAME,
-            connection_folder_path=CONNECTION_FOLDER,
+            connection_name=connection.name or "",
+            connection_folder_path=folder_path,
             operation="EMAIL_RECEIVED",
             object_name="Message",
             filter_expression=f"(subject=='{state.subject}')",