Skip to content

Commit 20ef1c5

Browse files
committed
docs: use restore_from_state_id as default in @persist deprecation guide
1 parent 10da3ad commit 20ef1c5

4 files changed

Lines changed: 25 additions & 25 deletions

File tree

docs/ar/guides/flows/inputs-id-deprecation.mdx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
2-
title: "الانتقال من inputs.id إلى restoreFromStateId"
3-
description: "نقل تدفقات @persist من ترطيب inputs.id المهجور إلى حقل restoreFromStateId المدعوم"
2+
title: "الانتقال من inputs.id إلى restore_from_state_id"
3+
description: "نقل تدفقات @persist من ترطيب inputs.id المهجور إلى حقل restore_from_state_id المدعوم"
44
icon: "arrow-right-arrow-left"
55
---
66

77
<Warning>
8-
تمرير `id` داخل `inputs` لترطيب تدفق `@persist` هو **مهجور** ومقرر إزالته في إصدار مستقبلي. البديل، `restoreFromStateId`، متاح في CrewAI **v1.14.5 وما بعده** — الخطوات أدناه تنطبق بمجرد أن تقوم بالتحديث.
8+
تمرير `id` داخل `inputs` لترطيب تدفق `@persist` هو **مهجور** ومقرر إزالته في إصدار مستقبلي. البديل، `restore_from_state_id`، متاح في CrewAI **v1.14.5 وما بعده** — الخطوات أدناه تنطبق بمجرد أن تقوم بالتحديث.
99
</Warning>
1010

1111
## نظرة عامة
1212

13-
الطريقة الموثقة لترطيب تدفق `@persist` من تنفيذ سابق هي تمرير UUID لذلك التنفيذ كـ `inputs.id`. الآن، تكشف CrewAI عن حقل مخصص، `restoreFromStateId`، الذي يقوم بنفس الترطيب دون تحميل حمولة `inputs` — ودون ربط مفتاح الترطيب بهوية التنفيذ الجديد.
13+
الطريقة الموثقة لترطيب تدفق `@persist` من تنفيذ سابق هي تمرير UUID لذلك التنفيذ كـ `inputs.id`. الآن، تكشف CrewAI عن حقل مخصص، `restore_from_state_id`، الذي يقوم بنفس الترطيب دون تحميل حمولة `inputs` — ودون ربط مفتاح الترطيب بهوية التنفيذ الجديد.
1414

1515
## الانتقال
1616

@@ -48,11 +48,11 @@ flow.kickoff(restore_from_state_id="abcd1234-5678-90ef-ghij-klmnopqrstuv")
4848

4949
هذه الوظيفة المزدوجة هي السبب الجذري للمشاكل التي يصفها هذا الدليل. لأن UUID المقدم هو أيضاً معرف التنفيذ الجديد، فإن بدايتين تمرران نفس `inputs.id` ليست تنفيذين متميزين — إنهما تشتركان في معرف، وتشاركان في سجل الاستمرارية، و(على AMP) تشتركان في صف في قائمة التنفيذات. لا توجد طريقة للقول "ترطب من هذه اللقطة، ولكن سجل هذا التشغيل بشكل منفصل" دون تقسيم المسؤوليتين.
5050

51-
`restoreFromStateId` هو هذا الانقسام. إنه يخبر `@persist` من أي لقطة يترطب، بينما يترك التنفيذ الجديد حراً لاستلام `state.id` جديدة. لم يعد مصدر الترطيب والتشغيل المسجل نفس UUID — وهو ما تريده معظم سيناريوهات الإنتاج فعلياً.
51+
`restore_from_state_id` هو هذا الانقسام. إنه يخبر `@persist` من أي لقطة يترطب، بينما يترك التنفيذ الجديد حراً لاستلام `state.id` جديدة. لم يعد مصدر الترطيب والتشغيل المسجل نفس UUID — وهو ما تريده معظم سيناريوهات الإنتاج فعلياً.
5252

5353
## جدول إزالة
5454

55-
من المقرر إزالة `inputs.id` لترطيب `@persist` في إصدار مستقبلي من CrewAI. لا يوجد قطع صارم فوري — تظل التدفقات الحالية تعمل — ولكن بمجرد أن تقوم بالتحديث إلى v1.14.5 أو ما بعده، يجب أن يستخدم الكود الجديد `restoreFromStateId`، ويجب أن تهاجر التدفقات الحالية في الفرصة المناسبة التالية.
55+
من المقرر إزالة `inputs.id` لترطيب `@persist` في إصدار مستقبلي من CrewAI. لا يوجد قطع صارم فوري — تظل التدفقات الحالية تعمل — ولكن بمجرد أن تقوم بالتحديث إلى v1.14.5 أو ما بعده، يجب أن يستخدم الكود الجديد `restore_from_state_id`، ويجب أن تهاجر التدفقات الحالية في الفرصة المناسبة التالية.
5656

