🚗 A. Business Scenario
Declarative Agent야, 박차장님을 구해줘!
무한상사 마케팅팀의 박차장, 하루는 유부장님으로부터 다음과 같은 말을 듣는데요.
유부장: “박차장, 우리 홈페이지의 실시간 상품목록을 하루마다 불러와서 인사이트를 뽑아내고 싶어. 그렇게 해줄 수 있겠나?”
박차장: “그럼 IT팀이 실시간 상품목록을 하루마다 보내주는 건가요?”
유부장: “아니, API 정의서 줄 테니 알아서 해보게.”
사실 이 작업은 굉장히 간단한데요! API를 활용하면 쉽게 자동화할 수 있답니다. 그럼 프로젝트 목표부터 살펴볼까요?
</br> </br>
🎯 B. Objective
이번 프로젝트의 목표는 상품 API를 활용해 사내 시스템에 접근하여 제품 홈페이지에 올라가는 상품목록을 가져와 분석하는 거예요!
구체적인 목표는 다음과 같아요:
✅ 상품 API를 Declarative 에이전트에 연결해, 사내 시스템에서 상품 정보를 에이전트에 불러오기
✅ 불러온 상품정보를 프롬프트를 사용해 분석해보기
</br> </br>
💡 C. API란 뭘까?
API(Application Programming Interface)는 프로그램들이 서로 대화할 수 있게 해주는 중간 통신자예요.
예를 들어, 마치 음식점에서 메뉴를 보고 주문을 하는 것처럼,
우리는 API를 통해 필요한 데이터를 요청하고, API가 해당 데이터를 전달해주는 방식이에요.
| 비유 | 실제 상황 |
|---|---|
| 메뉴를 고른다 | API에 요청을 보낸다 (GET 요청) |
| 주문을 받는다 | API가 데이터를 반환한다 (JSON 형식) |
| 요리가 나온다 | 우리가 원하는 상품 정보가 제공된다 |
쉽죠? 그럼 우리가 사용할 API를 자세히 볼게요!
</br> </br>
🛠️ D. 우리가 활용할 시스템
이번 프로젝트를 위해 테스트용 이커머스 API를 사용해볼 거예요.
- API 사이트: DummyJSON
- 사용 API: Get All Product API
| 항목 | 설명 |
|---|---|
| Method | GET |
| Endpoint | https://dummyjson.com/products |
해당 Endpoint에 GET 요청을 보내면 상품 정보를 가져올 수 있어요!
직접 테스트해보고 싶다면, 브라우저 주소창에 Endpoint를 입력하면 상품 데이터를 확인할 수 있답니다.
</br>
🚀 E. 에이전트를 생성해보자
2강에서 배운 것처럼 Declarative Agent를 생성해볼게요!
반드시 Copilot for M365 내에서 생성해야 한다는 점을 잊지 말아요.
🎯 설정 방법
- Name: Product Analyze Agent
- Description: This Agent gets product information from the website and analyzes those.
💬 Instructions
### 시스템 프롬프트: 쇼핑몰 제품 정보 분석 에이전트
---
**역할:**
당신은 쇼핑몰 API에서 제품 데이터를 수집하고, 이를 사실에 근거하여 정확하게 분석하는 AI 에이전트입니다.
---
### 기능
#### 1. 데이터 수집
- RESTful API를 통해 쇼핑몰의 제품 정보를 가져옵니다.
- 인증, 페이징, 레이트 리밋을 자동으로 처리합니다.
#### 2. 정확한 분석
- 수집된 데이터를 기반으로 가격, 판매량, 리뷰 등 주요 지표를 분석합니다.
- 주관적 해석을 배제하고, 오직 사실에 근거한 결과만 제공합니다.
#### 3. 결과 제공
- 분석 결과를 **간결하고 명확한 텍스트 형식**으로 전달합니다.
- 추가 정보가 필요할 경우 데이터를 기반으로만 응답합니다.
---
### 예시 요청
- `"제품들을 불러오고 이중에 얼굴과 관련된 제품이 몇 개 인지 알려줘"`
- `"불러온 제품들 중 어떤 제품들이 평점이 높은 경향이 있니"`
- `"특정 제품의 리뷰 요약해줘"`
📢 설정 팁
- 대화창에 “Skip to Configure” 버튼이 나오면 눌러서 넘어가주세요!
- 이후 “Create” 버튼을 눌러주면 에이전트 생성 끝!
</br> </br>
💡 F. 오늘의 결론
오늘은 다음과 같은 3가지 내용을 배워봤어요!
- API의 개념과 역할을 이해했어요.
- 테스트용 이커머스 API를 통해 데이터를 가져오는 방법을 익혔어요.
- Declarative Agent를 생성하고 API 연결 방법을 실습했어요.
다음 시간에는 Power Automate Flow를 이용해 API를 호출하는 Flow를 만들어 볼게요!
기대되죠? 😊