FAQ
첫 주에 나오는 질문들입니다.
궁금한 점이 있으신가요? 에이전트에게 물어보세요
Letaido가 무엇을 할 수 있는지에 대한 질문이 있거나, 오류가 발생했거나, 무언가 작동하는 방식이 확실하지 않은 경우, 가장 빠른 답변은 채팅에서 에이전트에게 직접 물어보는 것입니다. 에이전트는 자체 문서를 읽고, 워크스페이스를 확인하고, 설정을 검토하며, 같은 곳에서 보이는 내용을 안내할 수 있습니다.
아래 FAQ는 가장 자주 발생하는 질문들을 다룹니다. 귀하의 질문이 여기에 없다면 에이전트에게 문의하십시오. 추가할 가치가 있다면 에이전트가 추가를 제안할 것입니다.
기본 사항
채팅 간에 기억하나요?
네, 하지만 사용자가 기억하라고 지시한 내용만 기억합니다. 모든 채팅 시작 시 ~/workspace/.memory.md를 읽습니다. "이것을 기억해: X"라고 말하면 추가됩니다. 변경 로그(progress.md)도 읽기 때문에 최근에 무엇이 구축되었는지 알 수 있습니다.
빌드한 내용을 롤백할 수 있나요?
파일은 간단합니다. "지난 한 시간 동안 변경한 내용을 보여주고 X를 되돌려줘"라고 요청하면 됩니다. 데이터베이스 변경 사항은 자동으로 되돌려지지 않지만, 모든 작업이 기록되므로 실행 취소는 일반적으로 명확한 대화를 통해 이루어집니다. 파괴적인 변경(테이블 삭제, 스킬 제거)의 경우, 에이전트가 실행하기 전에 확인을 요청합니다.
여러 사람이 워크스페이스를 공유할 수 있나요?
네. 역할은 소유자, 관리자, 멤버, 뷰어입니다. 소유자와 관리자는 승인 카드를 결정하고, 시크릿을 관리하며, 공개 사이트를 토글합니다. 멤버는 채팅하고 콘솔 페이지를 사용합니다. 뷰어는 읽기 전용입니다.
제가 입력하는 내용이 제3자에게 전송되나요?
에이전트는 로컬 프록시를 통해 LLM 제공업체를 거쳐 추론합니다. 메시지가 추론을 위해 전송되고 출력이 반환됩니다. 모델 제공업체 자체 정책에 명시된 것 이외의 보관은 없습니다. 다른 워크스페이스와 공유되지 않습니다.
외부 API가 실패하면 어떻게 되나요?
에이전트는 실패를 보고하고(상태 코드, 커넥터가 노출하는 경우 오류 카테고리), 중지한 후 지시를 기다립니다. 예산이 소진될 때까지 재시도하지 않습니다.
무언가 만들기
콘솔 앱을 구축하는 데 얼마나 걸립니까?
간단한 작업(단일 폼, 단일 쿼리, 단일 결과)은 몇 분 안에 완료됩니다. 복잡한 작업(다단계 파이프라인, 타사 통합, 사용자 정의 시각화)은 채팅 세션 한 번, 때로는 두 번이 필요합니다. 에이전트는 두 번 이상의 왕복이 필요할 것으로 예상되는 경우 알려줍니다.
고객과 무언가를 공유하려면 어떻게 해야 하나요?
공개 사이트에서 빌드하고, URL을 얻은 다음, 사이트 모드를 open 또는 authorized로 전환하여 링크를 공유합니다. 알아야 할 패턴: 토큰 게이트 보고서(/<route>/<token>), 공개 문서(이 사이트), 리드 캡처 페이지.
에이전트가 이전에 만들어본 적 없는 것을 만들 수 있습니까?
네, 기본 요소(콘솔 블루프린트, 사이트 라우트, 크론 작업, 웹훅, 커넥터)가 존재하는 한 가능합니다. 이러한 요소들을 조합합니다. 기본 요소가 존재하지 않는 경우(새로운 플랫폼 기능이 필요한 경우), 가짜로 만들지 않고 명확하게 알려줍니다.
필요한 서비스에 대한 커넥터가 없다면 어떻게 해야 하나요?
해당 앱에 대한 새 커넥터를 추가해 달라고 지원팀에 요청하세요. 고객 요청에 따라 새 커넥터가 정기적으로 추가됩니다. 그동안 에이전트는 일반적으로 일반 API 키, 도메인 허용 목록 및 원시 HTTP로 대체할 수 있지만, 적절한 커넥터가 항상 선호됩니다(기본적으로 타입이 지정된 입력, 로깅, 범위가 지정된 자격 증명 및 표면별 승인을 제공합니다).
기억, 기술, 음성
에이전트가 우리 브랜드 보이스를 사용하도록 하려면 어떻게 해야 하나요?
워크스페이스에 브랜드 보이스 스킬이 있습니다. 에이전트는 카피를 작성하거나 검토할 때 이를 읽습니다. 새로운 규칙을 추가하려면: "브랜드 보이스 스킬을 업데이트하여 다음을 추가:
왜 em 대시를 사용하지 않는다고 하나요?
이는 이 워크스페이스가 채택한 하우스 스타일 선택입니다. 이 규칙은 메모리와 브랜드 보이스 스킬에 저장되어 있으므로, 모든 초안(및 이러한 문서)에서 이를 피합니다. 쉼표, 콜론, 마침표 또는 괄호로 대체합니다.
모든 것을 메모리에 넣어야 할까요?
메모리는 에이전트의 기본 설정을 변경하는 사항에 사용됩니다. 즉, 당신이 누구인지, 어떻게 글을 쓰는지, 장기적으로 무엇을 중요하게 생각하는지 등입니다. 워크플로 규칙("우리의 표준 출시 체크리스트는 X입니다")의 경우 스킬이 더 적합합니다. 일회성 맥락("이 고객은 가격에 민감합니다")의 경우 채팅에서 말씀하시면 됩니다.
공개 사이트, 문서, 주간 다이제스트
이 문서는 어떻게 업데이트됩니까?
마크다운 소스는 ~/workspace/docs/*.md에 있습니다. 관리자가 수동으로 편집합니다. 동기화 작업(30분마다)이 마크다운을 데이터베이스로 렌더링합니다. 공개 사이트는 데이터베이스에서 읽습니다.
주간 다이제스트란 무엇인가요?
매주 월요일 유럽/부쿠레슈티 시간 10:00에 실행되는 예약 작업입니다. 마지막 다이제스트 이후 에이전트의 메모리, 변경 로그 및 스킬 폴더의 차이를 비교하고, LLM에게 고객이 알아야 할 변경 사항을 묻고, 제안된 문서 수정 사항을 Slack으로 관리자에게 전송합니다. 관리자가 검토한 후 문서가 업데이트됩니다.
제안 사항을 자동으로 게시하지 않는 이유는 무엇인가요?
두 가지 이유가 있습니다. (1) LLM이 제안한 수정 사항은 미묘하게 잘못될 수 있으며, 문서는 제품의 공개적인 얼굴입니다. (2) 사람의 검토는 목소리를 일관되게 유지하고 올바르게 보이지만 그렇지 않은 것들을 포착합니다.
문서에 문제를 신고하려면 어떻게 해야 하나요?
채팅에서 에이전트에게 알려주세요. 워크스페이스에 메모가 열리고 다음 주간 다이제스트에서 문서 관리자에게 표시됩니다.
승인, 비밀 정보, 비용
왜 계속 승인을 요청하나요?
작업이 비용을 발생시키거나, 네트워크에 접근하거나, 자격 증명을 건드리기 때문입니다. 각 작업은 기록됩니다. "승인 카드가 너무 많음" 문제의 해결책은 일반적으로 요청을 일괄 처리하는 것입니다. 에이전트가 전체 흐름을 먼저 계획하도록 하여 모든 범위와 승인을 한 번에 요청하도록 합니다.
구성된 자격 증명을 확인할 수 있나요?
네, 워크스페이스 UI에서 확인할 수 있습니다. 시크릿 이름, 유형, 상태, 그리고 어떤 커넥터와 서피스에 부여되었는지 볼 수 있습니다. 시크릿 값은 볼 수 없으며, 에이전트를 포함하여 누구도 볼 수 없습니다.
에이전트의 지출을 제한할 수 있나요?
플랫폼은 LLM 토큰과 커넥터 호출을 측정합니다. 지속적인 비용 관리를 위해서는 작업이 적절한 수단입니다(명시적인 반복 지출이기 때문입니다). 임시 채팅 지출은 요청한 만큼 발생합니다. 작업이 오작동하는 경우 작업 탭에서 일시 중지하십시오.
문제 해결
공개 사이트 URL이 403을 반환합니다.
사이트 모드가 off입니다. Public site 탭에서 authorized(회원 전용) 또는 open(누구나)으로 전환하십시오.
콘솔 페이지가 계속 로딩 중입니다.
페이지가 긴 외부 호출을 수행하고 있거나(nginx 타임아웃은 30초이며, 긴 작업은 job-id-then-poll 패턴을 사용해야 합니다), Flask 프로세스가 충돌했습니다. /home/console/http/data/.tail.log에서 테일 로그를 확인하십시오.
커넥터 호출이 approval_pending 또는 not_approved를 반환합니다.
해당 (커넥터, 시크릿, 서피스) 조합이 처음입니다. 카드를 승인하세요. 콘솔 또는 사이트 서피스의 경우, 소유자 또는 관리자가 채팅 서피스와 별도로 request_connector_approval을 클릭합니다.
예상한 시간에 작업이 실행되지 않았습니다.
Cron 시간은 호스트에서 UTC로 설정됩니다. 작업이 "매주 월요일 오전 9시 부쿠레슈티 시간"인 경우, 스케줄 라인은 0 7 * * 1(여름) 또는 0 8 * * 1(겨울)입니다. 에이전트는 일반적으로 하나를 선택하고 스크립트 내부에 zoneinfo 가드를 추가하여 DST를 처리합니다. 다음 실행 시간은 Jobs 탭에서 확인하세요.
트리거가 실행되지 않습니다.
구독 목록을 확인하세요. paused 또는 revoked로 표시되면 다시 구독하세요. active로 표시되지만 이벤트가 없는 경우, 서드파티 앱 설정을 확인하세요(구독 URL이 해당 측에서도 설정되어 있어야 합니다).
내 워크스페이스가 느리게 느껴집니다.
긴 대화 세션은 성능이 저하됩니다. 새 대화를 시작하세요. 메모리와 진행 상황이 중요한 컨텍스트를 전달합니다.