Typespec create agent vs Typespec create API plugin
Typespec create agent is an open-source agent skill for developer tools. Typespec create API plugin is an open-source agent skill for developer tools.
- Typespec create agent is best for create a typespec agent for an internal hr policy assistant.
- Typespec create API plugin is best for wrap a company rest api as a microsoft 365 copilot plugin.
- What it is
- Typespec create agent is an open-source agent skill for developer tools.Typespec create API plugin is an open-source agent skill for developer tools.
- Best for
- Create a TypeSpec agent for an internal HR policy assistantWrap a company REST API as a Microsoft 365 Copilot plugin
- Kind
- SkillSkill
- Pricing
- Open sourceOpen source
- Platforms
- Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, GooseClaude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- GitHub stars
- 41.3K41.3K
- Last commit
- Nov 2026Nov 2026
- License
- MITMIT
- Open source
- Good for
- Create a TypeSpec agent for an internal HR policy assistant; Define a Copilot agent that searches a company SharePoint site; Generate a research helper agent with web search and conversation startersWrap a company REST API as a Microsoft 365 Copilot plugin; Create a TypeSpec agent that lists and creates tickets in an external system; Add an OAuth2-protected API to a Copilot agent
What Typespec create agent does
Agent declaration
Produces the agent name and description within the documented length limits.
Behavioral instructions
Drafts role, expertise and scope guidance for the agent in a multi-line instructions block.
Conversation starters
Adds two to four diverse starter prompts that showcase different capabilities.
Capability selection
Chooses from the supported Microsoft 365 Copilot capabilities based on what the agent needs.
Scoped access
Recommends limiting URLs, folders and sources to improve agent performance.
TypeSpec template
Follows a standard main.tsp structure with the required imports and namespace.
What Typespec create API plugin does
Agent definition scaffold
Provides a main.tsp template that declares the agent name, description and instructions and imports operations from an actions file.
REST operation mapping
Shows how to declare routes, HTTP verbs and typed parameters for each external API operation.
Authentication options
Covers no auth, API key, OAuth2 authorization code and registered auth references for the plugin.
Confirmation dialogs
Describes an Adaptive Card confirmation step for operations such as deletes or critical updates.
Adaptive Card responses
Explains binding response data to a card template with title, URL and data path mappings.
Guided setup questions
Lists the questions the agent should ask about the API before generating the TypeSpec files.
Typespec create agent vs Typespec create API plugin: questions
Is Typespec create agent or Typespec create API plugin cheaper?
Both are open source. Compare current plans on each official site.
What is the difference between Typespec create agent and Typespec create API plugin?
Typespec create agent is an open-source agent skill for developer tools. Typespec create API plugin is an open-source agent skill for developer tools.
