メインコンテンツへスキップ
開発者向けドキュメントを表示しています
このドキュメントは、Base44 開発者プラットフォームで作業する開発者向けです。アプリエディタ内の AI エージェントについては、AI エージェントのセットアップを参照してください。
AI エージェントは、アクションを実行しツールに接続して、チームメンバーやエンドユーザーをサポートするカスタマイズ可能な AI アシスタントです。エージェントの動作、権限、ツールをローカル JSONC 設定ファイルを使用して定義します。

エージェントを作成する

base44/agents/ ディレクトリに JSONC 設定ファイルを作成し (エージェントごとに 1 ファイル)、agents push を実行して Base44 に同期します。

{
  "name": "customer_support",
  "description": "Handles customer support inquiries and ticket management",
  "instructions": "You are a friendly customer support agent. Help users resolve their issues politely and efficiently. If you cannot help, escalate to a human agent.",
  "model": "anthropic/claude-sonnet-4-20250514",
  "tool_configs": [
    {
      "entity_name": "tickets",
      "allowed_operations": ["read", "create", "update"],
    },
    {
      "entity_name": "customers",
      "allowed_operations": ["read"],
    },
    {
      "function_name": "send_notification",
      "description": "Sends a push notification to the customer",
    },
    {
      "function_name": "escalate_to_human",
      "description": "Escalates the conversation to a human support agent",
    },
  ],
  "whatsapp_greeting": "Hi, I'm your support assistant. How can I help you today?",
}

フィールドリファレンス

エージェント設定は JSONC を使用します。各エージェントは base44/agents/ ディレクトリ内の個別のファイルで定義されます。

必須フィールド

name
string
必須
エージェントの一意の識別子。小文字とアンダースコアを使用してください。名前はファイル名と一致する必要があるため、customer_support という名前のエージェントは customer_support.jsonc 内になります。
description
string
必須
エージェントが何をするかの簡単な説明。
instructions
string
必須
エージェントの動作、人格、ガイドラインを定義するシステムプロンプト。
model
string
必須
使用する AI モデル、provider/model-name 形式。サポートされるモデル:
  • anthropic/claude-sonnet-4-20250514
  • anthropic/claude-3-5-sonnet-20241022
  • openai/gpt-4o
  • openai/gpt-4o-mini

オプションフィールド

tool_configs
array
エージェントがアプリと対話するために使用できるツール。ツール設定を参照してください。
whatsapp_greeting
string
このエージェントとの WhatsApp 会話のウェルカムメッセージ。

ツール設定

tool_configs 配列は、エージェントが持つ機能を定義します。エンティティツール関数ツールの 2 つのタイプがあります。

エンティティツール

エンティティツールにより、エージェントはアプリのエンティティに対して CRUD 操作を実行できます。
entity_name
string
必須
エンティティの名前。アプリ内の既存エンティティと一致する必要があります。
allowed_operations
array
必須
エージェントがこのエンティティに対して実行できる操作。有効な値は "read""create""update""delete" です。

関数ツール

関数ツールにより、エージェントはアプリのバックエンド関数を呼び出すことができます。
function_name
string
必須
関数の名前。アプリ内の既存関数と一致する必要があります。
description
string
必須
関数が何をするかの説明。エージェントはこれを使用して、いつ呼び出すかを決定します。

TypeScript 型

エージェント設定から TypeScript 型を生成して、SDK コード内のエージェント名に対する型安全性とオートコンプリートを取得します。ダイナミック型について詳しく学んでください。

関連項目

  • agents pull: Base44 からローカルプロジェクトにエージェント設定を同期
  • agents push: ローカルエージェント設定を Base44 にデプロイ
  • agents: コード内でエージェントを操作するための SDK リファレンス
  • Setting up AI agents: AI エージェントの作成と構成のガイド
このページは AI を使用して翻訳されました。最も正確で最新の情報については、英語版 を参照してください。