docs: add Secure Agent Design guide

docs/docs.json

@@ -98,7 +98,8 @@
                         "group": "Agents",
                         "icon": "user",
                         "pages": [
-                          "edge/en/guides/agents/crafting-effective-agents"
+                          "edge/en/guides/agents/crafting-effective-agents",
+                          "edge/en/guides/agents/secure-agent-design"
                         ]
                       },
                       {
@@ -13361,7 +13362,8 @@
                         "group": "Agentes",
                         "icon": "user",
                         "pages": [
-                          "edge/pt-BR/guides/agents/crafting-effective-agents"
+                          "edge/pt-BR/guides/agents/crafting-effective-agents",
+                          "edge/pt-BR/guides/agents/secure-agent-design"
                         ]
                       },
                       {
@@ -25711,7 +25713,8 @@
                         "group": "에이전트 (Agents)",
                         "icon": "user",
                         "pages": [
-                          "edge/ko/guides/agents/crafting-effective-agents"
+                          "edge/ko/guides/agents/crafting-effective-agents",
+                          "edge/ko/guides/agents/secure-agent-design"
                         ]
                       },
                       {
@@ -38481,7 +38484,8 @@
                         "group": "الوكلاء",
                         "icon": "user",
                         "pages": [
-                          "edge/ar/guides/agents/crafting-effective-agents"
+                          "edge/ar/guides/agents/crafting-effective-agents",
+                          "edge/ar/guides/agents/secure-agent-design"
                         ]
                       },
                       {

docs/edge/ar/concepts/agents.mdx

@@ -350,6 +350,12 @@ result = researcher.kickoff("What are the latest developments in language models
 print(result.raw)
 ```
 
+<Note>
+  يشغّل `kickoff()` مُنفّذ `AgentExecutor`. ولا ينشئ Task ولا Crew.
+  يحتفظ الـ Agent بدوره وهدفه وخلفيته وأدواته. تُرجع الدالة
+  `LiteAgentOutput`.
+</Note>
+
 ## اعتبارات مهمة وأفضل الممارسات
 
 ### الأمان وتنفيذ الكود

docs/edge/ar/concepts/production-architecture.mdx

@@ -154,9 +154,14 @@ flow.kickoff(restore_from_state_id="<previous-run-state-id>")
 
 يحصل التشغيل الجديد على `state.id` جديد (مولّد تلقائيًا، أو `inputs["id"]` إذا تم تثبيته) لذا لا تمتد كتابات `@persist` الخاصة به إلى تاريخ المصدر. الجمع مع `from_checkpoint` يطلق `ValueError`؛ اختر مصدر ترطيب واحدًا.
 
+## الأمان
+
+يمكن للـ Agents المزودة بأدوات تنفيذ إجراءات حقيقية. راجع [تصميم Agent الآمن](/edge/ar/guides/agents/secure-agent-design) للحد من هذا الخطر.
+
 ## الخلاصة
 
 - **ابدأ بتدفق.**
 - **حدد حالة واضحة.**
 - **استخدم الأطقم للمهام المعقدة.**
 - **انشر مع API واستمرارية.**
+- اتبع [تصميم Agent الآمن](/edge/ar/guides/agents/secure-agent-design).

docs/edge/ar/guides/agents/crafting-effective-agents.mdx

@@ -11,6 +11,8 @@ mode: "wide"
 
 سيساعدك هذا الدليل على إتقان فن تصميم الـ Agent، مما يمكّنك من إنشاء شخصيات AI متخصصة تتعاون بفعالية وتفكر بشكل نقدي وتنتج مخرجات عالية الجودة مصممة لاحتياجاتك المحددة.
 
+إذا كانت الـ Agents تستخدم أدوات أو محتوى غير موثوق، فاقرأ أيضًا [تصميم Agent الآمن](/edge/ar/guides/agents/secure-agent-design).
+
 ### لماذا يهم تصميم الـ Agent
 
 الطريقة التي تعرّف بها الـ Agents تؤثر بشكل كبير على:

docs/edge/ar/mcp/security.mdx

@@ -147,3 +147,5 @@ mode: "wide"
 من خلال فهم اعتبارات الأمان هذه وتنفيذ أفضل الممارسات، يمكنك الاستفادة بأمان من قوة خوادم MCP في مشاريع CrewAI.
 هذه ليست شاملة بأي حال، لكنها تغطي المخاوف الأمنية الأكثر شيوعاً وأهمية.
 ستستمر التهديدات في التطور، لذا من المهم البقاء على اطلاع وتكييف إجراءات الأمان وفقاً لذلك.
+
+راجع أيضًا [تصميم Agent الآمن](/edge/ar/guides/agents/secure-agent-design).

docs/edge/en/concepts/agents.mdx

@@ -638,9 +638,9 @@ asyncio.run(main())
 ```
 
 <Note>
-  The `kickoff()` method uses a `LiteAgent` internally, which provides a simpler
-  execution flow while preserving all of the agent's configuration (role, goal,
-  backstory, tools, etc.).
+  `kickoff()` runs an `AgentExecutor`. It does not create a Task or a Crew.
+  The agent keeps its role, goal, backstory, and tools. The method returns
+  `LiteAgentOutput`.
 </Note>
 
 ## Important Considerations and Best Practices

docs/edge/en/concepts/production-architecture.mdx

@@ -154,9 +154,14 @@ flow.kickoff(restore_from_state_id="<previous-run-state-id>")
 
 The new run gets a fresh `state.id` (auto-generated, or `inputs["id"]` if pinned) so its `@persist` writes don't extend the source's history. Combining with `from_checkpoint` raises a `ValueError`; pick one hydration source.
 
+## Security
+
+Agents with tools can take real-world actions. See [Secure Agent Design](/edge/en/guides/agents/secure-agent-design) to limit that risk.
+
 ## Summary
 
 - **Start with a Flow.**
 - **Define a clear State.**
 - **Use Crews for complex tasks.**
 - **Deploy with an API and persistence.**
+- Follow [Secure Agent Design](/edge/en/guides/agents/secure-agent-design).

docs/edge/en/guides/agents/crafting-effective-agents.mdx

@@ -11,6 +11,10 @@ At the heart of CrewAI lies the agent - a specialized AI entity designed to perf
 
 This guide will help you master the art of agent design, enabling you to create specialized AI personas that collaborate effectively, think critically, and produce high-quality outputs tailored to your specific needs.
 
+<Tip>
+If agents use tools or untrusted content, also read [Secure Agent Design](/edge/en/guides/agents/secure-agent-design).
+</Tip>
+
 ### Why Agent Design Matters
 
 The way you define your agents significantly impacts: