Conversations

Folder related APIs

목록 대화 가져오기

get

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversations

대화 목록을 가져옵니다. 대화는 기본적으로 마지막 대화 시간 기준으로 내림차순으로 정렬됩니다.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Query parameters

llmAppIdstring · nullableOptional

categoryIdstring · nullableOptional

startedAtnumber · nullableOptional

이 값 이전의 첫 번째 대화 시간을 검색하십시오.

endAtnumber · nullableOptional

Search for last chat time before this value

firstChatStartedAtnumber · nullableOptional

Search for first chat time after this value

firstChatEndAtnumber · nullableOptional

Search for first chat time before this value

searchTermstring · nullableOptional

cursorstring · nullableOptional

variablesstring[] · nullableOptional

pageSizeinteger · min: 1 · max: 50OptionalDefault: 50

activeOnlybooleanOptionalDefault: false

backgroundRunningboolean · nullableOptional

orderstring · enumOptionalPossible values:

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses

200

알겠습니다

application/json

cursorstring · nullableRequired

페이지 네비게이션을 위한 커서

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

get/webapi/v2/conversations

HTTPcURLJavaScriptPython

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",
          "type": "text",
          "sender": "USER",
          "message": "text",
          "source": {
            "knowledgeBaseIds": [
              "text"
            ],
            "folderIds": [
              "text"
            ],
            "webSites": [
              "text"
            ],
            "searchAllSharedDocument": false,
            "searchAllPersonalDocument": false,
            "includingHashtags": [
              "text"
            ],
            "excludingHashtags": [
              "text"
            ],
            "includingHashtagsOperator": "text",
            "excludingHashtagsOperator": "text",
            "sharedKnowledgeBases": [
              {
                "id": "text",
                "name": "text"
              }
            ],
            "sharedFolders": [
              {
                "id": "text",
                "name": "text"
              }
            ],
            "personalKnowledgeBases": [
              {
                "id": "text",
                "name": "text"
              }
            ],
            "personalFolders": [
              {
                "id": "text",
                "name": "text"
              }
            ]
          },
          "timestamp": 1,
          "completed": true,
          "citations": [
            {
              "clueId": "text",
              "source": "text",
              "title": "text",
              "url": "text",
              "text": "text"
            }
          ],
          "rating": true,
          "agentRating": true
        }
      ],
      "chatCount": 1,
      "llmApp": {
        "id": "text",
        "name": "text",
        "description": "text"
      },
      "variables": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "cursor": "text"
}

대화 설정

post

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversations/bulk_update

Update state, assignee, title, or categories for multiple conversations at once. Filter by conversation IDs, user IDs, app IDs, or category IDs.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

userIdsstring[] · nullableOptional

필터링을 위한 유저의 ID

llmAppIdsstring[] · nullableOptional

필터링을 위한 llm 앱의 ID

categoryIdsstring[] · nullableOptional

필터링을 위한 대화 카테고리의 ID

conversationIdsstring[] · nullableOptional

필터링을 위한 대화 ID

Responses

200

알겠습니다

No content

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

post/webapi/v2/conversations/bulk_update

HTTPcURLJavaScriptPython

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

ID로 대화 가져오기

get

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversations/{conversation_id}

대화를 시작해 주세요.

대화에 제공된 대화은 가장 최근의 20건입니다.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Path parameters

conversation_idstringRequired

Query parameters

variablesstring[] · nullableOptional

Comma separated list of variables to include in the response

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses

200

알겠습니다.

application/json

idstringRequired

대화의 고유 ID

titlestringRequired

대화의 제목

createdAtnumberRequired

대화 생성 시간

lastChatTimenumber · nullableRequired

대화 마지막 대화 시간

isEndbooleanRequired

대화가 완료되었습니까 아니면 안 되었습니까?

categoriesstring[] · nullableRequired

대화 카테고리

memostring · nullableRequired

대화 메모

chatCountintegerRequired

총 대화 수

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

get/webapi/v2/conversations/{conversation_id}

HTTPcURLJavaScriptPython

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",
      "type": "text",
      "sender": "USER",
      "message": "text",
      "source": {
        "knowledgeBaseIds": [
          "text"
        ],
        "folderIds": [
          "text"
        ],
        "webSites": [
          "text"
        ],
        "searchAllSharedDocument": false,
        "searchAllPersonalDocument": false,
        "includingHashtags": [
          "text"
        ],
        "excludingHashtags": [
          "text"
        ],
        "includingHashtagsOperator": "text",
        "excludingHashtagsOperator": "text",
        "sharedKnowledgeBases": [
          {
            "id": "text",
            "name": "text"
          }
        ],
        "sharedFolders": [
          {
            "id": "text",
            "name": "text"
          }
        ],
        "personalKnowledgeBases": [
          {
            "id": "text",
            "name": "text"
          }
        ],
        "personalFolders": [
          {
            "id": "text",
            "name": "text"
          }
        ]
      },
      "timestamp": 1,
      "completed": true,
      "citations": [
        {
          "clueId": "text",
          "source": "text",
          "title": "text",
          "url": "text",
          "text": "text"
        }
      ],
      "rating": true,
      "agentRating": true
    }
  ],
  "chatCount": 1,
  "llmApp": {
    "id": "text",
    "name": "text",
    "description": "text"
  },
  "variables": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

