General Chat
Open-ended career and workplace conversation — questions, advice, and information not covered by a structured intent.
POST /v1/hiring/general-chat
A conversational fallback for career-related questions that don't map to a specific structured intent. The engine responds as a knowledgeable career assistant. Useful for building chat UIs where users ask free-form questions.
Required inputs
| Field | Type | Notes |
|---|---|---|
input.user_id | string | Your platform's user ID |
input.message | string | The user's question or message |
Optional inputs
| Field | Type | Notes |
|---|---|---|
input.profile | ProfileInput | Enables contextualised answers |
input.resume | ResumeInput | Resume context |
input.career_goals | CareerGoalsInput | Goal context |
input.session_history | SessionHistoryInput | Conversation history via session_id |
session_id | string | Continue a session |
Example request
curl -X POST https://api.liyaengine.ai/v1/hiring/general-chat \
-H "x-api-key: $LIYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"user_id": "usr_123",
"message": "What is the difference between a staff engineer and an engineering manager?"
}
}'Response
{
"success": true,
"data": {
"output": {
"message": "Both are senior roles but they represent two different career tracks...",
"turn": 1,
"session_active": true
},
"session_id": "ses_chat_abc"
}
}When to use general-chat vs coaching-session
general-chat | coaching-session | |
|---|---|---|
| Best for | Questions, factual answers, quick advice | Ongoing, personal coaching relationship |
| Session memory | Optional | Recommended — memory improves coaching quality |
| Output structure | Conversational message | Message + suggested follow-ups + session state |
| Tone | Informative | Empathetic and goal-oriented |