OpenAI, Anthropic Claude, Mistral, Cohere AI 서비스 통합을 위한 Laravel 패키지 Sidekick

composer require paparascaldev/sidekick
php artisan sidekick:install

composer require paparascaldev/sidekick
php artisan vendor:publish --tag=sidekick-config
php artisan migrate

SIDEKICK_OPENAI_TOKEN=your-openai-key
SIDEKICK_CLAUDE_TOKEN=your-anthropic-key
SIDEKICK_MISTRAL_TOKEN=your-mistral-key
...

return [
// 명시된 기본 제공업체(provider)가 없을 때의 기본값
'default' => env('SIDEKICK_DEFAULT_PROVIDER', 'openai'),
...

use PapaRascalDev\Sidekick\Facades\Sidekick;
// 파사드를 사용하는 경우
$response = Sidekick::text()->withPrompt('Hello')->generate();
...

$response = Sidekick::text()
->using('openai', 'gpt-4o')
->withSystemPrompt('You are a helpful assistant.')
...

$stream = Sidekick::text()
->using('anthropic', 'claude-sonnet-4-20250514')
->withPrompt('Write a haiku about coding')
...

use PapaRascalDev\\\Sidekick\\\Facades\\\Sidekick;
use PapaRascalDev\\\Sidekick\\\ValueObjects\\Tool;
$response = Sidekick::text()
...

$response = Sidekick::text()
->using('openai', 'gpt-4o')
->withPrompt('What is the weather in London?')
...

$response = Sidekick::text()
->using('openai', 'gpt-4o')
->withPrompt('Extract the person: John Doe, age 42, lives in London.')
...

use PapaRascalDev\Sidekick\ValueObjects\Schema;
// 인라인
->withSchema($schema, name: 'person', strict: false)
...

// 대화 시작
$convo = Sidekick::conversation()
->using('openai', 'gpt-4o')
...

$response = Sidekick::image()
->using('openai', 'dall-e-3')
->withPrompt('A sunset over mountains')
...

$response = Sidekick::audio()
->using('openai', 'tts-1')
->withText('Hello, welcome to Sidekick!')
...

$response = Sidekick::transcription()
->using('openai', 'whisper-1')
->withFile('/path/to/audio.mp3')
...

$response = Sidekick::embedding()
->using('openai', 'text-embedding-3-small')
->withInput('Laravel is a great framework')
...

$response = Sidekick::moderation()
->using('openai', 'text-moderation-latest')
->withContent('Some text to moderate')
...

// 텍스트 요약 (문자열 반환)
$summary = Sidekick::summarize('Long text here...', maxLength: 500);
// 텍스트 번역 (문자열 반환)
...

'knowledge' => [
'embedding' => ['provider' => 'openai', 'model' => 'text-embedding-3-small'],
'chunking' => ['chunk_size' => 2000, 'overlap' => 200],
...

# 파일 인제스트(Ingest)하기
php artisan sidekick:ingest my-kb --file=/path/to/faq.md
# 인라인 텍스트 인제스트하기
...

// 관련 청크 검색하기
$results = Sidekick::knowledge('my-kb')->search('What is your return policy?');
foreach ($results as $chunk) {
...

// 원샷(One-liner): KB를 검색하고 근거 기반 답변 생성하기
$answer = Sidekick::knowledge('my-kb')->ask('What is your return policy?');

SIDEKICK_WIDGET_ENABLED=true
SIDEKICK_WIDGET_KNOWLEDGE_BASE=my-kb

'widget' => [
'knowledge_base' => 'my-kb',
'rag_context_chunks' => 5,
...

// SearchesKnowledge 계약 구현하기
use PapaRascalDev\\\Sidekick\Contracts\SearchesKnowledge;
class PgVectorSearch implements SearchesKnowledge
...

$kb = Sidekick::knowledge('my-kb');
$kb->chunkCount(); // 저장된 청크 개수
$kb->purge(); // 모든 청크 삭제하기
...

SIDEKICK_WIDGET_ENABLED=true
SIDEKICK_WIDGET_PROVIDER=openai
SIDEKICK_WIDGET_MODEL=gpt-4o
...

<x-sidekick::chat-widget
position="bottom-right"
theme="dark"
...

<meta name="csrf-token" content="{{ csrf_token() }}">
<script defer src="https://cdn.jsdelivr.net/npm/[email protected]/dist/cdn.min.js"></script>

// 런타임 등록 (Runtime registration)
Sidekick::registerProvider('ollama', function ($app) {
return new OllamaProvider(config('sidekick.providers.ollama'));
...

use PapaRascalDev\Sidekick\Facades\Sidekick;
use PapaRascalDev\Sidekick\Responses\TextResponse;
use PapaRascalDev\Sidekick\ValueObjects\Meta;
...