코딩 에이전트를 사용하여 Agent Framework 앱 빌드

Note

.NET용 Microsoft Agent Framework 빌더 기능은 아직 사용할 수 없습니다. builder-skill 작업이 추적되는 동안 .NET 시작 자습서 및 .NET 샘플을 사용합니다.

agent-framework-builder-python, ,은 호환되는 코딩 에이전트에 Python Agent Framework 솔루션을 빌드하기 위한 Microsoft에서 유지 관리하는 지침을 제공합니다. 코딩 에이전트가 적절한 패턴을 선택하고 작업에 대한 포커스가 있는 지침을 점진적으로 로드하는 데 도움이 됩니다.

이 기술은 다음 작업을 지원할 수 있습니다.

일반 에이전트, 모델 공급자, 도구, 승인, 세션, 기록 및 컨텍스트 공급자.
계획, 할 일 목록, 메모리, 압축, 파일, 백그라운드 에이전트, 셸 도구 및 루프를 사용하여 에이전트를 활용합니다.
함수형 및 그래프 워크플로, 기본 제공 오케스트레이션 및 선언적 정의.
평가, 관찰 가능성, 미들웨어, 사용자 지정 클라이언트, 사용자 지정 에이전트 및 통합.
자체 호스팅 및 Microsoft Foundry 호스팅 에이전트 개발.

기술은 Python 전용입니다. 외부 코딩 에이전트에 개발 지침을 제공합니다. Python 패키지가 아니고, pip install agent-framework에 의해 설치되지 않으며, Agent Framework 애플리케이션 내에서 실행되지 않습니다.

Important

이 코딩 에이전트 기술은 런타임 에이전트 기술과 다릅니다. 런타임 스킬은 애플리케이션이 실행되는 동안 에이전트 프레임워크 에이전트에 의해 로드됩니다. 빌더 스킬은 코딩 에이전트가 애플리케이션 소스 코드를 만들거나 수정하는 데 도움이 됩니다.

Tip

빌더 스킬을 Microsoft Learn MCP Server와 페어링하세요. 이 기술은 코딩 에이전트에 집중된 Agent Framework 워크플로 및 구현 지침을 제공하며 Learn MCP Server를 사용하면 현재 Microsoft 설명서를 검색하고, 전체 문서를 가져오고, 작업 중에 코드 샘플을 찾을 수 있습니다. 호환되는 코딩 에이전트에서 인증되지 않은 공용 Streamable HTTP 엔드포인트를 구성합니다.

https://learn.microsoft.com/api/mcp

Prerequisites

개방형 에이전트 스킬 사양을 지원하는 코딩 에이전트입니다.
미리 보기 명령이 포함된 gh skill 또는 교차 에이전트 skills CLI를 사용하는 경우 Node.js 22.20 이상.
새 Agent Framework 애플리케이션에는 Python 3.11 이상이 필요합니다. 에이전트 프레임워크 1.23은 여전히 Python 3.10을 지원하지만 Python 3.10은 업스트림 지원 종료(EOL)에 도달했습니다.

GitHub CLI 스킬 관리는 미리 보기 상태이며 변경될 수 있습니다.

GitHub CLI로 검토 및 설치

설치하기 전에 릴리스된 스킬 미리 보기:

gh skill preview microsoft/agent-framework agent-framework-builder-python@python-1.23.0

태그가 지정된 최신 버전을 설치하세요:

gh skill install microsoft/agent-framework agent-framework-builder-python

재현 가능한 지침이 필요한 경우 Python 1.23 릴리스를 고정합니다.

gh skill install microsoft/agent-framework agent-framework-builder-python@python-1.23.0

기본 설치는 프로젝트 범위이며 비대화형 사용 시 GitHub Copilot을 대상으로 합니다. 필요한 경우 지원되는 다른 코딩 에이전트 또는 사용자 범위를 선택합니다.

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent claude-code \
  --scope user

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent cursor

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent codex

현재 클라이언트 및 범위 옵션은 다음을 참조하세요 gh skill install.

에이전트 간 스킬 CLI를 사용하여 설치

대안으로 에이전트 skills 간 CLI를 사용하여 스킬을 설치합니다.

npx skills add microsoft/agent-framework --skill agent-framework-builder-python

설치하기 전에 CLI의 지원되는 코딩 에이전트 및 런타임 요구 사항을 검토하세요.

기술을 사용하세요

코딩 에이전트에게 자연스럽게 프롬프트를 입력합니다. 호환되는 클라이언트는 메타데이터에서 스킬을 발견하고 활성화합니다. 범용 슬래시 명령을 가정하지 마세요.

예제 프롬프트:

Build a Python Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.
Add approval-required tools and persistent conversation history to this Agent Framework application.
Convert this multi-agent design into an Agent Framework workflow and add checkpointing.
Create a harness agent with planning, todos, file access, and safe shell tooling.
Review this Python Agent Framework application for current APIs and package requirements.
Prepare this Agent Framework agent for Foundry hosting and add an evaluation plan.

모델 공급자, 호스팅 대상, 지속성 요구 사항, 보안 경계 및 지원되는 Python 버전과 같은 제약 조건을 알고 있는 경우 포함합니다.

코딩 에이전트가 수행해야 하는 작업

이 스킬은 코딩 에이전트에 다음을 지시합니다.

일반 에이전트, 하네스, 워크플로, 오케스트레이션 또는 선언적 정의와 같은 가장 작은 적합한 패턴을 선택합니다.
관련된 집중된 참조만 로드합니다.
변동이 잦은 세부 정보의 경우 현재 Microsoft Learn 지침, 공용 API 참조, 패키지 수명 주기 정보 및 유지 관리되는 샘플을 선호합니다.
모든 통합이 안정적이거나 필수라고 가정하지 않고 좁은 패키지 집합을 설치합니다.
명시적 세션, 승인, 인증 및 호스팅 경계를 유지합니다.
리포지토리의 기존 테스트, 형식 검사 및 실행 가능한 샘플을 사용하여 생성된 애플리케이션의 유효성을 검사합니다.

이 기술은 생성된 코드가 프로덕션 준비가 되었음을 보장하지 않습니다. 승인 전에 코딩 에이전트의 계획, 패키지 선택 사항, 보안 경계, 명령 및 생성된 변경 내용을 검토합니다.

버전 지정 및 신뢰

이 스킬은 python-1.23.0 리포지토리 태그에서 릴리스된 공개용, 설치 가능한 Microsoft에서 유지 관리하는 소비자 스킬입니다. 해당 기술의 메타데이터 버전은 0.3.

태그가 지정된 최신 릴리스에 대해 수식어 없는 install 명령을 사용합니다.
재현성이 중요할 때 @python-1.23.0을(를) 고정하세요.
의도적으로 미공개 지침을 원하는 경우에만 사용합니다 @main .
새 스크립트 또는 지침을 신뢰하기 전에 설치 전에 스킬 콘텐츠를 미리 확인하고 업데이트를 검토합니다.

원본 및 중점 참조는 다음을 참조하세요.

다음 단계

첫 번째 에이전트 만들기

더 자세히 살펴보기: