Agents Arcadia
Agents Arcadia は、LLM(Large Language Model)を活用した柔軟なワークフロー自動化フレームワークです。
本プロジェクトは、LangGraph と langchain-openai を活用し、ユーザーのリクエストに基づいた動的な処理やツール呼び出しを実現します。
例えば、足し算、割り算(ゼロ除算エラーチェック付き)、数値比較といった基本的なツールを組み合わせることで、記事自動投稿やその他自動化シナリオへの応用が可能です。
特徴
-
モジュール化された構成:
nodes,prompts,states,tools,workflowsなどのディレクトリに機能が分割され、拡張性と保守性を向上。 -
LLM による動的判断:
langchain-openai を利用して、ユーザーリクエストに応じたツールの呼び出しや分岐処理を自動化します。 -
ツールの統合:
足し算、割り算、数値比較などのツールを標準装備。各ツールは柔軟に拡張可能です。 -
柔軟なワークフロー設計:
LangGraph を用いた分岐やエラーハンドリングを含む複雑なワークフローの構築が容易です。
インストール
PyPI で公開されている場合、以下のコマンドでインストールできます:
pip install agentsarcadia
使い方
以下は、簡単なワークフローを実行する例です。
この例では、ユーザーリクエストに基づき、LLM の判断を経て適切なツール(例:足し算)が呼び出されます。
import os
from dotenv import load_dotenv
from langchain_openai import ChatOpenAI
from agentsarcadia.tools.add import add_tool
from agentsarcadia.tools.divide import divide_tool
from agentsarcadia.tools.compare_num import compare_tool
from agentsarcadia.tool_registry import ToolRegistry
from agentsarcadia.workflows.simple_flow import create_simple_workflow
from agentsarcadia.prompts.calculate import get_prompt
# .envファイルから環境変数を読み込む
load_dotenv()
# ChatOpenAIの初期化(temperature=0 で決定的な応答)
# 環境変数からAPIキーを取得
llm = ChatOpenAI(temperature=0, model_name="gpt-4o-mini", api_key=os.environ.get("OPENAI_API_KEY"))
# プロンプトを取得
prompt = get_prompt()
def setup_tools():
"""利用可能なツールを設定する"""
tool_registry = ToolRegistry()
tool_registry.register_tools({
"足し算": add_tool,
"割り算": divide_tool,
"数値比較": compare_tool,
})
return tool_registry
if __name__ == "__main__":
# ユーザーからのリクエスト例
# user_request = "3.11と3.9はどちらが大きいですか?"
# user_request = "3と5を足してください"
user_request = "10と3で割り算してください"
# ツールの設定
tool_registry = setup_tools()
# ワークフローの構築
graph = create_simple_workflow(llm, prompt, tool_registry)
graph.get_graph().draw_mermaid_png(output_file_path="workflow.png")
# 初期状態の作成
initial_state = {"user_request": user_request}
# ワークフローの実行
result = graph.invoke(initial_state)
print("最終結果:", result["result"])
詳細なサンプルコードは、sample ディレクトリ内のコードもご参照ください。
コントリビューション
本プロジェクトへの貢献を歓迎します。
- リポジトリをフォークしてください。
- 新しいブランチを作成して変更を加えてください。
- プルリクエストを作成し、変更内容の説明を記載してください。
詳細は CONTRIBUTING.md をご確認ください。
ライセンス
このプロジェクトは MIT License の下で公開されています。
Metadata
Release files for agentsarcadia 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agentsarcadia-0.1.4.tar.gz | 9.4 kB | Without provenance | Details for agentsarcadia-0.1.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agentsarcadia-0.1.4-py3-none-any.whl | Python 3 | none | any | Details for agentsarcadia-0.1.4-py3-none-any.whl |
Total release size: 22.0 kB
Release files / agentsarcadia-0.1.4.tar.gz
| Download URL | agentsarcadia-0.1.4.tar.gz |
|---|---|
| Size | 9.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
45f98363f0d9af0afd76fae29fd8dca56d4014e5281a1304a4ddf4533bd38039
|
|
BLAKE2b-256 checksum How to use checksums |
edde92c7eb29fb68773e8dcf6170e2481707e702fa2cda3e14fceb4d91fbd086
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.9
|
Release files / agentsarcadia-0.1.4-py3-none-any.whl
| Download URL | agentsarcadia-0.1.4-py3-none-any.whl |
|---|---|
| Size | 12.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8669bc8a916a17c401680a53c84537bdd50903a83d59a571f1f82e12845a4ca7
|
|
BLAKE2b-256 checksum How to use checksums |
e2d3ef2500108e15be37747cb8bbf272d07bd1f28b4ebe042a7ffd0c96ef23ce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.9
|
Security for agentsarcadia 0.1.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.