De Ce Contează Definiția
AI-ul decide când să apeleze o funcție bazat pe descriere. O definiție clară = funcție apelată corect. O definiție ambiguă = erori.
Schema Components
| Component | Description | Required |
|---|---|---|
| name | Identificator unic, snake_case | ✓ |
| description | Când și de ce să folosească funcția | ✓ |
| parameters | JSON Schema pentru input | ✓ |
| parameters.type | Întotdeauna "object" | ✓ |
| parameters.properties | Definiții pentru fiecare parametru | ✓ |
| parameters.required | Array cu parametrii obligatorii | Optional |
Complete Example
{
"name": "schedule_appointment",
"description": "Schedule an appointment for the customer. Use this when the customer wants to book a meeting, consultation, or service appointment. Returns confirmation details.",
"parameters": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Appointment date in YYYY-MM-DD format. Example: 2024-01-15"
},
"time": {
"type": "string",
"description": "Appointment time in HH:MM format (24h). Example: 14:30"
},
"service_type": {
"type": "string",
"enum": ["consultation", "demo", "support", "training"],
"description": "Type of appointment to schedule"
},
"customer_name": {
"type": "string",
"description": "Full name of the customer"
},
"customer_phone": {
"type": "string",
"description": "Customer phone number for confirmation"
},
"notes": {
"type": "string",
"description": "Additional notes or special requests (optional)"
}
},
"required": ["date", "time", "service_type", "customer_name"]
}
}Parameter Types
string
Text, IDs, names
"order_id": {"type": "string"}number
Quantities, amounts
"amount": {"type": "number"}integer
Counts, whole numbers
"quantity": {"type": "integer"}boolean
Yes/no flags
"urgent": {"type": "boolean"}array
Multiple items
"items": {"type": "array"}enum
Fixed options
"status": {"enum": ["pending", "done"]}Best Practices
✓Descrieri clare care explică CÂND să folosească funcția
✓Include exemple în descrierea parametrilor
✓Specifică format-ul așteptat (ex: "YYYY-MM-DD")
✓Listează valori acceptate pentru enum-uri
✓Menționează ce returnează funcția