Reasoning Engine API는 생성형 AI 애플리케이션에서 맞춤설정된 에이전트 워크플로에 대한 관리형 런타임을 제공합니다. LangChain과 같은 조정 프레임워크를 사용하여 애플리케이션을 만들고 Reasoning Engine으로 배포할 수 있습니다. 이 서비스는 Vertex AI 통합의 모든 보안, 개인 정보 보호, 관측 가능성, 확장성 이점을 제공합니다.
Reasoning Engine에 대한 자세한 개념 정보는 애플리케이션 배포를 참조하세요.
제한사항
- Reasoning Engine API는 Python 조정 프레임워크만 지원합니다.
- Reasoning Engine API는
us-central1
리전에서만 지원됩니다.
예시 구문
추론 엔진 리소스를 만들고 등록하는 구문입니다.
Python
class SimpleAdditionApp: def query() -> str: """ ... """ return ... reasoning_engine = reasoning_engines.ReasoningEngine.create( SimpleAdditionApp(), display_name="", description="", requirements=[...], extra_packages=[...], )
매개변수 목록
매개변수 | |
---|---|
display_name |
필수:
|
description |
선택사항:
|
spec |
필수:
|
package_spec |
필수: 피클링된 객체 및 패키지 요구사항과 같은 사용자가 제공한 패키지 사양입니다. |
class_methods |
선택사항: 객체 클래스 메서드에 대한 선언입니다. |
PackageSpec
PackageSpec에는 OpenAPI YAML 파일을 저장하는 Cloud Storage URI에 대한 참조가 포함됩니다.
매개변수 | |
---|---|
pickle_object_gcs_uri |
선택사항: 피클링된 Python 객체의 Cloud Storage URI입니다. |
dependency_files_gcs_uri |
선택사항: 확장자가 |
requirements_gcs_uri |
선택사항:
|
python_version |
선택사항: Python 버전입니다. 지원되는 버전으로는 Python |
QueryReasoningEngine
매개변수 | |
---|---|
input |
|
예시
기본 앱 구성 배포
다음 예시에서는 Reasoning Engine을 사용하여 두 개의 정수와 원격 앱을 추가하는 애플리케이션을 사용합니다.
Python
Vertex AI SDK for Python을 설치하거나 업데이트하는 방법은 Vertex AI SDK for Python 설치를 참조하세요. 자세한 내용은 Python API 참고 문서를 확인하세요.
고급 앱 구성 배포
다음은 LangChain의 체인, 프롬프트 템플릿, Gemini API를 사용하는 고급 예시입니다.
Python
Vertex AI SDK for Python을 설치하거나 업데이트하는 방법은 Vertex AI SDK for Python 설치를 참조하세요. 자세한 내용은 Python API 참고 문서를 확인하세요.
Reasoning Engine 쿼리
Reasoning Engine을 쿼리합니다.
이 예시에서는 기본 앱 구성 배포 예시의 SimpleAdditionApp
클래스를 사용합니다.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: 프로젝트 ID입니다.
- LOCATION: 요청을 처리하는 리전입니다.
us-central1
여야 합니다. - REASONING_ENGINE_ID: 추론 엔진의 ID입니다.
- INPUT:
protobuf.struct:
input
내부의 인수는 기본 앱 구성 배포 중에 정의된def query(self, question: str)
메서드 내부의 인수와 일치해야 합니다.
HTTP 메서드 및 URL:
POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID:query
JSON 요청 본문:
{ "input": { INPUT } }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID:query"
PowerShell
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID:query" | Select-Object -Expand Content
Python
Vertex AI SDK for Python을 설치하거나 업데이트하는 방법은 Vertex AI SDK for Python 설치를 참조하세요. 자세한 내용은 Python API 참고 문서를 확인하세요.
Reasoning Engine 나열
프로젝트의 추론 엔진을 나열합니다.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
HTTP 메서드 및 URL:
GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
다음 명령어를 실행합니다.
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines"
PowerShell
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines" | Select-Object -Expand Content
Python
Vertex AI SDK for Python을 설치하거나 업데이트하는 방법은 Vertex AI SDK for Python 설치를 참조하세요. 자세한 내용은 Python API 참고 문서를 확인하세요.
Reasoning Engine 가져오기
추론 엔진의 세부정보를 가져옵니다.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: 프로젝트 ID
- PROJECT_ID: 프로젝트 ID
- LOCATION: 요청을 처리하는 리전입니다.
us-central1
여야 합니다. - REASONING_ENGINE_ID: 추론 엔진의 ID입니다.
HTTP 메서드 및 URL:
GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
다음 명령어를 실행합니다.
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID"
PowerShell
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID" | Select-Object -Expand Content
Python
Vertex AI SDK for Python을 설치하거나 업데이트하는 방법은 Vertex AI SDK for Python 설치를 참조하세요. 자세한 내용은 Python API 참고 문서를 확인하세요.
Reasoning Engine 삭제
추론 엔진을 삭제합니다.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: 프로젝트 ID입니다.
- LOCATION: 요청을 처리하는 리전입니다.
us-central1
여야 합니다. - REASONING_ENGINE_ID: 추론 엔진의 ID입니다.
HTTP 메서드 및 URL:
DELETE https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
다음 명령어를 실행합니다.
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID"
PowerShell
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID" | Select-Object -Expand Content
Python
Vertex AI SDK for Python을 설치하거나 업데이트하는 방법은 Vertex AI SDK for Python 설치를 참조하세요. 자세한 내용은 Python API 참고 문서를 확인하세요.
다음 단계
- Vertex AI 클라이언트 라이브러리 사용 자세히 알아보기