Criação de fluxos de trabalho com agentes no criador de fluxos de trabalho

Editar detalhes do fluxo de trabalho do agente

Para editar os detalhes do fluxo de trabalho autêntico:

1. No menu , vá até “Compilar ”.

2. Navegue até Todas as ferramentas.

   Em um ambient IBM Cloud, selecione o espaço de trabalho associado ao fluxo de trabalho na lista de espaços de trabalho.

3. Selecione o fluxo de trabalho, clique no ícone Opções e selecione Editar detalhes.

4. Na guia "Visão geral ", atualize o nome e insira uma descrição para a ferramenta.

5. Clique na guia Parâmetros para configurar as entradas e saídas da ferramenta.

6. Clique em Adicionar entradas para definir a entrada. Para obter instruções detalhadas, consulte Adição de entradas

7. Clique em Add outputs (Adicionar saídas) para definir a saída. Para obter instruções detalhadas, consulte Adicionando saídas

8. Clique em Pronto.

Incluir caminhos

Para adicionar um caminho a um ramo:

1. Clique na filial.

2. Na janela da ramificação, selecione Adicionar caminho.

Adicionar condições de caminho

Para adicionar uma condição a um caminho:

1. Clique na filial.

2. Localize o caminho e selecione Editar condição. Escolha uma das seguintes opções para definir uma condição:

   • Para criar uma condição usando o Criador de condições :

     1. Na janela do Construtor de condições, clique em e selecione uma variável na lista suspensa Variáveis disponíveis.

     2. Clique e selecione um operador na lista suspensa.

     3. Clique e insira um valor.

     4. Pressione Enter. Para adicionar mais de uma condição, selecione Adicionar condição.

   • Para criar uma condição usando o editor de expressões :

     1. Selecione o Editor de expressões.

     2. Clique em Enter expression e digite a expressão Python.

3. Clique em voltar.

Editar ou excluir uma condição

Para editar as condições de um caminho:

1. Clique na filial.

2. Localize o caminho e selecione Editar condição. Selecione uma das seguintes opções para editar uma condição:

   • Para editar uma condição usando o Criador de condições :

     1. Atualize a variável, o operador e o valor.

     2. Clique em Enter.

   • Para editar uma condição usando o editor de expressões :

     1. Selecione o editor de expressões.

     2. Clique na expressão para abrir a janela do editor e atualizar a expressão Python.

Para excluir a condição de um caminho:

1. Clique na filial.

2. Localize o caminho e selecione Editar condição.

3. Clique em “Excluir condição”.

Editar caminhos

Você pode gerenciar os caminhos em seu ramo alterando a ordem, renomeando um caminho ou excluindo um caminho.

Para alterar a ordem dos caminhos:

1. Clique na filial.

2. Clique em “Mais ações”.

3. Selecione Mover para cima ou Mover para baixo na lista para alterar a ordem.

Você também pode reorganizar a ordem dos caminhos clicando e arrastando o ícone ao lado do caminho.

Para editar um caminho:

1. Clique na filial.

2. Clique em “Mais ações”.

3. Selecione Editar nome do caminho e digite o novo nome.

Para excluir um caminho:

1. Clique na filial.

2. Clique em “Mais ações”.

3. Selecione Excluir.

Lista de seleção

Para selecionar uma lista para o Para cada controle:

1. Clique no botão Para cada controle.

2. Use uma das seguintes opções para selecionar uma lista:

   • Por padrão, o mapeamento automático está ativado, o que seleciona um objeto de lista a partir da entrada do fluxo de trabalho do agente.

No entanto, você pode alterar esse comportamento padrão e configurar o objeto de lista escolhendo opções de variáveis ou expressões.

• Para configurar o objeto de lista usando uma variável, selecione e escolha uma variável na lista Variáveis disponíveis.

• Para configurar um objeto de lista usando uma expressão, selecione e clique em “Inserir expressão” na seção “Selecionar um campo da lista” para abrir a janela do editor e atualizar a expressão “ Python ”.

Quando o objeto de lista é selecionado, as variáveis de iterador e índice são fornecidas automaticamente.

Adicionar variáveis locais

As variáveis locais são usadas somente dentro de um controle For each e não podem ser acessadas fora dele. Cada iteração do For each pode armazenar resultados intermediários específicos para essa iteração. Esses valores são armazenados dentro deles e não podem ser compartilhados entre diferentes iterações.

Para adicionar variáveis locais ao Para cada controle:

1. Clique no botão Para cada controle.

2. Clique na seção Variáveis locais.

3. Selecione Adicionar na janela Variáveis locais.

4. Selecione o tipo de variável na lista suspensa.

