適用於 Azure Functions 的 Azure OpenAI 助理觸發程序

目前這款綁定沒有 Go 支援。

此範例示範如何建立助理，將新的待辦工作新增至資料庫。 觸發程序具有模型所使用的 Create a new todo task 靜態描述。 函式本身會採用字串，表示要加入的新工作。 執行時，函式會將工作新增為自訂項目存放區中的新待辦事項項目，並從存放區傳回回應。

[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));
}

此範例示範如何建立助理，將新的待辦工作新增至資料庫。 觸發程序具有模型所使用的 Create a new todo task 靜態描述。 函式本身會採用字串，表示要加入的新工作。 執行時，函式會將工作新增為自訂項目存放區中的新待辦事項項目，並從存放區傳回回應。

/**
 * 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);
}

此範例示範如何建立助理，將新的待辦工作新增至資料庫。 觸發程序具有模型所使用的 Create a new todo task 靜態描述。 函式本身會採用字串，表示要加入的新工作。 執行時，函式會將工作新增為自訂項目存放區中的新待辦事項項目，並從存放區傳回回應。

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))
    }
})

此範例示範如何建立助理，將新的待辦工作新增至資料庫。 觸發程序具有模型所使用的 Create a new todo task 靜態描述。 函式本身會採用字串，表示要加入的新工作。 執行時，函式會將工作新增為自訂項目存放區中的新待辦事項項目，並從存放區傳回回應。

以下是 新增 Todo 的 function.json檔案：

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

如需 function.json 檔案屬性的詳細資訊，請參閱設定一節。

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

此範例示範如何建立助理，將新的待辦工作新增至資料庫。 觸發程序具有模型所使用的 Create a new todo task 靜態描述。 函式本身會採用字串，表示要加入的新工作。 執行時，函式會將工作新增為自訂項目存放區中的新待辦事項項目，並從存放區傳回回應。

@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

屬性

套用 AssistantSkillTrigger 屬性來定義助理觸發程序，其支援下列參數：

註釋

AssistantSkillTrigger 註釋可讓您定義助理觸發程序，其支援下列參數：

裝飾項目

在預覽期間，將輸入繫結定義為 generic_trigger 類型的 assistantSkillTrigger 繫結，其支援下列參數：

組態

繫結支援您在 function.json 檔案中設定的下列組態屬性。

組態

繫結支援您在程式碼中定義的下列屬性：