Mastra

用語・参照公式仕様のみ鮮度未確認

記事状態: 公開 · 最終確認: 未確認

要点

「Mastraの現行Docsは、TypeScript上のagent・処理の流れ・ツール・記憶情報・Studio・稼働状況を観測する仕組みを案内している。これは実装要素の存在根拠であり、全提供元・契約プラン・regionでの利用可否、業務品質、権限安全性、本番環境 SLOの保証ではない。」

現在の判断

ESTABLISHED: 公式DocsはMastraをTypeScript frameworkとして、agents、workflows、tools、記憶情報、モデル提供元形式、Studioでの生成・構築/test/manage、稼働状況を観測する仕組みを記載している。Docsの導入例にはツール input データ形式の定義/execute、agent登録、npmベースの実装入口がある。
NOT_ESTABLISHED: framework・Studio・モデル routerの機能記述は、全提供元/モデル、全契約プラン/region、全配備での利用可否、agent品質・安全性・SLA、実際の保存・削除条件を確立しない。

どこまで当てはまるか

エンタープライズAIコア / 実装 / 相互運用性 / ガバナンス / 監査 / 運用性。Mastraフレームワーク、Studio、モデルルーター、および外部プロバイダーを混同しないこと。

詳しく理解する

なぜ重要か

TypeScript/Node系でagent、処理の流れ、記憶情報、ツール、Studio、稼働状況を観測する仕組みを束ねる実装の現行境界を、OSS frameworkと管理製品のoverlayに分けて更新する。

対象範囲と前提

検討ポイント

現行のMastra公式ドキュメントにおいて、エージェント、一連の処理（workflows）、ツール、メモリ、Studio、オブザーバビリティ、およびモデル/プロバイダーの設定が、どの範囲まで明示されているか。

根拠資料の対応表

source_class=official project 仕様・利用方法の文書; exact_title=Get started with Mastra; 著者・組織=Mastra; canonical_url=https://mastra.ai/docs publication/update/access_date=現在の docs 参照日 2026-09-13 JST; バージョン/公開・提供/tag/commit/API 改訂版=現在の @mastra/core docs（docsは@mastra/core@latest等の導入を案内、固定バージョンなし）; supporting_locator=Get started / Agent and ツール setup / Mastra Studio / Quickstart（TypeScript framework、Agent/ツール、提供元/モデル形式、npm create mastra、Studioがagent/処理の流れ/ツールの生成・構築・test・manage interface、モデル routerへの言及）; evidence_label=VERIFIED_SPEC+PRODUCT_VOLATILE; 対応関係=裏付け+limit
source_class=official product 仕様・利用方法の文書; exact_title=稼働状況を観測する仕組み; 著者・組織=Mastra; canonical_url=https://mastra.ai/docs/observability/overview publication/update/access_date=現在の docs 参照日 2026-09-13 JST; バージョン/公開・提供/tag/commit/API 改訂版=現在の docs; supporting_locator=稼働状況を観測する仕組み overview（agent 実行、処理の流れ step、ツール call、モデル interactionを可視化する稼働状況を観測する仕組みの説明）; evidence_label=VERIFIED_SPEC+PRODUCT_VOLATILE; 対応関係=裏付け+文脈・入力情報

利用できる条件

Node/TypeScript版、@mastra/coreと関連packageの固定公開・提供、supported 提供元/モデル・資格情報・契約・地域、Studio/Server/保存領域/Auth/Deploy機能、記憶情報/稼働状況を観測する仕組み backend、ツール OAuth・RBAC・データ保持。

実装・運用

OSS/TypeScript framework 仕様・利用方法の文書 + PRODUCT_VOLATILE。Docs exampleとnpm導入案内は実装入口。管理Studio・外部接続・認証済み組織の利用環境・本番負荷試験は未実施。

確認・評価方法

公式ドキュメントが Studio のテスト、トレース、メトリクス、評価（evals）について案内していることは、機能が存在する根拠である。品質、安全性、コスト、レイテンシ、メモリの想起（recall）に関する独立した再現ベンチマークは、本パケットでは確認していない。不明（未確認事項）。

セキュリティとプライバシー

セキュリティ=ツールスキーマ、承認、RBAC（ロールベースのアクセス制御）、プロバイダーごとの権限の分離。プライバシー=メモリ・ストレージ・トレース・外部プロバイダーへの送信の記録。監査=エージェント/一連の処理/ツール/モデル/バージョン/状態の相関。コスト=ルーター選択・LLM・ツール・メモリ・トレース・再試行を含む。運用性=バージョン固定、移行、タイムアウト、同じ要求の再送で処理を重複させない仕組み、ロールバック、プロバイダーの停止を検証。

検証済みの適用範囲

Mastra 現行性 @mastra/core@1.71.0 as-of 2026-09-25. Keep OSS framework separate from Studio/Platform, 保存領域/稼働状況を観測する仕組み backends and 外部 providers. Durable 再開 is not exactly-once side-effect delivery. データ形式の定義/policy primitives are not 意味上の truth or 認可. Independent 本番環境 SLO/比較評価未確認事項; author-maintained duplicate-live-delivery issue retained as 反証.

