{"id":479403,"date":"2026-05-12T08:15:30","date_gmt":"2026-05-12T08:15:30","guid":{"rendered":"https:\/\/savepearlharbor.com\/?p=479403"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=479403","title":{"rendered":"\u041a\u0430\u043a \u043c\u044b \u043d\u0430\u0443\u0447\u0438\u043b\u0438 AG2 \u0434\u0440\u0443\u0436\u0438\u0442\u044c \u0441 \u043d\u043e\u0440\u043c\u0430\u043b\u044c\u043d\u044b\u043c DI (\u0438 \u043f\u043e\u0447\u0435\u043c\u0443 \u044d\u0442\u043e \u0432\u043e\u043e\u0431\u0449\u0435 \u043d\u0443\u0436\u043d\u043e)"},"content":{"rendered":"<div xmlns=\"http:\/\/www.w3.org\/1999\/xhtml\">\n<p>C\u0438\u0442\u0443\u0430\u0446\u0438\u044f: \u0443 \u0432\u0430\u0441 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u0434\u0430\u0432\u043d\u043e \u0436\u0438\u0432\u0451\u0442 <strong>Dishka<\/strong>. \u041a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u043d\u0430\u0441\u0442\u0440\u043e\u0435\u043d, \u043f\u0443\u043b\u044b, \u0444\u0430\u0431\u0440\u0438\u043a\u0438 UoW. \u0418 \u0442\u0443\u0442 \u0432\u044b \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442\u0435 LLM-\u0430\u0433\u0435\u043d\u0442\u0430 (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u043d\u0430 <a href=\"https:\/\/github.com\/ag2ai\/ag2\" rel=\"noopener noreferrer nofollow\"><strong>AG2<\/strong><\/a>). \u0410 \u043e\u043d \u0442\u0430\u043a\u043e\u0439: <\/p>\n<blockquote>\n<p>\u00ab\u0421\u043f\u0430\u0441\u0438\u0431\u043e, \u0434\u0435\u0440\u0436\u0438 <code>dependencies={'session': session, 'repo': repo}<\/code> \u0438 \u043c\u043e\u044e \u0441\u043e\u0431\u0441\u0442\u0432\u0435\u043d\u043d\u0443\u044e DI-\u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0443. \u041d\u0435 \u0431\u043b\u0430\u0433\u043e\u0434\u0430\u0440\u0438\u00bb.<\/p>\n<\/blockquote>\n<p>\u0422\u043e \u0435\u0441\u0442\u044c \u0442\u0435\u043f\u0435\u0440\u044c \u0443 \u0432\u0430\u0441 <strong>\u0434\u0432\u0430 \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u044b\u0445 DI-\u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0430<\/strong>: \u043e\u0434\u0438\u043d \u0434\u043b\u044f HTTP-\u0440\u043e\u0443\u0442\u043e\u0432, \u0432\u0442\u043e\u0440\u043e\u0439 \u2014 \u0434\u043b\u044f \u0442\u0443\u043b\u0437 \u0430\u0433\u0435\u043d\u0442\u0430. \u041e\u0434\u0438\u043d \u0438 \u0442\u043e\u0442 \u0436\u0435 \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0439 \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442\u0441\u044f \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0434\u0432\u0430\u0436\u0434\u044b. <br \/>\u041d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \/chat-\u0440\u043e\u0443\u0442 \u2014 \u0440\u0443\u043a\u0430\u043c\u0438 \u0441\u043e\u0431\u0438\u0440\u0430\u0442\u044c \u0441\u043b\u043e\u0432\u0430\u0440\u044c \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439 \u0438 \u043f\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u0442\u044c \u0435\u0433\u043e \u0432 <code>agent.ask(dependencies={...})<\/code>. \u0418 \u0432\u0441\u0451 \u044d\u0442\u043e \u2014 \u0440\u044f\u0434\u043e\u043c \u0441 \u0443\u0436\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u043c Dishka-\u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u043e\u043c, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0440\u043e\u0432\u043d\u043e \u044d\u0442\u0443 \u0440\u0430\u0431\u043e\u0442\u0443 \u0434\u0435\u043b\u0430\u0442\u044c \u0443\u043c\u0435\u0435\u0442.<\/p>\n<p>\u042d\u0442\u0430 \u0441\u0442\u0430\u0442\u044c\u044f \u2014 \u043f\u0440\u043e \u0442\u043e, \u043a\u0430\u043a \u044d\u0442\u043e\u0433\u043e \u0431\u043e\u043b\u044c\u0448\u0435 \u043d\u0435 \u0434\u0435\u043b\u0430\u0442\u044c. \u0412\u043d\u0443\u0442\u0440\u0438:<\/p>\n<ul>\n<li>\n<p>\u0437\u0430\u0447\u0435\u043c \u0430\u0433\u0435\u043d\u0442\u0443 \u0432\u043e\u043e\u0431\u0449\u0435 \u043d\u0443\u0436\u0435\u043d \u043f\u043e\u043b\u043d\u043e\u0446\u0435\u043d\u043d\u044b\u0439 DI \u0438 \u043f\u043e\u0447\u0435\u043c\u0443 AG2 \u043f\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0441\u043e \u0432\u0441\u0442\u0440\u043e\u0435\u043d\u043d\u044b\u043c <a href=\"https:\/\/github.com\/Lancetnik\/FastDepends\" rel=\"noopener noreferrer nofollow\"><code>fast-depends<\/code><\/a>;<\/p>\n<\/li>\n<li>\n<p>\u043f\u0430\u043a\u0435\u0442 <a href=\"https:\/\/github.com\/C3EQUALZz\/dishka-ag2\" rel=\"noopener noreferrer nofollow\"><code>dishka-ag2<\/code><\/a>\u2014 \u043c\u043e\u0441\u0442 \u043c\u0435\u0436\u0434\u0443 AG2 \u0438 Dishka, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0434\u0432\u0430 \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0430 \u0432 \u043e\u0434\u0438\u043d;<\/p>\n<\/li>\n<li>\n<p>\u0440\u0430\u0431\u043e\u0447\u0438\u0439 \u043f\u0440\u0438\u043c\u0435\u0440, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u044f \u0441\u043e\u0431\u0440\u0430\u043b: FastAPI + AG2-\u0430\u0433\u0435\u043d\u0442 \u0441\u043e SSE-\u0441\u0442\u0440\u0438\u043c\u043e\u043c, \u0442\u0443\u043b\u0437\u044b \u0445\u043e\u0434\u044f\u0442 \u0432 Postgres \u0447\u0435\u0440\u0435\u0437 \u0442\u0438\u043f\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 DI;<\/p>\n<\/li>\n<li>\n<p>\u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u043e\u043d\u043d\u0430\u044f \u0441\u0435\u043c\u0430\u043d\u0442\u0438\u043a\u0430 tool calls \u2014 \u0447\u0442\u043e \u043f\u0440\u043e\u0438\u0441\u0445\u043e\u0434\u0438\u0442, \u043a\u043e\u0433\u0434\u0430 \u043c\u043e\u0434\u0435\u043b\u044c \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442 \u0442\u0440\u0438 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u0430 \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u043e \u0438 \u043e\u0434\u0438\u043d \u0438\u0437 \u043d\u0438\u0445 \u043f\u0430\u0434\u0430\u0435\u0442.<\/p>\n<\/li>\n<\/ul>\n<p><strong>\u041f\u043e\u043b\u043d\u044b\u0439 \u043a\u043e\u0434 \u043f\u0440\u0438\u043c\u0435\u0440\u0430:<\/strong> <a href=\"https:\/\/github.com\/vvlrff\/ag2_ag-ui_example\" rel=\"noopener noreferrer nofollow\">github.com\/vvlrff\/ag2_ag-ui_example<\/a> \u2014 \u0441\u043e \u0432\u0441\u0435\u043c\u0438 \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u044f\u043c\u0438, Docker-\u0441\u0431\u043e\u0440\u043a\u043e\u0439 \u0438 \u0442\u0435\u0441\u0442\u0430\u043c\u0438.<\/p>\n<h2>\u041f\u0440\u043e\u0431\u043b\u0435\u043c\u0430: \u043f\u043e\u0447\u0435\u043c\u0443 dependencies={&#8230;} \u2014 \u044d\u0442\u043e \u0431\u043e\u043b\u044c<\/h2>\n<p>AG2 \u043f\u0440\u0435\u0434\u043b\u0430\u0433\u0430\u0435\u0442 \u043f\u0440\u043e\u043a\u0438\u0434\u044b\u0432\u0430\u0442\u044c \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u0432 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b \u0447\u0435\u0440\u0435\u0437 \u0441\u043b\u043e\u0432\u0430\u0440\u044c \u2014 \u043b\u0438\u0431\u043e \u043d\u0430 \u0443\u0440\u043e\u0432\u043d\u0435 \u0430\u0433\u0435\u043d\u0442\u0430, \u043b\u0438\u0431\u043e \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u043f\u0440\u043e\u0433\u043e\u043d:<\/p>\n<pre><code class=\"python\"># \u043d\u0430 \u0443\u0440\u043e\u0432\u043d\u0435 \u0430\u0433\u0435\u043d\u0442\u0430 (\u0436\u0438\u0432\u0451\u0442 \u0432\u0441\u044e \u0436\u0438\u0437\u043d\u044c \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f)agent = Agent(    tools=[my_tool],    dependencies={\"static_dep\": something},)# \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u043f\u0440\u043e\u0433\u043e\u043d \u2014 \u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u0430\u044f \u0441\u0435\u0441\u0441\u0438\u044f \u043b\u0435\u0442\u0438\u0442 \u0441\u044e\u0434\u0430await agent.ask(\"...\", dependencies={\"db_session\": session, \"repo\": repo})<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:87px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0414\u043e\u0441\u0442\u0430\u0451\u0448\u044c \u0432 \u0442\u0443\u043b\u0437\u0435 \u0447\u0435\u0440\u0435\u0437 <code>fast-depends<\/code>-\u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u044e \u2014 \u0442\u0438\u043f\u0438\u0437\u0430\u0446\u0438\u044f \u043d\u0430 \u043c\u0435\u0441\u0442\u0435:<\/p>\n<pre><code class=\"python\">@toolasync def my_tool(session: Annotated[AsyncSession, Inject()]) -&gt; ...:    ...<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u042d\u0442\u043e <strong>\u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442<\/strong>. \u0418 \u0434\u043e \u043a\u0430\u043a\u043e\u0433\u043e-\u0442\u043e \u043c\u043e\u043c\u0435\u043d\u0442\u0430 \u044d\u0442\u043e\u0433\u043e \u0445\u0432\u0430\u0442\u0430\u0435\u0442. \u0427\u0442\u043e \u043d\u0435 \u0442\u0430\u043a \u043d\u0430\u0447\u0438\u043d\u0430\u0435\u0442\u0441\u044f \u0434\u0430\u043b\u044c\u0448\u0435:<\/p>\n<ol>\n<li>\n<p><strong>\u0414\u0443\u0431\u043b\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 DI.<\/strong> \u0415\u0441\u043b\u0438 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u0443\u0436\u0435 \u0435\u0441\u0442\u044c Dishka \u2014 \u0443 \u0432\u0430\u0441 \u0434\u0432\u0430 \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0430. \u041e\u0434\u0438\u043d \u0438 \u0442\u043e\u0442 \u0436\u0435 <code>CreateNoteUseCase<\/code> \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0432 Dishka (\u0434\u043b\u044f HTTP-\u0440\u043e\u0443\u0442\u043e\u0432) \u0438 \u0433\u0434\u0435-\u0442\u043e \u0440\u044f\u0434\u043e\u043c \u0441\u043e\u0431\u0438\u0440\u0430\u0435\u0442\u0441\u044f \u0440\u0443\u043a\u0430\u043c\u0438 \u0434\u043b\u044f <code>dependencies={...}<\/code>. \u0414\u0432\u0435 \u043f\u043e\u043b\u0438\u0442\u0438\u043a\u0438 \u0436\u0438\u0437\u043d\u0435\u043d\u043d\u044b\u0445 \u0446\u0438\u043a\u043b\u043e\u0432. \u041b\u044e\u0431\u0430\u044f \u043f\u0440\u0430\u0432\u043a\u0430 \u0432 \u0434\u0435\u0440\u0435\u0432\u0435 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439 \u2014 \u0432 \u0434\u0432\u0443\u0445 \u043c\u0435\u0441\u0442\u0430\u0445.<\/p>\n<\/li>\n<li>\n<p><strong>\u0420\u0443\u0447\u043d\u0430\u044f \u0441\u0431\u043e\u0440\u043a\u0430 \u0441\u043b\u043e\u0432\u0430\u0440\u044f \u0432 \u043a\u0430\u0436\u0434\u043e\u043c \/chat-\u0440\u043e\u0443\u0442\u0435.<\/strong> \u041d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u0437\u0430\u043f\u0440\u043e\u0441 \u0432\u044b \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0435 Dishka REQUEST, \u0434\u043e\u0441\u0442\u0430\u0451\u0442\u0435 \u043e\u0442\u0442\u0443\u0434\u0430 \u0441\u0435\u0441\u0441\u0438\u044e, \u0440\u0435\u043f\u043e, \u043d\u0443\u0436\u043d\u044b\u0435 \u0441\u0435\u0440\u0432\u0438\u0441\u044b, \u0441\u043a\u043b\u0430\u0434\u044b\u0432\u0430\u0435\u0442\u0435 \u0432 <code>dict<\/code> \u0438 \u043f\u0435\u0440\u0435\u0434\u0430\u0451\u0442\u0435 \u0432 <code>agent.ask(dependencies=...)<\/code>. \u042d\u0442\u043e \u0440\u043e\u0432\u043d\u043e \u0442\u0430 \u043f\u043b\u0443\u043c\u0431\u0438\u043d\u0433-\u0440\u0430\u0431\u043e\u0442\u0430, \u043a\u043e\u0442\u043e\u0440\u0443\u044e DI-\u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u0434\u043e\u043b\u0436\u0435\u043d \u0434\u0435\u043b\u0430\u0442\u044c \u0441\u0430\u043c.<\/p>\n<\/li>\n<li>\n<p><strong>\u041a\u0430\u0436\u0434\u043e\u0435 \u043d\u043e\u0432\u043e\u0435 \u0442\u0440\u0435\u0431\u043e\u0432\u0430\u043d\u0438\u0435<\/strong> (\u043b\u043e\u0433\u0433\u0435\u0440, \u043a\u0435\u0448, http-\u043a\u043b\u0438\u0435\u043d\u0442) \u0434\u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0432 \u044d\u0442\u043e\u0442 \u0436\u0435 \u0441\u043b\u043e\u0432\u0430\u0440\u044c. \u0427\u0435\u0440\u0435\u0437 \u043f\u043e\u043b\u0433\u043e\u0434\u0430 \u0443 \u0432\u0430\u0441 \u0442\u0430\u043c 15 \u043a\u043b\u044e\u0447\u0435\u0439, \u0438 \u0447\u0438\u0442\u0430\u0442\u044c \u0441\u0431\u043e\u0440\u043a\u0443 \u044d\u0442\u043e\u0433\u043e \u0441\u043b\u043e\u0432\u0430\u0440\u044f \u2014 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u0435 \u0443\u0434\u043e\u0432\u043e\u043b\u044c\u0441\u0442\u0432\u0438\u0435.<\/p>\n<\/li>\n<li>\n<p><strong>\u0421\u043a\u043e\u0443\u043f \u2014 \u043d\u0430 \u0432\u0435\u0441\u044c \u043f\u0440\u043e\u0433\u043e\u043d, \u0430 \u043d\u0435 \u043d\u0430 tool call.<\/strong> \u0421\u0435\u0441\u0441\u0438\u044f, \u043f\u0435\u0440\u0435\u0434\u0430\u043d\u043d\u0430\u044f \u0432 <code>agent.ask<\/code>, \u0436\u0438\u0432\u0451\u0442 \u043f\u043e\u043a\u0430 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043f\u0440\u043e\u0433\u043e\u043d. \u0415\u0441\u043b\u0438 LLM \u0434\u0451\u0440\u0433\u0430\u0435\u0442 \u0442\u0440\u0438 \u0442\u0443\u043b\u0437\u044b \u043f\u043e\u0434\u0440\u044f\u0434 \u2014 \u0432\u0441\u0435 \u0442\u0440\u0438 \u0441\u0438\u0434\u044f\u0442 \u043d\u0430 \u043e\u0434\u043d\u043e\u0439 \u0441\u0435\u0441\u0441\u0438\u0438 \u0438 \u043e\u0434\u043d\u043e\u0439 \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438. \u041d\u0443\u0436\u043d\u043e \u00ab\u043a\u0430\u0436\u0434\u044b\u0439 tool call \u2014 \u0441\u0432\u043e\u044f \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u044f\u00bb? \u0411\u0435\u0437 <code>dishka-ag2<\/code> \u044d\u0442\u043e \u043f\u0440\u0438\u0434\u0451\u0442\u0441\u044f \u043f\u0438\u0441\u0430\u0442\u044c \u0440\u0443\u043a\u0430\u043c\u0438.<\/p>\n<\/li>\n<\/ol>\n<p>\u0416\u0435\u043b\u0430\u0435\u043c\u043e\u0435 API \u2014 \u0442\u0438\u043f\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u0435 \u0432\u043d\u0435\u0434\u0440\u0435\u043d\u0438\u0435, \u043a\u0430\u043a \u0432 FastAPI:<\/p>\n<pre><code class=\"python\">@tool@injectasync def create_note(    title: str,    body: str = \"\",    *,    uc: FromDishka[CreateNoteUseCase],) -&gt; NoteToolResult:    response = await uc.execute(CreateNoteRequest(title=title, body=body))    return NoteToolResult.from_entity(response.note)<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>LLM \u0432 \u0441\u0445\u0435\u043c\u0443 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u0430 \u0432\u0438\u0434\u0438\u0442 \u0442\u043e\u043b\u044c\u043a\u043e <code>title<\/code> \u0438 <code>body<\/code>. \u0421\u0446\u0435\u043d\u0430\u0440\u0438\u0439 \u0432\u043d\u0435\u0434\u0440\u044f\u0435\u0442\u0441\u044f \u0447\u0435\u0440\u0435\u0437 DI \u0438 \u0436\u0438\u0432\u0451\u0442 \u0440\u043e\u0432\u043d\u043e \u0441\u0442\u043e\u043b\u044c\u043a\u043e, \u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0442\u0443\u043b\u0437\u0430. \u041e\u0434\u0438\u043d \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u043d\u0430 \u0432\u0435\u0441\u044c \u043f\u0440\u043e\u0435\u043a\u0442. \u042d\u0442\u043e \u0438 \u0435\u0441\u0442\u044c <code>dishka-ag2<\/code>.<\/p>\n<h2>\u041f\u043e\u0434 \u043a\u0430\u043f\u043e\u0442\u043e\u043c AG2: \u0437\u0430\u0447\u0435\u043c \u0442\u0430\u043c fast-depends<\/h2>\n<p>\u0427\u0442\u043e\u0431\u044b \u043f\u043e\u043d\u044f\u0442\u044c, \u043a\u0430\u043a <code>dishka-ag2<\/code> \u0432\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u0432 AG2, \u043d\u0443\u0436\u043d\u043e \u0437\u043d\u0430\u0442\u044c \u043e\u0434\u043d\u0443 \u0434\u0435\u0442\u0430\u043b\u044c: <strong>\u0432\u043d\u0443\u0442\u0440\u0438 AG2 \u0443\u0436\u0435 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 DI<\/strong> \u2014 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 <code>fast-depends<\/code>, \u0430\u0432\u0442\u043e\u043d\u043e\u043c\u043d\u044b\u0439 \u043c\u0435\u0445\u0430\u043d\u0438\u0437\u043c \u0440\u0430\u0431\u043e\u0442\u044b \u0441  \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u044f\u043c\u0438 \u0432 \u0434\u0443\u0445\u0435 FastAPI <code>Depends<\/code>, \u043d\u043e \u0431\u0435\u0437 \u043f\u0440\u0438\u0432\u044f\u0437\u043a\u0438 \u043a \u0432\u0435\u0431-\u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a\u0443.<\/p>\n<p><code>fast-depends<\/code> \u2014 \u044d\u0442\u043e <strong>\u0438\u043d\u0436\u0435\u043a\u0442\u043e\u0440 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u043e\u0432<\/strong>, \u0430 \u043d\u0435 <strong>\u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440<\/strong>. \u0420\u0430\u0437\u043d\u0438\u0446\u0430 \u043f\u0440\u0438\u043d\u0446\u0438\u043f\u0438\u0430\u043b\u044c\u043d\u0430\u044f: \u043e\u043d \u0443\u043c\u0435\u0435\u0442 \u0440\u0430\u0441\u043f\u043e\u0437\u043d\u0430\u0442\u044c <code>Annotated[T, Inject()]<\/code> \u0432 \u0441\u0438\u0433\u043d\u0430\u0442\u0443\u0440\u0435, \u0434\u0451\u0440\u043d\u0443\u0442\u044c \u0437\u0430\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u043f\u0440\u043e\u0432\u0430\u0439\u0434\u0435\u0440, \u043f\u043e\u0434\u0441\u0442\u0430\u0432\u0438\u0442\u044c \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0432 \u0432\u044b\u0437\u043e\u0432. \u0427\u0435\u0433\u043e \u0443 \u043d\u0435\u0433\u043e \u043d\u0435\u0442 \u2014 \u0438\u0435\u0440\u0430\u0440\u0445\u0438\u0438 \u0441\u043a\u043e\u0443\u043f\u043e\u0432 (APP\/REQUEST\/&#8230;) \u0438 \u043e\u0431\u0449\u0435\u0433\u043e \u0440\u0435\u0435\u0441\u0442\u0440\u0430, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u043f\u0440\u043e\u0432\u0430\u0439\u0434\u0435\u0440\u044b \u043c\u043e\u0433\u0443\u0442 \u0437\u0430\u0432\u0438\u0441\u0435\u0442\u044c \u0434\u0440\u0443\u0433 \u043e\u0442 \u0434\u0440\u0443\u0433\u0430 \u0438 \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c\u0441\u044f \u043c\u0435\u0436\u0434\u0443 \u0440\u0430\u0437\u043d\u044b\u043c\u0438 \u0442\u043e\u0447\u043a\u0430\u043c\u0438 \u0432\u0445\u043e\u0434\u0430.<\/p>\n<p>\u0417\u0430\u043e\u0434\u043d\u043e \u2014 \u0434\u0432\u0430 \u0441\u043b\u043e\u0432\u0430 \u043f\u0440\u043e <strong>AG-UI<\/strong>. \u042d\u0442\u043e <a href=\"https:\/\/github.com\/ag-ui-protocol\/ag-ui\" rel=\"noopener noreferrer nofollow\">SSE-\u043f\u0440\u043e\u0442\u043e\u043a\u043e\u043b<\/a>, \u043a\u043e\u0442\u043e\u0440\u044b\u043c \u0441\u0435\u0440\u0432\u0435\u0440 \u0448\u043b\u0451\u0442 \u043a\u043b\u0438\u0435\u043d\u0442\u0443 \u0441\u043e\u0431\u044b\u0442\u0438\u044f \u0430\u0433\u0435\u043d\u0442\u0430 \u0432 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u043c \u0432\u0440\u0435\u043c\u0435\u043d\u0438:<\/p>\n<div>\n<div class=\"table\">\n<table>\n<tbody>\n<tr>\n<td>\n<p align=\"left\">\u0421\u043e\u0431\u044b\u0442\u0438\u0435<\/p>\n<\/td>\n<td>\n<p align=\"left\">\u041a\u043e\u0433\u0434\u0430<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>RUN_STARTED<\/code> \/ <code>RUN_FINISHED<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0433\u0440\u0430\u043d\u0438\u0446\u044b \u043f\u0440\u043e\u0433\u043e\u043d\u0430<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>RUN_ERROR<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\">\u043f\u0440\u043e\u0433\u043e\u043d \u0443\u043f\u0430\u043b<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>TEXT_MESSAGE_CHUNK<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0441\u0442\u0440\u0438\u043c \u0442\u043e\u043a\u0435\u043d\u043e\u0432 \u043e\u0442 LLM<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>TOOL_CALL_START<\/code> \/ <code>TOOL_CALL_ARGS<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\">LLM \u0440\u0435\u0448\u0438\u043b \u0432\u044b\u0437\u0432\u0430\u0442\u044c \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>TOOL_CALL_RESULT<\/code> \/ <code>TOOL_CALL_END<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \/ \u0437\u0430\u0432\u0435\u0440\u0448\u0435\u043d\u0438\u0435 \u0432\u044b\u0437\u043e\u0432\u0430<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n<blockquote>\n<p><code>autogen.beta.ag_ui.AGUIStream<\/code> \u2014 \u043e\u0431\u0451\u0440\u0442\u043a\u0430, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u0431\u0435\u0440\u0451\u0442 \u0432\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u0438\u0435 \u0441\u043e\u0431\u044b\u0442\u0438\u044f \u0430\u0433\u0435\u043d\u0442\u0430 \u0438 \u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0443\u0435\u0442 \u0438\u0445 \u0432 SSE-\u0444\u0440\u0435\u0439\u043c\u044b. AG-UI \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442 AG2, LangGraph, Pydantic AI, LlamaIndex, CrewAI \u0438 \u0442.\u0434. \u2014 \u0442\u0430\u043a \u0447\u0442\u043e \u0441\u0430\u043c \u043f\u043e \u0441\u0435\u0431\u0435 \u043e\u043d \u0434\u0430\u0432\u043d\u043e \u043d\u0435 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442 \u00ab\u0437\u0430\u00bb \u043a\u0430\u043a\u043e\u0439-\u0442\u043e \u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a. \u0410\u0440\u0433\u0443\u043c\u0435\u043d\u0442 \u0437\u0434\u0435\u0441\u044c \u2014 \u0441\u0432\u044f\u0437\u043a\u0430 <code>AG2.beta + dishka-ag2<\/code>.<\/p>\n<\/blockquote>\n<h2>\u041f\u0430\u043a\u0435\u0442 dishka-ag2: \u0442\u0440\u0438 \u043a\u0438\u0440\u043f\u0438\u0447\u0438\u043a\u0430<\/h2>\n<p><strong>1. <\/strong><code><strong>AG2Scope<\/strong><\/code><strong> \u2014 \u0438\u0435\u0440\u0430\u0440\u0445\u0438\u044f \u0441\u043a\u043e\u0443\u043f\u043e\u0432<\/strong><\/p>\n<p>\u0421\u0435\u043c\u044c \u0443\u0440\u043e\u0432\u043d\u0435\u0439, \u043d\u043e \u0440\u0435\u0430\u043b\u044c\u043d\u043e \u0432\u0430\u043c \u043d\u0443\u0436\u043d\u044b \u0434\u0432\u0430:<\/p>\n<ul>\n<li>\n<p><code><strong>AG2Scope.APP<\/strong><\/code> \u2014 \u0441\u0438\u043d\u0433\u043b\u0442\u043e\u043d\u044b \u043d\u0430 \u0436\u0438\u0437\u043d\u044c \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f: engine SQLAlchemy, sessionmaker, \u043a\u043e\u043d\u0444\u0438\u0433, <code>OpenAIConfig<\/code>.<\/p>\n<\/li>\n<li>\n<p><code><strong>AG2Scope.REQUEST<\/strong><\/code> \u2014 \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 HTTP-\u0437\u0430\u043f\u0440\u043e\u0441 (\u0447\u0435\u0440\u0435\u0437 ASGI-middleware) <strong>\u0438 \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 tool call<\/strong> (\u0434\u0435\u043a\u043e\u0440\u0430\u0442\u043e\u0440\u043e\u043c <code>@inject<\/code>). \u0412\u043d\u0443\u0442\u0440\u0438 \u0436\u0438\u0432\u0443\u0442 \u0441\u0435\u0441\u0441\u0438\u044f \u0411\u0414, \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438, \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0438.<\/p>\n<\/li>\n<\/ul>\n<p><strong>2. <\/strong><code><strong>DishkaAsyncMiddleware<\/strong><\/code><strong> \u2014 middleware \u0430\u0433\u0435\u043d\u0442\u0430<\/strong><\/p>\n<p>\u041f\u043e\u0434\u043a\u043b\u044e\u0447\u0430\u0435\u0442\u0441\u044f \u043a <code>Agent<\/code>. \u041f\u0435\u0440\u0435\u0445\u0432\u0430\u0442\u044b\u0432\u0430\u0435\u0442 \u0441\u043e\u0431\u044b\u0442\u0438\u044f \u0430\u0433\u0435\u043d\u0442\u0430 (<code>on_turn<\/code>, <code>on_tool_execution<\/code>, <code>on_llm_call<\/code>) \u0438 <strong>\u0433\u043e\u0442\u043e\u0432\u0438\u0442 \u043a\u043e\u043d\u0442\u0435\u043a\u0441\u0442<\/strong> \u0434\u043b\u044f \u0431\u0443\u0434\u0443\u0449\u0435\u0433\u043e \u043e\u0442\u043a\u0440\u044b\u0442\u0438\u044f \u0441\u043a\u043e\u0443\u043f\u0430. \u0421\u0430\u043c \u0441\u043a\u043e\u0443\u043f <code>REQUEST<\/code> middleware <strong>\u043d\u0435 \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442<\/strong> \u2014 \u0442\u043e\u043b\u044c\u043a\u043e \u0441\u043a\u043b\u0430\u0434\u044b\u0432\u0430\u0435\u0442 \u0442\u0435\u043a\u0443\u0449\u0438\u0439 <code>Context<\/code> \u0438 <code>ToolCallEvent<\/code> \u0432 pending-\u0441\u043b\u043e\u0442.<\/p>\n<p><strong>3. <\/strong><code><strong>@inject<\/strong><\/code><strong> \u2014 \u0434\u0435\u043a\u043e\u0440\u0430\u0442\u043e\u0440 \u0442\u0443\u043b\u0437\u044b<\/strong><\/p>\n<p>\u041a\u043e\u0433\u0434\u0430 AG2 \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442, <code>@inject<\/code>:<\/p>\n<ol>\n<li>\n<p>\u0414\u043e\u0441\u0442\u0430\u0451\u0442 \u043a\u043e\u0440\u043d\u0435\u0432\u043e\u0439 \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u0438\u0437 \u043a\u043e\u043d\u0442\u0435\u043a\u0441\u0442\u0430.<\/p>\n<\/li>\n<li>\n<p>\u041e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442 <code>AG2Scope.REQUEST<\/code> \u0441 \u0434\u0430\u043d\u043d\u044b\u043c\u0438 \u0438\u0437 pending-\u0441\u043b\u043e\u0442\u0430.<\/p>\n<\/li>\n<li>\n<p>\u0420\u0435\u0437\u043e\u043b\u0432\u0438\u0442 \u0432\u0441\u0435 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u044b, \u043f\u043e\u043c\u0435\u0447\u0435\u043d\u043d\u044b\u0435 <code>FromDishka[T]<\/code>.<\/p>\n<\/li>\n<li>\n<p>\u0412\u044b\u0437\u044b\u0432\u0430\u0435\u0442 \u0444\u0443\u043d\u043a\u0446\u0438\u044e.<\/p>\n<\/li>\n<li>\n<p>\u0417\u0430\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u0441\u043a\u043e\u0443\u043f \u043f\u043e\u0441\u043b\u0435 \u0432\u043e\u0437\u0432\u0440\u0430\u0442\u0430 (\u0438\u043b\u0438 \u043f\u043e\u0441\u043b\u0435 \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u044f).<\/p>\n<\/li>\n<\/ol>\n<p>\u0418\u043d\u044b\u043c\u0438 \u0441\u043b\u043e\u0432\u0430\u043c\u0438, <strong>\u0441\u043a\u043e\u0443\u043f \u0436\u0438\u0432\u0451\u0442 \u0440\u043e\u0432\u043d\u043e \u0441\u0442\u043e\u043b\u044c\u043a\u043e, \u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0432\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u0442\u0441\u044f \u0442\u0435\u043b\u043e \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u0430<\/strong>. \u0421\u0435\u0441\u0441\u0438\u044f \u0411\u0414 \u2014 \u0442\u043e\u0436\u0435.<\/p>\n<p>\u041f\u043b\u044e\u0441 \u043a \u044d\u0442\u043e\u043c\u0443 \u043f\u0430\u043a\u0435\u0442 \u0434\u0430\u0451\u0442 <code>AG2Provider<\/code> \u2014 \u043f\u0440\u043e\u0432\u0430\u0439\u0434\u0435\u0440 \u00ab\u0438\u0437 \u043a\u043e\u0440\u043e\u0431\u043a\u0438\u00bb, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0443\u043c\u0435\u0435\u0442 \u043e\u0442\u0434\u0430\u0432\u0430\u0442\u044c <code>ToolCallEvent<\/code>, <code>Context<\/code>, <code>ConversationContainer<\/code> \u0438 \u0442.\u043f. \u0432 \u0432\u0438\u0434\u0435 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439. \u0411\u0435\u0437 \u043d\u0435\u0433\u043e \u0442\u0438\u043f\u044b \u0438\u0437 \u0441\u0430\u043c\u043e\u0433\u043e AG2 \u0432 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442 \u043d\u0435 \u0432\u043d\u0435\u0434\u0440\u044f\u0442\u0441\u044f, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 <code>AG2Provider()<\/code> \u0432 <code>default_providers()<\/code> \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u0435\u043d.<\/p>\n<h2>\u0410\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0430 \u043f\u0440\u0438\u043c\u0435\u0440\u0430<\/h2>\n<p>\u0416\u0438\u0437\u043d\u0435\u043d\u043d\u044b\u0439 \u0446\u0438\u043a\u043b \u0441\u043a\u043e\u0443\u043f\u043e\u0432 \u043d\u0430 \u043e\u0434\u043d\u043e\u043c HTTP-\u0437\u0430\u043f\u0440\u043e\u0441\u0435:<\/p>\n<pre><code>HTTP POST \/api\/chat   \u2502   \u25bc AG2ContainerMiddleware \u2500\u2500 \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442 AG2Scope.REQUEST \u0434\u043b\u044f HTTP   \u2502   \u25bc chat-route \u2500\u2500 \u0431\u0435\u0440\u0451\u0442 agent = app.state.agent (\u0441\u0438\u043d\u0433\u043b\u0442\u043e\u043d)   \u2502   \u25bc AGUIStream(agent).dispatch(run_input)   \u2502      \u0430\u0433\u0435\u043d\u0442 \u0440\u0435\u0448\u0430\u0435\u0442 \u0432\u044b\u0437\u0432\u0430\u0442\u044c \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442   \u25bc   DishkaAsyncMiddleware.on_tool_execution   \u2502      stash_request_context: \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u0435\u0442 Context, ToolCallEvent   \u2502      (\u0441\u043a\u043e\u0443\u043f \u041d\u0415 \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442)   \u25bc   @inject create_note(uc: FromDishka[CreateNoteUseCase])   \u2502      \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442 AG2Scope.REQUEST \u0441\u043e stash-\u0434\u0430\u043d\u043d\u044b\u043c\u0438   \u2502      \u0440\u0435\u0437\u043e\u043b\u0432\u0438\u0442 uc \u0447\u0435\u0440\u0435\u0437 \u0446\u0435\u043f\u043e\u0447\u043a\u0443 DI   \u25bc   CreateNoteUseCase \u2192 AlchemyNoteRepository \u2192 AsyncSession \u2192 Postgres   \u2502   \u25bc \u041f\u043e\u0441\u043b\u0435 \u0432\u043e\u0437\u0432\u0440\u0430\u0442\u0430 @inject \u0437\u0430\u043a\u0440\u044b\u0432\u0430\u0435\u0442 REQUEST-\u0441\u043a\u043e\u0443\u043f   \u2502      (\u0441\u0435\u0441\u0441\u0438\u044f \u0411\u0414 \u043e\u0442\u043f\u0443\u0449\u0435\u043d\u0430 \u043e\u0431\u0440\u0430\u0442\u043d\u043e \u0432 \u043f\u0443\u043b)   \u25bc ToolResultEvent \u2192 AGUIStream \u2192 SSE TOOL_CALL_RESULT<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u043e\u0434\u0438\u043d. \u0421\u043a\u043e\u0443\u043f <code>REQUEST<\/code> \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0434\u0432\u0430\u0436\u0434\u044b \u2014 \u043d\u0430 HTTP-\u0437\u0430\u043f\u0440\u043e\u0441 \u0438 \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 tool call. \u042d\u0442\u043e \u0441\u0434\u0435\u043b\u0430\u043d\u043e \u043d\u0430\u043c\u0435\u0440\u0435\u043d\u043d\u043e: <strong>\u043a\u0430\u0436\u0434\u044b\u0439 tool call \u2014 \u0441\u0432\u043e\u044f \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u044f<\/strong> (\u0441\u043c. \u043d\u0438\u0436\u0435).<\/p>\n<p><strong>\u0421\u0431\u043e\u0440\u043a\u0430 \u0441\u043d\u0438\u0437\u0443 \u0432\u0432\u0435\u0440\u0445 (\u0442\u043e\u043b\u044c\u043a\u043e \u0432\u0430\u0436\u043d\u043e\u0435)<\/strong><\/p>\n<pre><code class=\"python\"># domain\/entities.pyNoteId = NewType(\"NoteId\", UUID)@dataclassclass Note:    id: NoteId    title: str    body: str    created_at: datetime    # gateways\/db\/note\/interface.pyclass NoteRepository(Protocol):    async def create(self, note: Note) -&gt; Note: ...    async def list_notes(self, limit: int = 20) -&gt; list[Note]: ...    async def delete(self, note_id: NoteId) -&gt; bool: ...<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0420\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u043d\u0430 SQLAlchemy 2.0 \u2014 <a href=\"https:\/\/github.com\/vvlrff\/ag2_ag-ui_example\" rel=\"noopener noreferrer nofollow\">\u043f\u043e\u043b\u043d\u044b\u0439 \u043a\u043e\u0434 \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438<\/a>. \u0422\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u044f \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u044f\u0432\u043d\u043e \u043d\u0435 \u0437\u0430\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u2014 \u044d\u0442\u0438\u043c \u0437\u0430\u043d\u0438\u043c\u0430\u0435\u0442\u0441\u044f UoW.<\/p>\n<p><strong>\u0421\u0446\u0435\u043d\u0430\u0440\u0438\u0439 + UnitOfWork<\/strong><\/p>\n<pre><code class=\"elixir\"># usecases\/uow.pyclass UnitOfWork(Protocol):    async def commit(self) -&gt; None: ...    async def rollback(self) -&gt; None: ...    async def flush(self) -&gt; None: ...<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p><code>AsyncSession<\/code> \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u043d\u043e \u0443\u0434\u043e\u0432\u043b\u0435\u0442\u0432\u043e\u0440\u044f\u0435\u0442 \u044d\u0442\u043e\u043c\u0443 \u043f\u0440\u043e\u0442\u043e\u043a\u043e\u043b\u0443 \u2014 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 \u043a\u043b\u0430\u0441\u0441 \u043d\u0435 \u043d\u0443\u0436\u0435\u043d. \u042d\u0442\u043e \u043f\u0440\u0438\u0433\u043e\u0434\u0438\u0442\u0441\u044f \u0447\u0435\u0440\u0435\u0437 \u0448\u0430\u0433.<\/p>\n<pre><code class=\"python\">class CreateNoteUseCase:    def __init__(self, repo: NoteRepository, uow: UnitOfWork) -&gt; None:        self._repo = repo        self._uow = uow    async def execute(self, request: CreateNoteRequest) -&gt; CreateNoteResponse:        note = Note(            id=NoteId(uuid4()),             title=request.title,            body=request.body,             created_at=datetime.now(UTC)        )        created = await self._repo.create(note)        await self._uow.commit()        return CreateNoteResponse(note=created)<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0421\u0446\u0435\u043d\u0430\u0440\u0438\u0439 \u043d\u0435 \u0437\u043d\u0430\u0435\u0442 \u043d\u0438 \u043f\u0440\u043e FastAPI, \u043d\u0438 \u043f\u0440\u043e SQLAlchemy, \u043d\u0438 \u043f\u0440\u043e AG2 \u2014 \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u0432\u0430 \u043f\u0440\u043e\u0442\u043e\u043a\u043e\u043b\u0430. \u0422\u0435\u0441\u0442\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0432 \u043f\u043e\u043b\u043d\u043e\u0439 \u0438\u0437\u043e\u043b\u044f\u0446\u0438\u0438.<\/p>\n<p><strong>DI-\u043f\u0440\u043e\u0432\u0430\u0439\u0434\u0435\u0440 \u0441 \u043e\u0434\u043d\u0438\u043c \u0445\u0438\u0442\u0440\u044b\u043c \u043f\u0440\u0438\u0451\u043c\u043e\u043c<\/strong><\/p>\n<pre><code class=\"python\">class DatabaseProvider(Provider):    @provide(scope=AG2Scope.APP)    async def provide_async_engine(self, settings: Settings) -&gt; AsyncIterator[AsyncEngine]:        engine = create_async_engine(            make_url(settings.database_url),            pool_size=10,            max_overflow=10,            pool_timeout=10,            pool_pre_ping=True,        )        yield engine        await engine.dispose()    @provide(scope=AG2Scope.APP)    def provide_sessionmaker(self, engine: AsyncEngine) -&gt; async_sessionmaker[AsyncSession]:        return async_sessionmaker[AsyncSession](            bind=engine,            autoflush=False,            autocommit=False,            expire_on_commit=False,        )    @provide(scope=AG2Scope.REQUEST)    async def provide_async_session(        self, pool: async_sessionmaker[AsyncSession]    ) -&gt; AsyncIterator[AnyOf[AsyncSession, UnitOfWork]]:  # \u2190 \u043a\u043b\u044e\u0447\u0435\u0432\u0430\u044f \u0441\u0442\u0440\u043e\u0447\u043a\u0430        async with pool() as session:            yield session<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p><code><strong>AnyOf[AsyncSession, UnitOfWork]<\/strong><\/code> \u2014 Dishka \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u0443\u0435\u0442 <strong>\u043e\u0434\u0438\u043d \u0438 \u0442\u043e\u0442 \u0436\u0435 \u043e\u0431\u044a\u0435\u043a\u0442<\/strong> \u043f\u043e\u0434 \u0434\u0432\u0443\u043c\u044f \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u0430\u043c\u0438. \u0420\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u043f\u043e\u043b\u0443\u0447\u0438\u0442 \u0435\u0433\u043e \u043a\u0430\u043a <code>AsyncSession<\/code>, \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0439 \u2014 \u043a\u0430\u043a <code>UnitOfWork<\/code>. \u042d\u0442\u043e <strong>\u043e\u0434\u043d\u0430<\/strong> \u0441\u0435\u0441\u0441\u0438\u044f, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 <code>await uow.commit()<\/code> \u043a\u043e\u043c\u043c\u0438\u0442\u0438\u0442 \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u044e, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0441\u0434\u0435\u043b\u0430\u043b <code>add<\/code> \u0438 <code>flush<\/code>.<\/p>\n<p><strong>\u0421\u0431\u043e\u0440\u043a\u0430 \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0430<\/strong><\/p>\n<pre><code class=\"python\">def default_providers() -&gt; tuple[Provider, ...]:    return (        SettingsProvider(),        DatabaseProvider(),        RepositoryProvider(),        UseCaseProvider(),        AgentProvider(),        AG2Provider(),  # \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u0435\u043d    )def create_container(*providers, context=None) -&gt; AsyncContainer:    return make_async_container(        *providers,        context=context,        scopes=AG2Scope,  # \u043f\u0435\u0440\u0435\u043a\u043b\u044e\u0447\u0430\u0442\u0435\u043b\u044c \u043d\u0430 \u0438\u0435\u0440\u0430\u0440\u0445\u0438\u044e dishka-ag2    )<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p><code>scopes=AG2Scope<\/code> \u0432\u043c\u0435\u0441\u0442\u043e \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u043e\u0439 <code>Scope.{APP,REQUEST,...}<\/code> Dishka \u2014 \u0438\u043d\u0430\u0447\u0435 <code>AG2Scope.REQUEST<\/code> \u043d\u0435 \u043f\u043e\u0434\u0446\u0435\u043f\u0438\u0442\u0441\u044f.<\/p>\n<p><strong>\u0418\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442: <\/strong><code><strong>@tool<\/strong><\/code><\/p>\n<pre><code class=\"python\">from autogen.beta import Toolkit, toolfrom dishka_ag2 import FromDishka, inject@tool@injectasync def create_note(    uc: FromDishka[CreateNoteUseCase],    title: Annotated[str, Field(description=\"Short title of the note.\")],    body: Annotated[str, Field(description=\"Full text body (optional).\")] = \"\",) -&gt; dict[str, str]:    \"\"\"Create a new note in the database.\"\"\"    response = await uc.execute(CreateNoteRequest(title=title, body=body))    return NoteToolResult.from_entity(response.note)<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0422\u0440\u0438 \u0434\u0435\u0442\u0430\u043b\u0438, \u043d\u0430 \u043a\u043e\u0442\u043e\u0440\u044b\u0445 \u043b\u0435\u0433\u043a\u043e \u0441\u043f\u043e\u0442\u043a\u043d\u0443\u0442\u044c\u0441\u044f:<\/p>\n<ul>\n<li>\n<p><strong>\u041f\u043e\u0440\u044f\u0434\u043e\u043a \u0434\u0435\u043a\u043e\u0440\u0430\u0442\u043e\u0440\u043e\u0432: \u0441\u043d\u0430\u0447\u0430\u043b\u0430 <\/strong><code><strong>@tool<\/strong><\/code><strong>, \u043f\u043e\u0442\u043e\u043c <\/strong><code><strong>@inject<\/strong><\/code><strong>.<\/strong> <\/p>\n<\/li>\n<\/ul>\n<blockquote>\n<p><code>@inject<\/code> \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u0442 \u0444\u0443\u043d\u043a\u0446\u0438\u044e \u0438 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0444\u0443\u043d\u043a\u0446\u0438\u044e. <code>@tool<\/code> \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u0442 \u0444\u0443\u043d\u043a\u0446\u0438\u044e \u0438 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 <strong>\u043e\u0431\u044a\u0435\u043a\u0442 <\/strong><code><strong>FunctionTool<\/strong><\/code> \u2014 \u0438\u043c\u0435\u043d\u043d\u043e \u0435\u0433\u043e \u0436\u0434\u0451\u0442 <code>Agent(tools=[...])<\/code>. \u0412 \u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u043e\u043c \u043f\u043e\u0440\u044f\u0434\u043a\u0435 <code>@inject<\/code> \u0441\u0440\u0430\u0431\u0430\u0442\u044b\u0432\u0430\u0435\u0442 \u043f\u0435\u0440\u0432\u044b\u043c (\u0432\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u0438\u0439), \u043f\u043e\u0442\u043e\u043c <code>@tool<\/code> \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0432 <code>FunctionTool<\/code>. \u0415\u0441\u043b\u0438 \u043f\u043e\u043c\u0435\u043d\u044f\u0442\u044c \u043c\u0435\u0441\u0442\u0430\u043c\u0438 \u2014 <code>@tool<\/code> \u0441\u043d\u0430\u0447\u0430\u043b\u0430 \u0432\u0435\u0440\u043d\u0451\u0442 <code>FunctionTool<\/code>, <code>@inject<\/code> \u043e\u0431\u0435\u0440\u043d\u0451\u0442 \u0435\u0433\u043e \u043a\u0430\u043a \u043e\u0431\u044b\u0447\u043d\u044b\u0439 callable, \u0438 AG2 \u0442\u0430\u043a\u043e\u0439 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u043a\u0430\u043a \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442 \u043d\u0435 \u043f\u0440\u0438\u043c\u0435\u0442.<\/p>\n<\/blockquote>\n<ul>\n<li>\n<p><code><strong>FromDishka[...]<\/strong><\/code><strong> \u0441\u043a\u0440\u044b\u0442 \u043e\u0442 LLM.<\/strong> <\/p>\n<\/li>\n<\/ul>\n<blockquote>\n<p>\u0412\u043d\u0443\u0442\u0440\u0438 AG2 \u0434\u043b\u044f \u0441\u0431\u043e\u0440\u043a\u0438 JSON Schema \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u0430 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u043c\u0435\u0445\u0430\u043d\u0438\u0437\u043c <code>fast-depends<\/code>, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0443\u043c\u0435\u0435\u0442 \u043e\u0442\u043b\u0438\u0447\u0430\u0442\u044c \u00ab\u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438\u00bb \u043e\u0442 \u00ab\u0431\u0438\u0437\u043d\u0435\u0441\u043e\u0432\u044b\u0445 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u043e\u0432\u00bb. <code>@inject<\/code> \u043f\u043e\u043c\u0435\u0447\u0430\u0435\u0442 <code>FromDishka[T]<\/code> \u043a\u0430\u043a \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u044c \u2014 \u0432 \u0441\u0445\u0435\u043c\u0443 \u043e\u043d\u0430 \u043d\u0435 \u043f\u043e\u043f\u0430\u0434\u0430\u0435\u0442. LLM \u0432\u0438\u0434\u0438\u0442 \u0442\u043e\u043b\u044c\u043a\u043e <code>title<\/code> \u0438 <code>body<\/code>.<\/p>\n<\/blockquote>\n<ul>\n<li>\n<p><strong>Docstring \u0438 \u0442\u0438\u043f\u044b \u2014 \u044d\u0442\u043e \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u0430 \u0434\u043b\u044f LLM.<\/strong> <\/p>\n<\/li>\n<\/ul>\n<blockquote>\n<p>\u0422\u043e, \u0447\u0442\u043e \u0432 <code>Args:<\/code>, \u043f\u043e\u043f\u0430\u0434\u0430\u0435\u0442 \u0432 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u043e\u0432. \u0427\u0435\u043c \u0442\u043e\u0447\u043d\u0435\u0435 \u0444\u043e\u0440\u043c\u0443\u043b\u0438\u0440\u043e\u0432\u043a\u0430 \u2014 \u0442\u0435\u043c \u0447\u0430\u0449\u0435 \u043c\u043e\u0434\u0435\u043b\u044c \u043f\u043e\u043f\u0430\u0434\u0430\u0435\u0442 \u0432 \u043d\u0443\u0436\u043d\u044b\u0439 \u043d\u0430\u0431\u043e\u0440 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u043e\u0432.<\/p>\n<\/blockquote>\n<p><strong>\u0421\u0431\u043e\u0440\u043a\u0430 \u0430\u0433\u0435\u043d\u0442\u0430<\/strong><\/p>\n<pre><code class=\"python\">def build_agent(config: OpenAIConfig, container: AsyncContainer) -&gt; Agent:    return Agent(        name=\"example_assistant\",        prompt=SYSTEM_PROMPT,        config=config,        tools=[weather, notes_toolkit()],        middleware=[Middleware(DishkaAsyncMiddleware, container=container)],    )<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0410\u0433\u0435\u043d\u0442 \u043a\u043e\u043d\u0441\u0442\u0440\u0443\u0438\u0440\u0443\u0435\u0442\u0441\u044f <strong>\u043e\u0434\u0438\u043d \u0440\u0430\u0437<\/strong> \u043f\u0440\u0438 \u0441\u0442\u0430\u0440\u0442\u0435 \u0438 \u043a\u043b\u0430\u0434\u0451\u0442\u0441\u044f \u0432 <code>app.state.agent<\/code>. \u041d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 HTTP-\u0437\u0430\u043f\u0440\u043e\u0441 \u0435\u0433\u043e \u043d\u0435 \u043f\u0435\u0440\u0435\u0441\u043e\u0431\u0438\u0440\u0430\u0442\u044c. \u042d\u0442\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442, \u043f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e <code>REQUEST<\/code>-\u0441\u043a\u043e\u0443\u043f \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 tool call \u0434\u0435\u043a\u043e\u0440\u0430\u0442\u043e\u0440\u043e\u043c <code>@inject<\/code>, \u0430 \u043d\u0435 \u0430\u0433\u0435\u043d\u0442\u043e\u043c.<\/p>\n<p><strong>ASGI-middleware \u0434\u043b\u044f REST-\u0440\u043e\u0443\u0442\u043e\u0432<\/strong><\/p>\n<p>\u0421\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u0430\u044f FastAPI-\u0438\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u044f Dishka \u043d\u0435 \u043f\u043e\u0434\u0445\u043e\u0434\u0438\u0442 \u0438\u0437 \u043a\u043e\u0440\u043e\u0431\u043a\u0438 \u2014 \u0435\u0451 \u0445\u0443\u043a \u043d\u0430 <code>Scope.REQUEST<\/code> \u0440\u0430\u0441\u0441\u0447\u0438\u0442\u0430\u043d \u043d\u0430 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u0443\u044e \u0438\u0435\u0440\u0430\u0440\u0445\u0438\u044e, \u0430 \u0443 \u043d\u0430\u0441 \u0441\u0432\u043e\u044f. \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u043f\u0438\u0448\u0435\u043c ASGI-middleware \u043d\u0430 12 \u0441\u0442\u0440\u043e\u043a:<\/p>\n<pre><code class=\"python\">class AG2ContainerMiddleware:    def __init__(self, app: ASGIApp, container: AsyncContainer) -&gt; None:        self.app = app        self.container = container    async def __call__(self, scope, receive, send) -&gt; None:        if scope[\"type\"] != \"http\":            await self.app(scope, receive, send)            return        request = Request(scope, receive, send)        async with self.container(            context={Request: request}, scope=AG2Scope.REQUEST,        ) as request_container:            request.state.dishka_container = request_container            await self.app(scope, receive, send)<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0418 \u044d\u043d\u0434\u043f\u043e\u0438\u043d\u0442 <code>\/api\/chat<\/code> \u0431\u0435\u0437 \u0435\u0434\u0438\u043d\u043e\u0433\u043e \u0443\u043f\u043e\u043c\u0438\u043d\u0430\u043d\u0438\u044f \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0430:<\/p>\n<pre><code class=\"python\">@router.post(\"\")async def run_agent(    run_input: Annotated[RunAgentInput, Body()],    request: Request,    accept: Annotated[str | None, Header()] = None,) -&gt; StreamingResponse:    agent: Agent = request.app.state.agent    stream = AGUIStream(agent)    return StreamingResponse(        stream.dispatch(run_input, accept=accept),        media_type=accept or \"text\/event-stream\",    )<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<h2>\u0422\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u043e\u043d\u043d\u0430\u044f \u0441\u0435\u043c\u0430\u043d\u0442\u0438\u043a\u0430 tool calls<\/h2>\n<p>\u0413\u043b\u0430\u0432\u043d\u0430\u044f \u043c\u044b\u0441\u043b\u044c: <strong>\u043a\u0430\u0436\u0434\u044b\u0439 tool call \u0432\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u0442\u0441\u044f \u0432 \u0441\u043e\u0431\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0439 \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438<\/strong>. \u0418\u0437 \u044d\u0442\u043e\u0433\u043e \u0432\u044b\u0442\u0435\u043a\u0430\u0435\u0442 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0441\u043b\u0435\u0434\u0441\u0442\u0432\u0438\u0439, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0441\u0442\u043e\u0438\u0442 \u043f\u0440\u043e\u0433\u043e\u0432\u043e\u0440\u0438\u0442\u044c \u044f\u0432\u043d\u043e.<\/p>\n<p><strong>\u0412\u0438\u0434\u0438\u043c\u043e\u0441\u0442\u044c \u0434\u0430\u043d\u043d\u044b\u0445 \u043c\u0435\u0436\u0434\u0443 tool calls.<\/strong><\/p>\n<blockquote>\n<p> LLM \u043c\u043e\u0436\u0435\u0442 \u0437\u0430 \u043e\u0434\u0438\u043d \u043f\u0440\u043e\u0433\u043e\u043d \u0432\u044b\u0437\u0432\u0430\u0442\u044c <code>create_note<\/code>, \u043f\u043e\u0442\u043e\u043c <code>list_notes<\/code>. \u042d\u0442\u043e \u0440\u0430\u0437\u043d\u044b\u0435 tool calls \u0441 \u0440\u0430\u0437\u043d\u044b\u043c\u0438 \u0441\u0435\u0441\u0441\u0438\u044f\u043c\u0438. \u041a \u043c\u043e\u043c\u0435\u043d\u0442\u0443, \u043a\u043e\u0433\u0434\u0430 <code>list_notes<\/code> \u043d\u0430\u0447\u043d\u0451\u0442 \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c, \u0435\u0433\u043e \u0441\u0435\u0441\u0441\u0438\u044f \u0432\u0438\u0434\u0438\u0442 <strong>\u0432\u0441\u0451, \u0447\u0442\u043e \u0437\u0430\u043a\u043e\u043c\u043c\u0438\u0442\u0438\u043b\u0430<\/strong> \u0441\u0435\u0441\u0441\u0438\u044f <code>create_note<\/code>. \u041f\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u0435 \u0435\u0441\u0442\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0435 \u0438 \u043f\u0440\u0435\u0434\u0441\u043a\u0430\u0437\u0443\u0435\u043c\u043e\u0435.<\/p>\n<\/blockquote>\n<p><strong>\u041f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u044b\u0435 tool calls.<\/strong> <\/p>\n<blockquote>\n<p>OpenAI \u0438 Anthropic \u043c\u043e\u0433\u0443\u0442 \u0432\u0435\u0440\u043d\u0443\u0442\u044c \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e tool calls \u0432 \u043e\u0434\u043d\u043e\u043c \u043e\u0442\u0432\u0435\u0442\u0435. AG2.beta \u043e\u0442\u0434\u0430\u0451\u0442 \u0438\u0445 \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u043e. \u041a\u0430\u0436\u0434\u044b\u0439 \u2014 \u0432 \u0441\u0432\u043e\u0451\u043c <code>REQUEST<\/code>-\u0441\u043a\u043e\u0443\u043f\u0435, \u0441\u043e \u0441\u0432\u043e\u0435\u0439 \u0441\u0435\u0441\u0441\u0438\u0435\u0439 \u0438\u0437 \u043f\u0443\u043b\u0430. \u041f\u043e\u044d\u0442\u043e\u043c\u0443 <code>pool_size=10, max_overflow=10<\/code> \u2014 \u043d\u0435 \u043d\u0430\u0443\u0433\u0430\u0434: \u044d\u0442\u043e \u0437\u0430\u043f\u0430\u0441 \u043d\u0430 N \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u044b\u0445 \u0442\u0443\u043b\u0437. \u0415\u0441\u043b\u0438 \u0443 \u0432\u0430\u0441 \u0430\u0433\u0435\u043d\u0442\u044b \u043d\u0430 20 \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u044b\u0445 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u043e\u0432 \u2014 \u0443\u0432\u0435\u043b\u0438\u0447\u0438\u0432\u0430\u0439\u0442\u0435 \u043f\u0443\u043b.<\/p>\n<\/blockquote>\n<p><strong>\u0415\u0441\u043b\u0438 \u043e\u0434\u0438\u043d tool call \u0443\u043f\u0430\u043b \u2014 \u043e\u0442\u043a\u0430\u0442\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u0435\u0433\u043e \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u044f.<\/strong> <\/p>\n<blockquote>\n<p>\u0415\u0441\u043b\u0438 <code>create_note<\/code> \u0443\u0436\u0435 \u0437\u0430\u043a\u043e\u043c\u043c\u0438\u0442\u0438\u043b\u0441\u044f, \u0430 <code>delete_external_thing<\/code> \u0443\u043f\u0430\u043b \u2014 \u0437\u0430\u043c\u0435\u0442\u043a\u0430 \u043e\u0441\u0442\u0430\u043d\u0435\u0442\u0441\u044f. \u041e\u0431\u0449\u0435\u0439 \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438 \u043d\u0430 \u0432\u0435\u0441\u044c \u043f\u0440\u043e\u0433\u043e\u043d <strong>\u043d\u0435\u0442<\/strong>.<\/p>\n<\/blockquote>\n<p><strong>\u041e\u0434\u0438\u043d \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0439 \u2014 \u044d\u0442\u043e \u043e\u0434\u0438\u043d UseCase, \u0430 \u043d\u0435 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0442\u0443\u043b\u0437<\/strong><\/p>\n<p>\u042d\u0442\u043e \u0433\u043b\u0430\u0432\u043d\u0430\u044f \u0430\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u043d\u0430\u044f \u043c\u044b\u0441\u043b\u044c \u0441\u0442\u0430\u0442\u044c\u0438. \u041a\u043e\u0433\u0434\u0430 \u0443 \u0431\u0438\u0437\u043d\u0435\u0441-\u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044f \u0435\u0441\u0442\u044c \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u044d\u0444\u0444\u0435\u043a\u0442\u043e\u0432 \u2014 \u0437\u0430\u043f\u0438\u0441\u0430\u0442\u044c \u0432 \u0411\u0414, \u043e\u0442\u043f\u0440\u0430\u0432\u0438\u0442\u044c \u0443\u0432\u0435\u0434\u043e\u043c\u043b\u0435\u043d\u0438\u0435, \u043e\u043f\u0443\u0431\u043b\u0438\u043a\u043e\u0432\u0430\u0442\u044c \u0441\u043e\u0431\u044b\u0442\u0438\u0435 \u0432 \u0431\u0440\u043e\u043a\u0435\u0440 \u2014 <strong>\u0432\u0441\u0451 \u044d\u0442\u043e \u0432\u0445\u043e\u0434\u0438\u0442 \u0432 \u043e\u0434\u0438\u043d \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0439<\/strong>. \u041d\u0435 \u0432 \u0434\u0435\u0441\u044f\u0442\u044c \u0442\u0443\u043b\u0437, \u0438 \u043d\u0435 \u0432 \u043e\u0434\u043d\u0443 \u0442\u0443\u043b\u0437\u0443 \u0441 \u044f\u0432\u043d\u044b\u043c <code>session.begin()<\/code>.<\/p>\n<p>\u0422\u0443\u043b\u0437\u0430 \u043e\u0441\u0442\u0430\u0451\u0442\u0441\u044f \u043e\u0431\u0451\u0440\u0442\u043a\u043e\u0439, \u0432\u0441\u044f \u043e\u0440\u043a\u0435\u0441\u0442\u0440\u0430\u0446\u0438\u044f \u2014 \u0432\u043d\u0443\u0442\u0440\u0438 \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u044f, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440:<\/p>\n<pre><code class=\"python\">class CreateNoteUseCase:    def __init__(        self,         notes: NoteRepository,         events: EventBus,        notifier: NotificationService,         uow: UnitOfWork    ) -&gt; None:        self._notes = notes        self._events = events        self._notifier = notifier        self._uow = uow    async def execute(self, request: CreateNoteRequest) -&gt; CreateNoteResponse:        try:            note = await self._notes.create(Note(...))            await self._events.publish(NoteCreated(note_id=note.id))            await self._notifier.send(...)            await self._uow.commit()            return CreateNoteResponse(note=note)        except Exception:            await self._uow.rollback()            raise<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p><code>raise<\/code> \u0432 \u043a\u043e\u043d\u0446\u0435 \u2014 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u0439. \u0415\u0441\u043b\u0438 \u00ab\u0441\u044a\u0435\u0441\u0442\u044c\u00bb \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435, \u043c\u043e\u0434\u0435\u043b\u044c \u0440\u0435\u0448\u0438\u0442, \u0447\u0442\u043e \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u044f \u043f\u0440\u043e\u0448\u043b\u0430, \u0438 \u043f\u043e\u0439\u0434\u0451\u0442 \u0434\u0430\u043b\u044c\u0448\u0435 \u0441 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u043c \u0441\u043e\u0441\u0442\u043e\u044f\u043d\u0438\u0435\u043c.<\/p>\n<p><strong>\u0410\u043d\u0442\u0438\u043f\u0430\u0442\u0442\u0435\u0440\u043d, \u0447\u0442\u043e\u0431\u044b \u0431\u044b\u043b\u043e \u043d\u0430\u0433\u043b\u044f\u0434\u043d\u0435\u0435<\/strong><\/p>\n<pre><code class=\"python\"># \u274c \u0442\u0430\u043a \u043d\u0435 \u043d\u0430\u0434\u043e@tool@injectasync def create_note(    session: FromDishka[AsyncSession],         # \u0434\u0435\u0442\u0430\u043b\u044c \u0438\u043d\u0444\u0440\u0430\u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u044b \u0432 API \u0442\u0443\u043b\u0437\u044b    notes: FromDishka[NoteRepository],         # \u0441\u043a\u043e\u043f \u043e\u0440\u043a\u0435\u0441\u0442\u0440\u0430\u0446\u0438\u0438 \u0432 \u0442\u0443\u043b\u0437\u0435    events: FromDishka[EventBus],              # \u0442\u0443\u0434\u0430 \u0436\u0435    title: str,     body: str = \"\",) -&gt; dict[str, str]: ...<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0422\u0443\u043b\u0437\u0430 \u0437\u043d\u0430\u0435\u0442 \u043f\u0440\u043e \u0411\u0414, \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439, \u0441\u043e\u0431\u044b\u0442\u0438\u044f \u2014 \u0442\u0440\u0438 \u0441\u043b\u043e\u044f \u0432 \u043e\u0434\u043d\u043e\u043c \u043c\u0435\u0441\u0442\u0435. \u041b\u044e\u0431\u043e\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0435 \u0431\u0438\u0437\u043d\u0435\u0441-\u043b\u043e\u0433\u0438\u043a\u0438 \u043f\u043e\u0442\u0430\u0449\u0438\u0442 \u043f\u0440\u0430\u0432\u043a\u0438 \u0441\u044e\u0434\u0430. \u041f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u043e \u2014 \u043e\u0441\u0442\u0430\u0432\u0438\u0442\u044c \u0442\u0443\u043b\u0437\u0435 <strong>\u043e\u0434\u043d\u0443<\/strong> \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u044c \u043d\u0430 \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0439 \u0438 \u043f\u043e\u043b\u043e\u0436\u0438\u0442\u044c \u0432\u0441\u044e \u0441\u043b\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u0437\u0430 \u0435\u0433\u043e \u0433\u0440\u0430\u043d\u0438\u0446\u0443.<\/p>\n<p><strong>\u041a\u043e\u0433\u0434\u0430 \u0432\u044b\u0431\u0438\u0440\u0430\u0442\u044c \u044d\u0442\u0443 \u0441\u0432\u044f\u0437\u043a\u0443<\/strong><\/p>\n<p>AG-UI \u043a\u0430\u043a \u043f\u0440\u043e\u0442\u043e\u043a\u043e\u043b \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u0448\u0438\u0440\u043e\u043a\u0438\u043c \u043d\u0430\u0431\u043e\u0440\u043e\u043c \u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a\u043e\u0432 \u2014 LangGraph, Pydantic AI, LlamaIndex, CrewAI, Mastra \u0438 \u0434\u0440. \u0421\u0430\u043c AG-UI \u0434\u0430\u0432\u043d\u043e \u043d\u0435 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442 \u00ab\u0437\u0430\u00bb \u043e\u0434\u0438\u043d \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u044b\u0439 \u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a.<\/p>\n<p>\u0427\u0442\u043e \u043e\u0441\u043e\u0437\u043d\u0430\u043d\u043d\u043e \u0432\u044b\u0431\u0438\u0440\u0430\u0435\u0442\u0441\u044f \u0432 <code>AG2.beta + dishka-ag2<\/code>:<\/p>\n<ul>\n<li>\n<p><strong>\u0413\u043e\u0442\u043e\u0432\u044b\u0439 \u043c\u043e\u0441\u0442 \u043a Dishka.<\/strong> \u0415\u0441\u043b\u0438 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u0443\u0436\u0435 Dishka \u2014 <code>dishka-ag2<\/code> \u0440\u0435\u0448\u0430\u0435\u0442 \u044d\u0442\u043e \u0441\u0440\u0430\u0437\u0443, \u0431\u0435\u0437 \u0432\u0442\u043e\u0440\u043e\u0433\u043e \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u043e\u0433\u043e DI \u0438 \u0431\u0435\u0437 <code>dependencies={...}<\/code>-\u0441\u043b\u043e\u0432\u0430\u0440\u0435\u0439.<\/p>\n<\/li>\n<li>\n<p><strong>Multi-agent-\u043e\u0440\u043a\u0435\u0441\u0442\u0440\u0430\u0446\u0438\u044f.<\/strong> \u0418\u0441\u0442\u043e\u0440\u0438\u0447\u0435\u0441\u043a\u0430\u044f \u043d\u0438\u0448\u0430 AG2: \u0433\u0440\u0443\u043f\u043f\u043e\u0432\u044b\u0435 \u0447\u0430\u0442\u044b, hand-off, \u043f\u0430\u0442\u0442\u0435\u0440\u043d\u044b \u00ab\u043c\u0435\u043d\u0435\u0434\u0436\u0435\u0440 \u2014 \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u0438\u00bb. \u0415\u0441\u043b\u0438 \u0430\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0430 \u043e\u0434\u043d\u043e\u0433\u043e \u0430\u0433\u0435\u043d\u0442\u0430 \u043f\u0435\u0440\u0435\u0441\u0442\u0430\u0451\u0442 \u0445\u0432\u0430\u0442\u0430\u0442\u044c \u2014 \u0440\u0430\u0441\u0442\u044f\u0433\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u0431\u0435\u0437 \u0441\u043c\u0435\u043d\u044b \u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a\u0430.<\/p>\n<\/li>\n<\/ul>\n<h2>\u0417\u0430\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435<\/h2>\n<p><code>AG2.beta + dishka-ag2<\/code> \u2014 \u0440\u0430\u0431\u043e\u0447\u0430\u044f \u0441\u0432\u044f\u0437\u043a\u0430 \u0434\u043b\u044f \u0418\u0418-\u0430\u0433\u0435\u043d\u0442\u0430 \u0441 \u043d\u043e\u0440\u043c\u0430\u043b\u044c\u043d\u043e\u0439 \u0430\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u043e\u0439: \u043e\u0434\u0438\u043d DI-\u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u043d\u0430 \u043f\u0440\u043e\u0435\u043a\u0442, \u0442\u0438\u043f\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u0435 \u0432\u043d\u0435\u0434\u0440\u0435\u043d\u0438\u0435 \u0432 \u0442\u0443\u043b\u0437\u044b, \u043f\u0440\u0435\u0434\u0441\u043a\u0430\u0437\u0443\u0435\u043c\u0430\u044f \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u043e\u043d\u043d\u0430\u044f \u0441\u0435\u043c\u0430\u043d\u0442\u0438\u043a\u0430 \u0438 \u043d\u043e\u043b\u044c \u043c\u0430\u0433\u0438\u0447\u0435\u0441\u043a\u0438\u0445 \u0441\u043b\u043e\u0432\u0430\u0440\u0435\u0439 \u0432 \u043a\u043e\u0434\u0435 \u0430\u0433\u0435\u043d\u0442\u0430.<\/p>\n<\/div>\n<p>\u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 <a href=\"https:\/\/habr.com\/ru\/articles\/1034102\/\">https:\/\/habr.com\/ru\/articles\/1034102\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>C\u0438\u0442\u0443\u0430\u0446\u0438\u044f: \u0443 \u0432\u0430\u0441 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u0434\u0430\u0432\u043d\u043e \u0436\u0438\u0432\u0451\u0442 Dishka. \u041a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u043d\u0430\u0441\u0442\u0440\u043e\u0435\u043d, \u043f\u0443\u043b\u044b, \u0444\u0430\u0431\u0440\u0438\u043a\u0438 UoW. \u0418 \u0442\u0443\u0442 \u0432\u044b \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442\u0435 LLM-\u0430\u0433\u0435\u043d\u0442\u0430 (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u043d\u0430 AG2). \u0410 \u043e\u043d \u0442\u0430\u043a\u043e\u0439: \u00ab\u0421\u043f\u0430\u0441\u0438\u0431\u043e, \u0434\u0435\u0440\u0436\u0438 dependencies={&#8216;session&#8217;: session, &#8216;repo&#8217;: repo} \u0438 \u043c\u043e\u044e \u0441\u043e\u0431\u0441\u0442\u0432\u0435\u043d\u043d\u0443\u044e DI-\u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0443. \u041d\u0435 \u0431\u043b\u0430\u0433\u043e\u0434\u0430\u0440\u0438\u00bb.\u0422\u043e \u0435\u0441\u0442\u044c \u0442\u0435\u043f\u0435\u0440\u044c \u0443 \u0432\u0430\u0441 \u0434\u0432\u0430 \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u044b\u0445 DI-\u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0430: \u043e\u0434\u0438\u043d \u0434\u043b\u044f HTTP-\u0440\u043e\u0443\u0442\u043e\u0432, \u0432\u0442\u043e\u0440\u043e\u0439 \u2014 \u0434\u043b\u044f \u0442\u0443\u043b\u0437 \u0430\u0433\u0435\u043d\u0442\u0430. \u041e\u0434\u0438\u043d \u0438 \u0442\u043e\u0442 \u0436\u0435 \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0439 \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442\u0441\u044f \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0434\u0432\u0430\u0436\u0434\u044b. \u041d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \/chat-\u0440\u043e\u0443\u0442 \u2014 \u0440\u0443\u043a\u0430\u043c\u0438 \u0441\u043e\u0431\u0438\u0440\u0430\u0442\u044c \u0441\u043b\u043e\u0432\u0430\u0440\u044c \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439 \u0438 \u043f\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u0442\u044c \u0435\u0433\u043e \u0432 agent.ask(dependencies={&#8230;}). \u0418 \u0432\u0441\u0451 \u044d\u0442\u043e \u2014 \u0440\u044f\u0434\u043e\u043c \u0441 \u0443\u0436\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u043c Dishka-\u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u043e\u043c, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0440\u043e\u0432\u043d\u043e \u044d\u0442\u0443 \u0440\u0430\u0431\u043e\u0442\u0443 \u0434\u0435\u043b\u0430\u0442\u044c \u0443\u043c\u0435\u0435\u0442.\u042d\u0442\u0430 \u0441\u0442\u0430\u0442\u044c\u044f \u2014 \u043f\u0440\u043e \u0442\u043e, \u043a\u0430\u043a \u044d\u0442\u043e\u0433\u043e \u0431\u043e\u043b\u044c\u0448\u0435 \u043d\u0435 \u0434\u0435\u043b\u0430\u0442\u044c. \u0412\u043d\u0443\u0442\u0440\u0438:\u0437\u0430\u0447\u0435\u043c \u0430\u0433\u0435\u043d\u0442\u0443 \u0432\u043e\u043e\u0431\u0449\u0435 \u043d\u0443\u0436\u0435\u043d \u043f\u043e\u043b\u043d\u043e\u0446\u0435\u043d\u043d\u044b\u0439 DI \u0438 \u043f\u043e\u0447\u0435\u043c\u0443 AG2 \u043f\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0441\u043e \u0432\u0441\u0442\u0440\u043e\u0435\u043d\u043d\u044b\u043c fast-depends;\u043f\u0430\u043a\u0435\u0442 dishka-ag2\u2014 \u043c\u043e\u0441\u0442 \u043c\u0435\u0436\u0434\u0443 AG2 \u0438 Dishka, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0434\u0432\u0430 \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0430 \u0432 \u043e\u0434\u0438\u043d;\u0440\u0430\u0431\u043e\u0447\u0438\u0439 \u043f\u0440\u0438\u043c\u0435\u0440, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u044f \u0441\u043e\u0431\u0440\u0430\u043b: FastAPI + AG2-\u0430\u0433\u0435\u043d\u0442 \u0441\u043e SSE-\u0441\u0442\u0440\u0438\u043c\u043e\u043c, \u0442\u0443\u043b\u0437\u044b \u0445\u043e\u0434\u044f\u0442 \u0432 Postgres \u0447\u0435\u0440\u0435\u0437 \u0442\u0438\u043f\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 DI;\u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u043e\u043d\u043d\u0430\u044f \u0441\u0435\u043c\u0430\u043d\u0442\u0438\u043a\u0430 tool calls \u2014 \u0447\u0442\u043e \u043f\u0440\u043e\u0438\u0441\u0445\u043e\u0434\u0438\u0442, \u043a\u043e\u0433\u0434\u0430 \u043c\u043e\u0434\u0435\u043b\u044c \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442 \u0442\u0440\u0438 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u0430 \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u043e \u0438 \u043e\u0434\u0438\u043d \u0438\u0437 \u043d\u0438\u0445 \u043f\u0430\u0434\u0430\u0435\u0442.\u041f\u043e\u043b\u043d\u044b\u0439 \u043a\u043e\u0434 \u043f\u0440\u0438\u043c\u0435\u0440\u0430: github.com\/vvlrff\/ag2_ag-ui_example \u2014 \u0441\u043e \u0432\u0441\u0435\u043c\u0438 \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u044f\u043c\u0438, Docker-\u0441\u0431\u043e\u0440\u043a\u043e\u0439 \u0438 \u0442\u0435\u0441\u0442\u0430\u043c\u0438.\u041f\u0440\u043e\u0431\u043b\u0435\u043c\u0430: \u043f\u043e\u0447\u0435\u043c\u0443 dependencies={&#8230;} \u2014 \u044d\u0442\u043e \u0431\u043e\u043b\u044cAG2 \u043f\u0440\u0435\u0434\u043b\u0430\u0433\u0430\u0435\u0442 \u043f\u0440\u043e\u043a\u0438\u0434\u044b\u0432\u0430\u0442\u044c \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u0432 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b \u0447\u0435\u0440\u0435\u0437 \u0441\u043b\u043e\u0432\u0430\u0440\u044c \u2014 \u043b\u0438\u0431\u043e \u043d\u0430 \u0443\u0440\u043e\u0432\u043d\u0435 \u0430\u0433\u0435\u043d\u0442\u0430, \u043b\u0438\u0431\u043e \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u043f\u0440\u043e\u0433\u043e\u043d:# \u043d\u0430 \u0443\u0440\u043e\u0432\u043d\u0435 \u0430\u0433\u0435\u043d\u0442\u0430 (\u0436\u0438\u0432\u0451\u0442 \u0432\u0441\u044e \u0436\u0438\u0437\u043d\u044c \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f)agent = Agent(    tools=[my_tool],    dependencies={&#171;static_dep&#187;: something},)# \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u043f\u0440\u043e\u0433\u043e\u043d \u2014 \u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u0430\u044f \u0441\u0435\u0441\u0441\u0438\u044f \u043b\u0435\u0442\u0438\u0442 \u0441\u044e\u0434\u0430await agent.ask(&#171;&#8230;&#187;, dependencies={&#171;db_session&#187;: session, &#171;repo&#187;: repo})\u0414\u043e\u0441\u0442\u0430\u0451\u0448\u044c \u0432 \u0442\u0443\u043b\u0437\u0435 \u0447\u0435\u0440\u0435\u0437 fast-depends-\u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u044e \u2014 \u0442\u0438\u043f\u0438\u0437\u0430\u0446\u0438\u044f \u043d\u0430 \u043c\u0435\u0441\u0442\u0435:@toolasync def my_tool(session: Annotated[AsyncSession, Inject()]) -&gt; &#8230;:    &#8230;\u042d\u0442\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442. \u0418 \u0434\u043e \u043a\u0430\u043a\u043e\u0433\u043e-\u0442\u043e \u043c\u043e\u043c\u0435\u043d\u0442\u0430 \u044d\u0442\u043e\u0433\u043e \u0445\u0432\u0430\u0442\u0430\u0435\u0442. \u0427\u0442\u043e \u043d\u0435 \u0442\u0430\u043a \u043d\u0430\u0447\u0438\u043d\u0430\u0435\u0442\u0441\u044f \u0434\u0430\u043b\u044c\u0448\u0435:\u0414\u0443\u0431\u043b\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 DI. \u0415\u0441\u043b\u0438 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u0443\u0436\u0435 \u0435\u0441\u0442\u044c Dishka \u2014 \u0443 \u0432\u0430\u0441 \u0434\u0432\u0430 \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0430. \u041e\u0434\u0438\u043d \u0438 \u0442\u043e\u0442 \u0436\u0435 CreateNoteUseCase \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0432 Dishka (\u0434\u043b\u044f HTTP-\u0440\u043e\u0443\u0442\u043e\u0432) \u0438 \u0433\u0434\u0435-\u0442\u043e \u0440\u044f\u0434\u043e\u043c \u0441\u043e\u0431\u0438\u0440\u0430\u0435\u0442\u0441\u044f \u0440\u0443\u043a\u0430\u043c\u0438 \u0434\u043b\u044f dependencies={&#8230;}. \u0414\u0432\u0435 \u043f\u043e\u043b\u0438\u0442\u0438\u043a\u0438 \u0436\u0438\u0437\u043d\u0435\u043d\u043d\u044b\u0445 \u0446\u0438\u043a\u043b\u043e\u0432. \u041b\u044e\u0431\u0430\u044f \u043f\u0440\u0430\u0432\u043a\u0430 \u0432 \u0434\u0435\u0440\u0435\u0432\u0435 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439 \u2014 \u0432 \u0434\u0432\u0443\u0445 \u043c\u0435\u0441\u0442\u0430\u0445.\u0420\u0443\u0447\u043d\u0430\u044f \u0441\u0431\u043e\u0440\u043a\u0430 \u0441\u043b\u043e\u0432\u0430\u0440\u044f \u0432 \u043a\u0430\u0436\u0434\u043e\u043c \/chat-\u0440\u043e\u0443\u0442\u0435. \u041d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u0437\u0430\u043f\u0440\u043e\u0441 \u0432\u044b \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0435 Dishka REQUEST, \u0434\u043e\u0441\u0442\u0430\u0451\u0442\u0435 \u043e\u0442\u0442\u0443\u0434\u0430 \u0441\u0435\u0441\u0441\u0438\u044e, \u0440\u0435\u043f\u043e, \u043d\u0443\u0436\u043d\u044b\u0435 \u0441\u0435\u0440\u0432\u0438\u0441\u044b, \u0441\u043a\u043b\u0430\u0434\u044b\u0432\u0430\u0435\u0442\u0435 \u0432 dict \u0438 \u043f\u0435\u0440\u0435\u0434\u0430\u0451\u0442\u0435 \u0432 agent.ask(dependencies=&#8230;). \u042d\u0442\u043e \u0440\u043e\u0432\u043d\u043e \u0442\u0430 \u043f\u043b\u0443\u043c\u0431\u0438\u043d\u0433-\u0440\u0430\u0431\u043e\u0442\u0430, \u043a\u043e\u0442\u043e\u0440\u0443\u044e DI-\u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u0434\u043e\u043b\u0436\u0435\u043d \u0434\u0435\u043b\u0430\u0442\u044c \u0441\u0430\u043c.\u041a\u0430\u0436\u0434\u043e\u0435 \u043d\u043e\u0432\u043e\u0435 \u0442\u0440\u0435\u0431\u043e\u0432\u0430\u043d\u0438\u0435 (\u043b\u043e\u0433\u0433\u0435\u0440, \u043a\u0435\u0448, http-\u043a\u043b\u0438\u0435\u043d\u0442) \u0434\u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0432 \u044d\u0442\u043e\u0442 \u0436\u0435 \u0441\u043b\u043e\u0432\u0430\u0440\u044c. \u0427\u0435\u0440\u0435\u0437 \u043f\u043e\u043b\u0433\u043e\u0434\u0430 \u0443 \u0432\u0430\u0441 \u0442\u0430\u043c 15 \u043a\u043b\u044e\u0447\u0435\u0439, \u0438 \u0447\u0438\u0442\u0430\u0442\u044c \u0441\u0431\u043e\u0440\u043a\u0443 \u044d\u0442\u043e\u0433\u043e \u0441\u043b\u043e\u0432\u0430\u0440\u044f \u2014 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u0435 \u0443\u0434\u043e\u0432\u043e\u043b\u044c\u0441\u0442\u0432\u0438\u0435.\u0421\u043a\u043e\u0443\u043f \u2014 \u043d\u0430 \u0432\u0435\u0441\u044c \u043f\u0440\u043e\u0433\u043e\u043d, \u0430 \u043d\u0435 \u043d\u0430 tool call. \u0421\u0435\u0441\u0441\u0438\u044f, \u043f\u0435\u0440\u0435\u0434\u0430\u043d\u043d\u0430\u044f \u0432 agent.ask, \u0436\u0438\u0432\u0451\u0442 \u043f\u043e\u043a\u0430 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043f\u0440\u043e\u0433\u043e\u043d. \u0415\u0441\u043b\u0438 LLM \u0434\u0451\u0440\u0433\u0430\u0435\u0442 \u0442\u0440\u0438 \u0442\u0443\u043b\u0437\u044b \u043f\u043e\u0434\u0440\u044f\u0434 \u2014 \u0432\u0441\u0435 \u0442\u0440\u0438 \u0441\u0438\u0434\u044f\u0442 \u043d\u0430 \u043e\u0434\u043d\u043e\u0439 \u0441\u0435\u0441\u0441\u0438\u0438 \u0438 \u043e\u0434\u043d\u043e\u0439 \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438. \u041d\u0443\u0436\u043d\u043e \u00ab\u043a\u0430\u0436\u0434\u044b\u0439 tool call \u2014 \u0441\u0432\u043e\u044f \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u044f\u00bb? \u0411\u0435\u0437 dishka-ag2 \u044d\u0442\u043e \u043f\u0440\u0438\u0434\u0451\u0442\u0441\u044f \u043f\u0438\u0441\u0430\u0442\u044c \u0440\u0443\u043a\u0430\u043c\u0438.\u0416\u0435\u043b\u0430\u0435\u043c\u043e\u0435 API \u2014 \u0442\u0438\u043f\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u0435 \u0432\u043d\u0435\u0434\u0440\u0435\u043d\u0438\u0435, \u043a\u0430\u043a \u0432 FastAPI:@tool@injectasync def create_note(    title: str,    body: str = &#171;&#187;,    *,    uc: FromDishka[CreateNoteUseCase],) -&gt; NoteToolResult:    response = await uc.execute(CreateNoteRequest(title=title, body=body))    return NoteToolResult.from_entity(response.note)LLM \u0432 \u0441\u0445\u0435\u043c\u0443 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u0430 \u0432\u0438\u0434\u0438\u0442 \u0442\u043e\u043b\u044c\u043a\u043e title \u0438 body. \u0421\u0446\u0435\u043d\u0430\u0440\u0438\u0439 \u0432\u043d\u0435\u0434\u0440\u044f\u0435\u0442\u0441\u044f \u0447\u0435\u0440\u0435\u0437 DI \u0438 \u0436\u0438\u0432\u0451\u0442 \u0440\u043e\u0432\u043d\u043e \u0441\u0442\u043e\u043b\u044c\u043a\u043e, \u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0442\u0443\u043b\u0437\u0430. \u041e\u0434\u0438\u043d \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u043d\u0430 \u0432\u0435\u0441\u044c \u043f\u0440\u043e\u0435\u043a\u0442. \u042d\u0442\u043e \u0438 \u0435\u0441\u0442\u044c dishka-ag2.\u041f\u043e\u0434 \u043a\u0430\u043f\u043e\u0442\u043e\u043c AG2: \u0437\u0430\u0447\u0435\u043c \u0442\u0430\u043c fast-depends\u0427\u0442\u043e\u0431\u044b \u043f\u043e\u043d\u044f\u0442\u044c, \u043a\u0430\u043a dishka-ag2 \u0432\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u0432 AG2, \u043d\u0443\u0436\u043d\u043e \u0437\u043d\u0430\u0442\u044c \u043e\u0434\u043d\u0443 \u0434\u0435\u0442\u0430\u043b\u044c: \u0432\u043d\u0443\u0442\u0440\u0438 AG2 \u0443\u0436\u0435 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 DI \u2014 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 fast-depends, \u0430\u0432\u0442\u043e\u043d\u043e\u043c\u043d\u044b\u0439 \u043c\u0435\u0445\u0430\u043d\u0438\u0437\u043c \u0440\u0430\u0431\u043e\u0442\u044b \u0441  \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u044f\u043c\u0438 \u0432 \u0434\u0443\u0445\u0435 FastAPI Depends, \u043d\u043e \u0431\u0435\u0437 \u043f\u0440\u0438\u0432\u044f\u0437\u043a\u0438 \u043a \u0432\u0435\u0431-\u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a\u0443.fast-depends \u2014 \u044d\u0442\u043e \u0438\u043d\u0436\u0435\u043a\u0442\u043e\u0440 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u043e\u0432, \u0430 \u043d\u0435 \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440. \u0420\u0430\u0437\u043d\u0438\u0446\u0430 \u043f\u0440\u0438\u043d\u0446\u0438\u043f\u0438\u0430\u043b\u044c\u043d\u0430\u044f: \u043e\u043d \u0443\u043c\u0435\u0435\u0442 \u0440\u0430\u0441\u043f\u043e\u0437\u043d\u0430\u0442\u044c Annotated[T, Inject()] \u0432 \u0441\u0438\u0433\u043d\u0430\u0442\u0443\u0440\u0435, \u0434\u0451\u0440\u043d\u0443\u0442\u044c \u0437\u0430\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u043f\u0440\u043e\u0432\u0430\u0439\u0434\u0435\u0440, \u043f\u043e\u0434\u0441\u0442\u0430\u0432\u0438\u0442\u044c \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0432 \u0432\u044b\u0437\u043e\u0432. \u0427\u0435\u0433\u043e \u0443 \u043d\u0435\u0433\u043e \u043d\u0435\u0442 \u2014 \u0438\u0435\u0440\u0430\u0440\u0445\u0438\u0438 \u0441\u043a\u043e\u0443\u043f\u043e\u0432 (APP\/REQUEST\/&#8230;) \u0438 \u043e\u0431\u0449\u0435\u0433\u043e \u0440\u0435\u0435\u0441\u0442\u0440\u0430, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u043f\u0440\u043e\u0432\u0430\u0439\u0434\u0435\u0440\u044b \u043c\u043e\u0433\u0443\u0442 \u0437\u0430\u0432\u0438\u0441\u0435\u0442\u044c \u0434\u0440\u0443\u0433 \u043e\u0442 \u0434\u0440\u0443\u0433\u0430 \u0438 \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c\u0441\u044f \u043c\u0435\u0436\u0434\u0443 \u0440\u0430\u0437\u043d\u044b\u043c\u0438 \u0442\u043e\u0447\u043a\u0430\u043c\u0438 \u0432\u0445\u043e\u0434\u0430.\u0417\u0430\u043e\u0434\u043d\u043e \u2014 \u0434\u0432\u0430 \u0441\u043b\u043e\u0432\u0430 \u043f\u0440\u043e AG-UI. \u042d\u0442\u043e SSE-\u043f\u0440\u043e\u0442\u043e\u043a\u043e\u043b, \u043a\u043e\u0442\u043e\u0440\u044b\u043c \u0441\u0435\u0440\u0432\u0435\u0440 \u0448\u043b\u0451\u0442 \u043a\u043b\u0438\u0435\u043d\u0442\u0443 \u0441\u043e\u0431\u044b\u0442\u0438\u044f \u0430\u0433\u0435\u043d\u0442\u0430 \u0432 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u043c \u0432\u0440\u0435\u043c\u0435\u043d\u0438:\u0421\u043e\u0431\u044b\u0442\u0438\u0435\u041a\u043e\u0433\u0434\u0430RUN_STARTED \/ RUN_FINISHED\u0433\u0440\u0430\u043d\u0438\u0446\u044b \u043f\u0440\u043e\u0433\u043e\u043d\u0430RUN_ERROR\u043f\u0440\u043e\u0433\u043e\u043d \u0443\u043f\u0430\u043bTEXT_MESSAGE_CHUNK\u0441\u0442\u0440\u0438\u043c \u0442\u043e\u043a\u0435\u043d\u043e\u0432 \u043e\u0442 LLMTOOL_CALL_START \/ TOOL_CALL_ARGSLLM \u0440\u0435\u0448\u0438\u043b \u0432\u044b\u0437\u0432\u0430\u0442\u044c \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442TOOL_CALL_RESULT \/ TOOL_CALL_END\u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \/ \u0437\u0430\u0432\u0435\u0440\u0448\u0435\u043d\u0438\u0435 \u0432\u044b\u0437\u043e\u0432\u0430autogen.beta.ag_ui.AGUIStream \u2014 \u043e\u0431\u0451\u0440\u0442\u043a\u0430, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u0431\u0435\u0440\u0451\u0442 \u0432\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u0438\u0435 \u0441\u043e\u0431\u044b\u0442\u0438\u044f \u0430\u0433\u0435\u043d\u0442\u0430 \u0438 \u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0443\u0435\u0442 \u0438\u0445 \u0432 SSE-\u0444\u0440\u0435\u0439\u043c\u044b. AG-UI \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442 AG2, LangGraph, Pydantic AI, LlamaIndex, CrewAI \u0438 \u0442.\u0434. \u2014 \u0442\u0430\u043a \u0447\u0442\u043e \u0441\u0430\u043c \u043f\u043e \u0441\u0435\u0431\u0435 \u043e\u043d \u0434\u0430\u0432\u043d\u043e \u043d\u0435 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442 \u00ab\u0437\u0430\u00bb \u043a\u0430\u043a\u043e\u0439-\u0442\u043e \u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a. \u0410\u0440\u0433\u0443\u043c\u0435\u043d\u0442 \u0437\u0434\u0435\u0441\u044c \u2014 \u0441\u0432\u044f\u0437\u043a\u0430 AG2.beta + dishka-ag2.\u041f\u0430\u043a\u0435\u0442 dishka-ag2: \u0442\u0440\u0438 \u043a\u0438\u0440\u043f\u0438\u0447\u0438\u043a\u04301. AG2Scope \u2014 \u0438\u0435\u0440\u0430\u0440\u0445\u0438\u044f \u0441\u043a\u043e\u0443\u043f\u043e\u0432\u0421\u0435\u043c\u044c \u0443\u0440\u043e\u0432\u043d\u0435\u0439, \u043d\u043e \u0440\u0435\u0430\u043b\u044c\u043d\u043e \u0432\u0430\u043c \u043d\u0443\u0436\u043d\u044b \u0434\u0432\u0430:AG2Scope.APP \u2014 \u0441\u0438\u043d\u0433\u043b\u0442\u043e\u043d\u044b \u043d\u0430 \u0436\u0438\u0437\u043d\u044c \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f: engine SQLAlchemy, sessionmaker, \u043a\u043e\u043d\u0444\u0438\u0433, OpenAIConfig.AG2Scope.REQUEST \u2014 \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 HTTP-\u0437\u0430\u043f\u0440\u043e\u0441 (\u0447\u0435\u0440\u0435\u0437 ASGI-middleware) \u0438 \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 tool call (\u0434\u0435\u043a\u043e\u0440\u0430\u0442\u043e\u0440\u043e\u043c @inject). \u0412\u043d\u0443\u0442\u0440\u0438 \u0436\u0438\u0432\u0443\u0442 \u0441\u0435\u0441\u0441\u0438\u044f \u0411\u0414, \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438, \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0438.2. DishkaAsyncMiddleware \u2014 middleware \u0430\u0433\u0435\u043d\u0442\u0430\u041f\u043e\u0434\u043a\u043b\u044e\u0447\u0430\u0435\u0442\u0441\u044f \u043a Agent. \u041f\u0435\u0440\u0435\u0445\u0432\u0430\u0442\u044b\u0432\u0430\u0435\u0442 \u0441\u043e\u0431\u044b\u0442\u0438\u044f \u0430\u0433\u0435\u043d\u0442\u0430 (on_turn, on_tool_execution, on_llm_call) \u0438 \u0433\u043e\u0442\u043e\u0432\u0438\u0442 \u043a\u043e\u043d\u0442\u0435\u043a\u0441\u0442 \u0434\u043b\u044f \u0431\u0443\u0434\u0443\u0449\u0435\u0433\u043e \u043e\u0442\u043a\u0440\u044b\u0442\u0438\u044f \u0441\u043a\u043e\u0443\u043f\u0430. \u0421\u0430\u043c \u0441\u043a\u043e\u0443\u043f REQUEST middleware \u043d\u0435 \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u2014 \u0442\u043e\u043b\u044c\u043a\u043e \u0441\u043a\u043b\u0430\u0434\u044b\u0432\u0430\u0435\u0442 \u0442\u0435\u043a\u0443\u0449\u0438\u0439 Context \u0438 ToolCallEvent \u0432 pending-\u0441\u043b\u043e\u0442.3. @inject \u2014 \u0434\u0435\u043a\u043e\u0440\u0430\u0442\u043e\u0440 \u0442\u0443\u043b\u0437\u044b\u041a\u043e\u0433\u0434\u0430 AG2 \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442, @inject:\u0414\u043e\u0441\u0442\u0430\u0451\u0442 \u043a\u043e\u0440\u043d\u0435\u0432\u043e\u0439 \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u0438\u0437 \u043a\u043e\u043d\u0442\u0435\u043a\u0441\u0442\u0430.\u041e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442 AG2Scope.REQUEST \u0441 \u0434\u0430\u043d\u043d\u044b\u043c\u0438 \u0438\u0437 pending-\u0441\u043b\u043e\u0442\u0430.\u0420\u0435\u0437\u043e\u043b\u0432\u0438\u0442 \u0432\u0441\u0435 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u044b, \u043f\u043e\u043c\u0435\u0447\u0435\u043d\u043d\u044b\u0435 FromDishka[T].\u0412\u044b\u0437\u044b\u0432\u0430\u0435\u0442 \u0444\u0443\u043d\u043a\u0446\u0438\u044e.\u0417\u0430\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u0441\u043a\u043e\u0443\u043f \u043f\u043e\u0441\u043b\u0435 \u0432\u043e\u0437\u0432\u0440\u0430\u0442\u0430 (\u0438\u043b\u0438 \u043f\u043e\u0441\u043b\u0435 \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u044f).\u0418\u043d\u044b\u043c\u0438 \u0441\u043b\u043e\u0432\u0430\u043c\u0438, \u0441\u043a\u043e\u0443\u043f \u0436\u0438\u0432\u0451\u0442 \u0440\u043e\u0432\u043d\u043e \u0441\u0442\u043e\u043b\u044c\u043a\u043e, \u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0432\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u0442\u0441\u044f \u0442\u0435\u043b\u043e \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u0430. \u0421\u0435\u0441\u0441\u0438\u044f \u0411\u0414 \u2014 \u0442\u043e\u0436\u0435.\u041f\u043b\u044e\u0441 \u043a \u044d\u0442\u043e\u043c\u0443 \u043f\u0430\u043a\u0435\u0442 \u0434\u0430\u0451\u0442 AG2Provider \u2014 \u043f\u0440\u043e\u0432\u0430\u0439\u0434\u0435\u0440 \u00ab\u0438\u0437 \u043a\u043e\u0440\u043e\u0431\u043a\u0438\u00bb, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0443\u043c\u0435\u0435\u0442 \u043e\u0442\u0434\u0430\u0432\u0430\u0442\u044c ToolCallEvent, Context, ConversationContainer \u0438 \u0442.\u043f. \u0432 \u0432\u0438\u0434\u0435 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439. \u0411\u0435\u0437 \u043d\u0435\u0433\u043e \u0442\u0438\u043f\u044b \u0438\u0437 \u0441\u0430\u043c\u043e\u0433\u043e AG2 \u0432 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442 \u043d\u0435 \u0432\u043d\u0435\u0434\u0440\u044f\u0442\u0441\u044f, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 AG2Provider() \u0432 default_providers() \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u0435\u043d.\u0410\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0430 \u043f\u0440\u0438\u043c\u0435\u0440\u0430\u0416\u0438\u0437\u043d\u0435\u043d\u043d\u044b\u0439 \u0446\u0438\u043a\u043b \u0441\u043a\u043e\u0443\u043f\u043e\u0432 \u043d\u0430 \u043e\u0434\u043d\u043e\u043c HTTP-\u0437\u0430\u043f\u0440\u043e\u0441\u0435:HTTP POST \/api\/chat   \u2502   \u25bc AG2ContainerMiddleware \u2500\u2500 \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442 AG2Scope.REQUEST \u0434\u043b\u044f HTTP   \u2502   \u25bc chat-route \u2500\u2500 \u0431\u0435\u0440\u0451\u0442 agent = app.state.agent (\u0441\u0438\u043d\u0433\u043b\u0442\u043e\u043d)   \u2502   \u25bc AGUIStream(agent).dispatch(run_input)   \u2502      \u0430\u0433\u0435\u043d\u0442 \u0440\u0435\u0448\u0430\u0435\u0442 \u0432\u044b\u0437\u0432\u0430\u0442\u044c \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442   \u25bc   DishkaAsyncMiddleware.on_tool_execution   \u2502      stash_request_context: \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u0435\u0442 Context, ToolCallEvent   \u2502      (\u0441\u043a\u043e\u0443\u043f \u041d\u0415 \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442)   \u25bc   @inject create_note(uc: FromDishka[CreateNoteUseCase])   \u2502      \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442 AG2Scope.REQUEST \u0441\u043e stash-\u0434\u0430\u043d\u043d\u044b\u043c\u0438   \u2502      \u0440\u0435\u0437\u043e\u043b\u0432\u0438\u0442 uc \u0447\u0435\u0440\u0435\u0437 \u0446\u0435\u043f\u043e\u0447\u043a\u0443 DI   \u25bc   CreateNoteUseCase \u2192 AlchemyNoteRepository \u2192 AsyncSession \u2192 Postgres   \u2502   \u25bc \u041f\u043e\u0441\u043b\u0435 \u0432\u043e\u0437\u0432\u0440\u0430\u0442\u0430 @inject \u0437\u0430\u043a\u0440\u044b\u0432\u0430\u0435\u0442 REQUEST-\u0441\u043a\u043e\u0443\u043f   \u2502      (\u0441\u0435\u0441\u0441\u0438\u044f \u0411\u0414 \u043e\u0442\u043f\u0443\u0449\u0435\u043d\u0430 \u043e\u0431\u0440\u0430\u0442\u043d\u043e \u0432 \u043f\u0443\u043b)   \u25bc ToolResultEvent \u2192 AGUIStream \u2192 SSE TOOL_CALL_RESULT\u041a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u043e\u0434\u0438\u043d. \u0421\u043a\u043e\u0443\u043f REQUEST \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0434\u0432\u0430\u0436\u0434\u044b \u2014 \u043d\u0430 HTTP-\u0437\u0430\u043f\u0440\u043e\u0441 \u0438 \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 tool call. \u042d\u0442\u043e \u0441\u0434\u0435\u043b\u0430\u043d\u043e \u043d\u0430\u043c\u0435\u0440\u0435\u043d\u043d\u043e: \u043a\u0430\u0436\u0434\u044b\u0439 tool call \u2014 \u0441\u0432\u043e\u044f \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u044f (\u0441\u043c. \u043d\u0438\u0436\u0435).\u0421\u0431\u043e\u0440\u043a\u0430 \u0441\u043d\u0438\u0437\u0443 \u0432\u0432\u0435\u0440\u0445 (\u0442\u043e\u043b\u044c\u043a\u043e \u0432\u0430\u0436\u043d\u043e\u0435)# domain\/entities.pyNoteId = NewType(&#171;NoteId&#187;, UUID)@dataclassclass Note:    id: NoteId    title: str    body: str    created_at: datetime    # gateways\/db\/note\/interface.pyclass NoteRepository(Protocol):    async def create(self, note: Note) -&gt; Note: &#8230;    async def list_notes(self, limit: int = 20) -&gt; list[Note]: &#8230;    async def delete(self, note_id: NoteId) -&gt; bool: &#8230;\u0420\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u043d\u0430 SQLAlchemy 2.0 \u2014 \u043f\u043e\u043b\u043d\u044b\u0439 \u043a\u043e\u0434 \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438. \u0422\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u044f \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u044f\u0432\u043d\u043e \u043d\u0435 \u0437\u0430\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u2014 \u044d\u0442\u0438\u043c \u0437\u0430\u043d\u0438\u043c\u0430\u0435\u0442\u0441\u044f UoW.\u0421\u0446\u0435\u043d\u0430\u0440\u0438\u0439 + UnitOfWork# usecases\/uow.pyclass UnitOfWork(Protocol):    async def commit(self) -&gt; None: &#8230;    async def rollback(self) -&gt; None: &#8230;    async def flush(self) -&gt; None: &#8230;AsyncSession \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u043d\u043e \u0443\u0434\u043e\u0432\u043b\u0435\u0442\u0432\u043e\u0440\u044f\u0435\u0442 \u044d\u0442\u043e\u043c\u0443 \u043f\u0440\u043e\u0442\u043e\u043a\u043e\u043b\u0443 \u2014 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 \u043a\u043b\u0430\u0441\u0441 \u043d\u0435 \u043d\u0443\u0436\u0435\u043d. \u042d\u0442\u043e \u043f\u0440\u0438\u0433\u043e\u0434\u0438\u0442\u0441\u044f \u0447\u0435\u0440\u0435\u0437 \u0448\u0430\u0433.class CreateNoteUseCase:    def __init__(self, repo: NoteRepository, uow: UnitOfWork) -&gt; None:        self._repo = repo        self._uow = uow    async def execute(self, request: CreateNoteRequest) -&gt; CreateNoteResponse:        note = Note(            id=NoteId(uuid4()),             title=request.title,            body=request.body,             created_at=datetime.now(UTC)        )        created = await self._repo.create(note)        await self._uow.commit()        return CreateNoteResponse(note=created)\u0421\u0446\u0435\u043d\u0430\u0440\u0438\u0439 \u043d\u0435 \u0437\u043d\u0430\u0435\u0442 \u043d\u0438 \u043f\u0440\u043e FastAPI, \u043d\u0438 \u043f\u0440\u043e SQLAlchemy, \u043d\u0438 \u043f\u0440\u043e AG2 \u2014 \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u0432\u0430 \u043f\u0440\u043e\u0442\u043e\u043a\u043e\u043b\u0430. \u0422\u0435\u0441\u0442\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0432 \u043f\u043e\u043b\u043d\u043e\u0439 \u0438\u0437\u043e\u043b\u044f\u0446\u0438\u0438.DI-\u043f\u0440\u043e\u0432\u0430\u0439\u0434\u0435\u0440 \u0441 \u043e\u0434\u043d\u0438\u043c \u0445\u0438\u0442\u0440\u044b\u043c \u043f\u0440\u0438\u0451\u043c\u043e\u043cclass DatabaseProvider(Provider):    @provide(scope=AG2Scope.APP)    async def provide_async_engine(self, settings: Settings) -&gt; AsyncIterator[AsyncEngine]:        engine = create_async_engine(            make_url(settings.database_url),            pool_size=10,            max_overflow=10,            pool_timeout=10,            pool_pre_ping=True,        )        yield engine        await engine.dispose()    @provide(scope=AG2Scope.APP)    def provide_sessionmaker(self, engine: AsyncEngine) -&gt; async_sessionmaker[AsyncSession]:        return async_sessionmaker[AsyncSession](            bind=engine,            autoflush=False,            autocommit=False,            expire_on_commit=False,        )    @provide(scope=AG2Scope.REQUEST)    async def provide_async_session(        self, pool: async_sessionmaker[AsyncSession]    ) -&gt; AsyncIterator[AnyOf[AsyncSession, UnitOfWork]]:  # \u2190 \u043a\u043b\u044e\u0447\u0435\u0432\u0430\u044f \u0441\u0442\u0440\u043e\u0447\u043a\u0430        async with pool() as session:            yield sessionAnyOf[AsyncSession, UnitOfWork] \u2014 Dishka \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u0443\u0435\u0442 \u043e\u0434\u0438\u043d \u0438 \u0442\u043e\u0442 \u0436\u0435 \u043e\u0431\u044a\u0435\u043a\u0442 \u043f\u043e\u0434 \u0434\u0432\u0443\u043c\u044f \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u0430\u043c\u0438. \u0420\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u043f\u043e\u043b\u0443\u0447\u0438\u0442 \u0435\u0433\u043e \u043a\u0430\u043a AsyncSession, \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0439 \u2014 \u043a\u0430\u043a UnitOfWork. \u042d\u0442\u043e \u043e\u0434\u043d\u0430 \u0441\u0435\u0441\u0441\u0438\u044f, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 await uow.commit() \u043a\u043e\u043c\u043c\u0438\u0442\u0438\u0442 \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u044e, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0441\u0434\u0435\u043b\u0430\u043b add \u0438 flush.\u0421\u0431\u043e\u0440\u043a\u0430 \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0430def default_providers() -&gt; tuple[Provider, &#8230;]:    return (        SettingsProvider(),        DatabaseProvider(),        RepositoryProvider(),        UseCaseProvider(),        AgentProvider(),        AG2Provider(),  # \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u0435\u043d    )def create_container(*providers, context=None) -&gt;&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-479403","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/479403","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=479403"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/479403\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=479403"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=479403"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=479403"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}