사용 설명서

Evo Chat은 브라우저에서 쓰는 업무용 AI 채팅입니다. 이 설명서는 처음 로그인부터 대화, 설정, 다른 AI 세션과의 작업 요청까지 화면 순서대로 안내합니다. 화면에는 서비스 이름이 evo로 표시됩니다.

화면 캡처는 개발 서버(개인용 인스턴스)에서 찍었고, 이름·이메일·아이디는 예시 값(홍길동, 예시 주소)으로 바꿨습니다. 관리자가 켜 둔 기능에 따라 일부 버튼은 보이지 않을 수 있습니다.

1. 로그인

1. 관리자에게 받은 Evo Chat 주소로 접속하면 evo 로그인 화면이 나옵니다.
2. 계정 종류에 맞게 로그인합니다.
   • 조직 SSO 계정: OIDC(SSO)로 로그인을 누르고 조직 로그인 화면에서 로그인합니다.
   • 로컬 계정: 아이디와 비밀번호를 입력하고 로그인을 누릅니다.
   • 관리자가 LDAP을 켜 두었다면 LDAP 디렉터리로 로그인 버튼도 보입니다. 사내 디렉터리 아이디·비밀번호로 로그인합니다.
3. 계정이 있어도 user 또는 admin 그룹에 속하지 않으면 **“접근 권한이 없습니다.”**가 나오고 들어갈 수 없습니다. 관리자에게 그룹 소속을 요청하세요.

이미 로그인한 상태에서 로그인 화면을 열면 지금 계정으로 계속할지, 다른 계정으로 로그인할지 고를 수 있습니다.

2. 첫 화면 둘러보기

위치	이름	하는 일
왼쪽 위	로고·“업무용 AI 어시스턴트”	서비스 이름 표시
왼쪽	+ 새 대화	새 대화를 시작합니다
왼쪽	검색	대화 제목을 검색합니다
왼쪽	대화 목록	오늘·어제처럼 날짜별로 묶여 있습니다. 누르면 그 대화로 이동합니다
왼쪽 아래	계정 버튼(이름·아이디·역할)	설정, 내 작업 공간(관리자가 켠 경우), 내 기록, 버그 신고, 로그아웃 메뉴를 엽니다
가운데 아래	입력창	메시지를 쓰고 보냅니다. 왼쪽 아래 +, 오른쪽 아래 모델 이름과 ↑ 버튼이 있습니다
오른쪽 위	⚙ 관리자 설정	관리 화면 권한이 있는 사용자(관리자, 관리 권한을 위임받은 사용자)에게만 보입니다. 관리자 설명서를 참고하세요

휴대폰에서 쓰기

휴대폰처럼 화면 폭이 좁으면 사이드바가 숨겨지고, 왼쪽 위에 ☰(메뉴 열기) 버튼이 나옵니다.

**☰**을 누르면 사이드바가 서랍처럼 열립니다. 서랍에서 새 대화, 검색, 대화 목록, 계정 메뉴(설정·내 작업 공간·내 기록·버그 신고·로그아웃)를 데스크톱과 똑같이 씁니다.

3. 대화하기

1. 사이드바에서 + 새 대화를 누릅니다. 아직 메시지가 없는 새 대화가 있으면 새로 만들지 않고 그 대화로 이동합니다.
2. 입력창(메시지를 입력하세요…)에 질문을 씁니다.
3. Enter를 누르거나 오른쪽 아래 ↑ 버튼을 눌러 보냅니다.
   • 줄을 바꾸려면 Shift+Enter
   • 답변 생성을 멈추려면 Esc 또는 같은 자리의 ■ 버튼
   • 한글을 조합하던 중 Enter를 눌러도 두 번 보내지지 않습니다.
4. 답변 위쪽에 evo · 모델 이름이 표시되어, 어느 모델이 답했는지 알 수 있습니다.

답변에 쓴 Markdown은 화면 서식으로 그려집니다. 제목 위계, 목록, 인용, 표, 취소선, 작업 목록, 링크와 자동 링크, 인라인 코드, 코드 블록이 모두 서식대로 보이고, 빈 줄 없이 한 번만 줄을 바꾼 자리도 그대로 줄이 바뀝니다. 받은 요청 창의 답변도 같은 서식을 씁니다.

답변이 나오는 동안 화면을 위로 조금 올려도 자동으로 맨 아래로 끌려가지 않습니다. 새 메시지를 보내거나 맨 아래 근처로 돌아오면 다시 답변을 따라갑니다.

