> **⚠️ Elysia 处于测试阶段！**
>
> 如果您遇到任何问题，请[在 GitHub 上打开问题](https://github.com/weaviate/elysia/issues)。
[](https://pepy.tech/projects/elysia-ai) [](https://elysia.weaviate.io/)
Elysia 是一个代理平台，旨在使用决策树中的工具。决策代理根据其环境和上下文动态决定使用哪些工具。您可以使用自定义工具或使用旨在检索 Weaviate 集群中的数据的预构建工具。
[阅读文档！](https://weaviate.github.io/elysia/)
> ? 不要忘记查看 [前端的 Github 存储库](https://github.com/weaviate/elysia-frontend)！
安装非常简单：
````bash
pip 安装 elysia-ai
````
### 在这里观看我们最新的 Elysia 视频：
## 目录
- [开始使用（应用程序）](#get-started-app)
- [开始 (Python)](#get-started-python)
- [安装](#installation-bash-linuxmacos)
- [PyPi（推荐）]（#pypi-推荐）
- [GitHub](#github)
- [配置设置](#configuring-settings)
- [架构](#architecture)
- [开源精神](#open-source-spirit-)
- [常见问题解答](#faq)
## 开始使用（应用程序）
通过运行应用程序
````bash
艾丽西亚开始
````
然后在浏览器中前往“localhost:8000”，导航至设置页面，添加所需的 API 密钥、Weaviate 云集群详细信息并指定您的模型。可以选择使用 `--port` 来指定 Elysia 将在哪个端口上运行。
或者，我们创建了 Elysia 的演示版本（速率受限、固定数据集）来进行实验。找到它：https://elysia.weaviate.io/
## 开始 (Python)
要使用 Elysia，您需要在“.env”文件中设置模型和 API 密钥，或者在配置中指定它们。 [请参阅设置页面以开始。](https://weaviate.github.io/elysia/setting_up/)
Elysia 的使用非常简单：
````蟒蛇
来自 elysia 导入工具，树
树 = 树()
@工具（树=树）
异步 def add(x: int, y: int) -> int:
返回 x + y
tree("9009 和 6006 的和是多少？")
````
Elysia 已预先配置为能够连接到您的 [Weaviate](https://weaviate.io/deployment/serverless) 集群并与之交互！
````蟒蛇
进口艾丽西亚
树 = elysia.Tree()
响应，对象=树（
“电子商务系列中最昂贵的 10 件商品是什么？”,
collection_names = [“电子商务”]
）
````
这将使用内置的开源_query_工具或_aggregate_工具与您的W进行交互