SweepJob الفصل

مهمة المسح لضبط المعلمات الفائقة.

توريث

azure.ai.ml.entities._job.job.Job

SweepJob

azure.ai.ml.entities._job.sweep.parameterized_sweep.ParameterizedSweep

SweepJob

azure.ai.ml.entities._job.job_io_mixin.JobIOMixin

SweepJob

الدالمنشئ

SweepJob(*, name: str | None = None, description: str | None = None, tags: Dict | None = None, display_name: str | None = None, experiment_name: str | None = None, identity: ManagedIdentityConfiguration | AmlTokenConfiguration | UserIdentityConfiguration | None = None, inputs: Dict[str, int | str | float | bool | Input] | None = None, outputs: Dict[str, Output] | None = None, compute: str | None = None, limits: SweepJobLimits | None = None, sampling_algorithm: str | SamplingAlgorithm | None = None, search_space: Dict[str, Choice | LogNormal | LogUniform | Normal | QLogNormal | QLogUniform | QNormal | QUniform | Randint | Uniform] | None = None, objective: Objective | None = None, trial: CommandJob | CommandComponent | None = None, early_termination: BanditPolicy | MedianStoppingPolicy | TruncationSelectionPolicy | None = None, queue_settings: QueueSettings | None = None, **kwargs: Any)

المعلمات

name

str

اسم الوظيفة.

display_name

str

عرض اسم المهمة.

description

str

وصف الوظيفة.

tags

dict[str, str]

قاموس العلامات. يمكن إضافة العلامات وإزالتها وتحديثها.

properties

dict[str, str]

قاموس خاصية الأصل.

experiment_name

str

اسم التجربة التي سيتم إنشاء الوظيفة ضمنها، إذا تم توفير بلا، سيتم إنشاء الوظيفة ضمن التجربة "افتراضي".

identity

Union[ManagedIdentityConfiguration, AmlTokenConfiguration, UserIdentityConfiguration]

الهوية التي ستستخدمها مهمة التدريب أثناء التشغيل على الحساب.

inputs

dict

المدخلات إلى الأمر .

outputs

dict[str, Output]

تعيين روابط بيانات الإخراج المستخدمة في الوظيفة.

sampling_algorithm

str

خوارزمية أخذ عينات المعلمات الفائقة لاستخدامها عبر search_space. الإعدادات الافتراضية إلى "عشوائي".

search_space

Dict

قاموس مساحة البحث مقياس الوسيط الفائق. يعتبر المفتاح هو اسم المعلمة التشعبية والقيمة هي تعبير المعلمة.

objective

Objective

مقياس لتحسينه.

compute

str

هدف الحساب الذي تعمل عليه المهمة.

trial

Union[CommandJob, CommandComponent]

تكوين الوظيفة لكل إصدار تجريبي. سيتم تزويد كل إصدار تجريبي بمجموعة مختلفة من قيم المعلمات الفائقة التي يعينها النظام من search_space.

early_termination

Union[BanditPolicy, MedianStoppingPolicy, TruncationSelectionPolicy]

نهج الإنهاء المبكر المُراد استخدامه. تُلغي مهمة تجريبية عند استيفاء معايير النهج المحدد. في حال حذفه، فلن يتم تطبيق نهج الإنهاء المبكر.

limits

<xref:azure.ai.ml.entities.SweepJobLimits>

حدود مهمة المسح.

queue_settings

QueueSettings

إعدادات قائمة الانتظار للوظيفة.

kwargs

dict

قاموس لمعلمات التكوين الإضافية.

أمثلة

إنشاء SweepJob

   from azure.ai.ml.entities import CommandJob
   from azure.ai.ml.sweep import BayesianSamplingAlgorithm, Objective, SweepJob, SweepJobLimits

   command_job = CommandJob(
       inputs=dict(kernel="linear", penalty=1.0),
       compute=cpu_cluster,
       environment=f"{job_env.name}:{job_env.version}",
       code="./scripts",
       command="python scripts/train.py --kernel $kernel --penalty $penalty",
       experiment_name="sklearn-iris-flowers",
   )

   sweep = SweepJob(
       sampling_algorithm=BayesianSamplingAlgorithm(),
       trial=command_job,
       search_space={"ss": Choice(type="choice", values=[{"space1": True}, {"space2": True}])},
       inputs={"input1": {"file": "top_level.csv", "mode": "ro_mount"}},
       compute="top_level",
       limits=SweepJobLimits(trial_timeout=600),
       objective=Objective(goal="maximize", primary_metric="accuracy"),
   )

الأساليب

dump	تفريغ محتوى الوظيفة في ملف بتنسيق YAML.
set_limits	تعيين حدود لعقدة المسح. اترك المعلمات على أنها بلا إذا كنت لا تريد تحديث القيم المقابلة.
set_objective	تعيين كائن المسح.. اترك المعلمات على أنها بلا إذا كنت لا تريد تحديث القيم المقابلة. "تصغير"، "تكبير". :اكتب الهدف: str :الكلمة الأساسية primary_metric: اسم المقياس لتحسينه. primary_metric :p aramtype: str

dump

تفريغ محتوى الوظيفة في ملف بتنسيق YAML.

dump(dest: str | PathLike | IO, **kwargs) -> None

المعلمات

dest

Union[<xref:PathLike>, str, IO[AnyStr]]

مطلوب

المسار المحلي أو دفق الملف لكتابة محتوى YAML إليه. إذا كان dest مسار ملف، فسيتم إنشاء ملف جديد. إذا كان dest ملفا مفتوحا، فستتم كتابة الملف إليه مباشرة.

kwargs

dict

