Conversations
Conversation related APIs
대화 목록을 가져옵니다. 대화는 기본적으로 마지막 대화 시간 기준으로 내림차순으로 정렬됩니다.
Required: Your API key for authentication
Search for last chat time after this value
Search for last chat time before this value
Search for first chat time after this value
Search for first chat time before this value
50falseLAST_CHAT_TIME_DESCOptional: Email of the agent to use for this request
Optional: Email address to associate with the user
Optional: User ID to identify or create a user
알겠습니다
GET /webapi/v2/conversations HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*
알겠습니다
{
"conversations": [
{
"id": "text",
"title": "text",
"user": {
"userId": "text",
"firstName": "text",
"lastName": "text"
},
"createdAt": 1,
"lastChatTime": 1,
"isEnd": true,
"categories": [
"text"
],
"memo": "text",
"chats": [
{
"id": "text",
"sender": "USER",
"message": "text",
"timestamp": 1,
"citations": [
{
"clueId": "text",
"source": "text",
"title": "text",
"knowledgeBaseId": "text",
"pageNo": 1,
"url": "text",
"text": "text"
}
],
"rating": true,
"agentRating": true
}
],
"chatCount": 1,
"llmApp": {
"id": "text",
"name": "text",
"description": "text"
},
"variables": {}
}
],
"cursor": "text"
}Required: Your API key for authentication
Optional: Email of the agent to use for this request
Optional: Email address to associate with the user
Optional: User ID to identify or create a user
필터링을 위한 유저의 ID
필터링을 위한 llm 앱의 ID
필터링을 위한 대화 카테고리의 ID
필터링을 위한 대화 ID
알겠습니다
No content
POST /webapi/v2/conversations/bulk_update HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 181
{
"userIds": [
"text"
],
"llmAppIds": [
"text"
],
"categoryIds": [
"text"
],
"conversationIds": [
"text"
],
"conversationInfo": {
"state": "no",
"assignee": "text",
"categoryIds": [
"text"
],
"title": "text"
}
}알겠습니다
No content
대화를 시작해 주세요.
대화에 제공된 대화은 가장 최근의 20건입니다.
Required: Your API key for authentication
Comma separated list of variables to include in the response
Optional: Email of the agent to use for this request
Optional: Email address to associate with the user
Optional: User ID to identify or create a user
알겠습니다.
GET /webapi/v2/conversations/{conversation_id} HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*
알겠습니다.
{
"id": "text",
"title": "text",
"user": {
"userId": "text",
"firstName": "text",
"lastName": "text"
},
"createdAt": 1,
"lastChatTime": 1,
"isEnd": true,
"categories": [
"text"
],
"memo": "text",
"chats": [
{
"id": "text",
"sender": "USER",
"message": "text",
"timestamp": 1,
"citations": [
{
"clueId": "text",
"source": "text",
"title": "text",
"knowledgeBaseId": "text",
"pageNo": 1,
"url": "text",
"text": "text"
}
],
"rating": true,
"agentRating": true
}
],
"chatCount": 1,
"llmApp": {
"id": "text",
"name": "text",
"description": "text"
},
"variables": {}
}Required: Your API key for authentication
Optional: Email of the agent to use for this request
Optional: Email address to associate with the user
Optional: User ID to identify or create a user
대화의 상태
대화의 담당자
카테고리의 ID
대화의 제목
알겠습니다.
PATCH /webapi/v2/conversations/{conversation_id} HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 70
{
"state": "no",
"assignee": "text",
"categoryIds": [
"text"
],
"title": "text"
}알겠습니다.
{
"id": "text",
"title": "text",
"user": {
"userId": "text",
"firstName": "text",
"lastName": "text"
},
"createdAt": 1,
"lastChatTime": 1,
"isEnd": true,
"categories": [
"text"
],
"memo": "text",
"chats": [
{
"id": "text",
"sender": "USER",
"message": "text",
"timestamp": 1,
"citations": [
{
"clueId": "text",
"source": "text",
"title": "text",
"knowledgeBaseId": "text",
"pageNo": 1,
"url": "text",
"text": "text"
}
],
"rating": true,
"agentRating": true
}
],
"chatCount": 1,
"llmApp": {
"id": "text",
"name": "text",
"description": "text"
},
"variables": {}
}대화 대화을 가져오세요. 대화은 타임스탬프를 기준으로 오름차순으로 정렬됩니다.
대화 페이지 크기는 100입니다.
Required: Your API key for authentication
1Optional: Email of the agent to use for this request
Optional: Email address to associate with the user
Optional: User ID to identify or create a user
좋아
GET /webapi/v2/conversations/{conversation_id}/chats HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*
좋아
{
"chats": [
{
"id": "text",
"sender": "USER",
"message": "text",
"timestamp": 1,
"citations": [
{
"clueId": "text",
"source": "text",
"title": "text",
"knowledgeBaseId": "text",
"pageNo": 1,
"url": "text",
"text": "text"
}
],
"rating": true,
"agentRating": true
}
],
"pageNo": 1,
"totalCount": 1
}Required: Your API key for authentication
Optional: Email of the agent to use for this request
Optional: Email address to associate with the user
Optional: User ID to identify or create a user
알겠습니다
GET /webapi/v2/conversations/{conversation_id}/running HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*
알겠습니다
{
"isRunning": true
}Stop a running conversation.
Required: Your API key for authentication
Optional: Email of the agent to use for this request
Optional: Email address to associate with the user
Optional: User ID to identify or create a user
OK
No content
POST /webapi/v2/conversations/{conversation_id}/stop HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*
OK
No content
Required: Your API key for authentication
Optional: Email of the agent to use for this request
Optional: Email address to associate with the user
Optional: User ID to identify or create a user
알겠습니다.
No content
DELETE /webapi/v2/conversations/{conversation_id}/chats/{chat_id} HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*
알겠습니다.
No content
대화 제목 설정.
Required: Your API key for authentication
Optional: Email of the agent to use for this request
Optional: Email address to associate with the user
Optional: User ID to identify or create a user
대화의 제목
알겠습니다
PUT /webapi/v2/conversations/{conversation_id}/title HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16
{
"title": "text"
}알겠습니다
{
"id": "text",
"title": "text",
"user": {
"userId": "text",
"firstName": "text",
"lastName": "text"
},
"createdAt": 1,
"lastChatTime": 1,
"isEnd": true,
"categories": [
"text"
],
"memo": "text",
"chats": [
{
"id": "text",
"sender": "USER",
"message": "text",
"timestamp": 1,
"citations": [
{
"clueId": "text",
"source": "text",
"title": "text",
"knowledgeBaseId": "text",
"pageNo": 1,
"url": "text",
"text": "text"
}
],
"rating": true,
"agentRating": true
}
],
"chatCount": 1,
"llmApp": {
"id": "text",
"name": "text",
"description": "text"
},
"variables": {}
}Required: Your API key for authentication
Optional: Email of the agent to use for this request
Optional: Email address to associate with the user
Optional: User ID to identify or create a user
대화에 대한 평가
피드백 선택
제안된 답변
알겠습니다.
POST /webapi/v2/conversations/{conversation_id}/chats/{chat_id}/feedback HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 77
{
"rating": true,
"feedbackSelection": [
"not_relevant"
],
"suggestedAnswer": "text"
}알겠습니다.
{
"conversationId": "text",
"chatId": "text",
"rating": true
}주어진 범위에 대한 하루 총 대화 수.
Required: Your API key for authentication
Optional: Email of the agent to use for this request
Optional: Email address to associate with the user
Optional: User ID to identify or create a user
YYYY-MM-DD 형식으로 조회할 날짜 범위의 시작.
조회할 날짜 범위의 끝(YYYY-MM-DD 형식).
성공적으로 검색된 일일 대화 횟수
GET /webapi/conversation_daily_count HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 37
{
"startDate": "text",
"endDate": "text"
}성공적으로 검색된 일일 대화 횟수
{
"result": {
"dailyTotalCount": [
{
"date": "text",
"activeCount": 1
}
],
"state": "text",
"campaignCount": 1
},
"errors": {}
}Last updated
Was this helpful?