Módulos do Adobe CX Enterprise Coworker

Use o conector do Adobe CX Enterprise Coworker no Adobe Workfront Fusion para enviar um prompt em linguagem natural ao Co-worker e usar sua resposta em um cenário. O colega interpreta a sua solicitação e pode usar as ferramentas disponíveis na sua conta para realizar o trabalho.

O conector fornece dois módulos:

  • Executar um Prompt inicia uma nova solicitação e, por padrão, aguarda o resultado.
  • Obter Status de Execução verifica uma solicitação iniciada anteriormente.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso da funcionalidade neste artigo.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront

Qualquer pacote de fluxo de trabalho do Adobe Workfront e qualquer pacote do Adobe Workfront Automation and Integration

Workfront Ultimate

Os pacotes Workfront Prime e Select, com uma compra adicional do Workfront Fusion.

Licenças do Adobe Workfront

Padrão

Trabalho ou maior

Produto Se sua organização tiver um pacote Workfront Select ou Prime, ele não inclui o Workfront Automation and Integration. É necessário comprar o Adobe Workfront Fusion.

Para obter mais detalhes sobre as informações contidas nesta tabela, consulte Requisitos de acesso na documentação.

Pré-requisitos

Você deve ter uma conta do Adobe com acesso ao Adobe CX Enterprise Coworker.

Conectar o Adobe CX Enterprise Coworker ao Workfront Fusion

Entre com uma conta da Adobe que tenha acesso ao Colaborador e a todos os serviços necessários para a sua solicitação.

Para criar uma conexão:

  1. No módulo MCP do Adobe Fusion, clique em Adicionar ao lado do campo Conexão.

  2. Preencha os seguintes campos:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
    Nome da conexão Insira um nome para essa conexão.
    Ambiente Selecione se você está se conectando a um ambiente de produção ou não produção.
    Tipo Selecione se você está se conectando a uma conta de serviço ou a uma conta pessoal.
    ID do cliente Insira ou mapeie uma substituição opcional para esta conexão. Caso contrário, use a clientId gerenciada pela plataforma desse tipo de conta. Registre o URL de retorno de chamada do Fusion exibido para a conta de Colaborador dedicada.
    Segredo do cliente Insira ou mapeie uma substituição opcional para esta conexão. Caso contrário, use o clientSecret gerenciado por plataforma desse tipo de conta. Use credenciais emitidas para o ambiente IMS configurado.
  3. Clique em Continuar.

Se não conseguir fazer logon ou usar um serviço necessário, entre em contato com o administrador.

Módulos do Adobe CX Enterprise Coworker e seus campos

WARNING
Nunca inclua senhas ou outras credenciais em um prompt.

Obter Status de Execução

Este módulo de ação verifica o estado atual de uma tarefa iniciada por Executar um prompt.

Este módulo verifica a tarefa uma vez. Ela não inicia uma nova tarefa ou continua verificando até que a tarefa seja concluída. Se o resultado ainda estiver pendente, verifique novamente mais tarde.

NOTE
Não converta a ID da tarefa em um número, arredonde-a ou reformate-a. Se o Colaborador responder ao prompt original imediatamente sem uma ID de tarefa, não será necessário verificar o status.
Incluir resultado bruto (Opcional, avançado)
Essa opção está desativada por padrão. Inclua a resposta completa do colaborador na saída. A resposta pode conter informações confidenciais.
Connection
Selecione a mesma conexão usada na execução original Executar um Prompt.
ID de Tarefa
Mapeie a ID de Tarefa retornada por Executar um Prompt. Manter como texto exatamente como retornado.

Executar um prompt

Esse módulo de ação envia uma instrução ao Colaborador, como o resumo de texto ou a coleta de informações usando as ferramentas disponíveis para sua conta.

Cada execução envia o prompt uma vez e inicia uma nova conversa. Não é necessário selecionar um modelo de IA ou fornecer uma chave separada do provedor de IA.

Connection
Selecione sua conexão com o Colaborador. Para obter instruções, consulte Conectar o Adobe CX Enterprise Coworker ao Workfront Fusion neste artigo.
Prompt de usuário
Digite sua instrução. Você pode usar várias linhas e mapear informações de módulos anteriores.
Aguardar conclusão (Opcional, avançado)

Essa opção está ativada por padrão. Ative essa opção se desejar que o módulo aguarde a conclusão da tarefa ou exigir atenção. Desative para retornar o resultado inicial imediatamente.

Para obter mais informações, consulte Aguardar a conclusão neste artigo.

