> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Agents で Framer を使用する
このページでは、Profound の **Framer CMS** インテグレーションについて説明します。
Framer プロジェクトを接続すると、Framer CMS のコレクションとアイテムを操作するための次のアクションを Agent のステップとして利用できるようになります。各ステップでは、ドロップダウンから接続済みの **Framer Project** を選択する必要があります。
#### **Create Item**
Framer コレクションに新しい CMS アイテムを作成します。
**必須の入力**
* **Framer Project** — ドロップダウンから、Profound で接続した Framer プロジェクトを選択します
* **Collection** — ドロップダウンからコレクションを選択します
* **Field Data** — 利用可能なフィールドは、選択したコレクションのスキーマから生成されます。[Create Item の入力を扱う](#working-with-create-item-inputs)をご覧ください。
出力には、作成されたアイテムの `id`、`slug`、`draft`、[`field_data`](#understanding-item-output) が含まれます。
**ヒント:** アイテムを作成する前に、まず **Get Collection** を使用してコレクションのスキーマを調べ、どのフィールドが必須かを確認してください。
#### **List Collections**
接続した Framer プロジェクトで利用可能な CMS コレクションを取得します。
**必須の入力**
* **Framer Project** — ドロップダウンから、Profound で接続した Framer プロジェクトを選択します
出力には、各コレクションの `id`、`name`、`readonly` の値を含む、構造化されたコレクションの一覧が含まれます。
#### **Get Collection**
1 つの Framer コレクションとそのスキーマを取得します。
**必須の入力**
* **Framer Project** — ドロップダウンから、Profound で接続した Framer プロジェクトを選択します
* **Collection** — ドロップダウンからコレクションを選択します
出力には、コレクションの `id`、`name`、`readonly`、`managed_by`、[`field_definitions`](#understanding-collection-schemas) が含まれます。`field_definitions` には、各フィールドの `id`、`name`、`type`、および必須かどうかが記述されています。
#### **List Items**
Framer コレクションから CMS アイテムを取得します。
**必須の入力**
* **Framer Project** — ドロップダウンから、Profound で接続した Framer プロジェクトを選択します
* **Collection** — ドロップダウンからコレクションを選択します
出力には、各アイテムの `id`、`slug`、`draft`、[`field_data`](#understanding-item-output) が含まれます。
#### **Get Item**
ID を指定して 1 件の CMS アイテムを取得します。
**必須の入力**
* **Framer Project** — ドロップダウンから、Profound で接続した Framer プロジェクトを選択します
* **Collection** — ドロップダウンからコレクションを選択します
* **Item ID** — アイテム ID を直接入力します
出力には、アイテムの `id`、`slug`、`draft`、[`field_data`](#understanding-item-output) が含まれるため、内容を確認したり後続のステップに渡したりできます。
***
## サポートされているフィールドタイプ
Framer は動的なスキーマを採用しているため、Profound はお使いのコレクションモデルに対応します。アイテムの作成時に現在サポートされている Framer CMS のフィールドタイプは次のとおりです。
| フィールドタイプ | 説明 | サポート |
| - | - | - |
| **Plain Text** | 1 行のテキスト | あり |
| **Formatted Text** | リッチテキストコンテンツ | あり |
| **Date** | 日付フィールド | なし |
| **Link** | URL フィールド | あり |
| **Image** | 画像アセット | なし |
| **Gallery** | 画像の配列 | なし |
| **Color** | カラー値 | なし |
| **Toggle** | true/false の値 | あり |
| **Number** | 数値 | あり |
| **Option** | 単一選択のオプション | あり |
| **File** | ファイルアセット | なし |
| **Reference** | 別のアイテムへの参照 | なし |
| **Multi-Reference** | 複数のアイテムへの参照 | なし |
***
## コレクションのスキーマについて
アイテムを操作する前に、**Get Collection** を使用してコレクションのスキーマを確認してください。
出力には次の情報が含まれます。
* **Collection ID** と **Collection Name**
* **readonly** — コレクションが読み取り専用かどうか
* **managed\_by** — コレクションの管理方法
* **field\_definitions** — そのコレクションに設定されているフィールド
各フィールド定義には次の情報が含まれます。
* **id** — フィールドの Framer 内部 ID
* **name** — Framer に表示されるラベル
* **type** — `string`、`formattedText`、`number` など、フィールドの主な Framer タイプ
* **required** — フィールドが必須かどうか
* **itemType** — 複合フィールドタイプの追加のアイテム情報(Framer が提供する場合)
コレクションの出力例:
```json theme={null}
{
"collection": {
"field_definitions": [
{
"id": "slug",
"name": "Slug",
"required": true,
"type": "string",
"itemType": null
},
{
"id": "111111",
"name": "Title",
"required": true,
"type": "string",
"itemType": null
},
{
"id": "222222",
"name": "Content",
"required": true,
"type": "formattedText",
"itemType": null
}
],
"id": "333333",
"managed_by": "user",
"name": "Example Collection",
"readonly": false
}
}
```
***
## Create Item の入力を扱う
**Create Item** で Framer コレクションを選択すると、Profound はそのコレクションのスキーマから入力欄を動的に生成します。
サポートされているフィールドタイプについては、ステップの UI で値を直接入力できます。たとえば、コレクションでは次のようなフィールドが表示される場合があります。
* **Slug**
* **Title**
* **Content**
* **Link**
* **Name**
* **Option**
* **Count**
* **Featured**
コレクションに、サポートされていないタイプの必須フィールドが含まれている場合、Profound はそれらのフィールドに値を指定できないため、**Create Item** リクエストは失敗します。
**注:** アイテムを作成する前に、**Get Collection** を使用してフィールド定義を確認してください。現在サポートされていない Framer のフィールドタイプへの対応が必要な場合は、お問い合わせください。ユースケースの評価をお手伝いします。
***
## アイテムの出力について
Framer のアイテムのレスポンスには、次のようなトップレベルのアイテムフィールドが含まれます。
* **id**
* **slug**
* **draft**
* **field\_data**
`field_data` オブジェクトは、フィールド ID をキーとしています。各エントリーには、フィールドの人が読める名前、タイプ、値が含まれます。
アイテムの出力例:
```json theme={null}
{
"item": {
"draft": true,
"field_data": {
"111111": {
"name": "Title",
"type": "string",
"value": "Example title",
"valueByLocale": {}
},
"222222": {
"name": "Featured",
"type": "boolean",
"value": true
}
},
"id": "333333",
"slug": "example-title"
}
}
```
***
## 主なユースケース
* **コンテンツの公開**: AI が生成したコピーや構造化データから、新しい Framer CMS アイテムを作成します
* **コンテンツの取得**: レビュー、要約、後続のワークフローのために、Framer コレクションから構造化コンテンツを取得します
* **ワークフローの準備**: 特定の Framer フィールドに依存する自動化を構築する前に、コレクションのスキーマを確認します