Confluence API 연동: 위키 조회와 JSON 출력 설정
작성: Ai Flowi · 게시일
공식 출처: Confluence Cloud REST API 문서
Confluence API 연동은 사이트 URL, 사용자 이름, API 키, 스페이스 키로 설정하는 위키 원본 컴포넌트를 제공합니다. 이를 사용해 접근이 허용된 스페이스의 콘텐츠를 후속 문서 워크플로에 사용할 수 있는지 조사합니다. AI Flowi Workflow의 내보낸 Confluence 인터페이스에는 JSON 출력이 있으며, 문서화된 페이지 쓰기 작업은 없습니다.
Confluence는 카탈로그에 문서화되어 있지만, Ai Flowi가 프로덕션 환경에서 테스트하지는 않았습니다. 카탈로그 설명은 Confluence 위키 협업 플랫폼
입니다. 아래 설정으로 스페이스를 읽는 것은 설정 예시이며, 기록된 테스트가 아닙니다.
1. 접근이 허용된 원본 범위 선택
연결 참고 자료에 따라 본인의 위키 계정에 선택한 스페이스 접근 권한을 부여합니다. 해당 계정에 맞춰 사이트 주소와 배포 유형을 확인하고, 첫 확인은 접근이 허용된 합성 페이지로 제한합니다.
스페이스 키는 요청할 원본을 선택하지만, 모든 페이지를 읽을 권한을 만들지는 않습니다. 요청에 어떤 계정이 사용되는지 확인하고 반환된 자료를 해당 계정에서 볼 수 있는 페이지와 비교합니다. 후속 복사본은 다른 사람이 볼 수 있으므로, 비공개 위키 텍스트를 다른 서비스로 옮기기 전에 대상을 검토합니다.
이 원본 규약은 다른 서비스와 함께 컴포넌트를 나열하는 컴포넌트 카탈로그를 보완합니다. 제품 전반에 이미 문서화된 자격 증명 방식은 연결을 사용합니다. 위키 API 키를 Google OAuth 연결로 취급하지 않습니다.
2. 내보낸 입력 일곱 개 작성
필드 여섯 개가 필수로 표시되어 있습니다. max_pages만 선택 사항입니다. 이 필드를 생략하면 페이지 수 동작이 검증되지 않은 상태로 남으며, 생략 시 스페이스 전체를 읽는다는 근거가 되지 않습니다.
| 필드 | 결정할 사항 | 유형 / 필수 여부 | 연결 유형 / 선택값 |
|---|---|---|---|
api_key | 비공개 필드에 본인의 원본 자격 증명을 설정합니다. 여기서는 자격 증명 발급 절차를 확립하지 않습니다. | str / 필수 | Wiki: input_types가 []임 |
cloud | 배포 환경에 맞는 불리언 값을 선택합니다. 실행 시 해석 방식은 내보내지지 않았지만 필수 항목입니다. | bool / 필수 | Wiki: input_types 생략됨 |
content_format | 나열된 본문 형식 중 하나를 선택하고, 대상 형식을 지정하기 전에 실제 표현을 확인합니다. | str / 필수 | Wiki: input_types 생략됨; 선택값: "body.editor", "body.export_view", "body.anonymous_export_view", "body.storage", "body.view" |
max_pages | 조회 범위를 확인하는 동안 의도적으로 작은 정수를 사용합니다. 기본값, 최댓값 또는 페이지네이션 규약은 나열되어 있지 않습니다. | int / 선택 | Wiki: input_types 생략됨 |
space_key | 본인의 위키에서 확인한 원본 스페이스 식별자를 입력합니다. 표시 제목이 식별자와 같은 경우가 아니라면 제목을 입력하지 않습니다. | str / 필수 | Wiki: input_types 생략됨 |
url | 사용하려는 Confluence 사이트 주소를 입력하고, 편집기에서 엔드포인트 요건을 확인합니다. | str / 필수 | Wiki: input_types 생략됨 |
username | 배포 환경과 자격 증명 방식에서 요구하는, 권한 있는 계정 식별자를 입력합니다. | str / 필수 | Wiki: input_types 생략됨 |
3. 확인할 본문 표현 결정
content_format의 선택값은 "body.editor", "body.export_view", "body.anonymous_export_view", "body.storage", "body.view"입니다. 이는 카탈로그의 정확한 옵션 문자열입니다. 이름만으로 일반 텍스트 출력, 이식 가능한 문서 형식 또는 페이지 매크로 보존을 확인할 수는 없습니다.
합성 데이터를 조사할 때는 "body.view"를 선택하고 반환된 텍스트를 화면에 보이는 위키 페이지와 비교합니다. 대상에 일반 텍스트가 필요하다면 변환 방식을 선택하기 전에 반환된 위키 본문에 마크업이 있는지 확인합니다. 본문 형식 값에 ‘export’가 포함되어 있다고 해서 첨부 파일, 댓글 또는 개정 이력을 포괄한다고 판단할 수는 없습니다.
"body.anonymous_export_view"를 선택해도 필수 사용자 이름 및 API 키 필드가 필요 없어지는 것은 아닙니다. 카탈로그는 선택한 형식과 관계없이 이러한 필수 입력을 유지합니다. 옵션 이름에서 인증 동작을 추론하지 말고 접근을 명시적으로 테스트합니다.
4. 범위를 제한한 원본 조사 실행
- 제목과 본문을 확인할 수 있는 콘텐츠가 있는, 접근이 허용된 소규모 테스트 스페이스를 만들거나 선택합니다. 계정이 접근할 것으로 예상되는 페이지를 기록합니다.
- Confluence를 추가합니다. 본인의 원본 설정으로
url,username,api_key,space_key를 설정합니다. 해당 환경에 맞는cloud값을 선택합니다. - 이 확인을 위해
content_format을"body.view"로 설정하고, 상한 예시로max_pages를2로 설정합니다. 선택한 개수는 기록된 출력이나 완전성을 주장하는 값이 아닙니다. - JSON 출력
data를 살펴봅니다. 실제 페이지 텍스트, 식별자, 존재하는 원본 참조를 찾습니다. 내보내기 자료에는 결과 키 스키마가 없으므로 이름을 임의로 만들지 말고 확인합니다. - 반환된 페이지를 예상 테스트 집합과 비교합니다. 계정이 페이지를 읽을 수 없을 때와 선택한 페이지 제한에 도달했을 때 어떤 일이 일어나는지 확인합니다.
- 구조를 확인한 후에만 JSON을 허용하는 수신 컴포넌트를 설정합니다. 후속 변환을 확인할 수 있도록 첫 원본 결과를 보관합니다.
5. 출력을 완성된 문서가 아닌 원본으로 취급
출력 표시 이름은 JSON이고 포트는 data이며, 선언된 유형도 JSON입니다. 이 컴포넌트에는 내보낸 Table, Message 또는 별도의 오류 포트가 없습니다. 이 차이에 따라 어떤 후속 노드가 출력을 직접 받을 수 있는지 결정됩니다.
위키 본문을 대상 텍스트로 바꾸는 방식을 정할 때는 Parser를 검토합니다. 검토할 스냅샷에 포함할 위키 페이지 선택은 Confluence에서 Google Docs로 옮기는 가이드를 확인합니다.
Confluence 연동의 위키 조회 범위 제한은 무엇인가요?
이 카테고리는 페이지 생성, 페이지 편집, 댓글 또는 이벤트 트리거 작업을 제공하지 않습니다. 내보낸 입력에는 페이지 ID 선택 항목, 첨부 파일 토글, 증분 커서 또는 버전 이력 제어도 없습니다. 스페이스를 선택하고 페이지 수를 제한한다고 해서 모든 위키 페이지를 일관되게 읽었다고 입증할 수는 없습니다.
모든 관계, 첨부 파일, 개정 이력을 보존해야 하는 보관용 내보내기에 이 예시를 사용하지 않습니다. 원본 권한을 확인할 수 없거나 후속 텍스트를 누가 보는지 통제할 수 없다면 피합니다. 반복 실행과 서비스 오류는 본인의 환경에서 검증해야 합니다. 여기서는 결합된 흐름의 성공을 주장하지 않습니다.
목표가 벡터 검색이라면 Pinecone 규약을 따로 검토합니다. 인덱스, 네임스페이스, 임베딩 설정이 위키 접근 규칙을 자동으로 상속하지 않으므로, 원본 읽기와 검색에 각각 적절한 접근 경계가 필요합니다.
사용량 및 설정
노드를 한 번 실행할 때마다 1 Flowi Token을 사용합니다. 월별 포함 토큰은 Go 5,000개, Plus 10,000개, Pro 100 50,000개, Pro 200 100,000개, Pro 500 250,000개입니다. 데모 예약
실제 실행과 후속 노드를 계산하고, 서비스 제공업체의 제한은 별도로 검토합니다. 다른 원본 규약은 연동 목록에서 찾습니다.