Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Παράδειγμα Εφαρμογής: Αυτοματοποιημένο CRM

Μάθημα 13 / 14 Ενημερώθηκε 2 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Ένα CRM Οδηγούμενο από Συνομιλία
  2. Η Προσομοιωμένη Βάση Δεδομένων
  3. Οι Συναρτήσεις CRUD
  4. Προδιαγραφές Εργαλείων JSON
  5. Διανομή και Βρόχος
  6. Τέσσερα Σενάρια και Τι Διδάσκουν
  7. Μετάβαση στην Παραγωγή Χωρίς Επανασυγγραφή
  8. Βασικά σημεία

Ένα CRM Οδηγούμενο από Συνομιλία

Φανταστείτε ένα CRM όπου οι πωλητές δεν χρειάζεται πλέον να πλοηγούνται σε πολύπλοκες διεπαφές. Μιλούν σε έναν βοηθό που δημιουργεί, ενημερώνει και ανακτά αυτόματα επαφές. Αυτό ακριβώς σας επιτρέπει να χτίσετε η κλήση συναρτήσεων (function calling). Η διαφορά από τον ιχνηλάτη πληρωμών του προηγούμενου μαθήματος είναι σημαντική: μέχρι τώρα, το μοντέλο μόνο διάβαζε δεδομένα. Εδώ, γράφει δεδομένα, γεγονός που μετατοπίζει την εστίαση της άσκησης προς την επικύρωση, την επιβεβαίωση και τη διαχείριση διπλοτύπων.

Θα υλοποιήσετε ένα συνομιλιακό CRM με λειτουργίες CRUD (Δημιουργία, Ανάγνωση, Ενημέρωση, Διαγραφή) σε μια βάση δεδομένων επαφών.

Η Προσομοιωμένη Βάση Δεδομένων

Ένα λεξικό Python λειτουργεί ως βάση δεδομένων για αυτή την επίδειξη. Δύο επαφές είναι επαρκείς: ένας πελάτης και ένας υποψήφιος πελάτης. Αυτή η ρύθμιση μας επιτρέπει να δοκιμάσουμε μια μετάβαση κατάστασης αργότερα στο μάθημα.

import json
import os
from mistralai.client import Mistral

# In-memory contact database (in production: PostgreSQL, MongoDB, etc.)
contacts_db = {
    "CT001": {
        "name": "Marie Dupont",
        "email": "[email protected]",
        "company": "TechCorp",
        "role": "Chief Technology Officer",
        "phone": "+33 6 12 34 56 78",
        "status": "client",
        "notes": "Interested in the enterprise solution"
    },
    "CT002": {
        "name": "Pierre Martin",
        "email": "[email protected]",
        "company": "StartupIO",
        "role": "CEO",
        "phone": "+33 6 98 76 54 32",
        "status": "prospect",
        "notes": "Meeting scheduled for April"
    }
}

next_id = 3  # Counter for new contacts

Οι Συναρτήσεις CRUD

Οι get_contact και search_contacts διαχειρίζονται τις λειτουργίες ανάγνωσης. Η τελευταία δέχεται ένα όρισμα πεδίου αναζήτησης για να αποφευχθεί η δημιουργία πολλαπλών, σχεδόν πανομοιότυπων συναρτήσεων. Η create_contact είναι η πρώτη συνάρτηση που τροποποιεί την κατάσταση του συστήματος και illustrates έναν κανόνα που συχνά παραβλέπεται στις συνομιλιακές λειτουργίες: οι έλεγχοι μοναδικότητας πρέπει να υπάρχουν στον κώδικά σας, ποτέ στο prompt που δίνεται στο μοντέλο. Τίποτα δεν εμποδίζει έναν πωλητή να υπαγορεύσει την ίδια επαφή δύο φορές· ο έλεγχος email στην αρχή της συνάρτησης επιστρέφει duplicate_email με το υπάρχον ID, επιτρέποντας στο μοντέλο να εξηγήσει την άρνηση με ακρίβεια.

