Buckets:

download
raw
37 kB
<meta charset="utf-8" /><meta name="hf:doc:metadata" content="{&quot;title&quot;:&quot;درخواست کمک در انجمن‌ها&quot;,&quot;local&quot;:&quot;asking-for-help-on-the-forums&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;نوشتن یک پست خوب در انجمن&quot;,&quot;local&quot;:&quot;writing-a-good-forum-post&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;انتخاب عنوانی توصیفی&quot;,&quot;local&quot;:&quot;choosing-a-descriptive-title&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;قالب‌بندی قطعه کدهای شما&quot;,&quot;local&quot;:&quot;formatting-your-code-snippets&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;گنجاندن traceback کامل&quot;,&quot;local&quot;:&quot;including-the-full-traceback&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;ارائه‌ی یک مثال قابل‌بازتولید&quot;,&quot;local&quot;:&quot;providing-a-reproducible-example&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3}],&quot;depth&quot;:2}],&quot;depth&quot;:1}"/>
<link href="/docs/course/pr_1364/fa/_app/immutable/entry/start.CqZXmSrv.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/oyrVqMhC.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/B3UUDp28.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/entry/app.B4UvgX5H.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/BioDZtGL.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/NIl2lQjl.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/DN6uzRQe.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/DsnmJJEf.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/nodes/0.DcFj1eGj.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/u5kFQ1Zb.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/nodes/89.Dc4P99yP.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/BjCHz3cj.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/BPNwLiYb.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/B8VBSgkq.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/DFIrGYWg.js" rel="modulepreload">
<!--181r8xm--><meta name="hf:doc:metadata" content="{&quot;title&quot;:&quot;درخواست کمک در انجمن‌ها&quot;,&quot;local&quot;:&quot;asking-for-help-on-the-forums&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;نوشتن یک پست خوب در انجمن&quot;,&quot;local&quot;:&quot;writing-a-good-forum-post&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;انتخاب عنوانی توصیفی&quot;,&quot;local&quot;:&quot;choosing-a-descriptive-title&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;قالب‌بندی قطعه کدهای شما&quot;,&quot;local&quot;:&quot;formatting-your-code-snippets&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;گنجاندن traceback کامل&quot;,&quot;local&quot;:&quot;including-the-full-traceback&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;ارائه‌ی یک مثال قابل‌بازتولید&quot;,&quot;local&quot;:&quot;providing-a-reproducible-example&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3}],&quot;depth&quot;:2}],&quot;depth&quot;:1}"/><!---->
<link href="/docs/course/pr_1364/fa/_app/immutable/assets/0.tn0RQdqM.css" rel="modulepreload"> <!--[--><!--[0--><!--[--><!--[0--><!--[--><p></p> <div class="items-center shrink-0 min-w-[100px] max-sm:min-w-[50px] justify-end ml-auto flex" style="float: right; margin-left: 10px; display: inline-flex; position: relative; z-index: 10;"><div class="inline-flex rounded-md max-sm:rounded-sm"><button class="inline-flex items-center gap-1 h-7 max-sm:h-7 px-2 max-sm:px-1.5 text-sm font-medium text-gray-800 border border-r-0 rounded-l-md max-sm:rounded-l-sm border-gray-200 bg-white hover:shadow-inner dark:border-gray-850 dark:bg-gray-950 dark:text-gray-200 dark:hover:bg-gray-800" aria-live="polite"><span class="inline-flex items-center justify-center rounded-md p-0.5 max-sm:p-0 hover:text-gray-800 dark:hover:text-gray-200"><svg class="sm:size-3.5 size-3" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----></span> <span>Copy page</span></button> <button class="inline-flex items-center justify-center w-6 max-sm:w-5 h-7 max-sm:h-7 disabled:pointer-events-none text-sm text-gray-500 hover:text-gray-700 dark:hover:text-white rounded-r-md max-sm:rounded-r-sm border border-l transition border-gray-200 bg-white hover:shadow-inner dark:border-gray-850 dark:bg-gray-950 dark:text-gray-200 dark:hover:bg-gray-800" aria-haspopup="menu" aria-expanded="false" aria-label="Open copy menu"><svg class="transition-transform text-gray-400 overflow-visible sm:size-3.5 size-3 rotate-0" width="1em" height="1em" viewBox="0 0 12 7" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M1 1L6 6L11 1" stroke="currentColor"></path></svg><!----></button></div> <!--[-1--><!--]--></div><!----> <!--[0--><h1 class="relative group"><a id="asking-for-help-on-the-forums" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#asking-for-help-on-the-forums"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>درخواست کمک در انجمن‌ها</span></h1><!--]--><!----> <div dir="rtl"><div class="flex space-x-1 absolute z-10 right-0 top-0"><a href="https://discuss.huggingface.co/t/chapter-8-questions" target="_blank"><img alt="Ask a Question" class="!m-0" src="https://img.shields.io/badge/Ask%20a%20question-ffcb4c.svg?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgLTEgMTA0IDEwNiI+PGRlZnM+PHN0eWxlPi5jbHMtMXtmaWxsOiMyMzFmMjA7fS5jbHMtMntmaWxsOiNmZmY5YWU7fS5jbHMtM3tmaWxsOiMwMGFlZWY7fS5jbHMtNHtmaWxsOiMwMGE5NGY7fS5jbHMtNXtmaWxsOiNmMTVkMjI7fS5jbHMtNntmaWxsOiNlMzFiMjM7fTwvc3R5bGU+PC9kZWZzPjx0aXRsZT5EaXNjb3Vyc2VfbG9nbzwvdGl0bGU+PGcgaWQ9IkxheWVyXzIiPjxnIGlkPSJMYXllcl8zIj48cGF0aCBjbGFzcz0iY2xzLTEiIGQ9Ik01MS44NywwQzIzLjcxLDAsMCwyMi44MywwLDUxYzAsLjkxLDAsNTIuODEsMCw1Mi44MWw1MS44Ni0uMDVjMjguMTYsMCw1MS0yMy43MSw1MS01MS44N1M4MCwwLDUxLjg3LDBaIi8+PHBhdGggY2xhc3M9ImNscy0yIiBkPSJNNTIuMzcsMTkuNzRBMzEuNjIsMzEuNjIsMCwwLDAsMjQuNTgsNjYuNDFsLTUuNzIsMTguNEwzOS40LDgwLjE3YTMxLjYxLDMxLjYxLDAsMSwwLDEzLTYwLjQzWiIvPjxwYXRoIGNsYXNzPSJjbHMtMyIgZD0iTTc3LjQ1LDMyLjEyYTMxLjYsMzEuNiwwLDAsMS0zOC4wNSw0OEwxOC44Niw4NC44MmwyMC45MS0yLjQ3QTMxLjYsMzEuNiwwLDAsMCw3Ny40NSwzMi4xMloiLz48cGF0aCBjbGFzcz0iY2xzLTQiIGQ9Ik03MS42MywyNi4yOUEzMS42LDMxLjYsMCwwLDEsMzguOCw3OEwxOC44Niw4NC44MiwzOS40LDgwLjE3QTMxLjYsMzEuNiwwLDAsMCw3MS42MywyNi4yOVoiLz48cGF0aCBjbGFzcz0iY2xzLTUiIGQ9Ik0yNi40Nyw2Ny4xMWEzMS42MSwzMS42MSwwLDAsMSw1MS0zNUEzMS42MSwzMS42MSwwLDAsMCwyNC41OCw2Ni40MWwtNS43MiwxOC40WiIvPjxwYXRoIGNsYXNzPSJjbHMtNiIgZD0iTTI0LjU4LDY2LjQxQTMxLjYxLDMxLjYxLDAsMCwxLDcxLjYzLDI2LjI5YTMxLjYxLDMxLjYxLDAsMCwwLTQ5LDM5LjYzbC0zLjc2LDE4LjlaIi8+PC9nPjwvZz48L3N2Zz4="/></a><!----> <!--[0--><a href="https://colab.research.google.com/github/huggingface/notebooks/blob/master/course/en/chapter8/section3.ipynb" target="_blank"><img alt="Open In Colab" class="!m-0" src="https://colab.research.google.com/assets/colab-badge.svg"/></a><!--]--> <!--[0--><a href="https://studiolab.sagemaker.aws/import/github/huggingface/notebooks/blob/master/course/en/chapter8/section3.ipynb" target="_blank"><img alt="Open In Studio Lab" class="!m-0" src="https://studiolab.sagemaker.aws/studiolab.svg"/></a><!--]--></div><!----> <iframe class="w-full xl:w-4/6 h-80" src="https://www.youtube-nocookie.com/embed/S2EEG3JIt2A" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen=""></iframe><!----> <p><a href="https://discuss.huggingface.co" rel="nofollow">انجمن‌های هاگینگ‌فیس</a> مکان بسیار خوبی برای دریافت کمک از تیم متن‌باز و جامعه‌ی گسترده‌تر هاگینگ‌فیس هستند. صفحه‌ی اصلی انجمن در یک روز معمولی چیزی شبیه تصویر زیر است:</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forums.png" alt="The Hugging Face forums." width="100%"/></div> <p>در سمت چپ می‌توانید دسته‌بندی‌هایی را ببینید که موضوع‌های مختلف در آن‌ها گروه‌بندی شده‌اند و سمت راست جدیدترین موضوع‌ها را نشان می‌دهد. موضوع پستی است که عنوان، دسته‌بندی و توضیح دارد؛ چیزی بسیار شبیه issueهای گیت‌هاب که هنگام ساخت دیتاسِت خودمان در <a href="/course/chapter5">فصل ۵</a> دیدیم. همان‌طور که از نامش پیداست، دسته‌بندی <a href="https://discuss.huggingface.co/c/beginners/5" rel="nofollow">مبتدیان</a> عمدتاً برای افرادی است که تازه کار با کتابخانه‌ها و اکوسیستم هاگینگ‌فیس را شروع کرده‌اند. هر پرسشی درباره‌ی هر یک از کتابخانه‌ها در آنجا پذیرفته است؛ چه برای اشکال‌زدایی کد و چه برای درخواست راهنمایی درباره‌ی انجام کاری. (البته اگر پرسشتان به یک کتابخانه‌ی خاص مربوط است، بهتر است به دسته‌بندی همان کتابخانه در انجمن بروید.)</p> <p>به‌طور مشابه، دسته‌بندی‌های <a href="https://discuss.huggingface.co/c/intermediate/6" rel="nofollow">متوسط</a> و <a href="https://discuss.huggingface.co/c/research/7" rel="nofollow">پژوهش</a> برای پرسش‌های پیشرفته‌تر هستند؛ مثلاً درباره‌ی کتابخانه‌ها یا پژوهش جدید و جالبی در NLP که می‌خواهید درباره‌اش گفت‌وگو کنید.</p> <p>و طبیعتاً، باید به دسته‌بندی <a href="https://discuss.huggingface.co/c/course/20" rel="nofollow">دوره</a> هم اشاره کنیم، جایی که می‌توانید هر سوالی که مربوط به دوره هاگینگ‌فِیس دارید را بپرسید!</p> <p>پس از انتخاب دسته‌بندی، آماده‌اید نخستین موضوع خود را بنویسید. در انجمن <a href="https://discuss.huggingface.co/t/how-to-request-support/3128" rel="nofollow">راهنماهایی</a> برای این کار وجود دارد و در این بخش چند قابلیت سازنده‌ی یک موضوع خوب را بررسی می‌کنیم.</p> <!--[1--><h2 class="relative group"><a id="writing-a-good-forum-post" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#writing-a-good-forum-post"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>نوشتن یک پست خوب در انجمن</span></h2><!--]--><!----> <p>برای مثال، فرض کنید می‌خواهیم از مقاله‌های ویکی‌پدیا embedding بسازیم تا یک موتور جست‌وجوی سفارشی ایجاد کنیم. طبق معمول، توکن‌ساز و مدل را به شکل زیر بارگذاری می‌کنیم:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Copied</div><!----></button><!----></div> <pre class="language-python "><!----><span class="hljs-keyword">from</span> transformers <span class="hljs-keyword">import</span> AutoTokenizer, AutoModel
model_checkpoint = <span class="hljs-string">&quot;distilbert-base-uncased&quot;</span>
tokenizer = AutoTokenizer.from_pretrained(model_checkpoint)
model = AutoModel.from_pretrained(model_checkpoint)<!----></pre></div><!----> <p>حالا فرض کنید می‌خواهیم یک بخش کامل از <a href="https://en.wikipedia.org/wiki/Transformers" rel="nofollow">مقاله‌ی ویکی‌پدیا</a> درباره‌ی ترنسفورمرها را embedding کنیم (منظور مجموعه‌ی فیلم‌هاست، نه کتابخانه!):</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Copied</div><!----></button><!----></div> <pre class="language-python "><!---->text = <span class="hljs-string">&quot;&quot;&quot;
Generation One is a retroactive term for the Transformers characters that
appeared between 1984 and 1993. The Transformers began with the 1980s Japanese
toy lines Micro Change and Diaclone. They presented robots able to transform
into everyday vehicles, electronic items or weapons. Hasbro bought the Micro
Change and Diaclone toys, and partnered with Takara. Marvel Comics was hired by
Hasbro to create the backstory; editor-in-chief Jim Shooter wrote an overall
story, and gave the task of creating the characthers to writer Dennis O&#x27;Neil.
Unhappy with O&#x27;Neil&#x27;s work (although O&#x27;Neil created the name &quot;Optimus Prime&quot;),
Shooter chose Bob Budiansky to create the characters.
The Transformers mecha were largely designed by Shōji Kawamori, the creator of
the Japanese mecha anime franchise Macross (which was adapted into the Robotech
franchise in North America). Kawamori came up with the idea of transforming
mechs while working on the Diaclone and Macross franchises in the early 1980s
(such as the VF-1 Valkyrie in Macross and Robotech), with his Diaclone mechs
later providing the basis for Transformers.
The primary concept of Generation One is that the heroic Optimus Prime, the
villainous Megatron, and their finest soldiers crash land on pre-historic Earth
in the Ark and the Nemesis before awakening in 1985, Cybertron hurtling through
the Neutral zone as an effect of the war. The Marvel comic was originally part
of the main Marvel Universe, with appearances from Spider-Man and Nick Fury,
plus some cameos, as well as a visit to the Savage Land.
The Transformers TV series began around the same time. Produced by Sunbow
Productions and Marvel Productions, later Hasbro Productions, from the start it
contradicted Budiansky&#x27;s backstories. The TV series shows the Autobots looking
for new energy sources, and crash landing as the Decepticons attack. Marvel
interpreted the Autobots as destroying a rogue asteroid approaching Cybertron.
Shockwave is loyal to Megatron in the TV series, keeping Cybertron in a
stalemate during his absence, but in the comic book he attempts to take command
of the Decepticons. The TV series would also differ wildly from the origins
Budiansky had created for the Dinobots, the Decepticon turned Autobot Jetfire
(known as Skyfire on TV), the Constructicons (who combine to form
Devastator),[19][20] and Omega Supreme. The Marvel comic establishes early on
that Prime wields the Creation Matrix, which gives life to machines. In the
second season, the two-part episode The Key to Vector Sigma introduced the
ancient Vector Sigma computer, which served the same original purpose as the
Creation Matrix (giving life to Transformers), and its guardian Alpha Trion.
&quot;&quot;&quot;</span>
inputs = tokenizer(text, return_tensors=<span class="hljs-string">&quot;pt&quot;</span>)
logits = model(**inputs).logits<!----></pre></div><!----> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Copied</div><!----></button><!----></div> <pre class="language-python "><!---->IndexError: index out of <span class="hljs-built_in">range</span> <span class="hljs-keyword">in</span> <span class="hljs-variable language_">self</span><!----></pre></div><!----> <p>ای وای، به مشکل خوردیم—پیام خطا بسیار رمزآلودتر از خطاهایی است که در <a href="/course/chapter8/section2">بخش ۲</a> دیدیم! از traceback کامل سر درنمی‌آوریم، پس تصمیم می‌گیریم برای کمک به انجمن‌های هاگینگ‌فیس مراجعه کنیم. چگونه باید موضوع را مطرح کنیم؟</p> <p>برای شروع، باید روی دکمه‌ی «New Topic» در گوشه‌ی بالا سمت راست کلیک کنیم (توجه کنید که برای ایجاد موضوع باید وارد حساب شده باشیم):</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forums-new-topic.png" alt="Creating a new forum topic." width="100%"/></div> <p>با این کار، رابطی برای نوشتن باز می‌شود که در آن می‌توانیم عنوان موضوع را وارد کنیم، دسته‌بندی را انتخاب کنیم و محتوا را بنویسیم:</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forum-topic01.png" alt="The interface for creating a forum topic." width="100%"/></div> <p>از آنجا که به نظر می‌رسد خطا منحصراً به 🤗 ترنسفورمرها مربوط است، همین گزینه را برای دسته‌بندی انتخاب می‌کنیم. نخستین تلاشمان برای توضیح مشکل ممکن است چیزی شبیه این باشد:</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forum-topic02.png" alt="Drafting the content for a new forum topic." width="100%"/></div> <p>اگرچه این تاپیک حاوی پیام خطایی است که در مورد آن به کمک نیاز داریم، اما چند مشکل در نحوه نگارش آن وجود دارد:</p> <p>۱. عنوان خیلی توصیفی نیست، بنابراین هر کسی که در انجمن جستجو کند، بدون خواندن متن اصلی نمی‌تواند تشخیص دهد که موضوع در مورد چیست.
۲. متن اصلی اطلاعات کافی درباره‌ی <em>محل</em> وقوع خطا و <em>نحوه‌ی بازتولید</em> آن ارائه نمی‌کند.
۳. موضوع، چند نفر را مستقیماً و با لحنی تاحدی مطالبه‌گر تگ می‌کند.</p> <p>موضوعاتی مثل این بعید است که به سرعت به پاسخ برسند (اگر اصلاً پاسخی دریافت کنند)، بنابراین بیایید ببینیم چگونه می‌توانیم آن را بهبود بخشیم. با اولین مورد انتخاب یک عنوان خوب شروع خواهیم کرد.</p> <!--[2--><h3 class="relative group"><a id="choosing-a-descriptive-title" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#choosing-a-descriptive-title"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>انتخاب عنوانی توصیفی</span></h3><!--]--><!----> <p>اگر برای اشکالی در کدتان کمک می‌خواهید، قاعده‌ی کلی خوب این است که در عنوان اطلاعات کافی بگنجانید تا دیگران سریع تشخیص دهند آیا می‌توانند به پرسشتان پاسخ دهند یا نه. در مثال ما، نام استثنای ایجادشده را می‌دانیم و سرنخ‌هایی داریم که نشان می‌دهد خطا در گذر رو به جلوِ مدل رخ می‌دهد؛ جایی که <code>model(**inputs)</code> را فراخوانی می‌کنیم. برای انتقال این موضوع، یکی از عنوان‌های ممکن چنین است:</p> <blockquote><p>منبع خطای IndexError در پاس رو به جلوی AutoModel چیست؟</p></blockquote> <p>این عنوان به خواننده می‌گوید <em>فکر می‌کنید خطا از کجا می‌آید</em> و اگر قبلاً با <code>IndexError</code> روبه‌رو شده باشد، احتمالاً می‌داند چگونه آن را اشکال‌زدایی کند. البته عنوان می‌تواند هر چیزی باشد و گزینه‌های دیگری مانند این هم مناسب‌اند:</p> <blockquote><p>چرا مدل من یک IndexError تولید می‌کند؟</p></blockquote> <p>حالا که عنوانی توصیفی داریم، بیایید به بهبود متن اصلی بپردازیم.</p> <!--[2--><h3 class="relative group"><a id="formatting-your-code-snippets" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#formatting-your-code-snippets"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>قالب‌بندی قطعه کدهای شما</span></h3><!--]--><!----> <p>خواندن کد منبع در یک IDE به‌اندازه‌ی کافی دشوار است، اما وقتی کد به‌صورت متن ساده کپی و جای‌گذاری شود دشوارتر هم می‌شود! خوشبختانه انجمن‌های هاگینگ‌فیس از Markdown پشتیبانی می‌کنند؛ بنابراین همیشه بلوک‌های کد را با سه بک‌تیک (```) دربر بگیرید تا خوانایی بیشتری داشته باشند. بیایید پیام خطا را مرتب کنیم و هم‌زمان متن اصلی را کمی مؤدبانه‌تر بنویسیم:</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forum-topic03.png" alt="Our revised forum topic, with proper code formatting." width="100%"/></div> <p>همان‌طور که در تصویر می‌بینید، دربرگرفتن بلوک‌های کد با بک‌تیک، متن خام را به کدی قالب‌بندی‌شده و رنگی تبدیل می‌کند! همچنین توجه کنید که می‌توان از بک‌تیک‌های تکی برای قالب‌بندی متغیرهای درون‌خطی، مانند <code>distilbert-base-uncased</code>، استفاده کرد. این موضوع حالا بسیار بهتر به نظر می‌رسد و شاید با کمی شانس کسی در جامعه بتواند حدس بزند خطا درباره‌ی چیست. اما به‌جای تکیه بر شانس، با افزودن traceback در تمام جزئیاتش کار را برای دیگران آسان‌تر کنیم!</p> <!--[2--><h3 class="relative group"><a id="including-the-full-traceback" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#including-the-full-traceback"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>گنجاندن traceback کامل</span></h3><!--]--><!----> <p>از آنجا که آخرین خط traceback اغلب برای اشکال‌زدایی کد خودتان کافی است، ممکن است وسوسه شوید برای «صرفه‌جویی در فضا» فقط همان را در موضوع قرار دهید. با اینکه نیت خوبی دارد، این کار اشکال‌زدایی مشکل را برای دیگران <em>دشوارتر</em> می‌کند، چون اطلاعات بخش‌های بالاتر traceback نیز می‌تواند بسیار مفید باشد. بنابراین، بهتر است <em>کل</em> traceback را کپی و جای‌گذاری کنید و مطمئن شوید که به‌خوبی قالب‌بندی شده است. از آنجا که tracebackها ممکن است طولانی باشند، بعضی افراد ترجیح می‌دهند آن‌ها را بعد از توضیح کد منبع نشان دهند. بیایید همین کار را انجام دهیم. اکنون موضوع انجمن ما شبیه زیر است:</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forum-topic04.png" alt="Our example forum topic, with the complete traceback." width="100%"/></div> <p>این بسیار آموزنده‌تر است، و یک خواننده دقیق ممکن است بتواند به این نکته اشاره کند که به نظر می‌رسد مشکل به دلیل ارسال یک ورودی طولانی به دلیل این خط در traceback است:</p> <blockquote><p>طول توالی شاخص‌های توکن از حداکثر طول توالی مشخص شده برای این مدل (583 > 512) بیشتر است.</p></blockquote> <p>بااین‌حال، می‌توانیم کار را برای آن‌ها آسان‌تر کنیم و کدی را که خطا را ایجاد کرده است ارائه دهیم. بیایید همین حالا این کار را انجام دهیم.</p> <!--[2--><h3 class="relative group"><a id="providing-a-reproducible-example" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#providing-a-reproducible-example"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>ارائه‌ی یک مثال قابل‌بازتولید</span></h3><!--]--><!----> <p>اگر تا به حال تلاش کرده باشید کد شخص دیگری را اشکال‌زدایی کنید، احتمالاً ابتدا سعی کرده‌اید مشکلی را که گزارش کرده بازسازی کنید تا بتوانید traceback را مرحله‌به‌مرحله دنبال کرده و خطا را مشخص کنید. دریافت یا ارائه‌ی کمک در انجمن‌ها نیز همین‌طور است؛ بنابراین اگر مثال کوچکی ارائه کنید که خطا را بازتولید کند، بسیار کمک‌کننده خواهد بود. نیمی از مواقع، همین تمرین به شما کمک می‌کند بفهمید چه چیزی اشتباه است. در هر صورت، بخش گمشده‌ی مثال ما نشان‌دادن <em>ورودی‌هایی</em> است که به مدل داده‌ایم. با این کار، مثال کامل‌شده‌ای مانند زیر خواهیم داشت:</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forum-topic05.png" alt="The final version of our forum topic." width="100%"/></div> <p>این موضوع اکنون اطلاعات زیادی دارد و به شکلی نوشته شده است که احتمال جلب توجه جامعه و دریافت پاسخی مفید را بسیار بیشتر می‌کند. با این دستورالعمل‌های پایه، حالا می‌توانید برای یافتن پاسخ پرسش‌های خود درباره‌ی 🤗 ترنسفورمرها موضوع‌های خوبی ایجاد کنید!</p></div> <a class="!text-gray-400 !no-underline text-sm flex items-center not-prose mt-4" href="https://github.com/huggingface/course/blob/main/chapters/fa/chapter8/3.mdx" target="_blank"><svg class="mr-1" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M31,16l-7,7l-1.41-1.41L28.17,16l-5.58-5.59L24,9l7,7z"></path><path d="M1,16l7-7l1.41,1.41L3.83,16l5.58,5.59L8,23l-7-7z"></path><path d="M12.419,25.484L17.639,6.552l1.932,0.518L14.351,26.002z"></path></svg><!----> <span><span class="underline">Update</span> on GitHub</span></a><!----> <p></p><!--]--><!----><!--]--><!--]--><!--]--> <!--[-1--><!--]--><!--]-->
<script>
{
__sveltekit_pfm8ny = {
base: "/docs/course/pr_1364/fa",
assets: "/docs/course/pr_1364/fa"
};
const element = document.currentScript.parentElement;
Promise.all([
import("/docs/course/pr_1364/fa/_app/immutable/entry/start.CqZXmSrv.js"),
import("/docs/course/pr_1364/fa/_app/immutable/entry/app.B4UvgX5H.js")
]).then(([kit, app]) => {
kit.start(app, element, {
node_ids: [0, 89],
data: [null,null],
form: null,
error: null
});
});
}
</script>

Xet Storage Details

Size:
37 kB
·
Xet hash:
cca4692e6612a4b776930627547aca90d8649b47c747293dc0c55e2bdb3bab8a

Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.