> For the complete documentation index, see [llms.txt](https://docs.neuron-ai.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neuron-ai.dev/neuron-v3-zh/gai-lan/getting-started.md).

# 安装

关于如何将 Neuron 安装到你的应用中并创建 Agent 的分步说明。

### 要求

* PHP：^8.1

### 从一个提示开始

复制并粘贴此初始提示，告诉你的编码代理如何在你的项目中安装和配置 Neuron AI。

```
你将要在这个项目中设置 Neuron AI，这是一个用于构建代理式应用程序的 PHP 框架， 
并且你必须按顺序遵循三个步骤。首先，安装框架： 
检查 composer.json，如果尚未要求 neuron-core/neuron-ai， 
运行 `composer require neuron-core/neuron-ai`。第二，安装随包提供的代理技能， 
在项目根目录运行 `npx skills add ./vendor/neuron-core/neuron-ai/skills -y`。 
这些技能是通过符号链接连接的，因此每当 Neuron 
通过 Composer 更新时，它们都会保持最新。从那以后，在你编写任何 Neuron 
代码之前，先加载相关技能，而不要依赖你对该框架的记忆，因为你的记忆可能 
描述的是较旧的版本。第三，弄清楚这是什么类型的应用。查看 composer.json 
和项目结构，以判断它是 Laravel 应用还是 Symfony 应用，然后 
激活匹配的技能：neuron-laravel-integration 或 neuron-symfony-integration。 
如果 Neuron 已经是应用的一部分，就逐项查看该技能的基础检查清单 
。报告哪些内容与推荐设置不同。如果 Neuron 还 
没有加入应用，请按照同样的检查清单进行首次设置。如果应用使用 
这两个框架都不是，请从使用 neuron-agent 技能的纯 PHP 代理开始。 
最后用简短总结说明你安装了什么以及你发现了什么。
```

### 安装

运行下面的命令来安装最新版本：

```bash
composer require neuron-core/neuron-ai
```

### 创建代理

你可以使用 Neuron CLI 轻松创建你的第一个代理：

{% tabs %}
{% tab title="Unix" %}

```bash
./vendor/bin/neuron make:agent App\\Neuron\\MyAgent
```

{% endtab %}

{% tab title="Windows" %}

```powershell
.\vendor\bin\neuron make:agent App\Neuron\MyAgent
```

{% endtab %}
{% endtabs %}

```php
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Agent\SystemPrompt;
use NeuronAI\Providers\Anthropic\Anthropic;

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        // 返回一个 AI 提供商（Anthropic、OpenAI、Ollama、Gemini 等）
        return new Anthropic(
            key: 'ANTHROPIC_API_KEY',
            model: 'ANTHROPIC_MODEL',
        );
    }

    public function instructions(): string
    {
        return (string) new SystemPrompt(
            background: ["你是一个使用 Neuron 框架创建的友好 AI 代理。"],
        );
    }
}
```

### 与代理对话

向代理发送提示以从底层 LLM 获取响应：

```php
use NeuronAI\Chat\Messages\UserMessage;

$message = MyAgent::make()
    ->setThreadId('chat_id')
    ->chat(new UserMessage("Hi, who are you?"))
    ->getMessage();

echo $message->getContent();
// 我是一个使用 Neuron 构建的友好 AI 代理，今天我能如何帮助你？
```

### 监控与调试

你使用 Neuron 构建的许多应用都会包含多个步骤以及多次 LLM 调用。随着这些应用变得越来越复杂，能够检查你的代理系统内部究竟发生了什么变得至关重要。做到这一点的最佳方式是使用 [Inspector](https://inspector.dev/).

{% embed url="<https://docs.inspector.dev/guides/neuron-ai>" %}

### 视频教程

{% embed url="<https://www.youtube.com/watch?v=oSA1bP_j41w>" %}
