Agents で Framer を使用する

このページでは、Profound の Framer CMS インテグレーションについて説明します。 Framer プロジェクトを接続すると、Framer CMS のコレクションとアイテムを操作するための次のアクションを Agent のステップとして利用できるようになります。各ステップでは、ドロップダウンから接続済みの Framer Project を選択する必要があります。

Create item
List collections
Get collection
List items
Get item

Create Item

Framer コレクションに新しい CMS アイテムを作成します。必須の入力

Framer Project — ドロップダウンから、Profound で接続した Framer プロジェクトを選択します
Collection — ドロップダウンからコレクションを選択します
Field Data — 利用可能なフィールドは、選択したコレクションのスキーマから生成されます。Create Item の入力を扱うをご覧ください。

出力には、作成されたアイテムの id、slug、draft、field_data が含まれます。

ヒント: アイテムを作成する前に、まず 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 が含まれます。field_definitions には、各フィールドの id、name、type、および必須かどうかが記述されています。

List Items

Framer コレクションから CMS アイテムを取得します。必須の入力

Framer Project — ドロップダウンから、Profound で接続した Framer プロジェクトを選択します
Collection — ドロップダウンからコレクションを選択します

出力には、各アイテムの id、slug、draft、field_data が含まれます。

Get Item

ID を指定して 1 件の CMS アイテムを取得します。必須の入力

Framer Project — ドロップダウンから、Profound で接続した Framer プロジェクトを選択します
Collection — ドロップダウンからコレクションを選択します
Item ID — アイテム ID を直接入力します

出力には、アイテムの id、slug、draft、field_data が含まれるため、内容を確認したり後続のステップに渡したりできます。

サポートされているフィールドタイプ

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 が提供する場合)

コレクションの出力例:

{
  "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 をキーとしています。各エントリーには、フィールドの人が読める名前、タイプ、値が含まれます。アイテムの出力例:

{
  "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 フィールドに依存する自動化を構築する前に、コレクションのスキーマを確認します

認証

インテグレーションとコネクタ

モニタリング

組織設定

メンバー

エージェンシー向け Profound

Agents で Framer を使用する

Create Item

List Collections

Get Collection

List Items

Get Item

サポートされているフィールドタイプ

コレクションのスキーマについて

Create Item の入力を扱う

アイテムの出力について

主なユースケース

​Create Item

​List Collections

​Get Collection

​List Items

​Get Item

​サポートされているフィールドタイプ

​コレクションのスキーマについて

​Create Item の入力を扱う

​アイテムの出力について

​主なユースケース

Create Item

List Collections

Get Collection

List Items

Get Item

サポートされているフィールドタイプ

コレクションのスキーマについて

Create Item の入力を扱う

アイテムの出力について

主なユースケース