[5/6]
Smarter Hand offs — Documentation &
Transitioning to Development
Agentic Discovery Webinar
Series
2
2
About UiPath Community Bengaluru!
We are a community of automation professionals and enthusiasts that acquire knowledge about the latest
in AI-powered automation and share it within the community.
You are welcome to enjoy the virtual and in-person experiences that our community has to offer:
- meet each other and share experiences from the automation industry
- find out about the latest developments in the UiPath Business Automation Platform
- get guidance and support through use cases, demos, and practical examples
https://community.uipath.com/bengaluru/
3
Speaker
Pranav Kashyap
Team Lead-
Wonderbotz
4
Speaker
Akhil Padgilwar
Senior Software Engineer
qBotica
5
Speaker
Shradha Sarap
Senior Business Analyst-
Wonderbotz
6
Speaker
Sushmita Dey
Senior Consultant- WonderBotz
7
Documentation
approach variations
Practical
Illustration
Business–Tech
Handoffs
Data modeling for
adaptive
processes
BPMN for dynamic
agent flows
Agent design
documentation
template
Agenda for the day
BPMNforDynamicAgentFlows
8
9
 Business Process
Model Notation
 Worldwide adopted
standard to model
business processes
and workflows
Understanding BPMN
10
Events
Tasks
Level Of
Automation
Gateways
Pools and Lanes
Components of BPMN
11
Use case- Invoice matching
12
Orchestration Solution
DocumentationApproachVariations
13
14
The "Black Box" Problem:
The Missing Memory Layer :
Traditional docs show steps, but not how agents actually decide
The Silent Failure Trap :
Challenges of Traditional Documentation in Agentic
Contexts
Traditional methods are insufficient for capturing the nuances of agentic systems, creating significant gaps
between design and implementation.
PDDs document workflows, not how agents learn/forget
Static docs assume perfect execution
15
From Static to Dynamic: The Shift to Agentic
Documentation
This shift is crucial for bridging the gap between business needs and technical execution, demanding
a new approach to documentation.
Aspect Traditional Documentation Agentic Documentation
Focus Captures static process flows and technical
specs
Documents adaptive agent behaviors, goals,
and decision logic
Collaboration Business analysts hand over to technical teams;
limited ongoing alignment
Ensures continuous alignment across
business, engineers, and automation owners
Adaptability Often misses context-switches and dynamic
changes; updates are infrequent
Details agent prompts, context, and
adaptability for evolving needs
Lifecycle Integration Finalized early (at dev start), changes require
formal change management
Evolves continuously throughout automation
lifecycle, serving as a living blueprint
AgentDesignDocumentation(ADD)Template
16
17
Agent Design Documentation is more than just a document-
• it's a living blueprint for your automation agent's success.
• It ensures everyone involved, from developers to stakeholders, shares a clear, unified
understanding of its purpose and function.
Defining the Agent
Purpose: Clearly states the agent's
role, goals, and the problem it solves.
Tasks: Details the specific functions
and actions the agent executes, step-
by-step.
Data Interaction: Explains how the
agent communicates with other
systems and data sources, including
inputs, outputs, and APIs.
The Power of Agent Design Documentation
Value to Your Team
Single Source of Truth: Eliminates
ambiguity and ensures everyone works from
the same understanding.
Minimizes Misinterpretation: Reduces
errors and rework by providing clear
guidelines.
Promotes Consistency: Ensures uniform
development practices and agent behavior
across its lifecycle.
The Outcome: A Seamless Development
Journey
Effective documentation leads to:
Reliable Development: Fewer bugs and more
predictable behavior.
Easier Maintenance: Streamlined updates and
troubleshooting.
Seamless Collaboration: Enhanced teamwork
across all technical teams and stakeholders.
Think of it as a GPS for your agent: it maps out the journey, identifies every turn, and ensures everyone
arrives at the same destination efficiently.
PracticalIllustration:BusinessRequirements
AnalysisWalkthrough
18
19
Problem Statement
IT Service Management (ITSM) teams are inundated with repetitive, time-consuming
requests that strain resources and impact service quality. The key challenges include-
Repetitive Request Types:
• Application access provisioning
• Password resets
• MFA (Multi-Factor Authentication) resets
Consequences:
• Delays in Resolution: Manual processing slows down response times.
• Increased Error Rates: Human errors lead to incorrect actions or misrouting.
• High Support Costs: Manual handling consumes significant resources and
escalates operational expenses.
Use Case
RPA Vs Agentic
20
Need for Agentic Automation
Businesses require intelligent agent that can:
 Interpret requests dynamically
 Handle missing or unclear details with adaptive logic
 Error Reduction through Guardrails
 Cost Efficiency & Service Quality Gains
