agentengine agente create-tool

Synopsis

Generar archivos de creación de conectores (tool.yaml y tool_defs.yaml) para la vista previa de los conectores.

Tres modas mutuamente excluyentes:

• --spec FILE-OR-URL: Compila un documento OpenAPI 3.0 en un catálogo completo y genera el archivo tool.yaml cuando no exista.

• --tool-defs FILE: Genera solo el archivo tool.yaml del consumidor para un catálogo local existente. El catálogo nunca se sobrescribe.

• --config tool.yaml: Vuelva a generar un catálogo de propiedad local cuyo tool.yaml declare source.spec.

El nombre del conector es obligatorio con --spec y, por defecto, es el nombre del catálogo con --tool-defs.

tool.yaml comienza con un bloque de autenticación propuesto a partir de los esquemas de seguridad del documento. OAuth 2.0 y OpenID Connect necesitan --proveedor, la aplicación OAuth del Proyecto cuyo token presenta cada llamar; la concesión de la aplicación decide si las herramientas llaman como cada usuario o como el propio cliente del agente. --scopes reemplaza los ámbitos que declaran las operaciones expuestas. HTTP bearer, HTTP basic y API keys vinculan secretos del espacio de trabajo que llevan el nombre del conector, por ejemplo JIRA_TOKEN. --auth none, bearer, basic o api_keys reemplaza la propuesta en cada operación.

Las entradas de URL se recuperan bajo la política de transporte de la plataforma. El generador se ejecuta dentro del contenedor asistente runner-base, por lo tanto, el comando requiere Docker.

Sale 0 en caso de éxito, 1 cuando se rechaza la entrada o falla la generación, 2 cuando falla el contenedor asistente o una transferencia de red.

Experimental: los indicadores, el formato de salida y los formatos de archivo generados pueden cambiar sin previo aviso.

agentengine agent create-tool [name] [flags]

opciones

    --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

Opciones heredadas de comandos padre

    --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)

Ver también

• agente agentengine: inspecciona, edita y genera la configuración del agente.