Agently 开源项目安装与使用指南

2026-01-16 10:29:15作者：虞亚竹Luna

🚀 Build AI agent native application in very few code 💬 Easy to interact with AI agent in code using structure data and chained-calls syntax 🧩 Enhance AI Agent using plugins instead of rebuild a whole new agent

项目地址：https://gitcode.com/gh_mirrors/ag/Agently

目录结构概览

在克隆或下载 Agently 的源代码库之后，你会看到以下主要目录与文件：

src/: 包含了所有的源代码，这里是开发的核心区域。
- agents.py: 定义了代理（Agents）类以及创建代理的方法。
- settings.py: 存储所有配置选项，默认模型选择等。
- utils.py: 提供一系列实用工具函数。
tests/: 所有单元测试将在这里进行。
- test_agents.py: 测试代理功能是否正常运行。
- test_utils.py: 对 utils 文件中的工具方法进行验证。
docs/: 文档资料存放位置，详细说明 Agently 各部分工作原理。
- installation.md: 安装指导，包括环境搭建和基本设置。
- usage.md: 使用指南，如何操作代理和配置参数。
README.md: 主要介绍 Agently 是什么，它的目标是什么，以及简单的快速入门示例。
.gitignore: 设置哪些文件不需要被 git 版本控制系统跟踪，如日志文件、编译产物或敏感配置。
LICENSE: 指定项目的许可协议，Agently 使用 Apache 2.0 许可证。
requirements.txt: 列出项目依赖的所有外部库及其版本号。

启动文件简介

Agently 的主要入口点是位于 src/agents.py 的 create_agent() 方法，它是构建代理的基础。此方法会基于提供的参数初始化一个代理实例，并且可以对其进行自定义设置以适应不同的应用场合。例如，你可以通过调用该方法并传递特定模型（如 "Claude" 或者 "OpenAI"），来指定代理使用的预训练大模型。

示例代码片段

import Agently

agent = (
    Agently.create_agent()
    .set_settings("current_model", "Claude")
    .set_settings("model Claude auth",
                  {"api_key": "YOUR_API_KEY"})
)

上面的例子展示了如何创建一个名为 agent 的代理实例，这里设定了它使用的是 Claude 模型，并提供了相应的 API 密钥用于认证。

配置文件说明

src/settings.py:

这个文件包含了全局配置设定，比如默认应答模型、代理认证信息以及一些高级控制选项。其设计目的是为了方便地调整代理的行为而无需修改大量其他代码。
```
CURRENT_MODEL = 'Claude'
MODEL_AUTH = {
    'Claude': {'api_key': 'YOUR_CLAUDE_API_KEY'},
    'OpenAI': {'api_key': 'YOUR_OPENAI_API_KEY'}
}
```
在上述配置中，我们指定了当前活跃的模型是 Claude，并且给每种支持的模型都预留了各自的 API 认证字段。