確認できていること

ESTABLISHED: 公式DocsはMastraをTypeScript frameworkとして、agents、workflows、tools、記憶情報、モデル提供元形式、Studioでの生成・構築/test/manage、稼働状況を観測する仕組みを記載している。Docsの導入例にはツール input データ形式の定義/execute、agent登録、npmベースの実装入口がある。
NOT_ESTABLISHED: framework・Studio・モデル routerの機能記述は、全提供元/モデル、全契約プラン/region、全配備での利用可否、agent品質・安全性・SLA、実際の保存・削除条件を確立しない。

よくある失敗・反証

@latest への依存による更新によって、APIやプロバイダーアダプターが変更される可能性がある。スキーマを通過した誤情報、メモリ汚染、ワークフローの状態における競合、ツールの副作用、オブザーバビリティの欠如、モデルルーターの誤選択といった問題が残る。ドキュメント内の顧客利用例や「プロダクション」という表現は、独立したベンチマークではない。
npm導入成功を運用可能性へ拡張しない。モデル router・記憶情報・稼働状況を観測する仕組みの存在を、正しさ・プライバシー・SLAの自動保証と書かない。 UNIT_CLOSE_STATUS: INDIVIDUAL_BOUNDED_CLOSE / EVIDENCE_RECORDED / UNKNOWN_PRESERVED
---

実務での使い方

Node/TypeScript版、@mastra/coreと関連packageの固定公開・提供、supported 提供元/モデル・資格情報・契約・地域、Studio/Server/保存領域/Auth/Deploy機能、記憶情報/稼働状況を観測する仕組み backend、ツール OAuth・RBAC・データ保持。
OSS/TypeScript framework 仕様・利用方法の文書 + PRODUCT_VOLATILE。Docs exampleとnpm導入案内は実装入口。管理Studio・外部接続・認証済み組織の利用環境・本番負荷試験は未実施。
公式ドキュメントが Studio のテスト、トレース、メトリクス、評価（evals）について案内していることは、機能が存在する根拠である。品質、安全性、コスト、レイテンシ、メモリの想起（recall）に関する独立した再現ベンチマークは、本パケットでは確認していない。不明（未確認事項）。
セキュリティ=ツールスキーマ、承認、RBAC（ロールベースのアクセス制御）、プロバイダーごとの権限の分離。プライバシー=メモリ・ストレージ・トレース・外部プロバイダーへの送信の記録。監査=エージェント/一連の処理/ツール/モデル/バージョン/状態の相関。コスト=ルーター選択・LLM・ツール・メモリ・トレース・再試行を含む。運用性=バージョン固定、移行、タイムアウト、同じ要求の再送で処理を重複させない仕組み、ロールバック、プロバイダーの停止を検証。
CoreのTypeScriptフレームワーク欄と製品オーバーレイ欄を分ける。次回は、固定のnpmリリース/コミット、ライセンス、プロバイダー/モデルのマトリックス、Studio/保存領域/Authの契約境界、トレース/メモリデータのポリシー、公開されているIssue/インシデント、再現可能な評価（評価）を補完する。
Mastra 現行性 @mastra/core@1.71.0 as-of 2026-09-25. Keep OSS framework separate from Studio/Platform, 保存領域/稼働状況を観測する仕組み backends and 外部 providers. Durable 再開 is not exactly-once side-effect delivery. データ形式の定義/policy primitives are not 意味上の truth or 認可. Independent 本番環境 SLO/比較評価未確認事項; author-maintained duplicate-live-delivery issue retained as 反証.

まだ確認できていないこと

EA-138-UNKNOWN-01
現在の package versions、モデル routerの選択規則と失敗時の代替処理、記憶情報 consistency、Studioの権限・監査粒度、提供元/region差、処理の流れ復旧、実業務比較評価。
EA-138-UNKNOWN-02
All 未確認事項/PRODUCT_VOLATILE/提供元- or organization-specific limits from authority/監査 remain open unless explicitly closed by the audited 引継ぎ.
EA-138-UNKNOWN-CURRENTNESS
外部根拠の再確認日が正式な本文・公開管理情報で確定していないため、現行性は未確認のまま保持する。確認日を推測して補わない。

根拠資料

研究資料研究資料
source_class=official project 仕様・利用方法の文書; exact_title=Get started with Mastra; 著者・組織=Mastra; canonical_url=
原資料を開く
確認上の限界
元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
研究資料研究資料
source_class=official product 仕様・利用方法の文書; exact_title=稼働状況を観測する仕組み; 著者・組織=Mastra; canonical_url=
原資料を開く
確認上の限界
元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

出典ID・検証情報・機械可読データ

根拠の種類と情報の鮮度は、ラベルとアイコンで確認できます。

記事ID: EA-138
最終確認日: —
提供元・モデル・プラン・利用環境: —
対象地域: —

元資料の全文と収録照合記録

WHY_THIS_MATTERS_TO_UPDATE

TypeScript/Node系でagent、workflow、memory、tool、Studio、observabilityを束ねる実装の現行境界を、OSS frameworkと管理製品のoverlayに分けて更新する。