5. Digite o nome e a descrição.

6. Marque a caixa de seleção List of {object type} se quiser armazenar uma lista de valores na variável.

7. Clique em Incluir.

Para adicionar mais de uma variável local, clique em Adicionar.

Editar ou excluir variável local

Para editar uma variável local:

1. Clique no botão Para cada controle.

2. Clique na seção Variáveis locais.

3. Passe o mouse sobre a variável e selecione .

4. Atualize o nome e a descrição na janela Atualizar saída.

5. Clique em Salvar.

Para excluir uma variável local:

1. Clique no botão Para cada controle.

2. Clique na seção Variáveis locais.

3. Passe o mouse sobre a variável e selecione .

Atividades do usuário

Você pode usar a atividade do usuário para criar uma interação baseada em bate-papo para coletar informações e exibir o resultado em um fluxo de trabalho autêntico. Para obter mais informações, consulte Adicionar atividades do usuário.

Para assistir a um vídeo de exemplo sobre como adicionar atividades do usuário, consulte “Criação de um fluxo de trabalho agênico com atividades do usuário” em watsonx Orchestrate, na seção Vídeos.

Blocos lógicos

Você pode usar o bloco lógico para adicionar lógica personalizada Python diretamente em um fluxo de trabalho de agente. Para obter mais informações, consulte “Adicionando blocos lógicos ”.

Prompts geradores

Você pode usar um prompt generativo quando precisar de ajuda com tarefas que envolvam compreensão de linguagem natural. Ele funciona usando um modelo de linguagem grande (LLM) para gerar texto ou conteúdo estruturado. Para prompts generativos em fluxos de trabalho agênticos, você pode adicionar novos modelos por meio do AI Gateway. Para obter mais informações, consulte Adicionando prompts generativos.

Para ver um vídeo de exemplo sobre como adicionar prompts generativos, consulte “Criação de um fluxo de trabalho autônomo com prompts generativos” em “ watsonx Orchestrate ”, na seção “Vídeos ”.

Classificadores de documentos

Você pode adicionar classificadores de documentos a fluxos de trabalho autênticos para identificar automaticamente os tipos de documentos. Para obter mais informações, consulte Adicionar classificadores de documentos.

Extratores de documentos

Você pode adicionar extratores de documentos a fluxos de trabalho autênticos para extrair campos ou entidades, como data, nomes e outros, de documentos. Para obter mais informações, consulte Adicionando extratores de documentos.

Extratores de texto

Você pode usar um extrator de texto em um fluxo de trabalho autêntico para extrair texto de um documento. Para obter mais informações, consulte Adicionar extratores de texto.

Adicionar entradas

Para adicionar entradas de fluxo de trabalho autêntico:

1. Clique no nó Iniciar.

2. Na janela Inputs, clique em Adicionar.

3. Selecione um tipo de entrada na lista.

4. Digite um nome e uma descrição.

5. Opcional: marque a caixa de seleção Lista de valores ( {data type} ) para armazenar uma lista de valores na entrada.

6. Opcional: ative o botão de alternância Definir valores padrão para definir a entrada com um valor padrão.

7. Digite um valor e clique no campo de valor padrão.

8. Opcional: ative o botão de alternância “Obrigatório” para marcar o campo como obrigatório. Quando um campo é marcado como obrigatório, o agente tenta obter um valor para esse campo antes de executar a ferramenta. Se for possível inferir um valor a partir do contexto do agente, o agente utiliza esse valor. Caso contrário, o agente solicita que o usuário insira um valor.

9. Clique em Incluir.

   • Se você selecionar a caixa de seleção Lista de {data type}, poderá adicionar mais de um valor padrão no campo Lista de valores padrão.

   • A caixa de seleção Lista de {data type} não está disponível para entradas de arquivo, e a opção Definir valor padrão não está disponível para entradas de arquivo e objeto.

   • Para o tipo de dados objeto, você pode escolher entre a visualização simples e a visualização JSON para visualizar as propriedades do objeto.

Adicionar saídas

Para adicionar saídas de fluxo de trabalho autêntico:

1. Clique no nó Final.

2. Na janela Outputs (Saídas ), clique em Add (Adicionar ).

3. Selecione o tipo de saída na lista.

4. Opcional: marque a caixa de seleção Lista de valores ( {data type} ) para gerar uma lista de valores como saída.

5. Clique em Incluir.

   • A caixa de seleção Lista de {data type} não está disponível para entradas de arquivos.

   • Para o tipo de dados objeto, você pode escolher entre a visualização simples e a visualização JSON para visualizar as propriedades do objeto.

Adicionando variáveis de fluxo

Para adicionar variáveis de fluxo:

1. Clique no ícone localizado no lado esquerdo da janela do fluxo de trabalho do agente.

2. Clique em Add (Adicionar ) e selecione o tipo de variável na lista.

3. Digite um nome e uma descrição.

4. Opcional: marque a caixa de seleção Lista de {data type} para armazenar uma lista de valores na variável.

5. Opcional: ative o botão de alternância Definir valores padrão para definir a variável com um valor padrão.

6. Digite um valor e clique no campo de valor padrão.

7. Clique em Incluir.

   • Se você selecionar a caixa de seleção Lista de {data type}, poderá adicionar mais de um valor padrão no campo Lista de valores padrão.

   • A opção Definir valor padrão não está disponível para variáveis de arquivo, objeto e usuário.

   • Para o tipo de dados objeto, você pode escolher entre a visualização simples e a visualização JSON para visualizar as propriedades do objeto.

Pré-requisitos para utilizar o tipo de dados do usuário em um fluxo de trabalho agênico

Você pode usar o tipo de dados do usuário para definir variáveis que armazenam detalhes do usuário do locatário. Antes de listar usuários locatários em um fluxo de trabalho de agente, é necessário configurar o acesso às APIs da plataforma IBM Cloud.

Como administrador do locatário, execute as seguintes etapas para configurar o acesso:

1. Crie um ID de serviço ou usuário que represente seu aplicativo ou fluxo de trabalho. Para obter mais informações, consulte a seção “Gerenciamento de IDs de serviço ”.

2. Gere uma chave API para o ID do serviço. Para obter mais informações, consulte Gerenciamento de chaves de API de identificação de serviço.

3. Atribua as seguintes funções ao ID do serviço ou ao usuário:

   • Função de administrador, com escopo definido para o locatário wxO de destino como um recurso

   • Função de visualizador para todos os serviços de gerenciamento de contas IAM

Para obter mais informações sobre a atribuição de funções, consulte Gerenciamento do acesso a recursos. Depois de atribuir essas funções, registre a chave de API do ID do serviço ou do usuário como uma conexão com o ID de aplicativo WXO_PLATFORM_USER_API predefinido.

Este pré-requisito é exigido apenas para locatários do watsonx Orchestrate hospedados em IBM Cloud.

Adicionando propriedades a um tipo de dados de objeto

Você pode adicionar propriedades a um tipo de dados de objeto para entradas, saídas e variáveis.

Para adicionar propriedades a um tipo de dados de objeto:

1. Selecione o tipo de dados Objeto na lista.

2. Digite um nome e uma descrição.

3. Opcional: marque a caixa de seleção Lista de objetos para armazenar uma lista de valores no tipo de dados do objeto.

4. Clique ao lado do nome do objeto na árvore de objetos ou clique em Adicionar + na seção Propriedades do objeto.

5. Selecione uma propriedade da lista.

6. Digite um nome e uma descrição.

7. Opcional: marque a caixa de seleção Lista de valores ( {data type} ) para armazenar uma lista de valores na propriedade do objeto.

8. Opcional: ative a opção Definir valores padrão para definir as propriedades com um valor padrão.

9. Digite um valor e clique no campo de valor padrão.

10. Você pode escolher entre a visualização simples e a visualização JSON para visualizar as propriedades do objeto.

11. Clique em Salvar.

Tipos de dados de objetos

Ao definir um objeto, considere os seguintes elementos. Um objeto inclui um nome, uma descrição opcional e um conjunto de propriedades definidas usando um subconjunto simplificado do padrão de esquema JSON. Para obter mais informações, consulte a documentação do esquema JSON.

As propriedades podem ser objetos com suas próprias propriedades aninhadas. Também podem ser listas, que são definidas usando o tipo de matriz do esquema JSON.

Aqui está um exemplo que mostra as propriedades de um objeto Employee definido usando o esquema JSON

{
    "id": {
        "type": "integer",
        "description": "Unique identifier for the employee"
    },
    "firstName": {
        "type": "string",
        "description": "Employee's first name"
    },

    "lastName": {
        "type": "string",
        "description": "Employee's last name"
    },
    "email": {
        "type": "string",
        "description": "Employee's email address"
    },
    "department": {
        "type": "string",
        "description": "Employee's department"
    },
    "salary": {
        "type": "number",
        "description": "Employee's salary"
    },
    "isActive": {
        "type": "boolean",
        "description": "Whether the employee is currently active"
    },
    "startDate": {
        "type": "string",
        "format": "date",
        "description": "Employee's start date"
    },
    "badges": {
        "type": "array",
        "items": {
            "type": "string"
        },
        "description": "Employee's badges"
    },
    "address": {
        "type": "object",
        "properties": {
            "street": {
                "type": "string"
            },
            "city": {
                "type": "string"
            },
            "zipCode": {
                "type": "string"
            }
        }
    }
}

