ホーム - AskRobots.com | AI Task Management

結果

フルシェルを開く

ワーカー向け：

7. タスク管理

タスクの作成と割り当て
タスクステータスの更新
チームメンバーとのコラボレーション

開発者向け：

MCP統合（Claude Code）

クイックセットアップ： claude mcp add askrobots https://askrobots.com/api/mcp/ -t http -H "Authorization: Token YOUR_TOKEN"
19のツール：タスク、プロジェクト、連絡先、ノート、リンク、記事、検索
MCP完全ドキュメント →

オブジェクト（100xアーキテクチャ）

内容： デプロイ不要で即時実行できるライブPythonオブジェクト
ビュー： ページを作成する場所： /v/your-view/ - AIがコードを編集し、ブラウザを更新するだけでライブになります
データストア： スキーマ不要のJSONストレージ - マイグレーション不要
トリガー： cron式によるスケジュール自動化
オブジェクトを管理 →

12. SDKとライブラリ

概要とメリット
セットアップとインストール
サンプルコード

13. Webhookとインテグレーション

カスタムインテグレーションの作成
リアルタイム更新のためのWebhook活用

14. 開発者のベストプラクティス

コーディング規約とスタイルガイド
デザインシステム
セキュリティガイドライン
パフォーマンス最適化のヒント

15. トラブルシューティングとよくある質問

管理者ユーザーのよくある問題
ワーカーのよくある問題
開発者固有の問題

16. 用語集

用語、略語、専門用語の説明。

17. フィードバックとサポート

フィードバックの送り方
サポートへのお問い合わせ
コミュニティとフォーラムのリンク

1. はじめに

ソフトウェアについて

当社のタスクシステムは、タスク管理を効率化・簡素化するために設計された最先端のWebベースソリューションです。直感的なインターフェースと高度な機能により、ユーザーがタスクを効率的かつ効果的に遂行するための比類なきプラットフォームを提供します。

主なメリット

SaaS（Software-as-a-Service）として、当社のタスクシステムはシームレスな更新、容易なスケーラビリティ、ITコストの削減というメリットを提供します。しかし私たちを真に際立たせているのは、最先端AI技術との統合です。これにより意思決定能力が強化されるだけでなく、予測分析と自動化が導入され、タスク管理が常に一歩先を行くことができます。

対応プラットフォーム / ブラウザ

互換性が重要です。そのため、デスクトップとモバイルの両プラットフォームで主要なWebブラウザすべてに対応しています。さらに、カスタムソフトウェアシステムに当社の機能を統合したい方向けに、シームレスな接続を実現する堅牢なAPIを提供しています。

2. はじめ方

アカウント設定

有効なメールアドレスでアカウントを作成することから始めましょう。アカウントを設定したら、様々な機能をご活用ください。プレミアム機能にアクセスするには、ニーズに合ったサブスクリプションプランをお選びください。

基本設定

新しいアカウントは白紙の状態から始まり、カスタマイズの準備が整っています。最初は難しく感じるかもしれませんが、すべてをすぐにマスターする必要はありません。ノート、リンク、連絡先、イベントなどの基本から始めましょう。慣れてきたら、タスク、タスクテンプレート、シェルなどのより高度な機能を少しずつ探索してください。各モジュールは、自分のペースで生産性を向上させるよう設計されています。

初期ユーザーオンボーディング

登録後、アカウントを確認するためのメールが届きます。これはアカウントのセキュリティを確保し、すべての機能を有効にするための重要なステップです。メールの指示に従って確認プロセスを完了し、私たちとの旅を始めてください。

3. 主要機能

メインダッシュボードの概要

まずメインダッシュボードを探索してください。すべてのプロジェクト、タスク、最近のアクティビティ、重要な指標の概要にアクセスできます。この集中管理ハブにより、サイトの異なるセクション間を素早く移動し、進行中の作業を一目で確認できます。

プロジェクト

プロジェクト管理システムにより、プロジェクトの作成、追跡、コラボレーションが可能です。期限を設定し、各プロジェクト内のタスクを管理し、使いやすいツールで進捗を監視できます。プロジェクトセクションを使用して、すべてのアクティブおよびアーカイブされたプロジェクトを表示してください。

ノート

ログイン後、ユーザーはアイデア、会議議事録、その他の重要な情報を記録するためのノートを作成できます。ノートは自動的に保存され、後で簡単に検索できます。近日中に、プロジェクト、カテゴリ、またはタグでノートを整理できるようになります。

記事

記事セクションは、ドキュメントやレポートなどの長文コンテンツの作成と公開を支援するために設計されています。他のチームメンバーと記事の草稿作成、編集、コラボレーションが可能です。内蔵のバージョン管理により、必要に応じて以前のバージョンに戻すことができます。

リンク

有用なリソースを見つけたら、リンクセクションで保存・整理できます。タグ付け、カテゴリ分け、検索機能により、後で簡単に取り出せます。このセクションは、調査資料、外部ドキュメント、有用な参考資料の管理に最適です。

連絡先

システムに連絡先を追加した後、連絡先セクションで詳細を管理・整理できます。特定の人物を簡単に検索でき、近日中にプロジェクトや会社別に連絡先を分類し、他のコミュニケーションツールと統合できるようになります。

イベント

イベントを作成した後、イベントセクションで予定されているすべての会議、リマインダー、期限を表示できます。近日中に、カレンダーとのイベント同期、招待状の送信、重要な日付を把握するための通知管理が可能になります。

