Hugging Face's logo

Buckets:
hf-doc-build
/
doc-dev

Files
xet
hf-doc-build/doc-dev / agents-course /pr_742 /ru-RU /unit1 /tutorial.html
HuggingFaceDocBuilder's picture
HuggingFaceDocBuilder
download
raw
37.3 kB
<meta charset="utf-8" /><meta name="hf:doc:metadata" content="{&quot;title&quot;:&quot;Давайте создадим нашего первого агента с помощью smolagents&quot;,&quot;local&quot;:&quot;давайте-создадим-нашего-первого-агента-с-помощью-smolagents&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;Что такое smolagents?&quot;,&quot;local&quot;:&quot;что-такое-smolagents&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2},{&quot;title&quot;:&quot;Давайте создадим нашего агента!&quot;,&quot;local&quot;:&quot;давайте-создадим-нашего-агента&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;Инструменты&quot;,&quot;local&quot;:&quot;инструменты&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;Агент&quot;,&quot;local&quot;:&quot;агент&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3}],&quot;depth&quot;:2}],&quot;depth&quot;:1}"/>
 <link href="/docs/agents-course/pr_742/ru-RU/_app/immutable/entry/start.DpDIeGBz.js" rel="modulepreload">
 <link href="/docs/agents-course/pr_742/ru-RU/_app/immutable/chunks/BnFpddhb.js" rel="modulepreload">
 <link href="/docs/agents-course/pr_742/ru-RU/_app/immutable/chunks/BSLaTJ2c.js" rel="modulepreload">
 <link href="/docs/agents-course/pr_742/ru-RU/_app/immutable/entry/app.NlwnJ7Y2.js" rel="modulepreload">
 <link href="/docs/agents-course/pr_742/ru-RU/_app/immutable/chunks/lRqfJV97.js" rel="modulepreload">
 <link href="/docs/agents-course/pr_742/ru-RU/_app/immutable/chunks/C5Eq4c9g.js" rel="modulepreload">
 <link href="/docs/agents-course/pr_742/ru-RU/_app/immutable/chunks/DsnmJJEf.js" rel="modulepreload">
 <link href="/docs/agents-course/pr_742/ru-RU/_app/immutable/chunks/BleB-t_z.js" rel="modulepreload">
 <link href="/docs/agents-course/pr_742/ru-RU/_app/immutable/nodes/0.CWJ8VRdM.js" rel="modulepreload">
 <link href="/docs/agents-course/pr_742/ru-RU/_app/immutable/nodes/25.VT-dr-4U.js" rel="modulepreload">
 <link href="/docs/agents-course/pr_742/ru-RU/_app/immutable/chunks/Chx20VCR.js" rel="modulepreload">
 <!--1wnmgyx--><meta name="hf:doc:metadata" content="{&quot;title&quot;:&quot;Давайте создадим нашего первого агента с помощью smolagents&quot;,&quot;local&quot;:&quot;давайте-создадим-нашего-первого-агента-с-помощью-smolagents&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;Что такое smolagents?&quot;,&quot;local&quot;:&quot;что-такое-smolagents&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2},{&quot;title&quot;:&quot;Давайте создадим нашего агента!&quot;,&quot;local&quot;:&quot;давайте-создадим-нашего-агента&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;Инструменты&quot;,&quot;local&quot;:&quot;инструменты&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;Агент&quot;,&quot;local&quot;:&quot;агент&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3}],&quot;depth&quot;:2}],&quot;depth&quot;:1}"/><!---->
 <link href="/docs/agents-course/pr_742/ru-RU/_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="давайте-создадим-нашего-первого-агента-с-помощью-smolagents" 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="#давайте-создадим-нашего-первого-агента-с-помощью-smolagents"><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>Давайте создадим нашего первого агента с помощью smolagents</span></h1><!--]--><!----> <p>В прошлом разделе мы узнали, как можно создавать агентов с нуля, используя код на Python, и <strong>увидели, насколько утомительным может быть этот процесс</strong>. К счастью, многие библиотеки Агентов упрощают эту работу, <strong>выполняя большую часть тяжелой работы за вас</strong>.</p> <p>В этом уроке <strong>вы создадите своего первого агента</strong>, способного выполнять такие действия, как генерация изображений, веб-поиск, проверка часового пояса и многое другое!</p> <p>Вы также опубликуете своего агента <strong>в пространстве Hugging Face Space, чтобы вы могли поделиться им с друзьями и коллегами</strong>.</p> <p>Давайте начнем!</p> <!--[1--><h2 class="relative group"><a id="что-такое-smolagents" 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="#что-такое-smolagents"><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>Что такое smolagents?</span></h2><!--]--><!----> <img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit1/smolagents.png" alt="smolagents"/> <p>Для создания этого агента мы будем использовать библиотеку <code>smolagents</code>, которая <strong>предоставляет основу для разработки агентов с легкостью</strong>.</p> <p>Эта легковесная библиотека создана для простоты, но она абстрагирует большую часть сложности создания агента, позволяя вам сосредоточиться на разработке поведения агента.</p> <p>В следующем разделе мы углубимся в изучение smolagents. А пока вы можете ознакомиться с этой <a href="https://huggingface.co/blog/smolagents" target="_blank">статьей в блоге</a> или с <a href="https://github.com/huggingface/smolagents" target="_blank">репозиторием библиотеки на GitHub</a>.</p> <p>Вкратце, <code>smolagents</code> - это библиотека, ориентированная на <strong>Агентов кода</strong>, вид агента, который выполняет <strong>“Действия”</strong> через блоки кода, а затем <strong>“Наблюдает”</strong> за результатами, выполняя код.</p> <p>Вот пример того, что мы будем создавать!</p> <p>Мы предоставили нашему агенту <strong>Инструмент генерации изображений</strong> и попросили его сгенерировать изображение кошки.</p> <p>Агент внутри <code>smolagents</code> будет иметь <strong>такое же поведение, как и пользовательский агент, который мы построили ранее</strong>: он будет <strong>думать, действовать и наблюдать в цикле</strong>, пока не придет к окончательному ответу:</p> <iframe width="560" height="315" src="https://www.youtube.com/embed/PQDKcWiuln4?si=ysSTDZoi8y55FVvA" title="Видеоплеер YouTube" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen=""></iframe> <p>Захватывающе, правда?</p> <!--[1--><h2 class="relative group"><a id="давайте-создадим-нашего-агента" 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="#давайте-создадим-нашего-агента"><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>Для начала продублируйте это пространство (Space): <a href="https://huggingface.co/spaces/agents-course/First_agent_template" target="_blank">https://huggingface.co/spaces/agents-course/First_agent_template</a></p> <blockquote><p>Спасибо <a href="https://huggingface.co/m-ric" target="_blank">Aymeric</a> за этот шаблон! 🙌</p></blockquote> <p>Дублирование этого пространства означает <strong>создание локальной копии в вашем собственном профиле</strong>:</p> <img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit1/duplicate-space.gif" alt="Дубликат"/> <p>На протяжении всего этого урока единственным файлом, который вам придется изменить, будет (на данный момент неполный) <strong>“app.py »</strong>. Здесь вы можете увидеть <a href="https://huggingface.co/spaces/agents-course/First_agent_template/blob/main/app.py" rel="nofollow">оригинал в шаблоне</a>. Чтобы найти свой, зайдите в свою копию пространства, затем перейдите на вкладку <code>Files</code>, а затем на <code>app.py</code> в списке каталогов.</p> <p>Давайте разберем код вместе:</p> <ul><li>Файл начинается с простого, но необходимого импорта библиотек</li></ul> <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> smolagents <span class="hljs-keyword">import</span> CodeAgent, DuckDuckGoSearchTool, InferenceClientModel, load_tool, tool
