YAML конфигурация
для читаемых пайплайнов

analyst:
  role: >
    Аналитик рынка {topic}
  goal: >
    Собрать точные факты и цифры по теме {topic} с источниками
  backstory: >
    Ты дотошный аналитик с 8-летним стажем. Никогда не утверждаешь
    без подтверждения и всегда даёшь источник.

writer:
  role: >
    Редактор-копирайтер
  goal: >
    Превратить факты в ясный структурированный текст
  backstory: >
    Опытный редактор, ценит простоту и режет воду.

research_task:
  description: >
    Собери ключевые факты и цифры по теме {topic}.
  expected_output: >
    Маркированный список из 5–7 фактов с источниками.
  agent: analyst            # имя агента из agents.yaml

write_task:
  description: >
    Напиши короткий обзор по собранным фактам.
  expected_output: >
    Связный текст на 2–3 абзаца.
  agent: writer
  context:
    - research_task         # вход — результат предыдущей задачи

from crewai import Agent, Task, Crew, Process
from crewai.project import CrewBase, agent, task, crew

@CrewBase
class ContentCrew:
    """Команда: аналитик + писатель."""
    agents_config = "config/agents.yaml"     # пути к конфигам
    tasks_config = "config/tasks.yaml"

    @agent
    def analyst(self) -> Agent:
        return Agent(config=self.agents_config["analyst"])   # роль из YAML

    @agent
    def writer(self) -> Agent:
        return Agent(config=self.agents_config["writer"])

    @task
    def research_task(self) -> Task:
        return Task(config=self.tasks_config["research_task"])

    @task
    def write_task(self) -> Task:
        return Task(config=self.tasks_config["write_task"])

    @crew
    def crew(self) -> Crew:
        return Crew(agents=self.agents, tasks=self.tasks,    # авто-собранные списки
                    process=Process.sequential)

# Запуск
result = ContentCrew().crew().kickoff(inputs={"topic": "рынок электромобилей 2025"})

# {topic} в YAML подставляется при каждом запуске
crew = ContentCrew().crew()

crew.kickoff(inputs={"topic": "электромобили"})
crew.kickoff(inputs={"topic": "облачные сервисы"})
crew.kickoff(inputs={"topic": "рынок труда в IT"})
# одна конфигурация, разные входы — без правки YAML и кода

ИДЕЯ: описание команды → YAML, сборка/запуск → тонкий Python
  (принцип «разделяй конфигурацию и код»)

СТРУКТУРА (crewai create crew ):
  config/agents.yaml   — роли: role / goal / backstory
  config/tasks.yaml    — задачи: description / expected_output / agent / context
  crew.py              — @CrewBase + @agent / @task / @crew

СВЯЗЫВАНИЕ:
  ключ в YAML  ==  имя метода в коде   (совпадение по имени!)
  Agent(config=self.agents_config["analyst"])
  Task(config=self.tasks_config["research_task"])

ПЛЕЙСХОЛДЕРЫ:
  {topic} в YAML → подставляется из kickoff(inputs={"topic": ...})
  один YAML → много запусков с разными входами

ПЛЮСЫ: читаемость · правки без кода · доступно не-кодерам · git-diff

ГРАБЛИ:
  • имя в YAML = имя метода
  • YAML-отступы (пробелы, не табы); многострочно → > или |
  • плейсхолдеры должны приходить из inputs
  • в YAML — описание, НЕ логика