현지화된 읽기 가이드

declarative-agent-developer목적, 사용법 및 출처

M용 선언적 에이전트를 생성, 구축, 배포 및 현지화합니다.365Copilot 및 Teams. 이 스킬은 선언적 에이전트와 관련된 모든 작업(현지화, 스캐폴딩, 매니페스트 편집, 기능 추가, 배포 등)에 사용할 수 있습니다. 현지화에는 토큰화된 매니페스트와 언어 파일이 필요한데, 이 스킬만이 이를 생성하는 방법을 알고 있습니다. 트리거: "에이전트 생성", "선언적 에이전트 생성", "새 선언적 에이전트", "에이전트 스캐폴딩", "새 에이전트 프로젝트", "기능 추가", "플러그인 추가", "에이전트 구성", "에이전트 배포", "에이전트 매니페스트 수정", "에이전트 편집", "에이전트 현지화", "현지화 추가", "에이전트 번역", "다국어 에이전트", "API 플러그인 추가", "MCP 플러그인 추가", "플러그인에 OAuth 추가", "지침 검토", "지침 개선", "지침 수정"

출처 검색됨: 2026-10-29

소스 저장소: microsoft/skills
SKILL.md: .github/plugins/microsoft-365-agents-toolkit/skills/declarative-agent-developer/SKILL.md
저장소 Star: 3,157
저장소 최근 업데이트: 2026-10-31
능력 분류: 에이전트 워크플로
최근 수집 시간: 2026-10-31 10:38 UTC+08:00

라이선스: MIT

원본 SKILL.md

워크플로 발췌본은 이해를 돕기 위한 자료이며, Codez에서 제공하는 실행 가능한 명령어가 아닙니다. 이 페이지를 생성하는 데 타사 Skill은 사용되지 않았습니다.

아래의 목적 및 워크플로 관련 내용은 읽기 쉽도록 정리 및 번역된 상위 자료입니다. 이는 별도로 분류된 Codez 편집 분석과는 별개입니다.

이 스킬의 기능

업스트림 워크플로우 작동 방식

⛔ 작업 공간 점검 — 필수 첫 단계

어떤 작업을 시작하기 전에 먼저 워크스페이스 파일을 확인하여 프로젝트의 지문을 생성하세요.npx -y --package @microsoft/m365agentstoolkit-cli atk --versionATK CLI가 설치되어 있는지 확인합니다. 설치되어 있지 않으면 → 중지합니다. 사용자에게 ATK를 설치하도록 안내합니다. 확인합니다.m365agents.yml또는teamsApp.yml프로젝트 루트에서 확인하세요.appPackage/declarativeAgent.json.

상류 통로 · L26 ↗

6변경 후에는 항상 지침 및 시작 정보를 업데이트하십시오.

기능이나 플러그인을 추가할 때 지침을 업데이트하지 않으면 작업이 완료되지 않습니다. 변경 후에는 반드시 지침을 업데이트하여 변경 사항을 설명해야 합니다.new/changed기능성 — 모든 데이터 소스는 지침 검토 품질 기준에 따라 명확한 사용 목적(언제, 왜 사용해야 하는지)을 명확히 제시해야 합니다. 내장 기능은 정확한 이름이 필요하지 않습니다.actions/plugins이름을 지정해야 합니다. 지침에 도구 이름, 설명 또는 매개변수를 나열하지 마십시오. 이러한 정보는 이미 플러그인 메타데이터에 있습니다.ai-plugin.json(MCP 매니페스트, 기능 구성 포함). 지침에는 각 도구를 언제 사용할지, 연결 규칙 및 오류 처리와 같은 결정 논리만 포함되어야 합니다. 최소한 다음 내용을 추가하십시오.1추가된 대화 시작 항목당capability/plugin

상류 통로 · L158 ↗

상류 통로 · bash ↗

export ATK_CLI_SKILL=true

요구 사항 및 설정

ATK CLI 설정

ATK 명령어를 실행하기 전에, 다음 명령어를 실행하여 ATK CLI를 사용할 수 있는지 확인하십시오.npx -y --package @microsoft/m365agentstoolkit-cli atk --version찾을 수 없으면 즉시 중지하고 사용자에게 알리십시오. 절대로 직접 설치를 시도하지 마십시오. 모든 명령은 다음을 사용합니다.npx -y --package @microsoft/m365agentstoolkit-cli atk접두사(예:npx -y --package @microsoft/m365agentstoolkit-cli atk provision --env local).