<span class="hljs-keyword">import</span> datetime
<span class="hljs-keyword">import</span> requests
<span class="hljs-keyword">import</span> pytz
<span class="hljs-keyword">import</span> yaml
<span class="hljs-keyword">from</span> tools.final_answer <span class="hljs-keyword">import</span> FinalAnswerTool<!----></pre></div><!----> <p>Как уже говорилось ранее, мы будем напрямую использовать класс <strong>CodeAgent</strong> из <strong>smolagents</strong>.</p> <!--[2--><h3 class="relative group"><a id="инструменты" 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="#инструменты"><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>Теперь перейдем к инструментам! Если вы хотите узнать больше об инструментах, не стесняйтесь вернуться к разделу курса <a href="tools">Инструменты</a>.</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-meta">@tool</span>
<span class="hljs-keyword">def</span> <span class="hljs-title function_">my_custom_tool</span>(<span class="hljs-params">arg1:<span class="hljs-built_in">str</span>, arg2:<span class="hljs-built_in">int</span></span>)-&gt; <span class="hljs-built_in">str</span>: <span class="hljs-comment"># важно указать возвращаемый тип</span>
 <span class="hljs-comment"># Сохраните этот формат для описания инструмента / описания аргументов, но не стесняйтесь модифицировать инструмент</span>
 <span class="hljs-string">&quot;&quot;&quot;Инструмент, который пока ничего не делает
 Аргументы:
 arg1: первый аргумент
 arg2: второй аргумент
 &quot;&quot;&quot;</span>
 <span class="hljs-keyword">return</span> <span class="hljs-string">&quot;Какую магию вы будете создавать?&quot;</span>
<span class="hljs-meta">@tool</span>
<span class="hljs-keyword">def</span> <span class="hljs-title function_">get_current_time_in_timezone</span>(<span class="hljs-params">timezone: <span class="hljs-built_in">str</span></span>) -&gt; <span class="hljs-built_in">str</span>:
 <span class="hljs-string">&quot;&quot;&quot;Инструмент для получения текущего местного времени в указанном часовом поясе.
 Аргменты:
 timezone: Строка, представляющая действительный часовой пояс (например, &#x27;America/New_York&#x27;).
 &quot;&quot;&quot;</span>
 <span class="hljs-keyword">try</span>:
 <span class="hljs-comment"># Создание объекта timezone</span>
 tz = pytz.timezone(timezone)
 <span class="hljs-comment"># Получение текущего времени в заданном часовом поясе</span>
 local_time = datetime.datetime.now(tz).strftime(<span class="hljs-string">&quot;%Y-%m-%d %H:%M:%S&quot;</span>)
 <span class="hljs-keyword">return</span> <span class="hljs-string">f&quot;Текущее местное время в <span class="hljs-subst">{timezone}</span> составляет: <span class="hljs-subst">{local_time}</span>&quot;</span>
 <span class="hljs-keyword">except</span> Exception <span class="hljs-keyword">as</span> e:
 <span class="hljs-keyword">return</span> <span class="hljs-string">f&quot;Ошибка получения времени для часового пояса &#x27;<span class="hljs-subst">{timezone}</span>&#x27;: <span class="hljs-subst">{<span class="hljs-built_in">str</span>(e)}</span>&quot;</span><!----></pre></div><!----> <p>Инструменты - это то, что мы призываем вас создать в этом разделе! Мы приводим два примера:</p> <ol><li><strong>нерабочий фиктивный инструмент</strong>, который вы можете модифицировать, чтобы сделать что-то полезное.</li> <li><strong>действительно работающий инструмент</strong>, который получает текущее время в любой точке мира.</li></ol> <p>Чтобы определить свой инструмент, необходимо:</p> <ol><li>Предоставить входной и выходной типы для вашей функции, как в <code>get_current_time_in_timezone(timezone: str) -> str:</code></li> <li><strong>Написать хорошо отформатированную строку документации</strong>. <code>smolagents</code> ожидает, что все аргументы будут иметь <strong>текстовое описание в строке документации</strong>.</li></ol> <!--[2--><h3 class="relative group"><a id="агент" 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="#агент"><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>Он использует <a href="https://huggingface.co/Qwen/Qwen2.5-Coder-32B-Instruct" rel="nofollow"><code>Qwen/Qwen2.5-Coder-32B-Instruct</code></a> в качестве движка LLM. Это очень способная модель, к которой мы будем обращаться через бессерверный API.</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 "><!---->final_answer = FinalAnswerTool()
model = InferenceClientModel(
 max_tokens=<span class="hljs-number">2096</span>,
 temperature=<span class="hljs-number">0.5</span>,
 model_id=<span class="hljs-string">&#x27;Qwen/Qwen2.5-Coder-32B-Instruct&#x27;</span>,
 custom_role_conversions=<span class="hljs-literal">None</span>,
)
<span class="hljs-keyword">with</span> <span class="hljs-built_in">open</span>(<span class="hljs-string">&quot;prompts.yaml&quot;</span>, <span class="hljs-string">&#x27;r&#x27;</span>) <span class="hljs-keyword">as</span> stream:
 prompt_templates = yaml.safe_load(stream)
<span class="hljs-comment"># Создаем наш Кодовый Агент</span>
agent = CodeAgent(
 model=model,
 tools=[final_answer], <span class="hljs-comment"># добавьте сюда свои инструменты (не удаляйте final_answer)</span>
 max_steps=<span class="hljs-number">6</span>,
 verbosity_level=<span class="hljs-number">1</span>,
 grammar=<span class="hljs-literal">None</span>,
 planning_interval=<span class="hljs-literal">None</span>,
 name=<span class="hljs-literal">None</span>,
 description=<span class="hljs-literal">None</span>,
 prompt_templates=prompt_templates
)
GradioUI(agent).launch()<!----></pre></div><!----> <p>Этот агент по-прежнему использует <code>InferenceClient</code>, который мы видели в предыдущем разделе за классом <strong>InferenceClientModel</strong>!</p> <p>Мы приведем более подробные примеры, когда будем представлять фреймворк в разделе 2. Пока же вам нужно сосредоточиться на <strong>добавлении новых инструментов в список инструментов</strong> с помощью параметра <code>tools</code> вашего Агента.</p> <p>Например, вы можете использовать <code>DuckDuckGoSearchTool</code>, который был импортирован в первой строке кода, или вы можете изучить <code>image_generation_tool</code>, который загружается из Hub позже в коде.</p> <p><strong>Добавление инструментов даст вашему агенту новые возможности</strong>, попробуйте проявить творческий подход!</p> <p>Полная версия “app.py”:</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> smolagents <span class="hljs-keyword">import</span> CodeAgent, DuckDuckGoSearchTool, InferenceClientModel, load_tool, tool
<span class="hljs-keyword">import</span> datetime
<span class="hljs-keyword">import</span> requests
<span class="hljs-keyword">import</span> pytz
<span class="hljs-keyword">import</span> yaml
<span class="hljs-keyword">from</span> tools.final_answer <span class="hljs-keyword">import</span> FinalAnswerTool
<span class="hljs-keyword">from</span> Gradio_UI <span class="hljs-keyword">import</span> GradioUI
<span class="hljs-comment"># Ниже приведен пример инструмента, который ничего не делает. Удивите нас своей креативностью!</span>
<span class="hljs-meta">@tool</span>
<span class="hljs-keyword">def</span> <span class="hljs-title function_">my_custom_tool</span>(<span class="hljs-params">arg1:<span class="hljs-built_in">str</span>, arg2:<span class="hljs-built_in">int</span></span>)-&gt; <span class="hljs-built_in">str</span>: <span class="hljs-comment"># важно указать возвращаемый тип</span>
 <span class="hljs-comment"># Сохраните этот формат для описания инструмента / описания аргументов, но не стесняйтесь модифицировать инструмент</span>
 <span class="hljs-string">&quot;&quot;&quot;Инструмент, который пока ничего не делает
 Аргументы:
 arg1: первый аргумент
 arg2: второй аргумент
 &quot;&quot;&quot;</span>
 <span class="hljs-keyword">return</span> <span class="hljs-string">&quot;Какую магию вы будете создавать?&quot;</span>
<span class="hljs-meta">@tool</span>
<span class="hljs-keyword">def</span> <span class="hljs-title function_">get_current_time_in_timezone</span>(<span class="hljs-params">timezone: <span class="hljs-built_in">str</span></span>) -&gt; <span class="hljs-built_in">str</span>:
 <span class="hljs-string">&quot;&quot;&quot;Инструмент для получения текущего местного времени в указанном часовом поясе.
 Аргменты:
 timezone: Строка, представляющая действительный часовой пояс (например, &#x27;America/New_York&#x27;).
 &quot;&quot;&quot;</span>
 <span class="hljs-keyword">try</span>:
 <span class="hljs-comment"># Создание объекта timezone</span>
 tz = pytz.timezone(timezone)
 <span class="hljs-comment"># Получение текущего времени в заданном часовом поясе</span>
 local_time = datetime.datetime.now(tz).strftime(<span class="hljs-string">&quot;%Y-%m-%d %H:%M:%S&quot;</span>)
 <span class="hljs-keyword">return</span> <span class="hljs-string">f&quot;Текущее местное время в <span class="hljs-subst">{timezone}</span> составляет: <span class="hljs-subst">{local_time}</span>&quot;</span>
 <span class="hljs-keyword">except</span> Exception <span class="hljs-keyword">as</span> e:
 <span class="hljs-keyword">return</span> <span class="hljs-string">f&quot;Ошибка получения времени для часового пояса &#x27;<span class="hljs-subst">{timezone}</span>&#x27;: <span class="hljs-subst">{<span class="hljs-built_in">str</span>(e)}</span>&quot;</span>
final_answer = FinalAnswerTool()
model = InferenceClientModel(
max_tokens=<span class="hljs-number">2096</span>,
temperature=<span class="hljs-number">0.5</span>,
model_id=<span class="hljs-string">&#x27;Qwen/Qwen2.5-Coder-32B-Instruct&#x27;</span>,
custom_role_conversions=<span class="hljs-literal">None</span>,
)
<span class="hljs-comment"># Импорт инструмента из Hub</span>
image_generation_tool = load_tool(<span class="hljs-string">&quot;agents-course/text-to-image&quot;</span>, trust_remote_code=<span class="hljs-literal">True</span>)
<span class="hljs-keyword">with</span> <span class="hljs-built_in">open</span>(<span class="hljs-string">&quot;prompts.yaml&quot;</span>, <span class="hljs-string">&#x27;r&#x27;</span>) <span class="hljs-keyword">as</span> stream:
 prompt_templates = yaml.safe_load(stream)
agent = CodeAgent(
 model=model,
 tools=[final_answer], <span class="hljs-comment"># добавьте сюда свои инструменты (не удаляйте final_answer)</span>
 max_steps=<span class="hljs-number">6</span>,
 verbosity_level=<span class="hljs-number">1</span>,
 grammar=<span class="hljs-literal">None</span>,
 planning_interval=<span class="hljs-literal">None</span>,
 name=<span class="hljs-literal">None</span>,
 description=<span class="hljs-literal">None</span>,
 prompt_templates=prompt_templates
)
GradioUI(agent).launch()<!----></pre></div><!----> <p>Ваша <strong>Цель</strong> - познакомиться с Пространством и Агентом.</p> <p>В настоящее время агент в шаблоне <strong>не использует никаких инструментов, поэтому постарайтесь снабдить его некоторыми из готовых инструментов или даже сделать новые инструменты самостоятельно!</strong>.</p> <p>Мы с нетерпением ждем ваших потрясающих выводов агентов в канале discord <strong>#agents-course-showcase</strong>!</p> <hr/> <p>Поздравляем, вы создали своего первого агента! Не стесняйтесь поделиться им со своими друзьями и коллегами.</p> <p>Поскольку это ваша первая попытка, совершенно нормально, если он будет немного глючным или медленным. В следующих разделах мы узнаем, как создавать еще более совершенных агентов.</p> <p>Лучший способ научиться - это попробовать, поэтому не стесняйтесь обновлять его, добавлять новые инструменты, пробовать с другой моделью и т. д.</p> <p>В следующем разделе вы пройдете финальный тест и получите сертификат!</p> <a class="!text-gray-400 !no-underline text-sm flex items-center not-prose mt-4" href="https://github.com/huggingface/agents-course/blob/main/units/ru-RU/unit1/tutorial.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_yrdgk5 = {
 base: "/docs/agents-course/pr_742/ru-RU",
 assets: "/docs/agents-course/pr_742/ru-RU"
 };
 const element = document.currentScript.parentElement;
 Promise.all([
 import("/docs/agents-course/pr_742/ru-RU/_app/immutable/entry/start.DpDIeGBz.js"),
 import("/docs/agents-course/pr_742/ru-RU/_app/immutable/entry/app.NlwnJ7Y2.js")
 ]).then(([kit, app]) => {
 kit.start(app, element, {
 node_ids: [0, 25],
 data: [null,null],
 form: null,
 error: null
 });
 });
 }
 </script>

Xet Storage Details

Size:
37.3 kB
·
Xet hash:
6942094f1864a731ce3d60361384f609a608d4143616855d71104ae6f708cda0

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