agentengine agente create-tool

Synopsis

Gere arquivos de autoria de conector (tool.yaml e tool_defs.yaml) para a visualização de conectores.

Três modos mutuamente exclusivos:

• --spec FILE-OR-URL: Compile um documento OpenAPI 3.0 em um catálogo completo e crie o tool.yaml quando não existir.

• --tool-defs FILE: Crie apenas o arquivo tool.yaml do consumidor para um catálogo local existente. O catálogo nunca é reescrito.

• --config tool.yaml: Regenere um catálogo de propriedade local cujo tool.yaml declare source.spec.

O nome do conector é obrigatório com --spec e usa o padrão do nome do catálogo com --tool-defs.

O tool.yaml começa com um bloco de autenticação proposto a partir dos esquemas de segurança do documento. OAuth 2.0 e OpenID Connect precisam de --provedor, o aplicativo OAuth do projeto cujo token cada chamar apresenta; a concessão do aplicativo decide se as FERRAMENTAS chamam como cada usuário ou como o próprio cliente do agente. --scopes substitui os escopos que as operações expostas declaram. HTTP bearer, HTTP basic e chaves de API vinculam segredos do espaço de trabalho nomeados após o conector, por exemplo, JIRA_TOKEN. --auth none, bearer, basic ou api_keys substitui a proposta em cada operação.

As entradas de URL são buscadas sob a política de transporte da plataforma. O gerador é executado dentro do contêiner assistente runner-base, portanto, o comando requer Docker.

Sai com 0 em caso de sucesso, 1 quando a entrada é recusada ou a geração falha, 2 quando o contêiner assistente ou uma transferência de rede falha.

Experimental: as flags, o formato de saída e os formatos de arquivo gerados podem mudar sem aviso prévio.

agentengine agent create-tool [name] [flags]

Opções

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

Opções herdadas dos comandos pai

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

Veja também

• agente agentengine - Inspecione, edite e gere a configuração do agente.