losthost/simple-ai-agent

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

2.1.1 2025-11-25 07:43 UTC

Requires

• php: ^8.0
• deepseek-php/deepseek-php-client: ^2
• guzzlehttp/guzzle: ^7
• losthost/db: ^3

Requires (Dev)

• phpunit/phpunit: 11.5.44

MIT

• drweb

README

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

Особенности

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

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

use losthost\SimpleAI\SimpleAIAgent;

require 'vendor/autoload.php';

$api_key = "<your_deepseek_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 - простой запрос без контекста
• 02.no-prompt-dialog.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