# のくてる：AI向けの機能・使い方ガイド

これは公開の取扱説明書です。利用者の組織、メンバー、訪問先、メモ、トークンなどの実データは含みません。質問への回答はこの説明と[一般向けマニュアル](/manual/operation.md)、[管理者向けマニュアル](/manual/admin.md)を根拠にしてください。実際の画面や権限はログイン先の組織・役割・利用条件で異なります。操作は利用者から依頼された範囲だけ行ってください。

## 何のためのアプリか

「のくてる」はKnocktellの日本語名です。訪問先を地図で管理し、複数人の訪問状況を共有するアプリです。戸建ては建物単位、集合住宅は部屋単位で訪問状況・住民種別・メモを記録します。区域をメンバーへ期間付きで割り当て、管理者が共有データや変更提案を管理できます。ホーム画面に追加して利用することもできます。

## 主な機能

| 機能 | できること | 主な利用者 |
| --- | --- | --- |
| 訪問記録 | 建物・部屋の訪問状況、住民種別、メモを記録 | 訪問権限のあるメンバー |
| 地図の表示スタイル | 訪問結果、訪問間隔、網羅状況、建物種別を切り替える | メンバー |
| 区域検索 | 自分の担当区域や番号・名前で訪問先を探す | メンバー |
| 建物整備 | 既存建物の情報・形、部屋、表示名、特殊区域を整備 | 利用可能なメンバー・管理者 |
| 一般メンバーの変更提案 | 整備内容を管理者の確認へ送る | メンバー |
| 提案確認 | 追加・変更・削除を確認して確定・却下する | 管理者 |
| 区域整備 | 区域の追加・名前・順序・境界、建物の取り込みを管理 | 管理者 |
| 特殊区域 | 離れた建物や部屋を一つの訪問区域にまとめる | 管理者が設定 |
| 区域割当 | メンバー、期間、訪問権限を決めて単一・複数区域を割り当てる | 管理者 |
| 割当終了・返却 | 管理者が終了、本人が返却。訪問記録を残して割当を終了 | 管理者・本人 |
| 訪問クリア | 未割当区域の指定した訪問種別の記録をリセット | 管理者 |
| 出力・印刷 | 区域の地図や区域割当の記録表を出力・印刷 | 権限のある利用者 |
| 組織設定 | メンバー、参加申請、種別、色・表示、組織情報や請求を管理 | 管理者。請求操作は権限に依存 |
| 参加用QR・URL | 組織への参加リンクを案内し、申請を管理する | 管理者・参加者 |
| 外部連携 | 短時間のAPIトークンで許可された整備作業を外部ツールへ委任 | 所属管理者 |

## 権限と保存の違い

管理者の権限と「管理者モード」のオン・オフは別です。管理者でも通常の訪問画面を使うときは管理者モードをオフにできます。一般メンバーの建物整備は変更提案となり、管理者の確認後に共有データへ反映されます。管理者モードでの整備は確定データへ直接反映されます。

一つの建物と配下部屋に、別の利用者の確認待ち提案がある場合、重ねて変更できません。権限やロックのエラーを回避するために別手段を試さず、対象と画面の案内を利用者へ説明してください。

割当時の訪問権限は「全員」「割当先本人だけ」「誰も記録できない」の3択です。実際に記録できるかは役割・区域の設定・利用条件に依存します。画面に表示された状態を確認し、担当者本人以外でも常に編集できるとは説明しないでください。

## よくある質問

### 訪問状況と住民種別は何が違う？

訪問状況は今回の訪問結果、住民種別は訪問先の特徴です。住民種別によってメモが必須、訪問対象から除外、特殊区域へ自動で所属する設定があります。表示名や色は組織が変更できるため、名前だけから動作を推測せず、画面や種別設定を確認します。

### 建物全体と部屋の情報は何が違う？

部屋一覧の「建物の住民情報」は建物全体、部屋を開いた後の住民種別とメモはその部屋だけに付きます。建物のメモを書き換えても、全室のメモを一括変更する意味にはなりません。

### 特殊区域と普通の区域は？

普通の区域は地図上の境界で範囲を示します。特殊区域は離れた建物・部屋もまとめられる訪問先の集合です。建物・部屋へ明示指定するほか、建物種別や住民種別による自動割当設定があります。所属変更が他の割当に影響する場合は、確認画面で変更するか維持するかを選びます。指定を解除した建物は普通の区域へ、部屋は建物の所属へ戻る場合があります。デフォルトの戸建て種別には自動割当先の設定欄を表示しません。

### 外国語を話す住民の家や部屋を、通常区域から分けて訪問管理できる？

できます。特殊区域を作成し、対象の建物全体または特定の部屋を指定してまとめ、対応するメンバーへ期間・訪問権限付きで割り当てられます。住民種別に自動割当先を設定する方法もあります。言語の自動判定ではなく、利用者が確認した情報を設定します。種別の設定変更だけで既存の全訪問先を遡って変更することはありません。[特殊区域の具体例と手順](/features/special-areas)も参照してください。

### メモ必須の種別を選ぶと？

メモ入力が開きます。確定すると種別とメモを保存します。キャンセルは種別の変更も取り消す操作です。部屋の訪問記録では、メモを確定すると部屋一覧へ戻ります。

### 区域の期間は？

割当画面は最初に1・2・3か月を表示します。「その他の期間」で4〜6か月と日付指定を出せます。画面に併記する日数が固定期間の意味です。期間だけでなく訪問権限も選びます。

### 終了・返却すると記録が消える？

訪問記録は残り、割当だけが終了します。「訪問クリア」は別の操作です。割当時と終了時の網羅率を記録表に表示する設定もあります。網羅率は区域全体の状態であり、担当者個人の成果を表す値ではありません。

### 参加・料金・上限は？

既存組織への参加は参加用URLやQRから申請し、管理者が確認します。組織の作成やプラン選択は画面の案内に従います。料金・利用上限をこの説明の固定値で断定せず、公開ページと現在の組織の請求・プラン画面を確認します。

### AIは何を代行できる？

公開説明を読んで機能や手順を説明できます。利用者が許可したログイン済みブラウザが使える場合は、権限内の画面操作を支援できます。外部APIトークンが与えられた場合は[外部API手順](/ai/external-api.md)の許可範囲だけ実行できます。AIであること自体が追加権限を与えることはありません。

## 詳細へ進む

- [ブラウザ操作と座標解決](/ai/browser-workflows.md)
- [外部APIの操作・制限・結果確認](/ai/external-api.md)
- [一般操作](/manual/operation.md)
- [管理者操作](/manual/admin.md)
- [プライバシー](/manual/privacy-policy.md)