Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Primer delovanja: Avtomatizirani CRM

Lekcija 13 od 14 Posodobljeno 2. november 2026 Razvijalec
Na tej strani
  1. CRM, ki ga poganja pogovor
  2. Simulirana baza podatkov
  3. Funkcije CRUD
  4. Specifikacije orodij JSON
  5. Usmerjanje in zanka
  6. Štirje scenariji in kaj nas učijo
  7. Prehod v produkcijo brez popolnega prepisovanja
  8. Ključne ugotovitve

CRM, ki ga poganja pogovor

Predstavljaj si CRM, kjer prodajalcem ni treba brskati po zapletenih vmesnikih. Govorijo s pomočnikom, ki samodejno ustvarja, posodablja in pridobiva stike. Točno to ti omogoča izgradnjo s klicanjem funkcij. Razlika glede na sledilnik plačil iz prejšnje lekcije je bistvena: doslej je model podatke le bral. Tu jih zapisuje, kar premakne težišče vaje k preverjanju, potrditvi in upravljanju duplikatov.

Implementiral boš pogovorni CRM z operacijami CRUD (ustvari, beri, posodobi, izbriši) na bazi podatkov o stikih.

Simulirana baza podatkov

Za to demonstracijo služi baza podatkov Pythonov slovar. Dovolj sta dva stika: ena stranka in en potencialni kupec. Ta nastavitev nam omogoča kasnejše testiranje prehoda statusa.

import json
import os
from mistralai.client import Mistral

# Baza stikov v pomnilniku (v produkciji: PostgreSQL, MongoDB itd.)
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  # Števec za nove stike

Funkcije CRUD

get_contact in search_contacts obravnavata operacije branja. Slednja sprejme argument iskalnega polja, da se izogneš ustvarjanju več skoraj identičnih funkcij. create_contact je prva funkcija, ki spreminja stanje sistema, in ponazarja pravilo, ki ga v pogovornih načinih pogosto spregledajo: preverjanja edinstvenosti morajo živeti v tvoji kodi, nikoli v pozivu, danem modelu. Nič ne preprečuje prodajalcu, da bi narekoval isti stik dvakrat; preverjanje e-pošte na začetku funkcije vrne duplicate_email z obstoječim ID-jem, kar modelu omogoča natančno razlago zavrnitve.

update_contact uporablja pristop z izbirnimi polji: spremenijo se le podana polja, funkcija pa vrne seznam tistega, kar se je dejansko spremenilo. Ta seznam ni okrasen – omogoča pomočniku, da spremembo potrdi z natančnim stavkom namesto z nejasnim „končano”.

def get_contact(contact_id: str) -> str:
    """Pridobi informacije za stik."""
    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:
    """Išče stike po imenu, podjetju ali statusu."""
    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:
    """Ustvari nov stik v CRM-u."""
    global next_id

    # Preveri, ali e-pošta že obstaja
    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:
    """Posodobi eno ali več polj obstoječega stika."""
    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"})

Parameter ensure_ascii=False, prisoten v več vrnitvah, ni kozmetična podrobnost: brez njega bi „Interested” postal niz ubežnih zaporedij Unicode v kontekstu modela, kar je manj berljivo in dražje glede na število žetonov.

Specifikacije orodij JSON

Tu večino zanesljivosti nosita dva mehanizma. enum pri status preprečuje modelu izmišljevanje vrednosti: izbrati mora med prospect, client, partner in inactive, kar ščiti celovitost tvojih podatkov brez dodatnega preverjanja. Polje required opravi preostanek z razlikovanjem med obveznimi in izbirnimi polji – za create_contact stik brez imena, e-pošte ali podjetja nima smisla, medtem ko lahko telefonska številka počaka.

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"]
            }
        }
    }
]

Usmerjanje in zanka

Ker funkcije niso odvisne od zunanjih objektov, se slovar za usmerjanje zreducira na neposredno preslikavo. Sistemsko sporočilo pa nosi dve vedenjski omejitvi, ki ju v kodi ni: vsako dejanje ustvarjanja ali posodobitve potrdi s podrobnostmi in zahtevaj manjkajoče informacije pred ustvarjanjem stika. Brez tega drugega navodila model nagiba k izpolnjevanju obveznih polj z verjetnimi vrednostmi.

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."
    }
]

Štirje scenariji in kaj nas učijo

Prvi scenarij kaže, kako model sam izbere field="company", čeprav uporabnik ni določil ničesar: shema enum je zagotovila možnosti, fraziranje vprašanja pa je opravilo preostanek. Drugi prinaša informacije v neredu, brez oznak, model pa jih pravilno razporedi med ime, e-pošto, podjetje in naziv. Tretji je najbogatejši: „Spremeni Pierre Martina v stranko” ne vsebuje ID-ja, zato mora model verižiti iskanje in nato posodobitev, ob tem pa sklepati kontekstualno opombo. Četrti nas spominja, da lahko model funkcijo nameni drugam kot njenemu dobesednemu namenu, da odgovori na vprašanje o štetju.

# Scenarij 1: Iskanje stika
chat("Find me contacts at TechCorp")
# -> Model pokliče search_contacts(query="TechCorp", field="company")
# -> "I found 1 contact at TechCorp: Marie Dupont (CT001),
#     Chief Technology Officer, status client."

# Scenarij 2: Ustvarjanje stika
chat("Add a new contact: Sophie Laurent, [email protected], "
     "DataViz, Data Scientist")
# -> Model pokliče 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."

# Scenarij 3: Posodobitev statusa
chat("Switch Pierre Martin to client, he just signed")
# -> Model najprej išče Pierre Martina, nato pokliče
#    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."

# Scenarij 4: Vprašanje brez namenske funkcije
chat("How many prospects do we have?")
# -> Model pokliče search_contacts(query="prospect", field="status")
# -> "You currently have 1 prospect: Sophie Laurent at DataViz."

Prehod v produkcijo brez popolnega prepisovanja

Slovar v pomnilniku očitno izgine, takoj ko imamo več uporabnikov. Zamenjava z resnično bazo podatkov pa zahteva dotik le ene plasti: funkcija poizveduje v ORM ali API tvojega CRM-ja in še vedno vrača isti niz JSON.

# Funkcije kličejo ORM ali API tvojega CRM-ja
def get_contact_production(contact_id: str) -> str:
    """Različica za produkcijo s 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"})

Preostanek kode – orodja, usmerjanje, pogovorna zanka – ostane identičen. To je moč te arhitekture: spremenijo se le funkcije poslovne logike, pogovorni sloj pa ostane neveden glede tvojih izbir trajnega shranjevanja.

Ključne ugotovitve

  • Klicanje funkcij spremeni LLM v naravni vmesnik za CRM
  • Operacije CRUD se neposredno preslikajo v funkcije s shemo JSON
  • Model lahko v enem pogovoru veriži iskanje in nato posodobitev
  • Arhitektura je ločena: spremeni bazo podatkov, ne da bi se dotaknil logike pogovora
  • Sistemsko sporočilo je ključno za usmerjanje modela glede potrditev in manjkajočih informacij