Incluir resultado bruto (Opcional, avançado)
Essa opção está desativada por padrão. Ative essa opção se desejar que o módulo inclua a resposta completa do colaborador na saída. A resposta pode conter informações confidenciais.
NOTE
Recomendamos deixar Incluir resultado bruto desativado, a menos que você precise da resposta completa para uma finalidade específica. Os resultados brutos podem conter informações confidenciais e não são um registro completo garantido de cada ação. Analise o que um resultado bruto contém antes de salvá-lo, compartilhá-lo ou passá-lo para outro serviço.

Aguardar a conclusão

Quando Aguardar a conclusão está ativado, o módulo verifica a tarefa após uma espera de cinco segundos. Se a tarefa ainda estiver pendente, o módulo aguardará mais cinco segundos antes de verificar novamente. Cada verificação também leva tempo para receber uma resposta. A verificação de status não envia o prompt novamente.

A espera para quando a tarefa é concluída, falha, é cancelada ou rejeitada ou precisa da sua entrada ou autorização. Se o Colaborador fornecer uma resposta imediata, o módulo a retornará sem outras verificações.

Quando Aguardar a conclusão estiver desativado, o módulo retornará o primeiro resultado sem esperar a conclusão da tarefa. Inspecionar Estado, Concluído e Requer atenção para decidir o que fazer em seguida. Uma tarefa já pode ser concluída quando o primeiro resultado chegar.

A espera está sujeita ao tempo limite do módulo do Fusion. Se o módulo atingir o tempo limite ou parar, o Colaborador pode continuar trabalhando. Nesse caso, talvez você não receba uma saída ou uma ID de tarefa.

Para trabalho mais demorado, desative a espera e salve a ID da Tarefa inicial para poder verificar a tarefa mais tarde. Não executar automaticamente o prompt novamente após um tempo limite. A primeira solicitação pode já estar em andamento e repeti-la pode duplicar as alterações.

Saída do módulo

Ambos os módulos retornam as seguintes informações quando terminam sem erros.

ID de Tarefa
Identifica a tarefa. Isso fica vazio quando o Colaborador fornece uma resposta imediata sem criar uma tarefa. Use este valor com Obter Status de Execução.
ID de Contexto

Identifica a conversa. Não é uma entrada para continuar a conversa.

Para obter mais informações, consulte Usar respostas anteriores neste artigo.

State
O estado atual da tarefa. Consulte Estados da tarefa neste artigo.
Concluído
Verdadeiro quando a tarefa é concluída ou o Colaborador fornece uma resposta imediata.
Requer atenção

Verdadeiro quando o Colaborador precisa de entrada ou autorização.

Para obter mais informações, consulte Solicitações que precisam de atenção neste artigo.

Texto do assistente final
A resposta final quando a tarefa for concluída. Está vazio enquanto a tarefa está pendente ou requer atenção. Uma resposta concluída também não pode ter texto de resposta.
Artefatos de texto (podem incluir texto intermediário)
Texto retornado durante o trabalho. Cada item pode incluir uma ID de artefato, um Nome e um Texto. Esses itens não são necessariamente respostas finais.
Resultado bruto (aceitação)
A resposta completa. Isso é incluído somente quando Incluir resultado bruto está ativado.

Use Texto do assistente final para a resposta em vez de combinar todos os artefatos de texto. Os artefatos podem incluir descrições de progresso ou outro texto intermediário.

Solicitações que precisam de atenção

O colaborador pode precisar de mais informações ou autorização antes de continuar. Quando isso ocorrer, Requer atenção é verdadeiro e Concluído é falso. Direcionar o resultado para uma pessoa em vez de tratá-lo como trabalho concluído.

Esses módulos não podem responder a uma pergunta de acompanhamento ou aprovar uma ação em seu nome. Obter Status de Execução pode verificar se o estado da tarefa foi alterado, mas não resolve a solicitação de entrada ou autorização.

Usar respostas anteriores

A cada Executar um Prompt, a execução inicia uma nova conversa. Para consultar uma resposta anterior, inclua a pergunta e a resposta relevantes como texto no novo prompt. Isso fornece o contexto do Colaborador, mas não retoma a conversa anterior.

A ID de Contexto identifica a conversa associada ao resultado. Você não pode fornecê-lo a esses módulos para continuar uma conversa.

IMPORTANT
Concluído não garante que a ação comercial solicitada foi bem-sucedida. Por exemplo, o Colaborador pode terminar explicando que uma ferramenta necessária não estava disponível. Revise a resposta e verifique qualquer resultado necessário antes de executar a próxima ação.

Estados da tarefa

