A Letaido / docs
DOCUMENTATION

커넥터

타사 통합이 작동하는 방식과 현재 연결된 항목

Agent-A---Connectors.gif

커넥터란 무엇인가

커넥터는 서드파티 API를 감싸는 타입이 지정된 래퍼입니다. 에이전트가 사용자의 토큰으로 원시 HTTP 호출을 자유롭게 수행하는 대신, 모든 통합은 다음과 같은 작고 검증된 인터페이스를 통해 이루어집니다:

  • 자격 증명을 별도의 범위가 지정된 비밀 저장소에 보관합니다.
  • 스키마에 대해 입력 및 출력의 유효성을 검사합니다.
  • 새로운 표면(채팅, 콘솔, 공개 사이트)에서 처음 사용을 시도할 때 승인 카드를 표시합니다.
  • 모든 호출을 기록합니다.

이는 콘솔 페이지에서 Slack을 호출하는 것과 채팅 에이전트가 Slack을 호출하는 것이 별도로 승인되어야 하는 서로 다른 작업이라는 의미입니다. 기본 토큰은 공유될 수 있지만 말입니다.

현재 이용 가능한 기능

각 도구로 일반적으로 구축하는 것을 기준으로 그룹화했습니다.

SEO 및 콘텐츠 (Ahrefs)

사이트 익스플로러, 키워드 익스플로러, 콘텐츠 익스플로러, 순위 트래커, 사이트 감사, 브랜드 레이더, GSC 통합, 웹 애널리틱스, 경쟁 분석, 로컬 SEO, 보고서 빌더, 알림, 일괄 분석, AI 콘텐츠 헬퍼, 소셜 미디어 매니지먼트, 대시보드. 전체 Ahrefs 제품군이 연결되어 있습니다.

일반적인 요청: - "competitor.com의 상위 자연 검색 키워드 50개를 가져와서 상위 주제별로 그룹화해 주세요." - "우리의 우선순위 프롬프트 10개에 대해 일일 브랜드 레이더 확인을 설정하고 변경 사항이 있으면 Slack으로 알려주세요."

커뮤니케이션 및 운영

  • Slack. 메시지, DM, 채널 읽기, 반응, 파일 업로드. 두 개의 토큰(봇, 사용자)으로 에이전트가 사용 사례에 따라 봇 또는 사용자로 게시할 수 있습니다.
  • Notion. 페이지, 데이터베이스, 검색, 댓글 스레드.
  • Linear. 이슈, 프로젝트, 댓글, 상태 변경 시 트리거.
  • GitHub. 리포지토리, PR, 이슈, 릴리스, 웹훅 트리거.

CRM 및 수익

  • HubSpot. 연락처, 회사, 거래, 티켓, 목록, 워크플로우, 속성.
  • Stripe. 고객, 구독, 인보이스, 청구, 이벤트.
  • Gong. 통화, 대화 내용, 스니펫, 스코어카드.
  • Fathom. 회의 녹화, 요약, 실행 항목.

마케팅 및 이메일

  • Mailchimp. 캠페인, 목록, 세그먼트, 자동화, 보고서.
  • Resend. 트랜잭션 전송, 템플릿, 오디언스.
  • Airtable. 베이스, 테이블, 레코드, 스키마.

웹 및 데이터

  • WordPress. 게시물, 페이지, 미디어, 분류 체계(읽기 및 쓰기).
  • Apify. 빌딩 블록으로 스크레이퍼를 실행합니다.
  • Firehose. 내부 이벤트 스트림.

워크스페이스에 새 커넥터를 추가하는 방법

목록에 없는 항목을 요청하면 경로는 다음과 같습니다:

  1. 에이전트는 적합한 기존 커넥터가 있는지 확인합니다.
  2. 없는 경우, 지원팀에 문의하여 새 커넥터를 요청하세요. 모든 새 커넥터는 레타이두에 추가되기 전에 검토 및 승인되므로, 새로운 통합은 원시 HTTP 래퍼가 아닌 검증된 경로로 제공됩니다.
  3. 대기하는 동안 에이전트는 일반적으로 읽기 전용 작업을 위해 일반 API 키와 아웃바운드 도메인 허용 목록으로 대체할 수 있지만, 적절한 커넥터가 항상 선호됩니다(타입이 지정된 입력, 로깅, 범위가 지정된 자격 증명, 표면별 승인이 기본 제공됩니다).

X를 커넥터로 사용할 수 있는지 물어볼 수도 있으며, 작업 범위를 정하기 전에 확인합니다.

승인: 소유자 및 관리자를 위한 안내

2026-05-25_14-09-08.png

다음에 대한 승인 카드를 보게 됩니다:

  • 새로운 자격 증명 추가(Slack 워크스페이스, HubSpot 포털, Ahrefs 계정).
  • 해당 자격 증명을 새로운 표면에 부여(채팅 에이전트, 콘솔 페이지, 공개 사이트).
  • 새로운 도메인에 대한 아웃바운드 HTTPS 허용.
  • 새로운 Python 패키지 설치.
  • 반복 작업 예약.

패턴은 항상 동일합니다: 툴이 카드를 표시하면 한 번 클릭하고, 에이전트가 재시도합니다. 카드는 자동으로 만료되지 않으므로 에이전트가 중단되지 않고 하루 동안 검토할 수 있습니다.

내부 작동 방식. 커넥터는 버전이 지정되어 있으며 명시적인 범위 목록을 가지고 있습니다. 에이전트가 Slack 토큰을 요청할 때, 현재 계획된 모든 사용 사례에서 필요할 수 있는 모든 범위를 한 번에 요청하므로, 승인 카드가 조금씩 나타나지 않습니다. 토큰은 에이전트가 이름을 지정할 수 있지만 직접 읽을 수 없는 타입이 지정된 비밀 저장소에 저장됩니다.

Last updated 2026-07-15