ActiveAgent 使用教程

ActiveAgent 使用教程

activeagent ActiveAgent Rails framework for Agent Apps 项目地址: https://gitcode.com/gh_mirrors/ac/activeagent

1. 项目介绍

ActiveAgent 是一个基于 Ruby on Rails 的框架，用于构建 Agent 应用。它提供了与 AI 服务的集成，使得开发者可以轻松地创建与 AI 交互的应用程序。ActiveAgent 框架支持定义 Agent 类，以及与之相关的动作和提示，使得 AI 交互更加模块化和可重用。

2. 项目快速启动

环境准备

确保您的系统中已经安装了 Ruby 和 Rails。您可以通过以下命令检查安装情况：

ruby -v
rails -v

安装 ActiveAgent

将 ActiveAgent 添加到您的 Rails 项目的 Gemfile 中：

gem 'activeagent'

然后执行以下命令安装依赖：

bundle install

初始化 ActiveAgent

在 Rails 项目中运行以下命令以安装 ActiveAgent 的初始配置：

rails generate active_agent:install

这将在项目中创建以下文件：

• config/initializers/active_agent.rb
• config/active_agent.yml
• app/agents/application_agent.rb

配置 ActiveAgent

编辑 config/active_agent.yml 文件以配置 AI 服务提供者（例如 OpenAI）的相关设置：

development:
  openai:
    service: "OpenAI"
    api_key: "<your_openai_api_key>"
    model: "gpt-3.5-turbo"
    temperature: 0.7

production:
  openai:
    service: "OpenAI"
    api_key: "<your_openai_api_key>"
    model: "gpt-3.5-turbo"
    temperature: 0.7

确保替换 <your_openai_api_key> 为您的 OpenAI API 密钥。

创建 Agent

使用以下命令创建一个新的 Agent：

rails generate active_agent:agent example

这将创建一个名为 ExampleAgent 的 Agent 类及其相关的文本模板视图。

运行 Rails 服务器

启动 Rails 服务器：

rails server

现在，您的 ActiveAgent 应用已经准备好进行开发了。

3. 应用案例和最佳实践

创建一个简单的 Agent

下面是一个简单的 Agent 示例，它定义了搜索、预订和计划旅行的动作：

class TravelAgent < ApplicationAgent
  def search
    prompt { |format| format.text { render plain: "Searching for travel options" } }
  end

  def book
    prompt { |format| format.text { render plain: "Booking travel plans" } }
  end

  def plans
    prompt { |format| format.text { render plain: "Making travel plans" } }
  end
end

使用 Action Prompt

Action Prompt 提供了一个结构化的接口来组合 AI 交互，包括消息、动作/工具和对话上下文。下面是如何使用 Action Prompt 来发送一个消息并请求动作的示例：

agent.prompt(
  message: "Find hotels in Paris",
  actions: [
    {
      name: "search",
      params: { query: "hotels paris" }
    }
  ]
)

4. 典型生态项目

ActiveAgent 框架可以用于构建各种类型的 Agent 应用，例如：

• 客户支持 Agent：自动回答常见问题，提供客户服务。
• 旅行规划 Agent：帮助用户规划旅行路线和预订。
• 数据分析 Agent：分析数据并提供洞察。

ActiveAgent 的开源社区也在不断增长，开发者可以共享和重用 Agents，以加速开发过程并提高效率。

activeagent ActiveAgent Rails framework for Agent Apps 项目地址: https://gitcode.com/gh_mirrors/ac/activeagent