---
title: "アプリでできること"
description: "SotaAgents アプリは、組織とワークスペース内でプラットフォームを拡張する、バージョン管理された Capability パッケージです。Tool、Skill、Native UI、tool-result renderer、hook、event、prompt、スコープ付きデータアクセスを提供できます。プラットフォームは identity、インストー…"
url: "https://sotaagents.ai/ja/manual/developer-guide/what-apps-can-do"
generated_by: "sotaagents-ldp"
docs_index: "https://sotaagents.ai/manual/llms.txt"
locale: "ja"
---

# アプリでできること

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

> [!NOTE]
> アプリは拡張の単位であり、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](/manual/assets/developer/app-store-catalog.webp)
_アプリは組織レベルで検出・インストールし、workspace では既定 enabled を継承し、必要に応じて明示的に上書きします。_

![Native workspace page として動作する Knowledge Base](/manual/assets/developer/app-workspace-native-ui.webp)
_Production アプリは platform の navigation、identity、access control を維持しながら完全な workspace experience を提供できます。_

![SotaAgents conversation 内で展開された Web Search tool result](/manual/assets/developer/web-search-tool-result.webp)
_App action の query、visual preview、source card が conversation 内に直接表示されます。_

![SotaAgents conversation の横で開いた Office App presentation artifact](/manual/assets/developer/slide-artifact.webp)
_Workspace panel に slide artifact を開いても、元の conversation と artifact card を同時に確認できます。_

### 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 を直接編集する権限は持ちません。

> [!NOTE]
> Platform は常に exact environment を解決します。
>
> Tool、screen、asset、data request は Development、Staging、Production のいずれかに属し、別 environment への暗黙的 fallback はありません。