https://thedotnetblog.com/ar/tags/architecture/Articles, tutorials and insights from the .NET community.Hugoar@thedotnetblog (The .NET Blog)@thedotnetblogSat, 25 Apr 2026 00:00:00 +0000https://thedotnetblog.com/ar/posts/emiliano-montesdeoca/chat-history-storage-patterns-agent-framework/Sat, 25 Apr 2026 00:00:00 +0000Emiliano Montesdeocahttps://thedotnetblog.com/ar/posts/emiliano-montesdeoca/chat-history-storage-patterns-agent-framework/مُدار من الخدمة أم من العميل؟ خطي أم متفرع؟ القرار المعماري الذي يحدد ما يستطيع وكيل الذكاء الاصطناعي لديك فعله حقًا — مع أمثلة برمجية بـ C# و Python.<p><em>تمت ترجمة هذا المقال تلقائيًا. للاطلاع على النسخة الأصلية، <a href="https://thedotnetblog.com/ar/posts/emiliano-montesdeoca/chat-history-storage-patterns-agent-framework/">انقر هنا</a>.</em></p> <p>عند بناء وكيل ذكاء اصطناعي، تُنفق معظم طاقتك على النموذج والأدوات والأوامر. يبدو سؤال <em>أين يعيش سجل المحادثة</em> مجرد تفصيل تنفيذي — لكنه في الواقع أحد أهم القرارات المعمارية التي ستتخذها.</p> <p>يحدد هذا القرار ما إذا كان المستخدمون قادرين على تفرّع المحادثات، والتراجع عن الردود، واستئناف الجلسات بعد إعادة التشغيل، وما إذا كانت بياناتك تغادر بنيتك التحتية أم لا. <a href="https://devblogs.microsoft.com/agent-framework/chat-history-storage-patterns-in-microsoft-agent-framework/">نشر فريق Agent Framework تحليلاً متعمقًا</a>.</p> <h2 id="نمطان-أساسيان">نمطان أساسيان</h2> <p><strong>مُدار من الخدمة</strong>: تخزّن خدمة الذكاء الاصطناعي حالة المحادثة. يحتفظ تطبيقك بمرجع، وتُضمّن الخدمة تلقائيًا السجل ذا الصلة في كل طلب.</p> <p><strong>مُدار من العميل</strong>: يحتفظ تطبيقك بالسجل الكامل ويرسل الرسائل ذات الصلة مع كل طلب. الخدمة عديمة الحالة. أنت تتحكم في كل شيء.</p> <h2 id="كيف-يجرد-agent-framework-هذا">كيف يُجرّد Agent Framework هذا</h2> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-csharp" data-lang="csharp"><span class="line"><span class="cl"><span class="n">AgentSession</span> <span class="n">session</span> <span class="p">=</span> <span class="k">await</span> <span class="n">agent</span><span class="p">.</span><span class="n">CreateSessionAsync</span><span class="p">();</span> </span></span><span class="line"><span class="cl"><span class="kt">var</span> <span class="n">first</span> <span class="p">=</span> <span class="k">await</span> <span class="n">agent</span><span class="p">.</span><span class="n">RunAsync</span><span class="p">(</span><span class="s">&#34;اسمي أليس.&#34;</span><span class="p">,</span> <span class="n">session</span><span class="p">);</span> </span></span><span class="line"><span class="cl"><span class="kt">var</span> <span class="n">second</span> <span class="p">=</span> <span class="k">await</span> <span class="n">agent</span><span class="p">.</span><span class="n">RunAsync</span><span class="p">(</span><span class="s">&#34;ما اسمي؟&#34;</span><span class="p">,</span> <span class="n">session</span><span class="p">);</span> </span></span></code></pre></div><h2 id="مرجع-سريع-للموفرين">مرجع سريع للموفرين</h2> <table> <thead> <tr> <th>الموفر</th> <th>التخزين</th> <th>النموذج</th> <th>الضغط</th> </tr> </thead> <tbody> <tr> <td>OpenAI/Azure Chat Completions</td> <td>العميل</td> <td>لا ينطبق</td> <td>أنت</td> </tr> <tr> <td>Foundry Agent Service</td> <td>الخدمة</td> <td>خطي</td> <td>الخدمة</td> </tr> <tr> <td>Responses API (افتراضي)</td> <td>الخدمة</td> <td>متفرع</td> <td>الخدمة</td> </tr> <tr> <td>Anthropic Claude, Ollama</td> <td>العميل</td> <td>لا ينطبق</td> <td>أنت</td> </tr> </tbody> </table> <h2 id="كيف-تختار">كيف تختار</h2> <ol> <li><strong>تحتاج تفرعًا أو &ldquo;تراجعًا&rdquo;؟</strong> → Responses API مُدارة من الخدمة</li> <li><strong>تحتاج سيادة البيانات؟</strong> → مُدارة من العميل مع موفر بقاعدة بيانات</li> <li><strong>روبوت محادثة بسيط؟</strong> → خطية مُدارة من الخدمة تكفي</li> </ol> <p>اقرأ <a href="https://devblogs.microsoft.com/agent-framework/chat-history-storage-patterns-in-microsoft-agent-framework/">المقال الكامل</a> للاطلاع على شجرة القرار الكاملة.</p>