> ## 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.

# base44 agents push

> ローカルの AI エージェント構成を Base44 にプッシュします。エージェントはユーザーと対話し、アプリのエンティティにアクセスし、バックエンド関数を呼び出せる会話型 AI アシスタントです。

<Warning>
  このページは AI コーディングエージェントスキルの一部で、人間ではなくエージェント向けに書かれています。人間向けの Base44 ドキュメントは [デベロッパードキュメント](/developers) を参照してください。
</Warning>

# base44 agents push

ローカルの AI エージェント構成を Base44 にプッシュします。エージェントはユーザーと対話し、アプリのエンティティにアクセスし、バックエンド関数を呼び出せる会話型 AI アシスタントです。

## 構文

```bash theme={null}
npx base44 agents push
```

## 認証

**必須**: はい。認証されていない場合は、先にログインを求められます。

## 動作

1. `base44/agents/` ディレクトリからすべてのエージェントファイルを読み込みます
2. エージェント構成を検証します
3. プッシュするエージェントの数を表示します
4. エージェントを Base44 バックエンドにアップロードします
5. 作成、更新、削除されたエージェントの結果を報告します

## 前提条件

* Base44 プロジェクトディレクトリから実行する必要があります
* プロジェクトの `base44/agents/` フォルダーにエージェント定義が存在する必要があります

## 出力

```bash theme={null}
$ npx base44 agents push

Found 2 agents to push
Pushing agents to Base44...

Created: support_agent
Updated: order_bot
Deleted: old_agent

✓ Agents pushed to Base44
```

## エージェントの同期

プッシュ操作はローカルのエージェントを Base44 に同期します:

* **Created**: Base44 に存在しなかった新しいエージェント
* **Updated**: 構成が変更された既存のエージェント
* **Deleted**: ローカル構成から削除されたエージェント

**警告**: これは完全同期操作です。ローカルで削除されたエージェントは Base44 から削除されます。

## エラー処理

プロジェクトにエージェントが見つからない場合:

```bash theme={null}
$ npx base44 agents push
No local agents found - this will delete all remote agents
```

エージェント名が無効な場合:

```bash theme={null}
$ npx base44 agents push
Error: Agent name must be lowercase alphanumeric with underscores
```

## エージェント構成スキーマ

各エージェントファイルは `base44/agents/` 内の `.jsonc` ファイルで、次の構造を持ちます:

```jsonc theme={null}
{
  "name": "agent_name",              // Required: lowercase alphanumeric with underscores, 1-100 chars
  "description": "Brief description of what this agent does",  // Required: min 1 char
  "instructions": "Detailed instructions for the agent's behavior",  // Required: min 1 char
  "tool_configs": [                  // Optional: defaults to []
    // Entity tool - gives agent access to entity operations
    { "entity_name": "Task", "allowed_operations": ["read", "create", "update", "delete"] },
    // Backend function tool - gives agent access to a function
    { "function_name": "send_email", "description": "Send an email notification" }
  ],
  "whatsapp_greeting": "Hello! How can I help you today?"  // Optional
}
```

**命名ルール:**

* **エージェント名** はパターン `/^[a-z0-9_]+$/` に一致する必要があります (小文字英数字とアンダースコアのみ、1-100 文字)
  * 有効: `support_agent`, `order_bot`, `task_helper`
  * 無効: `Support-Agent`, `OrderBot`, `task helper`
* **エージェントファイル名** はアンダースコアを使用する必要があります (エージェント名と一致)
  * 有効: `support_agent.jsonc`, `order_bot.jsonc`
  * 無効: `support-agent.jsonc` (ハイフンは使用不可)
* **`tool_configs` 内のエンティティ名** は PascalCase を使用する必要があります (エンティティの `name` フィールドと一致)
  * 有効: `"entity_name": "Task"`, `"entity_name": "TeamMember"`
  * 無効: `"entity_name": "task"`, `"entity_name": "team_member"`

**必須フィールド:**

* `name`: 必須、上記の命名ルールに従う
* `description`: 必須、最小 1 文字
* `instructions`: 必須、最小 1 文字
* `tool_configs`: オプション、デフォルトは空配列
* `whatsapp_greeting`: オプション

### よくある間違い: 誤った tool\_configs 形式

**誤** - `type` と `entity` を持つ `tools` は使用しないでください:

```jsonc theme={null}
{
  "name": "my_agent",
  "tools": [                                    // ❌ WRONG
    { "type": "entity_query", "entity": "Task" }
  ]
}
```

**正** - `entity_name` と `allowed_operations` を持つ `tool_configs` を使用します:

```jsonc theme={null}
{
  "name": "my_agent",
  "tool_configs": [                             // ✅ CORRECT
    { "entity_name": "Task", "allowed_operations": ["read"] }
  ]
}
```

### エージェントの指示に関するベストプラクティス

エージェントにエンティティへのアクセスを与える場合は、指示の中でツールの使用について明示的にしてください:

```jsonc theme={null}
{
  "name": "support_agent",
  "instructions": "あなたは親切なサポートエージェントです。\n\n重要: エンティティツールを通じて顧客データにアクセスできます。ユーザーが注文やアカウントについて尋ねた場合:\n1. 必ず Order エンティティツールを使って注文履歴を照会してください\n2. Customer エンティティツールを使ってアカウント詳細を検索してください\n3. データを分析し、パーソナライズされた回答を提供してください\n\nユーザーデータに関する質問に答える前に、必ず関連するエンティティを最初に照会してください。",
  "tool_configs": [
    { "entity_name": "Order", "allowed_operations": ["read"] },
    { "entity_name": "Customer", "allowed_operations": ["read"] }
  ]
}
```

エンティティツールを使うよう明示的な指示がないと、エージェントは尋ねられてもユーザーデータを主体的に照会しない場合があります。

## ユースケース

* プロジェクトで新しいエージェントを定義した後
* 既存のエージェント構成を変更するとき
* テスト前にエージェントの変更を同期するために
* エージェントの動作が変わる開発ワークフローの一部として

## 注意事項

* このコマンドはエージェント構成を同期し、会話データは同期しません
* 変更は Base44 プロジェクトに即座に適用されます
* まず開発環境でエージェントの変更をテストしてください
* エージェント定義は `base44/agents/` ディレクトリにあります
* Base44 からエージェントをダウンロードするには `base44 agents pull` を使用します

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