Domain 1 of 3 · Chapter 16 of 22

Add tools to a topic

Unlock the complete study guide + 1,040 practice questions across 16 full exams.

Bundled into the existing Designing and Building Integrated AI Agent Solutions in Copilot Studio premium course — no separate purchase.

14-day money-back guarantee — no questions asked.

Included in this chapter:

  • One menu item, two decisions, five settings
  • Six mechanisms, and two that exist only in a topic
  • Agent level or topic level: the scope decision
  • Placing the Action node at the step that matters
  • Writing a description the orchestrator can act on
  • Identity: three things must line up before a tool runs
  • Asking the user before the tool runs
  • How each tool input gets its value
  • Choosing what the user sees after the tool runs
  • How these choices show up in questions

The six tool mechanisms, and what each one is for

Tool mechanismWhat it wrapsReach for it whenTopic-side caution
ConnectorA Power Platform connector operation, prebuilt or customOne typed read or write against a system that already has a connectorNeeds a connection; premium connectors need a plan that includes them
Agent flowA published Copilot Studio agent flow with one or more actionsThe work is multistep, or the same logic is called from several topicsOnly appears in the panel once it meets the flow-side eligibility criteria
PromptA single-turn model-based prompt that can reference knowledge you provideThe step is a language or analysis task rather than a system callExists at agent level or topic level, so confirm which scope a scenario intends
REST APISelected endpoints and methods from an OpenAPI specificationThe system publishes an API and no suitable connector existsPreview; add only the operations the agent should be able to perform
Model Context ProtocolAn MCP server's published tools and resourcesThe far side already speaks MCP and its tool set may growIts configuration page shows Tools and Resources instead of Inputs and Completion
Computer useInteraction with a graphical interface, on websites and desktop appsThe system has no API, connector, or protocol endpoint at allSlowest and most brittle path; treat it as the last resort

Decision tree

Does the step call anexternal system at all?noPromptSingle-turn model call over your knowledgeyesSeveral ordered actions,branching, or error handling?yesAgent flowOne callable unit of ordered actionsnoIs there a Power Platformconnector operation for it?yesConnectorOne typed operation, prebuilt or customnoDoes it publish an OpenAPIspecification?yesREST APISelected endpoints and methodsnoDoes it publish a ModelContext Protocol endpoint?yesModel Context ProtocolThe server publishes its tools and resourcesnoComputer useLast resort: drive the graphical interface

Cheat sheet

  • Choose the tool type that matches the external capability
  • Insert an Action node when the topic must call a tool explicitly
  • Use the narrowest effective scope for a tool
  • Configure tool authentication before testing the topic
  • Write a distinct tool description for correct selection
  • Ask the end user before running a sensitive tool
  • Configure how each tool input is filled and validated
  • Select completion behavior to match response-control requirements

Unlock with Premium — includes all practice exams and the complete study guide.

Also tested in

References

  1. Add tools to custom agents
  2. Create and edit topics - Microsoft Copilot Studio
  3. Extend your agent with tools from a REST API (preview)
  4. Use shared tools from the Tools page
  5. Create search query
  6. Perform custom search
  7. Call tools from agent topics (Take action in agent conversations training module)
  8. Add an agent flow as a tool to an agent - Microsoft Copilot Studio
  9. Use prompts to make your agent or agent flow perform specific tasks
  10. Orchestrate agent behavior with generative AI - Microsoft Copilot Studio
  11. https://learn.microsoft.com/en-us/microsoft-copilot-studio/advanced-additional-settings-topic-action-inputs
  12. Configure high-quality instructions for generative orchestration
  13. Use connectors in Copilot Studio agents
  14. Configure user authentication for tools
  15. Test your agent - Microsoft Copilot Studio
  16. Multistage and AI approvals in agent flows