Sampla Oibre: CRM Uathoibrithe
Ar an leathanach seo
CRM Tiomáinte ag Comhrá
Samhlaigh CRM nach gá do ionadaithe díolacháin aon idirghabháil chasta a dhéanamh air. Labhraíonn siad le cúntóir a chruthaíonn, a nuashonraíonn agus a aimsíonn teagmhálaithe go huathoibríoch. Is é seo go díreach an rud a chuireann glaonna feidhme (function calling) ar do chumas a thógáil. Tá difríocht shuntasach ann i gcomparáid leis an rianaire íocaíochta sa cheacht roimhe seo: go dtí seo, níor léigh an tsamhail ach sonraí. Anseo, scríobhann sí sonraí, rud a aistríonn fócas an chleachtaidh i dtreo bailíochtaithe, deimhniithe agus bainistíochta dúbailtí.
Cuirfidh tú CRM comhráite i bhfeidhm le hoibríochtaí CRUD (Cruthaigh, Léigh, Nuashonraigh, Scrios) ar bhunachar sonraí teagmhálaithe.
An Bunachar Sonraí Simulaithe
Seirbheálann foclóir Python mar bhunachar sonraí don taispeántas seo. Tá dhá theagmhálaí leordhóthanach: cliant amháin agus ionchas amháin. Ligeann an socrú seo dúinn aistriú stádais a thástáil níos déanaí sa cheacht.
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
Na Feidhmeanna CRUD
Déileálann get_contact agus search_contacts le hoibríochtaí léitheoireachta. Glacann an ceann deireanach le hargaimint réimse cuardaigh chun cruthú feidhmeanna ilroinnte atá beagnach comhionann a sheachaint. Is é create_contact an chéad fheidhm a mhodhnaíonn stádas an chórais, agus léiríonn sí riail a dhéantar a dhearmad go minic i módhanna comhráite: caithfidh seiceálacha uathúlachta bheith i do chód, riamh sa leid a thugtar don tsamhail. Níl aon rud ag cosc ar ionadaí díolacháin an teagmhálaí céanna a dhéanamh dhá uair; filleann an fíorú ríomhphoist ag tús na feidhme duplicate_email leis an ID atá ann cheana, rud a ligeann don tsamhail an diúltú a mhíniú go beacht.
Úsáideann update_contact cur chuige réimsí roghnacha: ní dhéantar ach na réimsí a soláthraíodh a mhodhnú, agus filleann an fheidhm liosta de na rudaí a athraíodh i ndáiríre. Níl an liosta seo maisiúil – cuireann sé ar chumas an chúntóra an modhnú a dheimhniú le habairt bheacht seachas “déanta” doiléir.
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"})
Níl an paraiméadar ensure_ascii=False atá i láthair i roinnt fillteáin ina mhionsonra cosmaideach: gan é, déanfaí sreangán de sheichimh éalúcháin Unicode as “Interested” i gcomhthéacs na samhla, rud atá níos lú inléite agus níos costasaí ó thaobh token de.
Sonraíochtaí Uirlisí JSON
Iompraíonn dhá mheicníocht an chuid is mó den iontaofacht anseo. Coscaíonn an enum ar status don tsamhail luachanna a chumadh: caithfidh sí roghnú as prospect, client, partner, agus inactive, rud a chosnaíonn sláine do chuid sonraí gan aon bhailíochtú breise. Déanann an t-eagar required an chuid eile trí idirdhealú a dhéanamh idir réimsí éigeantacha agus roghnacha – do create_contact, ní bhíonn ciall le teagmhálaí gan ainm, ríomhphost ná cuideachta, cé is féidir teacht ar uimhir theileafóin níos déanaí.
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"]
}
}
}
]
Sainordú agus an Lúb
Ós rud é nach mbraitheann na feidhmeanna ar aon réada seachtracha, laghdaítear an foclóir sainordaithe go mapáil dhíreach. Iompraíonn an teachtaireacht chórais, áfach, dhá shrian iompraíochta nach bhfuil sa chód: deimhnigh gach gníomh cruthaithe nó nuashonraithe le mionsonraí, agus iarr faisnéis atá ar iarraidh sula gcruthaíonn tú teagmhálaí. Gan an treoir sin, bíonn claonadh ag an tsamhail réimsí éigeantacha a líonadh le luachanna inchreidte.
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."
}
]
Ceithre Chás agus an Méid a Mhúineann Siad
Taispeánann an chéad chás go roghnaíonn an tsamhail field="company" léi féin cé nár shonraigh an t-úsáideoir aon rud: thug an scéama enum na roghanna, agus rinne an chaoi ar cuireadh an cheist an chuid eile. Soláthraíonn an dara cás faisnéis i meascán, gan lipéid, agus dáileann an tsamhail iad i gceart i measc ainm, ríomhphost, cuideachta agus teidil. Is é an tríú cás an ceann is saibhre: níl aon ID i “Switch Pierre Martin to client”, mar sin caithfidh an tsamhail slabhra cuardaigh agus ansin nuashonraithe a dhéanamh, ag tuiscint an nóta comhthéacsúil ar an mbealach. Cuireann an ceathrú cás in iúl dúinn gur féidir leis an tsamhail feidhm a athúsáid óna húsáid litriúil chun freagra a thabhairt ar cheist chomhairimh.
# 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."
Ag Bogadh chuig Táirgeadh Gan Gach Rud a Athscríobh
Imíonn an foclóir cuimhne istigh go soiléir chomh luath agus a bhíonn úsáideoirí iolracha ann. Ach, is ar chiseal amháin is gá teagmháil a dhéanamh chun é a chur in ionad bunachar sonraí fíor: déanann an fheidhm ceist ar ORM nó ar API do CRM agus filleann sí an tsreangán JSON céanna fós.
# 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"})
Fanann an chuid eile den chód – uirlisí, sainordú, lúb comhrá – mar an gcéanna. Is é seo neart na hailtireachta seo: ní athraíonn ach na feidhmeanna loighce gnó, agus fanann an ciseal comhráite gan aird ar do roghanna marthanachta.
Príomhphointí
- Tiontaíonn glaonna feidhme LLM ina chomhéadan nádúrtha do CRM
- Mapáiltear oibríochtaí CRUD go díreach le feidhmeanna le Scéama JSON
- Is féidir leis an tsamhail cuardach a shlabhrú agus ansin nuashonrú laistigh de chomhrá amháin
- Tá an ailtireacht dícheangailte: athraigh an bunachar sonraí gan teagmháil a dhéanamh le loighic an chomhrá
- Tá an teachtaireacht chórais ríthábhachtach chun an tsamhail a threorú maidir le deimhnithe agus faisnéis atá ar iarraidh