Atualizando uma implementação

Depois de criar uma implementação on-line ou em lote, ainda é possível atualizar os detalhes da implementação e atualizar os ativos associados à sua implementação.

Para obter mais informações, consulte:

Atualização de detalhes de implementação

É possível atualizar detalhes de implementação geral, como nome de implementação, descrição, metadados e tags, utilizando um desses métodos:

Antes de iniciar

Você deve configurar suas credenciais de tarefa gerando uma chave de API. Para obter mais informações, consulte Gerenciamento de credenciais de tarefas.

Como atualizar detalhes de implementação da UI

  1. Na guia Implementações de seu espaço de implementação, clique no menu de ação para a implementação e escolha Editar Configurações

  2. Atualize os detalhes e, em seguida, clique em Salvar

    Dica: Também é possível atualizar uma implementação a partir da planilha de informações para a implementação.

Atualização de detalhes de implementação usando o comando API Patch

Use o comando watsonx.ai Runtime API Patch para atualizar os detalhes da implantação.

curl -X PATCH '<deployment endpoint url>/ml/v4/deployments/<deployment id>?space_id=<space id>&version=<YYYY-MM-DD>' \n--data-raw '[
    {
        "op": "<operation type>",
        "path": "<path>",
        "value": "<new value>"
    },
    {
        "op": "<operation type>",
        "path": "<path>",
        "value": "<new value>"
    }
]'

Por exemplo, para atualizar uma descrição da implementação:

curl -X PATCH '<deployment endpoint url>/ml/v4/deployments/<deployment_id>?space_id=<space_id>&version=<YYYY-MM-DD>' \n--data-raw '[
    {
        "op": "replace",
        "path": "/description",
        "value": "<new_description>"
    },
]'

Notas:

Nota:
  • Para <operation type>, use "add", "remove" ou "replace".

Atualizando ativos associados a uma implementação

Depois de criar uma implementação on-line ou em lote, é possível atualizar o ativo implementado no mesmo terminal. Por exemplo, se você tiver um modelo de desempenho melhor, será possível substituir o modelo implementado pela versão melhorada. Quando a atualização for concluída, o novo modelo estará disponível no endpoint da API REST.

Antes de atualizar um ativo, certise-se de que essas condições são verdadeiras:

Atualização de um ativo a partir da UI do espaço de implementação

  1. Na guia Implementações do seu espaço de implementação, clique no menu de ação para a implementação e escolha Editar
  2. Clique em Substituir Ativo Na caixa de diálogo Selecionar um ativo , selecione o ativo pelo qual deseja substituir o ativo atual e clique em Selecionar ativo.
  3. Clique em Salvar.
Importante: Assegure-se de que o novo ativo seja compatível com a implementação.

Substituindo um ativo implementado

Atualização de um ativo usando o comando API Patch

Use o comando ' Patch da API de tempo de execução watsonx.ai para atualizar qualquer ativo compatível.

Use este método para corrigir um modelo para uma implementação on-line.

curl -X PATCH '<deployment endpoint url>/ml/v4/models/<model_id>?space_id=<space_id>&project_id=<project_id>&version=<YYYY-MM-DD>' \n--data-raw '[
    {
        "op": "<operation type>",
        "path": "<path>",
        "value": "<new value>"
    },
    {
        "op": "<operation type>",
        "path": "<path>",
        "value": "<new value>"
    }
]'

Por exemplo, corrigir um modelo com id 6f01d512-fe0f-41cd-9a52-1e200c525c84 no id do espaço f2ddb8ce-7b10-4846-9ab0-62454a449802:

curl -X PATCH '<deployment endpoint url>/ml/v4/models/6f01d512-fe0f-41cd-9a52-1e200c525c84?space_id=f2ddb8ce-7b10-4846-9ab0-62454a449802&project_id=<project_id>&version=<YYYY-MM-DD>' \n--data-raw '[

   {
      "op":"replace",
      "path":"/asset",
      "value":{
         "id":"6f01d512-fe0f-41cd-9a52-1e200c525c84",
         "rev":"1"
      }
   }
]'

Uma resposta de saída bem-sucedida se parece com esta:

{
  "entity": {
    "asset": {
      "href": "/v4/models/6f01d512-fe0f-41cd-9a52-1e200c525c84?space_id=f2ddb8ce-7b10-4846-9ab0-62454a449802",
      "id": "6f01d512-fe0f-41cd-9a52-1e200c525c84"
    },
    "custom": {
    },
    "description": "Test deployments",
    "name": "test_v4_dep_online_space_hardware_spec",
    "online": {
    },
    "space": {
      "href": "/v4/spaces/f2ddb8ce-7b10-4846-9ab0-62454a449802",
      "id": "f2ddb8ce-7b10-4846-9ab0-62454a449802"
    },
    "space_id": "f2ddb8ce-7b10-4846-9ab0-62454a449802",
    "status": {
      "online_url": {
        "url": "https://example.com/v4/deployments/349dc1f7-9452-491b-8aa4-0777f784bd83/predictions"
      },
      "state": "updating"
    }
  },
  "metadata": {
    "created_at": "2020-06-08T16:51:08.315Z",
    "description": "Test deployments",
    "guid": "349dc1f7-9452-491b-8aa4-0777f784bd83",
    "href": "/v4/deployments/349dc1f7-9452-491b-8aa4-0777f784bd83",
    "id": "349dc1f7-9452-491b-8aa4-0777f784bd83",
    "modified_at": "2020-06-08T16:55:28.348Z",
    "name": "test_v4_dep_online_space_hardware_spec",
    "parent": {
      "href": ""
    },
    "space_id": "f2ddb8ce-7b10-4846-9ab0-62454a449802"
  }
}

Notas:

  • Para <operation type>, use "add", "remove" ou "replace".

  • O estado inicial para a saída PATCH API é "atualizando". Continue pesquisando o status até que ele mude para "pronto", em seguida, recupere a meta de implementação.

  • Apenas o atributo ASSET pode ser especificado para a correção de ativos. Alterar qualquer outro atributo resulta em um erro.

  • O esquema do modelo atual e do modelo que está sendo corrigida é comparado com o ativo implementado. Uma mensagem de aviso é devolvida na saída da API de solicitação do Patch se os dois não coincidem. Por exemplo, se uma incompatibilidade for detectada, será possível localizar essas informações na resposta de saída..

    "status": {
      "message": {
        "text": "The input schema of the asset being patched does not match with the currently deployed asset. Please ensure that the score payloads are up to date as per the asset being patched."
      },

  • Para obter mais informações, consulte Atualizando especificações de software usando a API.