タスクとタスクテンプレート

タスクを作成した後、優先度別に整理し、チームメンバーに割り当て、完了状況を追跡できます。タスクテンプレートにより、繰り返し活動のための再利用可能なタスク構造を作成し、一貫性を確保して時間を節約できます。

ファイル

ファイルセクションは、自動カテゴリ分け、テキスト抽出、タスク作成機能を備えた強力なドキュメントのアップロード、整理、管理システムを提供します。

主な機能

スマートアップロード: 複数ファイルをドラッグ＆ドロップして自動処理
自動カテゴリ分け: ファイルが自動的に論理的なフォルダに整理されます
PDF インテリジェンス: テキスト抽出ですべてのPDFを検索可能にします
タスク作成: 請求書、契約書、ドキュメントからタスクを自動的に作成
一括操作: 複数のファイルを一度に管理

ファイルアップロード

ファイル → アップロードに移動してファイルをアップロードできます。以下のことが可能です：

複数ファイルを一度にドラッグ＆ドロップ
ファイルを特定のプロジェクトに関連付ける
リアルタイムのアップロード進捗を確認
プランの上限（10〜100 MB）までドキュメントをアップロード

自動カテゴリ分け

AskRobotsはインテリジェントなパターン認識を使用してファイルを自動的に整理します：

financial/invoices/2024/ - 請求書ドキュメント用
contracts/vendor/active/ - ベンダー契約用
receipts/travel/2024/ - 経費領収書用
personal/photos/vacation/ - 個人画像用

PDFテキスト抽出

すべてのPDFは自動的に処理されます：

検索用にすべてのテキストを抽出
重要情報（日付、金額、氏名）を識別
検索可能なメタデータを作成
すべてのドキュメントにわたる全文検索を有効化

ドキュメントからのタスク作成

ドキュメントをアップロードしてAIに自動でタスクを作成させる：

請求書 → 期限付き支払いリマインダータスク
契約書 → レビューと更新リマインダータスク
会議メモ → アクションアイテムを個別タスクとして作成
プロジェクトドキュメント → 成果物とマイルストーンタスク

プラン別ストレージ上限

プラン	合計ストレージ	最大ファイルサイズ
ベーシック	1 GB	10 MB
プロ	10 GB	50 MB
エンタープライズ	100 GB	100 MB

4. オブジェクト（100xアーキテクチャ）

オブジェクトはデプロイ不要で即時実行できるライブPythonコードです。これが100xアーキテクチャです— AIがコードを編集し、ブラウザを更新するだけで機能がライブになります。

なぜ100xなのか？

従来の開発では1回の変更に10〜30分かかります（コード、マイグレーション、ビルド、デプロイ、テスト）。オブジェクトを使えば、変更が10〜30秒で完了します（コード編集、ブラウザ更新、完了）。それが100倍速いイテレーションです。

オブジェクトの種類

閲覧数

ライブWebページ（場所： /v/your-view/

HTML、JSON、またはテンプレートをレンダリングして返す
ユーザーコンテキストとクエリパラメータにアクセス
データのために他のオブジェクトを呼び出す

データストア

スキーマ不要のJSON永続化

マイグレーション不要
JSONを保存・読み込むだけ
耐久性のためにTSVで保存

トリガー

スケジュール自動化

cron式
バックグラウンド実行
エラーハンドリング

クイックスタートの例

AIがシンプルなビューを作成する方法：

# Object: u_1_view_hello
# This renders at /v/hello/

def GET(request, context):
    name = context.get('params', {}).get('name', 'World')
    return {
        'html': f'<h1>Hello, {name}!</h1>',
        'title': 'Greeting'
    }

アクセス先： /v/hello/?name=Dan and see "Hello, Dan!" - no deploy needed.

データストアの例

# Object: u_1_deals (data store)
# Stores deals as JSON in _state_manager

def GET(request, context):
    deals = _state_manager.get('deals', [])
    return {'deals': deals, 'count': len(deals)}

def POST(request, context):
    deals = _state_manager.get('deals', [])
    new_deal = context.get('data', {})
    deals.append(new_deal)
    _state_manager.set('deals', deals)
    return {'status': 'added', 'count': len(deals)}

MCP経由でオブジェクトを使用する

あなたのAI（Claude Code、Cursorなど）はMCP APIを通じてオブジェクトを作成・変更できます：

create_object - Pythonコードで新しいオブジェクトを作成
get_object_source - オブジェクトのソースコードを読む
update_object_source - オブジェクトコードを変更する
execute_object - オブジェクトメソッドを呼び出す（GET/POST/PUT/DELETE）
get_object_state - オブジェクトの永続化された状態を読む

オブジェクトの分離

各ユーザーのオブジェクトはプレフィックスで分離されています：

u_1_view_dashboard - ユーザー1のダッシュボードビュー
u_1_deals - ユーザー1の取引データストア
views_landing - システムビュー（読み取り専用）

ユーザーは自分のオブジェクトのみ表示・変更できます。システムオブジェクトは読み取り専用の例として利用できます。

始め方： 移動先：オブジェクト最初のオブジェクトを作成するか、MCP経由でAIを接続して機能を構築させましょう。

5. カスタマイズ可能なタスク管理の未来：ダイナミックフォームの力を解き放つ

