AIエージェントのアクティビティログを読む
ワークスペースでエージェントが何を行ったか（作成・変更した内容、ジョブ、クレジット、拒否された呼び出し、日次の読み取り数）を確認できます。列、結果、アクション名、フィルター、保持期間について説明します。
更新日: 読了時間 1 分
アクティビティタブは、ワークスペースでエージェントが行ったことのログです。作成・変更した内容、開始した作業、使用したクレジット、拒否された呼び出し、日次の読み取り数が記録されます。エージェントの作業を確認したり、何らかの失敗の原因を特定したりするために使用します。
アクティビティログを開く
ワークスペースメニューを開き、AIエージェントとAPIを選択してから、アクティビティを開きます。ドキュメントサイトの設定メニューからAIエージェントとAPIを開くと、そのサイトでフィルターされた同じログが表示されます。
| ユーザーの役割 | 表示内容 |
|---|---|
| オーナーまたは管理者 | 「このワークスペースでエージェントが行ったこと：作業、拒否、日次の読み取り」。すべてのトークンと接続済みアプリが表示されます。 |
| エディターまたはコンテンツ作成者 | 「あなたのトークンとアプリが行ったこと」。自分自身のもののみが表示されます。 |
行の内容を読む
| 列 | 表示内容 |
|---|---|
| 時間 | 実行された日時。ポイントすると正確な時間と呼び出し元のIPアドレスが表示されます。 |
| エージェント | エージェント名、使用されたトークン（トークン「name」）または接続済みアプリ、および対象 person：誰のアクセス権限で実行されたか。 |
| アクション | 何を行ったか。アイテムIDおよび有料作業の場合はジョブ id が表示されます。 |
| サイト | 影響を受けたドキュメントサイト（ある場合）。 |
| クレジット | アクションで使用されたクレジット。無料のアクションでは空欄です。 |
| 結果 | OK、拒否されました（権限不足や制限などによる拒否）、競合（エージェントが読み取った後にコンテンツが変更された）、またはエラー。 |
読み取りは1件ずつログに記録されません。各トークンにつき1日1行、合計数（例：「46回の読み取り」）として記録されます。
表示されるアクション
| アクション | 意味 |
|---|---|
| ジョブを開始しました / ジョブをキャンセルしました | 動画、エクスポート、翻訳などの有料または長時間実行される作業。 |
| 承認依頼済み | エージェントが有料作業の承認を人間に求めた場合。エージェントの支出と承認を管理するを参照してください。 |
| リクエストが承認されました / リクエストが拒否されました / リクエストの有効期限が切れました | そのリクエストの結果。 |
| 記事を作成しました / 記事を編集しました / レビュー用に提出済み | ドキュメントサイトの記事。 |
| ページを変更しました / ページを準備完了としてマークしました / ページを削除しました / セクションを作成しました / セクションを変更しました | ドキュメントサイトの構造。 |
| サイトページを作成しました / サイトページを編集しました | ホーム、お問い合わせ、法律関連などのサイトページ。 |
| 変更履歴エントリを作成しました / 変更履歴エントリを編集しました / 変更履歴エントリを公開しました / 変更履歴エントリを削除しました | ドキュメントサイトの変更履歴。 |
| 画像をアップロードしました / サイトを公開しました | メディアと公開。 |
| サインインが拒否されました | 無効、期限切れ、取り消されたトークンによる呼び出し、またはIP許可リスト外のアドレスからの呼び出し。 |
| トークンを作成しました / トークンを取り消しました / シークレットを再生成しました | トークンの変更。取り消しの理由（例：「管理者によって取り消されました」）も表示されます。 |
| アプリを接続しました / アプリの接続を解除しました | 接続済みアプリの変更。 |
| サインインコードが再利用されました：アクセスが取り消されました | 接続済みアプリのサインインが2回使用されたため、安全のためにCleveraがアクセスを取り消しました。アプリを再接続してください。 |
ログをフィルターする
右上のメニューを使用します：すべてのトークンとアプリ（または特定のトークン。リストにないトークンの場合はその他のトークン）およびすべてのサイト（または特定のサイト）。フィルターをクリアですべての項目が再表示されます。
このタブには、現在のフィルター条件における最新の100件のイベントが表示されます。Cleveraはアクティビティを13か月間保持します。
トラブルシューティングに活用する
- 「拒否されました」の行には拒否の理由が記載されています。多くの場合、権限不足、制限、または役割の変更が原因です。エージェントとAPIのエラーを修正するを参照してください。
- 短時間に「拒否されました」が多発すると、トークンが自動的に取り消されることがあります（「取り消されました：異常なアクティビティ」）。トークンが機能しなくなった理由を参照してください。
- 行のクレジットは、そのジョブで使用された量を示します。ワークスペースの使用状況ページで、クレジット使用量の全体像を確認できます。