대화 설정

patch

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversations/{conversation_id}

Partially update a conversation's state, assignee, title, or categories.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Path parameters

conversation_idstringRequired

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

statestring · enum · nullableOptional

대화의 상태

Possible values:

assigneestring · nullableOptional

대화의 담당자

categoryIdsstring[] · nullableOptional

카테고리의 ID

titlestring · nullableOptional

대화의 제목

Responses

200

알겠습니다.

application/json

idstringRequired

대화의 고유 ID

titlestringRequired

대화의 제목

createdAtnumberRequired

대화 생성 시간

lastChatTimenumber · nullableRequired

대화 마지막 대화 시간

isEndbooleanRequired

대화가 완료되었습니까 아니면 안 되었습니까?

categoriesstring[] · nullableRequired

대화 카테고리

memostring · nullableRequired

대화 메모

chatCountintegerRequired

총 대화 수

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

patch/webapi/v2/conversations/{conversation_id}

HTTPcURLJavaScriptPython

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",
      "type": "text",
      "sender": "USER",
      "message": "text",
      "source": {
        "knowledgeBaseIds": [
          "text"
        ],
        "folderIds": [
          "text"
        ],
        "webSites": [
          "text"
        ],
        "searchAllSharedDocument": false,
        "searchAllPersonalDocument": false,
        "includingHashtags": [
          "text"
        ],
        "excludingHashtags": [
          "text"
        ],
        "includingHashtagsOperator": "text",
        "excludingHashtagsOperator": "text",
        "sharedKnowledgeBases": [
          {
            "id": "text",
            "name": "text"
          }
        ],
        "sharedFolders": [
          {
            "id": "text",
            "name": "text"
          }
        ],
        "personalKnowledgeBases": [
          {
            "id": "text",
            "name": "text"
          }
        ],
        "personalFolders": [
          {
            "id": "text",
            "name": "text"
          }
        ]
      },
      "timestamp": 1,
      "completed": true,
      "citations": [
        {
          "clueId": "text",
          "source": "text",
          "title": "text",
          "url": "text",
          "text": "text"
        }
      ],
      "rating": true,
      "agentRating": true
    }
  ],
  "chatCount": 1,
  "llmApp": {
    "id": "text",
    "name": "text",
    "description": "text"
  },
  "variables": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

대화 목록 대화

get

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversations/{conversation_id}/chats

대화 대화을 가져오세요. 대화은 타임스탬프를 기준으로 오름차순으로 정렬됩니다.

대화 페이지 크기는 100입니다.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Path parameters

conversation_idstringRequired

Query parameters

pageNointeger · min: 1OptionalDefault: 1

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses

200

좋아

application/json

pageNointegerRequired

totalCountintegerRequired

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

get/webapi/v2/conversations/{conversation_id}/chats

HTTPcURLJavaScriptPython

GET /webapi/v2/conversations/{conversation_id}/chats HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*

{
  "chats": [
    {
      "id": "text",
      "type": "text",
      "sender": "USER",
      "message": "text",
      "source": {
        "knowledgeBaseIds": [
          "text"
        ],
        "folderIds": [
          "text"
        ],
        "webSites": [
          "text"
        ],
        "searchAllSharedDocument": false,
        "searchAllPersonalDocument": false,
        "includingHashtags": [
          "text"
        ],
        "excludingHashtags": [
          "text"
        ],
        "includingHashtagsOperator": "text",
        "excludingHashtagsOperator": "text",
        "sharedKnowledgeBases": [
          {
            "id": "text",
            "name": "text"
          }
        ],
        "sharedFolders": [
          {
            "id": "text",
            "name": "text"
          }
        ],
        "personalKnowledgeBases": [
          {
            "id": "text",
            "name": "text"
          }
        ],
        "personalFolders": [
          {
            "id": "text",
            "name": "text"
          }
        ]
      },
      "timestamp": 1,
      "completed": true,
      "citations": [
        {
          "clueId": "text",
          "source": "text",
          "title": "text",
          "url": "text",
          "text": "text"
        }
      ],
      "rating": true,
      "agentRating": true
    }
  ],
  "pageNo": 1,
  "totalCount": 1
}

