Error publishing an agent

Wayne, Mark H 5 Reputation points
2025-07-09T15:38:00.42+00:00

In trying to publish an agent I get an error message which indicates that the "Description" property is missing in the agent's configuration. This property is required for the agent to be published successfully. The agent has the description in place and the test works but it will not publish. I need guidance with screen shots to compare my setup to see what is missing.

Microsoft Copilot | Microsoft 365 Copilot | Development
{count} vote

1 answer

Sort by: Most helpful
  1. Karan Shewale 1,125 Reputation points Microsoft External Staff
    2025-07-11T03:38:42.7833333+00:00

    Hi Wayne,

    I understand you are facing this issue "Description" property missing error during agent publishing. This is a common issue that can occur even when the description appears to be properly configured. Let me walk you through the troubleshooting steps with specific areas to check.

    Key Areas to Verify

    1. Agent Manifest File (m365agents.yml)

    Ensure your description is properly formatted:

    name: YourAgentName

    description: "Your detailed agent description here"

    • Description must not be empty or contain only whitespace
    • Avoid special characters that might break parsing

    2. App Manifest (manifest.json)

    Verify both description fields exist:
    {
      "description": {
        "short": "Brief description (under 80 characters)",
        "full": "Detailed description of your agent's functionality"
      }
    }
    

    3. Common Screenshot Comparison Points

    When reviewing your setup, check these specific areas:

    • Teams Toolkit: Agent configuration panel description field
    • Manifest Editor: Both short and full description populated
    • Character Count: Short description under 80 characters
    • Validation Panel: No red error indicators

    4. Troubleshooting Steps

    1. Open your m365agents.yml file and verify the description exists
    2. Check manifest.json for both description properties
    3. Clear Teams Toolkit cache and rebuild
    4. Copy descriptions to notepad to check for hidden characters
    5. Validate manifest using Teams Toolkit validation tools

    5. Quick Fix Template

    Replace your descriptions with this tested format:

    description: "This agent assists with [specific task] and provides [key functionality] to help users [achieve goal]."

    If you're still encountering issues, could you share:

    • Your m365agents.yml description section
    • The exact error message text
    • Screenshot of your agent configuration panel

    This will help pinpoint the specific configuration issue.

    https://learn.microsoft.com/en-us/microsoftteams/platform/resources/schema/manifest-schema

    https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/declarative-agent-manifest-1.2?tabs=json

    https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/copilot-studio-agent-builder-publish

    Thanks,  

    Karan Shewale. 

    *************************************************************************  

    If the response is helpful, please click "Accept Answer" and upvote it. You can share your feedback via Microsoft Teams Developer Feedback link. Click here to escalate. 

    0 comments No comments

Your answer

Answers can be marked as Accepted Answers by the question author, which helps users to know the answer solved the author's problem.