> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# エージェントスキル

> アプリの AI エージェント用に再利用可能な指示セットを定義します

<div className="dev-docs-banner">
  <div className="dev-docs-banner-content">
    <div className="dev-docs-banner-title">
      開発者向けドキュメントを表示しています
    </div>

    <div className="dev-docs-banner-text">
      このドキュメントは、Base44 開発者プラットフォームで作業する開発者向けです。アプリエディタでエージェントにスキルを追加する方法については、<a href="/Building-your-app/AI-agents-for-apps">AI エージェントの設定</a>を参照してください。
    </div>
  </div>
</div>

エージェントスキルは、再利用可能な指示セットです。[AI エージェント](/ja/developers/backend/resources/agents/overview) に、特定の動作、専門知識、ポリシーを与えます。たとえば、返金ポリシーやブランドボイスです。エージェントスキルはアプリ単位で管理されます。アプリで一度定義すれば、そのアプリ内のどのエージェントにも割り当てられます。

<Note>
  これらはアプリ内で動作するエージェント用のスキルです。[Base44 スキル](/ja/developers/backend/overview/skills) とは異なります。Base44 スキルは、Claude や Cursor などの AI コーディングアシスタントに Base44 アプリの構築方法を教えるものです。
</Note>

## エージェントによるスキルの使い方

各エージェントは、必要なスキルを名前で選択します。実行時、エージェントは選択した各スキルの説明を常に参照します。完全な指示は、スキルが関連すると判断したときにだけ読み込みます。これにより、エージェントのプロンプトを小さく保ちつつ、必要に応じて詳細な指示を利用できます。

1 つのエージェントには最大 10 個のスキルを割り当てられます。1 つのアプリには合計で最大 100 個のスキルを保持できます。

エージェントにスキルを割り当てるには、エージェントの `selected_skill_names` 配列にスキル名を追加します。

```jsonc theme={null}
{
  "name": "customer_support",
  "description": "Handles customer support inquiries and ticket management",
  "instructions": "You are a friendly customer support agent.",
  "model": "claude-sonnet-5",
  "selected_skill_names": ["refund-policy", "brand-voice"],
}
```

## エージェントスキルをローカルで定義する

各スキルは、`base44/agent-skills/` ディレクトリ内の 1 つの Markdown ファイルです。`.md` 拡張子を除いたファイル名がスキル名になります。YAML フロントマターにはスキルの `description` を記述します。本文には、エージェントがスキルを使うときに従う指示を記述します。例:

```markdown theme={null}
---
description: How to handle refund requests and exceptions
---

When a customer asks for a refund, first check whether the order is within
the 30 day return window. If it is, approve the refund. If it is outside the
window, explain the policy politely and offer store credit instead.
```

スキル名は小文字で、単語をハイフンで区切る必要があります。たとえば `refund-policy` です。説明は最大 1024 文字、指示の本文は最大 15000 文字です。

<Tip>
  デフォルトでは、スキルは `base44/agent-skills/` に置かれます。パスは、[プロジェクト設定](/ja/developers/backend/overview/project-structure#config-jsonc) の `agentSkillsDir` でカスタマイズできます。
</Tip>

## エージェントスキルをデプロイする

エージェントスキルは [`agent-skills push`](/ja/developers/references/cli/commands/agent-skills-push) でデプロイします。すべてのプロジェクトリソースを一度にプッシュするには [`deploy`](/ja/developers/references/cli/commands/deploy) を使います。

エージェントスキルをローカルプロジェクトにダウンロードするには、[`agent-skills pull`](/ja/developers/references/cli/commands/agent-skills-pull) を使います。

## 関連項目

* [`agent-skills push`](/ja/developers/references/cli/commands/agent-skills-push): ローカルのエージェントスキルを Base44 にプッシュします
* [`agent-skills pull`](/ja/developers/references/cli/commands/agent-skills-pull): Base44 からローカルプロジェクトにエージェントスキルを同期します
* [エージェントについて](/ja/developers/backend/resources/agents/overview): これらのスキルを使うエージェントを設定します

<Note>このページは AI によって翻訳されました。最も正確で最新の情報については、[英語版](/) を参照してください。</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.