LLM Agents PHP SDK 开源项目教程

1. 项目介绍

LLM Agents PHP SDK 是一个开源的 PHP 库，旨在帮助开发者构建和管理基于语言模型（LLM）的代理。这个框架支持开发者创建能够执行复杂任务、做出决策以及与各种工具和 API 交互的自主代理。通过该 SDK，开发者可以高效地将 LLM 功能集成到 PHP 应用中，从而创建能够理解用户输入、处理信息并根据这些处理执行动作的智能系统。

2. 项目快速启动

首先，确保您的开发环境已经安装了 Composer。接下来，通过以下命令安装 LLM Agents PHP SDK：

composer require llm-agents/agents

创建一个代理

以下是一个创建代理的基本示例：

use LLM\Agents\Agent\AgentAggregate;
use LLM\Agents\Agent\Agent;
use LLM\Agents\Solution\Model;
use LLM\Agents\Solution\ToolLink;
use LLM\Agents\Solution\metadataType;
use LLM\Agents\Solution\SolutionMetadata;

class SiteStatusCheckerAgent extends AgentAggregate {
    public const NAME = 'site_status_checker';

    public static function create(): self {
        $agent = new Agent(
            key: self::NAME,
            name: 'Site Status Checker',
            description: 'This agent checks the online status of websites.',
            instruction: 'You are a website status checking assistant. Your goal is to help users determine if a website is online. Use the provided tool to check site availability. Give clear, concise responses about a site\'s status.'
        );

        $aggregate = new self($agent);
        $aggregate->addMetadata(
            new SolutionMetadata(type: metadataType::Memory, key: 'check_availability', content: 'Always check the site\'s availability using the provided tool.'),
            new SolutionMetadata(type: metadataType::Configuration, key: 'max_tokens', content: 500)
        );

        $model = new Model(model: 'gpt-4o-mini');
        $aggregate->addAssociation($model);
        $aggregate->addAssociation(new ToolLink(name: CheckSiteAvailabilityTool::NAME));

        return $aggregate;
    }
}

实现一个工具

接下来，实现一个用于检查网站可访问性的工具：

use LLM\Agents\Tool\PhpTool;
use LLM\Agents\Tool\ToolLanguage;

class CheckSiteAvailabilityTool extends PhpTool {
    public const NAME = 'check_site_availability';

    public function __construct() {
        parent::__construct(
            name: self::NAME,
            inputSchema: CheckSiteAvailabilityInput::class,
            description: 'This tool checks if a given URL is accessible and returns its HTTP status code and response time.'
        );
    }

    public function getLanguage(): ToolLanguage {
        return ToolLanguage::PHP;
    }

    public function execute(object $input): string {
        $ch = curl_init($input->url);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HEADER => true,
            CURLOPT_NOBODY => true,
            CURLOPT_FOLLOWLOCATION => true,
            CURLOPT_MAXREDIRS => 10,
            CURLOPT_TIMEOUT => 30,
        ]);

        $startTime = microtime(true);
        $response = curl_exec($ch);
        $endTime = microtime(true);
        $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        $responseTime = round(($endTime - $startTime) * 1000, 2);
        curl_close($ch);

        $isOnline = $statusCode >= 200 && $statusCode < 400;

        return json_encode([
            'status_code' => $statusCode,
            'response_time_ms' => $responseTime,
            'is_online' => $isOnline,
        ]);
    }
}

输入模式

class CheckSiteAvailabilityInput {
    public function __construct(
        #[Field(title: 'URL', description: 'The full URL of the website to check')]
        public readonly string $url,
    ) {}
}

3. 应用案例和最佳实践

本节将介绍一些使用 LLM Agents PHP SDK 的实际案例和最佳实践。由于 SDK 提供了一个灵活的框架，开发者可以根据具体需求定制代理的行为。

• 监控网站状态：如前所示，可以创建一个代理来定期检查特定网站的状态，并在网站不可用时通知用户。
• 自动化任务执行：利用代理执行重复性任务，如数据抓取、报告生成等。

4. 典型生态项目

在 LLM Agents PHP SDK 的生态中，有一些典型的项目可以帮助开发者更快地启动和运行：

• sample-app：一个包含示例代理和 CLI 界面的示例应用程序，展示了 LLM Agents PHP SDK 的实际应用。

以上是 LLM Agents PHP SDK 的基本教程，希望对您的开发有所帮助。