第二章：LangChain快速入门

# 第二章：LangChain快速入门

## 2.1 安装和配置LangChain

在开始使用LangChain之前，首先需要进行安装和配置。LangChain是一个基于语言模型开发应用程序的框架，支持多种语言模型提供商，如OpenAI和Anthropic等。以下是安装和配置的基本步骤：

1. **安装Node.js和npm**：确保你的系统上已经安装了Node.js和npm。你可以通过以下命令检查是否已安装：
    ```bash
    node -v
    npm -v
    ```

2. **创建一个新的项目目录**：
    ```bash
    mkdir my-langchain-app
    cd my-langchain-app
    ```

3. **初始化npm项目**：
    ```bash
    npm init -y
    ```

4. **安装LangChain**：
    ```bash
    npm install langchain
    ```

5. **配置环境变量**：为了使用特定的语言模型提供商，如OpenAI，你需要设置相应的API密钥。可以在项目根目录下创建一个`.env`文件，并添加以下内容：
    ```env
    OPENAI_API_KEY=your_openai_api_key
    ```

6. **加载环境变量**：在项目中使用`dotenv`库来加载环境变量。首先安装`dotenv`：
    ```bash
    npm install dotenv
    ```
    然后在你的主文件（如`index.js`）中添加以下代码：
    ```javascript
    require('dotenv').config();
    ```

通过以上步骤，你已经完成了LangChain的基本安装和配置。接下来，我们将构建第一个LangChain应用。

## 2.2 构建第一个LangChain应用

在这一节中，我们将构建一个简单的LangChain应用程序，该应用程序使用OpenAI的GPT-3模型来生成文本。以下是具体的代码案例：

1. **创建主文件**：在项目根目录下创建一个`index.js`文件，并添加以下代码：
    ```javascript
    const { OpenAI } = require('langchain/models');
    const { PromptTemplate } = require('langchain/prompts');
    const { LLMChain } = require('langchain/chains');

// 初始化OpenAI模型
    const model = new OpenAI({
      openAIApiKey: process.env.OPENAI_API_KEY,
      temperature: 0.9,
    });

// 创建一个Prompt模板
    const prompt = new PromptTemplate({
      template: 'Generate a creative story about {topic}',
      inputVariables: ['topic'],
    });

// 创建一个LLMChain
    const chain = new LLMChain({
      llm: model,
      prompt: prompt,
    });

// 运行链并生成文本
    async function run() {
      const res = await chain.call({ topic: 'a magical forest' });
      console.log(res.text);
    }

run();
    ```

2. **运行应用程序**：在终端中运行以下命令：
    ```bash
    node index.js
    ```

通过以上代码，你已经构建了一个简单的LangChain应用程序，该应用程序使用OpenAI的GPT-3模型生成关于“a magical forest”的创意故事。

## 2.3 运行和测试

在这一节中，我们将讨论如何运行和测试你的LangChain应用程序。确保你的应用程序能够正确运行，并且生成的文本符合预期。

1. **运行应用程序**：如前所述，你可以通过在终端中运行以下命令来运行应用程序：
    ```bash
    node index.js
    ```

2. **测试应用程序**：为了确保应用程序的稳定性和可靠性，你可以编写一些测试用例。以下是一个简单的测试用例示例，使用`jest`进行测试：

- 首先安装`jest`：
      ```bash
      npm install --save-dev jest
      ```

- 在项目根目录下创建一个`__tests__`目录，并在其中创建一个`index.test.js`文件，添加以下代码：
      ```javascript
      const { OpenAI } = require('langchain/models');
      const { PromptTemplate } = require('langchain/prompts');
      const { LLMChain } = require('langchain/chains');

test('Generate a creative story about a magical forest', async () => {
        const model = new OpenAI({
          openAIApiKey: process.env.OPENAI_API_KEY,
          temperature: 0.9,
        });

const prompt = new PromptTemplate({
          template: 'Generate a creative story about {topic}',
          inputVariables: ['topic'],
        });

const chain = new LLMChain({
          llm: model,
          prompt: prompt,
        });

const res = await chain.call({ topic: 'a magical forest' });
        expect(res.text).toBeDefined();
        expect(res.text.length).toBeGreaterThan(0);
      });
      ```

- 在`package.json`中添加测试脚本：
      ```json
      "scripts": {
        "test": "jest"
      }
      ```

- 运行测试：
      ```bash
      npm test
      ```

通过以上步骤，你已经成功运行和测试了你的LangChain应用程序。确保你的应用程序在各种情况下都能稳定运行，并且生成的文本符合预期。

通过本章的学习，你应该已经掌握了LangChain的基本安装、配置、构建和测试流程。接下来，你可以进一步探索LangChain的高级功能和更多复杂的应用场景。

专栏目录