When your declarative agent’s instructions hit 8,000 characters and the model reaches for the wrong tool every other turn, you’ve hit agent scope creep. The answer is to connect the Zava Insurance HR Onboarding Buddy to an ecosystem of specialist connected agents.
What Are Connected Agents?
Connected agents let your declarative agent delegate tasks to other specialist agents in your organization. Your agent stays the front door. The user talks to the HR Buddy, always, but behind the scenes, Copilot routes specific questions to worker agents purpose-built for deep expertise.
It’s a microservices architecture for AI assistants. One conversation, multiple expert agents working behind the scenes.
For Zava Insurance, the setup looks like this:
- HR Onboarding Buddy: The agent we’ve been building. General onboarding questions, policies, task tracking, the day-to-day stuff new hires need.
- IT Support Agent: A separate agent owned by the IT team. Deep troubleshooting, device management, known issues databases, software requests.
- Benefits Advisor Agent: A dedicated agent built by the Total Rewards team. Full health plan documents, cost comparison calculators, enrollment workflows, 401(k) modeling.
Each agent is maintained by the team that owns the expertise. The HR Buddy delegates to them when needed. The user stays in one seamless conversation.
Configuring Worker Agents
In the declarative agent manifest (schema v1.6), connected agents are configured through the worker_agents property: a top-level array that references other deployed agents by their title ID.
{
"$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.6/schema.json",
"version": "v1.6",
"name": "HR Onboarding Buddy",
"description": "A friendly assistant to help new employees at Zava Insurance.",
"instructions": "$[file('instructions.txt')]",
"worker_agents": [
{
"id": "T_a1b2c3d4-e5f6-7890-abcd-ef1234567890"
},
{
"id": "T_f9e8d7c6-b5a4-3210-fedc-ba9876543210"
}
]
}
Each id is the title ID of the target agent’s application, available when you publish through the Agents Toolkit or in the agent metadata section of developer mode.
The title ID starts with T_ followed by a GUID. This isn’t the Teams app ID or the bot ID. It’s specific to the agent’s Copilot registration. Tenant agents (deployed within your organization) and public agents (published to the Teams Store) are both supported as connected agents. Check developer mode in Copilot if you’re not sure which ID to use.
How Delegation Works
Delegation is completely invisible to the user. They see a single conversation with the HR Onboarding Buddy. When Copilot determines that a question falls within a worker agent’s expertise, it routes the query, gets the response, and presents it as part of the same conversation. No switching. No “let me transfer you.” No friction.
From the user’s perspective, the HR Buddy is just really good at everything. Behind the scenes, specialists are doing the heavy lifting.
The Rules of Delegation
There are a few critical things to understand about how this works:
Same tenant requirement. Both agents must be deployed in the same Microsoft 365 tenant. The connected agent needs to be installed and available before your agent can delegate to it. No cross-tenant connections.
Independent configuration. Each connected agent maintains its own complete setup: its own instructions, knowledge sources, API plugins, MCP servers, and guardrails. The IT Support Agent has its own SharePoint sources and tool integrations. You don’t duplicate any of that in the HR Buddy’s manifest.
Permissions are respected. If the connected agent has access to data the user doesn’t have permission to see, that data won’t surface. Each agent operates within the user’s permission context. Security boundaries are maintained across every delegation.
Helping the Model Delegate
Copilot is surprisingly good at figuring out delegation on its own. The worker agents’ names and descriptions give it enough context to route most queries correctly. But there are a few levers you can pull to improve routing reliability.
Worker agent description. The description field of each connected agent acts as its routing signal. A tightly scoped description (like “Deep IT troubleshooting, device management, and software requests for Zava Insurance employees”) gives Copilot a precise match surface. Vague descriptions lead to missed delegations.
Conversation starters. The connected agent’s conversation starters also help Copilot understand what it handles. Starters like “Troubleshoot my laptop”, “Request software access”, or “Compare health plan options” give concrete examples of the queries that agent should own. Copilot uses these as additional routing signals when deciding whether to delegate.
Explicit instructions in the orchestrator. Beyond the worker agents’ own metadata, explicit instructions in the HR Buddy’s instructions.txt improve reliability:
“When a user asks a deep IT troubleshooting question that goes beyond basic setup instructions, or asks for detailed benefits comparisons and enrollment advice, delegate to the appropriate specialist agent. You don’t need to tell the user you’re delegating: just provide the best possible answer.”
This instruction hint is optional. Copilot uses the worker agents’ names, descriptions, and conversation starters to determine routing. But explicit delegation guidance reduces the cases where the model tries to answer a specialist question with general knowledge instead of handing off.
The Zava Insurance Scenario
Imagine you’re a new Zava Insurance employee on your second day.
IT Delegation
You type: “My laptop won’t connect to the external monitor: I’ve tried two different cables and three different dongles.”
The HR Buddy recognizes this is a deep IT troubleshooting question, beyond what’s in our IT Setup Guide. It delegates to the IT Support Agent, which has access to the full troubleshooting documentation and known issues database.
The response comes back with specific troubleshooting steps for your laptop model, including a known driver issue with the Dell WD22TB4 dock and the exact fix, complete with Device Manager instructions and the driver path. Then it offers to create a support ticket if the fix doesn’t work. You didn’t need to know the IT Support Agent exists.
Benefits Delegation
You follow up: “While I’m at it: can you explain the difference between the Silver and Gold health plans? My spouse is self-employed and we’re thinking about kids.”
The HR Buddy delegates to the Benefits Advisor Agent, which has the full plan documents and cost comparison tools. Back comes a detailed comparison table with monthly premiums, deductibles, and maternity coverage, with cost scenarios tailored to your situation. The Gold plan saves you $2,000+ in a pregnancy year. Deep domain expertise, not a generic answer from a one-page summary.
Seamless Context
You’re still in the same conversation. Follow up with “Include HSA contributions in that comparison” and the Benefits Advisor continues the analysis. Switch topics to “What’s left on my onboarding checklist?” and the HR Buddy handles it directly via its API plugin. The user never thinks about which agent to talk to.
The Value: Compose Specialists, Maintain Independently
Connected agents aren’t about making one agent smarter. They’re about building an agent ecosystem.
Don’t over-engineer from day one. Start with a single agent. Split into connected agents when you see quality degrade, when your instructions get unwieldy, or when another team already has an agent you can connect to. The monolith-first approach works just as well for agents as it does for software.
Compose, don’t duplicate. The IT team builds and maintains the IT Support Agent. The Total Rewards team owns the Benefits Advisor. The HR team manages the Onboarding Buddy. Each team iterates independently on their domain, updating knowledge, refining instructions, and adding new tools, without coordinating with every other team.
Build horizontal workers. Think about agents that multiple teams can connect to: a Helpdesk Agent that any department’s agent can delegate to, a Compliance Agent that surfaces regulatory info across the organization, a Benefits Agent that HR, Finance, and manager agents all leverage. You’re not building one massive agent: you’re building a network of reusable specialists.
Scale without degradation. Instead of one agent with 15 knowledge sources and 8,000 characters of instructions getting confused, you have three focused agents that each excel in their lane. Quality stays high as organizational scope grows.
Resources
Have questions or want to share what you're building? Connect with me on LinkedIn or check out more on The Manifest.