SW_DEV Agent 사용 가이드
Agent는 지침과 모델, 도구, 스킬을 묶어 업무용 AI 에이전트를 만드는 App입니다. 만든 에이전트를 GenAI에 배포하면 Planet 멤버가 대화로 씁니다. API로 부를 수도 있습니다. 관리자가 Agent에서 에이전트를 만들어 두면 멤버는 상단의 GenAI에서 골라 쓰는 구조입니다.
화면에 나오는 Planet, 에이전트, 숫자는 모두 설명용 예시입니다.
한눈에 보기
| 메뉴 | 하는 일 |
|---|---|
| Overview | 실행 수, 사용자, 비용, 응답 시간 |
| Agents | 에이전트 만들기, 시험 대화, 배포 |
| Skills | 업무 절차 문서(스킬) 등록 |
| Usage | 사용 한도와 멤버별 사용량 |
| Inquire | 멤버가 관리자에게 보낸 문의 |
Agent 관리 화면은 처음에는 Owner와 Admin만 씁니다. Member는 GenAI에서 배포된 에이전트와 대화합니다.
1. 에이전트 만들기 (Agents)
에이전트 추가로 만든 뒤 편집 화면의 탭에서 하나씩 설정합니다. 오른쪽 시험 대화에서는 저장한 설정으로 바로 대화해 볼 수 있습니다.
| 탭 | 설정 |
|---|---|
| 기본 · 지침 | 이름과 설명, 에이전트가 따를 지침 |
| 모델 | Gateway에 등록한 LLM 모델이나 라우트 |
| 도구 | 코드 실행 샌드박스, 기억, Gateway에 등록한 HTTP API 도구 |
| MCP | Gateway에 연결한 MCP 서버 |
| 스킬 | 이 에이전트가 쓸 스킬 |
| 멤버 | 이 에이전트를 쓸 수 있는 멤버 |
| API | 외부에서 부르는 방법 |
지침에는 에이전트가 맡을 일과 답하는 방식을 적습니다. "회의록을 받으면 표로 정리하고 다음 주 계획을 따로 적는다"처럼 구체적일수록 결과가 고릅니다.
2. 도구와 스킬 붙이기
도구 탭에서 샌드박스(swdev_sandbox)를 켜면 에이전트가 격리된 환경에서 코드를 실행하고 Word · Excel · PowerPoint · PDF 파일을 만들어 대화에 첨부합니다. 도구마다 실행 방식도 고릅니다. 기본값은 조회 도구만 바로 실행하고 나머지는 사용자 승인을 받는 방식입니다. 항상 바로 실행하거나 항상 승인을 받도록 바꿀 수도 있습니다.
스킬은 업무 절차를 적은 문서입니다. Skills 메뉴에서 Report 문서, md 파일, zip 묶음, GitHub 폴더로 등록하고 에이전트의 스킬 탭에서 연결합니다. 에이전트는 일을 시작할 때 맞는 스킬을 찾아 읽고 그 절차를 따릅니다.
3. 배포하고 GenAI에서 쓰기
설정을 마치면 편집 화면 위쪽의 GenAI로 배포를 누릅니다. 배포한 뒤에 설정을 고치면 다시 배포해야 멤버에게 반영됩니다. 잠시 내리려면 배포 중지를 누르는데, 이때 진행하던 대화는 읽기만 할 수 있습니다.
멤버는 상단의 GenAI에서 에이전트를 골라 대화합니다.
- 파일을 첨부하면 에이전트가 읽고 작업에 씁니다. 에이전트가 만든 파일은 대화에서 바로 내려받습니다.
- 여러 Planet에 속해 있으면 모든 Planet의 에이전트와 대화가 한 화면에 모입니다.
- 왼쪽 아래 Setting에서는 모든 대화에 넣을 개인 지침과 에이전트가 기억한 내용을 관리합니다.
4. 사용 한도와 현황 (Usage · Overview · Inquire)
Usage에서는 사용 한도를 정합니다. 한도가 초기화되는 주기(일 · 주 · 월)와 멤버 한 명이 쓸 수 있는 크레딧을 정합니다. 특정 멤버에게만 다른 한도를 줄 수도 있습니다. 아래 표에는 멤버별로 이번 기간에 쓴 크레딧이 나옵니다.
한도에 닿은 멤버는 GenAI에서 관리자에게 문의를 남길 수 있습니다. 문의는 Inquire에 모입니다.
Overview에는 실행 수와 사용자 수, 비용, 평균 응답 시간, 샌드박스 대기 현황이 나옵니다. 대화 내용은 관리자에게도 보이지 않습니다.
5. API로 부르기
배포한 에이전트는 외부 프로그램에서도 실행할 수 있습니다. Access의 API 메뉴에서 범위에 Agent를 넣어 키를 발급한 뒤 에이전트 편집의 API 탭에 있는 예시를 그대로 쓰면 됩니다.
curl -X POST https://swdev.co.kr/api/agent/v1/agents/{에이전트 id}/runs \
-H "Authorization: Bearer $SWDEV_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input": "이번 주 회의록을 세 줄로 요약해 주세요", "wait": 30}'
wait로 정한 초 안에 끝나면 답이 바로 옵니다. 더 걸리면 실행 id로 나중에 결과를 조회합니다. API로 실행할 때는 승인이 필요한 도구와 기억을 쓰지 않습니다. 자세한 내용은 화면 맨 아래 Docs의 Agent 문서에 있습니다.
댓글
등록된 댓글이 없습니다.