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

base44 agents push

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

構文

認証

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

動作

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

前提条件

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

出力

エージェントの同期

プッシュ操作はローカルのエージェントを Base44 に同期します:
  • Created: Base44 に存在しなかった新しいエージェント
  • Updated: 構成が変更された既存のエージェント
  • Deleted: ローカル構成から削除されたエージェント
警告: これは完全同期操作です。ローカルで削除されたエージェントは Base44 から削除されます。

エラー処理

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

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

各エージェントファイルは base44/agents/ 内の .jsonc ファイルで、次の構造を持ちます:
命名ルール:
  • エージェント名 はパターン /^[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 形式

- typeentity を持つ tools は使用しないでください:
- entity_nameallowed_operations を持つ tool_configs を使用します:

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

エージェントにエンティティへのアクセスを与える場合は、指示の中でツールの使用について明示的にしてください:
エンティティツールを使うよう明示的な指示がないと、エージェントは尋ねられてもユーザーデータを主体的に照会しない場合があります。

ユースケース

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

注意事項

  • このコマンドはエージェント構成を同期し、会話データは同期しません
  • 変更は Base44 プロジェクトに即座に適用されます
  • まず開発環境でエージェントの変更をテストしてください
  • エージェント定義は base44/agents/ ディレクトリにあります
  • Base44 からエージェントをダウンロードするには base44 agents pull を使用します
このページは AI を使用して翻訳されました。最も正確で最新の情報については、英語版 を参照してください。