SCOPE_ROUTING

Enterprise AI Core / implementation / interoperability / governance / audit / operability。Mastra framework、Studio、model router、外部providerを混同しない。

CLAIM_OR_RESEARCH_QUESTION

現行Mastra公式Docsがagents/workflows/tools/memory/Studio/observabilityとmodel/provider設定をどの範囲で明示しているか。

EVIDENCE_TABLE

source_class=official project documentation; exact_title=Get started with Mastra; author/org=Mastra; canonical_url=https://mastra.ai/docs publication/update/access_date=current docs accessed 2026-09-13 JST; version/release/tag/commit/API revision=current @mastra/core docs（docsは@mastra/core@latest等の導入を案内、固定versionなし）; supporting_locator=Get started / Agent and tool setup / Mastra Studio / Quickstart（TypeScript framework、Agent/Tool、provider/model形式、npm create mastra、Studioがagent/workflow/toolのbuild・test・manage interface、model routerへの言及）; evidence_label=VERIFIED_SPEC+PRODUCT_VOLATILE; relation=support+limit
source_class=official product documentation; exact_title=Observability; author/org=Mastra; canonical_url=https://mastra.ai/docs/observability/overview publication/update/access_date=current docs accessed 2026-09-13 JST; version/release/tag/commit/API revision=current docs; supporting_locator=Observability overview（agent run、workflow step、tool call、model interactionを可視化するobservabilityの説明）; evidence_label=VERIFIED_SPEC+PRODUCT_VOLATILE; relation=support+context

FINDINGS

ESTABLISHED: 公式DocsはMastraをTypeScript frameworkとして、agents、workflows、tools、memory、model provider形式、Studioでのbuild/test/manage、observabilityを記載している。Docsの導入例にはtool input schema/execute、agent登録、npmベースの実装入口がある。
NOT_ESTABLISHED: framework・Studio・model routerの機能記述は、全provider/model、全plan/region、全deploymentでの利用可否、agent品質・安全性・SLA、実際の保存・削除条件を確立しない。

LIMITS / COUNTEREVIDENCE / FAILURE ENVELOPE

@latest依存の更新でAPI・provider adapterが変わり得る。schemaを通った誤情報、memory汚染、workflow state race、tool副作用、observability欠損、model routerの誤選択が残る。Docsの顧客利用例・「production」表現は独立benchmarkではない。

AVAILABILITY_GATES

Node/TypeScript版、@mastra/coreと関連packageの固定release、supported provider/model・資格情報・契約・地域、Studio/Server/Storage/Auth/Deploy機能、memory/observability backend、tool OAuth・RBAC・データ保持。

IMPLEMENTATION_STATE

OSS/TypeScript framework documentation + PRODUCT_VOLATILE。Docs exampleとnpm導入案内は実装入口。管理Studio・外部接続・認証済みtenant・本番負荷試験は未実施。

BENCHMARK_OR_EVAL

公式DocsがStudioのtest、traces、metrics、evalsを案内することは機能存在の根拠。品質・安全・cost・latency・memory recallの独立再現benchmarkは本Packetで確認していない。UNKNOWN。

SECURITY / PRIVACY / AUDIT / COST / OPERABILITY

Security=tool schema、approval、RBAC、providerごとの権限を分離。Privacy=memory・storage・trace・外部providerへの送信を記録。Audit=agent/workflow/tool/model/version/stateを相関。Cost=router選択・LLM・tool・memory・trace・retryを含む。Operability=version pin、migration、timeout、idempotency、rollback、provider outageを検証。

SAFE_WORDING_FOR_FUTURE_BOOK

「Mastraの現行Docsは、TypeScript上のagent・workflow・tool・memory・Studio・observabilityを案内している。これは実装要素の存在根拠であり、全provider・plan・regionでの利用可否、業務品質、権限安全性、production SLOの保証ではない。」

UPDATE_WORK_HANDOFF

CoreのTypeScript framework欄とproduct overlay欄を分ける。次回は固定npm release/commit、license、provider/model matrix、Studio/Storage/Authの契約境界、trace/memory data policy、公開issue/incident、再現可能evalを補う。

OPEN_UNKNOWN

current package versions、model routerの選択規則とfallback、memory consistency、Studioの権限・監査粒度、provider/region差、workflow recovery、実業務benchmark。

STOP_CONDITION

npm導入成功を運用可能性へ拡張しない。model router・memory・observabilityの存在を、正しさ・プライバシー・SLAの自動保証と書かない。 UNIT_CLOSE_STATUS: INDIVIDUAL_BOUNDED_CLOSE / EVIDENCE_RECORDED / UNKNOWN_PRESERVED

---

AUDITED_BOUNDARY

Mastra currentness @mastra/core@1.71.0 as-of 2026-09-25. Keep OSS framework separate from Studio/Platform, storage/observability backends and external providers. Durable resume is not exactly-once side-effect delivery. Schema/policy primitives are not semantic truth or authorization. Independent production SLO/benchmark UNKNOWN; author-maintained duplicate-live-delivery issue retained as counterevidence.