For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/mobile/chat.md (or send Accept: text/markdown).
AI 채팅과 어시스턴트
공유 API 위의 스트리밍 채팅 스레드와 단발성 에이전트 실행.
채팅 스레드는 웹 계약을 사용합니다
채팅 탭은 브라우저 앱과 같은 REST 표면을 호출합니다. /api/chat/threads에서 목록과 생성을, /api/chat/threads/:id에서 읽기, 이름 바꾸기, 삭제를 합니다. 제목은 공유된 120자 제한으로 정규화되고, 스레드 목록은 오프라인 읽기 캐시가 적용됩니다.
스트리밍 응답
응답은 expo/fetch를 통해 POST /api/chat/stream으로 스트리밍됩니다. 서버가 보낸 프레임은 chunk, done, error 이벤트가 되고 형식이 잘못된 프레임은 건너뜁니다. 모델 별칭은 fast, smart, cheap이며 fast가 기본값입니다. structuredOutput 플래그는 해당 요구 사항을 전달하고, 중지 컨트롤은 진행 중인 요청을 중단합니다.
단발성 에이전트 실행
숨겨진 assistant 화면은 {alias, prompt, workspaceId, maxSteps: 4}를 /api/v1/agent-runs에 POST합니다 — 활성 워크스페이스에서 예산이 정해진 단일 실행입니다. 클라이언트는 응답을 엄격하게 검증하고 다른 워크스페이스에 귀속된 실행은 거부합니다. 속도 제한, 로그인 필요, 엔타이틀먼트 없음, 금지됨 응답은 각각 별개의 상태로 매핑되고, 실행 기록은 마이크로단위 정확도의 비용 형식으로 최근 10개를 세션 메모리에 유지합니다.
검증 및 문제 해결
취소된 스트림, 실행 중 폐기된 세션, 권한이 있는 워크스페이스와 잠긴 워크스페이스, 캐시된 스레드 목록에서의 비행기 모드 동작을 테스트하세요. 서버가 거부한 실행은 조용한 빈 응답이 아니라 사용할 수 없는 작업으로 표시되어야 합니다.