デジタル進化が絶え間なく続く時代において、オンラインプラットフォームとのインタラクション、タスクの処理、ワークフローの管理方法は継続的に進化しています。

従来のタスク管理システムは静的で、ユーザーに画一的なアプローチを強いています。しかし、大小を問わずすべてのタスクが完璧に合致する世界を想像してください。当社のダイナミックフォームシステムへようこそ。

適応性：ビジネスニーズの変化に合わせてタスクを進化させます。
効率性：メタデータを活用してデータを引き継ぎ、冗長性を排除し、速度を向上させます。
パーソナライズ：フォームのすべての要素をカスタマイズします。
スケーラビリティ：あらゆる規模や複雑さのプロジェクトをシームレスに処理します。

ぜひ飛び込んで、探索し、私たちとともにタスク管理の未来を体験してください。

ダイナミックフォームシステムの解説

当社のタスク管理システムは、コアコンポーネント（メタデータ、JSONスキーマ、UIスキーマ）を通じて柔軟性と効率性を提供するよう設計されています。それぞれがダイナミックフォームの作成と管理において重要な役割を果たします。

メタデータ：

それは何ですか？: Metadata is essentially "data about data." It functions as a detailed ledger, recording specific attributes and contextual information about each task.
なぜ重要なのですか？: メタデータはタスクのコンテキスト化の基盤となります。様々なタスク間でのデータのシームレスな統合を促進し、重要な詳細が引き継がれることを確保します。この継続性は、タスク管理における効率性と一貫性を維持するための鍵です。

JSONスキーマ（データスキーマ）：

それは何ですか？: JSONスキーマはタスクデータの設計図として機能します。各タスクに関連するデータの予想されるデータ型、制約、全体的な構造を概説します。
なぜ重要なのですか？: スキーマの主な役割はデータの整合性と構造を強制することです。データ要件の明確な定義を提供することで、収集されたすべての情報が一貫性があり、予測可能で、確立された標準に準拠していることを確保します。これはデータ品質の維持と自動化・データ処理の促進に不可欠です。

UIスキーマ（ビューモデル）：

それは何ですか？: UIスキーマは、JSONスキーマで定義されたデータ構造の視覚的表現を担当します。フォームフィールド、ウィジェット、その他のインタラクティブ要素のレイアウトとデザインのカスタマイズオプションを提供します。
なぜ重要なのですか？: UIスキーマはバックエンドのデータ構造とフロントエンドのユーザーエクスペリエンスの間のギャップを橋渡しします。その重要性は、特定のユーザーニーズと美的好みに合わせてデータのプレゼンテーションとインタラクションをカスタマイズできる能力にあります。このカスタマイズはユーザーエンゲージメントを高め、より直感的でユーザーフレンドリーなインターフェースを確保します。

JSONデータとタスクテンプレート

JSONデータから始めましょう。お持ちでない場合は、こちらをご覧ください： こちらの例 または ここで作成.

JSONスキーマ（データスキーマ）

[ ここにJSONコードまたはUML図の画像 ]

JSONファイルを使用してフォームオブジェクトを記述します。フィールドの名前、型、値、サイズが含まれます。

JSONスキーマを作成するこちらそしてフォームをオンラインでプレビュー.

UIスキーマ（ビューモデル）

[ ここにコードと対応するワイヤーフレームUIの画像 ]

JSONファイルを使用してUIのラベルとオプションを一覧表示します。

ユーザーインターフェース

[ ここにBootstrapでレンダリングされたデータ入りUIの画像 ]

最終結果はワーカーフォームに表示されます。送信された結果は blob フィールドに保存されます。

基本的な例

サンプルコード：

Python

6. アカウントと請求

AskRobotsはシンプルなウォレットベースの請求システムを使用しています。必要に応じて入金し、使用した分だけ支払います。予想外の請求や隠れた手数料はありません。

ウォレットシステムの仕組み

従来のサブスクリプションとは異なり、当社のウォレットシステムは完全なコントロールを提供します：

プリペイドモデル: いつでも$5〜$100の範囲で入金可能
自動更新なし: 許可なくカードに請求されることはありません
使用量ベース: AI機能を使用したときのみ残高から差し引かれます
有効期限なし: 残高は使用するまで保持されます
完全な透明性: 各AI操作のコストを正確に確認できます

サブスクリプションプランと機能

請求はウォレットベースですが、プランによって機能と上限が決まります：

プラン	ストレージ	ファイルサイズ	APIレート	最適な用途
ベーシック	1 GB	10 MB max	60/min	個人利用
プロ	10 GB	50 MB max	120/min	小規模チーム
エンタープライズ	100 GB	100 MB max	300/min	大規模組織

詳細プランを表示

AI利用コスト

AI操作は実際の使用量に基づいて課金されます：

GPT-4o-mini: リクエストあたり約$0.001
GPT-4: リクエストあたり約$0.03
Claude 3.5 Sonnet: リクエストあたり約$0.015
画像解析: 画像あたり約$0.005
PDF処理: ドキュメントあたり約$0.01

実際のコストはリクエストの複雑さとレスポンスの長さによって異なります

使用量の追跡

リアルタイムで使用量を監視できます：

ダッシュボード: ウォレット残高と最近の請求を確認
AI使用状況ページ: モデルと操作別の詳細内訳
取引履歴: すべての請求の完全なログ
日次サマリー: 支出パターンを追跡