첫 글자가 나오기까지 시간이 걸려도 답변이 멈춘 것처럼 보이지는 않습니다. 답변 칸에 지금 하는 일과 지난 시간이 1초마다 표시됩니다 — 생각하는 중 · n초, 도구 이름 실행 중 · n초, 답을 쓰는 중 · n초. 답변이 끝날 때까지 커서가 남습니다.

대화를 고르면 주소가 /c/<대화 id>로 바뀝니다. 새로 고침하거나 브라우저의 뒤로 가기·앞으로 가기를 눌러도 보던 대화가 그대로 열리고, 대화를 지우면 새 대화 화면(/)으로 돌아갑니다.

대화 제목은 처음에는 새 대화로 만들어지고, 관리자가 제목 생성 모델을 켜 두었으면 내용에 맞는 제목으로 바뀝니다. 켜져 있지 않으면 첫 메시지 앞부분이 제목이 됩니다.

입력창에 $를 입력하면 쓸 수 있는 스킬 목록이 나타납니다. 위아래 화살표로 고르고 Enter 또는 Tab으로 넣습니다(관리자가 스킬을 배포한 경우).

모델 고르기

입력창 오른쪽 아래의 모델 이름(▾)을 누르면 쓸 수 있는 모델 목록이 열립니다.

• 자동 선택: 질문 길이와 내용에 맞춰 모델을 자동으로 고릅니다. 대화에 그림이 있으면 이미지 입력을 지원하는 모델을 먼저 시도하고, 실패하면 일반 모델로 넘어갑니다.
• 그 아래에는 관리자가 연결한 프로바이더별로 내가 쓸 수 있는 모델이 나옵니다. 하나를 누르면 그 대화에서 그 모델을 씁니다.
• 관리자가 모델 프리셋을 등록했다면 프리셋 묶음도 함께 보입니다.
• 직접 고르지 않으면 관리자가 정한 기본 모델(그룹 기본 모델, 없으면 조직 기본 모델)로 시작합니다. 내가 고른 모델이 있으면 그 모델이 우선합니다.

도구 실행 표시

모델이 도구를 쓰면 진행 상황이 마지막 답변 위에 한 줄로 모입니다.

• 실행 중·완료·거부·실패한 도구는 도구 2개 실행 중 (1개 진행), 도구 3개 실행 완료, 도구 3개 중 1개 실패·거부처럼 한 줄로 보입니다. 줄을 누르면 도구별 상태와 요약이 펼쳐집니다.
• 승인이 필요한 도구는 입력창 위 패널에 승인 대기로 남고, 승인하거나 거부한 결과도 답변 안 한 줄에 합쳐집니다.
• 이 한 줄은 답변과 함께 저장되어 새로고침하거나 대화를 다시 열어도 그대로 보입니다. 저장되는 것은 서버·도구 이름·상태·짧은 요약·검색 출처뿐이고, 도구에 넣은 인자와 결과 본문은 저장하지 않습니다. 이 기능 전에 나눈 대화에는 흔적이 없어 한 줄이 보이지 않습니다.

웹 검색과 페이지 읽기

모델이 필요하다고 판단하면 웹을 검색하고(web_search) 공개 웹 페이지를 읽어(web_fetch) 답에 반영합니다. 켜거나 누르는 버튼은 없고, 외부 읽기 전용이라 승인 창 없이 실행됩니다.

• 검색은 그 답변에 쓰는 모델 연결(LiteLLM)의 검색 중계를 지나갑니다. 검색 엔진 키는 서버 쪽에 있습니다.
• 검색 결과의 제목과 주소(최대 10개)는 도구 줄에 출처 M개로 모여 보이고, 펼치면 제목과 도메인, http(s) 링크로 열립니다.
• 페이지 읽기는 인터넷에 공개된 http(s) 주소만 됩니다. 사설망·내부 주소와 그런 곳으로 가는 리다이렉트는 읽지 않습니다. HTML 페이지는 글만 남기고 제목을 앞에 붙여 읽습니다.
• 검색과 페이지 내용은 외부에서 가져온 자료입니다. 그 안에 적힌 지시는 따르지 않고 정보로만 쓰도록 모델에 안내합니다.
• 관리자가 기능을 끄면 쓰지 않고, 내 연결이 LiteLLM이 아니면 페이지 읽기만 됩니다.
• 검색이 실패해도 대화는 그대로 이어지고, 모델이 검색 없이 계속합니다.

답변 다루기

답변 아래에 마우스를 올리면 동작 버튼이 나타납니다. 휴대폰·태블릿처럼 마우스를 올릴 수 없는 터치 기기에서는 이 버튼과 코드 블록의 코드 복사 버튼이 늘 보입니다.

