agent/php/Services/AgenticManager.php
2026-03-21 11:10:44 +00:00

138 lines
3.7 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
declare(strict_types=1);
namespace Core\Mod\Agentic\Services;
use Illuminate\Support\Facades\Log;
use InvalidArgumentException;
class AgenticManager
{
/** @var array<string, AgenticProviderInterface> */
private array $providers = [];
private string $defaultProvider = 'claude';
public function __construct()
{
$this->registerProviders();
}
/**
* Get an AI provider by name.
*/
public function provider(?string $name = null): AgenticProviderInterface
{
$name = $name ?? $this->defaultProvider;
if (! isset($this->providers[$name])) {
throw new InvalidArgumentException("Unknown AI provider: {$name}");
}
return $this->providers[$name];
}
/**
* Get the Claude provider.
*/
public function claude(): ClaudeService
{
return $this->providers['claude'];
}
/**
* Get the Gemini provider.
*/
public function gemini(): GeminiService
{
return $this->providers['gemini'];
}
/**
* Get the OpenAI provider.
*/
public function openai(): OpenAIService
{
return $this->providers['openai'];
}
/**
* Get all available providers.
*
* @return array<string, AgenticProviderInterface>
*/
public function availableProviders(): array
{
return array_filter(
$this->providers,
fn (AgenticProviderInterface $provider) => $provider->isAvailable()
);
}
/**
* Check if a provider is available.
*/
public function isAvailable(string $name): bool
{
return isset($this->providers[$name]) && $this->providers[$name]->isAvailable();
}
/**
* Set the default provider.
*/
public function setDefault(string $name): void
{
if (! isset($this->providers[$name])) {
throw new InvalidArgumentException("Unknown AI provider: {$name}");
}
$this->defaultProvider = $name;
}
/**
* Register all AI providers.
*
* Logs a warning for each provider whose API key is absent so that
* misconfiguration is surfaced at boot time rather than on the first
* API call. Set the corresponding environment variable to silence it:
*
* ANTHROPIC_API_KEY Claude
* GOOGLE_AI_API_KEY Gemini
* OPENAI_API_KEY OpenAI
*/
private function registerProviders(): void
{
// Use null coalescing since config() returns null for missing env vars
$claudeKey = config('services.anthropic.api_key') ?? '';
$geminiKey = config('services.google.ai_api_key') ?? '';
$openaiKey = config('services.openai.api_key') ?? '';
if (empty($claudeKey)) {
Log::warning("Agentic: 'claude' provider has no API key configured. Set ANTHROPIC_API_KEY to enable it.");
}
if (empty($geminiKey)) {
Log::warning("Agentic: 'gemini' provider has no API key configured. Set GOOGLE_AI_API_KEY to enable it.");
}
if (empty($openaiKey)) {
Log::warning("Agentic: 'openai' provider has no API key configured. Set OPENAI_API_KEY to enable it.");
}
$this->providers['claude'] = new ClaudeService(
apiKey: $claudeKey,
model: config('services.anthropic.model') ?? 'claude-sonnet-4-20250514',
);
$this->providers['gemini'] = new GeminiService(
apiKey: $geminiKey,
model: config('services.google.ai_model') ?? 'gemini-2.0-flash',
);
$this->providers['openai'] = new OpenAIService(
apiKey: $openaiKey,
model: config('services.openai.model') ?? 'gpt-4o-mini',
);
}
}