맥락 제안
채팅의 빈 첫 화면 · 계획 카드 아래 · 끝난 실행 카드 아래에 AI 가 붙이는 「맥락 제안」 패널이 무엇이고, 어떤 호출과 전송이 늘어나는지, 어떻게 끄는지를 설명합니다.
목차
「맥락 제안」은 채팅 안에 붙는 작은 패널입니다. 머리줄의 「맥락 제안」 옆에 무엇을 근거로 만든 것인지가 적혀 있고(예: 「AI 생성 · 계획 사실 기준」), 안에는 다음에 보낼 요구를 고르게 하는 칩, 계획을 바꿀 수 있는 질문, 알아 둘 점이 들어갑니다. 내가 고른 AI 공급자를 한 번 더 불러서 만들기 때문에 선택 기능이고, 처음부터 켜져 있으며 끌 수 있습니다.
참고
이 쪽은 2026-10-09 시점의 최신 소스를 기준으로 합니다. 2026-10-08 에 내려받을 수 있던 0.1.0 에는 계획 카드 아래의 맥락 제안만 있고, 빈 첫 화면의 시작 제안과 끝난 실행 아래의 제안(성공 · 멈춤)은 그 뒤에 추가되었습니다. 0.1.0 의 설정에서는 스위치 이름이 「계획 아래에 맥락 제안 보이기」이고 카드 설명도 계획 카드 아래만 말합니다.
어디에 붙나
패널은 한 번에 하나만 보입니다. 새 요구를 보내거나 「확인하고 실행」을 누르면 떠 있던 패널은 걷히고, 계획 · 실행 아래 패널을 만들던 요청도 끊깁니다. 첫 화면의 시작 제안은 화면에서만 걷고, 이미 보낸 요청은 끊지 않습니다.
| 자리 | 붙는 때 | 머리줄 보조문 | 담길 수 있는 것 | 만드는 동안 보이는 글 |
|---|---|---|---|---|
| 빈 첫 화면 | 대화가 비어 있고 연결이 준비된 채로 첫 화면이 열릴 때 | AI 생성 · 이 기기의 카탈로그 기준 | 칩, 안내. 예시 단추 자리를 대신합니다 | 이 기기의 카탈로그로 시작 제안을 고르는 중… |
| 계획 카드 아래 | 계획이 나온 뒤, 그 계획이 확인을 기다리는 동안 | AI 생성 · 계획 사실 기준 | 칩, 질문, 안내 | 이 계획에 맞춘 다음 단계를 고르는 중… |
| 성공한 실행 카드 아래 | 실행이 실패 없이 끝난 뒤, 그 실행이 마지막일 때 | AI 생성 · 실행 결과 기준 | 칩, 안내 | 이 결과에 맞춘 다음 단계를 고르는 중… |
| 멈춘 실행 카드 아래 | 실행이 멈췄고 cob 가 사유를 남겼거나 정책 프록시가 막은 호스트가 있을 때, 그 실행이 마지막일 때 | AI 생성 · 실패 사유 기준 | 안내(원인과 다음 단계), 칩 | 이 실패에 맞춘 다음 단계를 고르는 중… |
- 빈 첫 화면: 이 컴퓨터의 cob 카탈로그를 읽을 수 있고 레시피가 하나라도 있을 때만 만듭니다. 그렇지 않거나 만들지 못하면 예시 단추가 그대로 남습니다. 시작 제안을 고르는 중에는 예시 단추 아래에 위의 글이 한 줄 붙습니다.
- 계획 카드 아래: 패널은 기다리지 않습니다. 계획 카드는 이미 확인할 수 있고, 패널은 준비되면 그 아래에 붙습니다.
- 멈춘 실행 카드 아래: cob 가 사유도 남기지 않았고 막힌 호스트도 없으면 만들지 않습니다. 실행 카드가 이미 말한 것(멈춘 단계 · 분류)보다 더 말할 근거가 없기 때문입니다.
- 조용히 실패합니다. 공급자가 답하지 않거나 그릴 수 없는 답을 주면 패널이 생기지 않을 뿐이고, 오류 안내도 없으며 계획 · 확인 · 실행은 막히지 않습니다.
패널 안의 것
| 구성 | 모양 | 누르면 |
|---|---|---|
| 칩 | 짧은 글이 적힌 단추. 한 묶음에 최대 네 개 | 그 칩의 문장이 입력창에 채워지고 포커스가 갑니다. 보내지 않으니 읽고 고친 뒤 보내세요 |
| 질문 | 질문 한 줄과 선택지(둘에서 여섯 개). 하나만 고르거나 여러 개를 고르는 질문이 있고, 「이대로 다시 계획」 단추가 붙습니다. 선택지를 하나도 고르지 않으면 이 단추는 눌러지지 않습니다 | 고른 답이 <질문> — <답>(여러 개면 <답1>, <답2>) 문장이 되어 곧바로 다음 요구로 보내지고 새 계획이 나옵니다. 입력창에 쓰던 글은 비워지고, 쉼표로 이어진 답은 요구를 읽는 규칙에 따라 기능이 따로 나뉩니다. 계획 카드 아래 패널에만 나옵니다 |
| 안내 | 제목 한 줄과 선택적인 설명. 참고 모양 또는 경고 모양 | 눌러지지 않습니다 |
패널 안의 동작은 위 둘(입력창 채우기, 다음 요구 보내기)뿐입니다. 패널이 계획이나 실행 자체를 바꾸지 못하고, 이름과 함께 만들기 체크도 카드가 정합니다. AI 에게는 프로젝트 이름 · 데모 데이터 · 소개 페이지 · 운영 콘솔을 묻거나 바꾸자고 하지 말라고 지시합니다.
참고
오른쪽 패널의 「컨텍스트」 구역(생성 위치 · 레시피 · 공급자 · 샌드박스)은 이 패널과 다릅니다. 그쪽은 AI 가 만든 것이 아니라 앱이 아는 사실을 그대로 보여 주는 칸입니다.
호출과 전송
맥락 제안을 켜 두면 같은 공급자 호출이 아래만큼 늘어납니다. 키가 필요한 공급자의 사용료는 그 공급자에게 직접 냅니다(BYOK).
- 계획 1건마다 1번, 실행 1건마다 1번입니다. 멈춘 실행은 위 표대로 사유나 막힌 호스트가 있을 때만 부릅니다. 멈춘 실행을 다시 돌리면 새 실행 카드가 생기므로 그것도 한 건으로 셉니다.
- 빈 첫 화면은 연결이 준비된 채 첫 화면이 열릴 때 부릅니다. 프로젝트와 앞선 요구가 같은 맥락이면 「새 작업」으로 연 다른 빈 대화들이 같은 제안을 나눠 쓰고 다시 묻지 않습니다. 실패한 결과는 기억하지 않아 다음에 다시 묻습니다.
| 자리 | 공급자에게 가는 것 | 가지 않는 것 |
|---|---|---|
| 빈 첫 화면 | 이 컴퓨터 cob 카탈로그의 레시피 · 도메인 · 브릭 · 데이터 팩 이름과 한 줄 설명 · 기능 키워드(개수 상한이 있습니다), 이 프로젝트의 다른 대화에서 첫 번째로 보낸 요구(최근 세 개까지) | 경로 · 폴더 이름 · 파일 내용 |
| 계획 카드 아래 | 이 대화에서 계획을 받은 요구 전부(받지 못한 요구는 제외), 계획 사실(레시피 · 기본 포함 · 후속 검토 후보 · 데이터 팩 · 구현 필요 · 예상 시간), 계획의 프로젝트 이름과 세 체크의 켬 · 끔 | 출력 경로 · 파일 내용 |
| 성공한 실행 아래 | 요구, 계획 사실, 이번 실행이 마친 단계, 실행 카드가 보여 주는 남은 일, 만든 것(데모 데이터 · 소개 페이지 · 운영 콘솔)의 켬 · 끔 | 경로 · Pages 주소 · 프로젝트 이름 · 실행 출력 |
| 멈춘 실행 아래 | 요구, 계획 사실, 멈춘 단계, 실패 분류, 프로젝트 폴더가 만들어졌는지, 실행 카드의 다시 돌리기 동작, cob 가 남긴 사유(알려진 형태의 비밀 값과 절대 경로를 가리고, 세 줄 400자 안쪽으로 줄입니다), 막힌 호스트 이름(다섯 개까지) | 출력 꼬리 전체(사유에 든 줄은 제외) · 프로젝트 경로 · Pages 주소 |
절대 경로는 이름이 셋 이상이면 마지막 이름만 남기고, /Users/이름 같은 짧은 경로는 통째로 가립니다. 상대 경로와 URL 은 그대로 갑니다. 위 표에서 프로젝트 이름이 가지 않는다고 한 자리에도, 같은 공급자가 같은 대화에서 앞선 호출(계획 설명 글 · 계획 카드 아래 패널)로 프로젝트 이름을 이미 받았습니다(카드에서 고치기 전의 제안 이름입니다).
주의
실패한 실행에서는 기기 밖으로 나가는 것이 늘어납니다. 멈춘 실행 아래 패널을 만들 때는 cob 가 남긴 사유(최대 세 줄 · 400자)와 막힌 호스트 이름이 공급자에게 갑니다. 사유에서 알려진 형태의 비밀 값과 절대 경로는 가려지지만, 그 밖의 글은 그대로 갑니다. 이것이 마음에 걸리면 맥락 제안을 끄세요.
켜고 끄기
「설정」 › 「AI 공급자」 아래쪽의 「채팅 맥락 제안」 카드(「선택 사항」)에서 정합니다. 카드 설명은 맥락 제안이 붙는 세 자리와 호출이 늘어나는 것을 알려 줍니다. 다만 카드는 실패 사유를 「한 줄」이라고 적지만, 앱은 위 표대로 최대 세 줄 · 400자까지 보냅니다. 설정 화면은 AI 공급자에도 정리해 두었습니다.
- 스위치 이름은 「채팅에 맥락 제안 보이기」이고 처음부터 켜져 있습니다.
- 켜면 지금부터 만듭니다. 이미 지나간 계획 · 실행에는 거슬러 만들지 않습니다.
- 끄면 새로 만들지 않고, 떠 있던 제안도 숨깁니다.
- 설정을 읽지 못하면 꺼진 것으로 봅니다. 끈 선택을 어기고 공급자를 부르지 않으려는 것입니다.
- 설정을 저장하지 못하면 카드에 「설정을 저장하지 못했습니다」가 보이고 스위치가 이전 상태로 돌아갑니다.
자주 겪는 문제
맥락 제안이 보이지 않습니다
스위치가 꺼져 있거나, 연결 설정(모델 · URL)이 유효하지 않거나, 키가 없거나(공급자를 부르기 전에 실패해 패널만 조용히 안 생깁니다), 공급자가 답하지 못한 경우입니다. 실패는 알리지 않으니 조립 계획 읽기의 「계획이 나오지 않을 때」를 보며 연결부터 확인하세요. 멈춘 실행 아래에는 cob 가 사유도 막힌 호스트도 남기지 않으면 만들지 않습니다. 또 새 요구를 보내거나 확인하면 앞의 패널은 걷힙니다.
칩을 눌렀는데 아무것도 보내지지 않았습니다
정상입니다. 칩은 문장을 입력창에 채우고 포커스를 줄 뿐입니다. 읽고 고친 뒤 Enter 키로 보내세요. 보낸 문장으로 cob 가 계획을 다시 세웁니다.
대화를 열기만 했는데 공급자 호출이 생겼습니다
맥락 제안이 켜져 있고 연결이 준비되어 있으면, 빈 첫 화면을 열 때 시작 제안을 위해 공급자를 한 번 부릅니다. 같은 맥락이면 다시 묻지 않습니다. 호출을 없애려면 스위치를 끄세요.
다음 단계
채팅 빌더의 흐름을 처음부터 다시 보려면 채팅으로 프로젝트 만들기로 돌아가세요. 만든 프로젝트를 코드 모드에서 여는 화면은 화면 구성에, 코드 모드의 사용법은 코드 모드와 실행에 있습니다.