Skip to main content
Blog

A Developer’s Guide to Building Agentic Agreement Workflows with Docusign Iris

Author Gaurav Rajoria
Gaurav RajoriaLead Product Manager

Summary10 min read

Docusign Iris helps turn agreement context into insights and governed actions. This guide explains how developers can use the AI assistant, ready-to-deploy agents, custom agents, Workflow Builder, Worksheets, and the Docusign MCP Server to build agreement workflows in Docusign and the AI tools where teams already work.

Key takeaways

  • Docusign Iris is the AI engine behind the agentic capabilities, turning agreement context into insights and action.

  • Docusign gives builders several ways to use Iris-powered agreement intelligence: in-platform agents and workflows, portfolio analysis with Worksheets, and external AI workflows through the Docusign MCP Server. 

  • These capabilities help teams reduce manual agreement work while keeping people in control of consequential decisions. 

Agreement workflows rarely happen in one system. A renewal might need customer data from a CRM, pricing from a CPQ platform, legal approval, the right agreement template, and follow-up after the document is sent.

Each step may be straightforward on its own. The hard part is coordinating them reliably, with the right context, permissions, and human review.

Docusign Iris is the AI engine behind Docusign’s agreement intelligence and AI experiences. It uses agreement context, such as terms, obligations, amendments, negotiation history, and renewal provisions, to help teams move from understanding agreements to acting on them.

For developers, that means agreement intelligence can become part of a governed workflow. Builders can use ready-to-deploy agents inside Docusign, create custom agents for organization-specific processes, add agents to structured workflows in Workflow Builder, analyze agreement portfolios with Worksheets, or bring Docusign intelligence into third-party AI applications through the Docusign MCP Server.

Watch this overview to understand how Docusign’s agentic capabilities can support agreement workflows.

Choose the right building block for your workflow 

Docusign provides several ways to use Iris-powered agreement intelligence, depending on where users work and how much reasoning, orchestration, and customization a workflow requires.

AI assistant

The AI assistant lets users ask questions about their agreement data and receive responses grounded in the agreements they can access. 

A user might ask the assistant to summarize a contract, identify an upcoming renewal, or explain how a clause differs from standard language. 

Because the assistant works with agreement context rather than standalone documents, it can provide more relevant answers than a general-purpose model working from isolated files. In many cases, the assistant is also the entry point for calling Docusign agents. 

Where to start: Review Docusign Iris, AI at Docusign, and Build with Docusign and AI.

Ready-to-deploy agents

Ready-to-deploy agents handle repeatable, multi-step agreement tasks without requiring a team to design an agent from scratch. 

These agents are intended for repeatable workflows such as retrieving agreement information, monitoring status and obligations, applying legal playbooks, and guiding users through standard agreement processes. 

Use a ready-to-deploy agent when the task is common, the workflow primarily runs within Docusign, and you need a faster starting point with less customization. Users can invoke agents through the AI assistant or use them as steps in Workflow Builder.

Where to start: Explore Docusign Agents and the Docusign Developer Center for APIs, workflows, and implementation resources.

Agent Studio

Agent Studio lets teams build custom agents for organization-specific processes. A builder describes the desired behavior in natural language and provides the instructions, policies, playbooks, and business context the agent should follow.

Custom agents are useful when a workflow depends on knowledge unique to an organization, such as approval requirements, pricing policies, escalation rules, or standard operating procedures. 

After testing and refining the agent, teams can make it available to other users or invoke it from a broader workflow.

Example: Review past agreements before a renewal

Before a renewal, a legal operations team may need to review prior agreements, amendments, nonstandard terms, total contract value, and upcoming renewal dates. 

With Docusign Agent Studio, the team could create a custom agent with instructions such as: Find the previous agreements for this customer. Summarize the key commercial and legal terms, identify deviations from our standard terms, calculate the total contract value, and list upcoming renewal dates.

The agent could then:

  1. Retrieve agreements associated with the customer

  2. Extract the relevant terms and dates

  3. Compare the language against the organization’s legal playbook

  4. Flag exceptions that require review

  5. Return a structured renewal summary

The legal team still defines the policies and review requirements. The agent handles the repetitive work of collecting and organizing the information so reviewers can focus on judgment and negotiation.

Once tested, the same agent could be made available to other legal or sales teams or invoked from a broader renewal workflow in Docusign Workflow Builder

Where to start: Explore Docusign Agents for custom-agent capabilities and the Docusign Developer Center for broader implementation resources.

Use agents in Workflow Builder

Custom agents become more powerful when they are part of a structured workflow. In Docusign Workflow Builder, agents can be added as steps that combine agent reasoning with rule-based routing, approvals, and downstream actions. 

For example, an agent can evaluate an agreement against a playbook and return a structured result. Workflow Builder can then use that result to route an agreement, request approval, escalate an exception, or trigger another downstream action.

