튜토리얼: Gemini Code Assist를 사용하여 Apigee에서 API 설계, 개발, 테스트

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

개요

이 튜토리얼에서는 Gemini Code Assist의 @Apigee 도구를 사용하여 API 사양을 만들고 수정하는 프로세스를 설명합니다. 자연어 프롬프트를 사용하여 치과 예약 관리에 사용할 API를 설계하고 만듭니다. 사양이 준비되면 사양을 테스트하고 사양에서 Apigee API 프록시를 만들 수도 있습니다.

Gemini Code Assist를 사용하여 API 사양을 만들고 수정하는 방법에 대한 자세한 내용은 API 설계 및 수정을 참조하세요.

시작하기 전에

이 튜토리얼을 완료하려면 다음이 필요합니다.

1단계: Gemini Code Assist 채팅 열기

VS Code를 열고 Gemini Code Assist 채팅 아이콘을 클릭합니다. 채팅 창이 표시됩니다.

Cloud Code Gemini Code Assist 채팅

2단계: Apigee 도구를 사용하도록 Apigee 핸들 입력

채팅 창에 @Apigee를 입력합니다. Apigee 프롬프트 목록이 표시됩니다. API 사양 만들기를 선택합니다.

Apigee 도구가 포함된 Cloud Code Gemini Code Assist 채팅 창

3단계: 프롬프트 입력

입력란에 다음 설명을 입력하고 제출하여 프롬프트를 완성합니다.

@Apigee Create an API specification for patients to schedule their own appointments with a dental office. Include multiple dentists and a dental appointment type, which can be regular checkup or other.

생성 프롬프트가 표시된 Cloud Code Gemini Code Assist 채팅 창

4단계: 사양 보기

Gemini Code Assist에서 사양을 생성하는 동안 기다립니다. 사양을 사용할 수 있게 되면 채팅 창에 API 허브 및 API 엔드포인트에서 활용된 엔터프라이즈 컨텍스트 요약을 포함한 생성된 사양에 대한 정보가 표시됩니다. Cloud Code의 다른 탭에는 새 API 사양에 대한 엔드포인트, 스키마, 기타 정보가 포함된 사양 코드와 Swagger 인터페이스가 표시됩니다.

사양 엔드포인트를 보여주는 Cloud Code Gemini Code Assist 채팅

5단계: 사양 수정

여러 치과 위치가 포함되도록 사양을 수정합니다. 먼저 사양이 포함된 YAML 파일이 현재 편집기에서 활성화된 탭에 있는지 확인합니다. 그런 다음 채팅 창에서 Apigee 핸들을 다시 입력하고 Apigee 도구 @Apigee를 선택합니다. 다음 프롬프트를 입력합니다.

@Apigee Update the API specification for the dental scheduling API. Add multiple dental office locations.

편집 탭에 차이점이 강조 표시된 사양 변경사항이 표시됩니다. 편집 탭에 직접 업데이트를 입력하고 파일을 저장하여 사양을 수정할 수도 있습니다.

Cloud Code Gemini Code Assist의 수정된 코드

6단계: API 허브에 API 게시

API를 검토하고 완료한 후에는 이를 API 허브에 등록하여 개발자에게 제공합니다.

  1. API 허브에 게시를 클릭합니다.
  2. 메시지를 따라 API를 게시/등록합니다. API 허브에 등록하는 방법과 제공해야 하는 정보는 API 등록을 참고하세요.

7단계: 로컬 모의 서버를 사용하여 API 테스트

API 응답을 에뮬레이션하는 로컬 모의 서버를 사용하여 API를 테스트합니다. 로컬 모의 서버를 API 허브에 게시할 필요가 없습니다.

서버 드롭다운에서 로컬 모의 서버가 이미 선택되어 있어야 합니다.
드롭다운의 Cloud Code Gemini Code Assist 로컬 모의 서버

로컬 모의 서버를 선택한 후 POST 경로를 열고 사용해 보기를 클릭합니다.

addresses 항목의 요청 본문에 'city', 'country', 'postalCode' 값을 제공합니다.

{
    "city": "string",
    "country": "string",
    "postalCode": "string",
    "state": "string",
    "streetAddress": "string"
  }

실행을 클릭하여 응답 섹션에서 API의 모의 응답을 확인합니다.

8단계: 이 사양으로 API 프록시 번들 만들기

(선택사항) 이 사양에서 Apigee API 프록시 번들을 만들려면 API 프록시 번들 만들기 버튼을 클릭하고 프록시 이름을 입력합니다. 생성되면 Apigee 작업공간의 apiproxies 아래에 새 프록시가 표시됩니다. Cloud Code에서 API 프록시를 사용하는 방법은 API 프록시 개발을 참조하세요.

다음 단계