AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

agentengine 에이전트 create-tool

[실험적] OpenAPI 문서 또는 기존 카탈로그에서 커넥터 작성 파일을 생성합니다.

커넥터 작성 파일(tool.yaml 및 tool_defs.yaml) 생성 커넥터 미리 보기용.

상호 배타적인 세 가지 모드:

  • --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 앱인 --provider가 필요합니다. 앱의 권한 부여는 도구가 각 사용자로 호출할지 아니면 에이전트 자체 클라이언트로 호출할지 결정합니다. --scopes는 노출된 작업이 선언하는 범위를 대체합니다. HTTP bearer, HTTP basic 및 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)
이 페이지 평가하기