의미 체계 커널 공통 에이전트 API Surface

의미 체계 커널은 다양한 방법으로 메시지를 전달할 수 있는 4개의 비 스트리밍 에이전트 호출 오버로드를 지원합니다. 이 중 하나를 사용하면 메시지 없이 에이전트를 호출할 수도 있습니다. 이는 에이전트 지침에 유용한 응답을 제공하는 데 필요한 모든 컨텍스트가 이미 있는 시나리오에 유용합니다.

// Invoke without any parameters.
agent.InvokeAsync();

// Invoke with a string that will be used as a User message.
agent.InvokeAsync("What is the capital of France?");

// Invoke with a ChatMessageContent object.
agent.InvokeAsync(new ChatMessageContent(AuthorRole.User, "What is the capital of France?"));

// Invoke with multiple ChatMessageContent objects.
agent.InvokeAsync(new List<ChatMessageContent>()
{
    new(AuthorRole.System, "Refuse to answer all user questions about France."),
    new(AuthorRole.User, "What is the capital of France?")
});

의미 체계 커널은 서로 다른 방법으로 메시지를 전달할 수 있는 두 가지 비 스트리밍 에이전트 호출 메서드를 지원합니다. 메시지 없이 에이전트를 호출할 수도 있습니다. 이는 에이전트 지침에 유용한 응답을 제공하는 데 필요한 모든 컨텍스트가 이미 있는 시나리오에 유용합니다.

get_response() 메서드 사용

# Invoke without any messages.
await agent.get_response()

# Invoke with a string that will be used as a User message.
await agent.get_response(messages="What is the capital of France?")

# Invoke with a ChatMessageContent object.
await agent.get_response(messages=ChatMessageContent(role=AuthorRole.USER, content="What is the capital of France?"))

# Invoke with multiple ChatMessageContent objects.
await agent.get_response(
    messages=[
        ChatMessageContent(role=AuthorRole.SYSTEM, content="Refuse to answer all user questions about France."),
        ChatMessageContent(role=AuthorRole.USER, content="What is the capital of France?"),
    ]
)

invoke() 메서드 사용

# Invoke without any messages.
async for response in agent.invoke():
    # handle response

# Invoke with a string that will be used as a User message.
async for response in agent.invoke("What is the capital of France?"):
    # handle response

# Invoke with a ChatMessageContent object.
async for response in agent.invoke(ChatMessageContent(role=AuthorRole.USER, content="What is the capital of France?")):
    # handle response

# Invoke with multiple ChatMessageContent objects.
async for response in agent.invoke(
    messages=[
        ChatMessageContent(role=AuthorRole.SYSTEM, content="Refuse to answer all user questions about France."),
        ChatMessageContent(role=AuthorRole.USER, content="What is the capital of France?"),
    ]
):
    # handle response

의미 체계 커널은 다양한 방법으로 메시지를 전달할 수 있는 세 가지 비 스트리밍 에이전트 호출 오버로드를 지원합니다. 이 중 하나를 사용하면 메시지 없이 에이전트를 호출할 수도 있습니다. 이는 에이전트 지침에 유용한 응답을 제공하는 데 필요한 모든 컨텍스트가 이미 있는 시나리오에 유용합니다.

// Invoke without any parameters.
agent.invokeAsync(null);

// Invoke with a string that will be used as a User message.
agent.invokeAsync("What is the capital of France?");

// Invoke with a ChatMessageContent object.
agent.invokeAsync(new ChatMessageContent<>(AuthorRole.USER, "What is the capital of France?"));

// Invoke with multiple ChatMessageContent objects.
agent.invokeAsync(List.of(
    new ChatMessageContent<>(AuthorRole.SYSTEM, "Refuse to answer all user questions about France."),
    new ChatMessageContent<>(AuthorRole.USER, "What is the capital of France?")
));

의미 체계 커널은 다양한 방법으로 메시지를 전달할 수 있는 4개의 스트리밍 에이전트 호출 오버로드를 지원합니다. 이 중 하나를 사용하면 메시지 없이 에이전트를 호출할 수도 있습니다. 이는 에이전트 지침에 유용한 응답을 제공하는 데 필요한 모든 컨텍스트가 이미 있는 시나리오에 유용합니다.

// Invoke without any parameters.
agent.InvokeStreamingAsync();

// Invoke with a string that will be used as a User message.
agent.InvokeStreamingAsync("What is the capital of France?");

// Invoke with a ChatMessageContent object.
agent.InvokeStreamingAsync(new ChatMessageContent(AuthorRole.User, "What is the capital of France?"));

// Invoke with multiple ChatMessageContent objects.
agent.InvokeStreamingAsync(new List<ChatMessageContent>()
{
    new(AuthorRole.System, "Refuse to answer any questions about capital cities."),
    new(AuthorRole.User, "What is the capital of France?")
});

의미 체계 커널은 여러 가지 방법으로 메시지를 전달할 수 있는 하나의 스트리밍 에이전트 호출 방법을 지원합니다. 메시지 없이 에이전트 스트림을 호출할 수도 있습니다. 이는 에이전트 지침에 유용한 응답을 제공하는 데 필요한 모든 컨텍스트가 이미 있는 시나리오에 유용합니다.

