API

​

Как работает интеграция через API

1. Создайте приложение в Студии Интеллос с нужными вам возможностями ИИ
2. Сгенерируйте учётные данные API для безопасного доступа к функциям приложения
3. Вызывайте API из своего приложения, чтобы получать ответы на базе ИИ
4. Пользователи взаимодействуют с вашим собственным интерфейсом, а Интеллос берёт на себя обработку ИИ

​

С чего начать

​

Приложение для генерации текста

curl --location --request POST 'https://app.intellos.ru/v1/completion-messages' \
--header 'Authorization: Bearer ENTER-YOUR-SECRET-KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"inputs": {},
"response_mode": "streaming",
"user": "abc-123"
}'

import requests
import json

url = "https://app.intellos.ru/v1/completion-messages"

headers = {
'Authorization': 'Bearer ENTER-YOUR-SECRET-KEY',
'Content-Type': 'application/json',
}

data = {
"inputs": {"text": 'Hello, how are you?'},
"response_mode": "streaming",
"user": "abc-123"
}

response = requests.post(url, headers=headers, data=json.dumps(data))

print(response.text)

​

Диалоговые приложения

Важное замечание: Service API не разделяет разговоры, созданные в WebApp. Разговоры, созданные через API, изолированы от разговоров, созданных в интерфейсе WebApp.

​

Что важно знать про conversation_id:

• Генерация conversation_id: При начале нового разговора оставьте поле conversation_id пустым. Система сгенерирует и вернёт новый conversation_id, который вы будете использовать в дальнейших взаимодействиях для продолжения диалога.
• Работа с conversation_id в существующих сессиях: После того как conversation_id сгенерирован, во все последующие вызовы API следует включать этот conversation_id, чтобы обеспечить непрерывность разговора с ботом Интеллос. Если передан ранее полученный conversation_id, любые новые inputs будут проигнорированы. Для продолжающегося разговора обрабатывается только query.
• Управление динамическими переменными: Если в ходе сессии нужно изменить логику или переменные, вы можете использовать переменные разговора (переменные, специфичные для сессии), чтобы скорректировать поведение или ответы бота.

curl --location --request POST 'https://app.intellos.ru/v1/chat-messages' \
--header 'Authorization: Bearer ENTER-YOUR-SECRET-KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"inputs": {},
"query": "eh",
"response_mode": "streaming",
"conversation_id": "1c7e55fb-1ba2-4e10-81b5-30addcea2276",
"user": "abc-123"
}'

import requests
import json

url = 'https://app.intellos.ru/v1/chat-messages'
headers = {
'Authorization': 'Bearer ENTER-YOUR-SECRET-KEY',
'Content-Type': 'application/json',
}
data = {
"inputs": {},
"query": "eh",
"response_mode": "streaming",
"conversation_id": "1c7e55fb-1ba2-4e10-81b5-30addcea2276",
"user": "abc-123"
}

response = requests.post(url, headers=headers, data=json.dumps(data))

print(response.text())