Перейти к содержимому
Agentum Cloud для разработчиков

Быстрый старт

1. Получите токен

Заголовок раздела «1. Получите токен»

Войдите в app.agentums.ru и откройте Настройки → API-токены → Создать. Скопируйте значение вида ak_… — оно показывается один раз.

Токен привязан к аккаунту и подписке, видит только ваши файлы и работает как пароль. Утёк — отзовите в том же разделе и выпустите новый.

2. Поставьте клиент

Заголовок раздела «2. Поставьте клиент»
Окно терминала
pip install agentum-cloud-sdk

Нужен Python 3.13+. Не на Python — смотрите прямые HTTP-запросы, контракт один и тот же.

3. Загрузите документ и спросите по нему

Заголовок раздела «3. Загрузите документ и спросите по нему»
import asyncio
from agentum_cloud import AgentumClient




async def main() -> None:
    async with AgentumClient(
        base_url="https://api.cloud.agentums.ru",
        api_key="ak_ваш_токен",
    ) as cloud:
        with open("contract.pdf", "rb") as f:
            obj = await cloud.upload("contract.pdf", f.read())


        # Обработка идёт фоном. Без ожидания поиск по содержимому ничего не найдёт.
        await cloud.wait_until_ready(obj.id)


        answer = await cloud.ask("Какой срок действия договора?")
        print(answer.answer)
        for c in answer.citations:
            print("источник:", c.filename)




asyncio.run(main())

Всё. Ни векторной базы, ни разбора PDF, ни эмбеддингов — этим занимается облако.

4. Продолжите разговор

Заголовок раздела «4. Продолжите разговор»

Ответ несёт session_id. Верните его следующим вопросом — и «а подробнее?» будет понято как продолжение, а не как новый диалог с чистого листа.

more = await cloud.ask("а подробнее про ответственность сторон?", session_id=answer.session_id)

Что дальше

Заголовок раздела «Что дальше»