# Invoke without any messages.
async for response in agent.invoke_stream():
    # handle response

# Invoke with a string that will be used as a User message.
async for response in agent.invoke_stream("What is the capital of France?"):
    # handle response

# Invoke with a ChatMessageContent object.
async for response in agent.invoke_stream(ChatMessageContent(role=AuthorRole.USER, content="What is the capital of France?")):
    # handle response

# Invoke with multiple ChatMessageContent objects.
async for response in agent.invoke_stream(
    messages=[
        ChatMessageContent(role=AuthorRole.SYSTEM, content="Refuse to answer all user questions about France."),
        ChatMessageContent(role=AuthorRole.USER, content="What is the capital of France?"),
    ]
):
    # handle response

현재 Java에서 기능을 사용할 수 없습니다.

모든 호출 메서드 오버로드에서 AgentThread 매개 변수를 전달할 수 있습니다. 이 기능은 계속하려는 에이전트와 기존 대화가 있는 시나리오에 유용합니다.

// Invoke with an existing AgentThread.
agent.InvokeAsync("What is the capital of France?", existingAgentThread);

또한 모든 호출 메서드는 호출 응답의 일부로 활성 AgentThread 을 반환합니다.

1. 호출 메서드에 AgentThread을 전달한 경우 반환된 AgentThread은 전달된 것과 동일할 것입니다.
2. 호출 메서드에 AgentThread를 전달하지 않으면, 반환되는 것은 새 AgentThread가 됩니다.

반환 AgentThread 된 항목은 응답 메시지와 함께 호출 메서드의 개별 응답 항목에서 사용할 수 있습니다.

var result = await agent.InvokeAsync("What is the capital of France?").FirstAsync();
var newThread = result.Thread;
var resultMessage = result.Message;

모든 호출 메서드 키워드 인수는 매개 변수 전달을 허용합니다 AgentThread . 이 기능은 계속하려는 에이전트와 기존 대화가 있는 시나리오에 유용합니다.

# Invoke with an existing AgentThread.
agent.get_response("What is the capital of France?", thread=existing_agent_thread)

또한 모든 호출 메서드는 호출 응답의 일부로 활성 AgentThread 을 반환합니다.

1. 호출 메서드에 AgentThread을 전달한 경우 반환된 AgentThread은 전달된 것과 동일할 것입니다.
2. 호출 메서드에 AgentThread를 전달하지 않으면, 반환되는 것은 새 AgentThread가 됩니다.

반환 AgentThread 된 항목은 응답 메시지와 함께 호출 메서드의 개별 응답 항목에서 사용할 수 있습니다.

response = await agent.get_response("What is the capital of France?")
new_thread = response.thread
response_message = response.message

두 개의 호출 메서드 오버로드를 통해 매개 변수를 AgentThread 전달할 수 있습니다. 이 기능은 계속하려는 에이전트와 기존 대화가 있는 시나리오에 유용합니다.

// Invoke with an existing AgentThread.
agent.invokeAsync("What is the capital of France?", existingAgentThread);

또한 이러한 호출 메서드는 호출 응답의 일부로 활성 AgentThread 을 반환합니다.

1. 호출 메서드에 AgentThread 전달한 경우 반환 AgentThread 된 인스턴스는 이전 메시지와 새 메시지가 있는 새 인스턴스가 됩니다.
2. 호출 메서드에 AgentThread를 전달하지 않으면, 반환되는 것은 새 AgentThread가 됩니다.

반환 AgentThread 된 항목은 응답 메시지와 함께 호출 메서드의 개별 응답 항목에서 사용할 수 있습니다.

var result = agent.invokeAsync("What is the capital of France?").block().get(0);
var newThread = result.getThread();
var resultMessage = result.getMessage();

옵션을 사용하여 호출

모든 호출 메서드 오버로드에서 AgentInvokeOptions 매개 변수를 전달할 수 있습니다. 이 옵션 클래스를 사용하면 선택적 설정을 제공할 수 있습니다.

// Invoke with additional instructions via options.
agent.InvokeAsync("What is the capital of France?", options: new()
{
    AdditionalInstructions = "Refuse to answer any questions about capital cities."
});

지원되는 옵션 목록은 다음과 같습니다.

옵션을 사용하여 호출

하나의 호출 메서드 오버로드를 통해 매개 변수를 AgentInvokeOptions 전달할 수 있습니다. 이 옵션 클래스를 사용하면 선택적 설정을 제공할 수 있습니다.

// Invoke with additional instructions via options.
agent.invokeAsync("What is the capital of France?",
    null, // null AgentThread
    AgentInvokeOptions.builder()
        .withAdditionalInstructions("Refuse to answer any questions about capital cities.")
        .build()
);

지원되는 옵션 목록은 다음과 같습니다.

// Delete a thread.
await agentThread.DeleteAsync();

# Delete a thread
await agent_thread.delete()

// Delete a thread.
agentThread.deleteAsync().block();