Η update_contact χρησιμοποιεί μια προσέγγιση προαιρετικών πεδίων: τροποποιούνται μόνο τα παρεχόμενα πεδία και η συνάρτηση επιστρέφει μια λίστα με αυτά που πραγματικά άλλαξαν. Αυτή η λίστα δεν είναι διακοσμητική· επιτρέπει στον βοηθό να επιβεβαιώσει την τροποποίηση με μια ακριβή πρόταση αντί για ένα αόριστο «έγινε».

def get_contact(contact_id: str) -> str:
    """Retrieves information for a contact."""
    if contact_id in contacts_db:
        contact = contacts_db[contact_id].copy()
        contact["contact_id"] = contact_id
        return json.dumps(contact, ensure_ascii=False)
    return json.dumps({"error": f"Contact {contact_id} not found"})


def search_contacts(query: str, field: str = "name") -> str:
    """Searches for contacts by name, company, or status."""
    results = []
    for cid, contact in contacts_db.items():
        if field in contact and query.lower() in contact[field].lower():
            entry = contact.copy()
            entry["contact_id"] = cid
            results.append(entry)

    if results:
        return json.dumps({"results": results, "count": len(results)},
                          ensure_ascii=False)
    return json.dumps({"results": [], "count": 0,
                        "message": f"No contact found for '{query}' in '{field}'"})


def create_contact(name: str, email: str, company: str,
                   role: str = "", phone: str = "",
                   status: str = "prospect", notes: str = "") -> str:
    """Creates a new contact in the CRM."""
    global next_id

    # Check if email already exists
    for cid, contact in contacts_db.items():
        if contact["email"].lower() == email.lower():
            return json.dumps({
                "error": "duplicate_email",
                "message": f"A contact with this email already exists: {cid}"
            })

    contact_id = f"CT{next_id:03d}"
    next_id += 1

    contacts_db[contact_id] = {
        "name": name,
        "email": email,
        "company": company,
        "role": role,
        "phone": phone,
        "status": status,
        "notes": notes
    }

    return json.dumps({
        "success": True,
        "contact_id": contact_id,
        "message": f"Contact {name} created with ID {contact_id}"
    }, ensure_ascii=False)


def update_contact(contact_id: str, **fields) -> str:
    """Updates one or more fields of an existing contact."""
    if contact_id not in contacts_db:
        return json.dumps({"error": f"Contact {contact_id} not found"})

    updated_fields = []
    for key, value in fields.items():
        if key in contacts_db[contact_id]:
            contacts_db[contact_id][key] = value
            updated_fields.append(key)

    if updated_fields:
        return json.dumps({
            "success": True,
            "contact_id": contact_id,
            "updated_fields": updated_fields,
            "message": f"Contact {contact_id} updated: {', '.join(updated_fields)}"
        }, ensure_ascii=False)

    return json.dumps({"error": "No valid fields to update"})

Η παράμετρος ensure_ascii=False που υπάρχει σε πολλές επιστροφές δεν είναι λεπτομέρεια αισθητικής: χωρίς αυτήν, το «Interested» μετατρέπεται σε μια σειρά ακολουθιών διαφυγής Unicode στο πλαίσιο του μοντέλου, κάτι που είναι λιγότερο ευανάγνωστο και πιο ακριβό σε tokens.

Προδιαγραφές Εργαλείων JSON

