Pavyzdys: Automatizuota CRM
Šiame puslapyje
Pokalbiais grindžiama CRM
Įsivaizduok CRM sistemą, kurioje pardavimų atstovams nebereikia naršyti sudėtingose sąsajose. Jie tiesiog kalbasi su asistentu, kuris automatiškai kuria, atnaujina ir suranda kontaktus. Būtent tai leidžia sukurti funkcijų iškvietimas. Skirtumas nuo ankstesnėje pamokoje nagrinėto mokėjimų seklio yra didelis: iki šiol modelis tik skaitė duomenis. Čia jis duomenis ir rašo, todėl pratimo akcentas persikelia į validavimą, patvirtinimą ir dublikatų valdymą.
Įgyvendinsi pokalbiais grindžiamą CRM su CRUD (Create, Read, Update, Delete) operacijomis kontaktų duomenų bazėje.
Simuliuojama duomenų bazė
Šiai demonstracijai duomenų bazei naudojamas Python žodynas. Pakanka dviejų kontaktų: vieno kliento ir vieno potencialaus kliento. Tokia sąranka leis vėliau pamokoje ištestuoti būsenos keitimą.
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 funkcijos
get_contact ir search_contacts tvarko skaitymo operacijas. Pastaroji priima paieškos lauko argumentą, kad nereikėtų kurti kelių beveik identiškų funkcijų. create_contact yra pirmoji funkcija, keičianti sistemos būseną, ir ji iliustruoja taisyklę, pokalbių režimuose dažnai pamirštamą: unikalumo patikros turi būti tavo kode, niekada – modeliuui pateiktame prompte. Niekas neužkerta kelio pardavimų atstovui diktuoti tą patį kontaktą du kartus; el. pašto patikra funkcijos pradžioje grąžina duplicate_email su esamu ID, leisdamas modeliui tiksliai paaiškinti atsisakymą.
update_contact naudoja opcioninių laukų principą: keičiami tik pateikti laukai, o funkcija grąžina sąrašą to, kas iš tikrųjų pasikeitė. Šis sąrašas nėra dekoracija – jis leidžia asistentui patvirtinti pakeitimą tiksliu sakiniu, o ne miglotu „atlikta“.
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"})
Parametras ensure_ascii=False, naudojamas keliuose grąžinamuose rezultatuose, nėra kosmetinė detalė: be jo žodis „Interested“ modelio kontekste virsta Unicode escape sekų eilute, kuri yra mažiau skaitoma ir brangesnė tokenais.
JSON įrankių specifikacijos
Didžiąją dalį patikimumo čia užtikrina du mechanizmai. enum laukui status neleidžia modeliui išgalvoti reikšmių: jis turi rinktis iš prospect, client, partner ir inactive, taip apsaugodamas duomenų vientisumą be papildomo validavimo. required masyvas atlieka likusį darbą, atskirdamas privalomus laukus nuo opcioninių – create_contact atveju kontaktas be vardo, el. pašto ar įmonės neturi prasmės, tuo tarpu telefono numerį galima pridėti vėliau.
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"]
}
}
}
]
Maršrutizavimas ir ciklas
Kadangi funkcijos nepriklauso nuo jokių išorinių objektų, maršrutizavimo žodynas sumažėja iki tiesioginio susiejimo. Tačiau sistemos žinutėje yra du elgesio apribojimai, kurių nėra kode: patvirtinti kiekvieną kūrimo ar atnaujinimo veiksmą su detalėmis ir prašyti trūkstamos informacijos prieš kuriant kontaktą. Be šios antrosios instrukcijos modelis linkęs privalomus laukus užpildyti tikėtinomis reikšmėmis.
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."
}
]
Keturi scenarijai ir jų pamokos
Pirmasis scenarijus rodo, kaip modelis savarankiškai pasirenka field="company", nors vartotojas nieko nenurodė: schema enum pateikė opcijas, o klausimo formuluotė atliko likusį darbą. Antrasis pateikia informaciją sumaišytai, be etikečių, ir modelis teisingai paskirsto ją tarp vardo, el. pašto, įmonės ir pareigų. Trečiasis yra turtingiausias: frazėje „Pakeisk Pierre Martin į klientą, jis ką tik pasirašė“ nėra ID, todėl modelis turi sujungti paiešką ir atnaujinimą, kartu išvesdamas kontekstinę pastabą. Ketvirtasis primena, kad modelis gali panaudoti funkciją ne tiesioginei paskirčiai, kad atsakytų į skaičiavimo klausimą.
# 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."
Perėjimas į gamybą neperrašant visko
Akivaizdu, kad atmintyje laikomas žodynas išnyksta, kai atsiranda keli vartotojai. Tačiau jo pakeitimas tikra duomenų baze reikalauja keisti tik vieną sluoksnį: funkcija kreipiasi į tavo CRM ORM arba API ir vis tiek grąžina tą pačią JSON eilutę.
# 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"})
Likusi kodo dalis – įrankiai, maršrutizavimas, pokalbių ciklas – lieka identiška. Tai ir yra šios architektūros stiprybė: keičiasi tik verslo logikos funkcijos, o pokalbių sluoksnis lieka nežinantis tavo duomenų išsaugojimo sprendimų.
Svarbiausi punktai
- Funkcijų iškvietimas paverčia LLM natūralia sąsaja CRM sistemai
- CRUD operacijos tiesiogiai atitinka funkcijas su JSON Schema
- Modelis gali grandininėti paiešką ir atnaujinimą vieno pokalbio metu
- Architektūra yra atsieta: keisk duomenų bazę neliesdamas pokalbių logikos
- Sistemos žinutė yra kritiškai svarbi nukreipiant modelį dėl patvirtinimų ir trūkstamos informacijos