アーキテクチャ

Takos は、利用者向けの AI ワークスペースです。デプロイ管理を内蔵せず、アカウントとアプリの配置は外部の Takosumi と連携します。

全体の流れ

ブラウザ
  ↓
Takos Worker ── Files / Git / Memory
  │
  ├─ エージェント実行サービス
  └─ アプリや MCP サーバーのツール

Takosumi
  └─ アカウント、アプリの OpenTofu 実行、実行履歴

Takos Worker は API とブラウザ UI の入口です。エージェント実行サービスは、実行ごとに許可された操作だけを受け取ります。アプリや外部 MCP サーバーのツールは、Workspace の権限を確認してから公開されます。

クラウドとの境界

Takos本体が必要とするリソースと接続名の正本は deploy/product-resources.jsonです。 そこにはCloudflare、Takoform、account ID、credentialを書きません。

• deploy/opentofu/cloudflare は、自分のCloudflare accountへ直接置くadapterです。
• deploy/opentofu/takoform は、同じ論理リソースをTakoform対応hostへ置く既定adapterです。
• Takosumiはどちらも普通のOpenTofu moduleとして扱います。Takos専用providerや特別なapply経路はありません。

Cloudflare Workers用entrypointやCloudflare binding変換はCloudflare adapterに残ります。 API、agent、tool、storageなどの製品ロジックは中立bindingを使い、選んだadapterを知りません。

読む順番

1. システム全体 — サービスと所有者
2. エージェント実行 — 一つの依頼が完了するまで
3. アプリの公開情報 — Apps、MCP、file handler の表示方法
4. 信頼境界 — サービス間の認証と権限

詳細ページ

ページ	内容
システム全体	Takos と Takosumi の境界
サービス構成	ローカル環境のサービスとポート
エージェント実行	実行、ツール、メモリ
アプリの公開情報	UI、MCP、ファイル形式
実行時の接続	デプロイ結果から接続を作る方法
アプリメタデータ	名前、URL、機能の所有者
信頼境界	内部呼び出しと capability token
構成図	主な処理の図

用語について

この章では、API と実装に対応させるため Takosumi 固有の名前も使います。初めて出てくる用語は 用語集 で確認できます。利用者向けページでは、可能な限り「アプリ」「実行」「公開先」のような一般的な言葉を使います。