CrewAI 排版配置指南

为什么排版配置如此重要？

在使用 CrewAI 构建智能代理系统时，排版配置的位置直接影响代码的可读性和可维护性。明智的配置安排可以使代码逻辑更清晰，同时提高开发效率。

使用CrewAI时，排版要求是放在agents配置中好，还是放在对应的task配置中好？

1 在 Agents 配置中设置排版要求

将排版要求放在agent的配置中，意味着这些要求将成为代理的固有特性。

2 在 Task 配置中设置排版要求

将排版要求放在具体任务的配置中，使每个任务可以有独特的格式需求。

1. 基础排版风格放在 Agents 配置中

在agent配置中定义通用的排版要求，如字体、基本布局风格和品牌标识等。这确保了所有输出的基本一致性。

2. 特定格式要求放在 Tasks 配置中

在任务配置中添加针对该任务独特的排版要求，如特定内容的展示方式、专业术语的格式等，这些会覆盖或补充基础样式。

3. 使用配置继承简化代码

创建一个格式配置库，允许在不同级别引用和扩展配置，避免代码重复，同时保持灵活性和一致性。

# Agent 配置中的基础排版设置
formatting_base = """
- 使用中文回答
- 保持简洁清晰的格式
- 段落间留有适当空白
"""

# 创建代理
researcher = Agent(
    role="研究员",
    goal="提供深入研究和分析",
    backstory="专业研究人员，擅长数据分析",
    formatting=formatting_base,  # 基础排版应用于所有任务
)

# Task 配置中的特定排版需求
report_task = Task(
    description="分析市场趋势并生成报告",
    agent=researcher,
    # 特定任务的额外排版要求
    formatting="""
    - 使用表格展示核心数据
    - 每个部分使用明确的标题
    - 关键结论用粗体标记
    """
)

在实际项目中，应根据团队规模和项目复杂度选择适合的配置方案。核心原则是平衡一致性与灵活性。