CAR_SHARING_README.md

Car Sharing Administration Agent

This agent helps with car sharing administration by tracking kilometers traveled and generating reports.

Features

• Record trips with starting and ending kilometer readings
• Calculate total kilometers traveled in a month
• Manage multiple users
• Parse kilometer readings from simple user input

How to Use

Recording a Trip

1. Set your user name first (if not already set)

   Please set my name as John Doe
   

2. Record a starting kilometer reading

   61520
   

   The agent will recognize this as a starting reading.

3. Record an ending kilometer reading

   64520
   

   The agent will calculate the distance traveled (3000 km in this example) and record the trip.

4. Alternatively, provide both readings at once

   I drove from 61520 to 64520
   

   The agent will parse both readings and record the trip.

Getting Statistics

To get your monthly statistics, ask something like:

How many kilometers did I travel this month?

or

Show me my trip summary for April 2023

Managing Users

You can switch between different users:

Switch to user Jane Doe

Examples of Interactions

Setting user:

User: I'm John Doe
Agent: I've set your name as John Doe. You can now record your trips.

Recording a trip:

User: 61520
Agent: I've recorded 61520 as your starting kilometer reading. Please provide an ending reading when your trip is complete.

User: 64520
Agent: I've recorded your trip:
- Starting km: 61520
- Ending km: 64520
- Distance traveled: 3000 km

Getting statistics:

User: How many kilometers did I travel this month?
Agent: You've traveled 3000 kilometers in May 2023 across 1 trip.

Technical Notes

The agent uses a SQLite database to store trip information. The database file (car_sharing.db) is created in the working directory.

User information is stored in a JSON file (car_sharing_users.json) in the working directory.