콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

Microsoft Agent Framework 선언형 에이전트 가져오기 — 에이전트와 MCP 서버

OpenAI 모델을 사용하고 MCP 서버를 통해 문서를 검색하는 에이전트 하나로 이루어진 Microsoft Agent Framework 선언형 에이전트를 aggrega import로 Aggrega 파일 초안으로 작성하고, 애플리케이션의 이미지는 답변 파일에서 한 번만 지정한 뒤 Docker Compose용으로 빌드합니다.

Microsoft Agent Framework 선언형 에이전트 가져오기에서는 명령, 그 명령이 묻는 내용, 작성하는 파일과 각 줄이 있는 이유, 빌드, 그리고 실행 중인 에이전트를 단계별로 안내합니다. 이 폴더에는 그 안내의 각 단계가 들어 있습니다:

폴더 또는 파일내용
source/선언형 에이전트 support-agent.yaml, 폴더를 워크스페이스로 만드는 .aggrega-config.yaml, 그리고 어떤 선언형 에이전트도 담고 있지 않은 값을 담은 import-answers.yaml: 애플리케이션의 이미지, 그리고 Kubernetes용 빌드가 OpenAI 키를 읽어 오는 Kubernetes Secret의 이름
draft/aggrega import support-agent.yaml --target compose 명령이 작성한 파일(변경 없음, release.lock 포함)과 출력한 내용: 표준 출력은 stdout.txt, 표준 오류는 import.txt

선언형 에이전트는 이 예제를 위해 작성되었습니다. 이를 로드하는 애플리케이션 코드는 예제에 포함되지 않습니다. 가져오기는 그 코드를 읽지 않으며, 애플리케이션이 실행되는 이미지는 Release가 지정합니다.

문서 저장소의 체크아웃에서 check.sh는 가져오기를 다시 실행하고, 작성하고 출력한 내용을 draft/와 비교하고, 안내에서 인용하는 블록을 이 파일들과 비교한 뒤, 가져오기가 작성한 내용을 검증하고 빌드합니다. 표준 라이브러리 카탈로그(얻는 곳)가 이 저장소 옆에 체크아웃되어 있거나, 그 디렉터리가 AGGREGA_CATALOG_DIRS에 지정되어 있어야 합니다.

예제 생성하기

이 예제의 가져오기는 아래 명령으로 실행하거나 AI 어시스턴트에게 대신 실행하게 할 수 있습니다.

예제 이름을 딴 새 폴더에 예제를 씁니다:

Terminal window
aggrega scaffold --example import-agent-framework

그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:

Terminal window
cd import-agent-framework

빌드

가져오기는 선언형 에이전트 옆의 source/에 Aggrega 파일 초안을 작성합니다. 프로젝트를 표준 라이브러리 카탈로그와 대조하는데, 이 카탈로그는 워크스페이스의 기본 레지스트리가 서명된 스냅숏으로 게시합니다. 첫 번째 가져오기가 이를 가져와 검증하고, 워크스페이스의 콘텐츠 캐시에 보관하며, 초안 옆에 작성하는 기록에서 다이제스트로 이를 지정합니다. 자체 카탈로그 폴더를 지정하는 워크스페이스는 — AGGREGA_CATALOG_DIRS에서든 workspace.catalog_dirs 아래에서든 — 대신 그 폴더들을 기준으로 가져옵니다. 가져오기는 import-answers.yaml에서 이미지를 읽은 다음, 초안으로 작성된 Release가 의존하는 것을 풀하므로 바로 빌드할 수 있습니다:

Terminal window
cd source
aggrega import support-agent.yaml --target compose
aggrega build --release release.yaml

예제가 지정하는 이미지는 프로젝트에서 빌드하는 이미지를 나타냅니다. 이미지 빌드와 스택 실행은 위에 링크된 안내에 있습니다.

AI 어시스턴트 사용

Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.

Aggrega 도구만 사용하고, 폴더는 직접 만들지 마십시오. 작업 영역 폴더에 아직 `import-agent-framework` 폴더가 없으면 `example`을 `import-agent-framework`로 설정하고 `dir`은 지정하지 않은 채 `scaffold` 도구를 한 번 호출하십시오. 이 도구는 예제를 새 `import-agent-framework` 폴더에 쓰며, 그 안의 `source` 폴더에 이 예제가 가져오는 내용이 들어 있습니다. 그런 다음 `workspace_root`를 `import-agent-framework/source`로, `source`를 `support-agent.yaml`로, `target`을 `compose`로 설정하여 `import` 도구를 호출하십시오. 이 도구는 필요한 답변을 `support-agent.yaml` 옆의 `import-answers.yaml`에서 읽고, 초안을 `import-agent-framework/source`에 쓰며, 초안에 필요한 것을 풀합니다. 그런 다음 `workspace_root`를 `import-agent-framework/source`로, `release`를 `release.yaml`로 설정하여 `validate` 도구를 호출하고, `workspace_root`를 `import-agent-framework/source`로, `release`를 `release.yaml`로, `write`를 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 쓴 파일을 알려 주십시오. 파일은 `import-agent-framework/source/dist/` 아래에 있습니다.

테스트하기

연습 가이드에서 실행하는 방식대로 스택을 실행하면 요청 하나가 에이전트에 도달합니다. 아래 경로는 연습 가이드 자체 프로그램의 것으로, 포트 8000의 작은 HTTP 서버입니다. 직접 만든 프로그램은 자체 경로를 정합니다. Release는 에이전트를 127.0.0.1:8000에 게시하므로 요청은 사용자의 머신에서 보냅니다:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \
-d '{"question": "In one short sentence: what is Azure Container Apps?"}'
{"error": "the agent failed: ChatClientException: (\"<class 'agent_framework_openai._chat_client.OpenAIChatClient'> service failed to complete the prompt: Error code: 401 - Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the same error repeated as the exception it wraps]"}

이 실행의 키는 자리 표시자였으므로 응답은 그 키에 대한 OpenAI의 거부입니다. Kubernetes에서는 Service가 없는 Deployment로 로컬 포트를 전달하고, 다른 터미널에서 같은 요청을 보내십시오:

Terminal window
kubectl port-forward deploy/supportagent 8000:8000
Terminal window
curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \
-d '{"question": "In one short sentence: what is Azure Container Apps?"}'

응답은 같습니다.