Desencadenador del asistente de Azure OpenAI para Azure Functions

El soporte de Go no está disponible actualmente para esta asignación.

En este ejemplo se muestra cómo crear un asistente que agrega una nueva tarea de tareas pendientes a una base de datos. El desencadenador tiene una descripción estática de Create a new todo task que usa el modelo. La propia función toma una cadena, que representa una nueva tarea que se va a agregar. Cuando se ejecuta, la función agrega la tarea como un nuevo elemento de tareas pendientes en un almacén de elementos personalizado y devuelve una respuesta del almacén.

[Function(nameof(AddTodo))]
public Task AddTodo([AssistantSkillTrigger("Create a new todo task")] string taskDescription)
{
    if (string.IsNullOrEmpty(taskDescription))
    {
        throw new ArgumentException("Task description cannot be empty");
    }

    this.logger.LogInformation("Adding todo: {task}", taskDescription);

    string todoId = Guid.NewGuid().ToString()[..6];
    return this.todoManager.AddTodoAsync(new TodoItem(todoId, taskDescription));
}

En este ejemplo se muestra cómo crear un asistente que agrega una nueva tarea de tareas pendientes a una base de datos. El desencadenador tiene una descripción estática de Create a new todo task que usa el modelo. La propia función toma una cadena, que representa una nueva tarea que se va a agregar. Cuando se ejecuta, la función agrega la tarea como un nuevo elemento de tareas pendientes en un almacén de elementos personalizado y devuelve una respuesta del almacén.

/**
 * Called by the assistant to create new todo tasks.
 */
@FunctionName("AddTodo")
public void addTodo(
    @AssistantSkillTrigger(
            name = "assistantSkillCreateTodo",
            functionDescription = "Create a new todo task"
    ) String taskDescription,
    final ExecutionContext context) {

    if (taskDescription == null || taskDescription.isEmpty()) {
        throw new IllegalArgumentException("Task description cannot be empty");
    }
    context.getLogger().info("Adding todo: " + taskDescription);

    String todoId = UUID.randomUUID().toString().substring(0, 6);
    TodoItem todoItem = new TodoItem(todoId, taskDescription);
    todoManager.addTodo(todoItem);
}

En este ejemplo se muestra cómo crear un asistente que agrega una nueva tarea de tareas pendientes a una base de datos. El desencadenador tiene una descripción estática de Create a new todo task que usa el modelo. La propia función toma una cadena, que representa una nueva tarea que se va a agregar. Cuando se ejecuta, la función agrega la tarea como un nuevo elemento de tareas pendientes en un almacén de elementos personalizado y devuelve una respuesta del almacén.

const { app, trigger } = require("@azure/functions");
const { TodoItem, CreateTodoManager } = require("../services/todoManager");
const { randomUUID } = require('crypto');

const todoManager = CreateTodoManager()

app.generic('AddTodo', {
    trigger: trigger.generic({
        type: 'assistantSkillTrigger',
        functionDescription: 'Create a new todo task'
    }),
    handler: async (taskDescription, context) => {
        if (!taskDescription) {
            throw new Error('Task description cannot be empty')
        }

        context.log(`Adding todo: ${taskDescription}`)

        const todoId = randomUUID().substring(0, 6)
        return todoManager.AddTodo(new TodoItem(todoId, taskDescription))
    }
})

import { InvocationContext, app, trigger } from "@azure/functions"
import { TodoItem, ITodoManager, CreateTodoManager } from "../services/todoManager"
import { randomUUID } from 'crypto';

const todoManager: ITodoManager = CreateTodoManager()

app.generic('AddTodo', {
    trigger: trigger.generic({
        type: 'assistantSkillTrigger',
        functionDescription: 'Create a new todo task'
    }),
    handler: async (taskDescription: string, context: InvocationContext) => {
        if (!taskDescription) {
            throw new Error('Task description cannot be empty')
        }

        context.log(`Adding todo: ${taskDescription}`)

        const todoId = randomUUID().substring(0, 6)
        return todoManager.AddTodo(new TodoItem(todoId, taskDescription))
    }
})

En este ejemplo se muestra cómo crear un asistente que agrega una nueva tarea de tareas pendientes a una base de datos. El desencadenador tiene una descripción estática de Create a new todo task que usa el modelo. La propia función toma una cadena, que representa una nueva tarea que se va a agregar. Cuando se ejecuta, la función agrega la tarea como un nuevo elemento de tareas pendientes en un almacén de elementos personalizado y devuelve una respuesta del almacén.

Este es el archivo function.json para Agregar tareas pendientes:

{
  "bindings": [
    {
      "name": "TaskDescription",
      "type": "assistantSkillTrigger",
      "dataType": "string",
      "direction": "in",
      "functionDescription": "Create a new todo task"
    }
  ]
}

Para obtener más información sobre las propiedades del archivo function.json, consulte la sección de Configuración.

using namespace System.Net

param($TaskDescription, $TriggerMetadata)
$ErrorActionPreference = "Stop"

if (-not $TaskDescription) {
    throw "Task description cannot be empty"
}

Write-Information "Adding todo: $TaskDescription"
$todoID = [Guid]::NewGuid().ToString().Substring(0, 5)
Add-Todo $todoId $TaskDescription

En este ejemplo se muestra cómo crear un asistente que agrega una nueva tarea de tareas pendientes a una base de datos. El desencadenador tiene una descripción estática de Create a new todo task que usa el modelo. La propia función toma una cadena, que representa una nueva tarea que se va a agregar. Cuando se ejecuta, la función agrega la tarea como un nuevo elemento de tareas pendientes en un almacén de elementos personalizado y devuelve una respuesta del almacén.

@skills.function_name("AddTodo")
@skills.assistant_skill_trigger(
    arg_name="taskDescription", function_description="Create a new todo task"
)
def add_todo(taskDescription: str) -> None:
    if not taskDescription:
        raise ValueError("Task description cannot be empty")

    logging.info(f"Adding todo: {taskDescription}")

    todo_id = str(uuid.uuid4())[0:6]
    todo_manager.add_todo(TodoItem(id=todo_id, task=taskDescription))
    return

Atributos

Aplique el atributo AssistantSkillTrigger para definir un desencadenador del asistente, que admite estos parámetros:

anotaciones

La anotación AssistantSkillTrigger permite definir un desencadenador del asistente, que admite estos parámetros:

Elementos Decorator

Durante la versión preliminar, defina el enlace de entrada como un enlace generic_trigger de tipo assistantSkillTrigger, que admite estos parámetros:

Configuración

El enlace admite estas propiedades de configuración que se establecen en el archivo function.json.

Configuración

El enlace admite estas propiedades, que se definen en el código: