Agents で Sanity を使用する

​

主要な概念

​

ドキュメントとタイプ

​

データセット

​

下書きと公開済み

• 公開済みドキュメントはプレーンな ID を持ちます(例: abc123)
• 下書きドキュメントは、同じ ID に drafts. プレフィックスが付いたものを持ちます(例: drafts.abc123)

​

Portable Text(リッチテキスト)の操作

​

リッチテキストコンテンツの指定

{
  "body": "<h1>Welcome</h1><p>This is a <strong>blog post</strong> with <em>formatting</em>.</p><ul><li>First item</li><li>Second item</li></ul>"
}

{
  "_type": "post",
  "title": "My Post",
  "body": [
    {
      "_type": "block",
      "_key": "abc123",
      "style": "normal",
      "markDefs": [],
      "children": [
        {
          "_type": "span",
          "_key": "def456",
          "marks": [],
          "text": "Hello world"
        }
      ]
    }
  ]
}

​

Sanity スキーマを Agent ステップに対応付ける

​

例: ブログ記事のスキーマ

// In your Sanity Studio schema
defineType({
  name: 'post',
  title: 'Post',
  type: 'document',
  fields: [
    defineField({ name: 'title', type: 'string' }),
    defineField({ name: 'slug', type: 'slug' }),
    defineField({ name: 'author', type: 'reference', to: [{ type: 'author' }] }),
    defineField({ name: 'body', type: 'blockContent' }),
    defineField({ name: 'publishedAt', type: 'datetime' }),
    defineField({ name: 'categories', type: 'array', of: [{ type: 'reference', to: [{ type: 'category' }] }] }),
  ],
})

​

ステップごとのセットアップ

1. Agent に Create Resource ステップを追加し、Sanity Project ドロップダウンから接続済みの Sanity プロジェクトを選択します。
2. ドロップダウンから Dataset を選択します(例: production)。
3. Document Details に、ドキュメントのフィールドを JSON で入力します。ここでは、タイトル、スラッグ、参照、カテゴリなどのシンプルな値を指定します。
   {
     "_type": "post",
     "title": "My Post Title",
     "slug": {
       "_type": "slug",
       "current": "my-post-title"
     },
     "author": {
       "_type": "reference",
       "_ref": "author-id-123"
     },
     "publishedAt": "2025-01-15T10:30:00Z",
     "categories": [
       {
         "_type": "reference",
         "_ref": "category-id-456"
       }
     ]
   }
   
   前のステップの動的な値を使用するには、フィールド内で / を入力して変数メニューを開き、変数を選択します。変数は JSON 内にピルバッジとしてインライン表示されます。たとえば、"My Post Title" を前の LLM ステップの変数に置き換えることができます。
4. Portable Text フィールド(ブログ本文など)には、Rich Text Content を入力します。フィールド名を HTML 文字列に対応付けると、Profound が自動的に Sanity の形式に変換します。
   {
     "body": "<h1>Welcome</h1><p>This is my post content.</p>"
   }
   
   ここに変数を挿入して、前のステップで生成された HTML を渡すこともできます。/ を入力して変数メニューを開き、LLM などの前のステップの出力を値として選択します。
5. Publish Resource をオンまたはオフにします — すぐに公開する場合はオンにし、Sanity Studio でレビューするための下書きを作成する場合はオフのままにします。

​

フィールドタイプのリファレンス

​

一般的なワークフロー

​

ブログ記事を生成して公開する

1. LLM ステップ — プロンプトからタイトル、スラッグ、HTML 本文を生成します
2. Create Resource — 生成したコンテンツを使用して Sanity の post ドキュメントを作成します
3. Publish Resource — 下書きを公開します(またはステップ 2 で publish_resource: true を設定します)

​

既存のコンテンツを更新する

1. Get Resource — ID を指定して現在のドキュメントを取得します
2. LLM ステップ — 既存のドキュメントに基づいて更新後のコンテンツを生成します
3. Update Resource — 変更されたフィールドのみを更新します

​

コンテンツの移行

1. List Resources — あるデータセットからドキュメントを取得します
2. Loop — リストを反復処理します
3. Create Resource — 別のデータセットに各ドキュメントを作成します

​

下書きレビューのパイプライン

1. Create Resource — コンテンツを下書きとして作成します(デフォルトの動作)
2. 人によるレビュー — Sanity Studio で手動のレビューを行います
3. Publish Resource — 承認された下書きを Agent 経由で公開します

​

権限とロール

​

トラブルシューティング

​

その他のリソース

• Sanity Content Lake — データセットとドキュメントについて
• Portable Text — Sanity のリッチテキスト形式の仕様
• GROQ Query Language — Sanity でのコンテンツのクエリ
• HTTP API Reference — Sanity API の完全なドキュメント
• Mutations API — ドキュメントの作成、更新、削除