jackfsuia/ShampooSalesAgent

영어 | 간체 중국어

LLM (Large Language Model, 대규모 언어 모델) 기반의

최소한의 (minimal)

샴푸 판매를 생업으로 하는 에이전트입니다. 웹(Web)에서 고객과 유창하게 대화하며, 고객의 주문을 로컬 .csv 파일에 기록합니다.

OpenAI 모델, HuggingFace 모델, Claude, Gemini, Baichuan, Qwen, Moonshot, Ernie, Glm, Deepseek을 지원합니다.

빠르게 테스트해보고 싶은 초보자, 연구자 및 비즈니스맨에게 매우 친숙합니다.

• 능동적인 (proactive) 실험적 버전은 Proactive-Sales-Agent입니다.

실행 방법

git clone https://github.com/jackfsuia/ShampooSalesAgent.git && cd ShampooSalesAgent

필수 요구 사항(gradio, openai 등)을 설치한 후, 다음을 실행합니다.

python start.py MODEL YOUR_KEY

MODEL은 gpt3.5/4, claude, gemini, baichuan, qwen, kimi, glm, deepseek이 될 수 있습니다. YOUR_KEY는 사용자의 모델 API KEY입니다. KEY가 없는 경우, 해당 모델 이름의 링크를 클릭하여 신청하거나 구매하십시오.

단, ernie를 사용하는 경우에는 다음과 같이 실행해야 합니다.

python start.py MODEL API_Key Secret_Key

API_Key와 Secret_Key는 ernie에서 정의하며, 해당 웹사이트를 참조하십시오.

그리고 huggingface 모델을 사용하는 경우, 단순히 다음을 실행하면 됩니다.

python start.py MODEL

그게 전부입니다!

웹 인터페이스 대신 CLI (Command Line Interface, 명령줄 인터페이스)를 사용하고 싶다면, start.py 대신 start_CLI.py를 사용하십시오.

기본적으로 이 에이전트는 능동적으로 샴푸를 판매합니다. 다른 제품을 판매하고 싶다면 product_description에 직접 제품 정보를 작성하십시오. 주문 정보(고객이 제공한 이름, 주소, 전화번호, 구매 수량 등)는 customer_orders.csv에 출력됩니다. 미션 프롬프트(mission prompt)를 변경하고 싶다면 normal_flow.py에 있습니다.

예를 들어, gpt-3.5-turbo를 모델로 사용하고 구매한 KEY가 sdjkSOIjkdejs라면, 다음과 같이 실행해야 합니다.

python start.py gpt-3.5-turbo sdjkSOIjkdejs

또는 짧게 (일부 모델은 짧은 이름을 가집니다)

python start.py gpt sdjkSOIjkdejs

Windows 10에서 gradio가 성공적으로 작동하려면, Windows Defender를 끄고 일부 폴더를 Defender 제외 목록에 추가해야 하는 정체불명의 파일을 다운로드해야 할 수도 있습니다.

그러면 출력 결과는 다음과 같이 나타납니다.

path\ShampooSalesAgent>python start.py gpt sdjkSOIjkdejs
채팅을 위해 다음 링크 중 하나로 이동하십시오. 두 번째 링크는 공개적으로 공유할 수 있습니다. 채팅 중에 링크가 충돌(crash)하면 채팅 페이지 하단에 있는 재시도(Retry) 버튼을 계속 클릭해 주세요. 영어를 사용해야 하는 경우, 그냥 'speak english'라고 말하면 됩니다. (请点击以下任一网址进入聊天，第二个网址可以分享给其他人。聊天的时候崩溃请点聊天框下面的Retry按钮)
...

두 링크 모두 작동합니다. 두 번째 링크만 대중에게 공유할 수 있습니다. 링크를 클릭하면 웹 페이지가 나타나며 채팅을 할 수 있습니다.

주문 정보는 CLI(Command Line Interface)에 출력됩니다.

이 공유 링크는 72시간 후에 만료됩니다. 무료 영구 호스팅 및 GPU 업그레이드를 원하시면 터미널에서 `gradio deploy`를 실행하여 Spaces(https://huggingface.co/spaces)에 배포하십시오.
2024-04-02 13:52:01.748677 <Jack Oliver><490 2nd St, Suite 300, New York><212555-1212><2 bottles><30 USD>
고객 주문 정보가 customer_orders.csv에 기록되었습니다.

그리고 customer_orders.csv 파일에도 기록됩니다. 이 .csv 파일을 열면 다음과 같은 주문 정보 행이 추가된 것을 볼 수 있습니다.

2024-04-02 13:52:01.748677,Jack Oliver,"490 2nd St, Suite 300, New York",212555-1212,2 bottles,30 USD

이 프로젝트가 마음에 드시나요? ⭐를 눌러주세요.

python order_counting.py를 실행하면

직접 확인하실 수 있습니다. 이 벤치마크(benchmark)에서 얻은 흥미로운 결과들을 우리 모두와 공유해 주세요.

• 판매에 더 전문적이고 인간처럼 더 자연스럽게 말하도록 모델을 미세 조정(Finetune)하는 것. 로봇과도(영화 her처럼) 서로 연결되어 있다는 느낌을 받게 하는 것이 중요합니다. 99%의 사람들은 복잡한 추론 기계는 아니지만, 거의 모든 사람은 인생의 어느 시점에서 우리에게 따뜻함과 지지를 느끼게 해줄 수 있습니다. - 멀티모달 (multimodal) 모델 지원. 이는 더 간단해질 수 있으며 곧 구현될 것입니다.

ShampooSalesAgent는 이 저장소의 루트 디렉토리에 있는 LICENSE 파일에 명시된 MIT 라이선스(MIT License)를 따릅니다.

이 작업이 도움이 되었다면, 다음과 같이 인용해 주시기 바랍니다:

@article{ShampooSalesAgent,
title={ShampooSalesAgent: 영업 에이전트의 빠른 배포 및 벤치마크를 위한 최소한의 LLM 영업 에이전트 프레임워크 (A minimal LLM Sales Agent Framework for Sales Agent Fast Deployment and Benchmark)},
author={Yannan Luo},
...

이 저장소는 gradio와 제가 사용해 온 무료 모델들인 baichuan, qwen, kimi, huggingface 모델의 도움을 받았습니다. 그들의 훌륭한 작업에 감사드립니다. 상상력을 열어준 gpt-3.5/4에게도 감사를 전합니다.

일부 모델은 짧은 이름을 사용합니다.

전체 이름 (Full Name)	짧은 이름 (Short Name)
gpt-3.5-turbo	gpt
...