Atualizar um modelo - Qoder CN Series: Central de Documentação do Alibaba Cloud

Atualize um modelo Forward por ID.

Cabeçalhos da requisição

Cabeçalho	Obrigatório	Descrição
`Authorization`	Sim	`Bearer <PAT>`
`Content-Type`	Sim	`application/json`
`Idempotency-Key`	Não	Chave de idempotência opcional para requisições não seguras.

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
`template_id`	string	Sim	ID do modelo Forward.

Corpo da requisição

Parâmetro	Tipo	Obrigatório	Descrição
`name`	string	Não	Novo nome do modelo.
`description`	string	Não	Nova descrição do modelo.
`model`	string	Não	Novo identificador de modelo.
`system`	string	Não	Novo prompt do sistema.
`tools`	array	Não	Substitui a lista de configuração de ferramentas.
`mcp_servers`	array	Não	Substitui a lista de servidores MCP.
`skills`	array	Não	Substitui a lista de vinculações de Skill.
`multiagent`	object	Não	Substitui a configuração de Managed Agents.
`environment_id`	string	null	Não	Substitui o ID de Environment padrão. Use `null` ou uma string vazia para limpar o valor.
`vault_ids`	array	null	Não	Substitui os IDs de Vault padrão. Use `null` para limpar a lista.
`files`	object	null	Não	Substitui os recursos de arquivo padrão. Use `null` para limpar o mapa.
`environment_variables`	object	string	null	Não	Substitui as variáveis de ambiente de sessão padrão. Use `null` para limpá-las.
`metadata`	object	Não	Mescla atualizações aos metadados personalizados.

Objetos de configuração aninhados

Os campos tools, mcp_servers e skills são arrays. Em uma atualização, cada array fornecido substitui integralmente o anterior.

Arquivos

O campo files é um mapa indexado por File ID. Não inclua file_id, id ou resource_id em uma entrada. O Forward injeta o mount_path automaticamente ao criar uma sessão.

Campo	Tipo	Obrigatório	Descrição
`enabled`	boolean	Não	Se omitido, o valor padrão é `true`. Em uma Identity Config, defina como `false` para desativar um arquivo herdado.

Itens de tools[]

Cada entrada de tools[] define sua estrutura pelo campo type.

Campo	Tipo	Aplica-se a	Descrição
`type`	string	Todos	Obrigatório. Um entre `agent_toolset_20260401`, `mcp_toolset` ou `custom`.
`enabled_tools`	array	`agent_toolset_20260401`	Lista de permissões simplificada; um array não vazio ativa apenas as ferramentas integradas listadas.
`disallowed_tools`	array	`agent_toolset_20260401`	Lista de bloqueios simplificada; compilada nas configurações de ferramentas desativadas.
`configs`	array	`agent_toolset_20260401`, `mcp_toolset`	Ativação por ferramenta e política de permissões.
`mcp_server_name`	string	`mcp_toolset`	Obrigatório. Deve corresponder a um `mcp_servers[].name`.
`name`	string	`custom`	Obrigatório. Nome da ferramenta personalizada; não pode entrar em conflito com uma ferramenta integrada.
`description`	string	`custom`	Obrigatório. Descrição da ferramenta personalizada.
`input_schema`	object	`custom`	JSON Schema obrigatório. `input_schema.type` deve ser `object`.

As ferramentas integradas incluem Bash, Read, Write, Edit, Glob, Grep, WebFetch, WebSearch e DeliverArtifacts.

Configuração de ferramenta

Cada entrada em tools[].configs[] usa a seguinte estrutura.

Campo	Tipo	Obrigatório	Descrição
`name`	string	Sim	Nome da ferramenta; use o nome da ferramenta integrada para nativas e o nome da ferramenta MCP para conjuntos de ferramentas MCP.
`enabled`	boolean	Não	`false` oculta e rejeita a ferramenta; `true` a ativa explicitamente.
`permission_policy`	object	Não	Comportamento de permissão em tempo de execução.

Política de permissões

Campo	Tipo	Obrigatório	Descrição
`type`	string	Sim	Um entre `always_allow`, `always_ask` ou `always_deny`.

Servidores MCP

Campo	Tipo	Obrigatório	Descrição
`type`	string	Não	Atualmente, há suporte apenas para `http`. Se omitido, a Effective Config trata a entrada como um servidor MCP HTTP.
`name`	string	Sim	Nome do servidor MCP, exclusivo no modelo e referenciado por `tools[].mcp_server_name`.
`url`	string	Sim	URL do endpoint MCP HTTP com suporte a streaming.

Itens de skills[]

Campo	Tipo	Obrigatório	Descrição
`type`	string	Sim	Pode ser `custom` ou `qoder`.
`skill_id`	string	Sim	ID da Skill.
`version`	string	Não	Versão da Skill. Omita para usar a versão mais recente.
`enabled`	boolean	Não	Se omitido, o valor padrão é `true`. `false` exclui a skill da configuração compilada do Agent.

Exemplo de requisição

curl -s -X POST 'https://api.qoder.com.cn/api/v1/forward/templates/tmpl_support' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support assistant v2",
    "environment_id": "env_support_v2",
    "vault_ids": ["vault_crm", "vault_billing"],
    "environment_variables": {
      "BASE_MODE": "support_v2"
    }
  }'

Exemplo de resposta

HTTP 200 OK

{
  "type": "template",
  "id": "tmpl_support",
  "name": "Support assistant v2",
  "description": "Handles pre-sales and after-sales support",
  "status": "active",
  "model": "ultimate",
  "system": "You are a helpful support assistant.",
  "tools": [],
  "mcp_servers": [],
  "skills": [],
  "multiagent": null,
  "environment_id": "env_support_v2",
  "vault_ids": ["vault_crm", "vault_billing"],
  "files": {},
  "environment_variables": {
    "BASE_MODE": "support_v2"
  },
  "metadata": {},
  "created_at": "2026-06-18T10:00:00Z",
  "updated_at": "2026-06-18T10:30:00Z"
}

Campos da resposta

Retorna o objeto Template atualizado.

Erros

HTTP	Tipo	Gatilho
400	`invalid_request_error`	Corpo da requisição inválido ou valor de campo sem suporte.
401	`authentication_error`	PAT inválido ou expirado.
404	`not_found_error`	O modelo ou recurso referenciado não existe.
409	`conflict_error`	O nome do modelo já existe.

Observações

Não é possível atualizar modelos arquivados.
Atualizar os padrões de sessão não altera as sessões existentes.