为什么值得关注

它展示了使用现代 PHP 栈构建 AI 销售代理的完整方案，集成了 LLM 可观测性（Langfuse）和长期记忆（Mem0），为开发者提供了实用参考。

适合谁使用

探索 AI 代理集成的 Laravel 开发者
构建 AI 驱动的销售或 CRM 工具的开发者
学习流式代理和记忆模式的团队
跟随配套视频课程的学习者或讲师

典型使用场景

原型化一个利用 CRM 数据处理客户咨询的 AI 销售代理
学习将 CRM 管道和阶段镜像到本地模型以提供 AI 上下文
在 Laravel 应用中演示代理可观测性和记忆功能
用作 AI 代理开发工作坊或课程的教学材料

项目优势

使用 Beer and Code Harness 实现模块化代理设计（技能、钩子、命令）
通过 Langfuse 内置 LLM 可观测性，支持追踪、成本评估和评价
集成 Mem0 提供长期记忆，确保代理上下文持久化
采用现代 Laravel 栈（13、Livewire 4、Sail、Pest、PHPStan），保证代码质量

使用前须知

仅支持 Pipedrive 作为 CRM 驱动，其他 CRM 需要自定义开发
需要外部 API 密钥（Langfuse、Mem0）和基础设施（Docker、队列）
设计为实验室/演示项目，未针对生产环境加固（例如仅依赖魔法链接认证）

README 快速开始

Lab Agent Seller

Aplicação Laravel 13 + Livewire 4 que demonstra um agente de vendas com IA. Empresas conectam um CRM (driver Pipedrive), um job em fila (ScanCrmConnection) espelha pipelines/stages/campos/pessoas/deals para modelos locais, clientes entram via magic link (guard auth:client) e conversam com o agente de vendas streaming SellerAgent (laravel/ai).

Repositórios e ferramentas usados

Projeto	Descrição	Link
Beer and Code Harness	Harness de agentes (skills, hooks, comandos e guidelines) usado no projeto	https://github.com/beerandcodeteam/beer-and-code-harness
Langfuse	Observabilidade de LLM (traces, custos, avaliações)	https://github.com/langfuse/langfuse
Mem0	Camada de memória de longo prazo para o agente	https://github.com/mem0ai/mem0

Pacotes de integração:

Langfuse — via axyr/laravel-langfuse (região US, projeto ai-lab).
Mem0 — via API HTTP (MEM0_API_KEY, MEM0_BASE_URL, MEM0_TIMEOUT no .env).

Aulas

Slides gravados neste repositório:

Aula 1 — slides-da-aula/aula-dia-1/index.html
Aula 2 — slides-da-aula/aula-dia-2/aula.html

Abra os arquivos .html direto no navegador.

Stack

PHP 8.5 · Laravel 13 · Livewire 4
laravel/ai (agente streaming)
Laravel Sail (Docker) · PostgreSQL 18 · Redis · Mailpit
Pest 4 · Larastan (PHPStan nível 7) · Pint
Tailwind CSS v4 · Vite

Setup do ambiente

Pré-requisitos: Docker, Composer 2, Node 22 + npm.

# 1. Clonar
git clone git@github.com:beerandcodeteam/lab-agent-seller.git
cd lab-agent-seller

# 2. Instalar deps PHP (necessário pra ter o binário do Sail)
composer install

# 3. Subir os containers (laravel.test PHP 8.5, pgsql 18, redis, mailpit)
vendor/bin/sail up -d

# 4. Setup completo: copia .env, key:generate, migrate --force, npm install, npm run build
vendor/bin/sail composer setup

# 5. Configurar chaves de API no .env
#    MEM0_API_KEY=...          (Mem0)
#    LANGFUSE_PUBLIC_KEY=...    (Langfuse - região US)
#    LANGFUSE_SECRET_KEY=...

Levantar o projeto

# Sobe os containers (se ainda não estiverem no ar)
vendor/bin/sail up -d

# Inicia os processos de desenvolvimento (servidor, queue, vite, logs)
vendor/bin

lab-agent-seller