버튼	하는 일
⧉ 복사	답변 전체를 복사합니다. 코드 블록에는 따로 코드 복사 버튼이 있습니다
↻ 재생성	마지막 답변을 다시 만듭니다. 이전 답변은 버전으로 남습니다
👍 / 👎	답변을 평가합니다

복사 버튼을 누르면 결과가 버튼 옆에 바로 보입니다. 복사되면 ✓ 복사됨이 2초 동안, 실패하면 복사하지 못했습니다가 4초 동안 표시되며, 화면 읽기 프로그램에도 같은 안내가 전달됩니다. 답변 전체 복사, 코드 블록의 코드 복사, 내 메시지 복사에 모두 같은 방식으로 표시됩니다.

내가 보낸 메시지 아래에도 버튼이 있습니다.

• ✎ 편집: 메시지를 고친 뒤 저장하고 다시 보내기를 누르면 새 답변을 받습니다. 원래 답변은 버전으로 남고, 이전 버전·다음 버전으로 오갈 수 있습니다.
• ⧉ 복사: 내 메시지를 복사합니다.

파일 첨부

입력창 왼쪽 아래의 +(파일 첨부) 버튼으로 파일을 고르거나, 입력창에 파일을 끌어 놓거나 붙여 넣으면 그 파일이 질문에 함께 갑니다. 한 번에 여러 개를 고를 수 있고, 형식은 가리지 않습니다.

• 고른 파일은 바로 올라가고 입력창 위에 이름과 크기 칩으로 보입니다. 올리는 중에는 보내지 않습니다. 올리지 못한 파일은 칩에 이유가 보입니다.
• 칩의 **✕**로 보내기 전에 뗄 수 있습니다.
• 글 없이 파일만 보내면 “첨부한 파일을 확인해 주세요.“를 질문으로 보냅니다.
• 보낸 뒤에는 질문 위에 붙인 파일이 보이고, ↓ 버튼으로 원래 이름 그대로 내려받습니다. 대화를 다시 열어도 남아 있습니다.
• 한 질문에 붙일 수 있는 파일은 최대 20개입니다.

첨부가 모델에 어떻게 전달되는지는 파일 종류에 따라 다릅니다.

파일	모델에 전달되는 내용
글로 읽히는 파일(txt·md·csv·json·소스 코드 등)	파일 내용이 질문 뒤에 붙습니다. 파일 하나 6만 자, 요청 전체 12만 자까지 넣고, 넘으면 생략 표시가 붙습니다. 최근 질문의 파일부터 채웁니다
이미지(png·jpeg·gif·webp)	관리자가 모델을 이미지 입력 지원으로 표시했으면 그림으로 함께 보냅니다. 최근 것부터 4장, 장당 5MB까지입니다. 표시하지 않은 모델에는 그림을 보내지 않고 그 사실을 글에 적습니다
PDF	글자를 꺼내 질문 뒤에 붙입니다. 글은 20만 자·앞 2,000쪽까지 저장하고, 글로 읽히는 파일과 같은 한도로 넣습니다. 암호가 걸렸거나 깨졌거나 글자가 없는(스캔) PDF는 내용 없이 “내용은 읽을 수 없는 형식”으로 알려 줍니다
Office 문서(docx·xlsx·pptx)	Word는 문단과 표, Excel은 시트마다 셀 값, PowerPoint는 슬라이드마다 보이는 글을 꺼내 PDF와 같은 한도로 붙입니다. 글은 20만 자까지 저장하고, zip 항목 10,000개·풀린 크기 64MB를 넘거나 암호가 걸린 파일은 내용 없이 알려 줍니다. 옛 형식(doc·xls·ppt)·hwp·압축 파일 등은 이름·형식·크기만 알려 줍니다

• 다시 생성하면 질문에 붙은 파일을 그대로 씁니다. 질문을 편집하면 새 버전에는 파일이 붙지 않고 편집 전 버전에만 남습니다.
• 파일은 대화에 묶여 저장됩니다. 대화를 지우거나 모든 대화를 지우거나 계정을 지우면 함께 사라집니다. 다른 사람의 대화 첨부는 보고 내려받고 지울 수 없습니다.
• 내려받은 파일은 항상 내려받기 파일로 열립니다. 올린 HTML·SVG가 브라우저에서 페이지로 실행되지 않습니다.

4. 대화 목록 관리