Δύο μηχανισμοί εξασφαλίζουν εδώ την αξιοπιστία. Το enum στο status εμποδίζει το μοντέλο να επινοήσει τιμές: πρέπει να επιλέξει ανάμεσα σε prospect, client, partner και inactive, προστατεύοντας την ακεραιότητα των δεδομένων σας χωρίς πρόσθετη επικύρωση. Ο πίνακας required κάνει τα υπόλοιπα, διαχωρίζοντας τα υποχρεωτικά από τα προαιρετικά πεδία· για την create_contact, μια επαφή χωρίς όνομα, email ή εταιρεία δεν έχει νόημα, ενώ ένας αριθμός τηλεφώνου μπορεί να προστεθεί αργότερα.

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_contact",
            "description": "Retrieves all information for a contact by ID",
            "parameters": {
                "type": "object",
                "properties": {
                    "contact_id": {
                        "type": "string",
                        "description": "Contact ID (e.g., CT001)"
                    }
                },
                "required": ["contact_id"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "search_contacts",
            "description": "Searches for contacts by name, company, or status",
            "parameters": {
                "type": "object",
                "properties": {
                    "query": {
                        "type": "string",
                        "description": "Search term"
                    },
                    "field": {
                        "type": "string",
                        "enum": ["name", "company", "status", "role"],
                        "description": "Field to search in (default: name)"
                    }
                },
                "required": ["query"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "create_contact",
            "description": "Creates a new contact in the CRM",
            "parameters": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "description": "Full name of the contact"
                    },
                    "email": {
                        "type": "string",
                        "description": "Email address of the contact"
                    },
                    "company": {
                        "type": "string",
                        "description": "Company name"
                    },
                    "role": {
                        "type": "string",
                        "description": "Job title or function within the company"
                    },
                    "phone": {
                        "type": "string",
                        "description": "Phone number"
                    },
                    "status": {
                        "type": "string",
                        "enum": ["prospect", "client", "partner", "inactive"],
                        "description": "Contact status"
                    },
                    "notes": {
                        "type": "string",
                        "description": "Free-form notes about the contact"
                    }
                },
                "required": ["name", "email", "company"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "update_contact",
            "description": "Updates information for an existing contact",
            "parameters": {
                "type": "object",
                "properties": {
                    "contact_id": {
                        "type": "string",
                        "description": "ID of the contact to modify (e.g., CT001)"
                    },
                    "name": {"type": "string", "description": "New name"},
                    "email": {"type": "string", "description": "New email"},
                    "company": {"type": "string", "description": "New company"},
                    "role": {"type": "string", "description": "New job title"},
                    "phone": {"type": "string", "description": "New phone number"},
                    "status": {
                        "type": "string",
                        "enum": ["prospect", "client", "partner", "inactive"],
                        "description": "New status"
                    },
                    "notes": {"type": "string", "description": "New notes"}
                },
                "required": ["contact_id"]
            }
        }
    }
]

Διανομή και Βρόχος

Επειδή οι συναρτήσεις δεν εξαρτώνται από εξωτερικά αντικείμενα, το λεξικό διανομής (dispatch) μειώνεται σε μια άμεση αντιστοίχιση. Το μήνυμα συστήματος, ωστόσο, μεταφέρει δύο συμπεριφορικούς περιορισμούς που απουσιάζουν από τον κώδικα: επιβεβαιώστε κάθε ενέργεια δημιουργίας ή ενημέρωσης με λεπτομέρειες και ζητήστε τις ελλείπουσες πληροφορίες πριν δημιουργήσετε μια επαφή. Χωρίς αυτή τη δεύτερη οδηγία, το μοντέλο τείνει να συμπληρώνει τα απαιτούμενα πεδία με πιθανές τιμές.

available_functions = {
    "get_contact": get_contact,
    "search_contacts": search_contacts,
    "create_contact": create_contact,
    "update_contact": update_contact,
}

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
model = "mistral-large-latest"

messages = [
    {
        "role": "system",
        "content": "You are a CRM assistant. You help sales reps "
                   "manage their contacts. Respond in English. "
                   "When you create or modify a contact, confirm "
                   "the action with details. Request missing "
                   "information before creating a contact."
    }
]

Τέσσερα Σενάρια και Τι Διδάσκουν

