다크 모드
Studio 활용 가이드
Studio는 채팅, 에이전트, 워크플로우, MCP 도구를 조합해 업무를 처리하는 작업 공간입니다. 이 문서는 어떤 기능을 언제 사용하면 좋은지, 개인 작업에서 팀 공유로 확장할 때 무엇을 확인해야 하는지 안내합니다.
기능 선택 기준
| 해야 할 일 | 추천 기능 | 이유 |
|---|---|---|
| 한 번만 확인할 질문 | 채팅 | 가장 빠르게 모델을 선택하고 답변을 받을 수 있습니다. |
| 같은 역할과 응답 형식을 반복 사용 | 에이전트 | 역할, 지침, 도구 구성을 저장해 재사용할 수 있습니다. |
| 여러 단계를 항상 같은 순서로 실행 | 워크플로우 | 입력, 처리, 분기, 출력 단계를 노드로 고정할 수 있습니다. |
| 외부 시스템 조회나 작업 실행 | MCP 설정 | 외부 도구를 채팅, 에이전트, 워크플로우에서 호출할 수 있습니다. |
| 팀에 검증된 작업 방식을 배포 | 에이전트 + 워크플로우 | 역할은 에이전트에, 반복 절차는 워크플로우에 나누어 관리합니다. |
판단 기준
자연어 지시만으로 충분하면 채팅이나 에이전트를 사용하고, 입력/출력 구조와 실행 순서가 중요하면 워크플로우로 만드는 것이 좋습니다.
채팅에서 시작하기
새 업무를 자동화하기 전에는 채팅에서 먼저 검증하세요.
- 모델을 선택하고 실제 업무 질문을 입력합니다.
- 필요한 MCP 도구나 에이전트를
@mention으로 직접 호출합니다. - 원하는 결과가 나올 때까지 지시문, 출력 형식, 도구 사용 조건을 조정합니다.
- 같은 패턴이 반복되면 에이전트 또는 워크플로우로 옮깁니다.
채팅은 탐색과 검증에 적합합니다. 아직 절차가 고정되지 않았거나 결과 형식이 바뀔 가능성이 크다면 먼저 채팅으로 실험하세요.
에이전트로 옮기기
에이전트는 "누가 어떤 기준으로 답할지"를 저장하는 기능입니다.
| 에이전트로 만들기 좋은 경우 | 예시 |
|---|---|
| 역할이 명확함 | 코드 리뷰어, 고객 응대 도우미, 계약 검토자 |
| 응답 형식이 반복됨 | 요약, 근거, 리스크, 다음 조치 순서로 답변 |
| 특정 도구를 자주 사용함 | 정책 검색 도구, 이슈 생성 도구, 문서 조회 도구 |
| 팀에서 같은 기준을 공유해야 함 | 보안 검토 기준, 운영 보고서 양식 |
에이전트 지침에는 역할, 목표, 도구 사용 조건, 응답 형식, 금지 사항을 함께 적으세요. 도구가 연결된 에이전트는 공유 전에 민감 정보와 실행 권한을 반드시 확인합니다.
워크플로우로 고정하기
워크플로우는 "어떤 순서로 처리할지"를 고정하는 기능입니다.
| 워크플로우로 만들기 좋은 경우 | 예시 |
|---|---|
| 입력값이 정해져 있음 | 고객명, 문의 유형, 주문 번호 |
| 중간 단계가 여러 개임 | 검색, 분류, 요약, 외부 API 호출, 결과 작성 |
| 조건 분기가 필요함 | VIP 고객이면 별도 처리, 오류면 재시도 |
| 결과 형식이 엄격함 | JSON, 표, 티켓 생성 payload |
워크플로우는 먼저 Input과 Output을 정한 뒤 중간 노드를 배치하는 순서로 설계하세요. 실행 패널에서 노드별 결과를 확인하고, 게시 전에는 실제 채팅에서 @mention으로 호출해 최종 응답을 검증합니다.
MCP 도구 연결하기
MCP 도구는 Studio가 외부 시스템과 상호작용할 수 있게 해줍니다. 도구를 연결할 때는 "읽기 도구인지", "쓰기/삭제 같은 변경 작업을 하는지"를 먼저 구분하세요.
| 도구 유형 | 운영 기준 |
|---|---|
| 조회 도구 | 자동 모드에서 사용해도 비교적 안전하지만, 반환 데이터의 최신성과 권한 범위를 확인합니다. |
| 생성 도구 | 이슈 생성, 문서 생성처럼 외부 시스템에 결과가 남는 작업은 입력값 검증이 필요합니다. |
| 수정/삭제 도구 | 수동 승인 모드 또는 명시적 확인 절차를 권장합니다. |
| 인증이 필요한 도구 | OAuth 또는 토큰 만료 시 실패할 수 있으므로 도구 테스트로 상태를 확인합니다. |
도구 설명과 사용자 지정 지침은 AI의 도구 선택에 직접 영향을 줍니다. 비슷한 도구가 여러 개라면 사용 조건과 제한 사항을 구체적으로 적으세요.
팀 공유 전 체크리스트
| 항목 | 확인 내용 |
|---|---|
| 이름과 설명 | 다른 사용자가 언제 사용할지 바로 이해할 수 있나요? |
| 입력 조건 | 필요한 정보와 선택 정보가 구분되어 있나요? |
| 권한 | 공유 대상자가 연결된 도구와 워크플로우를 사용할 권한이 있나요? |
| 민감 정보 | API 키, 토큰, 비밀번호, 내부 URL이 지침이나 노드에 포함되지 않았나요? |
| 실패 처리 | 도구 오류, 검색 결과 없음, 필수 입력 누락 시 안내가 있나요? |
| 검증 | 대표 입력으로 최소 1회 이상 채팅에서 실행해 봤나요? |
운영 패턴
| 패턴 | 구성 |
|---|---|
| 팀 공통 답변 도우미 | 에이전트에 역할과 응답 형식을 저장하고, 필요한 MCP 조회 도구를 연결합니다. |
| 정기 보고서 초안 작성 | 워크플로우로 데이터 조회, 요약, 템플릿 출력을 구성하고 에이전트에서 호출합니다. |
| 고객 문의 분류 | 채팅에서 분류 기준을 검증한 뒤, 에이전트 지침 또는 워크플로우 Condition 노드로 고정합니다. |
| 외부 시스템 작업 | MCP 도구를 등록하고 상세 화면에서 테스트한 뒤, 수동 승인 모드로 채팅에서 사용합니다. |