Leina가 OpenConnector를 통해 비즈니스 앱을 연결하는 방법
Leina의 OpenConnector 권한 부여 게이트웨이, provider, action, 계정 권한의 차이, 그리고 읽기 전용 작업으로 연결을 검증하는 방법을 살펴봅니다.
개념 설명: 작업이 액세스 게이트웨이를 통해 권한이 부여된 비즈니스 앱에 도달합니다.
AI 에이전트가 회의록을 요약하거나, 고객 업데이트를 정리하거나, 비즈니스 스프레드시트를 수정하려면 먼저 관련 시스템에 접근할 수 있어야 합니다. 실질적인 질문은 구체적입니다. 어떤 계정이 연결되어 있는가, 어떤 작업을 사용할 수 있는가, 어떤 레코드에 접근할 수 있는가?
Leina는 자체 보안 권한 부여 게이트웨이인 OpenConnector를 통해 비즈니스 앱을 연결합니다. 게이트웨이는 앱 호출에 대한 권한 부여를 제공합니다. 실제 사용 가능한 범위는 커넥터 지원, 비즈니스 계정 권한, 팀 설정에 따라 달라집니다.
게이트웨이와 그에 딸린 도구들은 공개 소스 코드를 가지고 있습니다. 오픈 소스 페이지에서 범위, 커뮤니티 기여, 독립적인 사용 경로를 살펴보거나, 보안 연결과 오픈 소스 약속에 대해 읽어보세요.
정의된 작업에서 시작해 그에 필요한 기능과 접근 권한을 역으로 따져보세요. 이렇게 하면 연결을 더 쉽게 검증할 수 있고, 좁은 작업을 위해 광범위한 접근 권한을 부여하는 일을 피할 수 있습니다.
1,500개의 Provider와 16,000개의 Action은 무엇을 의미하나요?
발행 시점의 제품 지원 범위를 기준으로, OpenConnector 게이트웨이는 1,500개 이상의 provider와 16,000개 이상의 action을 지원합니다. 이 수치는 서비스 및 작업 지원 범위를 나타냅니다. 특정 기능은 현재 디렉터리와 커넥터에서 확인하세요.
| 개념 | 의미 | 확인할 사항 |
|---|---|---|
| Provider | 연결할 수 있는 서비스 | 팀의 비즈니스 앱을 사용할 수 있는가? |
| Action | 해당 커넥터가 노출하는 작업 | 필요한 검색, 생성, 업데이트를 지원하는가? |
| 계정 권한 | 해당 서비스 내에서 계정의 접근 범위 | 대상 워크스페이스, 폴더, 레코드에 접근할 수 있는가? |
지원되는 provider가 해당 서비스의 모든 기능을 노출하는 것은 아닙니다. 지원되는 action이 연결된 계정에 모든 데이터에 대한 접근 권한을 주는 것도 아닙니다. 예를 들어, 커넥터가 문서 검색을 지원하더라도 계정이 특정 프로젝트 폴더에 접근할 수 없을 수 있습니다.
서비스 지원 범위는 팀에 선택지를 제공하고, 적절한 연결과 권한 부여 범위가 해당 작업의 성공 여부를 결정합니다.
앱 접근에서 게이트웨이의 역할
Leina의 비즈니스 앱 접근은 OpenConnector를 통과합니다. 팀은 연결 과정을 통해 계정을 권한 부여하고, 멤버, 그룹, 앱 측 권한을 통해 사용 가능한 접근 범위를 정의합니다.
작업에서 권한이 부여된 호출까지
flowchart TB
accTitle: 작업에서 권한이 부여된 호출까지
accDescr: Leina는 OpenConnector를 사용해 권한이 부여된 계정을 통해 앱 작업에 접근합니다. 사용 가능한 action과 데이터 범위를 모두 확인해야 합니다.
T("정의된 작업"):::channel
T --> L("Leina"):::agent
L --> G("OpenConnector
권한 부여 게이트웨이"):::gateway
G --> A("승인된 계정
접근 가능한 데이터"):::resource
G --> O("지원됨
앱 작업"):::resource권한 부여는 앱 호출 아키텍처의 일부입니다. 어떤 연결을 사용할 수 있는지, 계정이 어떤 권한을 가지는지, 누가 결과를 받는지는 여전히 구성으로 정해야 합니다. 게이트웨이가 그러한 결정을 대신하지는 않습니다.
채팅에 비밀번호나 원시 액세스 토큰을 붙여넣지 말고 연결 흐름을 통해 계정을 권한 부여하세요. 계정 및 작업 범위 지침은 권한 및 데이터 접근을 참고하세요.
하나의 작업에서 역으로 따져보기
이번 주 프로젝트 회의록을 요약하는 작업이라면, 연결하기 전에 네 가지를 정하세요.
- 소스: 회의록이 들어 있는 앱, 프로젝트, 폴더.
- 작업: 검색 및 읽기 접근. 이 작업에는 업데이트나 삭제 작업이 필요하지 않습니다.
- 범위: 프로젝트 이름, 날짜 범위, 추출할 필드.
- 출력: 보존할 대상과 소스 링크.
통합에서 서비스를 찾고, 필요한 작업을 확인한 다음, 연결을 통해 적절한 계정을 권한 부여하세요. 계정이 소스 레코드에 접근할 수 없다면, 프롬프트만 바꿔서는 권한 부여 문제가 해결되지 않습니다.
검증 가능한 요청으로 연결을 테스트하세요.
연결된 문서 앱에서 이번 주 Project A 회의록을 찾아주세요. 회의 날짜, 결정 사항, 담당자, 소스 링크를 반환하세요. Project A 자료만 읽고 문서를 변경하지 마세요. 누락된 정보는 누락으로 표시하세요.
작업을 반복 워크플로로 전환하기 전에 소스와 날짜 범위가 정확한지, 누락 사항이 정확히 보고되는지 확인하세요.
읽기에서 쓰기로 넘어가기 전에 접근 권한 다시 확인하기
읽기, 생성, 업데이트, 삭제는 서로 다른 요구 사항입니다. 정확한 요약을 생성한다고 해서 소스 시스템을 수정할 권한이 확보되는 것은 아닙니다.
회의 action을 비즈니스 테이블에 쓰려면 커넥터 지원, 계정 권한, 대상 테이블과 필드를 확인하세요. 다음과 같은 요청으로 시작하세요.
방금 검증한 회의 action에서 추가할 행을 준비하세요. 대상 테이블, 필드, 값을 나열하세요. 아직 아무것도 쓰지 말고 초안을 반환하세요.
실행을 요청하기 전에 대상, 영향을 받는 레코드, 값을 검토하세요. 이는 권장 작업 과정이며, 모든 커넥터가 동일한 승인, 초안, 롤백 기능을 갖추고 있다는 의미는 아닙니다.
연결된 앱이 여전히 누락된 데이터를 반환할 수 있는 이유는 무엇인가요?
다음 가능성을 순서대로 확인하세요.
- 서비스와 작업: 앱이 해당 작업에 필요한 action을 지원하는가?
- 계정: 연결된 계정이 대상 레코드에 접근할 수 있는 계정인가?
- 범위: 워크스페이스, 프로젝트, 폴더, 레코드가 해당 계정의 접근 범위 안에 있는가?
- 팀 권한: 현재 멤버나 그룹이 해당 연결과 작업을 사용할 수 있는가?
- 연결 상태: 인터페이스가 만료된 권한 부여나 연결 오류를 보고하면, 현재 연결 흐름에 따라 해결하세요.
부분 결과는 완전한 지원 범위를 의미하지 않습니다. 소스 링크를 보존하고, 중요한 요약은 예상 범위와 비교하세요. 문제가 여전히 불분명하면 자격 증명을 포함하지 말고 앱 이름과 오류 세부 정보를 가지고 지원에 문의하세요.
연결 범위를 검증 가능하게 만들기
광범위한 커넥터 지원 범위는 Leina가 팀의 기존 도구를 더 많이 활용하도록 돕습니다. 작업에서 시작해 그 action, 계정, 데이터 요구 사항을 확인한 다음, 읽기 전용 요청으로 결과를 검증하세요.
공유 사용에 대해서는 멤버 및 그룹 권한을 이어서 참고하세요. 진입점 관계는 채팅 플랫폼 전반의 하나의 에이전트를, 더 넓은 제품 소개는 Leina 개요를 읽어보세요.