caiyun/ai

There is no license information available for the latest version (v1.0.2) of this package.

Provider-agnostic AI client for Laravel with OpenAI-compatible chat support.

v1.0.2 2026-08-06 13:37 UTC

Requires

• php: ^8.2
• illuminate/http: ^11.0 || ^12.0 || ^13.0
• illuminate/support: ^11.0 || ^12.0 || ^13.0

Requires (Dev)

• orchestra/testbench: ^9.0 || ^10.0 || ^11.0
• phpunit/phpunit: ^11.0 || ^12.0

Unknown License

• 刘骏霖

• laravel
• ai
• openai

Published on Packagist.org on 2026-08-06 13:39 UTC

README

面向 Laravel 的供应商无关 AI 基础包，当前内置 OpenAI-compatible Chat Completions 驱动。

安装

composer require caiyun/ai
php artisan vendor:publish --tag=caiyun-ai-config

配置环境变量：

AI_DEFAULT_PROVIDER=openai
OPENAI_API_KEY=
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_MODEL=gpt-4.1-mini
AI_REQUEST_TIMEOUT=60
AI_CONNECT_TIMEOUT=10
AI_MAX_RETRIES=2

使用

use Caiyun\AI\DTOs\ChatRequest;
use Caiyun\AI\Facades\AI;

$response = AI::chat(new ChatRequest([
    ['role' => 'system', 'content' => 'You are a helpful assistant.'],
    ['role' => 'user', 'content' => 'Hello'],
]));

echo $response->content;

切换已配置的供应商：

$response = AI::driver('deepseek')->chat($request);

本地开发

composer install
composer check

测试替身

测试中可注入内置的 fake provider，避免发起真实网络请求：

use Caiyun\AI\AIManager;
use Caiyun\AI\Testing\FakeAIProvider;

$fake = new FakeAIProvider('测试响应');
app(AIManager::class)->extend('fake', $fake);

$response = app(AIManager::class)->driver('fake')->chat($request);

该包仅提供模型调用基础设施。业务路由、用户额度、会话存储、Prompt 内容和管理后台应由宿主应用维护。