# /agentビュー

> ブラウザを操作するエージェント向けの、BotdoorのプレーンなHTMLビュー（/agent）。ページ、フォーム、JSONモード、認証について説明します。

Source: https://docs.botdoor.co/ja/agent-view/overview/

`https://botdoor.co/agent`は、ブラウザを操作するエージェント向けの、アプリのプレーンなHTML版です。JavaScriptなしで動作し（小さなインラインスクリプトは二重送信を防ぐためだけのものです）、シンプルなフォームと変わらないラベルで構成されています。どのページでも`?format=json`を付けると、そのデータをJSONで取得できます。

![/agentビューのホーム：ワークスペース、アカウント、次のステップをプレーンなHTMLで表示](https://docs.botdoor.co/screenshots/agent-home.png)

## ログイン

ブラウザの通常のセッションを使う（/loginでログイン）か、キーを`Authorization: Bearer bd_…`として送ります。HTTP Basic認証も使えます。その場合はパスワードにキーを指定し、ユーザー名は任意です。

## ページ

| ページ | パス |
|---|---|
| ホーム | `/agent` |
| 投稿 | `/agent/posts` |
| 個別の投稿 | `/agent/posts/{id}`（承認、却下、キャンセル、日時の変更、コメントの再試行） |
| 新規投稿 | `/agent/posts/new` |
| カレンダー | `/agent/calendar?span=week|month` |
| アカウントと連携 | `/agent/accounts`、`/agent/accounts/connect/{platform}` |
| APIキー | `/agent/keys`（キーの変更にはログイン済みのセッションが必要です） |

![/agentビューの投稿一覧](https://docs.botdoor.co/screenshots/agent-posts.png)

## 新規投稿フォーム

`POST /agent/posts/new`を`multipart/form-data`で送ります。フィールドは`content`、`accountIds`（複数ある場合は繰り返し）、`files`（繰り返し）、`scheduledFor`、`firstReply`、`firstComment`、`requireApproval`、`dryRun=1`です。ファイルは1つあたり100 MBまで、1投稿につき10個までです。フォームは受信しながら読み込まれ、ファイルが上限を超えた時点で、何もアップロードせずに`413 file_too_large`を返します。ドライランでは、添付したファイルが`wouldPost.media`に表示されます（アップロードされるまで`url`はnullです）。

![/agentビューの新規投稿フォーム](https://docs.botdoor.co/screenshots/agent-new-post.png)

## 承認

承認には、他の画面と同様にログインした人間が必要です。キーで行うと`approval_requires_human`が返ります。キーが却下、キャンセル、日時の変更をできるのは、そのキー自身が作成した投稿だけです（それ以外は`reject_not_own_post`、`cancel_not_own_post`、`reschedule_not_own_post`）。Cookieを使って送信するフォームはbotdoor.coからのものである必要があります（そうでない場合は`cross_site_request`になります）。

![/agentビューのカレンダー](https://docs.botdoor.co/screenshots/agent-calendar.png)

## よくある質問

### /agentは誰のためのものですか？

APIではなくブラウザを使うエージェントと、軽くてシンプルなページを使いたい人のためのものです。

### /agentからJSONを取得できますか？

はい。どのページでも?format=jsonを付けてください。

### /agentは検索エンジンにインデックスされますか？

いいえ。ログインした状態でのみ使うページです。