상류 통로 · L91 ↗

3스키마 버전 호환성

어떤 기능이든 추가하기 전에, 다음 내용을 읽어보세요.version필드declarativeAgent.json스키마 기능 매트릭스를 확인하십시오. 해당 버전에서 기능이 지원되지 않으면 거부하고 업그레이드를 제안하십시오. 주요 버전 게이트는 다음과 같습니다.

상류 통로 · L131 ↗

제한 사항 및 품질 검사

2절대로 콘텐츠를 허위로 만들거나 누락된 파일을 생성하지 마십시오.

임시 이름, 설명 또는 지침을 임의로 만들어내지 마십시오.declarativeAgent.json또는appPackage/만약 해당 항목이 존재하지 않는다면, 이는 "생성하여 도움을 주는" 시나리오가 아니라 "거부" 시나리오입니다.

상류 통로 · L123 ↗

4. 사용`npx -y --package @microsoft/m365agentstoolkit-cli atk add action`API 플러그인의 경우 - 절대로 플러그인 파일을 수동으로 생성하지 마세요.

수동으로 생성하는 것은 금지되어 있습니다.ai-plugin.jsonOpenAPI 사양, 적응형 카드 또는 편집actions배열. CLI 사용: 단일 실행npx -y --package @microsoft/m365agentstoolkit-cli atk add actionOpenAPI 사양에 따른 호출이며, 모든 작업은 쉼표로 구분된 목록으로 표시됩니다.--api-operation절대로 별도로 실행하지 마십시오.npx -y --package @microsoft/m365agentstoolkit-cli atk add action동일한 사양에서 서로 다른 작업을 요청하는 경우, 하나의 플러그인 대신 여러 개의 플러그인이 생성됩니다.npx -y --package @microsoft/m365agentstoolkit-cli atk add action실패 시 오류를 보고하십시오. 수동 생성으로 전환하지 마십시오.

상류 통로 · L141 ↗

안전한 시험 사용부터 시작하세요

지원되는 호스트와 저장소 설치 지침을 확인하세요. 스킬 디렉토리와 해당 디렉토리에서 참조하는 스크립트, 자산 및 문서를 함께 보관하세요.SKILL.md단독으로는 종속성을 생략할 수 있습니다.
에이전트에 실제 입력값, 원하는 출력값 및 승인 기준을 제공하십시오. 호출 구문 및 사용 가능한 도구는 호스트에 따라 다르므로 이 사이트는 범용 설치 명령을 제공하지 않습니다.
원본 워크플로를 임시 프로젝트 또는 복사본에서 테스트해 보세요. 파일, 원격 서비스 또는 유료 리소스를 변경하는 작업은 허용하기 전에 검토하십시오.
출력 결과를 원본 품질 검사 및 자체 요구 사항에 맞춰 검증하십시오. 트리거가 성공적으로 작동했거나 저장소의 별점 수가 높다고 해서 반드시 올바른 결과가 나오는 것은 아닙니다.

기술 형식 및 디렉토리 사양 ↗

원문에서 더 자세한 내용을 읽어보세요.

번역 및 범위

이 독서 안내서는 고정된 상류 지역에서 발췌한 구절들을 소개합니다.SKILL.md본 번역은 보조 번역이며, 완전한 설명서 또는 호환성 테스트를 보장하는 것은 아닙니다. 사용 전에 원본 및 참조 파일을 반드시 읽어 주십시오.

이 소개글은 아래 고정된 버전을 참조하며, 현재 저장소 활동 및 수집 시간은 별도로 표시됩니다.

고정된 소스: 원문을 읽어보세요 ↗
출처 검색됨: 2026-10-29T09:32:23Z
소스 커밋: 00d66a64919edca5bca2c673373444e36a4b5461
출처 SHA-256: 13d2af8dd44cca049c8ebf8a8880cca304fc3dc419c926ef146dba35b14df412

전체 스킬 카탈로그로 돌아가기