A Letaido / docs
DOCUMENTATION

핵심 기능

레타이두가 오늘날 구축할 수 있는 것의 완전한 지도입니다. 각 기능은 레타이두가 구성하는 기본 요소이며, 가장하는 것이 아닙니다.

한눈에 보기

기능 설명 위치
파일 사용자가 소유한 파일 시스템에서 실제 읽기/쓰기/편집 ~/workspace/
데이터베이스 모든 것을 위한 영구 저장소인 PostgreSQL 세 개의 명명된 DB (데이터 참조)
내부 웹 앱 회원 전용 Flask 앱 (콘솔) console-http, 회원 전용
공개 웹 앱 인터넷에 공개된 Flask 앱 (공개 사이트) site-http, nginx 뒤의 별도 프로세스
커넥터 타입이 지정된 서드파티 API 래퍼 (Ahrefs, Slack, HubSpot 등) 로컬 커넥터 디스패처
자동화 예약된 스크립트, 예약된 에이전트 실행 및 트리거 기반 실행 워크스페이스에 등록된 자동화
웹훅 및 트리거 서드파티 신호에 대한 이벤트 기반 반응 커넥터 트리거 + 임시
스킬 에이전트가 필요 시 읽는 재사용 가능한 플레이북 ~/workspace/skills/ + 플랫폼
메모리 플래그를 지정한 사실의 채팅 간 지속성 ~/workspace/.memory.md
리서치 웹 검색, 페이지 가져오기, 출처가 포함된 다단계 종합 내장
LLM 액세스 로컬 프록시를 통한 300개 이상의 모델 호출 로컬 LLM 프록시
파일 내보내기 샌드박스 안전 렌더링 경로에서 PDF 및 PNG 생성 내장 (PDF 스킬 참조)

파일

Letaido는 워크스페이스에 대한 읽기/쓰기/편집 권한을 가지고 있습니다. 파일을 임시 작업 공간이 아닌 작업의 결과물로 취급합니다.

  • 초안, 메모, 리서치 자료는 마크다운으로 저장됩니다.
  • 코드, 생성기, 일회성 스크립트는 .py 파일로 저장됩니다.
  • 채팅에 업로드한 파일은 ~/workspace/uploads/에 저장되며 절대 경로로 참조됩니다.
  • 공유하려는 파일은 ~/workspace/downloads/에 저장되며 등록된 다운로드 URL을 통해 게시됩니다.

수행하지 않는 작업: 워크스페이스 외부의 플랫폼 내부에 쓰기, 파일 소유권 변경 또는 다른 워크스페이스 접근.

데이터베이스

PostgreSQL이 유일한 영구 저장소입니다. SQLite, 디스크의 JSON, 재시작 시 사라지는 인메모리 딕셔너리는 사용하지 않습니다.

세 가지 데이터베이스는 각각 다른 대상을 가지고 있습니다(데이터 및 저장소에서 다룹니다): - console_db는 내부 도구 및 비공개 상태를 위한 것입니다. - site_db는 공개 사이트가 제공하는 콘텐츠를 위한 것입니다. - console_site_db는 명시적인 교차 표면 채널을 위한 것입니다.

내부 웹 앱(콘솔)

Agent-A---Console.gif

사용자가 "X를 붙여넣고 Y를 얻을 수 있는 페이지"를 요청하면, 아티팩트는 콘솔 애플리케이션입니다: Python 블루프린트와 Jinja 템플릿으로 구성되며, 회원 전용 Flask 앱에 자동으로 등록됩니다.

  • 라우트는 예측 가능한 URL(/applications/<slug>/)에 존재합니다.
  • 페이지는 데이터베이스에서 읽고, 커넥터를 호출하며, 결과를 렌더링할 수 있습니다.
  • 앱은 파일 변경 시 자동으로 재시작되므로 flask run을 수동으로 실행할 필요가 없습니다.

공개 웹 앱 (공개 사이트)

Agent-A---Public-site.gif

자체 데이터베이스 역할과 세 가지 가시성 모드(비활성화, 인증됨, 공개)를 갖춘 오픈 인터넷을 제공하는 별도의 Flask 프로세스입니다. 고객 대면 페이지, 리드 생성 플로우, 공개 보고서 및 이 문서가 여기에 있습니다.

공개 사이트는 콘솔이 작성한 사전 계산된 데이터를 읽을 수 있지만, 콘솔 내부 상태에는 접근할 수 없습니다. 이러한 분리는 관례가 아닌 OS 및 데이터베이스 수준에서 강제됩니다.

커넥터

Agent-A---Connectors.gif

타사 API를 감싸는 타입 래퍼입니다. 디스커버리는 트리 구조(제공자 → 카테고리 → 커넥터)이며, 모든 호출이 기록되고, 모든 자격 증명은 범위가 지정되며, 모든 새로운 표면(채팅, 콘솔, 사이트)은 자체 승인이 필요합니다.

오늘 연결된 항목들을 일반적인 용도별로 그룹화했습니다:

  • SEO 및 마케팅 인텔리전스: Ahrefs(전체 제품군), Semrush, Apify, Firehose.
  • CRM 및 영업: HubSpot, Gong, Chargebee, Stripe.
  • 커뮤니케이션 및 협업: Slack, Notion, Linear, GitHub.
  • 콘텐츠 및 이메일: WordPress, Mailchimp, Resend, SendGrid, Fathom.
  • 데이터 및 운영: Airtable.
  • 인프라: Cloudflare, DNSimple.