وسيطات إضافية لتمريرها إلى تسلسل YAML.

استثناءات

FileExistsError

يتم رفعه إذا كان dest مسار ملف والملف موجود بالفعل.

IOError

يتم رفعه إذا كان dest ملفا مفتوحا ولم يكن الملف قابلا للكتابة.

set_limits

تعيين حدود لعقدة المسح. اترك المعلمات على أنها بلا إذا كنت لا تريد تحديث القيم المقابلة.

set_limits(*, max_concurrent_trials: int | None = None, max_total_trials: int | None = None, timeout: int | None = None, trial_timeout: int | None = None) -> None

المعلمات

max_concurrent_trials

int

الحد الأقصى لرقم الإصدار التجريبي المتزامن.

max_total_trials

int

الحد الأقصى لإجمالي رقم الإصدار التجريبي.

timeout

int

إجمالي المهلة بالثوان لعقدة المسح

trial_timeout

int

المهلة بالثوان لكل إصدار تجريبي

استثناءات

FileExistsError

يتم رفعه إذا كان dest مسار ملف والملف موجود بالفعل.

IOError

يتم رفعه إذا كان dest ملفا مفتوحا ولم يكن الملف قابلا للكتابة.

set_objective

تعيين كائن المسح.. اترك المعلمات على أنها بلا إذا كنت لا تريد تحديث القيم المقابلة.

"تصغير"، "تكبير". :اكتب الهدف: str :الكلمة الأساسية primary_metric: اسم المقياس لتحسينه. primary_metric :p aramtype: str

set_objective(*, goal: str | None = None, primary_metric: str | None = None) -> None

المعلمات

goal

يحدد أهداف القياس المدعومة لضبط المعلمات الفائقة. القيم المقبولة هي:

استثناءات

FileExistsError

يتم رفعه إذا كان dest مسار ملف والملف موجود بالفعل.

IOError

يتم رفعه إذا كان dest ملفا مفتوحا ولم يكن الملف قابلا للكتابة.

السمات

base_path

المسار الأساسي للمورد.

المرتجعات

المسار الأساسي للمورد.

نوع الإرجاع

str

creation_context

سياق إنشاء المورد.

المرتجعات

بيانات تعريف الإنشاء للمورد.

نوع الإرجاع

Optional[SystemData]

early_termination

نهج الإنهاء المبكر لوظيفة المسح.

المرتجعات

نهج الإنهاء المبكر لوظيفة المسح.

نوع الإرجاع

<xref:azure.ai.ml.entities._job.sweep.early_termination_policy.EarlyTerminationPolicy>

id

معرف المورد.

المرتجعات

المعرف العمومي للمورد، معرف Azure Resource Manager (ARM).

نوع الإرجاع

Optional[str]

inputs

limits

حدود مهمة المسح.

المرتجعات

حدود مهمة المسح.

نوع الإرجاع

SweepJobLimits

log_files

ملفات إخراج الوظيفة.

المرتجعات

قاموس أسماء السجلات وعناوين URL.

نوع الإرجاع

Optional[Dict[str, str]]

outputs

sampling_algorithm

خوارزمية أخذ العينات لمهمة المسح.

المرتجعات

خوارزمية أخذ العينات لمهمة المسح.

نوع الإرجاع

SamplingAlgorithm

status

حالة الوظيفة.

تتضمن القيم الشائعة التي تم إرجاعها "قيد التشغيل" و"مكتمل" و"فشل". جميع القيم المحتملة هي:

• NotStarted - هذه حالة مؤقتة تكون فيها كائنات التشغيل من جانب العميل قبل إرسال السحابة.

• البدء - بدأ تشغيل قيد المعالجة في السحابة. لدى المتصل معرف تشغيل في هذه المرحلة.

• التزويد - يتم إنشاء حساب عند الطلب لتقديم وظيفة معينة.

• التحضير - يتم إعداد بيئة التشغيل وهي في إحدى مرحلتين:

  • بناء صورة Docker

  • إعداد بيئة conda

• في قائمة الانتظار - يتم وضع المهمة في قائمة الانتظار على هدف الحساب. على سبيل المثال، في BatchAI، تكون المهمة في حالة قائمة الانتظار

  أثناء انتظار جميع العقد المطلوبة لتكون جاهزة.

• قيد التشغيل - بدأت المهمة في التشغيل على هدف الحساب.

• الإنهاء - اكتمل تنفيذ التعليمات البرمجية للمستخدم، والتشغيل في مراحل ما بعد المعالجة.

• CancelRequested - تم طلب الإلغاء للوظيفة.

• مكتمل - اكتمل التشغيل بنجاح. يتضمن ذلك كلا من تنفيذ التعليمات البرمجية للمستخدم وتشغيله

  مراحل ما بعد المعالجة.

• فشل - فشل التشغيل. عادة ما توفر الخاصية Error أثناء التشغيل تفاصيل حول السبب.

• تم الإلغاء - يتبع طلب إلغاء ويشير إلى أن التشغيل قد تم إلغاؤه بنجاح الآن.

• NotResponding - بالنسبة إلى عمليات التشغيل التي تم تمكين Heartbeats، لم يتم إرسال رسالة كشف أخطاء الاتصال مؤخرا.

المرتجعات

حالة الوظيفة.

نوع الإرجاع

Optional[str]

studio_url

نقطة نهاية استوديو التعلم الآلي من Microsoft Azure.

المرتجعات

عنوان URL لصفحة تفاصيل الوظيفة.

نوع الإرجاع

Optional[str]

type

نوع الوظيفة.

المرتجعات

نوع الوظيفة.

نوع الإرجاع

Optional[str]