Projeto: Customer Support com CrewAI

Descrição (Português)

Este projeto demonstra como usar o CrewAI para automatizar o atendimento ao cliente com múltiplos agentes de IA.

Configuração do Ambiente

• O ambiente foi configurado usando uv:

  uv venv .venv
  
  uv v add crewai crewai_tools langchain_community python-dotenv
  

• A chave do LLM deve ser definida no arquivo .env com o nome:

  OPENAI_API_KEY=suachaveaqui
  

Estrutura dos Agents

• O projeto conta com dois agents:
  • support_agent: Busca informações em uma página web e monta a prévia da resposta.
  • support_quality_assurance_agent: Estrutura a resposta final em formato de e-mail para o cliente.
• Os agentes executam as tarefas em sequência.

Exemplo de Input

{
    "customer": "DeepLearningAI",
    "person": "Andrew Ng",
    "inquiry": "I need help with setting up a Crew "
               "and kicking it off, specifically "
               "how can I add memory to my crew? "
               "Can you provide guidance?"
}

Output

Olá equipe DeepLearningAI,

Obrigado por entrar em contato com sua dúvida sobre como incorporar gerenciamento de memória no framework CrewAI para aprimorar as capacidades e o desempenho dos seus agentes de IA. Estamos animados para guiá-lo nesse processo e ajudá-lo a otimizar sua Crew de forma eficaz.

Para isso, siga estes passos abrangentes:

1. Aproveitando o Framework CrewAI: Para aprimorar as capacidades e o desempenho dos seus agentes de IA, utilize o Framework CrewAI. Ele oferece uma solução Python enxuta e extremamente rápida, permitindo que desenvolvedores criem agentes autônomos para qualquer cenário. O framework é composto por Crews e Flows, otimizados para autonomia e inteligência colaborativa.

2. Entendendo os Componentes do CrewAI: a. Crew: A organização de mais alto nível no CrewAI, responsável por gerenciar equipes de agentes de IA, supervisionar fluxos de trabalho, garantir colaboração e entregar resultados. b. Agentes de IA: Membros especializados da equipe dentro da Crew, cada um com funções, ferramentas e objetivos específicos. Esses agentes podem delegar tarefas, tomar decisões autônomas e colaborar de forma eficaz. c. Processo: Um sistema de gerenciamento de fluxo de trabalho que define padrões de colaboração, controla atribuições de tarefas, gerencia interações e garante execução eficiente. d. Tarefas: Atribuições individuais com objetivos claros, ferramentas específicas e resultados acionáveis que contribuem para o objetivo geral.

3. Explorando Principais Funcionalidades de Crews e Flows: a. Agentes baseados em papéis: Crie agentes especializados com funções, expertise e objetivos definidos. b. Ferramentas flexíveis: Equipe os agentes com ferramentas e APIs personalizadas para interação com serviços externos e fontes de dados. c. Colaboração inteligente: Agentes trabalham juntos, compartilham insights e coordenam tarefas para atingir objetivos complexos. d. Gerenciamento de tarefas: Defina fluxos de trabalho sequenciais ou paralelos com tratamento automático de dependências. e. Orquestração orientada a eventos: Defina caminhos de execução precisos que respondem dinamicamente a eventos. f. Controle refinado: Gerencie estados do fluxo de trabalho e execuções condicionais de forma segura e eficiente.

4. Escolhendo entre Crews e Flows:

   • Crews: Ideais para pesquisas abertas, geração de conteúdo e tarefas colaborativas que exigem criatividade.
   • Flows: Adequados para fluxos de decisão, orquestração de APIs e cenários que exigem resultados previsíveis e controle preciso.

5. Implementando Memória no CrewAI: Ao integrar o gerenciamento de memória no framework CrewAI, você pode armazenar e recuperar informações sempre que necessário, aprimorando o conhecimento e o desempenho dos seus agentes de IA. Essa abordagem permite maior adaptabilidade, eficiência e inteligência no tratamento de tarefas complexas.

Para instruções mais detalhadas sobre como incorporar memória à sua Crew no CrewAI, consulte a documentação oficial no site https://docs.crewai.com/how-to/Creating-a-Crew-and-kick-it-off/.

