Developer toolchainDeveloper Console概要

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

Developer Console

Developer Console を使用して、カスタムアプリケーションと、それに関連する認可クライアントおよび SDK を構築・管理します。カスタムアプリケーションを使用すると、開発者は Foundry の内部または外部でホストされるカスタムロジックで Foundry の機能を拡張できます。レガシー OAuth クライアントも Developer Console で管理します。

Developer Console と SuperRepo のどちらを使うべきですか?

Developer Console は、UI を中心にカスタムアプリケーションを設定する方法です。ここでアプリケーションを組み立てると、追加したリソース用の SDK を Foundry が生成して公開します。アプリケーションをコードで定義したい場合は、SuperRepo をご確認ください。SuperRepo は、オントロジー定義、関数、フロントエンドをまとめて保持する、コード中心の開発向けのモノレポです。編集に合わせて SDK をローカルで生成し、ご自身の CI システムから複数のエンロールメントにデプロイできる Marketplace 製品として配布されます。

カスタムアプリケーション

カスタムアプリケーションの主要な構成要素は次のとおりです。

  1. 認可クライアント: 人間のユーザーおよびサービスユーザーが Foundry にプログラムでアクセスできるようにする OAuth クライアントです。

  2. SDK: アプリケーションに追加されたリソースから生成される1つ以上の SDK です。アプリケーションの制限を参照してください。

  3. SDK ドキュメント: アプリケーションの SDK に合わせて自動生成される API ドキュメントとコードスニペットです。

  4. 権限: ユーザーレベルおよびアプリケーションレベルのアクセス制御です。権限を参照してください。

  5. メトリクス: アプリケーションの使用状況とパフォーマンスに関するインサイトです。アプリケーションのメトリクスを参照してください。

  6. Web ホスティング(任意): Foundry のサブドメインでカスタムフロントエンドをホストします。

  7. コードリポジトリ(任意): アプリケーションコード用にリンクされたコードリポジトリリソースです。

  8. Marketplace での配布(任意): アプリケーションをパッケージ化し、Foundry 環境間でデプロイします。Marketplace で Developer Console アプリケーションをインストールするを参照してください。

  9. MCP サーバー(任意): オントロジーリソースを Model Context Protocol ツールとして外部の AI エージェントに公開します。Ontology MCP を参照してください。

カスタムアプリケーションの構築をはじめるには、新しい Developer Console アプリケーションを作成するを参照してください。

OAuth クライアント

OAuth クライアントはカスタムアプリケーションに似たレガシーの基本要素ですが、認可クライアントのみを含み、上記のその他の機能は含みません。OAuth クライアントは、通常、プログラムでアクセスするユーザーに制限なしのアクセスを付与するために使用されてきました。OAuth クライアントの代わりに制限なしのアプリケーションを使用することを推奨します。

Developer Console のランディングページ

Developer Console のランディングページには、アクセスできるカスタムアプリケーションと OAuth クライアントが一覧表示されます。

アクセス要件の詳細については、権限のドキュメントをご確認ください。

Developer Console のホームページには、すべてのアプリケーションと OAuth クライアントが一覧表示されます。

アプリケーションのページ

アプリケーションの概要

アプリケーションの概要ページでは、次のことができます。

  • Web サイトホスティングのステータスと、生成された SDK のバージョンを表示します。
  • アプリケーションのオントロジー SDK に含まれるオントロジーリソースを確認します。
  • アプリケーションのメタデータを編集したり、アプリケーションを削除したりします。

アプリケーションの概要ページには、リソースの件数と共有オプションが表示されます。

OAuth クライアントについては、Developer Console で OAuth クライアントを管理するを参照してください。

OAuth と制限

アプリケーションの認証フローとリソースアクセス制限を設定します。制限により、トークンが付与するアクセスは、アプリケーションに対して承認されたリソースのみに限定されます。また、このページのアプリケーションの制限で、アプリケーションを制限ありまたは制限なしに設定します。この設定は作成ウィザードには含まれません。

権限の設定とアプリケーションの制限について、詳しくはこちらをご覧ください。

[OAuth と制限]ページには、認証とリソースの設定が表示されます。

SDK ドキュメント

各アプリケーションには、その SDK の内容に合わせて自動生成された API ドキュメントが含まれます。左側のパネルから API ドキュメントを選択するとアクセスできます。

API ドキュメントには、次の内容が含まれます。

  • アプリケーション固有の SDK のインストールガイド。
  • 個々のオブジェクトを読み込み、データのページを取得するコード例。
  • オントロジーの各オブジェクトタイプ、アクションタイプ、関数のリファレンス資料。

言語のドロップダウンメニューを使用して、TypeScript、Python、その他のサポート対象言語を切り替えます。

アプリケーションのドキュメントページには、API リファレンスとコード例が表示されます。

共有とトークン

アプリケーションをユーザー、グループ、組織と共有します。プログラムによるアクセス用に、有効期間の長いスコープ付きトークンを生成します。

アプリケーションの権限ページには、共有設定とトークン生成が表示されます。

Web ホスティング

React SPA などのフロントエンドのみのアプリケーションを Foundry 上で直接ホストすることで、外部のホスティングインフラストラクチャが不要になります。

Web ホスティングページには、デプロイオプションとドメイン設定が表示されます。

詳細については、オントロジー SDK アプリケーションを Foundry でホストするドキュメントをご確認ください。

メトリクス

リクエスト数、成功率、API の遅延など、アプリケーションのパフォーマンスを監視します。

アプリケーションのメトリクスページには、リクエスト数とパフォーマンスデータが表示されます。

アプリケーションのメトリクスについて詳しくはこちら。

MCP

アプリケーションを MCP サーバーとして設定し、オントロジーリソースを外部の AI エージェントに公開します。有効にすると、AI エージェントはアプリケーションのオブジェクトタイプ、アクションタイプ、クエリ関数を MCP ツールとして見つけて使用できます。

Ontology MCP について詳しくはこちらをご覧ください。

上限

デフォルトでは、各 Developer Console アプリケーションのデータリソースとリソースアクセス制限は、合計1000個に制限されています。この上限に達した場合は、Palantir の管理者にお問い合わせください。