Ir para o conteúdo

Atividade de Prompt do OpenAI

Introdução

Uma atividade de Prompt do OpenAI, utilizando sua conexão OpenAI, cria uma conclusão de texto para o prompt fornecido no OpenAI e é destinada a ser usada como um alvo para consumir dados em uma operação.

Importante

Para gerenciar o histórico de chat, você deve estar usando um agente privado para manter o contexto da conversa entre as chamadas da API.

Modelos OpenAI suportados

Esta atividade pode ser configurada para usar um destes modelos do OpenAI:

Criar uma atividade de Prompt do OpenAI

Uma instância de uma atividade de Prompt do OpenAI é criada a partir de uma conexão OpenAI usando seu tipo de atividade Prompt.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade de Prompt do OpenAI existente pode ser editada a partir destes locais:

Configurar uma atividade de Prompt do OpenAI

Siga estas etapas para configurar uma atividade de Prompt do OpenAI:

Etapa 1: Insira um nome e especifique as configurações

Nesta etapa, forneça um nome para a atividade e especifique o texto do prompt e configurações opcionais. Cada elemento da interface do usuário desta etapa é descrito abaixo.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade de Prompt do OpenAI e não deve conter barras / ou dois pontos :.

  • Texto do prompt: Insira o prompt a ser utilizado para as conclusões.

  • Modelo: Use o menu para selecionar um modelo suportado do OpenAI.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais:

    • Função: Selecione a função do prompt, que pode ser Assistente, Sistema ou Usuário:

      • Assistente: Um assistente (o modelo) responde ao prompt do usuário. Um prompt de assistente armazena respostas anteriores do assistente ou pode ser escrito por você para dar exemplos de comportamento desejado. Este é um exemplo de um prompt de assistente:
            `Você tem um conhecimento extenso do francês do século XVI.`

        -   **Sistema:** Um prompt de sistema define o comportamento do assistente. Você pode modificar a personalidade do assistente ou fornecer instruções específicas sobre como ele deve se comportar. Este é um exemplo de um prompt de sistema:

            `Quando eu pedir ajuda para escrever algo, você responderá com um documento que contém pelo menos uma piada ou comentário brincalhão em cada parágrafo.`

        -   **Ferramenta:** Um prompt de ferramenta é o que um assistente de chatbot usa para solicitar ao OpenAI que utilize uma [ferramenta](https://platform.openai.com/docs/guides/agents#tools) que foi registrada usando a [atividade de Registro de Ferramentas](/pt/integration-studio/design/connectors/openai/register-tools-activity/). Este é um exemplo de um prompt de ferramenta:

            `Use a ferramenta Conversor e me diga quanto valem 200 dólares na moeda brasileira.`

        -   **Usuário:** Um prompt de usuário é um pedido ao assistente. Este é um exemplo de um prompt de usuário:

            `Escreva uma lista em Markdown de raças de gatos e uma característica de personalidade para cada raça.`

    -   **Temperatura:** Insira a [temperatura](https://platform.openai.com/docs/api-reference/completions/create#completionscreate-temperature) de amostragem. O valor deve ser um decimal entre `0` e `2`. Não é recomendável usar esta configuração com **Probabilidade Máxima**.

    -   **Máximo de Tokens:** Insira o número máximo de [tokens](https://platform.openai.com/tokenizer) a serem usados.

    -   **Probabilidade Máxima:** Insira a [probabilidade máxima](https://platform.openai.com/docs/api-reference/completions/create#completions/create-top_p). Não é recomendável usar esta configuração com **Temperatura**.

-   **Continuar em Caso de Erro:** Selecione para continuar a execução da atividade se um erro for encontrado para um conjunto de dados em uma solicitação em lote. Se algum erro for encontrado, ele será registrado no [log de operações](/pt/integration-studio/design/operations/logs/).

-   **Salvar e Sair:** Se ativado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

Quaisquer esquemas de solicitação ou resposta são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.

  • Esquemas de Dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.

    Nota

    Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.

    O conector OpenAI utiliza a API OpenAI. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

  • Atualizar: Clique no ícone de atualizar ou na palavra Atualizar para regenerar esquemas do endpoint OpenAI. Esta ação também regenera um esquema em outros locais ao longo do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração para todas as etapas e fechar a configuração da atividade.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade Prompt do OpenAI, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.

As ações de menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, veja o menu de ações da atividade em Noções básicas sobre conectores.

As atividades de Prompt do OpenAI podem ser usadas como um alvo com esses padrões de operação:

Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.