OneAgent는 질의응답에 머무르지 않고 실제 업무를 직접 실행하고 완결하는 Actionable AI 에이전트입니다. 대화로 업무를 요청하면 에이전트가 스스로 계획을 세우고, 브라우저·파일·외부 도구를 직접 조작해 결과물까지 만들어냅니다.
OneAgent로 할 수 있는 일
일반적인 챗봇은 "어떻게 하는지" 알려주지만, OneAgent는 그 일을 대신 수행합니다. 예를 들어:
"메일함에서 오늘 안 읽은 메일을 요약해줘" → 직접 로그인해 메일을 읽고 요약 보고서를 생성
"이 사이트에서 매주 투입률을 신청해줘" → 브라우저를 조작해 폼을 채우고 제출
"이 데이터로 HTML 대시보드 만들어줘" → 코드를 작성하고 아티팩트로 미리보기까지 제공
"이번 분기 실적으로 발표자료 10장 만들어줘" → 슬라이드를 한 장씩 디자인해 .pptx 파일로 저장
발표자료(PPT) 만들기
"PPT 만들어줘"처럼 한 줄로 요청해도 됩니다. 에이전트가 색상·글자 크기 등 디자인 기준을 먼저 정하고 슬라이드를 한 장씩 만든 뒤, 전체 구성을 보여주고 .pptx 파일로 변환합니다. 특정 장만 고쳐 달라고 이어서 요청하면 그 슬라이드만 다시 만들어 파일을 갱신합니다.
세 가지 실행 채널
OneAgent는 다음 세 가지 방식으로 PC 안팎의 업무를 직접 수행합니다.
채널
설명
Browser-Use
웹 브라우저 UI를 직접 클릭·입력·제어합니다. 로그인·예약·조회 등 여러 단계로 이어지는 온라인 업무를 자동 수행합니다.
Computer-Use
파일 시스템 조작과 네이티브 앱 자동화를 담당합니다. 폴더·문서·사내 프로그램까지 PC 전체로 활동 영역을 넓힙니다.
MCP 연계
플러그인(MCP) 기반으로 내부·외부 API/도구를 연결합니다. 필요한 도구만 켜고 끌 수 있습니다.
핵심 개념
Actionable AI — 답변 생성에 그치지 않고, 도구를 직접 조작해 업무를 실행·완결하고 결과물(보고서·파일·제출 등)을 만들어내는 AI를 뜻합니다.
실제로 어떻게 동작하나요?
업무를 요청하면 OneAgent는 사람이 화면을 보며 일하듯 "생각(Thought) → 도구 실행 → 결과 확인"을 반복합니다. 아래는 사내 시스템에 브라우저로 접속해 프로젝트를 선택하는 과정의 실행 로그입니다.
진행한 대화를 HTML 파일로 저장하거나, 공유 링크를 만들어 다른 사람에게 전달할 수 있습니다. 작업공간에서 만들어진 파일도 지정한 사람에게 바로 보낼 수 있습니다.
상단 헤더의 공유(Share this conversation) 아이콘을 누르면 대화 공유 다이얼로그가 열립니다. 공유에는 지금까지의 모든 메시지와 도구 결과가 포함됩니다.
1. 공유 방법 선택
대화 공유 — HTML 다운로드 / 링크 복사 중 선택
HTML 다운로드 — 대화를 HTML 파일 하나로 저장합니다. 인터넷 연결 없이도 열어볼 수 있습니다.
링크 복사 — 공유 링크를 생성해 복사합니다. 링크로 접근하면 대화를 웹에서 바로 볼 수 있습니다.
2. HTML 다운로드
HTML 파일 다운로드 완료 — 모든 메시지·도구 결과 포함
HTML 다운로드를 선택하면 대화가 즉시 HTML 파일로 저장되고 완료 안내가 표시됩니다. 저장된 파일에는 이 대화의 모든 메시지와 도구 결과가 담겨 있습니다.
3. 공유 링크 생성
링크 복사 — 공개 범위(비공개/대상 지정/공개)와 만료 기간 설정 후 링크 생성
링크 복사를 선택하면 공개 범위와 만료 기간을 정한 뒤 공유 링크 생성을 누릅니다.
비공개 — 본인만 접근할 수 있습니다.
대상 지정 — 지정한 사용자만 볼 수 있습니다. 아래 검색창에 이름이나 이메일을 두 글자 이상 입력하면 후보가 나타나고, 고른 사람이 칩으로 추가됩니다. 칩의 ×로 다시 뺄 수 있고, 한 명도 지정하지 않으면 생성 버튼이 눌리지 않습니다.
공개 액세스 — 링크가 있는 모든 사람이 볼 수 있습니다.
만료 기간 — 1일 · 7일(기본) · 14일 · 30일 중 선택합니다. 최대 30일까지 설정할 수 있습니다.
수신자 검색 범위
수신자 검색(대상 지정·파일 공유 공통)은 같은 조직(회사 메일 도메인) 사용자만 대상으로 하며, 검색창에 안내 문구가 함께 표시됩니다. 조건에 맞는 사람이 없으면 "검색 결과가 없습니다", 네트워크 문제 등으로 검색에 실패하면 "일시적으로 검색할 수 없습니다" 안내가 구분되어 표시됩니다.
📷 스크린샷 갱신 필요 — 공개 범위에 대상 지정 항목과 수신자 검색창이 추가되어 기존 화면과 다릅니다.
4. 파일 공유
대화 전체가 아니라 결과물 파일 하나만 특정 사람에게 보낼 수도 있습니다. 우측 작업공간에서 파일을 연 뒤, 패널 헤더의 파일 액션 버튼(⬇)을 눌러 공유를 선택합니다.
수신자 지정 — 대화 공유와 같은 방식으로 이름·이메일을 검색해 받는 사람을 고릅니다.
만료 기간 선택 — 링크와 동일하게 최대 30일까지 정할 수 있습니다.
공유 — 파일이 업로드되고, 받는 사람의 받은 파일 목록에 나타납니다.
파일 크기 제한
한 번에 공유할 수 있는 파일은 20MB까지입니다. 넘으면 "20MB 를 초과하는 파일은 공유할 수 없습니다"라는 안내와 함께 현재 크기가 표시됩니다.
📷 스크린샷 갱신 필요 — 파일 액션 메뉴의 공유 항목과 파일 공유 모달
5. 공유한 것·받은 것 관리
지금까지 주고받은 내역은 웹에서 한곳에 모아 볼 수 있습니다. oneagent.genon.ai 에 로그인한 뒤 프로필 화면 좌측의 채팅 이력 공유를 누르면 네 개 영역이 차례로 표시됩니다.
영역
내용
공유한 파일
특정 사용자에게 보낸 파일을 관리합니다.
받은 파일
다른 사용자가 나에게 보낸 파일입니다.
내가 공유한 대화
만들어 둔 공유 링크의 공개 범위·만료를 확인하고 삭제할 수 있습니다.
받은 대화
다른 사용자가 나에게 지정해 공유한 대화입니다.
📷 스크린샷 갱신 필요 — 웹 프로필의 채팅 이력 공유 4섹션 화면
개인정보 유의
공유 시점까지의 메시지만 포함됩니다. 허가 없이 개인정보나 제3자 콘텐츠를 공유하지 마세요.
루틴은 자주 하는 업무 절차를 저장해 한 번의 실행으로 재사용하는 프롬프트 가이드입니다. 입력 변수를 받아 매번 다른 값으로 실행할 수 있습니다.
루틴 라이브러리 — 검색·필터·기본 제공/커스텀
구성 요소
검색 / 필터 — 이름·설명·내용 검색 + 전체 / 기본 제공 / 커스텀 탭
기본 제공 루틴(읽기 전용) — 예: "안 읽은 메일 읽기(Naver)". 단계가 정의되어 있고 미리보기(👁)·본문 클립보드 복사 가능
사용자 추가 루틴(커스텀) — 예: "RMS 전날 투입률 신청 v3". 미리보기·본문 클립보드 복사·편집(✏)·삭제(🗑). 카드에 생성일(YYYY-MM-DD)이 함께 표시됩니다(예전에 만들어져 생성일 정보가 없는 루틴은 표시되지 않습니다)
입력 변수 — 루틴은 {{입력 변수}}를 받아 매번 다른 값으로 실행됩니다
우상단 +를 누르면 곧바로 루틴 빌더 캔버스가 열려 새 루틴을 만들 수 있습니다. 옆의 루틴빌더 아이콘(사이드바의 루틴 빌더 아이콘과 동일한 모양)을 누르면 이미 루틴 빌더로 만들어 둔 루틴을 골라 이 목록으로 가져올 수 있습니다.
이름 중복 방지
이미 사용 중인 이름(기본 제공 루틴 포함)으로 저장하면 자동으로 _1, _2처럼 번호가 붙어 저장됩니다. 같은 루틴을 다시 저장할 때는 번호가 붙지 않고 원래 이름이 그대로 유지됩니다.
직접 만든 루틴은 계정에 저장됩니다
내가 만든 루틴과 프롬프트 스타일은 계정에 함께 저장됩니다. 앱을 다시 설치하거나 다른 PC에서 같은 계정으로 로그인해도 그대로 따라옵니다. 인터넷이 잠시 끊긴 동안 만든 내용은 PC에 먼저 저장됐다가 연결이 돌아오면 자동으로 반영됩니다.
웹에서도 확인·수정할 수 있습니다
oneagent.genon.ai 에 로그인해 프로필 화면의 내 루틴·스타일 탭을 열면, 앱에서 만든 루틴과 프롬프트 스타일을 앱 없이도 보고 수정할 수 있습니다.
루틴 미리보기 — 무엇이 들어 있나
각 루틴의 미리보기(👁)를 누르면 그 루틴이 실제로 어떤 단계로 동작하는지 확인할 수 있습니다.
기본 제공 루틴 "안읽은 메일 읽기(Naver)"의 미리보기
미리보기는 세 부분으로 구성됩니다.
실행 절차 — 루틴이 수행하는 단계 목록. 예를 들어 위 루틴은 mail.naver.com 이동 → 화면 요소 분석 → 필터에서 "안읽은 메일" 선택 → 안 읽은 메일 모두 읽기 → 각 메일의 핵심 내용 요약·보고 순서로 동작합니다(안읽은 메일이 없으면 그 사실만 보고하고 종료).
필요한 입력 정보 — 루틴이 실행 시 받는 입력 변수. 변수가 없으면 "등록된 입력 정보 가이드가 없습니다."로 표시됩니다.
후속 루틴 — 이 루틴이 끝난 뒤 자동으로 이어 실행할 루틴을 연결할 수 있습니다.
입력 변수
커스텀 루틴은 {{변수}} 형태로 입력 변수를 정의할 수 있어, 매번 다른 값(날짜·대상·금액 등)으로 같은 절차를 재실행할 수 있습니다.
루틴 실행 — 입력값 설정
입력 항목이 있는 루틴을 실행하면 루틴 입력값 설정 창이 먼저 열립니다. 채울 항목이 하나라도 있으면(필수든 선택이든) 이 창이 열리고, 채울 것이 전혀 없는 루틴은 곧바로 실행됩니다.
루틴 입력값 설정 — 필수 입력 요소 · 선택 입력 요소, 항목 옆 도움말(?)
필수 입력 요소 / 선택 입력 요소 — 반드시 채워야 하는 항목과 비워 둘 수 있는 항목이 나뉘어 표시됩니다. 적용을 누르면 값이 반영되어 루틴이 실행됩니다.
항목별 도움말 — 항목 이름 옆의 도움말 버튼(?)을 누르면 어떤 값을 적어야 하는지 설명과 예시가 나타납니다.
예시 캡처 — 도움말에 화면 캡처가 함께 등록돼 있으면, 어느 화면의 어느 자리를 보고 적으면 되는지 그림으로 확인할 수 있습니다.
선택 해제 — 여러 항목 중 하나를 고르는 칸은 고른 항목을 다시 누르거나 선택 해제를 눌러 비울 수 있습니다. 반드시 골라야 하는 필수 항목은 해제되지 않습니다.
미리 채워짐 — 요청 내용과 개인 메모리에 저장된 정보를 참고해 일부 칸이 미리 채워진 채로 열릴 수 있습니다. 값이 맞는지 확인하고 필요하면 고쳐 주세요.
텍스트 루틴을 루틴빌더로 전환하기
단계가 텍스트로만 적힌 루틴(기본 제공 루틴 포함)은 루틴 빌더 그래프로 전환해 분기·반복·조건을 시각적으로 편집할 수 있습니다. 미리보기(👁) 모달 하단에 안내 배너가 보이면 전환할 수 있습니다. 이미 루틴 빌더로 만들어진 루틴에는 이 배너가 나타나지 않습니다.
📷 스크린샷 갱신 필요 — 미리보기 모달 하단의 "루틴빌더로 전환" 배너
[루틴빌더로 전환]을 누르면 실행 절차가 자동으로 입력된 채 루틴 빌더가 열리고, 그래프 생성이 한 번 자동으로 실행됩니다.
생성이 중단되면
그래프 생성이 오래 걸리거나 연결이 끊기면 "오래 걸려 중단되었습니다"(다시 시도 안내) 또는 "연결이 끊겨 중단되었습니다"처럼 원인을 구분한 안내가 표시됩니다. 안내에 따라 다시 시도하세요.
전환 후 원본 텍스트 루틴 처리
전환 화면에서 처음 저장 또는 등록을 누르는 순간, 원본 텍스트 루틴을 어떻게 할지 한 번만 확인합니다. 한 번 선택하면 이후 저장에는 다시 묻지 않습니다.
선택
결과
원본 유지
원본 텍스트 루틴과 루틴 빌더 사본이 함께 남습니다.
삭제하고 전환
원본이 제거되고 루틴 빌더 버전 한 건만 남습니다. 이름이 같은 다른 루틴이 더 있으면 함께 삭제하는 옵션(기본 꺼짐)도 선택할 수 있습니다.
취소
저장/등록을 진행하지 않고 그대로 둡니다.
기본 제공 루틴은 삭제할 수 없습니다
원본이 기본 제공 루틴이면 "삭제하고 전환" 선택지 대신 전환 계속 버튼만 표시됩니다. 원본은 그대로 남고 루틴 빌더 버전이 별도로 추가되어 목록에 두 건이 함께 보이게 됩니다.
채팅을 루틴으로 만들기
이미 채팅(특히 브라우저 작업)으로 수행한 내용을 루틴으로 변환할 수 있습니다.
루틴 빌더의 도구 팔레트에 "브라우저 세션을 루틴으로 추출"(routine_extract 계열) 노드가 있어, 수행한 세션 데이터에서 DOM 식별 규칙·반복 패턴을 정리해 재사용 가능한 루틴으로 추출합니다.
또는 에이전트에게 "방금 한 작업을 루틴으로 저장해줘"라고 자연어로 요청하면 추출 도구가 동작합니다.
채팅에서 자연어 요청으로 루틴이 저장되면, 입력창 위에 등록 결과 카드가 나타나 바로 확인할 수 있습니다.
루틴 이름과 함께 텍스트 또는 루틴빌더 유형이 표시됩니다.
[텍스트 보기] — 저장된 내용을 미리보기와 같은 방식으로 바로 확인합니다.
[루틴빌더에서 열기] — 루틴 빌더로 만들어진 루틴이면 캔버스로 바로 이동하고, 텍스트 루틴이면 루틴 빌더 전환 화면으로 이동합니다.
제논 사내 업무 루틴
제논 그룹웨어(아마란스)의 근태·결재 업무를 위한 기본 제공 루틴 4종입니다. 각 루틴은 자동으로 처리하는 범위와 사람이 직접 해야 하는 단계가 정해져 있습니다.
결재 상신은 대부분 직접 하십니다
금액이 얽힌 문서(지출결의서·예상비용품의서)는 에이전트가 [결재상신]을 누르지 않습니다. 작성까지 마친 뒤 화면을 넘겨드리니 내용을 확인하고 직접 올려주세요. 연차휴가 신청만 상신까지 자동으로 진행합니다.
공통 사전 준비
그룹웨어 로그인 정보 등록 — 로그인 설정에서 gw.genon.ai 계정을 등록해 두면 에이전트가 로그인까지 직접 처리합니다. 등록하지 않으면 로그인 화면에서 멈춥니다.
사전 품의 확인 — 제논은 지출 전 품의가 필수입니다. 지출결의서 루틴은 시작 시 예상비용품의서 결재 완료 여부를 먼저 확인합니다.
연차휴가 신청
근태신청서를 작성하고 전자결재 상신까지 완료합니다.
입력값
휴가구분(연차 / 오전·오후 반차 / 오전·오후 반반차), 시작일, 종료일, 사유
자동 처리
휴가구분 선택 → 기간 입력 → 결재선 자동 선택 → [신청완료] → [상신]
직접 확인
상신 결과. 휴가 목록에서 신청 건이 결재진행 상태로 보이는지 확인하세요.
반반차
반반차는 시간 선택이 필요합니다. 시간 입력 팝업에서 [확인]까지 눌러야 값이 확정되며, 루틴이 이 과정을 처리합니다.
결재문서 확인
미결문서를 전건 조회해 요약합니다.
입력값
없음
자동 처리
미결문서 목록 조회 → 문서별 제목·기안자·금액 요약 보고
직접 확인
승인·반려는 하지 않습니다. 요약을 보고 직접 처리하세요.
예상비용품의서 작성 (사전 품의)
지출 전에 올리는 사전 품의서를 작성합니다.
입력값
제목, 지출항목(한 줄에 한 행), 사용목적, 지출예정일, 용도, 결제방법
자동 처리
지출계획 표에 행 추가 → 항목·금액 입력 → 합계액 계산 → 되읽기로 반영 확인
직접 입력
프로젝트 코드, 지급기한, 부서 코드
지출항목은 숙소 / 8.25~26 판교 스테이 · 120,000처럼 한 줄에 한 건씩 적습니다. 부가세와 합계액은 자동으로 채워지므로 적지 않아도 됩니다.
프로젝트 코드 · 지급기한 · 부서 코드는 직접 입력
이 세 칸은 코드도움 팝업이라 에이전트가 값을 확정할 수 없습니다. 작성이 끝나면 화면을 넘겨드리니 직접 채워주세요. 프로젝트 코드는 사이트 관련은 사이트 코드, 프로젝트 미투입·비관련은 소속 파트, 동호회 활동은 동호회 활동을 고릅니다.
용도 코드
용도는 이름(코드) 형태로 적어주시면 정확합니다(예: 여비교통비-국내출장비(1029)). 이름만 적으면 코드가 여러 개인 항목(식대·회의비·교통비 등)은 어떤 코드인지 확정할 수 없어 비워둔 채 넘어갑니다.
지출결의서 작성 (Notion 연동)
Notion 표에 정리해 둔 지출내역을 읽어, 아마란스 카드 승인내역과 대조해 용도·내용을 채웁니다.
개인 Notion 연결이 필요합니다
이 루틴은 MCP 서비스에서 Notion 커넥터를 연결해야 동작합니다. 연결하지 않으면 첫 단계에서 멈추고 연결 안내가 표시됩니다.
루틴 빌더는 루틴을 노드 단위(다이어그램)로 시각적으로 구성하는 도구입니다. AI에게 자연어로 설명해 자동 생성하거나, 도구 팔레트에서 직접 끌어다 만들 수 있습니다.
루틴 빌더 > + 새 루틴 만들기를 누르면 다이어그램(그래프) 캔버스가 열립니다.
처음이라면 — 가이드와 따라하기
루틴 빌더에 처음 들어가면 화면 곳곳을 짚어주는 가이드 안내가 목록·AI·노드·스텝 화면마다 자동으로 한 번 표시됩니다. 다시 보고 싶다면 상단 가이드 버튼을 누르세요.
무엇부터 손대야 할지 막막하다면 따라하기 버튼을 눌러보세요. 예시 값을 그대로 따라 입력하면서 반복이 있는 첫 루틴을 직접 만들고, 저장 → 루틴 등록 → 실행까지 끝까지 해 보는 실습입니다(15단계). 지금 만질 곳만 남기고 나머지는 흐려져 길을 잃지 않게 안내합니다.
저장과 등록은 다릅니다
저장은 지금 만든 루틴을 보관하는 것이고, 루틴 등록은 채팅의 "기존 루틴" 목록에 올려 다음부터 골라 쓸 수 있게 하는 것입니다. 저장만 하고 등록하지 않으면 만들어 두고도 실제 업무에서 부를 수 없습니다.
① AI 방식 — 자연어로 그래프 자동 생성
하단 AI와 대화 영역에 만들고 싶은 자동화를 자연어로 설명하면 그래프가 자동으로 그려집니다. 상단 LLM ON 토글과 AI · 노드 · 스텝 모드 전환을 사용합니다. (Thinking 모델이라 30초~2분 소요)
빈 캔버스 — AI와 대화 / 도구 팔레트
AI 생성 결과 — 노드 9 / 엣지 8
AI 생성 예시
"네이버 메일 안 읽은 메일 요약"을 요청하자 노드 9개 / 엣지 8개 그래프가 자동 생성됩니다. (루틴 시작 → 웹사이트 열기 → 로그인 폼 채우기 → 클릭 → 메일함 열기 → 안 읽은 메일 모두 읽기 → 본문 읽기 → 루틴 끝) 생성 후에도 AI와 대화에서 "X 빼줘", "Y 다음에 Z 넣어"처럼 자연어로 그래프를 수정할 수 있습니다.
생성이 잘 안 될 때
그래프 생성 중 오류가 나면 자동으로 한 번 더 시도합니다. 그래도 실패하면 "루틴 그래프 생성에 실패했습니다. 잠시 후 다시 시도하거나 지시문을 더 구체적으로 적어주세요." 안내가 표시됩니다. 요청 문장을 조금 더 구체적으로 바꿔 다시 시도해 보세요.
② 수동 방식 — 도구 팔레트 드래그
좌측 도구 팔레트에서 노드를 캔버스로 드래그해 직접 구성합니다. 모든 도구는 한국어 이름으로 표시되고, 이름 앞에 [gmail]·[browser]처럼 출처 태그가 붙어 어떤 서비스의 도구인지 바로 알 수 있습니다.
브라우저 동작 — 웹사이트 열기 / 새로고침 / 화면 캡처 / 폼 채우기 / 사용자에게 제어 양도 등
그 외 도구는 업무 성격별 그룹(문서·메일·메시지·검색 등)으로 묶여 있어 필요한 도구를 찾기 쉽습니다.
검색창에 "메일"처럼 한국어 단어를 입력하면 이름·태그·설명까지 함께 찾아줍니다.
도구 목록을 불러오지 못했을 때
도구 팔레트를 불러오다 실패하면 원인에 맞는 안내와 함께 다시 시도 버튼이 표시됩니다. 여러 번 시도해도 해결되지 않으면 운영자에게 알리기를 눌러 주세요 — 문제 상황이 운영자에게 전달되어 조치에 활용됩니다.
③ 반복 · 조건 노드 자세히 보기
반복과 조건은 그래프에 갈래를 만드는 노드라 별도의 입력 화면과 표시 방식을 가집니다.
노드
구성
리스트 반복(loop_each)
목록의 각 항목마다 / 정해진 횟수만큼 중 하나를 고릅니다. 출력이 반복 본문(매 회차 실행)과 반복 종료 후(모두 끝난 뒤 한 번) 두 갈래로 나뉘어 있어, 반복 중에 할 일과 반복이 끝난 뒤 할 일을 각각 다른 선으로 연결합니다. 카드에는 현재 설정이 요약돼 보입니다.
조건 분기(if_condition)
조건을 우선순위대로 여러 개 추가할 수 있고, 어떤 조건에도 맞지 않으면 자동으로 그 외 경로로 이동합니다. 조건마다 판단 대상·값 종류(숫자/텍스트/날짜/존재 여부)·비교 방법을 골라 문장으로 구성하거나, 자연어로 직접 입력할 수 있습니다.
연결되지 않은 노드가 있다면
다른 노드와 이어지지 않은 노드가 있으면 저장 시 "루틴이 정상적이지 않습니다" 확인 창이 뜹니다. 그대로 저장은 되지만 실행할 때는 연결되지 않은 노드가 제외됩니다. 스텝(목록) 모드에서는 이런 노드에 "연결 안 됨 · 실행에서 제외" 표시가 붙으며 삭제만 가능합니다. 노드 모드에서 선을 다시 이어주면 정상적으로 실행됩니다.
④ 도구 노드 설정하기
도구가 들어간 노드를 클릭하면 우측 속성 패널이 열립니다. 위에서부터 순서대로 채우면 됩니다.
도구 파라미터 — 이 도구가 쓰는 값 목록입니다. 이름 위에 마우스를 올리면 한국어 설명이 나타납니다. 대부분은 실행할 때 지침을 보고 AI가 채우므로 직접 입력하지 않아도 됩니다.
실행 지침 — 이 노드가 무엇을 해야 하는지 문장으로 적는 주 입력 칸입니다. 예: "두 번째 표에 이름 열을 추가해줘". 비워 두면 AI가 앞뒤 단계를 보고 알아서 판단합니다.
실제 실행 문장 — 지침을 포함해 실제로 전달될 문장이 앞뒤 단계와 함께 미리보기로 표시됩니다. 지침을 고치면 이 미리보기도 바로 바뀝니다.
직접 입력 — 파일 경로처럼 AI가 판단하기 어려운 값은 이 자리에서 직접 입력합니다.
여러 동작을 한 번에 묶은 노드
클릭·입력 등 여러 동작을 순서대로 묶어 실행하는 노드는 묶음 단위로 나뉘고, 묶음 안에 동작을 하나씩 추가·삭제·순서 변경할 수 있습니다. 동작 종류(클릭/값 입력/키 입력/대기/사용자 조작 요청)를 고르면 필요한 입력칸만 나타납니다. 노드 카드에는 클릭 12 · 입력 3처럼 실제 동작 수가 요약돼 보입니다.
저장 · 실행 · 공유
상단의 루틴 이름(저장 필수)을 입력한 뒤 저장하고, 실행으로 즉시 테스트할 수 있습니다. 루틴 등록으로 채팅의 "기존 루틴" 목록에 올릴 수 있고, 내보내기(JSON)와 후속 루틴 연결도 가능합니다.
목록 버튼을 누르면 루틴 목록 화면으로 바로 이동합니다. 저장하지 않은 변경 사항이 있으면 이동 전에 저장 / 저장 안 함 / 취소 중에서 고르는 확인 창이 뜹니다.
편집 중 다른 화면으로 이동하면
저장하지 않은 변경 사항이 있거나 AI가 루틴을 만드는 중일 때 사이드바 등 다른 화면으로 이동하면 나가시겠냐는 확인 창이 뜹니다. 이 상태에서 나가기를 선택하면 진행 중이던 AI 생성은 취소됩니다.
웹훅은 외부 시스템의 이벤트로 루틴을 자동 실행하는 트리거입니다. 호출 URL과 시크릿을 외부 서비스에 등록해 두면, 호출이 들어올 때마다 연결된 루틴이 변수와 함께 실행됩니다.
스케줄러와의 차이
스케줄러는 정해진 시각에 실행하고, 웹훅은 외부 이벤트가 도착한 순간 실행합니다. "매주 월요일 9시 보고"는 스케줄러, "주문이 접수되면 내역 정리"는 웹훅이 적합합니다.
진입 경로
사이드바의 웹훅 아이콘(루틴 아이콘 위)을 누르면 웹훅 전용 모달이 열립니다. 등록된 웹훅 목록과 새 웹훅·새로고침 버튼이 있고, 각 웹훅 카드에서 활성/비활성 전환과 삭제를 할 수 있습니다.
웹훅 생성 및 루틴 연결
새 웹훅을 누르면 등록 폼이 열립니다.
섹션
입력
기본 정보
이름(필수) · 설명 — 어떤 외부 이벤트가 이 훅을 호출하는지 적습니다.
실행 대상
유형을 루틴 또는 메시지 중에서 선택합니다. · 루틴 — 저장된 루틴을 선택해 실행 · 메시지 — 호출 시 에이전트에게 보낼 프롬프트(예: "{{input.주문번호}} 주문 내역을 정리해줘")
이전 세션 이어서 사용
기본은 꺼짐(실행할 때마다 새 작업이 만들어짐)입니다. 켜면 직전 실행 작업을 이어서 사용해 브라우저 로그인 같은 상태가 유지됩니다.
입력 변수
왼쪽은 값이 주입될 루틴 입력({{input.라벨}}), 오른쪽은 외부 호출자가 payload JSON에 담아 보낼 키입니다. 예: 외부에서 {"mail": "..."}로 보내면 루틴 입력 "메일주소"에 주입됩니다.
루틴의 필수 입력은 모두 payload 키와 매핑해야 저장할 수 있습니다. 저장하면 웹훅이 생성되고, 이어서 표시되는 호출 정보를 외부 서비스에 등록하면 됩니다.
시크릿(Secret)
웹훅을 만들면 호출 인증용 시크릿이 자동 발급됩니다. 편집 화면의 호출 정보 섹션에서 확인·복사할 수 있고, 시크릿이 유출됐거나 주기적으로 교체하려면 시크릿 행의 재발급을 누릅니다. 재발급해도 호출 URL은 그대로 유지되므로 외부 서비스에 URL을 다시 등록할 필요가 없습니다.
재발급 주의
재발급하면 기존 시크릿은 즉시 무효화되어 이전 시크릿으로 호출하면 거부됩니다. 외부 서비스에 등록한 시크릿도 새 값으로 바꿔야 합니다.
수신 엔드포인트 호출
편집 화면 호출 정보 섹션에 두 종류의 URL이 표시됩니다.
외부(공개) URL — 외부 서비스에 등록하는 주소. 로그인·기기 등록 후 확인할 수 있습니다.
로컬(테스트) URL — 같은 PC에서 동작을 확인할 때 사용하는 주소.
호출 시 시크릿은 X-Webhook-Secret 헤더로 함께 보내야 합니다. 화면에 표시되는 curl 예시는 아래와 같은 형태입니다.
스킬은 사용자가 명시적으로 부르지 않아도, 관련 요청에서 자동으로 적용되어 결과물의 완성도를 높입니다.
커스텀 스킬 추가
번들 스킬 외에 나만의 스킬을 직접 등록할 수 있습니다. 목록 우상단 +를 누르면 추가 폼이 열립니다.
새 스킬 추가 — 직접 작성 / 폴더 가져오기
등록 방식 — 직접 작성(SKILL.md 한 장) 또는 폴더 가져오기(scripts/resources 포함) 중 선택
이름(필수) — 영문/숫자 권장. 폴더명은 이 이름에서 slug로 생성됩니다.
설명(필수) — 언제 이 스킬이 쓰이는지를 적습니다. 모델이 이 문구를 보고 "언제 이 스킬을 쓸지" 판단하므로, 트리거 조건과 용도를 구체적으로 작성하세요. 예: "사용자가 CSV 파일의 분석이나 변환을 요청할 때 사용. pandas로 읽기·정제·집계, Excel/JSON 변환까지 처리."
고급 옵션(선택) — 버전 / 허용 도구
내용(선택) — 에이전트가 참고할 단계별 지침(마크다운)
저장 위치
저장하면 ~/.oneagent/skills/<이름>/SKILL.md 디렉토리가 생성됩니다. 프로젝트 코드에는 포함되지 않습니다.
온라인 스킬 — 공개 GitHub 저장소에서 가져오기
온라인 스킬 탭에서는 공개 GitHub 저장소에 있는 스킬을 검색해 원하는 것만 골라 설치할 수 있습니다. 일부 환경에서는 이 탭을 열어도 "온라인 환경에서만 지원되는 기능입니다" 안내만 표시되고 실제 가져오기는 지원되지 않습니다.
온라인 스킬 — 추천 저장소 버튼 · 저장소 주소 입력 · 탐색된 스킬 다중 선택
저장소 지정 — 추천 저장소 버튼(OpenAI Skills, Anthropic Skills, GitHub Awesome Copilot)을 누르거나, 검색창에 저장소 주소를 직접 입력합니다.
저장소 전체가 스킬 모음집이면 저장소 주소만 입력합니다.
모음집이 특정 폴더 안에 있으면 그 폴더 주소로 범위를 좁힙니다.
가져올 스킬이 하나뿐이면 그 스킬 폴더 주소를 입력합니다.
탐색 — 탐색 버튼을 누르면 발견되는 스킬이 이름·설명·용량과 함께 순서대로 표시됩니다. 규격에 맞지 않는 폴더는 자동으로 제외되며 제외 사유가 함께 안내됩니다.
결과 내 검색 — 탐색 결과가 많으면 목록 바로 위의 결과 내 검색 칸에 이름·설명·경로의 일부를 입력해 좁힙니다. 공백으로 여러 단어를 넣으면 모두 포함하는 스킬만 남고, 오른쪽에 필터 결과 N / 전체 M 개수가 표시되며 일치한 글자에는 표시가 들어갑니다.
선택 및 설치 — 원하는 스킬을 체크박스로 여러 개 선택한 뒤 선택한 N개 설치를 누릅니다.
설치 확인 — 설치가 끝나면 스킬 목록에 온라인 배지와 함께 추가되며, 기본값은 비활성화(OFF)입니다.
이미 설치한 스킬은 구분해서 보여줍니다
탐색 결과의 각 스킬에는 현재 상태가 배지로 표시됩니다 — 이미 설치됨(내용이 같아 다시 설치할 필요 없음) · 업데이트(설치본보다 새 버전이라 고르면 교체됨) · 이름 사용 중(같은 이름의 다른 스킬이 이미 있어 설치할 수 없음). 배지가 없으면 아직 설치하지 않은 스킬입니다.
설치 후 반드시 확인
온라인 저장소의 스킬에는 외부 지시나 실행 스크립트가 포함될 수 있습니다. 내용 보기(👁)로 내용을 확인한 뒤 활성화(ON)해주세요.
에이전트 설정은 좌측 레일 하단 톱니에서 엽니다. 그중 MCP 서비스는 에이전트가 사용할 도구를 켜고 끄거나 새 도구를 추가하는 곳입니다.
에이전트 설정 — 좌측 섹션 목록 + MCP 서비스 상세
에이전트 설정 모달의 좌측에는 다음 섹션이 있습니다: MCP 서비스 · 로그인 설정 · 권한 · 루틴 · 스킬스 · 예시 질문 설정 · 개인 메모리 · 문의하기 · 사용자 매뉴얼. 로그인 상태에서는 OneLink 원격제어 섹션이 추가로 나타납니다. 그중 첫 번째가 MCP 서비스입니다.
상단에 N개 서버 활성 · 도구 N개 현황이 표시됩니다(예: 5개 서버 활성 · 도구 75개).
제논 서비스 — GenOS MCP 서버 추가
연결된 서비스 — browser(웹 브라우저 자동화 및 스크래핑, 도구 21개)·filesystem(파일 시스템 접근 및 관리, 도구 12개) 등 기본 도구 + 추가한 MCP. 항목별 활성 토글 / 도구 목록 / 추가·수정·삭제
도구 단위로 켜고 끄기
각 서비스의 도구 목록을 펼치면 개별 도구를 체크박스로 켜고 끌 수 있습니다. 사용하지 않는 도구를 꺼두면 에이전트가 불필요한 도구를 호출하지 않습니다.
browser 도구 목록(21/21) — browser_refresh, browser_user_control … 개별 체크박스
커넥터 — 외부 서비스 간편 연결
커넥터 목록에서는 Slack · GitHub · Notion · Google Drive · Gmail · Google Calendar · Linear · Asana 같은 외부 서비스를 연결 버튼 한 번으로 붙일 수 있습니다. 버튼을 누르면 해당 서비스의 로그인·동의 화면이 열리고, 완료하면 연결된 서비스 목록에 나타납니다.
미지원 배지 — 서비스 측 사정으로 현재 연결할 수 없는 커넥터입니다. 연결 버튼이 비활성화되고, 마우스를 올리면 사유가 표시됩니다.
점검 중 배지 — 일시적인 점검으로 연결이 잠시 차단된 상태입니다. 점검이 끝나면 자동으로 다시 연결할 수 있게 됩니다.
로그아웃하면 연결이 해제됩니다
커넥터가 연결된 상태에서 로그아웃하면, 해제될 서비스의 개수와 목록을 보여주는 확인 창이 먼저 표시됩니다. 같은 계정으로 다시 로그인하면 연결이 자동으로 복원되며, 다른 계정으로 로그인하면 다시 연결해야 합니다.
📷 스크린샷 갱신 필요 — 커넥터 목록(미지원 · 점검 중 배지 포함)과 로그아웃 확인 창
에이전트가 파일 쓰기 등 민감한 도구를 실행하기 직전에는 승인 프롬프트가 표시됩니다. 민감 작업은 사용자가 승인한 뒤에 실행됩니다.
write_file 실행 직전 — "승인 필요" 프롬프트
승인 선택지
파일 쓰기(write_file) 등 도구를 실행할 때 "승인 필요" 프롬프트가 표시됩니다. 실행할 도구와 대상(예: 작성할 파일 경로/내용)이 함께 안내됩니다.
선택지
동작
한 번 허용
이번 한 번만 실행을 허용
세션 내내 허용
현재 대화에서 같은 도구를 다시 묻지 않고 자동 실행
수정
실행 내용을 수정한 뒤 진행
거부
실행하지 않음
자동화 팁
대화 중인 세션에서는 승인 프롬프트가 응답할 때까지 기다립니다(자동으로 거부되지 않습니다). 다만 스케줄러·웹훅 등 무인 실행에서는 승인을 기다릴 사람이 없어 즉시 거부되므로, 무인 자동화 작업에는 승인 정책(세션 내내 허용, 또는 아래 전체 자동 승인)을 미리 정해두어야 합니다.
자리를 비웠을 때
창을 최소화했거나 다른 화면을 보고 있을 때 승인이 필요한 순간이 되면 시스템 알림으로 알려드립니다(예: "write_file" 도구 실행 허용이 필요합니다.). 알림을 클릭하면 앱 창이 열리고 승인 화면으로 돌아갑니다.
전체 자동 승인 — 에이전트 설정 > 권한
매번 승인하는 대신, 에이전트 설정 > 권한 화면에서 도구 실행 자동 승인을 전역으로 켤 수 있습니다. 켜면 이후 모든 세션에서 승인 프롬프트 없이 도구가 바로 실행됩니다.
켜기 전에 확인하세요
전체 자동 승인을 켜면 파일 쓰기 등 민감한 도구도 확인 없이 실행됩니다. 무인 자동화가 꼭 필요한 경우에만 사용하고, 평소에는 꺼 두는 것을 권장합니다.