5757
## AMP
5858

docs/en/guides/flows/inputs-id-deprecation.mdx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: "Migrating from inputs.id to restoreFromStateId"
3-
description: "Move @persist flows off the deprecated inputs.id hydration onto the supported restoreFromStateId field"
2+
title: "Migrating from inputs.id to restore_from_state_id"
3+
description: "Move @persist flows off the deprecated inputs.id hydration onto the supported restore_from_state_id field"
44
icon: "arrow-right-arrow-left"
55
---
66

77
<Warning>
88
Passing `id` inside `inputs` to hydrate a `@persist` flow is **deprecated** and
9-
scheduled for removal in a future release. The replacement, `restoreFromStateId`,
9+
scheduled for removal in a future release. The replacement, `restore_from_state_id`,
1010
is available in CrewAI **v1.14.5 and later** — the steps below apply once you
1111
upgrade.
1212
</Warning>
@@ -15,7 +15,7 @@ icon: "arrow-right-arrow-left"
1515

1616
The documented way to hydrate a `@persist` flow from a previous execution is to pass
1717
that execution's UUID as `inputs.id`. CrewAI now exposes a dedicated field,
18-
`restoreFromStateId`, that performs the same hydration without overloading the
18+
`restore_from_state_id`, that performs the same hydration without overloading the
1919
`inputs` payload — and without coupling the hydration key to the new execution's
2020
identity.
2121

@@ -69,7 +69,7 @@ record, and (on AMP) share a row in the executions list. There is no way to say
6969
"hydrate from this snapshot, but record this run separately" without splitting the
7070
two responsibilities.
7171

72-
`restoreFromStateId` is that split. It tells `@persist` which snapshot to hydrate
72+
`restore_from_state_id` is that split. It tells `@persist` which snapshot to hydrate
7373
from, while leaving the new execution free to receive a fresh `state.id`. The
7474
hydration source and the recorded run are no longer the same UUID — which is what
7575
most production scenarios actually want.
@@ -78,7 +78,7 @@ most production scenarios actually want.
7878

7979
`inputs.id` for `@persist` hydration is scheduled for removal in a future release of
8080
CrewAI. There is no immediate hard cut-off — existing flows continue to work — but
81-
once you upgrade to v1.14.5 or later, new code should use `restoreFromStateId`, and
81+
once you upgrade to v1.14.5 or later, new code should use `restore_from_state_id`, and
8282
existing flows should migrate at the next convenient opportunity.
8383

8484
## AMP

docs/ko/guides/flows/inputs-id-deprecation.mdx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: "inputs.id에서 restoreFromStateId로 마이그레이션"
3-
description: "더 이상 지원되지 않는 inputs.id 하이드레이션에서 지원되는 restoreFromStateId 필드로 @persist 흐름을 이동"
2+
title: "inputs.id에서 restore_from_state_id로 마이그레이션"
3+
description: "더 이상 지원되지 않는 inputs.id 하이드레이션에서 지원되는 restore_from_state_id 필드로 @persist 흐름을 이동"
44
icon: "arrow-right-arrow-left"
55
---
66

77
<Warning>
88
`inputs` 내에서 `id`를 전달하여 `@persist` 흐름을 하이드레이트하는 것은 **더 이상 지원되지 않으며**
9-
향후 릴리스에서 제거될 예정입니다. 대체품인 `restoreFromStateId`는 CrewAI **v1.14.5 이상**에서 사용할 수 있으며,
9+
향후 릴리스에서 제거될 예정입니다. 대체품인 `restore_from_state_id`는 CrewAI **v1.14.5 이상**에서 사용할 수 있으며,
1010
아래 단계는 업그레이드 후 적용됩니다.
1111
</Warning>
1212

@@ -15,7 +15,7 @@ icon: "arrow-right-arrow-left"
1515
이전 실행에서 `@persist` 흐름을 하이드레이트하는 문서화된 방법은
1616
해당 실행의 UUID를 `inputs.id`로 전달하는 것입니다. CrewAI는 이제
1717
`inputs` 페이로드를 과부하하지 않고 동일한 하이드레이션을 수행하는 전용 필드인
18-
`restoreFromStateId`를 제공합니다 — 그리고 하이드레이션 키를 새로운 실행의
18+
`restore_from_state_id`를 제공합니다 — 그리고 하이드레이션 키를 새로운 실행의
1919
정체성과 결합하지 않습니다.
2020