支払い方法

Stripeを通じてすべての主要な支払い方法に対応しています：

クレジットカード（Visa、Mastercard、American Express、Discover）
デビットカード
デジタルウォレット（Apple Pay、Google Pay）
銀行振込（エンタープライズ向け）

すべての支払いはStripeを通じて安全に処理されます。カードの詳細情報を保存することはありません。

入金する

移動先：請求 → 資金を追加
金額を選択（最低$5、最高$100）
支払い情報を入力
Click "Add Funds"
入金はすぐに利用可能になります

アップグレード/ダウングレードの手順

プランの変更はシンプルで即時に反映されます：

プランをアップグレードする

次のページにアクセス：プランページ
新しいプランを選択
変更は即時に反映されます
ストレージと上限はすぐに増加します
日割り請求なし - ウォレットシステムは変わりません

プランをダウングレードする

下位プランの上限内（ストレージなど）であることを確認してください
プランページにアクセス
下位プランを選択
新しいストレージ上限を超えている場合はファイルを削除する必要があります
機能は即時に調整されます

残高低下通知

以下の場合に通知します：

残高が$5.00を下回ったとき
残高が$0.00になったとき
残高不足で操作が失敗したとき

請求履歴と請求書

完全な請求履歴にアクセスできます：

取引ログ: タイムスタンプと説明付きのすべての請求
月次明細: すべてのアクティビティのサマリー
エクスポートオプション: CSVまたはPDFでダウンロード
税務書類: 経理用の年次サマリー

こちらで確認できます：請求 → 取引履歴

返金ポリシー

以下の場合に返金に対応します：

未使用のウォレット残高（アカウント閉鎖時）
過大請求が発生した技術的エラー
重複請求

返金リクエストは30日以内にsupport@askrobots.comまでご連絡ください。

エンタープライズ請求

以下を必要とする組織向け：

請求書払い（NET 30）
ボリュームディスカウント
複数ユーザーアカウント
カスタム契約

エンタープライズオプションについてはsales@askrobots.comまでお問い合わせください。

11. APIドキュメント

API概要

当社のAPIにより、プラットフォームとプログラム的にやり取りでき、タスクの管理、ステータスの確認など多くのことが可能です。アプリケーションを統合したり、ワークフローを自動化したい開発者向けに設計されています。

認証方法

APIのセキュリティにはトークンベースの認証を使用しています。各リクエストには有効なAPIトークンをヘッダーに含める必要があります。トークンはユーザーダッシュボードから取得できます。APIキーはダッシュボードまたはこちらのリンク.

エンドポイント、リクエスト・レスポンス形式

APIはさまざまな機能にアクセスするための複数のエンドポイントを提供しています。リクエストはJSON形式で行い、レスポンスもJSONで返されます。タスク用のエンドポイントの例を示します： https://askrobots.com/api/tasks/. 利用可能なすべてのエンドポイント、リクエストメソッド、レスポンス形式の詳細なリストについては、完全なAPIドキュメントをご参照ください。

タスク一覧

タスクを一覧表示するcurlコマンドの例です：

curl -X GET \
          -H "Authorization: Token YOUR_API_TOKEN" \
          -H "Content-Type: application/json" \
          https://askrobots.com/api/tasks/

YOUR_API_TOKENを実際のトークンに置き換えてください。

タスクの詳細

特定のタスクの詳細を取得するには：

curl -X GET \
          -H "Authorization: Token YOUR_API_TOKEN" \
          -H "Content-Type: application/json" \
          https://askrobots.com/api/tasks/TASK_ID/

YOUR_API_TOKENを実際のトークンに、TASK_IDをタスクのIDに置き換えてください。

タスクテンプレート一覧

curl -X GET \
            -H "Authorization: Token YOUR_API_TOKEN" \
            -H "Content-Type: application/json" \
            https://askrobots.com/api/tasktemplates/

YOUR_API_TOKENを実際のトークンに、TASK_IDをタスクのIDに置き換えてください。

タスクを作成する


         % curl -X POST \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "title": "New Task with Template",
           "urgency": "normal",
           "template": "TEMPLATE_ID",
           "instructions": "Please follow the template guidelines",
           "json_form": {},
           "metadata": {},
           "priority": 1,
           "due_date": "2024-03-25T00:00:00Z",
           "project": "PROJECT_ID"
         }' \
     https://askrobots.com/api/tasks/

YOUR_API_TOKENを実際のトークンに置き換えてください。 TEMPLATE_IDをテンプレートIDに置き換えてください。 PROJECT_IDをプロジェクトIDに置き換えてください。

プロジェクト一覧


         % curl -X GET \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     https://askrobots.com/api/projects/

YOUR_API_TOKENを実際のトークンに置き換えてください。

APIエンドポイントリファレンス

利用可能なAPIエンドポイントの包括的なリストを以下に示します：

グローバル検索API

メソッド	エンドポイント	説明
GET	`/api/search/`	すべてのコンテンツを横断して検索

クエリパラメータ：

q (必須) - 検索クエリ（最低2文字）
types (任意) - カンマ区切りリスト：tasks、projects、contacts、files、notes、links、articles、events、messages
limit (任意) - タイプあたりの最大結果数（デフォルト10、最大50）

リクエストの例：

curl -X GET \
     -H "Authorization: Token YOUR_API_TOKEN" \
     "https://askrobots.com/api/search/?q=project&types=tasks,notes&limit=5"

