AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

agentengine エージェント create-tool

[実験的] OpenAPIドキュメントまたは既存のカタログからコネクタ作成ファイルを作成します。

コネクタ作成ファイル(tool.yamlおよびtool_defs.yaml)を生成しますコネクタプレビュー用。

相互に排他的な3つのモード:

  • --spec FILE-OR-URL: OpenAPI 3.0 ドキュメントを完全なカタログにコンパイルし、tool.yamlが存在しない場合はそれをスキャフォールドします。

  • --tool-defs FILE既存のローカルカタログ用に consumer tool.yaml のみをスキャフォールドします。カタログが書き換えられることはありません。

  • --config tool.yaml: tool.yamlでsource.specが宣言されているローカル所有のカタログを再生成します。

コネクタ名は --spec では必須であり、--tool-defs ではデフォルトでカタログ名になります。

tool.yamlは、ドキュメントのセキュリティスキームから提案されたauthブロックで始まります。OAuth 2.0とOpenID Connectには、各呼び出しが提示するトークンのプロジェクトOAuthアプリである--プロバイダーが必要です。アプリの許可によって、ツールが各ユーザーとして呼び出すか、エージェント自身のクライアントとして呼び出すかが決まります。--scopesは、公開された操作が宣言するスコープを置き換えます。HTTPベアラー、HTTPベーシック、APIキーは、例JIRA_TOKENのようにコネクタにちなんで名付けられたワークスペースシークレットをバインドします。--auth none、bearer、basic、またはapi_keysは、すべての操作の提案を置き換えます。

URL入力は、プラットフォームのトランスポートポリシーに基づいてフェッチされます。ジェネレーターはrunner-baseヘルパーコンテナ内で実行されるため、このコマンドにはDockerが必要です。

成功した場合は 0 で終了し、入力が拒否されたか生成が失敗した場合は 1 で終了し、ヘルパーコンテナまたはネットワーク転送が失敗した場合は 2 で終了します。

実験的機能:フラグ、出力形式、生成されるファイル形式は予告なく変更される場合があります。

agentengine agent create-tool [name] [flags]
--allow string Comma-separated operation allow list (default: allow_all) --auth string Credential to present instead of the one the document proposes: none, bearer, basic, or api_keys --base-url string Tenant API base URL for the authoring file --config string Existing tool.yaml that declares source.spec; regenerates its catalog-h, --help help for create-tool --out-dir string Connector folder for the generated files (required with --spec/--tool-defs) --provider string Project OAuth app whose token each call presents --scopes string Comma-separated OAuth scopes with --provider (default: the scopes the exposed operations declare) --skip-unsupported Exclude operations the preview cannot represent instead of failing; every skip is printed and recorded in the catalog's provenance --spec string OpenAPI 3.0 document (local file or HTTPS URL) to compile --timeout duration Helper container timeout (default 5m0s) --tool-defs string Existing local catalog to scaffold tool.yaml for
--log-file string override log file path --log-level string file log verbosity (error|warn|info|debug) (default "info") --no-log disable file logging-q, --quiet silence stderr below error-v, --verbose count raise stderr verbosity (-v info, -vv debug)
  • agentengine agent - エージェント構成の検査、編集、生成を行います。
このページを評価