Gatilho do assistente do OpenAI do Azure para Azure Functions

Importante

Atualmente, a extensão do OpenAI do Azure para Azure Functions está em versão prévia.

O gatilho do assistente do OpenAI do Azure permite que você execute seu código com base na solicitação de habilidade ou de chatbot personalizado feita a um assistente.

Para obter informações sobre os detalhes de configuração da extensão do OpenAI do Azure, confira Extensões do OpenAI do Azure para Azure Functions. Para saber mais sobre os assistentes do OpenAI do Azure, consulte API de Assistentes do OpenAI do Azure.

Observação

Referências e exemplos só são fornecidos para o modelo do Node.js v4.

Observação

Referências e exemplos só são fornecidos para o modelo do Python v2.

Observação

Embora haja suporte para ambos os modelos de processo C#, apenas exemplos de modelo de trabalho isolados são fornecidos.

Exemplo

O suporte do Go não está disponível para essa ligação no momento.

Este exemplo demonstra como criar um assistente que adiciona uma nova tarefa pendente a um banco de dados. O gatilho tem uma descrição estática de Create a new todo task usada pelo modelo. A função em si usa uma cadeia de caracteres, que representa uma nova tarefa a ser adicionada. Quando executada, a função adiciona a tarefa como um novo item pendente em um repositório de itens personalizado e retorna uma resposta do repositório.

Este exemplo demonstra como criar um assistente que adiciona uma nova tarefa pendente a um banco de dados. O gatilho tem uma descrição estática de Create a new todo task usada pelo modelo. A função em si usa uma cadeia de caracteres, que representa uma nova tarefa a ser adicionada. Quando executada, a função adiciona a tarefa como um novo item pendente em um repositório de itens personalizado e retorna uma resposta do repositório.

Este exemplo demonstra como criar um assistente que adiciona uma nova tarefa pendente a um banco de dados. O gatilho tem uma descrição estática de Create a new todo task usada pelo modelo. A função em si usa uma cadeia de caracteres, que representa uma nova tarefa a ser adicionada. Quando executada, a função adiciona a tarefa como um novo item pendente em um repositório de itens personalizado e retorna uma resposta do repositório.

Este exemplo demonstra como criar um assistente que adiciona uma nova tarefa pendente a um banco de dados. O gatilho tem uma descrição estática de Create a new todo task usada pelo modelo. A função em si usa uma cadeia de caracteres, que representa uma nova tarefa a ser adicionada. Quando executada, a função adiciona a tarefa como um novo item pendente em um repositório de itens personalizado e retorna uma resposta do repositório.

Aqui está o arquivo function.json para Adicionar Todo:

Para obter mais informações sobre as propriedades do arquivo function.json, consulte a seção Configuração.

Este exemplo demonstra como criar um assistente que adiciona uma nova tarefa pendente a um banco de dados. O gatilho tem uma descrição estática de Create a new todo task usada pelo modelo. A função em si usa uma cadeia de caracteres, que representa uma nova tarefa a ser adicionada. Quando executada, a função adiciona a tarefa como um novo item pendente em um repositório de itens personalizado e retorna uma resposta do repositório.

Atributos

Aplique o atributo AssistantSkillTrigger para definir um gatilho de assistente, que dá suporte a estes parâmetros:

Parâmetro Descrição
FunctionDescription Obtém a descrição da função de assistente, que é fornecida para o modelo.
FunctionName Opcional. Obtém ou define o nome da função chamada pelo assistente.
ParameterDescriptionJson Opcional. Obtém ou define uma descrição JSON do parâmetro de função, que é fornecido para o modelo. Para obter mais informações, confira Uso.

Anotações

A anotação AssistantSkillTrigger permite que você defina um gatilho de assistente, que dá suporte a estes parâmetros:

Elemento Descrição
nome Obtém ou define o nome da associação de entrada.
functionDescription Obtém a descrição da função de assistente, que é fornecida para o modelo.
functionName Opcional. Obtém ou define o nome da função chamada pelo assistente.
parameterDescriptionJson Opcional. Obtém ou define uma descrição JSON do parâmetro de função, que é fornecido para o modelo. Para obter mais informações, confira Uso.

Decoradores

Durante a versão prévia, defina a associação de entrada como uma associação generic_trigger do tipo assistantSkillTrigger, que dá suporte a estes parâmetros:

Parâmetro Descrição
function_description Obtém a descrição da função de assistente, que é fornecida para o modelo.
function_name Opcional. Obtém ou define o nome de uma função chamada pelo assistente.
parameterDescriptionJson Opcional. Obtém ou define uma descrição JSON do parâmetro de função, que é fornecido para o modelo. Para obter mais informações, confira Uso.

Configuração

A associação dá suporte a essas propriedades de configuração definidas no arquivo function.json.

Propriedade Descrição
tipo Deve ser AssistantSkillTrigger.
direção Deve ser in.
nome O nome do gatilho.
functionName Obtém ou define o nome da função chamada pelo assistente.
functionDescription Obtém a descrição da função de assistente, que é fornecida para o modelo de idioma.
parameterDescriptionJson Opcional. Obtém ou define uma descrição JSON do parâmetro de função, que é fornecido para o modelo. Para obter mais informações, confira Uso.

Configuração

A associação dá suporte a estas propriedades, que são definidas no código:

Propriedade Descrição
tipo Deve ser AssistantSkillTrigger.
nome O nome do gatilho.
functionName Obtém ou define o nome da função chamada pelo assistente.
functionDescription Obtém a descrição da função de assistente, que é fornecida para o LLM
parameterDescriptionJson Opcional. Obtém ou define uma descrição JSON do parâmetro de função, que é fornecido para o modelo. Para obter mais informações, confira Uso.

Consulte a Seção de exemplo para obter exemplos completos.

Uso

Quando o valor JSON parameterDescriptionJson não é fornecido, ele é gerado automaticamente. Para mais informações sobre a sintaxe desse objeto, veja a documentação de chamadas de funções do OpenAI.

Conteúdo relacionado

  • Last updated on