typespec-create-agent은(는) 무엇을 하나요?
Microsoft 365 Copilot용 완전한 TypeSpec 선언적 에이전트를 지침, 기능, 대화 시작점과 함께 생성합니다.
개요
이 스킬은 TypeSpec을 사용하여 Microsoft 365 Copilot용 선언적 에이전트를 생성하는 프로세스를 간소화합니다. TypeSpec을 사용하면 에이전트의 동작, 기능 및 대화 상호 작용을 선언적 방식으로 정의할 수 있으므로 수동 구성보다 더 쉽게 유지 관리하고 확장할 수 있습니다.
시작하기
필수 조건
- TypeSpec CLI 설치 (
npm install -g @typespec/compiler) - Microsoft 365 Copilot Studio 액세스 (선택 사항, 배포용)
사용법
-
새 TypeSpec 프로젝트를 만듭니다:
tsp init -
선언적 에이전트 템플릿을 생성합니다:
tsp generate github/typespec-create-agent -
생성된
agent.tsp파일을 편집하여 에이전트를 사용자 지정합니다.
TypeSpec 선언적 에이전트 구조
생성된 템플릿은 다음 섹션을 포함합니다:
- 패키지 및 모델 가져오기
- 에이전트 지침 (
model Instruction) - 기능 정의 (
model Capability) - 대화 시작점 (
model ConversationStarter) - 에이전트 구성 (
model AgentConfig)
예제
import "@typespec/openapi";
model CustomerSupportAgent {
name: "Customer Support Agent";
instructions: "고객 문의에 친절하고 효율적으로 응답합니다.";
capabilities: ["ticket-management", "faq-lookup", "escalation-handling"];
conversationStarters: [
"주문 상태를 확인할 수 있나요?",
"환불 정책이 어떻게 되나요?"
];
}
지원 플랫폼
- Microsoft 365 Copilot Studio – TypeSpec 파일을 가져와서 Copilot 에이전트를 생성합니다.
- Azure AI Foundry – TypeSpec 구성을 지원하는 AI 에이전트 배포 플랫폼.