プレビュー — CloudThinker REST API は早期アクセス段階です。エンドポイント、ペイロード、認証フローは一般提供前に変更される場合があります。プレビューへの参加はこちらからお問い合わせください。
できること
| 機能 | 説明 |
|---|---|
| 会話のトリガー | @agent #tool プロンプトでエージェント会話をプログラムで開始し、アプリにレスポンスをストリーミングする |
| リソースの照会 | AWS、GCP、Azure 横断でのクラウドリソース・コスト・トポロジーの統合インベントリを取得する |
| 推奨事項の管理 | コスト・セキュリティ・信頼性に関する推奨事項を一覧表示、承認、却下、またはコメントする |
| インシデントの操作 | インシデントの作成、シグナルの添付、RCA の依頼、調査結果の取得を行う |
認証
API はベアラートークンヘッダーで渡す、ワークスペーススコープの API キーを使用します。| フィールド | 説明 |
|---|---|
| スコープ | 各キーは単一のワークスペースにバインドされます |
| 権限 | 発行したメンバーのロールを継承します |
| ローテーション | ワークスペース設定からいつでもキーを失効させられます |
エンドポイント一覧
| リソース | 用途 |
|---|---|
/v1/workspaces | ワークスペースのメタデータとメンバー |
/v1/conversations | エージェント会話の開始・一覧・再開 |
/v1/resources | 検出されたクラウドリソースインベントリ |
/v1/recommendations | コスト・セキュリティ・信頼性の推奨事項 |
/v1/incidents | インシデントのライフサイクルと RCA 結果 |
/v1/dashboards | 組み込みおよびカスタムダッシュボードデータ |
/v1/skills | ワークスペースの Skills と実行 |
/v1/connections | クラウドおよび SaaS のコネクション |
バージョニング
API は URL パス（/v1/）でバージョン管理されています。破壊的変更は新しいバージョンでリリースされ、追加的な変更は現行バージョンでリリースされます。非推奨バージョンは後継バージョンのリリースから少なくとも12か月間は利用可能です。
関連
MCP Server
MCP 対応 AI クライアントから CloudThinker ツールを使用する
CLI
ターミナルから CloudThinker の操作を実行する
Webhooks
ポーリングの代わりにイベント駆動の通知を受け取る
コネクション
クラウドプロバイダーと SaaS システムを接続する