2121
## 마이그레이션
@@ -63,13 +63,13 @@ CrewAI AMP REST API를 통해 흐름을 시작하는 경우, 아래 [AMP](#amp)
6363
지속성 기록을 공유하며, (AMP에서) 실행 목록에서 행을 공유합니다. "이 스냅샷에서 하이드레이트하지만,
6464
이 실행을 별도로 기록하십시오"라고 말할 방법이 없습니다.
6565

66-
`restoreFromStateId`가 그 분리입니다. 이는 `@persist`에 어떤 스냅샷에서 하이드레이트할지를 알려주며,
66+
`restore_from_state_id`가 그 분리입니다. 이는 `@persist`에 어떤 스냅샷에서 하이드레이트할지를 알려주며,
6767
새 실행이 새로운 `state.id`를 받을 수 있도록 합니다. 하이드레이션 소스와 기록된 실행은 더 이상 동일한 UUID가 아닙니다 — 이는 대부분의 프로덕션 시나리오에서 실제로 원하는 것입니다.
6868

6969
## 제거 일정
7070

7171
`@persist` 하이드레이션을 위한 `inputs.id`는 CrewAI의 향후 릴리스에서 제거될 예정입니다. 즉각적인 강제 종료는 없으며 — 기존 흐름은 계속 작동합니다 — 하지만 v1.14.5 이상으로 업그레이드하면,
72-
새 코드에서는 `restoreFromStateId`를 사용해야 하며, 기존 흐름은 다음 편리한 기회에 마이그레이션해야 합니다.
72+
새 코드에서는 `restore_from_state_id`를 사용해야 하며, 기존 흐름은 다음 편리한 기회에 마이그레이션해야 합니다.
7373

7474
## AMP
7575

docs/pt-BR/guides/flows/inputs-id-deprecation.mdx

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: "Migrando de inputs.id para restoreFromStateId"
3-
description: "Mover fluxos @persist da hidratação obsoleta inputs.id para o campo suportado restoreFromStateId"
2+
title: "Migrando de inputs.id para restore_from_state_id"
3+
description: "Mover fluxos @persist da hidratação obsoleta inputs.id para o campo suportado restore_from_state_id"
44
icon: "arrow-right-arrow-left"
55
---
66

77
<Warning>
88
Passar `id` dentro de `inputs` para hidratar um fluxo `@persist` é **obsoleto** e
9-
programado para remoção em uma versão futura. A substituição, `restoreFromStateId`,
9+
programado para remoção em uma versão futura. A substituição, `restore_from_state_id`,
1010
está disponível no CrewAI **v1.14.5 e posterior** — os passos abaixo se aplicam uma vez que você
1111
faça a atualização.
1212
</Warning>
@@ -15,7 +15,7 @@ icon: "arrow-right-arrow-left"
1515

1616
A maneira documentada de hidratar um fluxo `@persist` de uma execução anterior é passar
1717
o UUID dessa execução como `inputs.id`. O CrewAI agora expõe um campo dedicado,
18-
`restoreFromStateId`, que realiza a mesma hidratação sem sobrecarregar a
18+
`restore_from_state_id`, que realiza a mesma hidratação sem sobrecarregar a
1919
carga útil de `inputs` — e sem acoplar a chave de hidratação à identidade da nova execução.
2020

2121
## Migração
@@ -50,7 +50,7 @@ para o modelo mental completo.
5050
Se você iniciar seu fluxo pela API REST do CrewAI AMP, veja [AMP](#amp) abaixo para a
5151
migração equivalente da carga útil.
5252

53-
## Por que estamos descontinuando `inputs.id` para `@persist`
53+
## Por que estamos descontinuando `inputs.id` para `@persist`?
5454

5555
`inputs.id` é atualmente a maneira documentada de retomar um fluxo `@persist` de uma
5656
execução anterior. O problema é que o mesmo UUID faz duas funções ao mesmo tempo:
@@ -68,7 +68,7 @@ de persistência e (no AMP) compartilham uma linha na lista de execuções. Não
6868
"hidratar a partir deste snapshot, mas registrar esta execução separadamente" sem dividir as
6969
duas responsabilidades.
7070

71-
`restoreFromStateId` é essa divisão. Ele informa ao `@persist` de qual snapshot hidratar,
71+
`restore_from_state_id` é essa divisão. Ele informa ao `@persist` de qual snapshot hidratar,
7272
enquanto deixa a nova execução livre para receber um novo `state.id`. A
7373
fonte de hidratação e a execução registrada não são mais o mesmo UUID — que é o que
7474
a maioria dos cenários de produção realmente deseja.
@@ -77,7 +77,7 @@ a maioria dos cenários de produção realmente deseja.
7777

7878
`inputs.id` para hidratação `@persist` está programado para remoção em uma versão futura do
7979
CrewAI. Não há um corte imediato — fluxos existentes continuam a funcionar — mas
80-
uma vez que você atualize para v1.14.5 ou posterior, novo código deve usar `restoreFromStateId`, e
80+
uma vez que você atualize para v1.14.5 ou posterior, novo código deve usar `restore_from_state_id`, e
8181
fluxos existentes devem migrar na próxima oportunidade conveniente.
8282

8383
## AMP

0 commit comments

Comments
 (0)