• 대화 목록에는 처음에 최근 대화 50개가 보입니다. 대화가 더 있으면 목록 맨 아래에 더 보기 버튼이 나오고, 누를 때마다 다음 50개가 이어 붙습니다.
• 대화 줄을 누르면 그 대화로 이동합니다.
• 대화 줄에 마우스를 올리면 오른쪽에 버튼이 나타납니다. 터치 기기에서는 버튼이 늘 보입니다.
  • ✎ 이름 변경: 대화 제목을 바꿉니다.
  • 🗑 삭제: 대화를 지웁니다. 지운 대화는 되돌릴 수 없습니다.
• 위쪽 검색에 단어를 넣으면 제목에 그 단어가 들어간 대화만 보입니다.
  • 검색 결과도 50개씩 보입니다. 결과가 50개를 넘으면 개수가 “검색 결과 (50+)“처럼 표시되고, 맨 아래 더 보기로 이어서 봅니다.

5. 계정 메뉴와 설정

사이드바 맨 아래의 계정 버튼을 누르면 계정 메뉴가 열립니다.

• 위쪽에 내 이름, 아이디, 이메일, 역할, 인증 방식(예: OIDC (SSO)), 소속 그룹이 보입니다.
• 설정: 아래 설정 창을 엽니다.
• 내 작업 공간: 관리자가 작업 공간 기능을 켜 두었을 때만 보입니다. 아래 작업 공간을 엽니다.
• 내 기록: 아래 내 기록을 엽니다.
• 버그 신고: 8. 버그 신고를 엽니다(관리자가 켠 경우, SSO 계정만).
• 로그아웃: 확인 창에서 로그아웃을 누르면 로그아웃됩니다. 서버의 로그인 세션도 함께 끝납니다.

내 기록

내 기록에서는 웹 채팅과 Evo CLI에서 보낸 질문의 사용 기록을 봅니다. 시각, 모델, 토큰 수, 지연 시간, 처리 단계만 보이며 질문과 답변 내용은 보이지 않습니다.

1. 웹 또는 CLI 탭을 고릅니다. 웹은 대화별로, CLI는 세션별로 묶여 보입니다.
2. 기간에서 최근 7일·30일·90일 중 고릅니다(기본 30일). 최신 내용은 새로 고침으로 다시 불러옵니다.
3. 대화(또는 세션)를 누르면 그 안의 질문 목록이 나옵니다. 질문마다 시각, 모델, 토큰(입력·출력·합계), 지연, 단계 수가 보입니다.
4. 단계 보기를 누르면 질문 하나가 처리된 순서(라우팅, 모델 호출, 도구 실행 등)가 펼쳐집니다. ← 목록으로를 누르면 대화 목록으로 돌아갑니다.

웹·CLI 탭이나 기간을 바꿔도 창 높이는 그대로입니다. 높이는 화면의 85%로 고정되고 목록 안에서만 스크롤됩니다.

• CLI 기록은 Evo CLI·데스크톱 앱이 사용 기록을 보내도록 설정되어 있을 때만 보입니다.
• “사용 기록 조회가 설정되어 있지 않습니다”가 나오면 관리자가 관측성(Langfuse) 연동을 켜야 합니다.

설정 창

설정 창은 왼쪽 탭 여섯 개로 나뉩니다. 바꾼 값은 계정에 저장되어 다른 PC에서도 같게 적용됩니다. 관리자가 작업 공간 기능을 켜지 않았어도 작업 공간 탭은 남아 있고, 그 탭에 기능이 꺼져 있다는 안내가 보입니다.

일반: 테마와 언어

• 테마: 라이트, 다크, 시스템(운영체제 설정을 따름), 고대비 중 고르면 바로 적용됩니다.
• 언어: 한국어(기본) 또는 English

개인화: 모든 대화에 적용할 지시문

• 전역 사용자 지시문에 “항상 한국어로 간결하게 답하고, 코드 예시에는 주석을 달아 줘”처럼 원하는 답변 방식을 적고 저장합니다.
• 모든 대화에 반영됩니다. 프리셋 지시문과 서로 다르면 프리셋 지시문이 우선합니다.

데이터: 내보내기와 전체 삭제

• Markdown 내보내기 / JSON 내보내기: 지금 보고 있는 대화(선택된 버전)를 파일로 내려받습니다.
• 모든 대화 삭제: 내 계정의 모든 대화와 메시지를 영구 삭제합니다. 되돌릴 수 없으니 주의하세요.

API 키: 외부 도구에서 Evo Chat 모델을 부를 때 쓰는 키

