alexandrupascutkw/tkw-sales-agent-langgraph-api

Langgraph销售代理API镜像文档

镜像概述

本镜像基于Langgraph框架构建，专为销售代理应用提供API服务。Langgraph是一个用于构建状态ful、多智能体协作应用的框架，本镜像针对销售场景优化，提供构建智能销售代理所需的核心接口，支持销售流程自动化、客户交互处理、销售任务管理等功能。

核心功能与特性

核心功能

• 销售流程编排：通过Langgraph的状态管理和流程控制能力，定义标准化销售流程（如需求分析→方案推荐→跟进转化）
• 客户交互处理：提供接口接收客户咨询、自动生成销售话术、分析客户需求
• 多智能体协作：支持销售助理、产品专家等多角色智能体协同响应客户需求
• 销售任务管理：自动创建跟进任务、设置任务优先级、跟踪任务完成状态

关键特性

• 状态持久化：支持销售对话状态、客户信息、任务进度的持久化存储
• 可扩展性：提供插件机制，支持集成第三方CRM系统、销售数据分析工具
• 灵活配置：支持通过环境变量配置模型参数、流程规则、接口权限
• 高可用性：基于FastAPI构建，支持异步请求处理，满足高并发场景需求

使用场景与适用范围

适用场景

• 电商平台销售助手：自动响应客户商品咨询，推荐相关产品，引导下单
• 企业客户销售跟进：针对B2B场景，自动分析客户需求，生成定制化方案，安排销售跟进
• 销售团队效率工具：为销售团队自动创建跟进任务，整理客户沟通记录，生成销售报表
• 客户服务销售引导：在客户服务流程中识别销售机会，自动引导客户完成购买决策

适用用户

• 企业开发者：需快速构建智能销售代理功能的开发团队
• 销售技术团队：需要集成智能销售能力到现有CRM/ERP系统的技术人员
• 创业公司：资源有限但需快速部署智能销售工具的小型企业

使用方法与配置说明

基础使用

Docker运行命令

bash
docker run -d -p 8000:8000 \
  --name langgraph-sales-api \
  -e API_PORT=8000 \
  -e LLM_MODEL="gpt-4" \
  -e DB_CONNECTION="sqlite:///sales.db" \
  docker.xuanyuan.run/langgraph-sales-agent-api:latest

Docker Compose配置示例

yaml
version: '3'
services:
  sales-api:
    image: docker.xuanyuan.run/langgraph-sales-agent-api:latest
    ports:
      - "8000:8000"
    environment:
      - API_PORT=8000
      - LLM_MODEL="gpt-4"
      - DB_CONNECTION="postgresql://user:password@db:5432/sales"
      - LOG_LEVEL="INFO"
    depends_on:
      - db
  db:
    image: docker.xuanyuan.run/postgres:14
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=sales
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

环境变量配置

接口调用示例

1. 创建销售对话

bash
curl -X POST http://localhost:8000/conversations \
  -H "Content-Type: application/json" \
  -d '{"customer_id": "cust_123", "initial_query": "请问这款产品的企业版有什么功能？"}'

2. 获取销售任务列表

bash
curl -X GET http://localhost:8000/tasks?customer_id=cust_123

扩展与集成

第三方集成

• CRM集成：通过环境变量CRM_API_URL和CRM_API_KEY配置，支持同步客户数据到Salesforce、HubSpot等CRM系统
• 消息渠道集成：支持通过Webhook配置，接收来自微信、企业微信、Slack等渠道的客户消息

自定义流程

通过挂载配置文件自定义销售流程：

bash
docker run -v ./custom_flow.yaml:/app/flows/sales_flow.yaml \
  docker.xuanyuan.run/langgraph-sales-agent-api:latest

配置文件格式参考Langgraph官方流程定义规范。