Cross-vendor agent integration
Integrate agents from different vendors around one accountable workflow
A vendor-specific agent must work with an existing platform. The decision is how to integrate agents from different vendors around one accountable workflow. The work begins with your actual workflow and looks for the evidence that separates intended behaviour from a consequential exception. It is particularly relevant to enterprise integration leads and product owners. A useful outcome is an explicit account of what was examined, what remains uncertain, and which decision the evidence can support.
The interaction contracts relationship
- Vendor interface documentation
Establish the basis for portable task.
- Adapter responsibility
Map identity, state, and errors at each boundary.
- Cross-vendor integration design
Retain the scoped finding and its unresolved dependencies.
Decision
Frame the decision around portable task
Questions and the evidence they need
- Portable task
- Inspect vendor interface documentation for the relevant constraint or observation.
- Adapter responsibility
- Inspect task contracts for the relevant constraint or observation.
- Exit dependency
- Inspect identity requirements for the relevant constraint or observation.
The decision is how to integrate agents from different vendors around one accountable workflow. This is relevant to enterprise integration leads and product owners when a vendor-specific agent must work with an existing platform. Name the affected workflow, the consequence of a wrong decision, and the owner who can act on the result. The initial discussion should establish which evidence is already available and which uncertainty is material enough to investigate.
The specific failure hypothesis is that a vendor adapter translates successful transport into a success state without verifying business completion. It remains a hypothesis until examined in the deployment. Existing internal tests or operating records may already resolve it; identify the uncovered question before commissioning additional work.
Mechanism
Cross-vendor integration needs a shared handoff contract
Relationships within interaction contracts
- Portable task
- Choose a representative business interaction.
- Adapter responsibility
- Map identity, state, and errors at each boundary.
- Exit dependency
- Identify data and evidence that must remain portable.
What this specialty examines
Cross-vendor integration should keep the business contract outside vendor-specific assumptions where practical. Define task ownership, accepted results, authority and evidence retention. An adapter should have explicit responsibilities rather than silently repairing every difference between products.
The review should prototype the smallest representative handoff and evaluate state, errors, permission and evidence portability. Identify the normal route, relevant exceptions and the authoritative record of the outcome. Inspect the relevant business-system record, enforcement event or process evidence alongside any reported status. Keep incomplete cases visible, with an explanation of what their absence prevents the owner from concluding.
The tradeoff to make explicit
For this decision, using specialized vendors may improve fit while proprietary assumptions increase integration and exit effort. Compare the available design or operating choices against the same intended outcome. If one option removes a required control or changes the task boundary, describe that difference before treating its apparent simplicity, speed or lower effort as an improvement. The decision should expose the tradeoff instead of burying it in an aggregate score.
Preparation
Connect the working inputs to the boundary being examined
Evidence packet for portable task
Illustrative working format
- Vendor interface documentation
- Match this description to the deployed or proposed boundary being examined.
- Task contracts
- Check its relationship to the relevant workflow and expose missing context.
- Identity requirements
- Confirm the applicable revision and who resolves disputed interpretation.
- Exit constraints
- Identify provenance and the specific decision this material can inform.
Start with vendor interface documentation, task contracts, identity requirements and exit constraints. Identify the owner, revision and operating context of each source. Sanitised examples may support initial design, but differences from actual conditions should remain explicit. Where direct access is unsuitable, a customer-controlled evidence or execution route may be considered, with agreed handling and retention.
The scope also needs the integration owner, agreed expectations for a representative interaction case, and the authority to inspect the relevant boundary. Specify what evidence would distinguish the failure in which a vendor adapter translates successful transport into a success state without verifying business completion from acceptable behaviour. If stakeholders disagree about intended behaviour, resolve the interpretation before classifying the observed difference as a defect.
How the work proceeds
Carry portable task through to an accountable finding
From the scoped material to a decision record
- Vendor interface documentation
Agree the task meaning at the sending boundary.
- Adapter responsibility
Apply the scoped check to exit dependency.
- Cross-vendor integration design
Record the evidence, open dependencies, and the owner’s next decision.
Fix the interaction contract and versions
Assemble vendor interface documentation, task contracts, identity requirements and exit constraints with enterprise integration leads and product owners. Identify the participating implementations, interface revisions, authority assumptions and intended business result. Prepare messages and task-state examples from both sides, including an interrupted exchange and a disputed or incomplete outcome. The preparation output is a paired contract fixture showing what each participant expects and which differences would prevent the workflow from completing correctly.
Run and compare both sides of the exchange
Prototype a narrow representative exchange before broad commitment. Examine failure handling, data export, identity mapping and observability. Vendor demonstrations can suggest capability, but the customer’s actual workflow needs its own evidence and operational owner.
Choose the contract or integration change
Summarise the comparison in a cross-vendor integration design with adapter responsibilities and unresolved dependencies. Classify each mismatch as interface validation, business meaning, identity, task state or operating behaviour. Decide whether to change a participant, add an explicit adapter rule, narrow supported combinations or defer the connection. Validate the affected pair again and preserve limitations that translation cannot resolve, especially around cancellation, authority and partial completion.
Indicative artefact
Make the cross-vendor integration design usable by its owner
Cross-vendor integration design
Illustrative working format
- Cross-vendor integration design
- Identify the assessed workflow, revision, and decision boundary.
- Adapter responsibilities
- Name the role, decision right, handoff, and unresolved ownership boundary.
- Unresolved dependencies
- Name the missing evidence, responsible owner, and condition for revisiting the decision.
A useful decision artefact is a cross-vendor integration design with adapter responsibilities and unresolved dependencies. Supporting material may include selected cases, configuration or process records, evidence references, a disagreement log and prioritised actions. Retain the case selection rationale and material disagreements alongside the result; otherwise the result may be mistaken for complete coverage.
Illustrative scenario
Examine exit dependency through a constructed exception
A constructed case and its decision paths
Illustrative scenario
- Portable task
A remote vendor reports completion before the customer's required state exists.
- Adapter responsibility
Compare remote completion with the customer's authoritative task state.
- Exit dependency
Assign adapter or acceptance changes before relying on the handoff.
Consider a fictional situation: a service-desk agent delegates an inventory check to another vendor’s agent with different status conventions. The scenario is illustrative, with no client engagement, executed test or measured improvement implied.
For the inventory check, compare what each vendor means by available and complete. If one returns a preliminary result, the adapter should preserve that qualification. Converting it into final success would create a business-state error rather than solve compatibility.
Scope and next action
Keep the conclusion within named implementations and revisions
Confirm fit before the next commitment
- Portable task
- This review is limited to named implementations and revisions.
- Vendor interface documentation
- The relevant owner must confirm access and the intended operating conditions.
- Cross-vendor integration design
- Untested peers require their own compatibility evidence.
Compatibility is assessed for named implementations, versions, features and workflows. It does not establish universal conformance, vendor endorsement or interoperability with untested peers. Any engagement depends on an agreed scope, qualified team, authorised access and confirmed availability. Bring the affected workflow, its current configuration or process, the triggering change and the evidence already available. The immediate scope question is prompted by the situation in which a vendor-specific agent must work with an existing platform; confirm which missing observation would change the owner’s next action.
Ways to engage
Related engagement scopes
AI Agent Protocol Interoperability Lab
Find where connected agents disagree. Exercise message contracts, identity propagation and failure recovery across your selected integrations.
Continue exploring
Related insights and resources
How to design a joint AI evaluation lab
A joint lab should be a governed way to create decision evidence across organisations, with shared methods but explicit ownership of systems, data and conclusions.
Agent protocols are creating a new control surface
Protocols make tools and agents interoperable, but they also standardise discovery, delegation and context exchange. Those interfaces need explicit trust and policy controls.
A practical security review for an MCP server
Review an MCP server as a privileged protocol adapter: verify tool semantics, OAuth boundaries, token audience, downstream delegation, input handling, isolation, logging and consent.