AiBLE의 기억과 원문 근거를 업무 서비스에 연결하세요

회의와 자료에서 정리한 기억을, 사용자가 볼 권한이 있는 범위 안에서 녹음 위치와 인용까지 함께 돌려줍니다. 연결 방법을 고르고 시험 환경에서 첫 근거 검색을 재현해 보세요.

POST/v1/search합성 예시

시범 운영 일정이 왜 밀렸나요?

도입 일정 4주 연기 후보

장비 납기가 늦어 시범 운영을 4주 미룹니다.

녹음 00:32–00:4011월 3일 주간 회의

연결 방식 고르기

업무 시스템이 서버에서 호출합니다. OpenAPI 명세를 가져와 연결합니다.

AI 도구가 사용자의 권한으로 공간·기억을 조회하고 근거를 검색합니다.

설치 경험이 필요한 플랫폼에서 찾아 설치한 뒤 REST나 MCP로 연결합니다.

시험 환경은 운영과 주소·자격증명·데이터가 분리된 API입니다. 아직 발급 전이라, 이 문서의 직접 호출은 브라우저 안의 합성 데이터로 실행됩니다.

기준 주소	`https://sandbox.api.aible.example/v1` 자리표시자
시험 키	환경 변수 `AIBLE_TEST_KEY`로 보관합니다. 발급 전
데이터	합성 데이터 · ‘시범 운영’, ‘운영 지원’ 두 공간
계약 버전	`0.1.0-fixture` (OpenAPI 3.0.3)

네 번의 호출로 질문 “시범 운영 일정이 왜 밀렸나요?”에 대한 기억과 원문 위치를 받습니다. 각 단계의 직접 호출은 값이 채워진 상태로 열립니다.

연결과 계약 버전 확인
health는 키 없이도 응답합니다. contract_version이 기대한 값인지 확인하세요.
볼 수 있는 공간 찾기
공간은 AiBLE의 프로젝트입니다. 사용자가 볼 수 있는 공간만 돌아오며, 이후 호출에서 그 ID를 지정합니다.
공간의 기억 살펴보기
기억은 회의·자료에서 정리된 내용입니다. AI가 정리한 candidate 후보와 사람이 확정한 confirmed 지식이 있습니다. 상세 조회에서 원문 근거와 이력을 봅니다.
질문으로 근거 검색
근거는 기억이 나온 원문 인용과 위치입니다. 녹음이면 초 단위 구간, 문서면 쪽 번호가 붙습니다.
권한 없는 요청 확인
같은 공간을 볼 권한이 없는 사용자가 지정하면 검색하지 않고 403 FORBIDDEN_SPACE를 돌려줍니다. 응답에 기억 내용이 없는지 확인하세요.

다음 단계: 인증과 권한에서 설치 인증과 사용자 위임의 차이를 확인하고, 공통 규칙에서 오류·커서·재시도를 읽어 보세요.