1. 새 키 발급에서 이름(예: ci-script)을 적습니다.
2. 필요하면 월 토큰 상한과 월 요청 상한을 정합니다. 비워 두면 상위(그룹·전역) 한도를 따릅니다.
3. 발급을 누르면 키가 한 번만 표시됩니다. 바로 안전한 곳에 보관하세요.
4. 이 키로 OpenAI 호환 API(/v1/chat/completions)를 호출할 수 있고, 키는 내 계정의 모델 권한을 그대로 따릅니다.
5. 아래에 이번 달 사용량(요청 수·토큰)과 활성 키 목록이 보이며, 필요 없는 키는 목록에서 폐기합니다.

작업 공간: 작업 공간에서 쓸 GitLab 토큰

• 작업 공간은 관리자가 켜고 내 역할에 workspace 기능 권한을 줘야 쓸 수 있습니다.
• 내가 등록한 GitLab 토큰 또는 서버에 설정된 공용 GitLab 토큰 중 하나가 있어야 clone·push를 할 수 있습니다. 토큰을 넣을 칸은 하나이며(주소 입력란은 없습니다), 저장하면 암호화되어 보관됩니다.
• 아래에 토큰 출처와 토큰 만료일(모르면 “알 수 없음”)이 보입니다. 만료가 가까우면 새 토큰을 등록하라는 안내가 나옵니다.
• 내가 등록한 토큰은 등록한 토큰 삭제로 지울 수 있습니다. 서버 공용 토큰은 여기서 지우지 않습니다.
• 기능이 꺼져 있으면 “작업 공간 기능이 꺼져 있습니다”가 보이고, 실행기나 토큰이 준비되지 않았으면 “지금은 이 계정으로 작업 공간 실행을 인증할 수 없습니다”가 보입니다.

계정: 내 계정 정보

• 아이디, 표시 이름, 이메일, 역할, 인증 방식, 그룹을 확인합니다.
• 로컬 계정이면 이 탭에서 비밀번호를 바꿀 수 있습니다. SSO·LDAP 계정의 비밀번호는 조직 계정 시스템에서 바꿉니다.

6. 작업 공간 (웹 workflow)

작업 공간은 대화가 GitLab 프로젝트 저장소를 clone해 파일을 읽고 고치며, 커밋·push·MR·이슈 작업까지 하게 해 주는 기능입니다. 관리자가 켜고 내 역할에 workspace 기능 권한을 줘야 쓸 수 있습니다. 기본은 꺼짐이고, 꺼져 있으면 이 설명서의 나머지 채팅 기능은 평소와 같습니다.

쓸 수 있는 조건

• 관리자가 작업 공간을 켜고(WORKSPACE_ENABLED), 실행기와 evo-workspace 이미지, GitLab 토큰을 준비해야 합니다.
• 내 계정이 활성이고 내 역할(또는 소속 그룹의 역할)에 workspace가 있어야 합니다. 로컬 계정과 SSO 계정 모두 쓸 수 있습니다.
• clone·push에는 GitLab 토큰이 필요합니다. 내가 등록한 토큰 또는 서버 공용 토큰이 있어야 하며, 없으면 “지금은 이 계정으로 작업 공간 실행을 인증할 수 없습니다”가 나옵니다.
• 조건이 안 맞으면 계정 메뉴에서 내 작업 공간이 숨겨지고, 대화의 워크플로 확인 패널에는 실행기나 토큰이 준비되지 않았다는 안내가 나옵니다. 모델에도 작업 공간 도구가 보이지 않습니다.

대화에서 작업하기

대화를 선택하면 대화 화면 위쪽에 워크플로 확인 단추가 보입니다. 누르면 작업 공간 패널이 열리고, 확인할 작업·에이전트 ID·MR 머지 탭에서 사람 확인이 필요한 작업을 처리합니다.

