メインコンテンツまでスキップ

エージェントSDK

agenticstar-platform SDK は、AGENTIC STAR プラットフォーム上で動作するカスタム AI エージェントを Python で開発するためのインフラ SDK です。エージェントロジックは開発者が自由に設計し、SDK はデータベース・イベント配信・メモリ・ストレージ・RAG・セキュリティなどのプラットフォーム基盤を提供します。

エージェントSDK とは​

項目値
パッケージagenticstar-platform
バージョンv0.5.40
言語Python 3.12+
配布PyPI
設計思想SDK はインフラのみ。エージェントロジックはユーザー自由

モジュール構成​

SDK は 11 のモジュールで構成されています。必要なモジュールだけを extras で選択インストールできます。

モジュール説明主要クラス
events非同期イベント配信（SSE / Webhook / DB）EventEmitter, StreamingEvent
dbPostgreSQL 接続 + Azure AD 認証PostgreSQLManager, DataAccess
ragQdrant ベクトル検索 + Azure OpenAI EmbeddingQdrantManager, EmbeddingGenerator
storageマルチクラウドストレージ（Azure / S3 / GCS）AzureBlobStorageClient, S3StorageClient
authAGENTIC STAR 認証 API クライアントAgenticStarAuthClient
memoryセマンティックメモリ（Mem0 + Qdrant）SemanticMemoryClient
securityコンテンツモデレーション + PII 検出AzureSecurityClient, ContentSafetyValidator
common共通ユーティリティ（バリデーション・シークレットマスク）SecretMasker, validate_identifier
meteringLLM 利用量・コスト計測（台帳記録 + 日次集計, v0.5.15+）UsageMeter
runnerMarketplace 互換の実行ライフサイクル（identity 検証 → 入力取得 → 実行 → 結果保存/Webhook → terminal 正確に 1 回 → cleanup, v0.5.30+）run_marketplace_agent
audit行為監査台帳（承認・ツール認可・ポリシー違反等の append-only 記録。本文は digest 化して渡す設計, v0.5.31+。alerts writer は v0.5.32+）ActionAudit, GatewayActionAudit, GuardrailAlertWriter, GuardrailAlertAggregates

このほか、credential 不要で DB / RAG / storage の統合 journey を 1 コマンド体験できる Local Integration Lab（python -m agenticstar_platform.lab, v0.5.35+）を同梱しています。 詳細は クイックスタート の Lab 節を参照してください。

クイックスタート​

curl
pip install agenticstar-platform[all]==0.5.40
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="処理を開始します")

始め方​

対象手順
新規開発クイックスタート で最小構成のエージェントを構築
既存エージェントの移行アーキテクチャガイド でモジュール構成を理解してから段階的に導入

ガイド​

リファレンス​