pydantic/pydantic-ai-harness

TL;DR

Pydantic AI Harnessは、Pydantic AIエージェントをフル機能の自律型ワーカーに変えるプラグインスタイルのケイパビリティのライブラリです。ファイルシステムアクセス、シェルコマンド、ウェブ検索、メモリ、プランニング、サブエージェント、安全ガード、耐久性のある実行、そして多くのSaaS統合のためのツールがバンドルされています。必要なピース（例：既製のCoderハーネス）を組み合わせて、Agentのcapabilitiesリストに追加します。

---

機能

• 50以上のケイパビリティのカタログを提供 – それぞれが自己完結型のユニット（ツール、メモリストア、ガードなど）で、任意のpydantic_ai.Agentに追加できます。
• 既製のハーネスには以下が含まれます：
  • Coder – ファイル編集、永続的なシェル、委任、自律的なコーディングワークフロー。
  • Researcher – ウェブ検索、ページ取得、サブリサーチャーへの委任。
• 実行環境ヘルパー：安全なファイルシステムアクセス、サンドボックス化されたシェル、オプションのModalクラウドサンドボックス。
• ツール統合：GitHub、Linear、Notion、Google Workspace、Slack、その他多くのSaaSサービス向けのMCPまたはホスト型API経由の統合。
• ウェブ＆リサーチユーティリティ：DuckDuckGoフォールバック検索、Exa、You.com、Playwrightブラウザ制御など。
• プランニング＆オーケストレーション – モデル所有のタスクプラン、サブエージェント、動的ワークフロー、バックグラウンド並行ツール。
• コンテキスト管理 – 圧縮、ツール出力制限、コードモード実行、スライディングウィンドウトリミング。
• メモリ＆ナレッジ – 永続的なノートブック、会話検索、オンデマンドスキル読み込み、リポジトリコンテキストヒント。
• 安全性＆制御 – ガードレール、プロンプトインジェクション防御、コスト制限、ヒューマン・イン・ザ・ループツール承認、軌道判定。
• 自己拡張 – エージェントは実行中に新しいケイパビリティを生成して永続化できます。
• 耐久性のある実行 – Temporal、DBOS、Prefect、Airflowなどを介して再起動後も実行が継続; AWS Lambdaチェックポイント; ステップ永続化バックエンド。
• 可観測性 – OpenTelemetryスパン、Logfire統合、管理されたプロンプト。

対象者

• 長期間実行する必要がある自律エージェントを構築する開発者（例：コードベースの修正、トピックのリサーチ）で、堅牢なツール、メモリ、安全性を必要とする方。
• 低レベルの配管を書かずにカスタムAIエージェントスタックを構成したいチーム – 必要なケイパビリティをインポートするだけです。
• 耐久性、可観測性、コスト制御を必要とする運用/本番チーム。

始め方

# uvを使用（推奨）
uv add "pydantic-ai-harness[anthropic]"
# またはpipで
pip install "pydantic-ai-harness[anthropic]"

from pydantic_ai import Agent
from pydantic_ai_harness import Coder

agent = Agent('anthropic:claude-fable-5', capabilities=[Coder()])
result = agent.run_sync('Fix the bug in tests/test_parser.py')
print(result.output)

フルCLIエクスペリエンスの場合：

uvx --with "pydantic-ai-harness[coder]" clai -a pydantic_ai_harness.coder:coder_agent -m anthropic:claude-fable-5

必要に応じて、メモリやウェブ検索などのケイパビリティを追加します：

from pydantic_ai.capabilities import WebSearch
from pydantic_ai_harness.memory import FileStore
from pydantic_ai_harness import Memory

agent = Agent(
    'openai:gpt-5.6-sol',
    capabilities=[Coder(), WebSearch(), Memory(FileStore('.agent-memory'))],
)

---

内部の構成（厳選ハイライト）

カテゴリ	例のケイパビリティ	中核アイデア
ハーネス	Coder、Researcher	ドロップインできる既製スタック。
ファイルシステム	FileSystem	ルート下での安全な読み取り/書き込み/リスト、オプションのripgrep。
シェル	Shell	許可/拒否リスト、タイムアウト、永続状態を持つコマンド実行。
SaaS統合	GitHub、Slack、Notion、Linear …	MCPまたはホスト型サーバーを介した直接APIレベルアクセス。
ウェブ	WebSearch、Exa、Playwright	ウェブ検索、ページ取得、実際のブラウザ操作。
プランニング	Planning	ライブリマインダー付きのモデル所有タスクプラン。
メモリ	Memory (FileStore、Postgresなど)	実行間の永続的で検索可能なノートブック。
安全性	Guardrails、PromptInjectionDefender、Spend	入力/出力検証、コスト制限の強制、リスクのあるツール結果のブロック。
耐久性	Durable execution、Step Persistence、AWS Lambda durability	実行のチェックポイント、再起動への耐性、ワークフローエンジンとの統合。
可観測性	Instrumentation、Logfire MCP	OpenTelemetryスパン、Logfireトレース。

---

なぜ重要か

Pydantic AIは、型付きエージェントループとツール呼び出しサポートをすでに提供しています。Pydantic AI Harnessはそれを本番運用可能なプラットフォームに変えます：コードを編集し、ウェブを閲覧し、SaaSツールと相互作用し、過去の作業を記憶し、予算内に留まり、プロセスがクラッシュしても実行を継続できるエージェントを構築できます。すべてのピースはモジュール式で型付き、ドキュメント化されており、既製のハーネスから始めて、個々のケイパビリティを剥がしたり置き換えたりして、正確なユースケースに合わせることができます。

---

リンク＆リソース

• ドキュメント: https://pydantic.dev/docs/ai/harness
• GitHubリポジトリ(アーカイブ済み): https://github.com/pydantic/pydantic-ai-harness
• メインPydantic AIリポジトリ: https://github.com/pydantic/pydantic-ai
• PyPIパッケージ: https://pypi.org/project/pydantic-ai-harness/
• Slackコミュニティ: https://logfire.pydantic.dev/docs/join-slack/

---

上記のすべての情報はリポジトリのREADMEから直接取得されており、追加の機能は推定されていません。