watsonx Orchestrate Agent for Document Comparison

Introduction

This short series of articles provides an introduction to the latest incarnation of watsonx Orchestrate, which has recently been redesigned for all new deployments from July 2025.

• watson Orchestrate Introduction covers the key components for building an agent, including defining the agent’s purpose, knowledge, tools, flows and behaviour.

• watson Orchestrate Agent Development Toolkit explains how to install a development environment for local agent development and testing.

• This post provides an end to end example of building an agent with tools.

• Finally, watson Orchestrate Publish from ADK to SaaS shows how to publish a locally developed agent to a watson Orchestrate SaaS tenant, and how users can interact with it.

Use Case - Document Comparison Task - BRIAN

To illustrate some of the capabilities… Two docs, need to be compared by human, e.g. legal clauses, contract risks… Simple document structure in this blog. Coding standards.

Solution Approach - ADAM

Describe the services SaaS tenant / ADK tools required. Block diagram of solution.

Building Tool - ADAM

Create tool convertDocumentToMarkdown tool with ADK. Upload to local dev.

Building Agent - BRIAN

ADK Discussion of agent settings via either yaml or Canvas Most value added here (see pink picture) Upload to local dev.

Testing - BRIAN

Use Chat UI In future, we’ll talk more about debugging / evaluation.