Foundation Models және MCP бар файлдық сервисді жасау
VK Object Storage көмегімен файлдық қызметті жасауға болады, мұнда объектілік сақтау құрылғысы деректерді сақтаудың негізгі жүйесі болып табылады, ал Foundation Models және MCP (Model Context Protocol) қолданбаны әзірлеу мен деплойдауды жеделдетеді. VK Object Storage S3-үйлесімді API қамтамасыз етеді, бұл файлдарды жүктеп салу, жүктеу және басқару үшін стандартты SDK (мысалы, Python үшін Boto3) пайдалануға мүмкіндік береді.
Мысал ретінде кейіннен мына деректер қолданылады:
- Бакет атауы:
ai-file-service-bucket - Аймақ:
ru-msk(Мәскеу) - Endpoint URL:
https://hb.ru-msk.vkcloud-storage.ru - S3-кілттер:
<ACCESS_KEY>және<SECRET_KEY>
-
VK Object Storage қызметіне аккаунт жасаңыз, егер ол әлі жасалмаса:
-
VK Cloud жеке кабинетіне өтіңіз.
-
Жобаны таңдаңыз.
-
Object Storage → Аккаунтар бөліміне өтіңіз.
-
Добавить аккаунт немесе Добавить түймесін басыңыз.
-
Аккаунт атауын қойыңыз.
-
Создать түймесін басыңыз.
-
Ашылған терезеде қолжетімділік кілтінің идентификаторын (Access Key ID) және құпия кілтті (Secret Key) көшіріп сақтаңыз.
-
-
Мәскеу аймағында бакет жасаңыз
ai-file-service-bucket. -
AWS CLI орнатылғанын және жасалған VK Object Storage аккаунтымен жұмыс істеуге бапталғанын тексеріңіз.
-
Бакетке қосылу деректерін конфигурацияға көрсетіңіз:
[default]region = ru-mskoutput = jsons3 =addressing_style = path -
Python 3.10+ және
pipпакеттік менеджері орнатылғанын тексеріңіз. -
Boto3 — Python үшін ресми SDK орнатыңыз:
pip install boto3 -
VK Cloud Foundation Models және MCP-серверіне қолжетімділігіңіз бар екенін тексеріңіз.
Файлдық қызметтің қаңқасын жасау үшін Foundation Models пайдаланыңыз. Модель үшін тапсырманы сипаттайтын промпт құрастырыңыз: S3-үйлесімді сақтау құрылғысында сақталатын файлдарды жүктеп салу, жүктеу және оларға сілтемелер алу функциялары бар Python (Flask/FastAPI) веб-қолданбасы.
Foundation Models үшін промпт мысалы:
Python (FastAPI) негізінде файлдық қызмет үшін веб-қолданба жаса.Қолданба мыналарды орындауы тиіс:- Файлдарды HTTP POST-сұранысы арқылы қабылдап, оларды S3-үйлесімді сақтау құрылғысына (Boto3) жүктеп салу.- Жүктеп салынған файлдардың тізімін қайтару.- Файлдарды жүктеп алу үшін presigned URL жасау.- Конфигурация үшін орта айнымалыларын пайдалану (endpoint, access key, secret key, bucket name).
Жасалған кодты жобаның директориясына сақтаңыз, мысалы ai-file-service/.
VK Object Storage қызметімен Boto3 арқылы жұмыс істеуге қолданбаны баптаңыз. SDK-ның стандартты AWS эндпоинттеріне қосылу әрекеттерін болдырмау үшін S3-клиентті endpoint_url және region_name көрсете отырып инициализациялаңыз.
Boto3 клиентін инициализациялау мысалы:
import boto3from botocore.client import Configimport os# Орта айнымалыларынан алынған тіркелгі деректері мен параметрлерaccess_key = os.environ.get('S3_ACCESS_KEY')secret_key = os.environ.get('S3_SECRET_KEY')endpoint_url = os.environ.get('S3_ENDPOINT_URL', 'https://hb.ru-msk.vkcloud-storage.ru')region_name = os.environ.get('S3_REGION', 'ru-msk')bucket_name = os.environ.get('S3_BUCKET_NAME', 'ai-file-service-bucket')# S3 клиентін инициализациялауs3_client = boto3.client('s3',endpoint_url=endpoint_url,aws_access_key_id=access_key,aws_secret_access_key=secret_key,region_name=region_name,config=Config(s3={'addressing_style': 'path'}, request_checksum_calculation="when_required", response_checksum_validation=None))
Файлды бакетке жүктеп салу функциясының мысалы:
def upload_file(file_data: bytes, object_key: str) -> str:"""Файлды VK Object Storage сақтау құрылғысына жүктеп салады және объект кілтін қайтарады."""s3_client.put_object(Bucket=bucket_name,Key=object_key,Body=file_data)return object_key
Файлды жүктеп алу үшін presigned URL жасау функциясының мысалы:
def generate_download_url(object_key: str, expiration: int = 3600) -> str:"""Файлды жүктеп алу үшін presigned URL жасайды."""url = s3_client.generate_presigned_url('get_object',Params={'Bucket': bucket_name, 'Key': object_key},ExpiresIn=expiration)return url
Жүктеп салынған файлдардың тізімін алу функциясының мысалы:
def list_files() -> list:"""Бакеттегі объектілердің тізімін қайтарады."""response = s3_client.list_objects_v2(Bucket=bucket_name)if 'Contents' in response:return [obj['Key'] for obj in response['Contents']]return []
Қолданба үшін орта айнымалыларын баптаңыз:
export S3_ACCESS_KEY=<ACCESS_KEY>export S3_SECRET_KEY=<SECRET_KEY>export S3_ENDPOINT_URL=https://hb.ru-msk.vkcloud-storage.ruexport S3_REGION=ru-mskexport S3_BUCKET_NAME=ai-file-service-bucket
Қолданбаны локально іске қосыңыз және VK Object Storage қызметімен жұмысты тексеріңіз.
-
Қолданбаны іске қосыңыз:
cd ai-file-serviceuvicorn main:app --host 0.0.0.0 --port 8000 -
HTTP-сұраныс арқылы сынақ файлын жүктеп салыңыз:
curl -X POST http://localhost:8000/upload \-F "file=@test-document.txt" -
AWS CLI көмегімен файл бакетте пайда болғанын тексеріңіз:
aws s3 ls s3://ai-file-service-bucket --endpoint-url https://hb.ru-msk.vkcloud-storage.ru -
Файлды жүктеп алу үшін presigned URL сұраңыз:
curl http://localhost:8000/download-url/test-document.txt -
Файлды алынған сілтеме бойынша жүктеп алыңыз және мазмұны түпнұсқамен сәйкес келетінін тексеріңіз.
MCP (Model Context Protocol) қолданбаны жинау мен деплойдауды автоматтандыруға мүмкіндік береді. VK Cloud инфрақұрылымын біртұтас интерфейс арқылы басқару үшін MCP-серверін жобаңызға қосыңыз.
- MCP-клиентті орнатыңыз және VK Cloud MCP-серверіне қосылуды баптаңыз.
- VK Object Storage қызметімен жұмыс істеу үшін MCP-серверін баптаңыз: MCP конфигурациясында endpoint URL, қолжетімділік кілттері және
ai-file-service-bucketбакетінің атауын көрсетіңіз. - MCP-серверінің VK Cloud ресурстарына қолжетімділігі бар екенін тексеріңіз: контейнерлік қолданбаларды жасай алуы және басқара алуы, бакеттердің конфигурациясын оқи алуы тиіс.
Docker-бейнесін жинауды және қолданбаны Container Apps ішіне деплойдауды автоматтандыру үшін MCP пайдаланыңыз.
-
Қолданба үшін
Dockerfileжасаңыз:FROM python:3.12-slimWORKDIR /appCOPY requirements.txt .RUN pip install --no-cache-dir -r requirements.txtCOPY . .CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"] -
requirements.txtфайлын жасаңыз:fastapiuvicornboto3python-multipart -
MCP-сервері арқылы бейнені жинауды және Container Apps ішіне деплойдауды орындаңыз.
-
Орта айнымалыларын контейнерлік қолданбаға беріңіз:
S3_ACCESS_KEY—<ACCESS_KEY>S3_SECRET_KEY—<SECRET_KEY>S3_ENDPOINT_URL—https://hb.ru-msk.vkcloud-storage.ruS3_REGION—ru-mskS3_BUCKET_NAME—ai-file-service-bucket
-
Container Apps ішінде орналастырылған қолданбаның URL мекенжайын алыңыз.
-
Орналастырылған қолданба арқылы сынақ файлын жүктеп салыңыз:
curl -X POST https://<URL_ПРИЛОЖЕНИЯ>/upload \-F "file=@test-document.txt" -
Файлдың
ai-file-service-bucketбакетінде пайда болғанын тексеріңіз:aws s3 ls s3://ai-file-service-bucket --endpoint-url https://hb.ru-msk.vkcloud-storage.ru -
Қолданба API арқылы файлдардың тізімін сұраңыз:
curl https://<URL_ПРИЛОЖЕНИЯ>/files -
Presigned URL алыңыз және сақтау құрылғысының дұрыс жұмыс істеуіне көз жеткізу үшін файлды жүктеп алыңыз:
curl https://<URL_ПРИЛОЖЕНИЯ>/download-url/test-document.txt -
Файлды алынған сілтеме бойынша жүктеп алыңыз және мазмұнын тексеріңіз.
Жасалған ресурстар тарифтеленеді. Егер олар сізге қажет болмаса:
- Container Apps ішіндегі контейнерлік қолданбаны жойыңыз.
- Бакетті жойыңыз
ai-file-service-bucket.