AI와 공통 메타데이터

AI가 코드를 쓰기 전에 알아야 할 것

AI도 작업 목표만 듣고 API 이름을 추측해서는 정확한 코드를 만들 수 없습니다. 사용할 기능, 타입과 호출 제약, 목표 플랫폼의 지원 상태, 실제 원본 예제와 검증 결과를 같은 기준으로 읽어야 합니다.

목표 단계	공통 정보로 확인할 것	사용자가 검토할 것
능력 검색	목표 플랫폼·업무에 해당하는 지원 기능	필요한 기능이 실제로 있는지
API·타입 조회	타입·인수·반환·오류와 지원 제약	호출 의미와 실패 조건이 맞는지
예제 조회	같은 기준의 등록 원본·hash·검증 상태	실행한 예제인지 변환 설명인지
모델·코드 작성	생산자가 정한 API와 모델 연결 계약	임의 API나 provider를 넣지 않았는지
검증 피드백	실제 분석·변환·실행 진단과 위치	지원 한계·오류를 숨기지 않았는지

위 표에서 mail의 검색·조회·예제 읽기는 실제 로컬 bridge로 확인했습니다. 모델 작성·진단·생성·실행의 완료를 그 결과로 대신 판정하지 않습니다.

실제 조회 도구와 입력 schema

아래 목록과 입력 schema는 동일 compiler-backed bridge의 실제 로컬 tools/list에서 읽은 snapshot입니다. 메타데이터 검색·조회는 확인했으며 모델 쓰기·코드 생성·앱 실행은 이 Docs 검증에서 호출하지 않았습니다.

unibase.services.search

Search actual compiler-supported service libraries. Planned domains are not callable APIs.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 128
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

unibase.services.get

Get canonical typed declarations, errors, constraints, supported targets/providers, version/hash and the real example.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

unibase.sources.diagnose

Analyze supplied model source through the real compiler. Does not save models or execute code.

{
  "type": "object",
  "properties": {
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "content": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "path",
          "content"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 500
    }
  },
  "required": [
    "files"
  ],
  "additionalProperties": false
}

unibase.preview.generate

Generate code using an explicit profile through the compiler. Returns artifacts/diagnostics without writing files or starting the application. Use guarded ERWeb modeling controls for saved model changes.

{
  "type": "object",
  "properties": {
    "request": {
      "type": "object"
    }
  },
  "required": [
    "request"
  ],
  "additionalProperties": false
}

실제 resource URI는 다음과 같습니다. 예제 resource의 이름이나 생성 성공을 실행 QA 증명으로 해석하지 않습니다.

unibase://services/catalog
unibase://services/mail/example

검색은 unibase.services.search, 타입·제약·예제 조회는 unibase.services.get으로 이루어집니다. 첫 callable library는 mail이며 billing 조회는 실제 bridge에서 거절됐습니다. storage·파일 전송·preview identity도 미구현입니다. Mail 첫 계약의 타입과 provider를 같은 기준으로 읽으세요.

unibase.sources.diagnose는 실제 compiler 진단을 반환하는 도구이고 unibase.preview.generate는 명시 profile로 생성 결과를 반환하는 계약입니다. 모델이나 앱을 저장·시작하는 도구가 아닙니다. 기존 보호된 모델링 controls의 projectKey·workspace revision·dictionary hash 검사를 사용해 모델을 저장하는 흐름과 구분합니다. 임의 코드 실행 도구를 추가하지 않습니다.

사람과 AI가 같은 기준을 읽기

Docs의 API·지원표·예제와 MCP의 검색·조회 결과는 같은 생산자 기준을 가리켜야 합니다. 문서에만 추가된 메서드나 MCP에만 남은 이전 예제를 사용하지 않도록 계약 버전·생산자 기준·원본 hash·검증 환경을 함께 확인합니다.

메타데이터에 선언이 있다는 것은 실제 구현·변환·서비스 배포·QA 통과와 다릅니다. AI는 확인되지 않은 단계를 완료로 바꾸지 않고, 생산자의 실제 진단을 바탕으로 작성한 모델·코드를 수정해야 합니다. 알 수 없는 계약 버전이나 누락된 타입을 추정해 계속 진행하는 방식은 사용하지 않습니다.

AI에 요청할 때 포함할 내용

파일 전송 기능을 배우려면 다음처럼 목표와 확인 조건을 함께 전달할 수 있습니다.

선택한 목표 플랫폼에서 지원되는 파일 전송 기능을 공통 메타데이터로 확인하세요. 실제 API 타입과 제약, 등록된 원본 예제와 검증 상태를 먼저 보여 주세요. 그 계약에 맞춰 모델·코드를 작성하고 실제 진단을 설명하세요. 없는 메서드나 provider를 추측하지 말고 미지원·미검증 부분을 구분하세요.

이 문장은 실제 도구 호출 코드가 아닌 학습용 요청 예시입니다. 문서 사이트의 기존 예제 runner에 임의 작성 코드를 보내도록 허용하지 않습니다. 새 모델 작성·검증 도구의 입력 형식과 실행 범위는 MCP 계약이 확정된 뒤 안내합니다.

결과를 검토하기

SaaS 프로젝트 작성과 저장은 AI로 SaaS 작성과 Desktop 연결에서 읽으세요. 인증된 SaaS의 11개 도구는 이 페이지의 라이브러리 조회 bridge와 입력 scope가 다릅니다. 최종 합성 모델 작성·정적 분석·Desktop 편집/HTTP 동기화/재열기는 실제 근거를 받았습니다. 새 Desktop 연결 UI·강제 종료 복구·RESTORE·Mail compile/export/runtime 연결은 미완료 또는 미지원이며, metadata 조회를 실행 지원으로 확대하지 않습니다.

AI가 제시한 API·예제가 사람이 읽은 Docs와 같은 기준인지 확인하세요. 목표 플랫폼과 provider, source hash, 분석·변환·실행 상태가 연결되어야 합니다. 코드의 모양이나 성공이라는 설명만으로 실제 처리를 판정하지 않습니다.

현재 mail의 정의 검색·조회는 확인됐습니다. 모델 작성·진단·생성의 실제 사용자 흐름과 화면은 해당 담당의 검증 근거가 확인되면 추가합니다. 학습 순서와 안전한 예제의 조건을 함께 읽으세요.