reins は何をしますか?
アプリケーションに簡単に組み込める軽量エージェントハーネスで、LLMが安全かつ低コストで操作できるようにします。
概要
Reinsは、あなたのアプリケーションにLLMエージェントの制御を追加するためのシンプルな方法を提供します。このツールを使用すると、アプリケーションの機能をエージェントに公開し、自律的なタスク実行を安全に実現できます。
主な機能
- 軽量設計: 最小限の依存関係で、既存のプロジェクトに素早く統合できます。
- 安全な操作: LLMの誤ったアクションからシステムを保護するためのビルトイン安全機構を備えています。
- 低コスト: 効率的なAPI呼び出しとリソース管理により、運用コストを抑えます。
- プラットフォーム互換性: Claude Code、Cursor、Codexなどの主要なAIエージェントプラットフォームで動作します。
クイックスタート
pip install reins
または、ソースからビルドする場合:
git clone https://github.com/shamspias/reins
cd reins
pip install -e .
使用方法
Reinsをアプリケーションに統合する基本的な例を以下に示します。
import reins
# アプリケーションのアクションを定義
def get_user_data(user_id: str):
# ユーザーデータを取得するロジック
return {"id": user_id, "name": "John Doe"}
def send_email(to: str, subject: str, body: str):
# メール送信ロジック
print(f"Sending email to {to}: {subject}")
# ハーネスを作成
harness = reins.Harness()
# アクションを登録
harness.register_action("get_user_data", get_user_data, "Get user data by ID")
harness.register_action("send_email", send_email, "Send an email to a user")
# LLMエージェントにハーネスを渡す
# これにより、エージェントは登録されたアクションを使用できる
設定
環境変数または設定ファイルでReinsの動作をカスタマイズできます。
| 環境変数 | 説明 | デフォルト値 |
|---|---|---|
REINS_LOG_LEVEL | ログレベル | INFO |
REINS_MAX_RETRIES | アクション実行の最大リトライ回数 | 3 |
REINS_TIMEOUT | アクション実行のタイムアウト(秒) | 30 |
安全機構
Reinsは、LLMエージェントが予期しない動作をした場合に備えて、以下の安全機構を提供します。
- アクションの許可リスト: エージェントが実行できるアクションを制限できます。
- レート制限: 一定時間内のアクション実行回数を制限します。
- 入力検証: エージェントからの入力が適切かどうかを検証します。
開発
コントリビューションを歓迎します!以下の手順で開発を始めてください。
# リポジトリをクローン
git clone https://github.com/shamspias/reins.git
cd reins
# 開発用依存関係をインストール
pip install -e ".[dev]"
# テストを実行
pytest
ライセンス
このプロジェクトはMITライセンスの下で公開されています。詳細についてはLICENSEファイルを参照してください。
貢献
バグ報告、機能リクエスト、プルリクエストは大歓迎です。詳細はCONTRIBUTING.mdをご覧ください。
Reinsを使って、あなたのアプリケーションをよりスマートに、より安全に操作しましょう!