レスポンスの例：

{
  "query": "project",
  "total_count": 15,
  "types_searched": ["tasks", "notes"],
  "results": {
    "tasks": {
      "count": 10,
      "results": [
        {
          "id": "uuid",
          "type": "task",
          "title": "Create project dashboard",
          "snippet": "Build the main project...",
          "created_at": "2026-02-03T...",
          "project": {"id": "uuid", "name": "AskRobots"},
          "status": "open"
        }
      ]
    },
    "notes": {
      "count": 5,
      "results": [...]
    }
  }
}

注意： 結果はユーザーアクセスでフィルタリングされます。自分が所有するかアクセス権を持つコンテンツのみ表示されます。

ノートAPI

メソッド	エンドポイント	説明
GET	`/api/notes/`	すべてのノートを一覧表示
GET	`/api/notes/{id}/`	ノートの詳細を取得
POST	`/api/notes/`	新しいノートを作成
PUT	`/api/notes/{id}/`	ノートを更新
DELETE	`/api/notes/{id}/`	ノートを削除

フィールド：

content (必須) - ノートのテキストコンテンツ
project (任意) - 関連付けるプロジェクトのUUID
project_name (読み取り専用) - 関連プロジェクトの名前

リクエストの例 - ノートを作成：

curl -X POST \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "content": "Discussed project timeline and deliverables",
       "project": "PROJECT_UUID"
     }' \
     https://askrobots.com/api/notes/

リンクAPI

メソッド	エンドポイント	説明
GET	`/api/links/`	すべてのリンクを一覧表示
GET	`/api/links/{id}/`	リンクの詳細を取得
POST	`/api/links/`	新しいリンクを作成
PUT	`/api/links/{id}/`	リンクを更新
DELETE	`/api/links/{id}/`	リンクを削除

イベントAPI

メソッド	エンドポイント	説明
GET	`/api/events/`	すべてのイベントを一覧表示
GET	`/api/events/{id}/`	イベントの詳細を取得
POST	`/api/events/`	新しいイベントを作成

リクエストの例 - イベントを作成：

curl -X POST \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "title": "Team Meeting",
       "start_date_time": "2025-06-15T14:00:00Z",
       "end_date_time": "2025-06-15T15:00:00Z",
       "description": "Weekly team sync",
       "project": "PROJECT_ID"
     }' \
     https://askrobots.com/api/events/

連絡先API

メソッド	エンドポイント	説明
GET	`/api/contacts/`	すべての連絡先を一覧表示
GET	`/api/contacts/{id}/`	連絡先の詳細を取得
POST	`/api/contacts/`	新しい連絡先を作成
PUT	`/api/contacts/{id}/`	連絡先を更新
DELETE	`/api/contacts/{id}/`	連絡先を削除

フィルター: ?project=UUID, ?search=text, ?ordering=last_name, ?lead_status=hot, ?organization_entity=UUID

Organizations API

メソッド	エンドポイント	説明
GET	`/api/organizations/`	List all organizations
GET	`/api/organizations/{id}/`	Get organization details (includes contact_count)
POST	`/api/organizations/`	Create new organization
PATCH	`/api/organizations/{id}/`	Update organization
DELETE	`/api/organizations/{id}/`	Delete organization

フィルター: ?search=text (searches name and industry), ?project=UUID

フィールド： name, website, industry, description, notes, project

Interactions API

メソッド	エンドポイント	説明
GET	`/api/interactions/`	List all interactions
GET	`/api/interactions/{id}/`	Get interaction details
POST	`/api/interactions/`	Log a new interaction
PATCH	`/api/interactions/{id}/`	Update interaction
DELETE	`/api/interactions/{id}/`	Delete interaction

フィルター: ?contact=UUID, ?organization=UUID, ?interaction_type=call|email|meeting|note|task

フィールド： contact, interaction_type, subject, notes, duration, outcome (positive/neutral/negative/no_answer), occurred_at

Tags API

メソッド	エンドポイント	説明
GET	`/api/tags/`	List all tags
POST	`/api/tags/`	Create a tag
PATCH	`/api/tags/{id}/`	Update tag
DELETE	`/api/tags/{id}/`	Delete tag

