PHPackages                             losthost/simple-openai-agent - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. losthost/simple-openai-agent

ActiveLibrary[Utility & Helpers](/categories/utility)

losthost/simple-openai-agent
============================

A very simple to use but powerfull AI-agent class for ChatGPT

2.5.2(2mo ago)04MITPHPPHP ^8.0

Since Feb 9Pushed 2mo agoCompare

[ Source](https://github.com/Datahider/SimpleOpenAIAgent)[ Packagist](https://packagist.org/packages/losthost/simple-openai-agent)[ RSS](/packages/losthost-simple-openai-agent/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

Simple AI Agent
===============

[](#simple-ai-agent)

Простая и мощная библиотека для работы с AI-агентами на основе DeepSeek API.

Особенности
-----------

[](#особенности)

- 🚀 **Простой старт** - всего 2 метода для начала работы
- 💾 **Автосохранение контекста** - интегрируется с БД
- 🔄 **Гибкая обработка ошибок** - retry, кастомные обработчики
- 🎭 **Мульти-агентность** - разные промпты в одном экземпляре
- ⚡ **Fluent interface** - цепочные вызовы для удобства

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

[](#быстрый-старт)

```
use losthost\SimpleAI\SimpleAIAgent;

require 'vendor/autoload.php';

$api_key = "";

// Простой запрос
$answer = SimpleAIAgent::build($api_key)
    ->ask('Привет! Как дела?');

echo $answer;
```

Расширенные возможности
-----------------------

[](#расширенные-возможности)

### Работа с контекстом

[](#работа-с-контекстом)

```
$agent = SimpleAIAgent::build($api_key)
    ->setUserId('user123')
    ->setDialogId('chat1')
    ->setAgentName('помощник')
    ->setPrompt('Ты полезный ассистент');

// Сохраняет контекст в БД автоматически
$answer1 = $agent->ask('Как настроить почту?');
$answer2 = $agent->ask('А для телефона?'); // Помнит предыдущий разговор
```

### Обработка ошибок

[](#обработка-ошибок)

```
// Авто-ретрай при ошибках
$answer = $agent->ask('Вопрос', function($ex) use ($agent) {
    if (str_contains($ex->getMessage(), 'timeout')) {
        return $agent->ask(); // ретрай
    }
    return "Извините, произошла ошибка";
});
```

### Несколько агентов

[](#несколько-агентов)

```
// Один экземпляр - много агентов
$agent = SimpleAIAgent::build($api_key)
    ->setUserId('user123')
    ->setDialogId('chat1')
    ->setAgentName('техподдержка')
    ->setPrompt('Ты ассистент техподдержки')
    ->setAgentName('консультант')
    ->setPrompt('Ты финансовый консультант');

$answer1 = $agent->setAgentName('техподдержка')->ask('Проблема с WiFi');
$answer2 = $agent->setAgentName('консультант')->ask('Куда вложить деньги?');
```

Примеры использования
---------------------

[](#примеры-использования)

В репозитории есть готовые примеры:

- [`01.simple-query.php`](01.simple-query.php) - простой запрос без контекста
- [`02.no-prompt-dialog.php`](02.no-prompt-dialog.php) - диалог с автосохранением контекста
- [`03.life-coach.php`](03.life-coach.php) - полный функционал с промптом и настройками

Примеры идут от простого к сложному - рекомендуем изучать по порядку.

Установка
---------

[](#установка)

```
composer require losthost/simple-ai-agent
```

Требования
----------

[](#требования)

- PHP 8.0+
- DeepSeek API ключ
- MySQL (для работы с контекстом)

Конфигурация БД
---------------

[](#конфигурация-бд)

Создайте файл конфигурации или используйте переменные окружения:

```
DB::connect($host, $user, $pass, $database, $prefix);
```

Лицензия
--------

[](#лицензия)

MIT

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance82

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

89d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d6034471e592d56036961af1cc7ae309cdc332e5eaae18b86c2d9ecde0aae773?d=identicon)[pio](/maintainers/pio)

---

Top Contributors

[![Datahider](https://avatars.githubusercontent.com/u/29582937?v=4)](https://github.com/Datahider "Datahider (3 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/losthost-simple-openai-agent/health.svg)

```
[![Health](https://phpackages.com/badges/losthost-simple-openai-agent/health.svg)](https://phpackages.com/packages/losthost-simple-openai-agent)
```

###  Alternatives

[rs/laravel-version-control

Foundations for making your app version controlled. Provides migration, blueprint and base models. Will make your app GxP compliant if you exclusively use the VC models and table structure as set out in this package.

1227.5k](/packages/rs-laravel-version-control)[mad-web/laravel-seoable

Easy to map your eloquent fields to seo properties

407.6k](/packages/mad-web-laravel-seoable)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)