--- title: "Agent-to-Agent Links — AVCodex Docs" description: "Agent-to-Agent Links — AVCodex documentation for AV integrators, programmers, and ops teams." lang: en json-ld: --- [](/) Solutions [Pricing](/pricing)[The Signal](/blog)[Resources](/resources) Learn [Free AI Assessment](/scorecard)[Get Started →](/pricing) [Documentation Home](/docs) Guides Getting Started - [The Alchemist Copilot](/docs/guides/the-alchemist-copilot) - [Choosing a Model](/docs/guides/choosing-a-model) - [Skills & Templates](/docs/guides/skills-and-templates) - [Pricing & Usage](/docs/guides/pricing-and-usage) - [Understanding Tokens](/docs/guides/understanding-tokens) - [Maximize AVCodex Capabilities](/docs/guides/maximize-avcodex-capabilities) Knowledge & Memory - [How Knowledge Sources Work](/docs/guides/how-knowledge-sources-work) - [Knowledge Retrieval Settings](/docs/guides/knowledge-retrieval-settings) - [User Memory](/docs/guides/user-memory) - [Consumer Brain](/docs/guides/consumer-brain) Agent Capabilities - [Image Recognition](/docs/guides/image-recognition) - [Image Generation](/docs/guides/image-generation) - [Video Generation](/docs/guides/video-generation) - [Deep Research and Deep Thinking](/docs/guides/deep-research-and-deep-thinking) - [Heartbeat (Proactive AI Outreach)](/docs/guides/heartbeat-proactive-ai-outreach) - [Database Connections](/docs/guides/database-connections) - [Agent-to-Agent Links](/docs/guides/agent-to-agent-links) - [Message Tagging](/docs/guides/message-tagging) - [Lead Generation Forms](/docs/guides/lead-generation-forms) - [Multilingual Apps](/docs/guides/multilingual-apps) - [Understanding Evaluations](/docs/guides/understanding-evaluations) Design & Experience - [Style Studio](/docs/guides/style-studio) - [Component Studio](/docs/guides/component-studio) - [HQ Profile](/docs/guides/hq-profile) - [Multiplayer Chat](/docs/guides/multiplayer-chat) - [Circles](/docs/guides/circles) - [Desktop Agent](/docs/guides/desktop-agent) Voice & Phone - [Phone Numbers](/docs/guides/phone-numbers) - [Outbound Calling](/docs/guides/outbound-calling) - [Voice Cloning](/docs/guides/voice-cloning) Publish & Share - [Embed Chat Widget](/docs/guides/embed-chat-widget) - [Custom Domains](/docs/guides/custom-domains) - [PWA Installation](/docs/guides/pwa-installation) - [AVCodex Sites](/docs/guides/avcodex-sites) - [Embed on Kajabi](/docs/guides/embed-on-kajabi) - [How to Use AVCodex with Claude Code](/docs/guides/how-to-use-avcodex-with-claude-code) Monetization & Access - [Selling Access](/docs/guides/selling-access) - [Consumer Monetization](/docs/guides/consumer-monetization) - [Access Control](/docs/guides/access-control) - [Bring Your Own Auth](/docs/guides/bring-your-own-auth) - [Clever SSO for Schools](/docs/guides/clever-sso-for-schools) Analytics & Operations - [Analytics & Chat History](/docs/guides/analytics-and-chat-history) - [Performance Dashboard](/docs/guides/performance-dashboard) - [Programmatic Usage Stats](/docs/guides/programmatic-usage-stats) - [Session Lifecycle Webhooks](/docs/guides/session-lifecycle-webhooks) - [Audit Logs](/docs/guides/audit-logs) Teams & White-Label - [Team Management](/docs/guides/team-management) - [Enterprise Whitelabel](/docs/guides/enterprise-whitelabel) Alchemist Platform - [Alchemist Tickets](/docs/guides/alchemist-tickets) - [Alchemist Getting Started](/docs/guides/alchemist-getting-started) - [Alchemist Working with Tickets](/docs/guides/alchemist-working-with-tickets) - [Alchemist Local Development](/docs/guides/alchemist-local-development) Alchemist Operations - [Alchemist Environment Variables](/docs/guides/alchemist-environment-variables) - [Alchemist Deploys and Domains](/docs/guides/alchemist-deploys-and-domains) - [Alchemist Self-Healing](/docs/guides/alchemist-self-healing) Alchemist API & Automation - [Alchemist API Keys](/docs/guides/alchemist-api-keys) - [Alchemist MCP Server](/docs/guides/alchemist-mcp-server) - [Alchemist Pipeline Configuration](/docs/guides/alchemist-pipeline-configuration) - [Alchemist Pipeline Permutations](/docs/guides/alchemist-pipeline-permutations) Developer Platform - [Building Custom MCP Servers](/docs/guides/building-custom-mcp-servers) - [Consumer OAuth for Custom MCP Servers](/docs/guides/consumer-oauth-for-custom-mcp-servers) AVCodex MCP Server - [Overview](/docs/guides/overview) - [MCP Reference](/docs/guides/mcp-reference) - [Setup & Installation](/docs/guides/setup-and-installation) - [Authentication](/docs/guides/authentication) - [Tools Reference](/docs/guides/tools-reference) - [Common Workflows](/docs/guides/common-workflows) - [Rate Limits](/docs/guides/rate-limits) Custom Actions Pro Actions API Builder API Agentic Commerce (ACP) Integrations [Docs](/docs)/ Guides / Agent Capabilities # Agent-to-Agent Links Last updated · MAR 2026 · [Read as Markdown](/docs/guides/agent-to-agent-links.md) Build a team of specialist AVCodex agents that automatically hand off questions to each other. One front-line agent. A roster of specialists behind it. The user sees one conversation. Agent-to-Agent Links let one agent delegate to specialist agents in your workspace. Your main agent acts as the orchestrator. When a user asks something a specialist handles better, the orchestrator passes the question over and folds the response back into the answer. > **Note:** Agent links require a Builder plan or higher. ## [How It Works# ](#how-it-works) 1. You link specialist agents to your main agent. 2. Linked agents register automatically as tools during the user chat. 3. When the main agent decides a specialist would answer better, it calls that specialist. 4. The specialist responds using its own system prompt, model, and knowledge base. 5. The main agent folds the specialist's response into its reply. The user sees a single coherent conversation. They never need to know multiple agents are working behind the curtain. ## [Setting Up Agent Links# ](#setting-up-agent-links) **1\. Open Agent Tools** Open your agent's **Build** page, click the **Connect** tab, and find the **Agent Tools** card. **2\. Add Linked Agents** Click **Add agent tools**. A modal lists every agent in your workspace. Click one to link it. **3\. Test It** In the chat preview, ask a question that falls inside a specialist's lane. You should see the main agent delegate and incorporate the response. To remove a linked agent, click the **x** next to its name in the Agent Tools list. ## [What Gets Passed to Specialists# ](#what-gets-passed-to-specialists) When a linked agent is called: Passed Not Passed The specific question or request The user's conversation history Specialist's system prompt and model User memory or profile Specialist's knowledge base (RAG) Uploaded files Web search (if enabled on the specialist) Billing or subscription info Each call is a single turn. The specialist answers once and returns the result. No multi-turn back-and-forth between agents. ## [Delegation Depth# ](#delegation-depth) Linked agents can have their own linked agents, supporting multi-hop delegation: - **Depth 0:** user talks to your main agent. - **Depth 1:** main agent calls a specialist. - **Depth 2:** that specialist calls one of its linked agents. - **Depth 3:** maximum nesting depth. No further delegation. This prevents infinite recursion while still supporting reasonable multi-hop chains. ## [Use Cases# ](#use-cases) Scenario Setup **AV helpdesk triage** A front-line helpdesk agent routes Crestron control system questions to a Crestron-programmer agent, Q-SYS Lua questions to a QSC specialist, network and AV-over-IP questions to a network specialist. **Multi-manufacturer expertise** A design engineer's research agent delegates Crestron spec questions to a Crestron-docs agent, Q-SYS to a Q-SYS agent, Biamp to a Biamp agent, Shure to a Shure agent. **Department delegation** An internal AV ops agent sends RFP questions to a proposal-writing agent, programming questions to a code-review agent, and dispatch questions to a scheduling agent. **Skill-based routing** A sales-engineering agent asks the product-knowledge agent for the latest model numbers before composing the customer-facing response. ## [Billing# ](#billing) When a linked agent is called, token usage is billed to the **source agent's organization** (the agent the user is talking to). There is no extra fee for agent-to-agent calls. It is part of your standard LLM token billing. ## [Tips# ](#tips) - **Write clear descriptions** for your specialist agents. The main agent uses the description to decide when to delegate. Be specific. "Crestron SIMPL# Pro programmer assistant for control system code review and macro generation" beats "programming agent." - **Keep specialists focused.** A Q-SYS Lua specialist with a tailored system prompt and a Q-SYS knowledge base outperforms a general-purpose programmer agent. - **Test delegation patterns.** In the chat preview, ask questions that should trigger delegation and confirm the right specialist picks them up. ## [Troubleshooting# ](#troubleshooting) **Agent not delegating?** - Confirm the specialist is linked in the Connect tab. - Verify the specialist's description names the specialty clearly. - The main agent may answer itself if it already has the knowledge. **Wrong specialist being called?** - Tighten specialist descriptions so each one stakes out a clear lane. - Add explicit delegation guidance to your main agent's system prompt ("If the question involves Q-SYS, hand it to the Q-SYS specialist"). **Slow responses?** - Each delegation adds a round trip. - Decide whether the specialist adds enough value to justify the latency. - Avoid depth 2 to 3 nesting unless you need it. \*AVCodex · Your AV expertise. Amplified by AI.\* Was this helpful? [Edit this page →](#) [ Previous Database Connections ](/docs/guides/database-connections)[ Next Message Tagging ](/docs/guides/message-tagging) On this page - [How It Works](#how-it-works) - [Setting Up Agent Links](#setting-up-agent-links) - [What Gets Passed to Specialists](#what-gets-passed-to-specialists) - [Delegation Depth](#delegation-depth) - [Use Cases](#use-cases) - [Billing](#billing) - [Tips](#tips) - [Troubleshooting](#troubleshooting) [](/) The AI platform built exclusively for professional AV. Build, deploy, and sell AI tools that understand your industry. ### Platform - What You Can Build - Templates - [Pricing](/pricing) ### Services - [Done-For-You](/pricing) - [Academy](/academy) - [Contact](/contact) ### Company - About - [The Signal](/blog) - [Docs](/docs) - [LinkedIn](#) © 2026 AVCodex. A Future Ready Holdings Inc. product. SOC 2 Type II Certified · HIPAA Compliant