submitted, working
A tarefa está pendente. Concluído é falso. Executar um Prompt continua aguardando quando a espera está ativada. Caso contrário, salve a ID da tarefa e verifique mais tarde.
completed
Concluído é verdadeiro. Revise Texto do assistente final e o resultado esperado.
input-required, auth-required
A tarefa precisa de atenção. Concluído é falso e Requer atenção é verdadeiro. A espera para. Direcionar o resultado para análise humana.
failed, canceled, rejected
O módulo relata um erro em vez de um resultado normal.

Um resultado pendente ou que requer atenção não é uma conclusão bem-sucedida, mesmo que o módulo retorne sem erro.

Exemplos

Resumir uma atualização

  1. Adicione Executar um Prompt e selecione sua conexão.

  2. Digite o seguinte no campo Prompt do usuário:

    code language-text
    Summarize the following project update in three bullet points.
    Use only the supplied text; do not call tools or change any records.
    
    The planning workshop is complete. Two dependencies need confirmation.
    The team will review the delivery estimate on Friday.
    
  3. Deixe Aguardar conclusão ativado e Incluir resultado bruto desativado.

  4. Se Requer atenção for verdadeiro, encaminhe o resultado para revisão humana. Se Concluído for verdadeiro, mapeie Texto do assistente final para a próxima etapa.

A redação gerada por IA pode variar. Analise os resultados onde a precisão é importante.

Verificar uma tarefa mais longa mais tarde

  1. Adicione Executar um Prompt, selecione sua conexão e insira sua instrução.

  2. Desative Aguardar a conclusão.

  3. Inspecione o resultado inicial.

    • Se a tarefa estiver concluída, processe o resultado.
    • Se a tarefa exigir atenção, encaminhe o resultado para revisão.
    • Se a tarefa estiver pendente, salve a ID da Tarefa como texto e anote qual conexão você usou.
  4. Mais tarde, use Obter Status de Execução com essa conexão e essa ID de Tarefa.

  5. Se a tarefa ainda estiver pendente, organize outra verificação dentro dos limites do seu cenário. Processe o resultado uma vez ao concluir e trate a atenção ou os erros separadamente.

Não execute o prompt original novamente apenas para verificar seu progresso.

Considerações de uso

  • O colega de trabalho pode usar as ferramentas e executar ações permitidas pela sua conta, incluindo alterações nos registros. Use prompts confiáveis e uma conta com acesso apropriado.
  • Esses módulos não fornecem uma maneira de restringir ferramentas individuais. Instruções como “não altere nada” descrevem sua intenção, mas não são um modo obrigatório somente leitura.
  • As ferramentas e habilidades disponíveis variam de acordo com a conta. O conector não fornece um seletor de habilidades ou garante uma ação específica, como criar uma jornada ou atualizar um projeto. Não presuma que as solicitações que precisam de aprovação serão concluídas de forma autônoma.
  • O conector é iniciado e verifica as solicitações do Colaborador. Ele não monitora alterações em projetos nem salva respostas automaticamente em outro aplicativo. Adicione os módulos de acionamento, armazenamento e acompanhamento apropriados ao seu cenário, conforme necessário.
  • As respostas geradas por IA podem estar incompletas ou imprecisas. Valide resultados importantes antes de usá-los para fazer alterações ou tomar decisões.
  • O conector não repete automaticamente uma solicitação com falha. Certifique-se de que o tratamento de erros do seu cenário não repita um prompt cujo resultado seja incerto.

Solução de problemas

Um campo obrigatório está ausente
Selecione uma conexão e insira o prompt ou a ID da tarefa necessário.
Falha de entrada ou acesso negado
Faça logon novamente e verifique se sua conta da Adobe tem acesso ao Colaborador e aos serviços necessários. Entre em contato com o administrador, se necessário.
Tarefa não encontrada
Verifique se a ID da tarefa não foi alterada e se você está usando a conexão original. Uma nova tarefa pode não estar visível imediatamente. Verifique o status posteriormente em vez de enviar o prompt novamente.
Uma verificação de status falha
Se o erro incluir a ID de Tarefa aceita, use Obter Status de Execução para investigar essa tarefa. Não reinicie o prompt automaticamente.
Executar um prompt atinge o tempo limite ou perde a resposta
A tarefa pode ter sido iniciada mesmo se você não tiver recebido a ID dela. Investigue antes de repetir a solicitação para evitar trabalho duplicado.
A fusão expira enquanto aguarda
O colega de trabalho ainda pode estar trabalhando. Verifique a tarefa se tiver sua ID. Para tarefas longas futuras, desative a espera e salve a ID inicial primeiro.
Colaborador ou um serviço necessário não está disponível
Compartilhe o erro exibido com o administrador, sem credenciais ou conteúdo de resultado confidencial.
recommendation-more-help
workfront-fusion-help-workfront-fusion