Buckets:

hf-doc-build
/

doc-dev

Files

xet

hf-doc-build/doc-dev / agents-course /pr_421 /ru-RU /unit1 /tutorial.html

rtrm

28 days ago

download

raw

36.2 kB

	<meta charset="utf-8" /><meta name="hf:doc:metadata" content="{"title":"Давайте создадим нашего первого агента с помощью smolagents","local":"давайте-создадим-нашего-первого-агента-с-помощью-smolagents","sections":[{"title":"Что такое smolagents?","local":"что-такое-smolagents","sections":[],"depth":2},{"title":"Давайте создадим нашего агента!","local":"давайте-создадим-нашего-агента","sections":[{"title":"Инструменты","local":"инструменты","sections":[],"depth":3},{"title":"Агент","local":"агент","sections":[],"depth":3}],"depth":2}],"depth":1}">
	<link href="/docs/agents-course/pr_421/ru-RU/_app/immutable/assets/0.e3b0c442.css" rel="modulepreload">
	<link rel="modulepreload" href="/docs/agents-course/pr_421/ru-RU/_app/immutable/entry/start.0c7aa981.js">
	<link rel="modulepreload" href="/docs/agents-course/pr_421/ru-RU/_app/immutable/chunks/scheduler.f6b352c8.js">
	<link rel="modulepreload" href="/docs/agents-course/pr_421/ru-RU/_app/immutable/chunks/singletons.51ea3dbc.js">
	<link rel="modulepreload" href="/docs/agents-course/pr_421/ru-RU/_app/immutable/chunks/index.26cf6c5a.js">
	<link rel="modulepreload" href="/docs/agents-course/pr_421/ru-RU/_app/immutable/chunks/paths.f70def04.js">
	<link rel="modulepreload" href="/docs/agents-course/pr_421/ru-RU/_app/immutable/entry/app.3d01f465.js">
	<link rel="modulepreload" href="/docs/agents-course/pr_421/ru-RU/_app/immutable/chunks/index.7f38e934.js">
	<link rel="modulepreload" href="/docs/agents-course/pr_421/ru-RU/_app/immutable/nodes/0.666206a5.js">
	<link rel="modulepreload" href="/docs/agents-course/pr_421/ru-RU/_app/immutable/chunks/each.e59479a4.js">
	<link rel="modulepreload" href="/docs/agents-course/pr_421/ru-RU/_app/immutable/nodes/25.5d2117ca.js">
	<link rel="modulepreload" href="/docs/agents-course/pr_421/ru-RU/_app/immutable/chunks/CodeBlock.3ee8293b.js">
	<link rel="modulepreload" href="/docs/agents-course/pr_421/ru-RU/_app/immutable/chunks/index.687cf7c1.js"><!-- HEAD_svelte-u9bgzb_START --><meta name="hf:doc:metadata" content="{"title":"Давайте создадим нашего первого агента с помощью smolagents","local":"давайте-создадим-нашего-первого-агента-с-помощью-smolagents","sections":[{"title":"Что такое smolagents?","local":"что-такое-smolagents","sections":[],"depth":2},{"title":"Давайте создадим нашего агента!","local":"давайте-создадим-нашего-агента","sections":[{"title":"Инструменты","local":"инструменты","sections":[],"depth":3},{"title":"Агент","local":"агент","sections":[],"depth":3}],"depth":2}],"depth":1}"><!-- HEAD_svelte-u9bgzb_END --> <p></p> <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 class="" 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 data-svelte-h="svelte-13cghrt">В прошлом разделе мы узнали, как можно создавать агентов с нуля, используя код на Python, и <strong>увидели, насколько утомительным может быть этот процесс</strong>. К счастью, многие библиотеки Агентов упрощают эту работу, <strong>выполняя большую часть тяжелой работы за вас</strong>.</p> <p data-svelte-h="svelte-5gu2f">В этом уроке <strong>вы создадите своего первого агента</strong>, способного выполнять такие действия, как генерация изображений, веб-поиск, проверка часового пояса и многое другое!</p> <p data-svelte-h="svelte-y2uq6w">Вы также опубликуете своего агента <strong>в пространстве Hugging Face Space, чтобы вы могли поделиться им с друзьями и коллегами</strong>.</p> <p data-svelte-h="svelte-1s3q477">Давайте начнем!</p> <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 class="" 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 data-svelte-h="svelte-1oe96a3">Для создания этого агента мы будем использовать библиотеку <code>smolagents</code>, которая <strong>предоставляет основу для разработки агентов с легкостью</strong>.</p> <p data-svelte-h="svelte-xmzozo">Эта легковесная библиотека создана для простоты, но она абстрагирует большую часть сложности создания агента, позволяя вам сосредоточиться на разработке поведения агента.</p> <p data-svelte-h="svelte-qkt2tx">В следующем разделе мы углубимся в изучение smolagents. А пока вы можете ознакомиться с этой <a href="https://huggingface.co/blog/smolagents" target="_blank">статьей в блоге</a> или с <a href="https://github.com/huggingface/smolagents" target="_blank">репозиторием библиотеки на GitHub</a>.</p> <p data-svelte-h="svelte-1c60q2l">Вкратце, <code>smolagents</code> - это библиотека, ориентированная на <strong>Агентов кода</strong>, вид агента, который выполняет <strong>“Действия”</strong> через блоки кода, а затем <strong>“Наблюдает”</strong> за результатами, выполняя код.</p> <p data-svelte-h="svelte-1yzzdiv">Вот пример того, что мы будем создавать!</p> <p data-svelte-h="svelte-1xhi54d">Мы предоставили нашему агенту <strong>Инструмент генерации изображений</strong> и попросили его сгенерировать изображение кошки.</p> <p data-svelte-h="svelte-1l9vn1">Агент внутри <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 data-svelte-h="svelte-1l679en">Захватывающе, правда?</p> <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 class="" 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 data-svelte-h="svelte-1x7ip0e">Для начала продублируйте это пространство (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 data-svelte-h="svelte-vr0uy0"><p>Спасибо <a href="https://huggingface.co/m-ric" target="_blank">Aymeric</a> за этот шаблон! 🙌</p></blockquote> <p data-svelte-h="svelte-8cez41">Дублирование этого пространства означает <strong>создание локальной копии в вашем собственном профиле</strong>:</p> <img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit1/duplicate-space.gif" alt="Дубликат"> <p data-svelte-h="svelte-1x9v6km">На протяжении всего этого урока единственным файлом, который вам придется изменить, будет (на данный момент неполный) <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 data-svelte-h="svelte-1r17c4f">Давайте разберем код вместе:</p> <ul data-svelte-h="svelte-1gloaak"><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 class="" 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=""><!-- HTML_TAG_START --><span class="hljs-keyword">from</span> smolagents <span class="hljs-keyword">import</span> CodeAgent, DuckDuckGoSearchTool, HfApiModel, 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<!-- HTML_TAG_END --></pre></div> <p data-svelte-h="svelte-ht95kn">Как уже говорилось ранее, мы будем напрямую использовать класс <strong>CodeAgent</strong> из <strong>smolagents</strong>.</p> <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 class="" 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 data-svelte-h="svelte-1bmgy8u">Теперь перейдем к инструментам! Если вы хотите узнать больше об инструментах, не стесняйтесь вернуться к разделу курса <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 class="" 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=""><!-- HTML_TAG_START --><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>)-> <span class="hljs-built_in">str</span>: <span class="hljs-comment"># важно указать возвращаемый тип</span>
	<span class="hljs-comment"># Сохраните этот формат для описания инструмента / описания аргументов, но не стесняйтесь модифицировать инструмент</span>
	<span class="hljs-string">"""Инструмент, который пока ничего не делает
	Аргументы:
	arg1: первый аргумент
	arg2: второй аргумент
	"""</span>
	<span class="hljs-keyword">return</span> <span class="hljs-string">"Какую магию вы будете создавать?"</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>) -> <span class="hljs-built_in">str</span>:
	<span class="hljs-string">"""Инструмент для получения текущего местного времени в указанном часовом поясе.
	Аргменты:
	timezone: Строка, представляющая действительный часовой пояс (например, 'America/New_York').
	"""</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">"%Y-%m-%d %H:%M:%S"</span>)
	<span class="hljs-keyword">return</span> <span class="hljs-string">f"Текущее местное время в <span class="hljs-subst">{timezone}</span> составляет: <span class="hljs-subst">{local_time}</span>"</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"Ошибка получения времени для часового пояса '<span class="hljs-subst">{timezone}</span>': <span class="hljs-subst">{<span class="hljs-built_in">str</span>(e)}</span>"</span><!-- HTML_TAG_END --></pre></div> <p data-svelte-h="svelte-1904qqr">Инструменты - это то, что мы призываем вас создать в этом разделе! Мы приводим два примера:</p> <ol data-svelte-h="svelte-w2qog7"><li><strong>нерабочий фиктивный инструмент</strong>, который вы можете модифицировать, чтобы сделать что-то полезное.</li> <li><strong>действительно работающий инструмент</strong>, который получает текущее время в любой точке мира.</li></ol> <p data-svelte-h="svelte-shhtj2">Чтобы определить свой инструмент, необходимо:</p> <ol data-svelte-h="svelte-fevusz"><li>Предоставить входной и выходной типы для вашей функции, как в <code>get_current_time_in_timezone(timezone: str) -> str:</code></li> <li><strong>Написать хорошо отформатированную строку документации</strong>. <code>smolagents</code> ожидает, что все аргументы будут иметь <strong>текстовое описание в строке документации</strong>.</li></ol> <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 class="" 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 data-svelte-h="svelte-1bwakwg">Он использует <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 class="" 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=""><!-- HTML_TAG_START -->final_answer = FinalAnswerTool()
	model = HfApiModel(
	max_tokens=<span class="hljs-number">2096</span>,
	temperature=<span class="hljs-number">0.5</span>,
	model_id=<span class="hljs-string">'Qwen/Qwen2.5-Coder-32B-Instruct'</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">"prompts.yaml"</span>, <span class="hljs-string">'r'</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()<!-- HTML_TAG_END --></pre></div> <p data-svelte-h="svelte-k0g7ji">Этот агент по-прежнему использует <code>InferenceClient</code>, который мы видели в предыдущем разделе за классом <strong>HfApiModel</strong>!</p> <p data-svelte-h="svelte-15kq4xi">Мы приведем более подробные примеры, когда будем представлять фреймворк в разделе 2. Пока же вам нужно сосредоточиться на <strong>добавлении новых инструментов в список инструментов</strong> с помощью параметра <code>tools</code> вашего Агента.</p> <p data-svelte-h="svelte-1ac67pm">Например, вы можете использовать <code>DuckDuckGoSearchTool</code>, который был импортирован в первой строке кода, или вы можете изучить <code>image_generation_tool</code>, который загружается из Hub позже в коде.</p> <p data-svelte-h="svelte-1cgtb5z"><strong>Добавление инструментов даст вашему агенту новые возможности</strong>, попробуйте проявить творческий подход!</p> <p data-svelte-h="svelte-1ads84">Полная версия “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 class="" 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=""><!-- HTML_TAG_START --><span class="hljs-keyword">from</span> smolagents <span class="hljs-keyword">import</span> CodeAgent, DuckDuckGoSearchTool, HfApiModel, 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>)-> <span class="hljs-built_in">str</span>: <span class="hljs-comment"># важно указать возвращаемый тип</span>
	<span class="hljs-comment"># Сохраните этот формат для описания инструмента / описания аргументов, но не стесняйтесь модифицировать инструмент</span>
	<span class="hljs-string">"""Инструмент, который пока ничего не делает
	Аргументы:
	arg1: первый аргумент
	arg2: второй аргумент
	"""</span>
	<span class="hljs-keyword">return</span> <span class="hljs-string">"Какую магию вы будете создавать?"</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>) -> <span class="hljs-built_in">str</span>:
	<span class="hljs-string">"""Инструмент для получения текущего местного времени в указанном часовом поясе.
	Аргменты:
	timezone: Строка, представляющая действительный часовой пояс (например, 'America/New_York').
	"""</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">"%Y-%m-%d %H:%M:%S"</span>)
	<span class="hljs-keyword">return</span> <span class="hljs-string">f"Текущее местное время в <span class="hljs-subst">{timezone}</span> составляет: <span class="hljs-subst">{local_time}</span>"</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"Ошибка получения времени для часового пояса '<span class="hljs-subst">{timezone}</span>': <span class="hljs-subst">{<span class="hljs-built_in">str</span>(e)}</span>"</span>


	final_answer = FinalAnswerTool()
	model = HfApiModel(
	max_tokens=<span class="hljs-number">2096</span>,
	temperature=<span class="hljs-number">0.5</span>,
	model_id=<span class="hljs-string">'Qwen/Qwen2.5-Coder-32B-Instruct'</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">"agents-course/text-to-image"</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">"prompts.yaml"</span>, <span class="hljs-string">'r'</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()<!-- HTML_TAG_END --></pre></div> <p data-svelte-h="svelte-6hqmll">Ваша <strong>Цель</strong> - познакомиться с Пространством и Агентом.</p> <p data-svelte-h="svelte-ueil6z">В настоящее время агент в шаблоне <strong>не использует никаких инструментов, поэтому постарайтесь снабдить его некоторыми из готовых инструментов или даже сделать новые инструменты самостоятельно!</strong>.</p> <p data-svelte-h="svelte-1ket0yy">Мы с нетерпением ждем ваших потрясающих выводов агентов в канале discord <strong>#agents-course-showcase</strong>!</p> <hr> <p data-svelte-h="svelte-10851b7">Поздравляем, вы создали своего первого агента! Не стесняйтесь поделиться им со своими друзьями и коллегами.</p> <p data-svelte-h="svelte-172vnxc">Поскольку это ваша первая попытка, совершенно нормально, если он будет немного глючным или медленным. В следующих разделах мы узнаем, как создавать еще более совершенных агентов.</p> <p data-svelte-h="svelte-bubc2z">Лучший способ научиться - это попробовать, поэтому не стесняйтесь обновлять его, добавлять новые инструменты, пробовать с другой моделью и т. д.</p> <p data-svelte-h="svelte-u6mr6m">В следующем разделе вы пройдете финальный тест и получите сертификат!</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"><span data-svelte-h="svelte-1kd6by1"><</span> <span data-svelte-h="svelte-x0xyl0">></span> <span data-svelte-h="svelte-1dajgef"><span class="underline ml-1.5">Update</span> on GitHub</span></a> <p></p>

	<script>
	{
	__sveltekit_1da6bh2 = {
	assets: "/docs/agents-course/pr_421/ru-RU",
	base: "/docs/agents-course/pr_421/ru-RU",
	env: {}
	};

	const element = document.currentScript.parentElement;

	const data = [null,null];

	Promise.all([
	import("/docs/agents-course/pr_421/ru-RU/_app/immutable/entry/start.0c7aa981.js"),
	import("/docs/agents-course/pr_421/ru-RU/_app/immutable/entry/app.3d01f465.js")
	]).then(([kit, app]) => {
	kit.start(app, element, {
	node_ids: [0, 25],
	data,
	form: null,
	error: null
	});
	});
	}
	</script>

Xet Storage Details

Size:: 36.2 kB
Xet hash:: ed4d24961df54091ea1ee1a7f3dcd589f6b7860234e8b60f6e6a6a89e973712e

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