typespec-create-api-plugin

Generate TypeSpec API plugins for Microsoft 365 Copilot with REST operations, authentication, and Adaptive Cards.

- Scaffolds complete TypeSpec projects with agent definitions (main.tsp) and API operations (actions.tsp) following Microsoft 365 Copilot conventions

- Supports four authentication modes: public APIs, API key headers, OAuth2 with authorization code flow, and registered auth references

- Includes optional confirmation dialogs for destructive operations and Adaptive Card templates for rich response formatting

- Provides decorators for operation reasoning, response instructions, and model definitions aligned with RESTful best practices

Create TypeSpec API Plugin

Create a complete TypeSpec API plugin for Microsoft 365 Copilot that integrates with external REST APIs.

Requirements

Generate TypeSpec files with:

main.tsp - Agent Definition

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

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