ドキュメント
アプリを開く

アプリでできること

このページの内容

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 でそれらを出荷できます。

アプリは拡張の単位であり、plugin script ではありません。

Version を持ち、組織単位でインストールされ、明示的な workspace override がない限りすべての workspace で既定 enabled となり、リクエストごとに exact environment へ解決されます。サードパーティの domain logic を first-party 機能の隣で安全に動かせるのはそのためです。

Tool

アシスタントが呼び出す型付き backend action。

Skill

アシスタントを導く再利用可能な指示と workflow。

Native UI

Workspace page、admin screen、inline view、artifact renderer。

App data

認可され、environment ごとに分離された storage/backend access。

インストール済みアプリとカタログを表示する組織 App Store
アプリは組織レベルで検出・インストールし、workspace では既定 enabled を継承し、必要に応じて明示的に上書きします。
Native workspace page として動作する Knowledge Base
Production アプリは platform の navigation、identity、access control を維持しながら完全な workspace experience を提供できます。
SotaAgents conversation 内で展開された Web Search tool result
App action の query、visual preview、source card が conversation 内に直接表示されます。
SotaAgents conversation の横で開いた Office App presentation artifact
Workspace panel に slide artifact を開いても、元の conversation と artifact card を同時に確認できます。

App experience が表示される場所#

Manifest surface用途代表的な host
pageNavigation と state を持つ継続 workflow。Workspace または admin route。
tool-view一つの tool invocation と結果を conversation 内で表示。Tool result part。
message-partApp 固有の構造化 message content を inline 表示。Conversation message part。
artifact再表示、確認、export できる永続 output。Artifact panel。
cardApp content の compact summary または entry point。Host が提供する card slot。
composer-actionComposer に隣接する compact action。chat.composer.actions。
composer-panelActive draft を読み取り、atomic に編集できる contextual UI。chat.composer.panel。

useComposer は意図的に composer-panel 内でのみ利用できます。composer-action は独立した surface であり、draft を直接編集する権限は持ちません。

Platform は常に exact environment を解決します。

Tool、screen、asset、data request は Development、Staging、Production のいずれかに属し、別 environment への暗黙的 fallback はありません。

目次

Esc

全章のタイトルと本文を検索します。