When configuring a custom agent for a workflow, define a structured output schema so the agent returns machine-readable results. In Workflow Builder, add the custom AI agent step and use the output in conditional logic.

Where to start: Explore Workflow Builder and the Workflow Builder API.

Worksheets

Worksheets in Agreement Manager help teams extract and compare specific data across thousands of agreements at once.

Teams can use Worksheets to identify vendor agreements that allow price increases above a certain threshold, find customer contracts with specific renewal or termination clauses, and surface obligations or caps that deviate from policy. 

Worksheets are powered by Iris, but they are not agentic. They help users analyze agreement data and make decisions; they do not independently route agreements, send documents, or execute workflow actions. 

Results are grounded in live signed agreements and can include citations, reasoning, and confidence indicators. This helps teams verify the source of each extracted value during a high-volume review.

Where to start: Explore Worksheets, Agreement Manager, and the Agreement Manager API.

Docusign MCP Server

The Docusign MCP Server makes Docusign capabilities available in supported third-party AI applications, including environments such as Claude, ChatGPT, Gemini Enterprise, Copilot Studio, and Slack.

This lets developers and business users connect agreement workflows to the tools where teams already work. Depending on the supported environment and configuration, users can create, review, send, track, sign, search, analyze, and manage agreements with natural-language prompts.

The MCP Server is especially useful when an agreement workflow spans multiple systems. An external AI agent might retrieve account data from a CRM, check approved pricing in a CPQ system, confirm approvals, and then use Docusign to prepare an agreement.

Example: Prepare and send an order form from an AI assistant

Suppose an account executive needs to prepare a renewal order form. The required information may live across a CRM, CPQ system, approval system, and Docusign. 

A user could deploy a custom agent in their AI environment and ask: Prepare an order form for the upcoming renewal.

The custom agent can then:

  1. Retrieve the customer and opportunity details from the CRM.

  2. Retrieve the approved products, pricing, and discounts from the CPQ system.

  3. Confirm that required approvals have been completed.

  4. Present the proposed agreement details for review.

  5. Use the Docusign MCP Server to select and populate the appropriate template.

  6. Send the agreement for signature after the user confirms.

For consequential actions such as sending an agreement, the agent should present the relevant details and receive explicit approval before proceeding. 

Where to start: Start with the MCP Server developer documentation, then choose a setup path for Claude, ChatGPT, GitHub Copilot, or other applications.

Choose a focused workflow and the right implementation

When designing your own implementation, start with one agreement process that has clear inputs, repetitive steps, and a defined outcome. Then decide where the workflow should run and what it needs to do: 

  • Use Docusign agents or Agent Studio when the work is primarily agreement-focused and benefits from Docusign context, policies, and controls.

  • Use Workflow Builder when the process needs deterministic routing, approvals, conditions, and downstream actions.

  • Use Worksheets when the goal is high-volume portfolio analysis rather than autonomous action.

  • Use the Docusign MCP Server when the workflow needs to run in an external AI ecosystem or coordinate Docusign with other business systems.

The most effective implementations focus on a specific outcome, make agreement context available, define the boundaries of automation, and keep people in control of consequential decisions.

Developers can also combine these capabilities with Docusign APIs, extension apps, and Docusign Workflow Builder for more advanced implementations.  

Security and control

Agents are limited to the agreement data the user can access. Permissions configured in Docusign Agreement Manager and other Docusign IAM services determine which agreements and agreement sets that user can retrieve. 

When designing an agentic workflow, developers should also decide:

  • Which actions the agent can perform

  • Which actions require user confirmation

  • What data can be sent to external systems or models

  • How the workflow will handle missing or conflicting information

  • What should happen when an approval or policy check fails

  • Which actions and decisions need to be logged

These controls are particularly important for workflows involving confidential agreements, employment documents, regulated data, or financial commitments. 

Availability

Availability varies by capability, plan, region, language, and launch phase. 

Because availability and supported capabilities can vary by region, plan, and launch phase, always check the latest product documentation and program requirements before beginning an implementation.

Additional Resources

Author Gaurav Rajoria
Gaurav RajoriaLead Product Manager

Gaurav Rajoria is a Lead Product Manager in Docusign, driving the product vision and strategy for the Docusign MCP Server. His focus is to bring Docusign capabilities into users’ AI tools of choice and to empower developers to integrate agreement scenarios seamlessly into their AI agents. You can reach out to Gaurav on Linkedin.

More posts from this author

Related posts

  • Developers

    Introducing the Docusign CLI: Configure, Test, and Deploy Agreement Manager

    Author Bharat Rele
    Bharat Rele

Docusign IAM is the agreement platform your business needs

Start for FreeExplore Docusign IAM
Person smiling while presenting