エージェントSDK
agenticstar-platform SDK は、AGENTIC STAR プラットフォーム上で動作するカスタム AI エージェントを Python で開発するためのインフラ SDK です。エージェントロジックは開発者が自由に設計し、SDK はデータベース・イベント配信・メモリ・ストレージ・RAG・セキュリティなどのプラットフォーム基盤を提供します。
エージェントSDK とは
| 項目 | 値 |
|---|---|
| パッケージ | agenticstar-platform |
| バージョン | v0.5.3 |
| 言語 | Python 3.12+ |
| 配布 | PyPI |
| 設計思想 | SDK はインフラのみ。エージェントロジックはユーザー自由 |
モジュール構成
SDK は 8 つのモジュールで構成されています。必要なモジュールだけを extras で選択インストールできます。
| モジュール | 説明 | 主要クラス |
|---|---|---|
| events | 非同期イベント配信（SSE / Webhook / DB） | EventEmitter, StreamingEvent |
| db | PostgreSQL 接続 + Azure AD 認証 | PostgreSQLManager, DataAccess |
| rag | Qdrant ベクトル検索 + Azure OpenAI Embedding | QdrantManager, EmbeddingGenerator |
| storage | マルチクラウドストレージ（Azure / S3 / GCS） | AzureBlobStorageClient, S3StorageClient |
| auth | AGENTIC STAR 認証 API クライアント | AgenticStarAuthClient |
| memory | セマンティックメモリ（Mem0 + Qdrant） | SemanticMemoryClient |
| security | コンテンツモデレーション + PII 検出 | AzureSecurityClient, ContentSafetyValidator |
| common | 共通ユーティリティ（バリデーション・シークレットマスク） | SecretMasker, validate_identifier |
クイックスタート
curl
pip install agenticstar-platform[all]==0.5.3
Python
from agenticstar_platform.events import EventEmitter, EventType
from agenticstar_platform.db import PostgreSQLManager, PostgreSQLConfig, DataAccess
# データベース接続
db_manager = PostgreSQLManager(PostgreSQLConfig.from_toml("config.toml"))
da = DataAccess(db_manager)
await da.initialize()
# イベント配信
emitter = EventEmitter(execution_id="exec-001")
await emitter.emit_event(EventType.PHASE_START, message="処理を開始します")
始め方
| 対象 | 手順 |
|---|---|
| 新規開発 | クイックスタート で最小構成のエージェントを構築 |
| 既存エージェントの移行 | アーキテクチャガイド でモジュール構成を理解してから段階的に導入 |
ガイド
- アーキテクチャガイド — SDK のモジュール構成と設計思想
- デプロイガイド — Docker ビルドとプラットフォームへの登録
- イベント / ストリーミングガイド — SSE イベント配信の実装
- メモリガイド — セマンティックメモリ（Mem0）の活用
- ストレージガイド — マルチクラウドオブジェクトストレージ
- セキュリティガイド — コンテンツモデレーションと PII 検出
リファレンス
- SDK API リファレンス — 全モジュール・クラス・メソッドの完全仕様