typespec-create-agent

by github

Generate a complete TypeSpec declarative agent for Microsoft 365 Copilot with instructions, capabilities, and conversation starters. Produces a main.tsp file with agent declaration, instructions, conversation starters, and capability definitions following Microsoft's TypeSpec M365 Copilot schema Supports 10 capability types including WebSearch, OneDriveAndSharePoint, TeamsMessages, Email, People, CodeInterpreter, GraphicArt, GraphConnectors, Dataverse, and Meetings with optional scoping... npx skills add https://github.com/github/awesome-copilot --skill typespec-create-agent Download ZIPGitHub36.2k

Create TypeSpec Declarative Agent

Create a complete TypeSpec declarative agent for Microsoft 365 Copilot with the following structure:

Template Structure

import "@typespec/http";
import "@typespec/openapi3";
import "@microsoft/typespec-m365-copilot";

using TypeSpec.Http;
using TypeSpec.M365.Copilot.Agents;

@agent({
 name: "[Agent Name]",
 description: "[Agent Description]"
})
@instructions("""
 [Detailed instructions about agent behavior, role, and guidelines]
""")
@conversationStarter(#{
 title: "[Starter Title 1]",
 text: "[Example query 1]"
})
@conversationStarter(#{
 title: "[Starter Title 2]",
 text: "[Example query 2]"
})
namespace [AgentName] {
 // Add capabilities as operations here
 op capabilityName is AgentCapabilities.[CapabilityType] ;
}

Best Practices

• Use descriptive, role-based agent names (e.g., "Customer Support Assistant", "Research Helper")

• Write instructions in second person ("You are...")

• Be specific about the agent's expertise and limitations

• Include diverse conversation starters that showcase different features

• Only include capabilities the agent actually needs

• Scope capabilities (URLs, folders, etc.) when possible for better performance

• Use triple-quoted strings for multi-line instructions

Examples

Ask the user:

• What is the agent's purpose and role?

• What capabilities does it need?

• What knowledge sources should it access?

• What are typical user interactions?

Then generate the complete TypeSpec agent definition.