빌드 또는 재사용 중에 구성 요소 계획에서 선택한 선언적 에이전트 구성 요소를 구현합니다. 이 문서는 제품 프로시저를 선택하고 구성 요소의 준비 상태를 확인하는 데 도움이 됩니다. 작업 에이전트와 해당 종속성, 플러그 인 통합에 대한 테스트 증거로 마무리합니다.
모든 플러그인에 에이전트가 필요한 것은 아닙니다. 사용자 고유의 오케스트레이션, 모델, 호스팅 또는 런타임의 경우 대신 앱 경로를 따릅니다.
에이전트를 만들기 전에 기존 에이전트 확인
기존 에이전트의 의도된 사용자, 지원되는 환경, 지침, 지식, 작업, 권한 및 소유자와 함께 알려진 제한 사항을 검토합니다.
확인: 문서화된 기능은 구성 요소 계획의 작업 및 대상 환경과 일치합니다.
문서화된 제품의 재사용 또는 확장 경로를 선택합니다. 에이전트 템플릿으로 시작하거나 해당 워크플로가 적합할 때 에이전트 빌더 에이전트를 Copilot Studio에 복사할 수 있습니다.
확인: 경로는 원본과 대상을 지원합니다. 에이전트 구성 요소를 플러그인에 추가하면 기존 프로젝트를 가져오는 것으로 가정하지 마세요.
소유권, 버전 관리, 지원, 변경 관리에 동의한 후 대표 작업을 테스트합니다.
확인: 에이전트를 변경하지 않고 사용하거나, 구성하거나, 새 구성 요소를 빌드하기로 결정하기 전에 결과와 해결되지 않은 괴리를 기록합니다.
Work IQ Dev 도구로 시작
전문성 개발의 경우 Work IQ Dev Tools로 시작하고, 문서화된 환경을 선택하고, 구성 요소에 특정 프로젝트 컨트롤이 필요한 경우에만 Agents Toolkit을 추가합니다.
| 시작 지점 | 제품 절차 | 예상 결과 |
|---|---|---|
| 에이전트 구성 요소가 필요한 새 플러그 인 | Work IQ Dev 도구를 사용하여 플러그인 빌드 |
wiqd plugin create 컨테이너를 만듭니다. wiqd plugin add agent 선택적 에이전트 구성 요소를 스캐폴딩합니다. |
| 기존 선언적 에이전트 원본 프로젝트 | 에이전트 구성 요소 수명 주기 | 문서화된 wiqd agent 명령을 사용하여 에이전트별 작성 및 반복을 계속합니다. |
| 편집해야 하는 에이전트 지침, 지식 또는 작업 | WIQD의 선언적 에이전트 및 명령 참조 | 선택한 구성 요소 및 환경에 대해 구성된 저장된 원본입니다. |
단계별 작업에는 WIQD 코딩 도우미 플러그 인을 사용하고, 반복 가능한 명령에는 직접 CLI를 사용합니다. 필요한 경우 코딩 도우미 플러그인 및 CLI를 별도의 필수 구성 요소로 설치합니다. GitHub Copilot은 파일, 지침, 구성 및 테스트를 작성하는 데 도움이 됩니다. 작성 도구, 런타임 또는 구성 요소 요구 사항을 대체하지 않습니다.
기존 에이전트 프로젝트의 경우 오프라인 유효성 검사를 명시적으로 선택합니다.
wiqd agent validate --mode source --env dev
확인: 저장된 원본 결과를 읽고 보고된 오류를 수정합니다. 소스 검사를 통과한다고 해서 런타임 동작, 엔드포인트 연결성, 인증 정확성 또는 최종 패키지 승인이 설정되지는 않습니다. 기본 package 모드는 기존 ZIP을 사용하고 유효성 검사를 위해 업로드하며 로그인이 필요할 수 있습니다.
기존 WIQD 에이전트 프로젝트에 기술을 추가하려면 에이전트 기술 명령 참조에서 기능 플래그와 현재 스키마 요구 사항을 검사 agent-skills 합니다. 최상위 플러그인 기술과 선언적 에이전트에 연결된 기술은 서로 다른 등록입니다. 둘 다 모든 호스트에서 지원을 설정하지는 않습니다.
구성 요소에 맞는 경우 다른 제품 경로를 사용합니다.
| 요구 사항 | 제품 절차 |
|---|---|
| Microsoft 365 Copilot에서 관리되는 작성 | 에이전트 빌더 개요 및 빌드 에이전트 |
| 로우코드 논리, 관리되는 환경 또는 Power Platform 커넥터 | Copilot Studio 및 Teams 및 Microsoft Copilot용 에이전트 연결 및 구성 |
| 하위 수준 에이전트 매니페스트 및 지원되는 개발 통합 | Work IQ Dev 도구 (지원되는 프로 코드 시나리오에 권장) |
| 기존 도구 키트 에이전트의 기술 | 에이전트 도구 키트를 사용하여 기술 추가 |
독립 실행형 Copilot Studio 에이전트는 플러그 인이 아닌 에이전트 레지스트리에 표시됩니다. 독립 실행형 에이전트를 게시한다고 해서 플러그 인으로 다시 패키징된다고 가정하지 마세요.
에이전트 구성 및 테스트
자세한 구현 단계는 선언적 에이전트 제품 지침을 따르세요.
| 완료할 작업 | 권위 있는 지침 | 확인 |
|---|---|---|
| ID, 동작, 작업 경계 및 대화 시작 사용자 정의 | 에이전트를 빌드하거나JSON으로 빌드한 다음 효과적인 지침을 작성합니다. | 대표 프롬프트는 예상된 동작을 생성하고 의도한 작업 내에 머무릅니다. |
| 지식 및 기능 구성 | 기술 자료 및 기능 및 사용자 지정 작업 추가 | 필요한 데이터는 의도한 사용자가 사용할 수 있으며 사용 권한이 허용하지 않는 경우에는 사용할 수 없습니다. |
| 지원되는 MCP 또는 API 작업 추가 | 선언적 에이전트용 MCP 및 API 플러그 인 | 도구 선택, 인증, 동의, 확인, 오류 및 지원되지 않는 요청이 의도한 대로 작동합니다. |
| 지원되는 기술 추가 | 선언적 에이전트 기술 및 선택한 작성 절차 | 대상 에이전트는 기술을 로드하고 해당 제품의 한도 내에서 정의된 작업을 완료합니다. |
| 작성 경로에 대한 구성 관리 | 도구 키트 환경 및 버전 또는 WIQD 환경 | ID 값, 종속성 및 설정은 의도한 테스트 환경에 속합니다. |
에이전트 버전, 소유자, 지원되는 환경, 종속성, 알려진 제한 사항 및 테스트 결과를 기록합니다. 제품별 테스트가 필요합니다. 소스 또는 패키지 유효성 검사를 통과한다고 해서 모든 사용자가 작업을 실행할 수 있다는 증거는 아닙니다.
디자인 지침은 선언적 에이전트에 대한 모범 사례 및 Copilot 오케스트레이터가 작업을 선택하는 방법을 참조하세요. 필요한 동작이 작동하면 필요에 따라 사용자 피드백을 사용하도록 설정 하고 콘텐츠 검색을 최적화할 수 있습니다.
다음 단계
나머지 구성 요소를 빌드 또는 재사용에서 계속 진행합니다. 준비가 되면 패키지 & 테스트 에 통합 및 구성 요소를 테스트합니다.