O esquema do objeto funcionário inclui as seguintes propriedades:

• id, email, salary isActive, e startDate são propriedades simples que contêm valores inteiros, strings, decimais, booleanos e datas.

• address é uma propriedade de objeto com propriedades aninhadas: rua, cidade e zipCode.

• badges é uma lista, expressa como uma matriz JSON Schema de valores de cadeia de caracteres.

Você pode baixar um exemplo de fluxo de trabalho do Agent que está relacionado ao tipo de dados Object em https://github.com/IBM/ibm-watsonx-orchestrate-adk/tree/main/examples/flow_builder/Employee_information. Para obter mais informações, consulte Exemplos de fluxos de trabalho agênicos.

Mapear dados

Os nós de um fluxo de trabalho agêntico podem exigir dados como entrada. Esses dados podem vir das entradas no fluxo de trabalho agêntico, das saídas dos nós upstream e do contexto da sessão de bate-papo.

Quando um fluxo de trabalho agêntico é concluído, ele também pode produzir dados como saída. Os dados produzidos pelo fluxo de trabalho agêntico podem vir das entradas do fluxo de trabalho agêntico ou de nós dentro do fluxo de trabalho agêntico.

Por padrão, quando um nó requer dados como entrada, o mecanismo de fluxo de trabalho agêntico tenta identificar possíveis fontes de dados. Se o mecanismo de fluxo de trabalho agêntico localizar uma fonte, ele mapeará automaticamente esses dados no nó. No entanto, você pode substituir esse comportamento padrão e fornecer um mapeamento nos nós ou na saída do fluxo de trabalho autêntico. Para substituir o comportamento de mapeamento da saída do fluxo de trabalho agêntico, selecione o nó End do fluxo de trabalho agêntico.

Para editar o mapeamento de dados em um fluxo de trabalho autêntico, selecione o nó e clique em Editar mapeamento de dados.

As seguintes opções de mapeamento de dados estão disponíveis:

• Mapeamento automático: Um fluxo de trabalho agêntico mapeia automaticamente os dados entre as etapas, conectando as entradas dos nós às saídas de outros nós ou às próprias entradas do fluxo de trabalho agêntico. Se um dado necessário não for produzido por nenhum nó no fluxo de trabalho agêntico, você poderá definir uma entrada no nível do fluxo de trabalho agêntico com o mesmo nome e tipo. Em seguida, o mecanismo de fluxo de trabalho agêntico o mapeia automaticamente, o que pode garantir uma transferência de dados perfeita em todo o fluxo de trabalho agêntico.

Formato de data e hora para blocos de código e expressões

Ao definir valores de data e hora em blocos de código ou expressões de mapeamento de dados, utilize o formato padrão ISO 8601 com suporte ao fuso horário da IANA:

Formato ISO 8601 : YYYY-MM-DDThh:mm:ss±hh:mm[timezone/location]

Exemplo : 2026-02-19T07:15:00+05:00[Europe/London]

Detalhamento do formato :

• Data : YYYY (Ano), MM (Mês), DD (Dia)

• Hora : hh (Hora), mm (Minutos), ss (Segundos)

• Separador : Um 'T' separa os componentes de data e hora

• Fuso horário : 'Z' (UTC) ou um ±hh:mm deslocamento

• Localização do fuso horário : identificador de fuso horário da IANA entre colchetes (por exemplo, [Europe/London])

A indicação do fuso horário é recomendada, mas pode ser omitida. Esse formato garante uma ordenação lógica, elimina ambiguidades e proporciona reconhecimento internacional.

O que fazer a seguir

Seu fluxo de trabalho agêntico foi criado. Você pode usar a visualização do Chat para testar seu fluxo de trabalho autêntico.

• Adicionar atividades do usuário

Uma atividade de usuário consiste em uma ou mais interações baseadas em bate-papo para coletar entradas e exibir resultados em um fluxo de trabalho agêntico.

• Adicionando blocos lógicos

Um bloco lógico adiciona lógica personalizada como uma lógi Python e dentro do seu fluxo de trabalho de agente.

• Adicionando prompts generativos

Um prompt generativo usa os recursos de modelos de linguagem grandes (LLMs) para tarefas.

• Adicionar classificadores de documentos

Um classificador de documentos identifica automaticamente os tipos de documentos.

• Adicionar extratores de documentos

Um extrator de documentos obtém campos e entidades de documentos.

• Adicionar extratores de texto

Um extrator de texto obtém o texto de um documento.