Se tiver mais dúvidas ou precisar de assistência adicional, não hesite em nos contatar. Estamos comprometidos em ajudá-lo a otimizar sua Crew, potencializando-a com capacidades aprimoradas de memória.

Atenciosamente, [Representante Sênior de Suporte] Equipe de Suporte DeepLearningAI

Project: Customer Support with CrewAI

Description (English)

This project demonstrates how to use CrewAI to automate customer support with multiple AI agents.

Environment Setup

• The environment was set up using uv:

  uv venv .venv
  uv pip install crewai crewai_tools langchain_community python-dotenv
  

  Or, to add packages individually:

  uv v add crewai crewai_tools langchain_community python-dotenv
  

• The LLM key must be set in the .env file as:

  OPENAI_API_KEY=yourkeyhere
  

Agents Structure

• The project has two agents:
  • support_agent: Searches for information on a web page and drafts the initial response.
  • support_quality_assurance_agent: Structures the final response as an email to the customer.
• The agents execute their tasks in sequence.

Example Input

{
    "customer": "DeepLearningAI",
    "person": "Andrew Ng",
    "inquiry": "I need help with setting up a Crew "
               "and kicking it off, specifically "
               "how can I add memory to my crew? "
               "Can you provide guidance?"
}

Output

Hello DeepLearningAI Team,

Thank you for reaching out with your inquiry regarding incorporating memory management within the CrewAI framework to enhance the capabilities and performance of your AI agents. We are excited to guide you through this process to help you optimize your Crew effectively.

To achieve this, follow these comprehensive steps:

1. Leveraging the CrewAI Framework: To enhance the capabilities and performance of your AI agents, utilize the CrewAI Framework. This framework offers a lean and lightning-fast Python solution that enables developers to create autonomous AI agents tailored to any scenario. It consists of Crews and Flows designed to optimize for autonomy and collaborative intelligence.

2. Understanding the Components of CrewAI: a. Crew: The top-level organization in CrewAI that manages AI agent teams, oversees workflows, ensures collaboration, and delivers outcomes. b. AI Agents: Specialized team members within the Crew, each having specific roles, tools, and goals. These agents can delegate tasks, make autonomous decisions, and collaborate effectively. c. Process: A workflow management system that defines collaboration patterns, controls task assignments, manages interactions, and ensures efficient execution. d. Tasks: Individual assignments with clear objectives, specific tools, and actionable results that contribute to achieving the overall goal.

3. Exploring Key Features of Crews and Flows: a. Role-Based Agents: Create specialized agents with defined roles, expertise, and goals. b. Flexible Tools: Equip agents with custom tools and APIs for seamless interaction with external services and data sources. c. Intelligent Collaboration: Agents work together, share insights, and coordinate tasks to achieve complex objectives. d. Task Management: Define sequential or parallel workflows with automatic handling of task dependencies. e. Event-Driven Orchestration: Define precise execution paths responding dynamically to events. f. Fine-Grained Control: Manage workflow states and conditional execution securely and efficiently.

4. Choosing Between Crews and Flows:

   • Crews: Ideal for open-ended research, content generation, and collaborative tasks that demand creative thinking.
   • Flows: Suitable for decision workflows, API orchestration, and scenarios necessitating predictable outcomes and precise control.

5. Implementing Memory in CrewAI: By integrating memory management within the CrewAI framework, you can store and retrieve information whenever required, enhancing the knowledge and performance of your AI agents. This approach enables greater adaptability, efficiency, and intelligence in handling complex tasks.

For more detailed instructions on how to incorporate memory within your Crew in crewAI, please refer to the official documentation provided on the CrewAI website at https://docs.crewai.com/how-to/Creating-a-Crew-and-kick-it-off/.

Should you have any further questions or require additional assistance, please do not hesitate to reach out to us. We are committed to supporting you in optimizing your Crew by empowering it with enhanced memory capabilities.

Best Regards, [Senior Support Representative] DeepLearningAI Support Team

Projeto feito com CrewAI / Project made with CrewAI