Files
microdao-daarion/site/greenfood/greenfood_agents/index.html

1423 lines
52 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link rel="canonical" href="https://IvanTytar.github.io/microdao-daarion/greenfood/greenfood_agents/">
<link rel="icon" href="../../assets/images/favicon.png">
<meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.18">
<title>GREENFOOD Crew - Документація - DAARION Documentation</title>
<link rel="stylesheet" href="../../assets/stylesheets/main.66ac8b77.min.css">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
<script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
</head>
<body dir="ltr">
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#greenfood-crew-" class="md-skip">
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header md-header--shadow" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href="../.." title="DAARION Documentation" class="md-header__button md-logo" aria-label="DAARION Documentation" data-md-component="logo">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
DAARION Documentation
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
GREENFOOD Crew - Документація
</span>
</div>
</div>
</div>
<script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
</label>
<nav class="md-search__options" aria-label="Search">
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
</button>
</nav>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
Initializing search
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href="../.." title="DAARION Documentation" class="md-nav__button md-logo" aria-label="DAARION Documentation" data-md-component="logo">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
</a>
DAARION Documentation
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../public/" class="md-nav__link">
<span class="md-ellipsis">
Home
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../public/getting-started/" class="md-nav__link">
<span class="md-ellipsis">
Getting Started
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../public/architecture-overview/" class="md-nav__link">
<span class="md-ellipsis">
Architecture
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../public/daiS_daos_overview/" class="md-nav__link">
<span class="md-ellipsis">
DAIS & DAOS
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="">
<span class="md-ellipsis">
Internal
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_5">
<span class="md-nav__icon md-icon"></span>
Internal
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
<label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
<span class="md-ellipsis">
Infra
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_5_1">
<span class="md-nav__icon md-icon"></span>
Infra
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../internal/infra/INFRA_AUTOMATION_PACK_V1/" class="md-nav__link">
<span class="md-ellipsis">
Infra Automation Pack v1
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../internal/infra/monitoring_overview/" class="md-nav__link">
<span class="md-ellipsis">
Monitoring Overview
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../internal/infra/nodes_registry_v0/" class="md-nav__link">
<span class="md-ellipsis">
Nodes Registry v0
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
<label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
<span class="md-ellipsis">
Specs
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_5_2">
<span class="md-nav__icon md-icon"></span>
Specs
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../internal/specs/matrix_presence_aggregator/" class="md-nav__link">
<span class="md-ellipsis">
Matrix Presence Aggregator
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../internal/specs/city_map_spec/" class="md-nav__link">
<span class="md-ellipsis">
City Map Spec
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../internal/specs/node_join_protocol_draft/" class="md-nav__link">
<span class="md-ellipsis">
Node Join Protocol (Draft)
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#_1" class="md-nav__link">
<span class="md-ellipsis">
Огляд
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#_2" class="md-nav__link">
<span class="md-ellipsis">
Архітектура
</span>
</a>
<nav class="md-nav" aria-label="Архітектура">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#_3" class="md-nav__link">
<span class="md-ellipsis">
Головний оркестратор
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#12" class="md-nav__link">
<span class="md-ellipsis">
12 доменних агентів
</span>
</a>
<nav class="md-nav" aria-label="12 доменних агентів">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#operations" class="md-nav__link">
<span class="md-ellipsis">
🏭 Операційні агенти (Operations)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#sales-support" class="md-nav__link">
<span class="md-ellipsis">
💼 Продажі та підтримка (Sales &amp; Support)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#finance" class="md-nav__link">
<span class="md-ellipsis">
💰 Фінанси (Finance)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#marketing" class="md-nav__link">
<span class="md-ellipsis">
📢 Маркетинг (Marketing)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#governance-analytics-governance" class="md-nav__link">
<span class="md-ellipsis">
📊 Аналітика та governance (Analytics &amp; Governance)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#success" class="md-nav__link">
<span class="md-ellipsis">
🚀 Успіх клієнтів (Success)
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#_4" class="md-nav__link">
<span class="md-ellipsis">
Ролі та відповідальність агентів
</span>
</a>
<nav class="md-nav" aria-label="Ролі та відповідальність агентів">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#1-greenfood-assistant" class="md-nav__link">
<span class="md-ellipsis">
1. GREENFOOD Assistant
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#2-product-catalog-agent" class="md-nav__link">
<span class="md-ellipsis">
2. Product &amp; Catalog Agent
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#3-batch-quality-agent" class="md-nav__link">
<span class="md-ellipsis">
3. Batch &amp; Quality Agent
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#4-vendor-success-agent" class="md-nav__link">
<span class="md-ellipsis">
4. Vendor Success Agent
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#5-warehouse-agent" class="md-nav__link">
<span class="md-ellipsis">
5. Warehouse Agent
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#6-logistics-delivery-agent" class="md-nav__link">
<span class="md-ellipsis">
6. Logistics &amp; Delivery Agent
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#7-seller-agent" class="md-nav__link">
<span class="md-ellipsis">
7. Seller Agent
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#8-customer-care-agent" class="md-nav__link">
<span class="md-ellipsis">
8. Customer Care Agent
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#9-finance-pricing-agent" class="md-nav__link">
<span class="md-ellipsis">
9. Finance &amp; Pricing Agent
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#10-smm-campaigns-agent" class="md-nav__link">
<span class="md-ellipsis">
10. SMM &amp; Campaigns Agent
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#11-seo-web-experience-agent" class="md-nav__link">
<span class="md-ellipsis">
11. SEO &amp; Web Experience Agent
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#12-analytics-bi-agent" class="md-nav__link">
<span class="md-ellipsis">
12. Analytics &amp; BI Agent
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#13-compliance-audit-agent" class="md-nav__link">
<span class="md-ellipsis">
13. Compliance &amp; Audit Agent
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#crews-" class="md-nav__link">
<span class="md-ellipsis">
Команди (Crews) для бізнес-сценаріїв
</span>
</a>
<nav class="md-nav" aria-label="Команди (Crews) для бізнес-сценаріїв">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#1-onboard-vendor-crew" class="md-nav__link">
<span class="md-ellipsis">
1. Onboard Vendor Crew
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#2-fulfill-order-crew" class="md-nav__link">
<span class="md-ellipsis">
2. Fulfill Order Crew
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#3-monthly-settlement-crew" class="md-nav__link">
<span class="md-ellipsis">
3. Monthly Settlement Crew
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#4-marketing-campaign-crew" class="md-nav__link">
<span class="md-ellipsis">
4. Marketing Campaign Crew (додатковий)
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#_5" class="md-nav__link">
<span class="md-ellipsis">
Зв'язки між агентами
</span>
</a>
<nav class="md-nav" aria-label="Зв'язки між агентами">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#_6" class="md-nav__link">
<span class="md-ellipsis">
Найчастіші взаємодії
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#dagi-router" class="md-nav__link">
<span class="md-ellipsis">
Інтеграція з DAGI Router
</span>
</a>
<nav class="md-nav" aria-label="Інтеграція з DAGI Router">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#router-configyml" class="md-nav__link">
<span class="md-ellipsis">
Додавання в router-config.yml
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#router" class="md-nav__link">
<span class="md-ellipsis">
Виклик через Router
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#_7" class="md-nav__link">
<span class="md-ellipsis">
Файлова структура
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#_8" class="md-nav__link">
<span class="md-ellipsis">
Наступні кроки
</span>
</a>
<nav class="md-nav" aria-label="Наступні кроки">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#1" class="md-nav__link">
<span class="md-ellipsis">
Фаза 1: Базова інтеграція
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#2-api" class="md-nav__link">
<span class="md-ellipsis">
Фаза 2: Інструменти та API
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#3-crews-workflows" class="md-nav__link">
<span class="md-ellipsis">
Фаза 3: Crews та workflows
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#4-ui-ux" class="md-nav__link">
<span class="md-ellipsis">
Фаза 4: UI та UX
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#_9" class="md-nav__link">
<span class="md-ellipsis">
Контакти та підтримка
</span>
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<h1 id="greenfood-crew-">GREENFOOD Crew - Документація<a class="headerlink" href="#greenfood-crew-" title="Permanent link">&para;</a></h1>
<p><strong>Версія</strong>: 1.0.0<br />
<strong>Дата</strong>: 2025-11-18<br />
<strong>Статус</strong>: Ready for Development</p>
<hr />
<h2 id="_1">Огляд<a class="headerlink" href="#_1" title="Permanent link">&para;</a></h2>
<p>GREENFOOD Crew — це команда з 13 спеціалізованих AI-агентів для управління ERP-системою крафтових виробників продуктів харчування. Система забезпечує повний цикл від onboarding виробника до доставки товару покупцю та фінансових розрахунків.</p>
<hr />
<h2 id="_2">Архітектура<a class="headerlink" href="#_2" title="Permanent link">&para;</a></h2>
<h3 id="_3">Головний оркестратор<a class="headerlink" href="#_3" title="Permanent link">&para;</a></h3>
<p><strong>GREENFOOD Assistant</strong> — єдина точка входу для всіх користувачів системи. Розпізнає роль користувача, виявляє намір та делегує завдання відповідним доменним агентам.</p>
<h3 id="12">12 доменних агентів<a class="headerlink" href="#12" title="Permanent link">&para;</a></h3>
<p>Агенти організовані за функціональними доменами:</p>
<h4 id="operations">🏭 Операційні агенти (Operations)<a class="headerlink" href="#operations" title="Permanent link">&para;</a></h4>
<ol>
<li><strong>Product &amp; Catalog Agent</strong> - Каталог товарів</li>
<li><strong>Batch &amp; Quality Agent</strong> - Партії та контроль якості</li>
<li><strong>Warehouse Agent</strong> - Управління складами</li>
<li><strong>Logistics &amp; Delivery Agent</strong> - Логістика та доставка</li>
</ol>
<h4 id="sales-support">💼 Продажі та підтримка (Sales &amp; Support)<a class="headerlink" href="#sales-support" title="Permanent link">&para;</a></h4>
<ol>
<li><strong>Seller Agent</strong> - Менеджер з продажу</li>
<li><strong>Customer Care Agent</strong> - Служба підтримки</li>
</ol>
<h4 id="finance">💰 Фінанси (Finance)<a class="headerlink" href="#finance" title="Permanent link">&para;</a></h4>
<ol>
<li><strong>Finance &amp; Pricing Agent</strong> - Бухгалтерія та ціноутворення</li>
</ol>
<h4 id="marketing">📢 Маркетинг (Marketing)<a class="headerlink" href="#marketing" title="Permanent link">&para;</a></h4>
<ol>
<li><strong>SMM &amp; Campaigns Agent</strong> - Соціальні мережі та кампанії</li>
<li><strong>SEO &amp; Web Experience Agent</strong> - SEO та веб-досвід</li>
</ol>
<h4 id="governance-analytics-governance">📊 Аналітика та governance (Analytics &amp; Governance)<a class="headerlink" href="#governance-analytics-governance" title="Permanent link">&para;</a></h4>
<ol>
<li><strong>Analytics &amp; BI Agent</strong> - Аналітика даних</li>
<li><strong>Compliance &amp; Audit Agent</strong> - Аудит та compliance</li>
</ol>
<h4 id="success">🚀 Успіх клієнтів (Success)<a class="headerlink" href="#success" title="Permanent link">&para;</a></h4>
<ol>
<li><strong>Vendor Success Agent</strong> - Менеджер успіху комітентів</li>
</ol>
<hr />
<h2 id="_4">Ролі та відповідальність агентів<a class="headerlink" href="#_4" title="Permanent link">&para;</a></h2>
<h3 id="1-greenfood-assistant">1. GREENFOOD Assistant<a class="headerlink" href="#1-greenfood-assistant" title="Permanent link">&para;</a></h3>
<p><strong>Роль</strong>: Фронтовий оркестратор<br />
<strong>Мета</strong>: Розуміти користувача, виявляти намір, делегувати завдання<br />
<strong>Ключові функції</strong>:
- Ідентифікація ролі користувача (комітент, складський, логіст, бухгалтер, маркетолог, покупець)
- Перетворення запиту на чітку дію
- Координація роботи доменних агентів
- Формування зрозумілих результатів для користувача</p>
<p><strong>Делегування</strong>: Так (може делегувати іншим агентам)</p>
<hr />
<h3 id="2-product-catalog-agent">2. Product &amp; Catalog Agent<a class="headerlink" href="#2-product-catalog-agent" title="Permanent link">&para;</a></h3>
<p><strong>Роль</strong>: Менеджер каталогу товарів<br />
<strong>Мета</strong>: Підтримувати чистий, структурований каталог без дублів<br />
<strong>Ключові функції</strong>:
- Створення та редагування карточок товарів
- Перевірка дублікатів
- Управління атрибутами (вага, склад, алергени, строк придатності)
- Управління медіа (фото, відео)</p>
<p><strong>Інструменти (TODO)</strong>:
- ProductCatalogAPI
- ImageUploadTool
- DuplicateDetectorTool</p>
<hr />
<h3 id="3-batch-quality-agent">3. Batch &amp; Quality Agent<a class="headerlink" href="#3-batch-quality-agent" title="Permanent link">&para;</a></h3>
<p><strong>Роль</strong>: Менеджер партій та якості<br />
<strong>Мета</strong>: Забезпечити трасованість партій та контроль якості<br />
<strong>Ключові функції</strong>:
- Створення та відстеження партій товарів
- Контроль строків придатності
- Управління статусами партій (на складі, в дорозі, реалізована, прострочена)
- Фіксація інцидентів якості та рекламацій</p>
<p><strong>Інструменти (TODO)</strong>:
- BatchTrackingAPI
- QualityCheckTool
- ExpiryAlertTool</p>
<hr />
<h3 id="4-vendor-success-agent">4. Vendor Success Agent<a class="headerlink" href="#4-vendor-success-agent" title="Permanent link">&para;</a></h3>
<p><strong>Роль</strong>: Менеджер успіху комітентів<br />
<strong>Мета</strong>: Швидкий запуск та зростання виробників<br />
<strong>Ключові функції</strong>:
- Onboarding нових комітентів (чеклісти, документи)
- Виявлення слабких місць (порожній каталог, відсутні фото)
- Проактивні рекомендації для покращення
- Моніторинг метрик успіху</p>
<p><strong>Інструменти (TODO)</strong>:
- VendorOnboardingAPI
- ChecklistTool
- RecommendationEngine</p>
<hr />
<h3 id="5-warehouse-agent">5. Warehouse Agent<a class="headerlink" href="#5-warehouse-agent" title="Permanent link">&para;</a></h3>
<p><strong>Роль</strong>: Начальник складу<br />
<strong>Мета</strong>: Коректні та актуальні залишки товарів<br />
<strong>Ключові функції</strong>:
- Управління залишками товарів
- Фіксація руху товарів (прихід, переміщення, відвантаження)
- Структурування складу (зони, стелажі, температурні зони)
- Сигналізація про критичні залишки</p>
<p><strong>Інструменти (TODO)</strong>:
- WarehouseAPI
- InventoryTool
- StockMovementTool
- ZoneManagementTool</p>
<hr />
<h3 id="6-logistics-delivery-agent">6. Logistics &amp; Delivery Agent<a class="headerlink" href="#6-logistics-delivery-agent" title="Permanent link">&para;</a></h3>
<p><strong>Роль</strong>: Логіст і диспетчер<br />
<strong>Мета</strong>: Мінімальні затримки та витрати на доставку<br />
<strong>Ключові функції</strong>:
- Створення маршрутів доставки
- Управління статусами доставок
- Інтеграція з перевізниками (API)
- Формування трек-номерів</p>
<p><strong>Інструменти (TODO)</strong>:
- LogisticsAPI
- DeliveryTrackerTool
- CourierIntegrationTool</p>
<hr />
<h3 id="7-seller-agent">7. Seller Agent<a class="headerlink" href="#7-seller-agent" title="Permanent link">&para;</a></h3>
<p><strong>Роль</strong>: Менеджер з продажу<br />
<strong>Мета</strong>: Допомога в оформленні замовлень та підборі товарів<br />
<strong>Ключові функції</strong>:
- Формування кошика замовлення
- Пропозиції альтернатив, апсели, крос-сели
- Перевірка можливості виконання замовлення
- Розуміння контексту клієнта (роздріб/опт, новий/постійний)</p>
<p><strong>Інструменти (TODO)</strong>:
- SalesAPI
- BasketTool
- RecommendationEngine
- PricingTool</p>
<hr />
<h3 id="8-customer-care-agent">8. Customer Care Agent<a class="headerlink" href="#8-customer-care-agent" title="Permanent link">&para;</a></h3>
<p><strong>Роль</strong>: Служба підтримки<br />
<strong>Мета</strong>: Швидко вирішувати проблеми клієнтів<br />
<strong>Ключові функції</strong>:
- Ідентифікація клієнта та його замовлення
- Відповіді на питання (статус, доставка, повернення)
- Фіксація рекламацій та причин повернень
- Пропозиція наступних кроків</p>
<p><strong>Інструменти (TODO)</strong>:
- SupportAPI
- OrderLookupTool
- ComplaintTool
- TicketingTool</p>
<hr />
<h3 id="9-finance-pricing-agent">9. Finance &amp; Pricing Agent<a class="headerlink" href="#9-finance-pricing-agent" title="Permanent link">&para;</a></h3>
<p><strong>Роль</strong>: Бухгалтер і фінансовий стратег<br />
<strong>Мета</strong>: Прозорі взаєморозрахунки та здорова економіка<br />
<strong>Ключові функції</strong>:
- Ведення балансів учасників
- Моделі ціноутворення (опт, роздріб, акції, промокоди)
- Розрахунок комісій та виплат
- Робота з токенами (DAAR/DAARION) та фіатом</p>
<p><strong>Інструменти (TODO)</strong>:
- FinanceAPI
- PricingEngine
- BalanceTool
- PayoutCalculator</p>
<hr />
<h3 id="10-smm-campaigns-agent">10. SMM &amp; Campaigns Agent<a class="headerlink" href="#10-smm-campaigns-agent" title="Permanent link">&para;</a></h3>
<p><strong>Роль</strong>: Маркетолог та контент-агент<br />
<strong>Мета</strong>: Просування товарів через цифрові канали<br />
<strong>Ключові функції</strong>:
- Створення контенту для соцмереж, розсилок, банерів
- Перевірка наявності товарів перед промо
- Планування кампаній з чіткою метою
- Честна комунікація без маніпуляцій</p>
<p><strong>Інструменти (TODO)</strong>:
- ContentGeneratorTool
- CampaignAPI
- SocialMediaTool
- ImageGeneratorTool</p>
<hr />
<h3 id="11-seo-web-experience-agent">11. SEO &amp; Web Experience Agent<a class="headerlink" href="#11-seo-web-experience-agent" title="Permanent link">&para;</a></h3>
<p><strong>Роль</strong>: SEO-оптимізатор<br />
<strong>Мета</strong>: Видимість в пошуку та зрозумілість для користувачів<br />
<strong>Ключові функції</strong>:
- Оптимізація заголовків, описів, метаданих
- Покращення структури контенту
- Використання реальних даних про товари
- Блоки довіри, FAQ, structured data</p>
<p><strong>Інструменти (TODO)</strong>:
- SEOAnalyzerTool
- MetaGeneratorTool
- ContentStructureTool</p>
<hr />
<h3 id="12-analytics-bi-agent">12. Analytics &amp; BI Agent<a class="headerlink" href="#12-analytics-bi-agent" title="Permanent link">&para;</a></h3>
<p><strong>Роль</strong>: Аналітик даних<br />
<strong>Мета</strong>: Перетворення даних на actionable insights<br />
<strong>Ключові функції</strong>:
- Формування зрозумілих звітів
- Виявлення трендів, сезонності, аномалій
- Пропозиції варіантів дій із вказанням ризиків
- Роз'яснення в простих термінах</p>
<p><strong>Інструменти (TODO)</strong>:
- AnalyticsAPI
- ReportGeneratorTool
- TrendAnalyzerTool
- ForecastingTool</p>
<hr />
<h3 id="13-compliance-audit-agent">13. Compliance &amp; Audit Agent<a class="headerlink" href="#13-compliance-audit-agent" title="Permanent link">&para;</a></h3>
<p><strong>Роль</strong>: Внутрішній аудитор<br />
<strong>Мета</strong>: Відповідність політикам та здоровій бізнес-логіці<br />
<strong>Ключові функції</strong>:
- Аналіз логів подій (зміни цін, списання, повернення)
- Виявлення ризикових операцій
- Формування попереджень та рекомендацій
- Нейтральний, фактичний стиль</p>
<p><strong>Інструменти (TODO)</strong>:
- AuditLogTool
- RiskDetectorTool
- ComplianceCheckerTool</p>
<hr />
<h2 id="crews-">Команди (Crews) для бізнес-сценаріїв<a class="headerlink" href="#crews-" title="Permanent link">&para;</a></h2>
<h3 id="1-onboard-vendor-crew">1. Onboard Vendor Crew<a class="headerlink" href="#1-onboard-vendor-crew" title="Permanent link">&para;</a></h3>
<p><strong>Мета</strong>: Запуск нового комітента (виробника)<br />
<strong>Агенти</strong>: GREENFOOD Assistant, Vendor Success, Product &amp; Catalog, Warehouse, Finance &amp; Pricing<br />
<strong>Етапи</strong>:
1. Привітання та збір інформації
2. Створення карточок товарів
3. Налаштування складу та партій
4. Налаштування фінансів та ціноутворення
5. Чекліст успішного запуску</p>
<p><strong>Виклик</strong>:</p>
<div class="codehilite"><pre><span></span><code><span class="kn">from</span><span class="w"> </span><span class="nn">services.greenfood.crew.greenfood_crews</span><span class="w"> </span><span class="kn">import</span> <span class="n">GREENFOOD_CREWS</span><span class="p">,</span> <span class="n">GREENFOOD_TASK_CREATORS</span>
<span class="n">vendor_data</span> <span class="o">=</span> <span class="p">{</span>
<span class="s2">&quot;name&quot;</span><span class="p">:</span> <span class="s2">&quot;Еко Мед Карпати&quot;</span><span class="p">,</span>
<span class="s2">&quot;products&quot;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&quot;Гірський мед&quot;</span><span class="p">,</span> <span class="s2">&quot;Мед з липи&quot;</span><span class="p">,</span> <span class="s2">&quot;Мед з акації&quot;</span><span class="p">],</span>
<span class="s2">&quot;contact&quot;</span><span class="p">:</span> <span class="s2">&quot;...&quot;</span><span class="p">,</span>
<span class="p">}</span>
<span class="n">tasks</span> <span class="o">=</span> <span class="n">GREENFOOD_TASK_CREATORS</span><span class="p">[</span><span class="s2">&quot;onboard_vendor&quot;</span><span class="p">](</span><span class="n">vendor_data</span><span class="p">)</span>
<span class="n">crew</span> <span class="o">=</span> <span class="n">GREENFOOD_CREWS</span><span class="p">[</span><span class="s2">&quot;onboard_vendor&quot;</span><span class="p">]</span>
<span class="n">crew</span><span class="o">.</span><span class="n">tasks</span> <span class="o">=</span> <span class="n">tasks</span>
<span class="n">result</span> <span class="o">=</span> <span class="n">crew</span><span class="o">.</span><span class="n">kickoff</span><span class="p">()</span>
</code></pre></div>
<hr />
<h3 id="2-fulfill-order-crew">2. Fulfill Order Crew<a class="headerlink" href="#2-fulfill-order-crew" title="Permanent link">&para;</a></h3>
<p><strong>Мета</strong>: Виконання замовлення від прийняття до доставки<br />
<strong>Агенти</strong>: GREENFOOD Assistant, Seller, Warehouse, Logistics, Customer Care, Finance &amp; Pricing<br />
<strong>Етапи</strong>:
1. Прийняття замовлення
2. Формування та підтвердження кошика
3. Резервація товарів на складі
4. Створення маршруту доставки
5. Фінансові проводки
6. Повідомлення клієнта</p>
<p><strong>Виклик</strong>:</p>
<div class="codehilite"><pre><span></span><code><span class="n">order_data</span> <span class="o">=</span> <span class="p">{</span>
<span class="s2">&quot;customer_name&quot;</span><span class="p">:</span> <span class="s2">&quot;Іван Петренко&quot;</span><span class="p">,</span>
<span class="s2">&quot;items&quot;</span><span class="p">:</span> <span class="p">[{</span><span class="s2">&quot;product_id&quot;</span><span class="p">:</span> <span class="s2">&quot;123&quot;</span><span class="p">,</span> <span class="s2">&quot;quantity&quot;</span><span class="p">:</span> <span class="mi">2</span><span class="p">}],</span>
<span class="s2">&quot;delivery_address&quot;</span><span class="p">:</span> <span class="s2">&quot;м. Львів, вул. Шевченка 1&quot;</span><span class="p">,</span>
<span class="p">}</span>
<span class="n">tasks</span> <span class="o">=</span> <span class="n">GREENFOOD_TASK_CREATORS</span><span class="p">[</span><span class="s2">&quot;fulfill_order&quot;</span><span class="p">](</span><span class="n">order_data</span><span class="p">)</span>
<span class="n">crew</span> <span class="o">=</span> <span class="n">GREENFOOD_CREWS</span><span class="p">[</span><span class="s2">&quot;fulfill_order&quot;</span><span class="p">]</span>
<span class="n">crew</span><span class="o">.</span><span class="n">tasks</span> <span class="o">=</span> <span class="n">tasks</span>
<span class="n">result</span> <span class="o">=</span> <span class="n">crew</span><span class="o">.</span><span class="n">kickoff</span><span class="p">()</span>
</code></pre></div>
<hr />
<h3 id="3-monthly-settlement-crew">3. Monthly Settlement Crew<a class="headerlink" href="#3-monthly-settlement-crew" title="Permanent link">&para;</a></h3>
<p><strong>Мета</strong>: Місячні звіряння та розрахунки<br />
<strong>Агенти</strong>: GREENFOOD Assistant, Finance &amp; Pricing, Analytics &amp; BI, Compliance &amp; Audit, Vendor Success<br />
<strong>Етапи</strong>:
1. Ініціація процесу звіряння
2. Формування аналітичних звітів
3. Розрахунок фінансових показників та актів звіряння
4. Audit та виявлення ризиків
5. Персоналізовані рекомендації комітентам</p>
<p><strong>Виклик</strong>:</p>
<div class="codehilite"><pre><span></span><code><span class="n">period_data</span> <span class="o">=</span> <span class="p">{</span>
<span class="s2">&quot;period&quot;</span><span class="p">:</span> <span class="s2">&quot;2025-11&quot;</span><span class="p">,</span>
<span class="s2">&quot;vendors&quot;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&quot;vendor_1&quot;</span><span class="p">,</span> <span class="s2">&quot;vendor_2&quot;</span><span class="p">],</span>
<span class="p">}</span>
<span class="n">tasks</span> <span class="o">=</span> <span class="n">GREENFOOD_TASK_CREATORS</span><span class="p">[</span><span class="s2">&quot;monthly_settlement&quot;</span><span class="p">](</span><span class="n">period_data</span><span class="p">)</span>
<span class="n">crew</span> <span class="o">=</span> <span class="n">GREENFOOD_CREWS</span><span class="p">[</span><span class="s2">&quot;monthly_settlement&quot;</span><span class="p">]</span>
<span class="n">crew</span><span class="o">.</span><span class="n">tasks</span> <span class="o">=</span> <span class="n">tasks</span>
<span class="n">result</span> <span class="o">=</span> <span class="n">crew</span><span class="o">.</span><span class="n">kickoff</span><span class="p">()</span>
</code></pre></div>
<hr />
<h3 id="4-marketing-campaign-crew">4. Marketing Campaign Crew (додатковий)<a class="headerlink" href="#4-marketing-campaign-crew" title="Permanent link">&para;</a></h3>
<p><strong>Мета</strong>: Запуск маркетингової кампанії<br />
<strong>Агенти</strong>: GREENFOOD Assistant, Warehouse, SMM &amp; Campaigns, SEO &amp; Web, Finance &amp; Pricing, Analytics &amp; BI<br />
<strong>Етапи</strong>:
1. Прийняття запиту на кампанію
2. Перевірка наявності товарів
3. Створення контенту
4. SEO-оптимізація посадкових сторінок
5. Налаштування цін та промокодів
6. Налаштування відстеження KPI</p>
<hr />
<h2 id="_5">Зв'язки між агентами<a class="headerlink" href="#_5" title="Permanent link">&para;</a></h2>
<h3 id="_6">Найчастіші взаємодії<a class="headerlink" href="#_6" title="Permanent link">&para;</a></h3>
<div class="codehilite"><pre><span></span><code>GREENFOOD Assistant (центральний хаб)
├── Product &amp; Catalog ←→ Batch &amp; Quality
├── Warehouse ←→ Logistics &amp; Delivery
├── Warehouse ←→ Batch &amp; Quality
├── Seller ←→ Warehouse
├── Seller ←→ Finance &amp; Pricing
├── Customer Care ←→ Logistics
├── SMM &amp; Campaigns ←→ Warehouse
├── SMM &amp; Campaigns ←→ SEO &amp; Web
├── Analytics &amp; BI ←→ (всі агенти)
├── Compliance &amp; Audit ←→ (всі агенти)
└── Vendor Success ←→ (всі агенти)
</code></pre></div>
<hr />
<h2 id="dagi-router">Інтеграція з DAGI Router<a class="headerlink" href="#dagi-router" title="Permanent link">&para;</a></h2>
<h3 id="router-configyml">Додавання в router-config.yml<a class="headerlink" href="#router-configyml" title="Permanent link">&para;</a></h3>
<div class="codehilite"><pre><span></span><code><span class="nt">agents</span><span class="p">:</span>
<span class="w"> </span><span class="nt">greenfood</span><span class="p">:</span>
<span class="w"> </span><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;GREENFOOD</span><span class="nv"> </span><span class="s">Assistant</span><span class="nv"> </span><span class="s">-</span><span class="nv"> </span><span class="s">ERP</span><span class="nv"> </span><span class="s">orchestrator&quot;</span>
<span class="w"> </span><span class="nt">default_llm</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">local_qwen3_8b</span>
<span class="w"> </span><span class="nt">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">|</span>
<span class="w"> </span><span class="no">Ти — GREENFOOD Assistant, фронтовий оркестратор ERP-системи...</span>
</code></pre></div>
<h3 id="router">Виклик через Router<a class="headerlink" href="#router" title="Permanent link">&para;</a></h3>
<div class="codehilite"><pre><span></span><code><span class="kn">from</span><span class="w"> </span><span class="nn">router_client</span><span class="w"> </span><span class="kn">import</span> <span class="n">send_to_router</span>
<span class="n">response</span> <span class="o">=</span> <span class="k">await</span> <span class="n">send_to_router</span><span class="p">({</span>
<span class="s2">&quot;mode&quot;</span><span class="p">:</span> <span class="s2">&quot;crew&quot;</span><span class="p">,</span>
<span class="s2">&quot;agent&quot;</span><span class="p">:</span> <span class="s2">&quot;greenfood&quot;</span><span class="p">,</span>
<span class="s2">&quot;message&quot;</span><span class="p">:</span> <span class="s2">&quot;Онбордь нового комітента &#39;Еко Мед Карпати&#39;&quot;</span><span class="p">,</span>
<span class="s2">&quot;metadata&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s2">&quot;scenario&quot;</span><span class="p">:</span> <span class="s2">&quot;onboard_vendor&quot;</span><span class="p">,</span>
<span class="s2">&quot;vendor_data&quot;</span><span class="p">:</span> <span class="p">{</span><span class="o">...</span><span class="p">},</span>
<span class="p">},</span>
<span class="p">})</span>
</code></pre></div>
<hr />
<h2 id="_7">Файлова структура<a class="headerlink" href="#_7" title="Permanent link">&para;</a></h2>
<div class="codehilite"><pre><span></span><code>services/greenfood/
├── __init__.py
└── crew/
├── __init__.py
├── greenfood_prompts.py # 13 системних промтів
├── greenfood_agents.py # 13 агентів
└── greenfood_crews.py # 4 crews + task creators
</code></pre></div>
<hr />
<h2 id="_8">Наступні кроки<a class="headerlink" href="#_8" title="Permanent link">&para;</a></h2>
<h3 id="1">Фаза 1: Базова інтеграція<a class="headerlink" href="#1" title="Permanent link">&para;</a></h3>
<ul>
<li>[ ] Підключити GREENFOOD Assistant до DAGI Router</li>
<li>[ ] Протестувати базовий діалог</li>
<li>[ ] Додати інструменти (tools) для агентів</li>
</ul>
<h3 id="2-api">Фаза 2: Інструменти та API<a class="headerlink" href="#2-api" title="Permanent link">&para;</a></h3>
<ul>
<li>[ ] Реалізувати ProductCatalogAPI</li>
<li>[ ] Реалізувати WarehouseAPI</li>
<li>[ ] Реалізувати FinanceAPI</li>
<li>[ ] Додати інтеграції з зовнішніми сервісами</li>
</ul>
<h3 id="3-crews-workflows">Фаза 3: Crews та workflows<a class="headerlink" href="#3-crews-workflows" title="Permanent link">&para;</a></h3>
<ul>
<li>[ ] Протестувати onboard_vendor_crew</li>
<li>[ ] Протестувати fulfill_order_crew</li>
<li>[ ] Протестувати monthly_settlement_crew</li>
<li>[ ] Додати monitoring та logging</li>
</ul>
<h3 id="4-ui-ux">Фаза 4: UI та UX<a class="headerlink" href="#4-ui-ux" title="Permanent link">&para;</a></h3>
<ul>
<li>[ ] Web-інтерфейс для комітентів</li>
<li>[ ] Дашборди для різних ролей</li>
<li>[ ] Mobile app для складських та логістів</li>
<li>[ ] Інтеграція з Telegram для швидких запитів</li>
</ul>
<hr />
<h2 id="_9">Контакти та підтримка<a class="headerlink" href="#_9" title="Permanent link">&para;</a></h2>
<p><strong>Репозиторій</strong>: <code>/Users/apple/github-projects/microdao-daarion</code><br />
<strong>Модуль</strong>: <code>services/greenfood/crew</code><br />
<strong>Версія crewAI</strong>: 0.28.0+<br />
<strong>Python</strong>: 3.11+</p>
<hr />
<p><em>Документ створено: 2025-11-18</em><br />
<em>Останнє оновлення: 2025-11-18</em></p>
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.instant", "content.code.copy"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="../../assets/javascripts/bundle.3220b9d7.min.js"></script>
</body>
</html>