ID로 대화 상태 가져오기

get

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversations/{conversation_id}/running

Check whether a conversation is currently running in the background.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Path parameters

conversation_idstringRequired

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses

200

알겠습니다

application/json

isRunningbooleanRequired

백그라운드 실행 상태

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

get/webapi/v2/conversations/{conversation_id}/running

HTTPcURLJavaScriptPython

GET /webapi/v2/conversations/{conversation_id}/running HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*

{
  "isRunning": true
}

Stop Conversation

post

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversations/{conversation_id}/stop

Stop a running conversation.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Path parameters

conversation_idstringRequired

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses

200

OK

application/json

isRunningbooleanRequired

백그라운드 실행 상태

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

post/webapi/v2/conversations/{conversation_id}/stop

HTTPcURLJavaScriptPython

POST /webapi/v2/conversations/{conversation_id}/stop HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*

{
  "isRunning": true
}

Get Chat

get

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversations/{conversation_id}/chats/{chat_id}

Get a specific chat by ID from a conversation.

This API is useful for verifying the message content after a streaming response from run_apps API. The response includes detailed chat information compatible with LLMResponse.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Path parameters

conversation_idstringRequired

chat_idstringRequired

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses

200

OK

application/json

Detailed chat information compatible with LLMResponse for run_apps API response verification.

Extends Chat with additional fields for verifying streaming responses from run_apps API.

idstringRequired

Unique ID of the chat

typestring · nullableOptional

Node type of the chat

senderstringRequired

Sender Type

Example: USER

messagestringRequired

Chat message

timestampnumberRequired

Timestamp of the chat message creation time

completedbooleanRequired

Whether the chat generation is completed

ratingboolean · nullableRequired

Rating of the chat

agentRatingboolean · nullableRequired

Agent rating of the chat

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

get/webapi/v2/conversations/{conversation_id}/chats/{chat_id}

HTTPcURLJavaScriptPython

GET /webapi/v2/conversations/{conversation_id}/chats/{chat_id} HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*

{
  "id": "text",
  "type": "text",
  "sender": "USER",
  "message": "text",
  "source": {
    "knowledgeBaseIds": [
      "text"
    ],
    "folderIds": [
      "text"
    ],
    "webSites": [
      "text"
    ],
    "searchAllSharedDocument": false,
    "searchAllPersonalDocument": false,
    "includingHashtags": [
      "text"
    ],
    "excludingHashtags": [
      "text"
    ],
    "includingHashtagsOperator": "text",
    "excludingHashtagsOperator": "text",
    "sharedKnowledgeBases": [
      {
        "id": "text",
        "name": "text"
      }
    ],
    "sharedFolders": [
      {
        "id": "text",
        "name": "text"
      }
    ],
    "personalKnowledgeBases": [
      {
        "id": "text",
        "name": "text"
      }
    ],
    "personalFolders": [
      {
        "id": "text",
        "name": "text"
      }
    ]
  },
  "timestamp": 1,
  "completed": true,
  "citations": [
    {
      "clueId": "text",
      "source": "text",
      "title": "text",
      "url": "text",
      "text": "text"
    }
  ],
  "rating": true,
  "agentRating": true,
  "intermediateSteps": [
    {
      "key": "text",
      "createdAt": 1,
      "completed": true,
      "statusMessage": "text",
      "markdownMessage": "text"
    }
  ]
}

아이디로 대화 대화 삭제

delete

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversations/{conversation_id}/chats/{chat_id}

Delete a specific chat message from a conversation.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Path parameters

conversation_idstringRequired

chat_idstringRequired

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses

200

알겠습니다.

No content

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

delete/webapi/v2/conversations/{conversation_id}/chats/{chat_id}

HTTPcURLJavaScriptPython

DELETE /webapi/v2/conversations/{conversation_id}/chats/{chat_id} HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*

No content

대화 제목 업데이트

put

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversations/{conversation_id}/title

대화 제목 설정.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Path parameters

conversation_idstringRequired

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

titlestringRequired

대화의 제목

Responses

200

알겠습니다

application/json

idstringRequired

대화의 고유 ID

titlestringRequired

대화의 제목

createdAtnumberRequired

대화 생성 시간

lastChatTimenumber · nullableRequired

대화 마지막 대화 시간

isEndbooleanRequired

대화가 완료되었습니까 아니면 안 되었습니까?

categoriesstring[] · nullableRequired

대화 카테고리

memostring · nullableRequired

대화 메모

chatCountintegerRequired

총 대화 수

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

put/webapi/v2/conversations/{conversation_id}/title

