Visual Studio Code에서 Foundry 에이전트 서비스 작업(미리 보기)

Visual Studio Code용 Microsoft Foundry 확장을 시작한 후 Foundry 에이전트 서비스를 사용하여 에이전트를 빌드합니다. 에이전트는 다음과 같은 마이크로 서비스입니다.

• 학습 데이터를 사용하거나 RAG(검색 보강 생성)를 사용하여 다른 원본을 검색하여 질문에 답변합니다.
• 특정 작업을 수행합니다.
• 전체 워크플로를 자동화합니다.

에이전트는 AI 모델을 도구와 결합하여 데이터에 액세스하고 상호 작용합니다.

Foundry 개발자는 VS Code(Visual Studio Code)의 친숙한 환경에서 에이전트를 개발, 테스트 및 배포하여 생산성을 유지할 수 있습니다.

디자이너 보기 내에서 Azure AI 에이전트 만들기 및 편집

다음 단계에 따라 Azure AI 에이전트를 만듭니다.

1. Azure 리소스에 로그인합니다.

2. 기본 프로젝트를 설정합니다.

3. 에이전트와 함께 사용할 모델을 배포합니다.

4. Foundry 확장 보기에서 리소스 부분을 찾습니다.

5. + 하위 섹션 옆에 있는 더하기() 아이콘을 선택하여 새 AI 에이전트를 만듭니다.

   

디자이너에서 에이전트와 상호 작용합니다

저장 위치를 선택하면 AI 에이전트를 편집할 수 있도록 에이전트 .yaml 파일과 디자이너 보기가 모두 열립니다. 에이전트 디자이너에서 다음 작업을 수행합니다.

1. 프롬프트에서 에이전트의 이름을 입력합니다.

2. 드롭다운 목록에서 모델 배포의 이름을 선택합니다. 배포 이름은 기존 모델을 배포할 때 선택한 이름입니다.

3. 확장은 ID 값을 생성합니다. 다음 필드를 구성하세요.

   • 에이전트에 대한 설명을 추가합니다.
   • 시스템 지침을 설정합니다.
   • 에이전트 사용을 위한 도구를 구성합니다.

   

4. .yaml 파일을 저장하려면 VS Code 메뉴 모음에서 파일>저장 을 선택합니다.

Azure AI 에이전트의 .yaml 정의 살펴보기

AI 에이전트의 .yaml 파일이 디자이너가 작업을 수행하고 있을 때 동시에 열렸습니다. 이 파일에는 에이전트에 대한 세부 정보 및 설정 정보가 포함되어 있습니다. 다음 .yaml 파일 예제와 유사합니다.

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: my-agent
description: Description of the agent
id: ''
metadata:
  authors:
    - author1
    - author2
  tags:
    - tag1
    - tag2
model:
  id: 'gpt-4o-1'
  options:
    temperature: 1
    top_p: 1
instructions: Instructions for the agent
tools: []

Azure AI 에이전트에 도구 추가

에이전트 서비스에는 데이터 원본과 상호 작용하는 데 사용할 수 있는 다음과 같은 도구 집합이 있습니다. 이러한 도구는 Visual Studio Code용 Foundry 확장에서 사용할 수 있습니다.

• Bing 검색을 통해 기초를 다지기
• 파일 검색
• 코드 해석기
• OpenAPI 지정된 도구
• MCP(모델 컨텍스트 프로토콜)

MCP 도구 사용에 대한 자세한 내용은 Visual Studio Code의 에이전트 서비스 및 MCP 서버 도구 작업(미리 보기)을 참조하세요.

AI 에이전트에 도구 추가

1. 디자이너의 도구 섹션 오른쪽 위 모서리에서 도구 추가를 선택합니다. 드롭다운 목록에서 추가할 도구를 선택합니다.

   

2. 디자이너는 다음 이미지와 같이 도구를 구성하는 데 적합한 창을 표시합니다.

   • Bing 검색을 사용하여 기초 다지기

     

   • 파일 검색:

     

   • 코드 인터프리터:

     

   • OpenAPI 3.0 지정된 도구:

     

3. 필요한 정보를 입력한 후 만들기 및 연결, 업로드 및 저장 또는 도구 만들기를 선택합니다. 단추는 창에 따라 달라집니다.

도구를 추가할 때 필요한 새 자산을 추가할 수도 있습니다. 예를 들어 파일 검색 도구를 추가하는 경우 기존 벡터 저장소 자산을 사용하거나 벡터 저장소에 대한 새 자산을 만들어 업로드된 파일을 호스트할 수 있습니다.

Foundry에서 Azure AI 에이전트 만들기

다음 단계를 사용하여 Foundry에서 직접 에이전트를 만듭니다.

1. 디자이너에서 Foundry에서 에이전트 만들기 단추를 선택합니다.

   

2. VS Code에서 Azure 리소스 보기를 새로 고칩니다. 배포된 에이전트가 에이전트 하위 섹션에 나타납니다.

   

배포된 AI 에이전트의 세부 정보 보기

배포된 에이전트를 선택하면 에이전트 기본 설정 창이 보기 전용 모드로 열립니다. 당신은 할 수 있어요:

