グローバルブランチで Pro-code エージェントを開発する

Pro-code エージェントは Global Branching と統合されており、main ブランチに影響を与えずに、ブランチ上のオントロジーやアプリケーションの変更と並行してエージェントのコードを開発・テストできます。グローバルブランチで実行されるエージェントは、オントロジー SDK（OSDK）および Ontology MCP の読み取りと書き込みに、そのブランチを自動的に使用します。

ブランチコンテキストがすべてのインターフェースに適用されるわけではありません。オントロジー SDK および Ontology MCP の操作は、選択したグローバルブランチを対象としますが、main ブランチのオントロジースキーマを使用します。そのため、グローバルブランチにのみ存在するオントロジーのタイプの変更は、生成される型や利用可能なツールには反映されません。プラットフォーム API のリクエストはブランチを認識せず、選択したグローバルブランチでは実行されません。

前提条件

グローバルブランチで Pro-code エージェントを開発する前に、次の条件を満たしていることを確認してください。

• お使いのエンロールメントで Global Branching とエージェントのブランチ機能が有効になっていること。利用をご希望の場合は、Palantir サポートにお問い合わせください。
• エージェントのコードリポジトリを編集できるロールを持っていること。たとえば、そのプロジェクトのデフォルトの編集者ロールまたは所有者ロールです。
• エージェントのリポジトリで、Global Branching に対応したテンプレートバージョンを使用していること。リポジトリをブランチに追加したときに、リポジトリが古いと Foundry に表示された場合は、リポジトリをアップグレードしてから再試行してください。

エージェントのリポジトリをグローバルブランチに追加する

グローバルブランチでエージェントを開発するには、次の手順を実行します。

1. エージェントのコードリポジトリまたはコードワークスペースを開きます。
2. ブランチセレクターを開き、グローバルブランチを作成または選択します。
3. 確認画面が表示された場合は、追加を選択してリポジトリをブランチに追加します。

Foundry はグローバルブランチに関連付けられたリポジトリブランチを作成し、コードワークスペースでチェックアウトします。開発を繰り返し進める際は、エージェントのコードの変更をこのリポジトリブランチにコミットします。

グローバルブランチでエージェントをテストする

Foundry で Pro-code エージェントを構築するの説明に従って、コードワークスペースから npm run start でエージェントを実行します。エージェントテンプレートは、チェックアウトされているリポジトリブランチに関連付けられたグローバルブランチを特定します。その後、オントロジー SDK および Ontology MCP の操作は、そのグローバルブランチから読み取り、そのグローバルブランチに書き込みます。エージェントライブラリが提供するオントロジー SDK クライアントは、呼び出しのグローバルブランチコンテキストを自動的に継承します。別の方法でクライアントを構築する場合は、ブランチコンテキストを明示的に設定しない限り、グローバルブランチでは動作しません。

エージェントがアクションを呼び出す場合は、アクションをテストする前に、同じグローバルブランチでアクションの対象オブジェクトタイプをインデックス化してください。Ontology Manager でグローバルブランチを選択し、対象オブジェクトタイプを開いて、バナーからオブジェクトタイプをインデックス化を選択します。インデックス化が完了してからエージェントを実行してください。

公開済みのエージェント関数も、同じグローバルブランチ上のリソースから呼び出されると、グローバルブランチコンテキストを受け取ります。ブランチ上のエージェント関数と、その関数が書き込むデータは、main およびほかのグローバルブランチから分離されています。

グローバルブランチでエージェントを公開する

公開すると、同じグローバルブランチ上のリソースからエージェント関数を利用できるようになります。

1. 公開するエージェントの変更をコミットします。
2. リポジトリのインターフェースでタグ付けするを選択します。
3. グローバルブランチを選択し、安定バージョンを対象バージョンとして選択します。対象バージョンは、グローバルブランチがマージされたときに main に公開されるバージョンです。
4. タグとリリースを選択します。

Foundry はブランチのプレリリースバージョンを作成し、エージェント関数をグローバルブランチに公開します。Git で直接タグを作成しないでください。リポジトリのインターフェースによって、グローバルブランチに必要なバージョンが作成されます。

開発を繰り返し進める間、同じ対象バージョンに再公開できます。対象バージョンを使用するグローバルブランチ上のリソースは、ブランチの最新のプレリリースを自動的に参照します。公開済みの関数は、main や別のグローバルブランチからは利用できません。

グローバルブランチからエージェントをマージする

エージェントとその依存リソースの準備ができたら、グローバルブランチの提案を作成してマージします。Foundry はリポジトリの変更をマージし、選択した対象の安定バージョンを main に公開します。ブランチの対象バージョンを使用していたリソースは、その後 main の安定バージョンを参照します。

マージする前に、対象バージョンが main で引き続き利用可能であることを確認し、Global Branching アプリケーションに表示されるチェック項目を解決してください。

次のステップ

• Pro-code エージェントを公開して呼び出す
• Global Branching ワークフローについて詳しくはこちら