21
With a Checklist
• Forces clarity: asks the right
questions upfront.
• Captures both steps AND
intelligence (goals, edge cases,
context).
• Ensures shared understanding,
leading to predictable agent
responses.
Checklist Magic: Turning Chaos into Clarity
Without a Checklist
• Incomplete requirements lead to
unclear agent behavior.
• Assumptions cause costly rework
and missed scenarios.
• Developers guess intent, not build
to it.
22
Agentic Automation Flow: From Rules to Reasoning
23
Time for our ADD walkthrough! 🚀 Let’s see how
goals, prompts, edge cases, and adaptive logic
come together—turning business intent into smooth
technical execution.
ADD Walkthrough: Integrating for Intelligent Agent
Behaviour
DataModelingforAdaptiveProcesses
24
25
Data Modeling for Adaptive Processes
Healthcare
Diagnostics
Patient records use an evolving schema;
as new symptoms appear, the model
adapts by adding new metrics, allowing
medical staff to capture richer and more
relevant information without redesigning
the whole system.
Fraud Detection
Adaptive models constantly learn from
new transaction patterns, instantly
updating to spot previously unknown
fraud types—fields and thresholds may
be added as fraud schemes evolve
26
Techniques for Adaptive Processes
Entity-Relationship + Metadata
Extensions
• Still define entities (Invoice, Purchase Order, Supplier).
• But add metadata schemas (JSON/YAML) for things
like:
• Prompt templates
• Confidence thresholds
• Context variables
Example:
{
"entity": "Invoice", "attributes":
["InvoiceID", "Vendor",
"Amount", "DueDate"], "context":
{"confidence": 0.92, "source":
"OCR"}, "decision_rules": ["If
AmountMismatch > 5%,
escalate"]
}
27
Graph Data Models
• Represent adaptive flows as graphs (nodes = states,
edges = transitions).
• Useful when agent decisions depend on multi-hop
relationships.
• Example: Vendor → Past Deliveries → Payment
Performance → Approval Path.
Event-Driven Data Models
• Each process step = event with attributes.
• Process state = accumulation of events (like Event
Sourcing).
• Example:
• Event: InvoiceUploaded → State: Pending
Validation.
• Event: Validation Failed → State: Escalated.
Techniques for Adaptive Processes
BestPracticesforBusiness-to-TechHandovers
28
29
Ensuring Seamless Business-to-Tech Handovers
Clarity is
King
Show, Don’t
Just Tell
Bring It to
Life
Close the
Gaps
Consistency
Matters
Q&A

Smarter Hand offs — Documentation & Transitioning to Development [5/6]

  • 1.
    [5/6] Smarter Hand offs— Documentation & Transitioning to Development Agentic Discovery Webinar Series
  • 2.
    2 2 About UiPath CommunityBengaluru! We are a community of automation professionals and enthusiasts that acquire knowledge about the latest in AI-powered automation and share it within the community. You are welcome to enjoy the virtual and in-person experiences that our community has to offer: - meet each other and share experiences from the automation industry - find out about the latest developments in the UiPath Business Automation Platform - get guidance and support through use cases, demos, and practical examples https://community.uipath.com/bengaluru/
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
    7 Documentation approach variations Practical Illustration Business–Tech Handoffs Data modelingfor adaptive processes BPMN for dynamic agent flows Agent design documentation template Agenda for the day
  • 8.
  • 9.
    9  Business Process ModelNotation  Worldwide adopted standard to model business processes and workflows Understanding BPMN
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
    14 The "Black Box"Problem: The Missing Memory Layer : Traditional docs show steps, but not how agents actually decide The Silent Failure Trap : Challenges of Traditional Documentation in Agentic Contexts Traditional methods are insufficient for capturing the nuances of agentic systems, creating significant gaps between design and implementation. PDDs document workflows, not how agents learn/forget Static docs assume perfect execution
  • 15.
    15 From Static toDynamic: The Shift to Agentic Documentation This shift is crucial for bridging the gap between business needs and technical execution, demanding a new approach to documentation. Aspect Traditional Documentation Agentic Documentation Focus Captures static process flows and technical specs Documents adaptive agent behaviors, goals, and decision logic Collaboration Business analysts hand over to technical teams; limited ongoing alignment Ensures continuous alignment across business, engineers, and automation owners Adaptability Often misses context-switches and dynamic changes; updates are infrequent Details agent prompts, context, and adaptability for evolving needs Lifecycle Integration Finalized early (at dev start), changes require formal change management Evolves continuously throughout automation lifecycle, serving as a living blueprint
  • 16.
  • 17.
    17 Agent Design Documentationis more than just a document- • it's a living blueprint for your automation agent's success. • It ensures everyone involved, from developers to stakeholders, shares a clear, unified understanding of its purpose and function. Defining the Agent Purpose: Clearly states the agent's role, goals, and the problem it solves. Tasks: Details the specific functions and actions the agent executes, step- by-step. Data Interaction: Explains how the agent communicates with other systems and data sources, including inputs, outputs, and APIs. The Power of Agent Design Documentation Value to Your Team Single Source of Truth: Eliminates ambiguity and ensures everyone works from the same understanding. Minimizes Misinterpretation: Reduces errors and rework by providing clear guidelines. Promotes Consistency: Ensures uniform development practices and agent behavior across its lifecycle. The Outcome: A Seamless Development Journey Effective documentation leads to: Reliable Development: Fewer bugs and more predictable behavior. Easier Maintenance: Streamlined updates and troubleshooting. Seamless Collaboration: Enhanced teamwork across all technical teams and stakeholders. Think of it as a GPS for your agent: it maps out the journey, identifies every turn, and ensures everyone arrives at the same destination efficiently.
  • 18.
  • 19.
    19 Problem Statement IT ServiceManagement (ITSM) teams are inundated with repetitive, time-consuming requests that strain resources and impact service quality. The key challenges include- Repetitive Request Types: • Application access provisioning • Password resets • MFA (Multi-Factor Authentication) resets Consequences: • Delays in Resolution: Manual processing slows down response times. • Increased Error Rates: Human errors lead to incorrect actions or misrouting. • High Support Costs: Manual handling consumes significant resources and escalates operational expenses. Use Case RPA Vs Agentic
  • 20.
    20 Need for AgenticAutomation Businesses require intelligent agent that can:  Interpret requests dynamically  Handle missing or unclear details with adaptive logic  Error Reduction through Guardrails  Cost Efficiency & Service Quality Gains
  • 21.
    21 With a Checklist •Forces clarity: asks the right questions upfront. • Captures both steps AND intelligence (goals, edge cases, context). • Ensures shared understanding, leading to predictable agent responses. Checklist Magic: Turning Chaos into Clarity Without a Checklist • Incomplete requirements lead to unclear agent behavior. • Assumptions cause costly rework and missed scenarios. • Developers guess intent, not build to it.
  • 22.
    22 Agentic Automation Flow:From Rules to Reasoning
  • 23.
    23 Time for ourADD walkthrough! 🚀 Let’s see how goals, prompts, edge cases, and adaptive logic come together—turning business intent into smooth technical execution. ADD Walkthrough: Integrating for Intelligent Agent Behaviour
  • 24.
  • 25.
    25 Data Modeling forAdaptive Processes Healthcare Diagnostics Patient records use an evolving schema; as new symptoms appear, the model adapts by adding new metrics, allowing medical staff to capture richer and more relevant information without redesigning the whole system. Fraud Detection Adaptive models constantly learn from new transaction patterns, instantly updating to spot previously unknown fraud types—fields and thresholds may be added as fraud schemes evolve
  • 26.
    26 Techniques for AdaptiveProcesses Entity-Relationship + Metadata Extensions • Still define entities (Invoice, Purchase Order, Supplier). • But add metadata schemas (JSON/YAML) for things like: • Prompt templates • Confidence thresholds • Context variables Example: { "entity": "Invoice", "attributes": ["InvoiceID", "Vendor", "Amount", "DueDate"], "context": {"confidence": 0.92, "source": "OCR"}, "decision_rules": ["If AmountMismatch > 5%, escalate"] }
  • 27.
    27 Graph Data Models •Represent adaptive flows as graphs (nodes = states, edges = transitions). • Useful when agent decisions depend on multi-hop relationships. • Example: Vendor → Past Deliveries → Payment Performance → Approval Path. Event-Driven Data Models • Each process step = event with attributes. • Process state = accumulation of events (like Event Sourcing). • Example: • Event: InvoiceUploaded → State: Pending Validation. • Event: Validation Failed → State: Escalated. Techniques for Adaptive Processes
  • 28.
  • 29.
    29 Ensuring Seamless Business-to-TechHandovers Clarity is King Show, Don’t Just Tell Bring It to Life Close the Gaps Consistency Matters
  • 30.

Editor's Notes

  • #9 Definition: Maestro is UiPath’s low-code tool for modeling, implementing, monitoring, and optimizing longrunning, end-to-end business processes. Why 'Maestro'? Like a conductor synchronizing an orchestra, Maestro synchronizes automations, decisions, human steps, and business logic into a single cohesive flow. It doesn’t just automate. It orchestrates. That’s the difference. Maestro ensures your bots, decisions, and humans work in harmony.
  • #10 Events - There are three kinds of it start, intermediate and end. Events are things that just happen or occur right for example the start of a process is an event, the end of a process is an event process ended but also for example five minutes are over is an event so this is something that takes place in a specific point in time Tasks - Tasks or activities mainly tasks look like this rectangle with some round shapes and a couple of words in it and tasks come in multiple forms. Three important forms the first one here with this hand symbol is a manual task manual task you could think about for example moving a rock from place a to place B is a manual task no it system is involved, then we have user tasks a user task means like a human is interacting with an IT system. Then you have service tasks that a system is doing something in the background Gateways - Gateways help us to basically make decisions or route us where to go in the business flow. There are multiple but let’s focus on four different gateways for now. The first is the either or Gateway that's basically based on a certain condition you would decide to go left or to go right only one way. Then we have the parallel Gateway this is there to actually have multiple tasks run in parallel not sequential. Then the or Gateway this is a very complex concept to understand what the difference is between or and an either or in either or means you can just go left or right there's no both but with an or you can go also both ways but you have to go at least one way. Then there's the event based Gateway also a quite complex but also useful one here it's basically based on a certain event so we are waiting for an event to happen and if it happens we go one way if it does not happen for example or another condition is met we go another route Pools and Lanes - Pools and lanes are there to describe different roles and to Showcase who's doing what in the process for example here you can see we have two different pools process A and process B each one is a pool and in process A we have multiple roles which are Lanes
  • #11 Problem Statement---- We are receiving the invoice in email, automation is there to extract the data from the pdf, will match the PO data which is stored in the DB, if everything looks good, it will post it to the SAP system, else Human has to go back, reach to the customer, multiple email chains , and then the issue will be resolved and finally uploaded it to the SAP system.
  • #24 Data modeling defines how data is stored, organized, and accessed—its structures, relationships, and rules. For adaptive processes, the focus is on designing these models so they can deal with unpredictable changes: new activities, inputs, or business scenarios emerging over time rather than following a fixed workflow
  • #25 Data modeling for adaptive processes means designing flexible data structures that can handle dynamic, changing workflows and decision logic—making business processes responsive and robust in unpredictable environments. In practical terms, this involves using models and techniques that allow data—and therefore processes themselves—to evolve over time as requirements and real-world contexts shift