Microsoft、Azure AI Foundry の非公開シェルツール仕様を検証──Python SDK で未掲載機能の挙動を確認
公式ドキュメントに未記載の shell ツールを Azure AI Foundry の SDK で検証し、ネットワーク設定の実装状況を特定した。
リリース: 2026-09-01 · 読了 2 分記事の要約
1. 核心（What）
- Azure AI Foundry（旧 Microsoft Foundry）のエージェント向けツールとして shell が利用可能であり、モデルが生成したコマンドを専用コンテナで実行できる。
- 公式ドキュメントのツール一覧表には shell や一部のプレビュー機能が記載されていないが、SDK の ToolboxToolType には含まれている。
- Python SDK azure-ai-projects 2.6.0 を用いた実測により、{\"type\": \"shell\\-type\"} のペイロードがサービス側で受け付けられることが確認されている。
- Hosted shell の実体は Debian 12 および Python 3.11 環境であり、既定では外部ネットワークへのアクセスを持たない設計となっている。
2. 影響（Why）
- ドキュメントと実環境の乖離の特定: 公式ドキュメントに記載のない機能を SDK の型定義から逆theり検証することで、実装可能な機能の全容を正確に把握できる。
- 国内開発チームへの影響: 国内のクラウド基盤でエージェントを構築するチームは、非公式機能の挙動依存を避け、堅牢なエラーハンドリングを設計に組み込む必要がある。
3. 根拠・詳細（How）
- SDK を用いた ToolboxToolType の列挙検証: azure-ai-projects 2.6.0 の ToolboxToolType を用いて 16 種類のツール定義を列挙し、API への最小ペイロード送信により 200 OK で保存されることを確認した。
- Hosted shell の実行環境仕様: Debian 12 ベースのコンテナに Python 3.11 がプリインストールされ、作業ディレクトリは /mnt/data、タイムアウトは作成から 1 時間に設定されている。
4. 展望・課題（Next）
- ネットワークポリシーの挙動確認: allowlist によるネットワーク制限が実際の実行時にどのように適用されるかの検証が今後の課題となる。