Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Task 03: Create a child agent to handle marketing inquiries

Introduction

Zava needs domain-specific agents that can act on enterprise tools while staying within clear scope. The marketing agent must use approved connectors for marketing actions and avoid answering outside its domain.

Description

In this task, you’ll create MarketingInquiryAgent as a child agent and attach the OpenAPI connector as its required tool. You’ll configure the agent instructions so it answers marketing requests only through the tool and declines non-marketing intents.

Success criteria

  • MarketingInquiryAgent successfully handles a marketing prompt by calling the marketing tool and returning a grounded response.

Key steps


01: Create the child agent

  1. Return to the Copilot Studio page.

  2. Select Agents and then select Marketing-HR-Domain-Router.

    6vdhdmnl.jpg

  3. On the command bar, select Agents and then select + Add.

    0szccy7y.jpg

  4. Select New child agent.

    809c6h9l.jpg

  5. Add the following information:
    • Agent Name: MarketingInquiryAgent
    • When will this be used?: The agent chooses - Based on description
    • Agent Description:
        This agent processes all marketing‑related inquiries, including campaigns, branding, digital assets, analytics, and interactions with systems such as CRM, MAP, and DAM, while upholding established marketing standards and escalating any out‑of‑scope or non‑marketing intents to the parent orchestrator for proper handling. It can also invoke a custom API to retrieve or update campaign data, access approved brand assets, trigger marketing workflows, or perform other system‑level operations, using secure authentication, schema‑validated payloads, and audited request and response logging.
      
  6. On the command bar for the agent, select Save.

    If Copilot Studio displays a message stating that there is an error, wait a few seconds and then try saving again. Copilot Studio might still be in the process of validating your instructions.

  7. In the left pane for MarketingInquiryAgent, select Tools, and then Add tool.

    Be sure to select Tools in the left pane for the child agent and not the left pane in Copilot Studio.

    9mrd9e6m.jpg

  8. Search for and select ZavaOpenAPICall then press enter.

    23tg2i8t.jpg

  9. Select the newly created tool, ZavaOpenAPICall.

    9wol8nu7.jpg

  10. Next to Connection, select the dropdown, and then select Create new connection.

    njqwv53i.jpg

  11. Select Create.

    vxws5l98.jpg

  12. Select Add and configure.

    92n88718.jpg

  13. On the command bar, select Settings and then select Connection Settings.

    e9py3rl0.jpg

  14. Select Connect and then select Submit.

    yuebiu8v.jpg

  15. Wait until the status is Connected and then exit Settings.

  16. On the Marketing-HR-Domain-Router page, select Agents.

    9fp6mqxg.jpg

  17. Select the MarketingInquiryAgent child agent.

  18. Select Instructions and enter the following text:

     For any inquiry related to marketing, respond only by using [tool]. For all non‑marketing inquiries, decline and direct the user to their primary assistant. Do not answer marketing questions without calling MarketingInquiryAgent.
    
  19. Highlight and delete [tool] and enter /. In the context menu, in the Tool section, select Get Marketing Data (Raw).

    4w3yxrn9.jpg

  20. On the command bar, select Save.

    hw0bdqsj.jpg

  21. Start a new test session and submit the following prompt:

     Please explain why the marketing team wants to open a couple of new stores?
    

    It may take a moment to respond because it needs to access external resources, and the GPT model is performing deep reasoning. Once it completes, notice how Marketing‑HR‑Domain‑Router was able to route the request to MarketingInquiryAgent, its child agent.

    yb2z2bwj.jpg


02: Revise the parent agent’s instructions to reinforce its redirect‑thinking process.

  1. Select the Overview tab of the Marketing‑HR‑Domain‑Router agent.

    k6wdqqn0.jpg

  2. In the Instructions tile, select Edit.

  3. Locate the text If Marketing, delegate to MarketingInquiryAgent.

  4. Highlight and delete MarketingInquiryAgent and then enter /. Select the MarketingInquiryAgent agent from the list.

    yjdxt8mz.jpg

  5. On the Instructions tile, select Save.

  6. On the command bar, select Publish.

    a38w19gm.jpg

  7. In the confirmation dialog, select Publish.

    fm275z3g.jpg


Congratulations!

You have completed this portion of the workshop.

!If you’re following these istructions as part of the live lab, you will launch a separate environment to complete Exercises 03 and 04 of the workshop.