새로운 제공업체가 정기적으로 추가됩니다. 워크스페이스의 커넥터 탭에서 실시간 목록을 확인하십시오.

자동화

Agent-A---Jobs.gif

반복 작업은 채팅에서 "나중에 알림"으로 존재하는 것이 아니라 등록된 자동화로 존재합니다. 자동화는 크론으로 실행되는 Python 스크립트, 고정된 프롬프트로 실행되는 예약된 에이전트 채팅, 또는 타사 이벤트에서 실행되는 트리거 기반 실행 중 하나입니다. 각 자동화는 소유자/관리자의 승인을 위해 제출되며, 승인 후 일정에 따라 실행되고 모든 실행에 대해 stdout 및 stderr이 캡처됩니다.

일반적인 요청: 주간 경쟁사 스캔, 일일 트래픽 스냅샷, 시간별 브랜드 레이더 새로고침, 이 문서를 업데이트하는 것과 같은 월요일 아침 다이제스트입니다.

웹훅과 트리거

Letaido는 폴링뿐만 아니라 리스닝도 할 수 있습니다. 커넥터 트리거(Slack 메시지, GitHub 이벤트, Linear 상태 변경, HubSpot 레코드 변경)는 앱이나 작업이 소비하는 로컬 큐로 이벤트를 전달합니다.

커넥터 트리거가 없는 서비스의 경우에도 명시적 확인 기능이 있는 임시 웹훅 경로가 있어 이벤트가 자동으로 삭제되지 않습니다.

기술

Agent-A---Skills.gif

스킬은 SKILL.md 파일과 지원 자산이 포함된 폴더입니다. 에이전트는 작업이 일치할 때 필요에 따라 이를 읽습니다. 일부 스킬은 플랫폼에서 제공되며(Postgres, Pydantic, PDF 내보내기, 웹 검색), 다른 스킬은 워크스페이스별로 ~/workspace/skills/에 저장됩니다. 여기에는 팀의 브랜드 보이스, 디자인 매뉴얼, 게시물 뱅크, 마케팅 전략이 포함됩니다.

스킬은 레타이두가 모든 채팅에 상용구로 누출되지 않으면서 귀하의 하우스 스타일을 학습하는 방법입니다.

메모리

Agent-A---Memory.gif

Letaido는 모든 대화 시작 시 ~/workspace/.memory.md 파일을 읽습니다. "이것을 기억해: X"라고 말하면 해당 내용이 추가됩니다. 기억하기 좋은 것: 역할, 반복되는 어휘, 문체 규칙, 장기 목표. 기억하면 안 되는 것: 민감한 정보, 매주 변경되는 내용.

에이전트가 각 의미 있는 변경 사항 이후에 추가하는 변경 로그(progress.md)도 있으므로, 세션 전반에 걸쳐 발생한 일을 재구성할 수 있습니다.

리서치

  • 강조 표시된 발췌문과 함께 오픈 웹 전체를 검색합니다(충분히 자주 제공되어 페치를 절약합니다).
  • 깔끔한 마크다운으로 페이지를 가져옵니다(광고, 내비게이션, 보일러플레이트 제거).
  • 작업 범위가 넓을 때 검색과 종합을 번갈아 가며 수행하는 다단계 리서치를 진행합니다.
  • 업로드된 PDF, 대본, 프레젠테이션을 읽고 구조화된 출력을 추출합니다.

레타이두는 기본적으로 출처를 인용하며, 주장을 확인할 수 없을 때 이를 알려줍니다.

LLM 접근

Agent-A---AI-bots.gif

레타이두 자체는 LLM을 통해 추론합니다. 또한 로컬 프록시를 통해 앱과 작업에 해당 기능을 제공합니다. 즉, 어떤 코드든 API 키를 처리하지 않고도 최신 Claude, GPT, Gemini 및 300개 이상의 다른 모델을 호출할 수 있습니다. 이는 에이전트가 구축하는 콘솔 앱과 백그라운드 작업이 레타이두와 대화하는 채팅뿐만 아니라 내부에서 AI 에이전트와 LLM 호출을 직접 실행할 수 있음을 의미합니다.

이는 "URL을 입력받아 우리 브랜드 보이스로 90초짜리 비디오 스크립트를 반환하는 앱"이나 매시간 LLM으로 인바운드 HubSpot 리드를 분류하는 작업과 같은 기능을 구동합니다.

파일 내보내기

샌드박스 안전 경로에서 PDF 및 PNG 생성. 이 샌드박스 내에서 작동하는 라이브러리(Pillow, ReportLab, 헤드리스 경로)와 피해야 할 라이브러리(대부분의 웹 캔버스 기반 익스포터)를 나열하는 전용 스킬이 있습니다.

"이 보고서의 PDF"를 요청하면, 에이전트는 추측하는 대신 먼저 스킬을 읽어 작동하는 경로를 선택합니다.

내부 작동 원리. 위의 각 기능은 소수의 기본 요소로 매핑됩니다: 파일 쓰기, SQL 쿼리, Flask 블루프린트, cron 항목, 웹훅 구독, 커넥터 호출. 에이전트는 기본 요소를 발명하지 않습니다. 이를 조합합니다. 그렇기 때문에 "Y마다 X를 수행하고 Z에 알리는 것을 만들어줘"라는 형태의 요청이 신뢰할 수 있는 것입니다.

Last updated 2026-07-15