Record a training
Records a training someone completed, like AI literacy, with its date, hours, certificate and expiry.
$0.01 a call
From your agent’s balance. A call that fails costs nothing.
An example
Lena did the AI literacy course yesterday, two hours. Here is her certificate; it is valid for two years.
Your agent callshr_record_training$0.01 a call
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
{
"person": "lena.brandt@hansenvoss.example",
"course": "AI literacy for small teams",
"kind": "ai_literacy",
"completed_on": "2026-10-13",
"hours": 2,
"expires_on": "2028-10-13"
}Use it when
Someone finished a course the business must be able to show: AI literacy, privacy, security, safety.
What it does
A training someone completed: its kind (ai_literacy for the EU AI Act's Art. 4, privacy, security, safety, other), date, hours, certificate from the file store and expiry. $0.01.
What comes back
training: its training_id, person_id, course, kind, date, hours, certificate file_id and expiry. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
personRequired | integer or string | The person_id, or their work email. 1 to 254 characters, at least 1. |
courseRequired | string | 1 to 200 characters. |
kindRequired | string | One of: ai_literacy,privacy,security,safety,other. |
completed_onRequired | string | YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$. |
hours | number | 0 to 9,999. |
certificate_file_id | string | Exactly 36 characters. |
expires_on | string | YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$. |
The call
Over MCP, call hr_record_training on https://api.conecto.chat/mcp/hr. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/hr_record_training \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"person":"lena.brandt@hansenvoss.example","course":"AI literacy for small teams","kind":"ai_literacy","completed_on":"2026-10-13","hours":2,"expires_on":"2028-10-13"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | The person is not on the HR records, or certificate_file_id is not in the file store. | Use a person_id or work email from hr_list_people, and a file_id from files_list. |
More HR tools
All 23 tools- Add or change people
hr_save_peopleAdds people or changes them, up to 100 at a time, all or none: names, emails, job, department, location, manager, dates and allowances.$1.00 per person added - List people
hr_list_peoplePeople by last name, everyone who hasn't left by default, filtered by status, department, location, manager, type or words.Free* - Get a person
hr_get_personEverything about one person: details, leave balances for a year, pending and upcoming leave, documents, open tasks and direct reports.Free* - Delete a person
hr_delete_personErases a person for good with their leave, tasks and document records; their files stay in the store.Free - Read the HR settings
hr_get_settingsThe working days, hours, leave year, time zone, leave types, public holidays and checklists.Free* - Change the HR settings
hr_save_settingsSets the work calendar: working days, hours per day, leave year, time zone, and one location's public holidays for a year.$0.001 a call - Add or change a leave type
hr_save_leave_typeAdds or changes a kind of time off: annual days, monthly or yearly accrual, carry-over, paid and tracked.$0.001 a call - Adjust a leave balance
hr_adjust_leaveAdds days to, or takes days off, one person's balance of a tracked leave type, with the reason.$0.01 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md