アプリでできること
SotaAgents アプリは、組織とワークスペース内でプラットフォームを拡張する、バージョン管理された Capability パッケージです。Tool、Skill、Native UI、tool-result renderer、hook、event、prompt、スコープ付きデータアクセスを提供できます。プラットフォームは identity、インストール、認可、environment 選択、asset 配信、監査を管理し、アプリは業務ロジックと固有データを管理します。
なぜアプリという仕組みがあるのか#
SotaAgents のアシスタントは一つですが、どんなアシスタントも御社の CAD 図面規格、法務レビュー手順、社内 ERP の API までは知りません。あらゆる業務領域に合わせて製品本体を肥大化させる代わりに、プラットフォームは意図的に「未完成」に設計されています。足りない capability を各チームが足す手段がアプリであり、プラットフォームの側がそれに合わせて形を変えます。法令文書レビュー、knowledge base、CAD 生成、Office 文書作成、Web 検索——同じ shell がこれらすべてを支えられるのは、その domain logic がどれも core に入っていないからです。
具体的には、アプリは manifest.yaml を含むディレクトリであり、計算処理・非公開 credential・外部 API・永続的な業務データが必要な場合には、自前で host する HTTP service を伴います。プラットフォームがコードを調べて機能を推測することはありません。manifest が宣言したものだけを、解決された organization・workspace・environment に対してのみ公開し、宣言のないものはすべて拒否します。
結果として二つのことが起こります。アシスタントは本来持ち得ない能力を獲得します——社内システムを照会・更新する tool、業務手順を教える skill、workspace 内で自社データを描画する screen。そしてチームは、SotaAgents 本体に一切手を入れずに、自分たちの release cadence・言語・runtime でそれらを出荷できます。
Version を持ち、組織単位でインストールされ、明示的な workspace override がない限りすべての workspace で既定 enabled となり、リクエストごとに exact environment へ解決されます。サードパーティの domain logic を first-party 機能の隣で安全に動かせるのはそのためです。
アシスタントが呼び出す型付き backend action。
アシスタントを導く再利用可能な指示と workflow。
Workspace page、admin screen、inline view、artifact renderer。
認可され、environment ごとに分離された storage/backend access。




App experience が表示される場所#
| Manifest surface | 用途 | 代表的な host |
|---|---|---|
page | Navigation と state を持つ継続 workflow。 | Workspace または admin route。 |
tool-view | 一つの tool invocation と結果を conversation 内で表示。 | Tool result part。 |
message-part | App 固有の構造化 message content を inline 表示。 | Conversation message part。 |
artifact | 再表示、確認、export できる永続 output。 | Artifact panel。 |
card | App content の compact summary または entry point。 | Host が提供する card slot。 |
composer-action | Composer に隣接する compact action。 | chat.composer.actions。 |
composer-panel | Active draft を読み取り、atomic に編集できる contextual UI。 | chat.composer.panel。 |
useComposer は意図的に composer-panel 内でのみ利用できます。composer-action は独立した surface であり、draft を直接編集する権限は持ちません。
Tool、screen、asset、data request は Development、Staging、Production のいずれかに属し、別 environment への暗黙的 fallback はありません。