Το πρώτο σενάριο δείχνει το μοντέλο να επιλέγει μόνο του field="company", παρόλο που ο χρήστης δεν καθόρισε τίποτα: το enum του σχήματος παρείχε τις επιλογές και η διατύπωση της ερώτησης έκανε τα υπόλοιπα. Το δεύτερο παρέχει πληροφορίες με αταξία, χωρίς ετικέτες, και το μοντέλο τις κατανέμει σωστά μεταξύ ονόματος, email, εταιρείας και τίτλου. Το τρίτο είναι το πλουσιότερο: η φράση «Μετατρέψτε τον Pierre Martin σε πελάτη, μόλις υπέγραψε» δεν περιέχει ID, οπότε το μοντέλο πρέπει να αλυσοδετήσει μια αναζήτηση και μετά μια ενημέρωση, συμπεραίνοντας παράλληλα τη σχετική σημείωση. Το τέταρτο μας θυμίζει ότι το μοντέλο μπορεί να επαναχρησιμοποιήσει μια συνάρτηση από την κυριολεκτική της χρήση για να απαντήσει σε μια ερώτηση καταμέτρησης.

# Scenario 1: Search for a contact
chat("Find me contacts at TechCorp")
# -> The model calls search_contacts(query="TechCorp", field="company")
# -> "I found 1 contact at TechCorp: Marie Dupont (CT001),
#     Chief Technology Officer, status client."

# Scenario 2: Create a contact
chat("Add a new contact: Sophie Laurent, [email protected], "
     "DataViz, Data Scientist")
# -> The model calls create_contact(name="Sophie Laurent",
#     email="[email protected]", company="DataViz", role="Data Scientist")
# -> "Contact created successfully! Sophie Laurent (CT003) has been added
#     as a prospect at DataViz."

# Scenario 3: Update a status
chat("Switch Pierre Martin to client, he just signed")
# -> The model first searches for Pierre Martin, then calls
#    update_contact(contact_id="CT002", status="client",
#                   notes="Contract signed in April 2026")
# -> "Pierre Martin (CT002) is now marked as a client.
#     I added a note about the contract signature."

# Scenario 4: Question without a dedicated function
chat("How many prospects do we have?")
# -> The model calls search_contacts(query="prospect", field="status")
# -> "You currently have 1 prospect: Sophie Laurent at DataViz."

Μετάβαση στην Παραγωγή Χωρίς Επανασυγγραφή

Το λεξικό στη μνήμη προφανώς εξαφανίζεται μόλις υπάρχουν πολλοί χρήστες. Η αντικατάστασή του με μια πραγματική βάση δεδομένων, ωστόσο, απαιτεί άγγιγμα μόνο ενός επιπέδου: η συνάρτηση καλεί το ORM ή το API του CRM σας και επιστρέφει ακόμα την ίδια συμβολοσειρά JSON.

# Functions call your CRM's ORM or API
def get_contact_production(contact_id: str) -> str:
    """Production version with PostgreSQL."""
    contact = db.session.query(Contact).filter_by(id=contact_id).first()
    if contact:
        return json.dumps(contact.to_dict(), ensure_ascii=False)
    return json.dumps({"error": f"Contact {contact_id} not found"})

Το υπόλοιπο του κώδικα—εργαλεία, διανομή, βρόχος συνομιλίας—παραμένει ίδιο. Αυτή είναι η δύναμη αυτής της αρχιτεκτονικής: αλλάζουν μόνο οι συναρτήσεις επιχειρηματικής λογικής και το συνομιλιακό επίπεδο παραμένει unaware των επιλογών σας για την επιμονή δεδομένων.

Βασικά σημεία

  • Η κλήση συναρτήσεων μετατρέπει ένα LLM σε μια φυσική διεπαφή για ένα CRM
  • Οι λειτουργίες CRUD αντιστοιχούν άμεσα σε συναρτήσεις με JSON Schema
  • Το μοντέλο μπορεί να αλυσοδετήσει αναζήτηση και μετά ενημέρωση μέσα σε μια μόνο συνομιλία
  • Η αρχιτεκτονική είναι αποσυζευγμένη: αλλάξτε τη βάση δεδομένων χωρίς να αγγίξετε τη λογική συνομιλίας
  • Το μήνυμα συστήματος είναι κρίσιμο για την καθοδήγηση του μοντέλου σχετικά με τις επιβεβαιώσεις και τις ελλείπουσες πληροφορίες