이 문서에서는 선언적 에이전트에 연결된 기술에 대해 설명합니다. 에이전트를 만들지 않고 Microsoft 365 Copilot Chat에서 직접 사용할 기술을 작성하려면 Copilot Chat 기술 구축을 참조하세요. 이 문서의 지원 매트릭스는 모든 기술 또는 플러그인 패키지가 아닌 에이전트 범위 기술에 적용됩니다.
중요
Microsoft Purview IB(정보 장벽)를 사용하는 테넌트에서 관리자는 기술이 있는 선언적 에이전트를 배포할 수 있지만 최종 사용자는 자신이 만든 선언적 에이전트에 기술을 추가할 수 없습니다.
스킬은 특정 작업을 보다 안정적이고 반복적으로 수행하는 데 도움이 되도록 선언적 에이전트에 추가하는 모듈식 기능입니다. 기술은 필수 SKILL.md 파일과 선택적 리소스 파일 및 스크립트가 포함된 파일 디렉터리입니다.
SKILL.md 이 파일에는 모델이 작업을 완료하도록 지시하는 명령이 포함되어 있습니다.
기술은 선언적 에이전트의 고유한 구성 요소입니다. 이전 지침에서 스킬 이라는 단어는 상담원의 지시 사항 내에 인라인으로 작성한 작업 설명을 가리켰습니다. 기술은 이러한 접근 방식을 대체합니다. 지침에 직접 작업 세부 정보를 작성하는 대신 에이전트가 참조하는 별도의 구성 요소로 패키징합니다. 명령에서 기술을 참조하는 방법에 대한 지침은 선언적 에이전트에 대한 효과적인 지침 작성을 참조하세요.
에이전트 작성기를 사용하여 선언적 에이전트에 기술을 추가할 수 있습니다. 지원되는 프로 코드 시나리오의 경우 Work IQ Dev Tools 를 사용하는 것이 좋습니다. 해당 wiqd agent add skill 경로에는 기능 플래그가 필요 agent-skills 하며, 이 플래그는 기본적으로 꺼져 있습니다. 기술 구현 경로 선택을 참조하세요.
도구 키트 기반 연습은 기존 도구 키트 프로젝트에 계속 사용할 수 있습니다.
스킬이란?
스킬은 다음 내용이 포함된 디렉터리입니다.
- 다음을 포함하는 필수
SKILL.md파일:- YAML 프론트 매터의 기술 이름 및 설명입니다.
- 기술 지침(20,000자 미만이어야 함).
- 템플릿, 참조 데이터 또는 정의와 같은 선택적 리소스 파일입니다.
- 선택적 스크립트 및 지원 폴더.
예를 들어 재무 팀은 검토 생성 지침, 데이터를 변환하고 차트를 생성하는 스크립트, 재무 모델, KPI 정의 및 브랜드 슬라이드 템플릿과 같은 자산을 번들로 포함하는 분기별 비즈니스 검토 기술을 구축할 수 있습니다. 에이전트는 사용자가 해당 작업을 요청할 때 해당 기술을 사용합니다.
선언적 에이전트에서 기술을 사용하는 이유
기술은 보다 안정적이고 반복 가능한 에이전트 워크플로를 구축하는 데 도움이 됩니다.
- 컨텍스트 사용 최적화 및 정확도 향상. 기술은 점진적 공개를 사용합니다. 모델은 작업에 필요한 경우에만 기술의 지침과 콘텐츠를 컨텍스트에 로드합니다. 에이전트의 컨텍스트는 기술 라이브러리가 성장하더라도 집중됩니다. 모델에서 생성된 코드에 의존하는 대신 스크립트를 제공하면 워크플로의 반복성이 향상됩니다.
- 품질 손실 없이 명령의 크기를 조정합니다. 복잡한 명령을 재사용 가능한 모듈식 기술로 분해할 수 있습니다. 이 접근 방식을 사용하면 명령 준수 품질을 저하시키지 않고 선언적 에이전트 지침에 대한 8,000자 제한을 초과하지 않고 더 길고 구체적인 지침을 제공할 수 있습니다.
- 재사용 가능한 자산을 패키지합니다. 지침, 리소스 및 스크립트를 기술로 함께 패키지하고 해당 기능을 선언적 에이전트에 통합할 수 있습니다.
- 엔터프라이즈 준비. 스크립트는 보안 샌드박스에서 실행되고, 기술 파일의 민감도 레이블은 보존 및 적용되며, 관리자 거버넌스를 사용할 수 있습니다.
지원 매트릭스
Agent Builder 또는 Agents Toolkit을 사용하여 기술을 추가하는지에 따라 일부 제한 사항이 다릅니다.
다음 표에서는 WIQD 제한이나 기능 적용 범위가 아닌 이 두 작성 경로에 대해 설명합니다. 권장되는 프로 코드 경로의 경우 WIQD 설명서에서 현재 요구 사항을 확인하세요.
| 항목 | 에이전트 작성기 | 에이전트 도구 키트 |
|---|---|---|
| 에이전트당 최대 스킬 | 8 | 8 |
| 기술 패키지 | 압축, .zip최대 50MB |
기술 디렉토리; .zip 지원되지 않음 |
| 최대 파일 크기 | 파일당 25MB | 기술 수준 제한 없음; 전체 앱 패키지는 10MB로 제한됩니다 |
| 패키지당 최대 파일 수 | 모든 기술에 걸쳐 350개 파일 | 모든 기술에 걸쳐 350개 파일 |
| 개별 업로드에서 기술 구축 | 지원되지 않습니다. 전체 업로드 .zip |
전체 기술 디렉터리 추가 또는 가져오기 |
| 디렉터리 계층 구조 | 최대 디렉터리 깊이는 3입니다. | 최대 디렉터리 깊이는 3입니다. |
| 에이전트 간에 다시 사용 | 지원하지 않음 | 지원되지 않음 |
지원되는 파일 및 스크립트 형식
기술에는 다음 파일 형식이 포함될 수 있습니다.
| 범주 | 파일 형식 |
|---|---|
| 지침 및 리소스 파일 |
.json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .txt, .rtf, .md, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log |
| 스크립트 및 바이너리 |
.py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash |
스크립트 실행 샌드박스
기술 스크립트는 보안 샌드박스에서 실행되며 다음과 같은 제한이 적용됩니다.
| 기능 | 지원 |
|---|---|
| 스크립트에서 인터넷 또는 네트워크 액세스 | 샌드박스는 브라우저 사용 기간을 제외하고 런타임에 네트워크 액세스 권한이 없습니다. |
| 패키지 설치 | 지원되지 않습니다. 기술은 런타임에 패키지를 설치할 수 없습니다. |
| 스크립트에서 인증된 네트워크 호출 | 지원되지 않습니다. |
| 사전 설치된 패키지 및 도구 | 기술은 샌드박스에 이미 있는 패키지와 도구만 사용할 수 있습니다. 사용 가능한 패키지 및 도구를 참조하세요. |
| 커넥터, API 플러그 인 및 MCP 서버 | 에이전트는 오케스트레이터를 통해 사용하도록 설정된 기능을 사용할 수 있습니다. 스크립트는 샌드박스를 통해 호출할 수 없습니다. |
사용 가능한 패키지 및 도구
선언적 에이전트에 연결된 기술과 Copilot Chat에서 직접 사용하는 기술에는 동일한 샌드박스 및 패키지 인벤토리가 적용됩니다. 서비스 업데이트는 패키지 가용성 및 버전을 변경할 수 있습니다.
| 범주 | 패키지 및 도구 |
|---|---|
| 문서 및 스프레드시트 |
python-docx, , python-pptx, openpyxl, xlsxwriterdocx, , ; pptxgenjs LibreOffice, Pandoc |
| PDF 처리 |
pypdf, , pymupdf, pdfplumber, reportlabpdf-lib, , ; pdfjs-dist poppler (pdftotext, pdfinfo, pdftoppm), ghostscript |
| 데이터 분석 |
numpy, pandas, scipy, scikit-learn |
| 차트 작성 |
matplotlib, plotly, seaborn |
| 이미지 및 벡터 처리 |
pillow, ; sharp ImageMagick, 잉크스케이프 |
| OCR |
pytesseract, ; ocrmypdf 테서랙트 |
| 오디오/비디오 처리 | FFmpeg |
| LaTeX 문서 생성 | TeX Live (pdflatex, latexmk) |
| JSON 처리 | jq |
| 개발자 도구 | TypeScript, ts-node, Jupyter 구성 요소, Playwright |
민감도 및 저장 공간
| 항목 | 지원 |
|---|---|
| 민감도 레이블 | 샌드박스는 민감도 레이블을 유지하고 레이블 정책을 따릅니다. 사용자 정의 권한 또는 이중 키 암호화를 지원하지 않습니다. |
| 저장소 | 시스템은 업로드된 기술 파일을 테넌트 범위의 SharePoint Embedded 컨테이너에 저장합니다. |