Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Sampla Oibre: CRM Uathoibrithe

Ceacht 13 as 14 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. CRM Tiomáinte ag Comhrá
  2. An Bunachar Sonraí Simulaithe
  3. Na Feidhmeanna CRUD
  4. Sonraíochtaí Uirlisí JSON
  5. Sainordú agus an Lúb
  6. Ceithre Chás agus an Méid a Mhúineann Siad
  7. Ag Bogadh chuig Táirgeadh Gan Gach Rud a Athscríobh
  8. Príomhphointí

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