HTTPcURLJavaScriptPython

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",
      "type": "text",
      "sender": "USER",
      "message": "text",
      "source": {
        "knowledgeBaseIds": [
          "text"
        ],
        "folderIds": [
          "text"
        ],
        "webSites": [
          "text"
        ],
        "searchAllSharedDocument": false,
        "searchAllPersonalDocument": false,
        "includingHashtags": [
          "text"
        ],
        "excludingHashtags": [
          "text"
        ],
        "includingHashtagsOperator": "text",
        "excludingHashtagsOperator": "text",
        "sharedKnowledgeBases": [
          {
            "id": "text",
            "name": "text"
          }
        ],
        "sharedFolders": [
          {
            "id": "text",
            "name": "text"
          }
        ],
        "personalKnowledgeBases": [
          {
            "id": "text",
            "name": "text"
          }
        ],
        "personalFolders": [
          {
            "id": "text",
            "name": "text"
          }
        ]
      },
      "timestamp": 1,
      "completed": true,
      "citations": [
        {
          "clueId": "text",
          "source": "text",
          "title": "text",
          "url": "text",
          "text": "text"
        }
      ],
      "rating": true,
      "agentRating": true
    }
  ],
  "chatCount": 1,
  "llmApp": {
    "id": "text",
    "name": "text",
    "description": "text"
  },
  "variables": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

피드백 게시하기

post

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversations/{conversation_id}/chats/{chat_id}/feedback

Submit a thumbs-up or thumbs-down feedback on a generated chat response. Negative feedback can include a suggested answer and feedback selections.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Path parameters

conversation_idstringRequired

chat_idstringRequired

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

ratingboolean · nullableOptional

대화에 대한 평가

suggestedAnswerstring · nullableOptional

제안된 답변

Responses

200

알겠습니다.

application/json

conversationIdstringRequired

chatIdstringRequired

ratingboolean · nullableOptional

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

post/webapi/v2/conversations/{conversation_id}/chats/{chat_id}/feedback

HTTPcURLJavaScriptPython

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
}

대화 카테고리 목록

get

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversation_categories

List all conversation categories in the project.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses

200

네

application/json

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

get/webapi/v2/conversation_categories

HTTPcURLJavaScriptPython

GET /webapi/v2/conversation_categories HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*

{
  "categories": [
    {
      "categoryId": "text",
      "name": "text"
    }
  ]
}

대화 카테고리 생성

post

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversation_categories

Create a new conversation category with the given name.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

namestringRequired

Responses

200

알겠습니다.

application/json

categoryIdstringRequired

카테고리의 고유 ID

namestringRequired

카테고리 이름

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

post/webapi/v2/conversation_categories

HTTPcURLJavaScriptPython

POST /webapi/v2/conversation_categories HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "name": "text"
}

{
  "categoryId": "text",
  "name": "text"
}

대화 카테고리 삭제

delete

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/conversation_categories/{conversation_category_id}

Delete a conversation category by ID.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Path parameters

conversation_category_idstringRequired

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses

200

확인

No content

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

delete/webapi/v2/conversation_categories/{conversation_category_id}

HTTPcURLJavaScriptPython

DELETE /webapi/v2/conversation_categories/{conversation_category_id} HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*

No content

채팅 완성

post

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/v2/chat/completions

검색 없이 LLM을 직접 호출합니다.

Mally의 LLM 인프라(모델 라우팅, 과금)를 경유합니다. 'mode' 필드를 통해 동기 및 스트리밍 모드 모두 지원합니다.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

modelstringOptional

LLM model name (Mally internal name)

Default: gpt4_o

temperaturenumberOptional

Sampling temperature

Default: 0.3

modestring · enumOptional

sync or stream

Default: syncPossible values:

max_tokensintegerOptional

Max completion tokens

Default: 2048

Responses

200

OK

No content

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

post/webapi/v2/chat/completions

HTTPcURLJavaScriptPython

POST /webapi/v2/chat/completions HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 116

{
  "messages": [
    {
      "role": "system",
      "content": "text"
    }
  ],
  "model": "gpt4_o",
  "temperature": 0.3,
  "mode": "sync",
  "max_tokens": 2048
}

No content

일일 대화 횟수

get

https://backend.alli.aihttps://backend-ja.alli.ai

/webapi/conversation_daily_count

주어진 범위에 대한 하루 총 대화 수.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

startDatestringOptional

YYYY-MM-DD 형식으로 조회할 날짜 범위의 시작.

endDatestringOptional

조회할 날짜 범위의 끝(YYYY-MM-DD 형식).

Responses

200

성공적으로 검색된 일일 대화 횟수

application/json

errorsobject · nullableOptional

400

Invalid request parameters.

401

Authentication failed. The API-KEY header is missing or invalid.

403

Access denied. The project is inactive or the request IP is not allowed.

500

Internal server error.

get/webapi/conversation_daily_count

HTTPcURLJavaScriptPython

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": {}
}