문서
시작하기
Conduit는 데스크톱 애플리케이션입니다. 로그인해서 쓰는 호스팅 버전은 없으며, 여러분의 컴퓨터에서 여러분의 제공업체 키로 직접 실행합니다.
설치
설치 프로그램은 GitHub Releases 페이지에 있습니다. 최신 릴리스가 Windows, macOS, Linux용 현재 빌드입니다. 이미 toolchain이 갖춰진 환경이라면 소스에서 빌드하는 데도 대략 5분 정도 걸립니다.
사전 요구 사항
| 요구 사항 | 버전 | 비고 |
|---|---|---|
| Node.js | 20 | CI가 기준으로 삼는 버전 |
| pnpm | 10.34.4 | 고정 버전이며, 가장 쉬운 방법은 corepack enable입니다 |
| Rust | stable | rustup으로 설치하고 rustfmt, clippy 포함 |
| Visual Studio 2022 Build Tools | — | Windows에서만 필요, 네이티브 컴파일용 |
Windows에서는 저장소에 포함된 check-setup.ps1가 이 네 가지를 모두
확인하고, 무엇이 빠졌는지 알려 줍니다.
빌드 및 실행
git clone REPO_URL conduit
cd conduit
pnpm install
pnpm dev
pnpm dev는 Vite 개발 서버를 시작한 뒤 데스크톱 셸을 실행합니다.
첫 Rust 빌드는 시간이 좀 걸리지만, 이후 빌드는 점진적으로 빨라집니다.
| 명령어 | 설명 |
|---|---|
pnpm dev | 개발 모드로 앱 실행 |
pnpm build | 현재 플랫폼용 네이티브 설치 프로그램 생성 |
pnpm check | TypeScript 워크스페이스 타입 검사 |
지원 플랫폼
- Windows 10 / 11 — x86_64, NSIS 설치 프로그램, 관리자 권한 불필요
- macOS 11 Big Sur 이상 — Apple silicon과 Intel용 유니버설 바이너리
- Linux — Ubuntu 20.04+에서
.deb또는 AppImage 제공, 그 외 배포판은 best-effort
첫 번째 대화
Conduit는 모델에 도달할 방법이 준비되기 전에는 채팅을 시작할 수 없습니다. 첫 실행 시 온보딩에서 제공업체를 고르고 자격 증명을 입력하라는 안내가 나옵니다.
호스팅형 제공업체 사용
- 설정 → 공급자 및 키를 엽니다 (⌘,).
- 원하는 제공업체를 선택하고 API 키를 붙여 넣습니다.
- Conduit는 해당 제공업체에서 가져온 모델 목록에서 모델을 선택합니다.
키는 Windows Credential Manager, macOS Keychain, Linux Secret Service 같은 운영체제 자격 증명 저장소에 들어갑니다. Settings에는 값이 아닌 참조만 저장됩니다. 키체인이 없는 환경에서는 명시적으로 opt-in하는 암호화 파일 기반 저장소도 사용할 수 있습니다.
키 없이 로컬 모델 사용
Ollama 또는 LM Studio를 설치하고 모델을 받아온 뒤, Settings에서 해당 제공업체를 선택하세요. 자격 증명은 필요 없고 어떤 정보도 컴퓨터 밖으로 나가지 않습니다. 여기에 클라우드 제공업체를 아예 거부하는 로컬 전용 모드를 함께 쓰면 Conduit는 인터넷 요청을 전혀 보내지 않습니다.
이미지와 문서는 + → 파일 첨부…, 붙여넣기, 또는 대화로 드롭해서 첨부할 수 있습니다. 채팅에서는 대화 어디에 드롭해도 첨부되고, 그 밖의 화면에서 드롭하면 파일이 Documents에 추가됩니다. 이미지는 이미지를 받는 모델로 전달됩니다. PDF, Word, Excel, 텍스트, Markdown, CSV, HTML 파일은 기기에서 추출한 텍스트로 모든 모델에 전달됩니다. PDF를 직접 읽는 모델(Claude, OpenAI, Gemini, 그리고 파일 입력을 지원한다고 표시된 OpenRouter 모델)에는 PDF 자체도 함께 전달되므로 차트와 스캔한 페이지도 반영됩니다. 각 첨부 파일에는 어떻게 전송될지, 또는 전송되지 않는 이유가 표시됩니다.
어떤 메시지든 수정해 다시 보낼 수 있습니다. 가장 최근 메시지를 수정하면 그 자리에서 바로 바뀌지만, 그보다 이전 메시지를 수정하면 그 지점부터 새 대화가 포크되고 원본은 그대로 남습니다. 대화는 Markdown 또는 JSON으로 내보낼 수 있습니다.
다시 시도해도 모든 답변이 남습니다. 마지막 답변을 다시 시도하면 이전 답변이
버전으로 남고, 답변 아래의 ‹ 2 / 3 › 전환기로 버전 사이를 오갈 수 있습니다.
대화는 지금 표시된 버전에서 이어집니다. 이전 답변은 버전을 보여 주기만 하고 전환할 수는
없습니다. 그 뒤의 메시지가 지금의 답변을 바탕으로 쓰였기 때문입니다.
다시 시도 옆의 화살표는 모델 메뉴를 엽니다. 고른 모델이 마지막 질문에
다시 답하며, 그 답변에만 적용되고 대화의 모델은 그대로입니다. 명령 팔레트에도
다른 모델로 다시 시도…가 있습니다. 전환기 옆의 비교는
오른쪽 패널에 버전들을 나란히 열어, 각 버전을 쓴 모델과 답변, 비용을 보여 줍니다.
이 버전 사용은 마지막 답변으로 쓸 버전을 고르고,
이 버전에서 분기는 어느 버전에서든 이어지는 새 대화를 시작합니다.
잘린 답변 이어가기. 답변이 출력 한도에서 멈추면 그 아래 안내에 계속 버튼이 나타납니다. 모델은 멈춘 곳에서 이어서, 같은 메시지 안에 답을 이어 쓰며, 내가 새 메시지를 보낼 필요는 없습니다. 모든 제공업체에서 동작합니다.
모델 메뉴는 검색 필드와 함께 열립니다. 입력하면 모든 제공업체의 목록이 좁혀지고, Enter를 누르면 첫 번째 일치 항목이 선택됩니다. 각 제공업체의 모델은 알파벳순으로 나열됩니다. 대화 설정과 Settings → Chat defaults에 있는 추론 강도는 자동, 낮음, 보통, 높음 중에서 고릅니다. 강도를 낮추면 추론 모델이 더 빨리 답하고 비용도 줄며, 자동은 모델의 기본값을 그대로 둡니다. 이 값은 지원하는 모델에만 전송되며, OpenAI, OpenRouter, Anthropic, Gemini에 대해 매핑됩니다.
Settings → 사용량 및 비용은 추정 비용과 토큰을 일별, 모델별로 차트로 보여 주며, 리서치 실행과 워크플로 단계를 포함한 모든 모델 호출을 집계합니다. 가격은 직접 지정한 값이 가장 먼저, 그다음 OpenRouter가 해당 모델에 표시한 가격, 그다음 각 릴리스에 포함된 models.dev 카탈로그 스냅샷 순으로 적용됩니다. 가격을 알 수 없는 모델은 $0으로 표시하지 않고 알 수 없다고 표시합니다. 같은 페이지에서 오늘의 추정 지출이 직접 정한 금액을 넘으면 알림을 받을 수도 있습니다. 기본값은 꺼짐이며, 금액을 넘긴 답변 뒤에 하루에 최대 한 번만 표시되고 아무것도 중단시키지 않습니다. 날짜는 사용량 차트와 같게 UTC를 따릅니다.
지원 제공업체
기본 제공되는 제공업체는 23곳입니다. OpenAI 호환 엔드포인트도 그 안에 포함되며, 별도로 추가되는 것이 아닙니다. SambaNova, DeepInfra, Novita AI는 가격을 공개하므로 해당 모델에는 비용이 표시됩니다.
| 제공업체 | 자격 증명 | Base URL |
|---|---|---|
| Anthropic | API 키 | 변경 가능 |
| OpenAI | API 키 | 변경 가능 |
| Google Gemini | API 키 | 고정 |
| xAI | API 키 | 변경 가능 |
| Z.ai | API 키 | 변경 가능 |
| Moonshot AI | API 키 | 변경 가능 |
| Qwen | API 키 | 변경 가능 |
| MiniMax | API 키 | 변경 가능 |
| Cerebras | API 키 | 변경 가능 |
| SambaNova | API 키 | 변경 가능 |
| DeepInfra | API 키 | 변경 가능 |
| Novita AI | API 키 | 변경 가능 |
| NVIDIA NIM | API 키 | 변경 가능 |
| DeepSeek | API 키 | 고정 |
| Mistral | API 키 | 고정 |
| Groq | API 키 | 고정 |
| Together AI | API 키 | 변경 가능 |
| Fireworks AI | API 키 | 변경 가능 |
| OpenRouter | API 키 | 고정 |
| OpenCode Zen | API 키 | 고정 |
| Ollama | 없음 — 로컬 | 변경 가능 |
| LM Studio | 없음 — 로컬 | 변경 가능 |
| 모든 OpenAI 호환 엔드포인트 | 선택 사항 | 변경 가능 |
마지막 행은 vLLM, LiteLLM 같은 자체 호스팅 게이트웨이는 물론, 아직 전용 어댑터가 없는 제공업체도 포함합니다. Conduit에 base URL을 주고, 엔드포인트가 요구한다면 키도 함께 제공하면 됩니다.
GPT, Claude, Grok, GLM, Kimi 등 추가하기
Conduit는 2026년 현재 실제로 많이 쓰이는 모델 계열 — GPT, Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, MiniMax — 과 연결됩니다. 원하는 모델에 따라 다음 세 가지 경로 중 하나를 사용하면 됩니다.
- 내장 어댑터. Anthropic, OpenAI, Gemini, xAI, Z.ai, Moonshot AI, Qwen, MiniMax, DeepSeek, Mistral, Groq, Together AI, Fireworks AI, Cerebras, SambaNova, DeepInfra, Novita AI, NVIDIA NIM은 각각 전용 제공업체를 갖고 있습니다. 선택하고 키를 붙여 넣은 뒤 모델 목록을 불러오면 됩니다. 이 경로만으로 Claude, GPT, Gemini, Grok, GLM, Kimi, Qwen, MiniMax, DeepSeek를 바로 다룰 수 있습니다. 각각 자체 기본 엔드포인트를 갖고 있어 base URL을 따로 찾을 필요가 없습니다.
- 게이트웨이. OpenCode Zen이나 OpenRouter는 그 서비스가 현재 제공하는 모든 것을 하나의 키 뒤에서 카탈로그화합니다. Conduit는 고정된 카탈로그가 아니라 실시간 목록을 가져옵니다.
- 모든 OpenAI 호환 엔드포인트. 전용 어댑터가 없는 제공업체나 vLLM, SGLang 같은 자체 호스팅 프록시라면, OpenAI 호환 제공업체를 해당 엔드포인트의 base URL로 지정하고 필요하다면 키도 제공하세요.
Qwen의 내장 어댑터는 기본적으로 DashScope의 국제 엔드포인트를 사용하고, Moonshot은
기본적으로 api.moonshot.ai를 사용합니다. 다른 지역이 필요하다면 두 값 모두
수정할 수 있습니다.
키보드 단축키
Windows와 Linux에서는 ⌘ 대신 Ctrl을 사용하세요.
| 단축키 | 동작 |
|---|---|
| ⌘K | 명령 팔레트 — 검색, 명령, 모델, 아티팩트 |
| ⌘1–⌘9 | 홈, 채팅, 슬라이드, 글쓰기, 앱, 워크플로, 받은 편지함, 에이전트, 컨텍스트로 이동 |
| ⌘N | 새 대화 |
| ⌘, | Settings |
| ⌘/ | 이 단축키 시트 열기 |
| ⌘\ | 사이드바 전환 |
| ⌘J | 문서 패널 전환 |
| ⌘⇧E | 아티팩트 패널 확장, 또는 레이아웃 복원 |
| ⌘⇧P | 제공업체 전환 |
| ⌘⇧W | 이번 턴의 웹 검색 전환 |
| ⌘⇧F | 이 지점에서 대화 포크 |
| ⌘⇧C | 마지막 어시스턴트 메시지 복사 |
| Esc | 패널 닫기 또는 실행 중인 응답 중단 |
명령 팔레트는 모달 방식입니다. 명령은 >, 아티팩트는 @,
모델은 /를 입력하고, 평문을 입력하면 지금까지 보낸 모든 메시지를 검색합니다.
Settings에도 자체 검색창이 시트 상단에 있어서, 섹션을 뒤질 필요 없이 이름으로 바로 특정
설정으로 이동할 수 있습니다.
도구와 커넥터
기본 내장 도구
다음 도구들은 별도 설정이 필요 없습니다:
- 웹 검색과 fetch — Auto / 호스팅형 / 로컬 백엔드(기본값은 키가 필요 없는 Exa, Tavily, Brave, SearXNG, DuckDuckGo, 호스팅형 검색은 Anthropic, OpenAI, Gemini, OpenRouter), 도메인 허용·차단 목록, 인라인 번호 인용
- 문서 작성 — HTML, Markdown, 텍스트 아티팩트 생성 및 수정, 내보내기
- 클립보드 — 시스템 클립보드 읽기 및 쓰기
- 유틸리티 — 계산기, 현재 시간, UUID, 난수
도구는 읽기 전용으로 표시되어 있지 않은 한 실행 전에 확인을 요청합니다. 내장 읽기 전용 도구는 자동으로 실행되고, 커넥터의 도구는 서버가 읽기 전용으로 표시한 경우에만 자동으로 실행됩니다. 그 밖의 도구는 실행 전에 확인을 요청합니다. 웹 검색은 기본적으로 꺼져 있으며 처음 사용할 때 동의를 구합니다. 호스팅형 검색은 Anthropic, OpenAI, Gemini의 공식 엔드포인트에서만 동작하며, 제공업체에 커스텀 base URL을 지정하면 위의 로컬 백엔드로 대체됩니다.로컬 검색 백엔드로 보내는 쿼리는 해당 서비스로 전송됩니다. 기본값인 Exa는 자체 약관에 따라 쿼리를 보관할 수 있습니다.
모델의 페이지 가져오기는 공개 https 사이트에만 닿습니다. localhost나 사용자 네트워크 안의 주소에는 닿지 않으며, 모든 리디렉션을 확인합니다. 원본 HTML 대신 페이지의 제목과 읽기 좋은 텍스트를 돌려주고, 최대 20MB의 PDF도 읽습니다. 텍스트가 없는 스캔 PDF는 읽을 내용이 없는 페이지로 취급됩니다.
MCP 커넥터
Conduit는 Model Context Protocol 서버를 감독되는 커넥터로 실행합니다. 커넥터 페이지에서 시작 명령과 인수를 지정해 로컬 프로세스를 추가하거나, streamable HTTP를 사용하는 원격 MCP 엔드포인트를 지정하면 됩니다.
커넥터의 도구는 서버가 읽기 전용으로 표시한 경우(표준 readOnlyHint 또는 Conduit 자체 필드인 permissionLevel)에만 묻지 않고 실행됩니다. 그 밖의 도구는 먼저 묻고, 승인은 한 채팅 동안 또는 항상 기억하도록 할 수 있습니다. 1.0.0-rc.6 이전에는 대부분의 서드파티 서버에서 도구가 묻지 않고 실행되었으므로, 이미 쓰고 있는 커넥터가 전에는 조용히 실행되던 도구에 대해 이제 확인을 요청할 수 있습니다.
런타임은 비정상 종료된 로컬 서버를 백오프와 함께 재시작하며, 5분 안에 최대 세 번까지로 제한합니다. 동시성도 제한하고 개별 호출은 30초에서 타임아웃됩니다. 도구 출력은 모델에 전달되기 전에 크기가 제한되고 민감한 내용은 가려지며, 구조적 가드가 이 출력이 지시문처럼 재사용되지 않도록 막습니다 — 도구 결과를 거치는 표준적인 prompt injection 경로입니다.
stdio와 원격 streamable HTTP가 현재 제공됩니다.
레거시 HTTP+SSE는 지원하지 않습니다.
composer는 커넥터의 도구뿐 아니라 prompt와 resource도 끌어올 수 있습니다. prompt 선택기는 prompt가 선언한 인수를 채운 뒤 composer에 넣어 편집할 수 있게 하고, resource 선택기는 다음 메시지에만 콘텐츠를 첨부합니다. 동의는 커넥터마다 한 번 요청되며, 지시를 몰래 끼워 넣으려는 resource는 조용히 따르는 대신 거부되고 이름이 표시됩니다.
컨텍스트 → 커넥터에서는 실행 중인 커넥터의 각 도구가 스스로 밝힌 성격을
보여 줍니다. 읽기만 하는지, 무언가를 변경하는지, 항상 묻는지입니다. 아무것도 밝히지 않은
도구는 호출할 때마다 묻습니다. 조회만 한다고 믿는 도구는 읽기만 함을
체크하면 채팅, 에이전트, 워크플로에서 묻지 않고 실행됩니다. 무언가를 변경한다고 밝혔거나
민감한 도구는 계속 묻습니다. 한 채팅에서 제공할 커넥터 도구가 20개를 넘거나 설명이
길어지면, 모델에는 전체 목록 대신 search_tools 도구가 주어지고 모델이
찾은 도구를 그 턴에만 불러옵니다. 도구가 그보다 적으면 달라지는 것은 없고 승인도 전과
같이 동작합니다. 메시지에 커넥터 이름을 적으면 그 커넥터의 도구는 바로 제공됩니다.
내 컴퓨터에서 서버를 연결하는 것은 문서의 문제입니다. 그 서버를 고객 앞에 놓는 것은 — JSON 설정 없이, Claude Desktop 안에 나타나지 않으면서 — 다른 문제입니다. MCP 서버를 고객에게 시연하는 방법에서는 호스팅형 챗, 설정 파일을 쓰는 Claude Desktop, 그리고 데스크톱 클라이언트 배포를 비교합니다.
에이전트 루프
모델이 도구를 호출하면, Conduit는 이를 실행하고 같은 턴 안에서 다음 라운드를 위해 결과를 다시 모델에 전달합니다. 설정 → 에이전트에서 한계를 조정할 수 있습니다. 최대 단계 수는 1~50, wall-clock 예산은 30초~30분입니다. 채팅 UI는 단순한 스피너 대신, 여러 라운드에 걸쳐 사고·도구 호출·텍스트가 실제로 일어난 순서대로 배치된 실시간 진행 타임라인을 경과 시간과 함께 보여주고, 라운드가 멈춰 있으면 그 사실도 알려줍니다.
나의 에이전트
에이전트 페이지에서 에이전트를 한 번 만들어 두면 — 이름, 지침, 모델, 도구, 일을 넘길 수 있는 에이전트, 토큰 한도 — 채팅, 모든 워크플로, 또는 일정에서 쓸 수 있습니다. 워크플로는 에이전트를 참조로 가지므로 에이전트를 고치면 어디서나 바뀝니다. 에이전트를 삭제하면 그것을 쓰던 각 워크플로가 자기만의 사본을 받습니다. 새 프로필에는 리서처, 작성자, 검토자, 데이터 분석가의 스타터 네 개가 들어 있습니다. 기억함으로 설정한 에이전트는 실행 사이에 자기만의 노트를 보관하며, 편집기에서 보고 고칠 수 있습니다. 읽음을 켜면 내가 고른 지식 컬렉션을 검색할 수 있습니다.
채팅에서는 메시지 입력란에 @를 입력해 그 턴에 쓸 에이전트를 고르거나, 에이전트
카드의 질문하기를 누르세요. 설정 → 에이전트에서는 어시스턴트가
일을 넘길 수 있는 에이전트를 고릅니다. 넘겨진 일은 각각 그 에이전트 자신의 모델에서 실행되고,
답변 안에 상태, 토큰, 비용, 시간이 담긴 한 줄로 표시됩니다. 답변 아래의 도우미는
모델별 토큰과 비용을 합산합니다. 한 번에 넘겨진 여러 일은 동시에 실행되며 — 기본 3개, 설정 → 에이전트에서 1~4개 — 내 컴퓨터를 쓰거나 커넥터로 작업을 하는 것처럼 무언가를 변경하는 도우미는
여전히 한 번에 하나씩 일합니다.
넘겨진 일을 클릭하면 그 에이전트가 하는 일을 지켜볼 수 있습니다. 작업, 도구 호출, 토큰, 비용이 보입니다. 중지는 그 도우미만 멈추고, 방향 바꾸기(또는 메시지 입력란)은 작업 중인 도우미에게 새 지시를 보냅니다. 에이전트 카드의 일정에 따라 실행…으로 매일, 평일마다, 몇 시간마다, 또는 피드나 폴더에 새 내용이 생겼을 때 할 작업을 줄 수 있습니다. 각 답변은 결과에 쌓이고 알림을 켤 수도 있으며, 워크플로로 바꾸기를 누르면 루틴이 직접 편집할 수 있는 일반 워크플로가 됩니다. 문서 패널의 ⋯ 메뉴에서는 채팅 안의 HTML, Markdown, 텍스트 문서를 검토자 에이전트에게 보낼 수 있으며, 문제를 찾으면 채팅이 같은 문서를 고쳐 씁니다.
아티팩트
문서, 스크립트, 작은 웹페이지 같은 긴 출력은 메시지 스크롤을 채우는 대신 대화 옆 패널에서 열립니다. Conduit는 텍스트, 구문 강조가 적용된 코드, 접을 수 있는 JSON 트리, Markdown(Mermaid 다이어그램과 KaTeX 수식 포함), 인터랙티브 HTML을 렌더링합니다.
인터랙티브 HTML은 스크립트만 허용하는 샌드박스 프레임에서 실행됩니다. same-origin 접근,
팝업, 최상위 탐색은 허용되지 않습니다. 폼은 여전히 동작합니다 — Conduit가 페이지에
submit 이벤트를 전달할 뿐, 제출한다고 해서 어디로도 전송되지는 않습니다. 주입되는
콘텐츠 정책은 connect-src 'none'을 설정하므로, 페이지가 스스로 fetch를
하거나 소켓을 열 수 없으며, Conduit는 페이지를 자체 샌드박스 주소에서 제공합니다.
페이지는 애플리케이션 자체의 명령을 호출할 수 없습니다. 한 가지 예외가 있는데, macOS의
알려진 문제입니다. macOS에서는 페이지의 스크립트가 여전히 WebRTC 연결을 열 수
있으며, 콘텐츠 정책은 이를 막지 못합니다. Windows와 Linux는 웹뷰에서 이를 차단합니다. 특정
호스트의 이미지나 폰트를 로드해야 한다면 Settings → Privacy & data의 Artifact
Security에서 직접 범위를 넓힐 수 있습니다.
실시간 데이터 — 환율, 날씨 같은 것 — 이 필요한 페이지는 여전히 요청할 수 있습니다.
페이지의 fetch() 호출은 Conduit로 전달되며, 처음 보는 사이트에 대한 요청은
Conduit가 붙잡아 두고 그 사이트 이름을 담은 배너를 보여줍니다. 그 사이트를 한 번만
허용하거나, 이 페이지에서 항상 허용하거나, 아예 허용하지 않거나, 페이지가 어떤 공개
사이트에든 접근하도록 허용할 수 있습니다. 그 뒤 요청은 Conduit가 직접 보냅니다 — https만
허용되고, 쿠키나 자격 증명은 포함되지 않으며, 로컬이나 사설 주소는 제외되고, 타임아웃은
20초, 응답 크기는 5MB, 페이지당 분당 120회로 제한됩니다. 페이지의 지구본 버튼을 누르면
그 페이지가 요청한 모든 사이트와 실제로 보낸 모든 요청이 표시됩니다. 권한은 그 페이지
하나에만 속하며, 페이지를 삭제하면 함께 사라집니다. 로컬 전용 모드는 이 전부를
거부하며, 같은 Artifact Security 설정에 있는 페이지의 인터넷 연결 허용을
끄면 직접 막을 수도 있습니다.
대화에 코드 펜스로 감싼 블록을 붙여 넣으면 Conduit는 이를 아티팩트로 승격할지 제안합니다. 아티팩트는 선택형 메타데이터 sidecar와 함께 디스크로 내보낼 수 있습니다.
각 아티팩트는 현재 페이로드 하나만 보관합니다. 버전 기록은 없으므로, 복사본을 남기고 싶은 내용은 편집 전에 내보내는 것이 좋습니다.
문서
사이드바의 Documents에서 컬렉션을 만들고 파일을 추가하세요. 일반 텍스트, Markdown, CSV, HTML, Word(.docx), Excel(.xlsx), PDF를 지원합니다. HTML 파일은 Conduit가 페이지의 제목과 텍스트를 읽고 스크립트, 스타일 등 코드는 제외합니다. 채팅 밖에서 창의 어디에든 파일을 드롭해서 추가하거나, composer에서 컬렉션 전체를 단일 대화에 첨부할 수도 있습니다. 답변은 근거로 삼은 파일을 클릭 가능한 칩으로 보여주며, 클릭하면 정확한 구절을 확인할 수 있습니다.
파일이 하나뿐인가요? 컬렉션 대신 메시지에 첨부하세요. + → 파일 첨부…, 붙여넣기, 또는 대화로 드롭하면 됩니다. 아무것도 색인되지 않고 임베딩 제공업체도 관여하지 않습니다. 모델은 기기에서 추출한 문서 텍스트를 받으며, PDF를 읽는 모델은 PDF 자체도 받습니다. 어느 쪽이든 내용은 메시지의 일부로 선택한 채팅 제공업체로 전송됩니다. Ollama나 LM Studio를 선택하면 내 기기 밖으로 나가지 않습니다. 20MB를 넘는 PDF는 텍스트만 전송되고, 긴 문서의 텍스트는 150,000자에서 잘립니다.
각 컬렉션은 OpenAI, Gemini, OpenRouter, Ollama 중 하나의 제공업체로 임베딩됩니다 (Anthropic은 임베딩할 수 없습니다). 색인 작업은 문서 전체 텍스트를 해당 제공업체로 보내므로, Conduit는 처음 사용할 때 동의를 구하고 제공업체별로 그 답을 기억하며, 나중에 문서 페이지에서 철회할 수 있습니다. Ollama를 선택하면 아무것도 기기 밖으로 나가지 않습니다 — 로컬 전용 모드에서는 이 선택이 강제됩니다. 검색 자체는 하이브리드 방식으로, 같은 로컬 SQLite 데이터베이스에서 벡터 유사도 검색과 키워드 검색을 결합하며, 검색된 구절은 여전히 대화에 응답하는 제공업체로도 전달됩니다.
파싱은 기기에서 이루어지며 OCR 단계가 없어서, 텍스트 레이어가 없는 스캔 PDF는 아무것도 만들어내지 못합니다 — 그런 경우 Conduit는 빈 문서를 가져오는 대신 그 사실을 알려줍니다. 대신 메시지에 첨부하면, PDF를 읽는 모델은 PDF 자체를 받으므로 스캔 PDF도 읽을 수 있습니다.
프로젝트
프로젝트의 모든 채팅에 같은 지침, 문서, 스킬을 적용하세요. 채팅 목록의 프로젝트는 채팅을 1단계로 묶으며 중첩은 없습니다. 설정이 없는 프로젝트는 그냥 폴더입니다. 프로젝트의 ⋯ 메뉴에는 여기에 새 채팅, 프로젝트 설정, 이름 바꾸기, 삭제가 있습니다. 삭제는 먼저 확인을 받으며, 채팅은 지우지 않고 프로젝트 밖으로 옮깁니다. 프로젝트 설정에서는 다음을 정합니다.
- 지침 — 프로젝트의 모든 채팅이 알아야 할 내용.
- 문서 — 프로젝트의 모든 채팅에서 검색하는 컬렉션. 이 프로젝트용 새 컬렉션은 프로젝트 이름으로 컬렉션을 만들며, 파일은 문서에서 추가합니다.
- 스킬 — 프로젝트의 모든 채팅에서 켜집니다.
- 작업 폴더 — 프로젝트의 새 채팅은 이 폴더에서 시작하므로 모델이 작업 공간 도구로 그 안의 파일을 읽고 쓸 수 있습니다. 먼저 동의해야 하고, 접근은 그 폴더 안으로 제한되며, 셸은 없습니다. 폴더에
AGENTS.md가 있으면 모든 메시지와 함께 전송됩니다.
프로젝트는 설정을 대체하지 않고 그 위에 더해집니다. 지침은 각각 라벨이 붙은 채로 설정, 프로젝트, 채팅 자체의 순서로 쌓입니다. 컬렉션과 스킬은 프로젝트의 것에 채팅이 추가한 것을 더한 것입니다. composer에서는 프로젝트 칩으로 채팅이 어느 프로젝트에 있는지 알 수 있고, 채팅 설정 팝오버는 그 채팅이 설정과 프로젝트에서 추가로 쓰는 항목을 보여줍니다. 프로젝트 설정은 메시지를 보낼 때 읽으므로, 프로젝트를 고치면 그 안의 모든 채팅에 적용되고, 채팅을 프로젝트에 넣거나 빼면 다음 메시지부터 적용됩니다. 예외는 작업 폴더입니다. 채팅을 만들 때 복사되므로, 이미 프로젝트에 있는 채팅은 원래 폴더를 유지합니다.
이미지 생성
OpenAI, Gemini, OpenRouter는 대화 안에서 바로 이미지를 생성할 수 있습니다. 각 이미지는 제공업체가 과금하므로 Conduit는 첫 이미지를 만들기 전에 한 번 동의를 구합니다. 이미지 생성에 대해 이야기하는 것만으로는 이 확인이 발생하지 않습니다. 결과물은 제공업체에서 링크되는 대신 아티팩트로 로컬에 저장되어 만료되지 않습니다.
개인 앱
간직할 만한 페이지는 개인 앱으로 저장할 수 있습니다. 페이지의 ⋯ 메뉴에서 앱으로 저장을 고르면 복사본이 만들어지고, 이를 탐색 모음의 앱이나 새 채팅 화면의 내 앱에서 열 수 있습니다. 복사본은 채팅을 삭제해도 계속 동작합니다. 저장할 때는 페이지의 사이트 권한 중 무엇을 유지할지 하나씩 묻고, 체크하지 않은 권한은 유지하지 않습니다. 나중에 채팅의 페이지가 바뀌면 앱에 업데이트가 표시됩니다. 기본 내장 스타터 앱이 8개 있으며, 앱 페이지에서 추가하거나 앱이 딸린 아이디어에서 앱 열기를 누르면 됩니다.
페이지(앱이든 채팅 속 페이지든)는 Conduit가 각각 확인하는 세 가지를 더 선언할 수 있습니다. 실행 사이에 데이터를 보관할 수 있습니다 — 페이지당 최대 5 MB이며, 나머지 데이터와 함께 저장되고 저장 시 암호화가 켜져 있으면 암호화됩니다. 데이터 지우기로 삭제할 수 있습니다. 도시 같은 몇 가지 설정을 받을 수 있으며, Conduit가 자체 폼으로 값을 묻고 페이지를 다시 로드하지 않은 채 실행 중인 페이지에 전달합니다. 그리고 해당 페이지에 허용한 뒤에는 AI 모델에 질문할 수 있습니다. 프롬프트에 제공업체 이름이 표시되고 텍스트가 기기 밖으로 나갈 때 알려 주며, 페이지는 텍스트를 보내고 텍스트를 받을 뿐 도구, 채팅 기록, 메모리, 문서에는 접근하지 못합니다.
각 개인 앱에는 자체 설정 페이지가 있습니다(앱 헤더의 톱니바퀴 또는 ⋯ → 설정). 어떤 모델이 답하는지, 하루 토큰 수와 클라우드 모델의 하루 한도(기본 100,000, 내 컴퓨터의 모델은 제한 없음), 저장된 데이터(키별로 보기, 내보내기와 지우기), 사용할 수 있는 사이트와 제공업체, 그리고 한 주 분량의 한 줄짜리 활동 기록을 볼 수 있습니다. 프롬프트, 응답, 저장된 값은 기록되지 않습니다.
슬라이드
이야기를 설명하거나 아무 채팅에서나 프레젠테이션을 요청하면, Conduit가 승인할 수 있는 스토리라인을 작성한 뒤 하나의 라이브 덱을 만듭니다. 모든 변경은 새 복사본을 만드는 대신 그 덱을 직접 수정합니다. 덱은 가운데에 큰 슬라이드, 옆에 채팅이 있는 스튜디오에서 열립니다. 변경을 요청하면 어시스턴트가 슬라이드 한 장을 수정하거나, 덱 전체에서 단어 하나를 바꿉니다.
부품으로 조립합니다. 어시스턴트는 슬라이드의 HTML을 쓰지 않습니다. 레이아웃을 고르고 그 부품 — 제목, 요점, 레이블이 붙은 숫자, 열, 인용문 — 을 채우면 Conduit가 테마에 맞춰 슬라이드를 배치합니다. 자리에 비해 너무 긴 텍스트는 슬라이드가 만들어지기 전에 무엇을 줄여야 하는지와 함께 어시스턴트에게 돌려보내집니다. 어떤 레이아웃도 맞지 않는 슬라이드를 위한 자유 형식 레이아웃도 남아 있습니다. 그래도 맞지 않는 텍스트는 겹치거나 슬라이드 밖으로 나가는 대신, 읽을 수 있는 크기까지 한 단계씩 줄어듭니다. 내보낸 HTML과 PDF는 화면에서 보는 모습과 같습니다.
내 숫자로 만드는 차트. 막대, 선, 깔때기 차트는 어시스턴트가 준 데이터로 Conduit가 직접 그립니다. 축은 0에서 시작하고, 막대는 비율에 맞으며, 레이블은 겹치지 않고, 크기는 방 뒤쪽에서도 읽을 수 있습니다. 전체 너비 차트 레이아웃은 차트에 슬라이드 전체를 줍니다. 어시스턴트가 직접 그린 다이어그램은 너무 작은 레이블이 없는지 확인합니다.
변경할 때마다 레이아웃 점검. 어시스턴트가 슬라이드를 바꾸면 Conduit가 렌더링된 모습을 확인합니다. 텍스트가 넘치거나, 겹치거나, 각주에 바짝 붙거나, 다이어그램을 읽을 수 없으면 어시스턴트에게 바로 그 문제를 고칠 기회가 한 번 주어지고, 남은 문제는 메모로 표시됩니다. 직접 쓴 텍스트는 이 점검으로 바뀌지 않습니다. 이 점검은 그런 문제를 잡아낼 뿐, 잘 디자인된 슬라이드를 보장하지는 않습니다.
스크립트는 덱의 모든 글자를 하나의 문서로 보여 줍니다. 여기에서 입력하거나 슬라이드의 텍스트를 더블 클릭해 고칠 수 있습니다. 직접 쓴 텍스트는 어시스턴트가 슬라이드를 다시 써도, 그 텍스트를 바꿔 달라고 요청하지 않는 한 그대로 유지됩니다. 기록은 모든 변경마다 요청 내용으로 이름 붙인 버전을 남겨 언제든 복원할 수 있습니다. 테마는 두 가지가 기본 제공되며, 어시스턴트가 직접 디자인해 주는 테마도 쓸 수 있습니다.
발표는 덱을 전체 화면으로 열고, 별도의 발표자 보기(현재·다음 슬라이드, 발표자 노트, 타이머)는 슬라이드를 공유하는 동안에도 나만 볼 수 있습니다. 내보내기는 어떤 브라우저에서든 스스로 발표되는 단일 HTML 파일, 또는 PDF(Windows에서만)로 저장합니다. 슬라이드는 로컬 데이터베이스에 항목을 추가하므로, 슬라이드 이전 릴리스로 되돌아가면 빈 데이터베이스로 시작합니다(기존 파일은 백업으로 남습니다).
스프레드시트
예산표, 가격표, 대출 계산기처럼 숫자가 맞아떨어져야 하는 표를 요청하면 Conduit가 진짜 스프레드시트를 만들어 채팅 옆에 엽니다. 어시스턴트는 직접 계산한 숫자를 입력하지 않고 수식을 쓰며, 계산은 Conduit가 합니다. 숫자·통화·퍼센트·날짜 서식, 여러 시트, 고정된 머리글 행, 머리글·입력값·합계 스타일도 시트에 포함됩니다. 수식이 실패하면 어시스턴트가 오류(#NAME?, #REF!)를 바로 보고 고칩니다.
요청해서 바꾸기. 덱처럼 스프레드시트도 하나입니다. "보안 감사 행을 추가해 줘", "C열을 유로로 바꿔 줘", "월별 호스팅 비용 시트를 추가해 줘"라고 하면 새로 만드는 대신 그 스프레드시트를 고칩니다. 새 행은 위 행의 서식과 수식을 이어받고, 바로 위에서 끝나는 합계는 새 행을 포함하도록 늘어납니다. 금액은 요청한 통화로 들어갑니다. 그리드는 읽기용입니다. 셀을 클릭하거나 화살표 키로 이동하면 수식 입력줄에 수식이 보이고, 아래 탭으로 시트를 바꿉니다.
Excel로 가져오고 내보내기. 패널 메뉴의 Excel로 저장 (.xlsx)…은 Excel, Numbers, Google 스프레드시트에서 열리는 파일을 수식과 계산된 값까지 함께 저장합니다. 반대로 .xlsx 파일을 채팅에 첨부하거나 Documents에 추가하면 모델이 각 시트를 표로 읽습니다. 패널의 숫자는 앱 언어의 표기 방식대로 보입니다.
리서치
간단한 검색으로는 부족한 질문이라면 composer의 + 메뉴에서 리서치를 켜고(또는 홈에서 선택하고) 질문하세요. 웹 검색이 켜져 있어야 하며, 로컬 전용 모드에서는 쓸 수 없습니다. 리서치는 로컬 검색 백엔드(Exa, Tavily, Brave, 직접 운영하는 SearXNG, DuckDuckGo)를 사용하고 호스팅형 검색은 쓰지 않습니다. 검색 쿼리는 해당 서비스로, 페이지 텍스트는 선택한 채팅 제공업체로 전송됩니다.
개요. 무엇이든 실행하기 전에 리서치는 개요를 제안합니다. 답할 하위 질문 1~6개, 선택 사항인 범위, 그리고 깊이입니다. 이를 수정한 뒤 승인합니다. 깊이마다 어디까지 진행할 수 있는지가 정해집니다.
- 빠르게 — 최대 검색 8회, 페이지 15개, 10분
- 표준 — 최대 검색 20회, 페이지 40개, 20분
- 심층 — 최대 검색 50회, 페이지 100개, 40분
읽는 것. 페이지를 전체 내용으로, 한 번에 세 개씩 읽습니다. 웹 페이지와 최대 20MB의 PDF가 대상이며, 분석은 사용자 기기에서 이루어집니다. 스캔한 PDF에는 텍스트가 없어 읽을 내용이 없는 페이지로 취급됩니다. 긴 페이지나 PDF에서는 모델이 전체가 아니라 앞부분과 질문에 해당하는 부분을 봅니다.
인용 확인. 모델은 주장을 추려 내고, 각 주장에 페이지에서 뒷받침하는 정확한 문구를 붙입니다. 주장이 인정되려면 그 인용(20자 이상)이 저장된 해당 페이지 텍스트에 실제로 있어야 하며, 이 확인은 모델이 아니라 앱이 합니다. 그런 다음 아직 답이 없는 부분을 다시 검색하고, 작성기가 확인된 주장으로 보고서를 만듭니다. 번호가 붙은 인용과 출처 목록도 모델이 아니라 앱이 만듭니다.
출처 신뢰도. 각 페이지는 신뢰도가 평가됩니다. 신뢰도가 낮은 출처는 보고서의 출처 목록에 표시되고, 그 주장은 해당 출처의 주장으로 밝혀 쓰거나("검토되지 않은 프리프린트는 …라고 주장한다") 빠지며, 확립된 사실처럼 제시되지 않습니다. 공식 기관, 공공기관, 대학 사이트는 낮게 평가되지 않습니다. 평가는 모델의 판단이며, 위의 인용 확인은 앱이 합니다.
검토 단계. 보고서를 마무리하기 전에, 검토 단계가 모든 문장을 그 문장이 인용한 사실 및 보고서의 나머지 내용과 대조해, 뒷받침되지 않는 내용을 고치거나 삭제합니다. 리서치는 오늘 날짜를 알고 있으므로 "현재"는 지금을 뜻하고 이전의 일은 과거로 쓰입니다. 연도, 판, 정의, 단위에 따라 달라지는 수치는 불일치로 보고되는 대신 그 이유가 설명되며, 답하지 못한 하위 질문에는 페이지를 읽지 못한 사이트의 이름이 명시됩니다.
보고서. 결과는 채팅 문서에 저장되는 Markdown 문서입니다. 요약, 하위 질문별 발견, 남은 질문, 번호가 붙은 출처가 들어 있고 모든 발견에 인용이 달립니다. 채팅의 카드에는 요약과 인용·읽은 출처 수가 표시되고 보고서 열기 버튼이 있습니다. 중지하면 실행이 끝나고 그때까지 찾은 내용은 남습니다.
페이지는 명령할 수 없습니다. 페이지 텍스트는 도구가 없는 모델 호출에만 전달되므로, 지시를 끼워 넣으려는 페이지가 있어도 검색, 가져오기, 저장을 하게 만들 수 없습니다. 리서치의 모델 호출은 자체 숨겨진 대화에서 실행됩니다.
글쓰기
탐색 모음의 글쓰기(Ctrl+5, macOS에서는 ⌘5)는 블로그 글, 기술 문서, 보고서, 뉴스레터, 에세이 같은 긴 글을 위한 곳입니다. 탐색 모음, 홈의 글쓰기 타일, 또는 홈 입력 상자의 쓰기 칩에서 열고 무엇을 쓰는지 설명하세요.
먼저 개요. 어시스턴트가 개요를 제안합니다. 섹션, 각 섹션에서 말해야 할 내용, 목표 분량입니다. 섹션을 수정, 추가, 삭제하거나 순서를 바꾼 뒤 승인합니다. 그러면 어시스턴트가 대화 옆의 Markdown 편집기에 섹션별로 초안을 씁니다. 각 섹션은 쓰이는 대로 나타나며, 개요의 모든 섹션에 글이 채워질 때까지 초안은 계속됩니다.
출처. 출처 탭에서 초안은 웹에서 조사하거나(기본값은 꺼짐), Documents 컬렉션을 참고하거나, 완성된 리서치 보고서를 바탕으로 작업할 수 있습니다. 보고서를 쓰면 인용 확인을 거친 사실을 우선합니다. 대화에서 완료된 리서치 카드에는 이 보고서로 글쓰기가 있습니다. 출처에서 가져온 사실은 초안에 링크로 연결되며, 링크가 없는 내용은 지어내는 대신 [TODO]로 표시하도록 어시스턴트에게 지시되어 있습니다.
직접 쓴 글은 내 것으로 남습니다. 직접 입력하거나 바꾼 문단은 내 것으로 표시되고, 어시스턴트는 그 텍스트를 바꿔 달라고 요청하지 않는 한 한 글자도 바꾸지 않고 유지합니다. AI가 편집하도록 허용으로 어시스턴트에게 돌려줄 수 있습니다. 대화에서 변경을 요청하면 그 부분만 다시 쓰입니다. 텍스트를 선택하면 다시 쓰기, 짧게, 길게, 더 명확하게, 문법 수정, 또는 직접 쓴 지시를 사용할 수 있습니다. AI가 쓴 부분 표시는 어시스턴트가 썼고 아직 아무도 편집하지 않은 문단에 색을 입힙니다.
기록은 어시스턴트가 변경할 때마다, 그리고 내가 직접 편집한 뒤에도 버전을 남기며 어느 것으로든 복원할 수 있습니다. 내보내기는 초안을 Markdown 또는 HTML 파일로 저장합니다. 웹 페이지로 연결되는 링크가 있는 초안은 끝에 해당 페이지들의 출처 목록이 붙습니다.
[TODO] 표시는 모델이 한 일이므로 게시하기 전에 직접 확인하세요. 내보내기는 Markdown 또는 HTML만 지원합니다.
워크플로
워크플로 페이지는 반복 작업을 대신 실행합니다. 단계에서는 페이지 가져오기, 웹 검색, 리서치 실행, 문서 검색, 워크플로 전용 폴더에서 파일 읽기, CSV나 JSON을 표로 바꾸기, 커넥터의 읽기 전용 도구 호출, 모델의 요약, 질문하기를 할 수 있습니다. 결과는 문서로 저장하거나, 슬라이드 덱이나 글쓰기 초안을 업데이트하거나, 파일(Markdown, 텍스트, CSV, JSON, HTML)로 내보내거나, 기억으로 제안할 수 있습니다. '기억에 저장' 단계는 제안만 하며 스스로 추가하지 않습니다. 아침 브리핑, 페이지 모니터링, 주간 리서치 요약, 주간 수치 덱 같은 준비된 워크플로로 시작하거나 단계 편집기에서 직접 만들 수 있습니다. 실행을 열면 각 단계가 무엇을 했고 어떤 모델을 썼는지 볼 수 있으며, 단계를 고쳤다면 그 단계부터 다시 실행할 수 있고 앞선 단계는 다시 실행되지 않습니다.
설명만 해도 됩니다. 워크플로 페이지에서, 또는 홈의 '자동화' 칩으로 원하는 것을 내 말로 이야기하면 채팅 모델이 워크플로 초안을 만들고, 검사하고, 맞지 않는 부분을 고칩니다. 초안은 저장되지 않은 채 편집기에서 열리며, 폴더나 덱처럼 직접 골라야 할 항목의 짧은 목록이 함께 나옵니다. 내가 말하기 전에는 아무것도 저장되거나 예약되지 않습니다. 명령 팔레트의 채팅을 워크플로로 저장은 채팅에서 한 일을 다시 실행할 수 있는 워크플로로 만들어 줍니다. 내 메시지와 사용된 도구는 보지만 페이지나 문서 자체는 보지 않습니다. 워크플로는 자체 모델을 쓸 수 있고, 요약이나 에이전트 단계마다 이를 바꿀 수도 있습니다. 대부분의 작업에는 빠르고 저렴한 모델을, 마무리 글에는 더 강한 모델을, 비공개 데이터를 다루는 단계에는 로컬 모델을 쓰는 식입니다. 모델을 고르지 않은 워크플로는 채팅 모델을 따릅니다.
필요할 때 실행됩니다. 지금 실행하거나, 일정에 따라(매일, 평일 정해진 시각, 몇 시간마다), 또는 RSS나 Atom 피드에 새 글이 올라오거나 폴더에 새 파일이 들어오면 자동으로 실행할 수 있습니다. 자동 실행을 켜면 새 글이나 새 파일마다 별도의 실행이 만들어집니다. '다음 경우에만 계속…' 단계는 값이 바뀌지 않았거나, 비어 있거나, 특정 텍스트를 포함하지 않으면 실행을 조용히 끝내고, 알림과 저장 단계도 보낼 내용이나 저장할 내용이 지난번과 같으면 스스로 건너뛸 수 있어서, 새로운 것이 없는 예약 실행은 알림을 보내지 않습니다. 피드나 폴더를 세 번 연속 읽지 못하면 알림이 한 번 오고, 다시 읽을 수 있게 되면 워크플로가 알아서 이어집니다.
자동 실행을 켜면 먼저 워크플로가 스스로 해도 되는 모든 일(읽는 사이트, 웹 검색, 읽는 폴더, 커넥터, 사용하는 모델과 제공업체, 문서 저장)이 나열되어 승인을 요청합니다. 수정 이후 등 실행이 더 많은 권한을 필요로 하면 일시 중지하고 묻습니다. 한 번 허용, 항상 허용, 허용 안 함 중에서 고를 수 있습니다. 읽기만 하는 커넥터 도구는 스스로 실행되고, 무언가를 보내거나 게시하거나 편집하는 도구는 실행을 멈추고 묻습니다(아래 외부 작업 참조). 덱이나 초안 업데이트는 내가 직접 쓴 텍스트를 바꾸지 않으며, 업데이트 전후로 버전이 저장되므로 실행 화면의 '이 업데이트 되돌리기'나 기록에서 되돌릴 수 있습니다. 각 실행에는 시간과 토큰 한도가 있으며, 진행 중인 실행은 중지할 수 있습니다. Conduit가 닫혀 있는 동안 놓친 실행은 열 때 한 번 실행됩니다.
창을 닫아도 일정이 계속 돌아가게 하려면 Conduit를 트레이에 두고 로그인할 때 트레이에서 시작하게 할 수 있습니다. 둘 다 기본값은 꺼짐이며, 트레이 옵션은 처음 일정을 켤 때 한 번 제안됩니다.
캔버스로 보고 다듬기. 열린 워크플로는 단계를 캔버스나 목록으로 보여 주며, Conduit가 선택을 기억합니다. 캔버스에는 시작, 각 단계, 반복, 그 사이를 잇는 선이 그려지고, 실행 중에는 각 단계가 실행 중인지, 끝났는지, 실패했는지, 건너뛰었는지, 내 답을 기다리는지 표시되며, 반복은 항목 수를 셉니다. 단계를 선택하면 실행에서의 입력과 출력을 볼 수 있습니다. 편집할 때는 팔레트에서 단계를 추가하고, 끌어서 순서를 바꾸거나 반복 안으로 옮기고, 한 단계에서 다른 단계로 선을 끌어 어떤 출력이 어떤 필드로 들어갈지 정합니다. 문제가 있는 단계에는 표시가 붙고, 저장하지 않은 변경이 있으면 나갈 때 먼저 묻습니다. 워크플로에는 단계, 실행, 결과 탭이 있습니다. 끝난 실행은 저장한 것을 미리 보기와 함께 모두 보관하고, 결과 탭에 목록이 나오며, 워크플로 사이드바의 결과 목록은 모든 워크플로의 결과를 모아 읽지 않은 것을 표시하고, 홈에는 워크플로의 새 소식이 나옵니다.
분기와 나란히 실행되는 단계. 만약… 아니면 단계는 실행을 ‘예’ 쪽이나 ‘아니요’ 쪽으로 보내며, 가지 않은 쪽은 지나지 않음으로 기록됩니다. 한 단계가 앞의 여러 단계를 기다릴 수 있으므로, 서로 의존하지 않는 단계는 최대 네 개까지 나란히 실행되고 이후 단계가 그 결과를 모을 수 있습니다. 각 단계의 실행 시점도 끌지 않고 같은 일을 합니다. 이전에 저장한 워크플로는 순서대로 실행되었고 지금도 그렇습니다. 커넥터의 읽기 전용 목록 도구가 새로운 것을 돌려줄 때 워크플로가 시작되게 할 수도 있으며, 15분에서 하루 한 번까지의 간격으로 확인하고, 이전에 본 적 없는 항목마다 실행이 시작됩니다.
외부 작업. 단계가 무언가를 보내거나 게시하거나 편집하는 커넥터 도구를 쓰려 하면 실행이 멈추고 정확한 호출을 보여 줍니다. 보내기, 편집한 뒤 보내기, 또는 이유와 함께 실행을 멈추는 보내지 않기 중에서 고릅니다. 이 워크플로에서는 다시 묻지 않기를 고르면 그 작업은 앞으로 허용됩니다. 시작 패널의 외부 작업에서 워크플로의 묻기를 켜거나 끌 수 있고(기본값은 켜짐), 묻지 않고 허용한 작업이 목록으로 나오며 각각 삭제할 수 있습니다. 커넥터가 민감하다고 표시한 도구는 항상 묻고, 채팅에서 해 둔 승인은 워크플로로 이어지지 않습니다. 에이전트 단계는 커넥터 도구를 최대 열 개까지 쓸 수 있으며, 그 단계의 목록에 없는 도구는 호출할 수 없습니다.
에이전트와 도우미. 워크플로에서는 도우미를 정의할 수 있으며, 각 도우미는 자체 지침, 모델, 도구, 토큰 한도를 가집니다. 에이전트 단계는 일을 넘길 수 있는 도우미를 지정하고, 각각에게 작업을 적어 주고 답을 돌려받습니다. 도우미는 최대 한 단계 더 일을 넘길 수 있고, 도우미끼리 순환하는 구성은 저장할 때 거부되며, 한 단계가 맡기는 작업은 최대 열두 개입니다. 도우미에게도 단계와 같은 승인이 필요합니다. 에이전트 페이지에는 에이전트 단계와 도우미마다 카드가 있어, 일하는 중인지, 모델, 도구, 내 컴퓨터를 쓰는지, 일을 넘기는 대상, 최근 30일의 작업·실패·토큰이 표시되며, 검색과 전체, 작업 중, 도우미 필터가 있습니다. 워크플로를 말로 설명하면 이제 분기, 나란히 실행되는 단계, 커넥터 단계, 도우미도 초안으로 만들 수 있으며, 가지고 있지 않은 커넥터처럼 모델이 지어낸 것은 제거되고 그 사실이 안내됩니다.
내 컴퓨터를 사용하는 에이전트. 설정 → 컴퓨터를 켜기 전까지는 꺼져 있으며, 여기에는 항상 묻는 규칙도 있습니다. 워크플로는 에이전트 단계나 도우미마다 컴퓨터 사용으로 직접 선택해야 하고 폴더를 지정해야 합니다. 그러면 에이전트는 그 폴더에서 명령(셸 한 줄이 아니라 인수가 있는 프로그램)을 실행하고, 파일을 나열하고 읽고 검색하고, 파일을 쓰거나 편집할 수 있습니다. 워크플로의 허용 규칙(예: git status *)이 포함하지 않는 한 모든 명령은 먼저 묻고, 승인 카드는 가장 좁은 규칙을 앞으로 이 규칙 허용으로 제안합니다. 파일 삭제, git reset --hard, git clean, 강제 푸시, 시스템 및 보안 도구, 셸, 길거나 특이한 명령, 그리고 내가 만든 거부 규칙은 규칙과 상관없이 항상 묻습니다. 위험한 명령은 실행 안 함이 주 버튼인 별도 카드로 표시됩니다. 에이전트가 웹 페이지, 검색, 커넥터 결과 같은 외부 내용을 읽은 뒤에는 그 실행이 끝날 때까지 허용 규칙이 명령을 포함하지 않으며, 카드에 그 이유가 표시됩니다. 파일 변경은 줄 단위 차이를 보여 주고 먼저 묻습니다. 워크플로가 폴더 안에서 파일을 자유롭게 바꾸도록 허용한 경우는 예외입니다. 각 워크플로의 권한 탭에는 명령 규칙과 각 규칙이 쓰인 횟수, 내장된 항상 묻기 목록, 최근 열 번의 실행에서 승인한 명령을 바탕으로 제안된 규칙이 나옵니다. 실행 세부 정보에는 모든 명령과 파일 변경, 누가 승인했는지, 종료 코드, 출력이 기록됩니다.
받은 편지함, 그리고 기다리는 실행. 받은 편지함에는 워크플로가 기다리는 모든 것(질문, 검토, 외부 작업, 명령 승인)이 나열됩니다. 기다리는 것이 있으면 탐색 모음에 점이 표시되고, 새 요청은 시스템 알림으로 알려 줍니다. 나를 기다리며 멈춘 실행은 Conduit를 닫았다가 다시 열어도 원래 기한 그대로 이어집니다. 끝난 단계는 다시 실행되지 않고 이미 보낸 작업은 두 번 보내지 않으며, 기다리는 동안 워크플로가 바뀐 실행은 그 사실을 알리고 멈춥니다. 기다린 시간은 실행의 시간 한도에 포함되지 않습니다.
홈
Conduit는 탐색 모음 맨 위의 홈에서 열립니다. 입력 상자 하나로 무엇이든 시작할 수 있습니다. 프레젠테이션을 요청하면 스토리라인과 함께 슬라이드가 열리고, 그 외에는 채팅이 시작됩니다. 그 아래 확인 필요에는 내 확인을 기다리는 워크플로 승인과 질문, 기억 제안이 나열되며(아무것도 없으면 숨겨집니다), 워크플로의 새 소식에는 아직 열어 보지 않은 결과가 표시되고, 하던 작업 이어가기에는 최근 채팅, 덱, 초안, 앱이 표시됩니다. 앱의 각 영역은 실시간 개수가 표시된 타일로 놓여 있고, 비어 있는 영역에는 시도해 볼 예시가 나옵니다.
Ctrl+1부터 Ctrl+9까지(macOS에서는 ⌘)는 홈, 채팅, 슬라이드, 글쓰기, 앱, 워크플로, 받은 편지함, 에이전트, 컨텍스트를 엽니다. 관리에는 번호가 없습니다. 탐색 모음, 홈, 또는 모든 영역에 대한 '이동' 항목이 있는 명령 팔레트에서 열 수 있습니다.
모양과 언어
Conduit는 두 가지 모드를 가진 하나의 디자인입니다. 설정 → 모양에서 어둡게, 밝게, 또는 시스템 설정 따르기를 고르고, 버튼, 선택 영역, 활성 항목에 쓰이는 강조색인 메인 색상을 모드마다 따로 정할 수 있습니다. 읽기 어려운 색은 거부됩니다. 같은 페이지에서 인터페이스 글꼴 크기, 밀도, 다이어그램 크기도 설정합니다.
같은 Settings 화면에서 Conduit가 제공하는 8개 언어 전체에 대해 인터페이스 언어를 설정합니다. 메뉴, 버튼, 날짜, 숫자 표기는 바뀌지만, 어시스턴트가 답변하는 언어는 바뀌지 않습니다.
데이터가 저장되는 위치
Conduit는 모든 것을 플랫폼의 애플리케이션 데이터 디렉터리에 저장합니다. 대화, 메시지, 프롬프트, 사용량은 SQLite 데이터베이스에 들어가고, 첨부 파일과 아티팩트는 해시로 중복 제거되는 content-addressed blob 저장소에 들어갑니다.
메시지는 append-only 이벤트 로그로 기록되고, 그 위에 materialised view가 유지됩니다. 덕분에 응답 도중 앱이 종료되어도 대화가 살아남고, 시작 시 Conduit는 둘을 다시 맞춥니다.
저장 시 선택형 AES-256-GCM 암호화는 Settings → Privacy & data에서 켤 수 있으며, 마스터 키는 OS 키체인으로 래핑됩니다. 기본값은 꺼져 있고 아직 메시지 본문까지는 포함하지 않습니다. 현재 범위는 개인정보 페이지를 참고하세요.
문제 해결
Windows에서 빌드가 실패합니다
대부분은 C++ toolchain 누락입니다. Visual Studio 2022 Build Tools에서
"Desktop development with C++" 워크로드를 설치한 뒤 check-setup.ps1로
확인하세요.
제공업체 키가 저장되지 않습니다
Conduit는 동작하는 OS 자격 증명 저장소가 필요합니다. 헤드리스 또는 최소 구성의 Linux 시스템에서는 Secret Service가 실행 중이 아닐 수 있습니다. 키링 데몬을 시작하거나, 환경 변수를 통해 키를 제공해야 하는 암호화 파일 기반 자격 증명 저장소를 활성화하세요.
Ollama 모델이 나타나지 않습니다
Ollama가 실행 중이고 최소 하나 이상의 모델이 pull되어 있는지, 그리고 Conduit에 설정한 base URL이 Ollama가 실제로 수신 중인 포트와 일치하는지 확인하세요.
그 외 다른 문제가 있습니다
Settings → Diagnostics에서 진단 번들을 내보내 이슈에 첨부하세요. 설계상 비밀 정보, base URL, 허용 목록, 대화 내용은 제외되며, 생성 전에 포함 내용을 확인하도록 요구합니다.