Share via

Build Security Copilot agents by uploading a YAML

Important

Some information in this article relates to a prereleased product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

If you prefer not to use natural language prompts or the form-based Agent builder, you can define your agent by uploading a YAML manifest. This approach gives developers the flexibility to build the agent YAML in their development environment of choice.

This is best suited for developers who want to:

  • Reuse existing configurations
  • Manage agent definitions through iterations
  • Work outside of UI-driven or conversational experiences

This article explains how to build an agent by creating and uploading a YAML manifest to Security Copilot.

Steps to build and upload the YAML

Step 1: YAML manifest schema

To build a custom agent using a YAML file format and understand the required attributes, see Agent Manifest.

Step 2: Create the manifest YAML

For a sample manifest YAML, see Agent Manifest. You can also build agents using MCP tools in the MCP-compatible IDE of choice and upload the agent YAML here.

Step 3: Upload the YAML

You'll upload your custom agent YAML as follows:

  • Select the card Upload a yaml.

  • Select Upload.

    Image of the Upload Agent YAML in Security Copilot

  • Select your .yaml file from the file explorer.

  • After the file is uploaded, the agent builder dislays the components of the manifest file, including tools (skills) with its details and agent overview.

  • You can toggle View code to see the YAML manifest file. Toggle to switch to the form view.

    Image of the Agent YAML code view in Security Copilot

  • You can customize any parts of the agent from here such as updating the agent overview details.

  • You can also open the Tools section to:

    • Add Tools: Add an existing tool from the Tool catalog.
    • Create tool: Create a new tool.

For more details and documentation on create tool, see Tools.

  • Alternatively, you can use the Chat interface to interact with your agent and its tools.

Next steps