• 에이전트가 쓰는 작업 브랜치는 대화마다 **chat/<대화 id>**로 정해집니다.
• main·master·develop·release/* 같은 보호 브랜치에는 push하지 못합니다(관리자 배포 설정에 따라 목록이 다를 수 있음). 최종 방어선은 GitLab의 보호 브랜치 설정과 내 토큰 권한입니다.
• clone은 관리자가 허용한 GitLab 호스트의 **https://…:443**으로만 나갑니다. 다른 포트를 쓰는 GitLab은 이 구성에서 clone할 수 없습니다.
• 디스크는 계정마다 상한(기본 10GiB)이 있습니다. 상한을 넘으면 실행·clone·파일 쓰기가 disk_quota 오류로 거절되고, 파일 삭제와 초기화는 됩니다.

사람이 확인하고 실행하는 작업

모델은 이슈 게시, 에이전트 ID 등록, MR 머지를 스스로 실행하지 않습니다. 미리보기까지만 만들고, 로그인한 내가 화면에서 확인해야 서버가 실행합니다. 모델 도구에는 이 실행 경로가 열리지 않습니다.

• 확인할 작업: 미리보기 내용을 보고 확인하고 실행 또는 취소를 누릅니다. 미리보기는 만든 때부터 30분 동안만 확인할 수 있고, 지나면 “확인이 만료되었습니다”가 나와 다시 만들어야 합니다.
• 에이전트 ID: 미리보기 만들기로 내용을 확인한 뒤 이 내용으로 이슈 게시 또는 커밋·push 하고 MR 만들기를 고릅니다.
• MR 머지: 대상 MR을 확인한 뒤 머지를 누릅니다.

도구별 승인

• 파일 쓰기, git 변경(브랜치 만들기·stage·commit·push), MR 생성, 이슈 게시처럼 데이터를 바꾸는 도구는 실행 전에 승인 창을 띄웁니다. “데이터를 변경할 수 있는 도구입니다. 실행 전 인자를 확인하세요”와 함께 승인하고 실행·거부가 보입니다.
• 파일 읽기·조회 도구는 승인 없이 실행됩니다.
• 승인 창에 120초 안에 응답하지 않거나 거부하면 실행하지 않습니다.

내 작업 공간 창

계정 메뉴의 내 작업 공간에서 내 작업 공간 상태를 봅니다.

• 사용량: 상한 대비 사용량(기본 10GiB)과 파일·폴더·링크 수, 프로젝트별 크기가 보입니다. 상한을 넘으면 막대가 빨갛게 바뀌고 안내가 나옵니다.
• 파일 목록에서 파일 내용을 보고, 필요 없는 파일을 지울 수 있습니다.
• 초기화는 확인을 거쳐 내 작업 공간의 파일만 지웁니다. 계정, GitLab 토큰, 에이전트 ID 등록은 그대로 남습니다.
• 작업이 실행 중이면 초기화할 수 없고 “작업이 실행 중이라 지금은 지울 수 없습니다”가 나옵니다. 작업이 끝난 뒤 다시 시도하세요.
• 파일이 너무 많거나 프로젝트가 너무 많으면 일부만 계산·표시했다는 안내가 붙습니다.

감사

작업 공간 도구 호출은 관리자 감사 로그에 도구 이름, 동작, 승인 여부, 결과, 오류 코드로 남습니다. 파일 경로·인자·파일 내용·토큰은 남기지 않습니다.

7. 작업 요청 (다른 AI 세션과 주고받기)

관리자가 evo-dispatch 연동을 켜 두었고 SSO 계정으로 로그인했다면, 대화 하나하나가 작업 요청 세션이 됩니다. 이 세션으로 내 다른 세션(예: 터미널의 Evo CLI)과 작업 요청을 주고받습니다. 대화를 누르면 바로 열리며, 따로 켜는 버튼이나 열기·닫기 동작은 없습니다.

한 번 연 대화는 다른 대화로 옮겨도 연결이 그대로 유지됩니다. 그래서 같은 탭에서 열어 둔 대화끼리 작업 요청을 주고받을 수 있고, 답을 생성하는 중에 다른 대화로 옮겨도 생성은 뒤에서 계속됩니다. 탭마다 최근에 본 대화를 최대 10개까지 연결해 두고, 넘으면 가장 오래 안 본 대화부터 연결을 놓습니다(안내는 없으며, 대화 내용은 그대로 남아 다시 누르면 다시 연결됩니다). 사이드바의 대화 줄에는 생성 중(초록 점)·도구 승인 대기(주황 점)·안 읽은 요청 수가 표시됩니다.

내 계정 전체로는(다른 탭·다른 기기를 모두 합쳐) 동시에 연결할 수 있는 대화가 최대 10개입니다. 이미 10개가 연결된 상태에서 새 대화를 열면 그 대화는 연결되지 않고 화면에 안내 문구만 보이며, 채팅 자체는 평소처럼 됩니다.

대화 머리글 왼쪽 위에 이름 · 작업 공간 · 연결 상태가 표시됩니다(예: 이름 없음 · web · 연결됨). 이것을 누르면 작업 요청 창이 열립니다.

항목	뜻
상태	작업 요청 서버와 연결됐는지(연결됨)
작업 공간	이 세션의 작업 공간 이름(웹은 web)
안 읽은 요청	이 대화로 들어와 아직 읽지 않은 요청 수
받은 요청 보기	받은 요청 목록을 엽니다
요청 보내기	내 다른 세션에 요청을 보냅니다
작업 담당 이름(agent)	이 대화를 부를 이름. 영문·숫자로 시작하고 영문·숫자·. _ -만, 64자까지. 비우면 “이름 없음”

받은 요청 읽기

받은 요청 보기를 누르면 이 대화로 들어온 요청이 나옵니다. 요청을 골라 읽고, 내 지시로 그 작업을 이어 가거나 답장합니다. 받은 요청이 자동으로 실행되지는 않습니다.

암호화되어 온 요청에는 제목 앞에 🔒가 붙고, 창 안에 “종단간 암호화된 요청입니다. 보낸 기기의 서명을 확인했습니다.“가 함께 보입니다. 보낸 시각이 서버 기록과 10분 넘게 다르면 몇 분 차이인지도 알려 줍니다. 서명이 맞지 않거나 이 기기 앞으로 온 것이 아닌 요청은 내용 없이 “(열 수 없는 암호화 요청)“으로 보이고 실패 안내가 나오며, 채팅에 붙일 수 없습니다.

보낸 기기의 암호 키가 전에 본 것과 다르면 열되 “⚠ 보낸 기기의 암호 키가 전에 본 것과 다릅니다. 기기를 다시 설치했거나 다른 기기일 수 있습니다. 보낸 사람을 확인하세요.” 경고가 함께 보입니다. 같은 암호화 요청이 다른 메시지로 다시 오면 열지 않고 재전송 의심 안내를, 보낸 지 30일이 넘은 요청도 열지 않고 그 이유를 보여 줍니다.

요청 보내기

1. 요청 보내기를 누릅니다.
2. 받는 곳을 고릅니다.
   • 세션 하나: 아래 내 활성 세션 목록에서 하나를 고릅니다(이 대화는 제외). 목록이 오래됐으면 목록 새로 고침을 누릅니다.
   • 작업 담당 이름 / 작업 공간: 그 이름이나 작업 공간을 가진 내 세션 모두에 보냅니다.
   • 내 모든 세션: 내 활성 세션 전체에 보냅니다.
3. 제목과 본문(Markdown, 16KB까지)을 쓰고 보내기를 누릅니다.

토큰·비밀번호·내부 IP 같은 비밀정보는 넣지 마세요.

암호화

작업 요청의 제목·본문·링크는 같은 사용자의 다른 세션과 종단간 암호화해 주고받습니다. 그래서 dispatch 서버는 그 내용을 읽지 못합니다. 다만 웹에서는 브라우저가 평문을 다루고 evo-api가 암호 봉투를 만들고 풀기 때문에, evo-api 서버와 모델 제공자는 내용을 볼 수 있습니다.

세션 작업 요청은 늘 암호화해서 보냅니다. 평문으로 보내는 선택지는 없습니다.

• 보냈을 때: 보낸 결과에 🔒와 “종단간 암호화해 보냈습니다.“가 표시됩니다.
• 받는 기기 키가 바뀌었을 때: 전에 본 키와 다르면 보내되 “⚠ 받는 기기의 암호 키가 전에 본 것과 달라졌습니다. 보냈지만 받는 사람이 맞는지 확인하세요.” 경고를 함께 보여 줍니다.
• 보내지 않는 경우: 다음 중 하나면 보내지 않고 이유를 보여 줍니다. 이때도 대화는 그대로 됩니다.
  • 받는 세션 중 암호화 키가 없는 곳이 하나라도 있음 — “받는 세션 중 종단간 암호화를 지원하지 않는 곳이 있어 보내지 않았습니다”와 함께 어느 세션인지 알려 줍니다.
  • 주소에 맞는 활성 세션이 없음 — “주소에 맞는 활성 세션이 없습니다. 요청은 저장되지 않았습니다.”
  • 이 서버에서 종단간 암호화가 꺼져 있음 — “이 서버에서 종단간 암호화가 꺼져 있어 세션 요청을 보낼 수 없습니다.” 받기는 그대로 됩니다.
• 받았을 때: 제목 앞의 🔒와 서명 확인 안내, 시각 차이 안내는 받은 요청 읽기에서 설명합니다. 워크그룹이나 워크그룹 멤버 주소로 온 암호화 요청도 웹 대화에서 열어 볼 수 있고, 실행 표시가 바뀐 요청은 “(열 수 없는 암호화 요청)“으로 보입니다.
• 호환: 받는 쪽은 다른 세션이 보낸 평문 요청도 그대로 받습니다. 보내는 쪽만 늘 암호화합니다.

모델이 요청을 보내려 할 때

대화 중에 모델이 다른 세션으로 작업 요청(또는 답장)을 보내려 하면, 바로 보내지 않고 대화 안에 승인 창이 나옵니다.

• 승인 창에는 받는 주소(세션, 작업 담당 이름, 작업 공간, 또는 내 다른 모든 활성 세션), 종류(작업 요청 또는 답장), 제목, 본문, 링크가 보입니다.
• 모델이 보내려는 요청도 늘 암호화해 보냅니다. 평문으로 보내는 항목은 승인 창에 없습니다.
• 내용을 확인하고 비밀정보가 없을 때만 승인하고 보내기를 누릅니다. 보내고 싶지 않으면 거부를 누릅니다.
• 다른 도구도 데이터를 바꿀 수 있는 경우에는 같은 방식으로 승인하고 실행 또는 거부를 묻습니다.

8. 버그 신고

evo를 쓰다 생긴 문제를 올리고, 내가 올린 버그의 처리 상태와 처리 결과를 봅니다. 관리자가 켠 경우 계정 메뉴에 버그 신고가 보이며, SSO(OIDC) 계정으로 로그인했을 때만 쓸 수 있습니다.

내 버그 보기

내가 올린 버그가 최근 순으로 나옵니다. 상태는 접수(아직 확인 전), 확인 중, 처리 끝 셋입니다. 처리가 끝나면 처리한 쪽이 남긴 메모가 함께 보입니다. 올린 버그를 내가 취소하는 기능은 없습니다. 잘못 올렸다면 처리하는 쪽이 메모와 함께 닫습니다.

버그 올리기

1. 분류를 고릅니다. 기본은 웹 채팅이고, 다른 제품(관리자가 연 분류 안에서 evo CLI·에뮬레이터·Mac 앱·Windows 앱·dispatch 등)이라고 생각되면 그 분류를 고릅니다.
2. 제목과 본문(Markdown)을 씁니다.
3. 화면 캡처를 최대 3장 붙일 수 있습니다(붙여넣기 또는 파일 선택, PNG·JPEG·WebP). 1MiB가 넘는 이미지는 자동으로 줄여서 올라갑니다. 올리기 전에 미리보기가 보이니, 캡처에 비밀정보나 다른 사람의 개인정보가 찍히지 않았는지 확인하세요.
4. 올리기를 누르면 그 분류를 맡은 쪽이 봅니다. 올린 쪽에는 처리하는 쪽의 신원이 보이지 않습니다. 비밀정보는 넣지 마세요.

자주 묻는 질문

로그인했는데 “접근 권한이 없습니다”가 나와요. : 계정이 user나 admin 그룹에 속해 있지 않은 경우입니다. 관리자에게 그룹 소속을 요청하세요.

원하는 모델이 목록에 없어요. : 관리자가 내 계정·그룹에 허용한 모델만 보입니다. 관리자에게 허용 모델을 요청하세요.

작업 요청 표시나 버그 신고가 안 보여요. : 관리자가 evo-dispatch 연동을 켜야 보이며, 작업 요청과 버그 신고는 SSO 계정에서만 쓸 수 있습니다.

“이번 달 사용 금액 한도에 도달해 채팅할 수 없습니다”가 나와요. : 관리자가 정한 월 사용 금액 한도를 다 쓴 경우입니다. 다음 달이 되면 다시 쓸 수 있으며, 급하면 관리자에게 한도 조정을 요청하세요.

파일을 올리고 싶어요. : 입력창 왼쪽 아래 **+**를 누르거나 입력창에 파일을 끌어 놓거나 붙여 넣으세요. 글 없이 파일만 보내면 “첨부한 파일을 확인해 주세요.“가 질문으로 나갑니다. 한도(파일 하나·대화 합계)는 관리자가 정하며, 넘는 파일은 올리기 전에 막힙니다.

작업 공간이 보이지 않아요. : 관리자가 작업 공간 기능을 켜고 내 역할에 workspace 권한을 줘야 보입니다. 계정 메뉴의 내 작업 공간이 없거나 설정의 작업 공간 탭에 기능이 꺼져 있다는 안내가 나오면 관리자에게 요청하세요.

작업 공간에서 clone·push가 안 돼요. : GitLab 토큰이 필요합니다. 설정 → 작업 공간에서 내 GitLab 토큰을 등록하거나, 관리자에게 서버 공용 토큰 설정을 요청하세요. 보호 브랜치(main 등)에는 push할 수 없고, 대화 작업 브랜치는 chat/<대화 id>입니다.

더 보기

• 설치와 첫 화면 사용법은 Evo Chat 시작하기에 있습니다.
• 조직·모델·작업 공간 설정은 Evo Chat 관리자 설명서를 보세요.
• 버전별 바뀐 점은 릴리스 노트에 있습니다.
• 작업 요청과 버그 신고를 연결하는 서버는 Evo Dispatcher 시작하기를 보세요.