declarative-agents은(는) 무엇을 하나요?
Microsoft 365 Copilot 선언형 에이전트를 위한 완전한 개발 키트로, 세 가지 포괄적인 워크플로(기본, 고급, 검증), TypeSpec 지원, Microsoft 365 Agents Toolkit 통합을 제공합니다.
개요
이 저장소는 Microsoft 365 Copilot용 선언형 에이전트를 구축하기 위한 도구와 워크플로를 제공합니다. 선언형 에이전트는 특정 지침과 지식 원본을 사용하여 사용자 쿼리를 처리하는 사용자 정의 Copilot 경험입니다.
워크플로
기본 워크플로
빠른 시작 템플릿을 사용하여 기본 선언형 에이전트를 생성합니다. 이 워크플로는 다음을 포함합니다:
- 표준 에이전트 구성을 위한 퀵스타트 템플릿
- 기본 지식 원본 설정
- 간단한 매니페스트 생성
고급 워크플로
고급 사용자 정의 및 구성을 위한 TypeSpec 기반 워크플로:
- TypeSpec을 사용한 상세한 에이전트 구성
- 외부 API 통합
- 사용자 정의 지침 및 동작
- Microsoft 365 Agents Toolkit과의 통합
검증 워크플로
에이전트 구성 및 배포 검증:
- 필요한 패키지 설치 확인
- 설정 및 구성 검증
- CI/CD 파이프라인 통합
지원 플랫폼
- VSCode: Microsoft 365 Agents Toolkit 확장을 통한 완전한 IDE 지원
- Visual Studio: .NET 기반 개발을 위한 통합 도구
- CLI: 명령줄 도구를 사용한 자동화된 워크플로
시작하기
필수 조건
- Node.js 18 이상
- Microsoft 365 개발자 테넌트
- Azure 구독 (선택 사항)
빠른 시작
# 저장소 복제
git clone https://github.com/microsoft/declarative-agents.git
cd declarative-agents
# 의존성 설치
npm install
# 기본 워크플로 실행
npm run create:basic -- --name my-agent
구성
매니페스트 파일
선언형 에이전트는 에이전트 동작, 지식 원본 및 작업을 정의하는 JSON 매니페스트를 사용합니다.
예시 매니페스트:
{
"$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.0/schema.json",
"version": "1.0",
"name": "My Agent",
"description": "사용자 쿼리를 처리하는 사용자 정의 에이전트",
"instructions": "유용한 응답을 제공합니다.",
"capabilities": [
{
"name": "WebSearch",
"enabled": true
}
]
}
TypeSpec 구성
고급 사용자를 위해 TypeSpec을 사용하여 에이전트 구성을 정의할 수 있습니다:
model AgentConfig {
name: string;
description: string;
instructions: string;
knowledge?: KnowledgeSource[];
actions?: Action[];
}
model KnowledgeSource {
type: "file" | "web" | "sharepoint";
location: string;
}
Microsoft 365 Agents Toolkit 통합
이 툴킷은 VSCode 및 Visual Studio와 원활하게 통합되어 다음을 제공합니다:
- 프로젝트 생성 마법사
- 구성 편집기
- 디버깅 지원
- 배포 자동화
배포
선언형 에이전트는 다음과 같은 방법으로 배포할 수 있습니다:
- Microsoft Teams 관리 센터
- PowerShell을 통한 자동화된 배포
- CI/CD 파이프라인 (Azure DevOps, GitHub Actions)
참고 자료
기여하기
이 프로젝트에 기여하려면 기여 가이드라인을 참조하세요.
라이선스
이 프로젝트는 MIT 라이선스 하에 제공됩니다.