• 에이전트 편집 단추를 선택하여 에이전트 디자이너와 편집할 에이전트의 .yaml 정의를 봅니다.
• 코드 파일 열기 단추를 선택하여 에이전트를 사용하는 샘플 코드 파일을 만듭니다.
• 플레이그라운드 열기 단추를 선택하여 에이전트 플레이그라운드를 엽니다.

배포된 AI 에이전트 편집 및 업데이트

1. 에이전트 기본 설정 창에서 에이전트 편집 단추를 선택합니다. 에이전트 디자이너가 에이전트의 .yaml 파일을 열면서 시작합니다.

2. 모델, 도구 및 지침과 같은 에이전트의 구성을 편집합니다.

3. 편집을 마친 후 Foundry에서 에이전트 업데이트 단추를 선택하여 변경 내용을 저장합니다.

샘플 코드 파일 만들기

1. 배포된 에이전트를 마우스 오른쪽 단추로 클릭한 다음 코드 파일 열기 옵션을 선택합니다. 또는 에이전트 기본 설정 창에서 코드 파일 열기 단추를 선택합니다.

   

2. 원하는 SDK 선택 드롭다운 목록에서 에이전트 코드 파일에 대한 기본 설정 SDK를 선택한 다음 Enter 키를 선택합니다.

   

3. 언어 선택 드롭다운 목록에서 에이전트 코드 파일에 대한 기본 설정 언어를 선택한 다음 Enter 키를 선택합니다.

   

4. 인증 방법 선택 드롭다운 목록에서 에이전트 코드 파일에 대한 기본 인증 방법을 선택한 다음 Enter 키를 선택합니다.

   

샘플 코드 파일 살펴보기

다음 Python 샘플 코드 파일은 Foundry Projects API를 통해 에이전트와 상호 작용하는 기본 호출을 보여 줍니다.

에이전트 플레이그라운드를 사용하여 에이전트와 상호 작용

1. 배포된 에이전트를 마우스 오른쪽 단추로 클릭한 다음 플레이그라운드 열기 옵션을 선택합니다.

   또는 도구 하위 섹션에서 에이전트 플레이그라운드 링크를 선택한 다음 드롭다운 목록에서 에이전트를 선택합니다.

   이 단계에서는 에이전트 플레이그라운드 창을 열고 메시지를 보낼 수 있도록 에이전트를 사용하여 스레드를 시작합니다.

   

2. 프롬프트를 입력하고 출력을 봅니다.

   이 예제에서는 Bing Grounding을 사용하여 정보를 웹 검색하는 방법을 보여 줍니다. 에이전트는 에이전트 디자이너에서 구성한 모델 및 도구를 사용합니다. 정보의 원본은 에이전트 주석 섹션에 나타납니다.

   

스레드 탐색

스레드 하위 섹션에는 에이전트를 사용하여 실행하는 동안 생성된 스레드가 표시됩니다. Azure 리소스 보기에서 스레드 하위 섹션을 확장하여 목록을 봅니다.

스레드를 탐색할 때 다음 용어를 염두에 두세요.

• 스레드는 에이전트와 사용자 간의 대화 세션입니다. 스레드는 메시지를 저장하며, 자동으로 잘라서 콘텐츠를 모델의 컨텍스트에 맞춥니다.

• 메시지는 에이전트와 사용자 간의 단일 상호 작용입니다. 메시지에는 텍스트, 이미지 및 기타 파일이 포함될 수 있습니다. 메시지는 스레드의 목록으로 저장됩니다.

• 실행은 에이전트의 단일 실행입니다. 각 실행에는 여러 스레드가 있을 수 있으며 각 스레드에는 여러 메시지가 있을 수 있습니다. 에이전트는 해당 구성 및 스레드 메시지를 사용하여 모델 및 도구를 호출하여 작업을 수행합니다. 실행의 일부로 에이전트는 스레드에 메시지를 추가합니다.

스레드 세부 정보 보기

스레드 세부 정보 창을 보려면 스레드를 선택합니다.

실행 세부 정보 보기

JSON 파일에서 실행 정보를 보려면 스레드 세부 정보 창에서 실행 정보 보기 단추를 선택합니다. 다음 스크린샷은 예제 JSON 파일을 보여줍니다.

자원을 정리하세요

이 문서에서 만든 Azure 리소스는 Azure 구독에 청구됩니다. 앞으로 이러한 리소스가 필요하지 않을 것으로 예상되는 경우 추가 요금이 발생하지 않도록 삭제합니다.

에이전트 삭제

1. VS Code에서 Azure 리소스 보기를 새로 고칩니다. 에이전트 하위 섹션을 확장하여 배포된 에이전트 목록을 표시합니다.
2. 삭제할 배포된 에이전트를 마우스 오른쪽 단추로 클릭한 다음 삭제를 선택합니다.

모델 삭제

1. VS Code에서 Azure 리소스 보기를 새로 고칩니다. 모델 하위 섹션을 확장하여 배포된 모델 목록을 표시합니다.

2. 삭제할 배포된 모델을 마우스 오른쪽 단추로 클릭한 다음 삭제를 선택합니다.

   

연결된 도구 삭제

1. Azure Portal을 엽니다.

2. 도구가 포함된 Azure 리소스 그룹을 선택합니다.

3. 삭제 단추를 선택합니다.

관련 콘텐츠

• 파일 검색 또는 코드 인터프리터와 같은 Azure AI 에이전트에서 사용할 수 있는 도구에 대해 알아봅니다.