Agentao: AI агент для локальной интеграции в Python приложениях

Agentao — это среда выполнения агентов, ориентированная на управление, разработанная для встраивания в Python приложения. Она позволяет создавать локальные и приватные агенты, которые поддерживают управление разрешениями, протоколами, памятью и многосессионным взаимодействием.

Зачем нужен Agentao?

Основная идея проекта заключается в управлении действиями агентов. Agentao обеспечивает три ключевых аспекта: ограничения, связь и наблюдаемость. Это достигается с помощью:

• Ограничений: агенты не могут действовать без разрешения, применяются различные режимы доступа (только для чтения, возможность записи в рабочее пространство и полный доступ).
• Связи: агенты могут взаимодействовать с внешним миром через специфические протоколы.
• Наблюдаемости: работа агентов прозрачна и сопровождается логированием действий.

Как установить и запустить Agentao

Для начала работы необходимо установить библиотеку через pip и задать параметры окружения:

pip install agentao

Для использования интерфейса командной строки (CLI) потребуется:

pip install 'agentao[cli]'

Не забудь создать файл .env с тремя обязательными переменными окружения:

printf "OPENAI_API_KEY=sk-your-key\nOPENAI_BASE_URL=https://api.openai.com/v1\nOPENAI_MODEL=gpt-5.4\n" > .env

После этого можно запускать Agentao из терминала:

agentao

Как использовать Agentao

После установки ты можешь запускать агентов, используя Python. Вот пример создания агента:

from pathlib import Path
from agentao import Agentao
from agentao.llm import LLMClient
from agentao.transport import NullTransport

agent = Agentao(
    working_directory=Path("/tmp/agent-run-1"),
    llm_client=LLMClient(
        api_key="sk-...",
        base_url="https://api.openai.com/v1",
        model="gpt-5.4",
    ),
    transport=NullTransport(),
)
reply = agent.chat("Summarize today's logs.")
print(reply)
agent.close()

Этот код создает агента, который работает в изолированном режиме без доступа к глобальному состоянию.

Преимущества и возможности

Agentao предлагает множество функций:

• Управление инструментами с подтверждением действий и несколькими режимами разрешений.
• Поддержка памяти на базе SQLite с автоматическим восстановлением.
• Интеграция с другими инструментами и плагинами через различные протоколы.
• Возможность записи и воспроизведения сессий.

Ограничения

Требуется Python версии 3.10 или выше, и все три обязательные переменные окружения должны быть установлены, иначе будет выброшено исключение ValueError. Также стоит учесть, что проект полностью ориентирован на интеграцию с OpenAI API.