Agents で Contentful を使用する

Contentful アカウントを接続すると、次のアクションを Agent のステップとして利用できるようになります。各ステップでは、ドロップダウンから接続済みの Contentful Account を選択する必要があります。

Create entry
Update entry
Get entry
List entries

Create Entry

Contentful スペースに新しいエントリーを作成します。必須の入力

Contentful Account
Space
Environment
Content Type
Fields(コンテンツタイプのスキーマに基づいて動的に変化)

任意の入力

Locale(デフォルトはスペースのデフォルトロケール)
Publish(すぐに公開するか、下書きとして保存するか)

エントリーは、コンテンツタイプのスキーマに基づいて作成されます。リッチテキストフィールドは Markdown を受け付け、Contentful のリッチテキスト形式に自動的に変換されます。

ヒント: 公開前にレビュー用の下書きを作成するには、Publish のチェックを外したままにしてください。

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

Contentful は動的なスキーマを採用しているため、Profound はお使いのコンテンツモデルに自動的に対応します。すべてのフィールドタイプがサポートされています。

フィールドタイプ	説明	入力形式
Short text	1 行のテキスト	プレーンテキスト
Long text	複数行のテキスト	プレーンテキスト
Rich text	書式付きコンテンツ	Markdown(自動変換)
Number	小数	数値
Integer	整数	整数
Boolean	true/false	ブール値
Date & time	ISO 8601 形式の日付	日付文字列
Location	地理座標	`{lat, lon}` オブジェクト
JSON object	任意の JSON	JSON オブジェクト
Media	アセットの参照	アセット ID
Reference	エントリーの参照	エントリー ID または ID の配列

リッチテキストを扱う

Contentful のリッチテキストフィールドは、構造化ドキュメント形式(AST)を使用します。Profound は Markdown、HTML、Contentful ネイティブのリッチテキスト JSON 形式を受け付けます。 サポートされている Markdown:

見出し(# H1 から ###### H6 まで)
段落
太字、斜体、その他の書式
箇条書きリストと番号付きリスト
引用
コードブロック
リンク

サポートされている HTML:

<h1> から <h6> までの見出し
<p> 段落
<strong>、<em>、<u> の書式
<ul>、<ol>、<li> のリスト
<blockquote> 引用
<code>、<pre> コードブロック
<a> リンク

ネイティブのリッチテキスト JSON: Contentful のリッチテキストドキュメントがすでにある場合は、そのまま渡すことができます。

{
  "nodeType": "document",
  "data": {},
  "content": [
    {
      "nodeType": "paragraph",
      "data": {},
      "content": [
        { "nodeType": "text", "value": "Hello world", "marks": [] }
      ]
    }
  ]
}

ヒント: ワークフローに最も適した形式を使用してください。Markdown、HTML、ネイティブのリッチテキスト JSON のいずれもシームレスに機能します。

参照を扱う

参照フィールドはエントリー同士をリンクします。次のいずれかを指定できます。

単一の参照: エントリー ID を文字列で指定します
複数の参照: エントリー ID の配列を指定します

Profound は、これらを Contentful が必要とするリンク形式に自動的に変換します。

ロケールについて

Contentful はロケールベースのコンテンツモデルを採用しており、すべてのフィールド値はロケール(例: en-US、fr-FR)をキーとして保存されます。Profound はこれを自動的に処理します。

デフォルトの動作: ロケールを指定しない場合、Profound はスペースのデフォルトロケールを使用します
単一ロケール: ロケールを指定すると、その言語でコンテンツを書き込みます
複数ロケール: raw JSON 形式を使用すると、複数のロケールを一度に書き込めます

ロケールのラッピングの仕組み

次のようなシンプルなフィールド値を指定した場合:

{
  "title": "My Blog Post"
}

Profound は Contentful の API 向けに自動的にラップします。

{
  "title": {
    "en-US": "My Blog Post"
  }
}

このロケールのラッピングは、Contentful に送信する前にすべてのフィールドに対して行われます。

入力形式

Profound では、エントリーの作成と更新に 2 つの入力形式を使用できます。

シンプル形式
Raw JSON 形式

シンプル形式は人が扱いやすく、ロケールのラッピングを自動的に処理します。

{
  "space": "your-space-id",
  "environment": "master",
  "content_type_id": "blogPost",
  "locale": "en-US",
  "fields": {
    "title": "My Blog Post",
    "body": "# Hello\n\nThis is **markdown**.",
    "heroImage": "asset-123",
    "relatedPosts": ["post-1", "post-2"]
  },
  "publish": false
}

特長:

フラットなフィールド構造(ロケールのネストなし)
参照はシンプルな文字列 ID で指定
リッチテキストフィールドには Markdown を使用
ロケールの自動ラッピング

raw 形式では、ロケール固有のコンテンツを完全に制御できます。

{
  "space": "your-space-id",
  "environment": "master",
  "content_type_id": "blogPost",
  "fields": {
    "title": {
      "en-US": "My Blog Post",
      "fr-FR": "Mon Article de Blog"
    },
    "body": {
      "en-US": "# Hello\n\nEnglish content.",
      "fr-FR": "# Bonjour\n\nContenu français."
    }
  },
  "publish": false
}

この形式を使用する場面:

複数のロケールでコンテンツを同時に書き込む場合
ロケール固有の値を正確に制御する必要がある場合
別のシステムからコンテンツを移行する場合

主なユースケース

コンテンツの公開: ブログ記事、記事、製品説明を生成して公開します
コンテンツの更新: 既存のエントリーを新しい情報で一括更新します
コンテンツの移行: 環境間やスペース間でコンテンツを移動します
自動化ワークフロー: 外部トリガーやデータソースに基づいてエントリーを作成します

認証

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

モニタリング

組織設定

メンバー

エージェンシー向け Profound

Agents で Contentful を使用する

Create Entry

Update Entry

Get Entry

List Entries

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

リッチテキストを扱う

参照を扱う

ロケールについて

入力形式

主なユースケース

関連リソース

​Create Entry

​Update Entry

​Get Entry

​List Entries

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

​リッチテキストを扱う

​参照を扱う

​ロケールについて

​入力形式

​主なユースケース

​関連リソース

Create Entry

Update Entry

Get Entry

List Entries

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

リッチテキストを扱う

参照を扱う

ロケールについて

入力形式

主なユースケース

関連リソース