Volcengine Agent Development Kit (VeADK)

概要

• Volcengineの大規模モデルプラットフォーム（ARK）上で動作するAIエージェントを構築するためのPythonライブラリです。軽量なランタイム、ツール統合ヘルパー、オプションのWeb UI/Studioコンポーネントをバンドルしています。

主な機能

• エージェント抽象化 – veadk.Agent は言語モデル（例：VolcengineでホストされているOpenAI互換モデル）をラップし、シンプルな run(prompt) 非同期APIを提供します。
• ツール拡張 – Feishuボットチャネル、データベースバックアップの短期記憶、評価ツール、CLIの組み込みサポート。
• AgentKit統合 – ワンライナーファクトリ（create_agentkit_app）が、ヘルスチェック、メタデータ、Studio互換エンドポイント（動的ツール、Web検索、ナレッジベース、長期記憶など）を公開するFastAPIアプリを生成します。
• YAMLによる設定 – プロジェクトルートの config.yaml で、モデルプロバイダー、APIエンドポイント、認証情報、オプションのツール設定を指定できます。
• 開発者リソース – Jupyterチュートリアル、Google-Colabリンク、包括的なドキュメント。

はじめに

# PyPIからインストール（コア+オプション拡張）
pip install veadk-python[extensions]

from veadk import Agent
import asyncio

agent = Agent()  # config.yamlを自動的に読み取ります
result = asyncio.run(agent.run("hello!"))
print(result)

典型的なワークフロー

1. Volcengine ARK APIキーとモデル名を含む config.yaml を作成します。
2. コード内で Agent（または名前付きサブエージェント）をインスタンス化します。
3. オプションで、create_agentkit_app でラップして、Studioが管理できるFastAPIサーバー（メタデータ、ツールルーティング、フィードバック収集）を公開します。
4. サーバーをデプロイするか、ローカルで実行します。提供されているFeishuチャネル拡張を使用して、エージェントをFeishuボットに接続します。

拡張性

• データベース拡張 – uv sync --extra database で永続的な短期記憶を追加します。
• 評価拡張 – フィードバック用の評価セット処理を追加します。
• CLI拡張 – エージェントの実行とセッション管理のためのコマンドラインユーティリティを提供します。

コミュニティとサポート

• Apache 2.0の下でオープンソース。
• ドキュメントサイト：https://volcengine.github.io/veadk-python/
• リアルタイムヘルプ用のディスカッショングループ（リポジトリ内のQRコード）。
• セキュリティポリシーとCIテストが実施されています。貢献には pytest の合格が必要です。

誰が使うべきか

• Volcengineのインフラストラクチャ上でLLM搭載エージェントを迅速にプロトタイプまたは出荷したい開発者。
• ボイラープレートのネットワークコードを書かずに、組み込みの統合（Feishu、ナレッジベース、メモリストア）を必要とするチーム。
• Studio UIに合わせたPython SDKを望むVolcengine AgentKitプラットフォームのユーザー。