Skip to main content
このページは AI コーディングエージェントスキルの一部で、人間ではなくエージェント向けに書かれています。人間向けの Base44 ドキュメントは デベロッパードキュメント を参照してください。

​
base44 agents push

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

​
構文

npx base44 agents push

​
認証

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

​
動作

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

​
前提条件

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

​
出力

$ 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 から削除されます。

​
エラー処理

プロジェクトにエージェントが見つからない場合: 
$ npx base44 agents push
No local agents found - this will delete all remote agents
エージェント名が無効な場合: 
$ npx base44 agents push
Error: Agent name must be lowercase alphanumeric with underscores

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

各エージェントファイルは base44/agents/ 内の .jsonc ファイルで、次の構造を持ちます: 
{
  "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 は使用しないでください: 
{
  "name": "my_agent",
  "tools": [                                    // ❌ WRONG
    { "type": "entity_query", "entity": "Task" }
  ]
}
正 - entity_name と allowed_operations を持つ tool_configs を使用します: 
{
  "name": "my_agent",
  "tool_configs": [                             // ✅ CORRECT
    { "entity_name": "Task", "allowed_operations": ["read"] }
  ]
}

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

エージェントにエンティティへのアクセスを与える場合は、指示の中でツールの使用について明示的にしてください: 
{
  "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 を使用します
このページは AI を使用して翻訳されました。最も正確で最新の情報については、英語版 を参照してください。