> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# AI で API を探索する

> Admina APIは、AIと組み合わせることで、より効率的に探索・利用できます。

## AIとの連携

Admina APIは、AIアプリケーションとシームレスに連携できるように設計されています。以下のようなAIユースケースに対応しています。

* 自然言語によるAPIリクエストの生成
* APIレスポンスの自然言語による解釈
* 複雑なクエリの構築支援
* データ分析と洞察の自動生成

## AI開発者向けリソース

### APIスキーマの利用

Admina APIのOpenAPIスキーマは、AIモデルがAPIの構造と機能を理解するのに役立ちます。スキーマは以下のURLでアクセスできます。

```
https://api.itmc.i.moneyforward.com/public-api/docs/v1-json
```

### 自然言語インターフェースの構築

AIを使って自然言語でAdminaの機能にアクセスするインターフェースを構築できます。次に例を示します。

* "昨日追加された新しいユーザーを教えて"
* "IT資産の状況を要約して"

### コード生成

AIを使って、自然言語の指示からAPIリクエストコードを生成できます。

1. 指示を自然言語で記述
2. AIが対応するAPIエンドポイントとパラメータを特定
3. 実行可能なコードを生成

## ベストプラクティス

### セキュリティ

* AIにAPIキーを直接渡さない
* AI生成コードのセキュリティレビューをする
* 不要な権限を持つAPIキーの作成を避ける

### エラーハンドリング

* AIが生成したAPIリクエストにもエラーコードを確認するエラーハンドリングを実装
* APIのレート制限を考慮したリクエスト頻度の制御

### データプライバシー

* 機密データをAIツールに渡す際は注意が必要
* 個人情報や機密情報を扱う場合はマスキングや暗号化などの保護措置を講じる

## サンプルユースケース

### レポート生成

AIを使って定期的なレポートを自動生成:

```python theme={null}
# AIに指示: "今月のユーザーアクティビティレポートを作成"
# AIがAPIを呼び出してデータを収集し、自然言語のレポートを生成
```

### 異常検知

AIを使って異常なAPI利用パターンを検出:

```python theme={null}
# AIに指示: "過去1週間のログから異常なアクティビティを検出"
# AIがAPIからログデータを取得して分析
```

## サポート

AIとの連携に関する質問や問題がある場合は、サポートチームにお問い合わせください。