フィールド： name, color (hex color, default #6c757d)

Tip: Assign tags to contacts via the Contact API using tag_ids: [UUID, ...]

ファイル API

メソッド	エンドポイント	説明
GET	`/api/files/`	すべてのファイルを一覧表示
GET	`/api/files/{id}/`	ファイルの詳細を取得
GET	`/api/files/{id}/download/`	ダウンロード URL を取得
GET	`/api/files/stats/`	ファイルの統計情報を取得
POST	`/api/files/upload/`	ファイルをアップロード
POST	`/api/files/categorize/`	ファイルを一括カテゴリー分類

フィルター: ?project=UUID, ?category=path, ?uncategorized=true, ?file_type=document

ファイルアップロードの例:

curl -X POST \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -F "file=@/path/to/document.pdf" \
     -F "project=PROJECT_UUID" \
     -F "description=Project documentation" \
     https://askrobots.com/api/files/upload/

アップロードフィールド:

file (必須) - アップロードするファイル (multipart/form-data)
project (任意) - 関連付けるプロジェクトのUUID
category (任意) - カテゴリーパス文字列
description (任意) - ファイルの説明

時間追跡 API

メソッド	エンドポイント	説明
GET	`/api/timelogs/`	時間エントリーを一覧表示
GET	`/api/timelogs/running/`	実行中のタイマーを取得
POST	`/api/timelogs/`	時間エントリーを作成
POST	`/api/timelogs/start/`	新しいタイマーを開始
POST	`/api/timelogs/{id}/stop/`	実行中のタイマーを停止

フィルター: ?project=UUID, ?task=UUID, ?is_running=true, ?is_billable=true

ワーカー管理 API

メソッド	エンドポイント	説明
GET	`/api/workertypes/`	ワーカータイプを一覧表示
GET	`/api/aiworkers/`	AI ワーカーを一覧表示
POST	`/api/aiworkers/`	AI ワーカーを作成
GET	`/api/invitations/`	プロジェクトへの招待を一覧表示
POST	`/api/invitations/`	招待を作成
POST	`/api/invitations/{id}/accept/`	招待を承諾
GET	`/api/projectaccess/`	プロジェクトの権限を一覧表示

請求 API（読み取り専用）

メソッド	エンドポイント	説明
GET	`/api/plans/`	サブスクリプションプランを一覧表示
GET	`/api/wallet/me/`	ウォレット残高を確認
GET	`/api/subscription/me/`	サブスクリプションの状態を確認
GET	`/api/transactions/`	取引履歴を一覧表示

注意: 請求エンドポイントは読み取り専用です。請求の管理はダッシュボードから行ってください。

エージェント調整 API

複数の AI エージェントが同時にタスクに取り組む、マルチエージェント環境向けです。

メソッド	エンドポイント	説明
POST	`/api/tasks/{id}/claim/`	タスクをアトミックに取得します（競合状態を防止）
POST	`/api/tasks/{id}/release/`	取得済みのタスクをプールに返却
POST	`/api/tasks/{id}/heartbeat/`	取得タイムアウトを延長
GET	`/api/tasks/claimable/`	取得可能なタスクを一覧表示
GET	`/api/tasks/my_claims/`	現在取得中のタスクを一覧表示

クエリパラメーター: ?timeout_minutes=30, ?stale_minutes=30, ?urgency=high

エージェントのワークフロー:

# 1. Find claimable tasks
GET /api/tasks/claimable/?urgency=high&limit=5

# 2. Claim a task atomically
POST /api/tasks/{id}/claim/?timeout_minutes=30

# 3. Send heartbeats while working
POST /api/tasks/{id}/heartbeat/

# 4. Complete or release when done
POST /api/tasks/{id}/complete_simple/
# or
POST /api/tasks/{id}/release/

取得は既定で 30 分後に期限切れになります。古い取得は自動的に解放されます。

Shell API

Execute shell commands via the API. Supports all shell commands including AI queries (/ar), quick notes, search, and more.

メソッド	エンドポイント	説明
`POST`	`/api/shell/`	Execute a shell command

Request body:

{
  "command": "/ar What tasks are open?",
  "session_id": "optional-uuid-for-conversation-context"
}

Response:

{
  "output": "You have 12 open tasks...",
  "session_id": null,
  "success": true
}

例：

curl -X POST https://askrobots.com/api/shell/ \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"command": "/ping"}'

Command prefixes:

/ar — AI query with tool access (tasks, notes, files, etc.)
/note — Create a quick note
/search — Search notes
/task — Task management
^url — Quick bookmark
~term — Fuzzy global search

Any text without a prefix is sent directly to the AI agent.

レスポンス形式

すべての API レスポンスは一貫した JSON 形式に従います:

成功レスポンス (200 OK):

{
  "id": "uuid-here",
  "title": "Sample Note",
  "content": "This is the note content",
  "created_at": "2025-06-11T12:00:00Z",
  "updated_at": "2025-06-11T12:00:00Z",
  "user": "user-id",
  "project": "project-id"
}

エラーレスポンス (400 Bad Request):

{
  "error": "Bad Request",
  "message": "Title field is required",
  "field_errors": {
    "title": ["This field is required."]
  }
}

ページネーションレスポンス:

{
  "count": 45,
  "next": "https://askrobots.com/api/notes/?page=2",
  "previous": null,
  "results": [
    {
      "id": "uuid-1",
      "title": "Note 1",
      ...
    },
    {
      "id": "uuid-2", 
      "title": "Note 2",
      ...
    }
  ]
}

レート制限

公平な利用を確保するため、API リクエストにはレート制限があります:

認証済みユーザーは1時間あたり 1000 リクエスト
未認証リクエストは1時間あたり 100 リクエスト
レート制限情報はレスポンスヘッダーに含まれます:
- X-RateLimit-Limit: 許可される最大リクエスト数
- X-RateLimit-Remaining: 残りリクエスト数
- X-RateLimit-Reset: 制限がリセットされる時刻

Webhook

イベント発生時にリアルタイム通知を受け取るために Webhook を設定してください:

POST /api/webhooks/
{
  "url": "https://your-app.com/webhook",
  "events": ["task.created", "task.updated", "task.completed"],
  "active": true
}

SDKとライブラリ

主要な言語向けの公式 SDK を提供しています:

Python: pip install askrobots-sdk
JavaScript/Node: npm install @askrobots/sdk
Ruby: gem install askrobots
PHP: composer require askrobots/sdk

Python SDK の例:

from askrobots import Client

client = Client(api_key="YOUR_API_TOKEN")

# List tasks
tasks = client.tasks.list()

# Create a new task
new_task = client.tasks.create(
    title="Complete API documentation",
    urgency="high",
    project_id="PROJECT_ID"
)

# Update task status
client.tasks.update(new_task.id, status="completed")

認証の詳細

API トークンの取得

次のページへ移動してください設定 → API キー
Click "Generate New Token"
トークンにわかりやすい名前を付けてください
トークンをすぐにコピーしてください（再表示されません）
アプリケーション内に安全に保管してください

リクエストでのトークンの使用

すべてのリクエストの Authorization ヘッダーにトークンを含めてください:

Authorization: Token YOUR_API_TOKEN

各種ツールでの例:

# curl
curl -H "Authorization: Token YOUR_API_TOKEN" https://askrobots.com/api/tasks/

# Python requests
import requests
headers = {"Authorization": "Token YOUR_API_TOKEN"}
response = requests.get("https://askrobots.com/api/tasks/", headers=headers)

# JavaScript fetch
fetch('https://askrobots.com/api/tasks/', {
    headers: {
        'Authorization': 'Token YOUR_API_TOKEN'
    }
});

レート制限

API のレート制限はサブスクリプションプランに基づきます:

プラン	レート制限	バースト制限	1日の上限
ベーシック	60 リクエスト/分	10 リクエスト/秒	10,000 リクエスト
プロ	120 リクエスト/分	20 リクエスト/秒	50,000 リクエスト
エンタープライズ	300 リクエスト/分	50 リクエスト/秒	無制限

レート制限ヘッダー

各レスポンスにはレート制限情報が含まれます:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1698765432

エラーコード

API は標準的な HTTP ステータスコードを使用し、JSON 形式のエラーレスポンスを返します:

ステータスコード	意味	レスポンスの例
`200 OK`	成功	`{"data": {...}}`
`201 Created`	リソースが正常に作成されました	`{"id": "abc123", ...}`
`400 Bad Request`	リクエストパラメーターが無効です	`{"error": "Title is required"}`
`401 Unauthorized`	API トークンが無効または見つかりません	`{"error": "Authentication credentials were not provided"}`
`402 Payment Required`	ウォレット残高が不足しています	`{"error": "Insufficient funds", "balance": 0.50}`
`403 Forbidden`	リソースへのアクセスが拒否されました	`{"error": "You don't have permission to access this resource"}`
`404 Not Found`	リソースが見つかりません	`{"error": "Task not found"}`
`429 Too Many Requests`	レート制限を超えました	`{"error": "Rate limit exceeded", "retry_after": 60}`
`500 Server Error`	内部サーバーエラー	`{"error": "An unexpected error occurred"}`

ページネーション

リストエンドポイントは既定でページあたり 20 件のページネーション結果を返します:

{
    "count": 150,
    "next": "https://askrobots.com/api/tasks/?page=2",
    "previous": null,
    "results": [...]
}

クエリパラメーターでページネーションを制御できます:

page - ページ番号（既定: 1）
page_size - 1ページあたりのアイテム数（最大: 100）

フィルタリングと検索

ほとんどのリストエンドポイントはフィルタリングをサポートしています:

# Filter tasks by project
/api/tasks/?project=PROJECT_ID

# Filter by status
/api/tasks/?status=open

# Search tasks
/api/tasks/?search=invoice

# Combine filters
/api/tasks/?project=PROJECT_ID&status=open&urgency=high

Webhook

リアルタイム通知を受け取るために Webhook を設定してください:

Webhook イベント

task.created - 新しいタスクが作成されました
task.completed - タスクが完了としてマークされました
file.uploaded - ファイルがアップロードされました
file.processed - ファイルの処理が完了しました
wallet.low_balance - 残高が $5 を下回っています

Webhook ペイロードの例

{
    "event": "task.completed",
    "timestamp": "2025-06-19T10:30:00Z",
    "data": {
        "id": "task123",
        "title": "Process invoices",
        "completed_by": "user456"
    }
}

API のベストプラクティス

レスポンスをキャッシュする API 呼び出しを減らすため、可能な限りキャッシュしてください
レート制限を処理する 指数バックオフを使用して適切に処理してください
Webhook を使用する リアルタイム更新のためにポーリングではなく Webhook を使用してください
バッチ操作 複数のリソースを作成する際はバッチ処理を使用してください
必要なフィールドのみ含める フィールド選択パラメーターを使用してください
ページネーションを使用する 大規模なデータセットでは適切にページネーションを使用してください
トークンを安全に保管する 定期的にローテーションしてください

お困りですか？ API に関するご質問は api-support@askrobots.com までお問い合わせいただくか、 API サンプルリポジトリをご覧ください。

7. セキュリティとプライバシー

AskRobots はセキュリティとプライバシーを中心に構築されています。業界のベストプラクティスを実装し、お客様のデータを保護し、プライバシー規制への準拠を確保しています。

データ分離

すべてのユーザーのデータは完全に分離されています:

行レベルセキュリティ: すべてのデータベースクエリはユーザー ID でフィルタリングされます
データの共有なし: あなたのファイル、タスク、プロジェクトは他のユーザーからアクセスできません
API の分離: トークンベースの認証により、データアクセスはユーザー固有となります
プロジェクトの境界: チーム内でも、アクセスはプロジェクトレベルで制御されます

暗号化

お客様のデータを保護するために、複数の暗号化レイヤーを使用しています:

転送中: すべての接続は TLS 1.3 暗号化を使用しています
保存時: ファイルは AES-256 暗号化で保護されています
データベース: 機密フィールドはアプリケーションレベルの暗号化を使用しています
バックアップ: すべてのバックアップは保存前に暗号化されます

バックアップ手順

お客様のデータは包括的なバックアップ戦略によって保護されています:

自動日次バックアップ すべてのデータベースの
30 日間の保持 ポイントインタイムリカバリのため
定期的なリストアテスト バックアップの整合性を確保するため

ユーザー権限

きめ細かい権限制御:

ロールベースのアクセス制御: 管理者、ユーザー、ワーカーのロール
プロジェクトの権限: プロジェクトの閲覧、編集、管理ができるユーザーを制御します
API の権限: アクセスレベルに応じた個別のトークン
監査ログ: すべての権限変更を追跡します

API セキュリティ

当社の API は複数のセキュリティ対策を実装しています:

トークン認証: 失効させることができる安全な API トークン
レート制限: インテリジェントなレート制限で不正利用を防止します
入力検証: すべての入力はサニタイズおよび検証されます
CORS 保護: 制御されたクロスオリジンリソース共有

GDPRコンプライアンス

GDPR に基づくプライバシーの権利を尊重しています:

アクセスの権利: いつでもすべてのデータをエクスポートできます
消去の権利: アカウントとすべての関連データを削除できます
データポータビリティ: 標準形式（JSON、CSV）でデータをエクスポートできます
プライバシー・バイ・デザイン: すべての機能においてプライバシーを考慮しています
データ最小化: 必要なデータのみを収集します

データ保持ポリシー

データの保持期間に関する明確なポリシー:

アクティブなアカウント: アカウントがアクティブな間はデータを保持します
削除されたアイテム: 30 日間ソフト削除され、その後完全に削除されます
非アクティブなアカウント: 12 か月後に通知、18 か月後に削除されます
残高がマイナスのアカウント: データ削除前に 90 日間の猶予期間があります
監査ログ: セキュリティ目的で 1 年間保持されます

データエクスポートオプション

データはお客様のものであり、いつでもエクスポートできます:

アカウント全体のエクスポート: すべてのデータを 1 つの ZIP ファイルに
選択的エクスポート: 特定のプロジェクトや日付範囲を選択できます
複数の形式: データの種類に応じた JSON、CSV、PDF
API アクセス: REST API を通じたプログラムによるエクスポート
ベンダーロックインなし: 標準形式によりデータの移植性を確保します

ユーザー向けセキュリティのベストプラクティス

アカウントのセキュリティ維持にご協力ください:

強力なパスワード: 固有で複雑なパスワードを使用してください
二要素認証: 利用可能な場合は 2FA を有効にしてください
API トークン管理: 定期的にトークンをローテーションしてください
アクセスの監視: 定期的にアクティビティログを確認してください
問題の報告: 不正アクセスが疑われる場合はすぐにご連絡ください

セキュリティ連絡先: セキュリティに関するご懸念や脆弱性の報告は、以下のメールアドレスまでご連絡ください security@askrobots.com

結果

目次：

1. はじめに

2. はじめ方

3. 主要機能

4. オブジェクト（100xアーキテクチャ）

5. 管理者ユーザー向け高度な機能

6. アカウントと請求

7. セキュリティとプライバシー

ワーカー向け：

7. タスク管理

開発者向け：

MCP統合（Claude Code）

オブジェクト（100xアーキテクチャ）

11. APIドキュメント

12. SDKとライブラリ

13. Webhookとインテグレーション

14. 開発者のベストプラクティス

15. トラブルシューティングとよくある質問

16. 用語集

17. フィードバックとサポート

1. はじめに

ソフトウェアについて

主なメリット

対応プラットフォーム / ブラウザ

2. はじめ方

アカウント設定

基本設定

初期ユーザーオンボーディング

3. 主要機能

メインダッシュボードの概要

プロジェクト

ノート

記事

リンク

連絡先

イベント

タスクとタスクテンプレート

ファイル

主な機能

ファイルアップロード

自動カテゴリ分け

PDFテキスト抽出

ドキュメントからのタスク作成

プラン別ストレージ上限

4. オブジェクト（100xアーキテクチャ）

なぜ100xなのか？

オブジェクトの種類

クイックスタートの例

データストアの例

MCP経由でオブジェクトを使用する

オブジェクトの分離

5. カスタマイズ可能なタスク管理の未来：ダイナミックフォームの力を解き放つ

ダイナミックフォームシステムの解説

メタデータ：

JSONスキーマ（データスキーマ）：

UIスキーマ（ビューモデル）：

JSONデータとタスクテンプレート

JSONスキーマ（データスキーマ）

UIスキーマ（ビューモデル）

ユーザーインターフェース

基本的な例

サンプルコード：

6. アカウントと請求

ウォレットシステムの仕組み

サブスクリプションプランと機能

AI利用コスト

使用量の追跡

支払い方法

入金する

アップグレード/ダウングレードの手順

プランをアップグレードする

プランをダウングレードする

残高低下通知

請求履歴と請求書

返金ポリシー

エンタープライズ請求

11. APIドキュメント

API概要

認証方法