IChatClient 인터페이스

정의

네임스페이스:
Microsoft.Extensions.AI
어셈블리:
Microsoft.Extensions.AI.Abstractions.dll
패키지:
Microsoft.Extensions.AI.Abstractions v10.6.0
Source:
IChatClient.cs

채팅 클라이언트를 나타냅니다.

public interface class IChatClient : IDisposable
public interface IChatClient : IDisposable
type IChatClient = interface
    interface IDisposable
Public Interface IChatClient
Implements IDisposable
파생
구현
IDisposable

설명

애플리케이션은 프롬프트 삽입 공격, 데이터 크기 및 기본 공급자에게 전송되거나 반환된 메시지 수와 같은 위험을 고려해야 합니다. 특정 IChatClient 구현이 이러한 문제에 대한 보호를 명시적으로 문서화하지 않는 한 애플리케이션은 적절한 보호를 구현해야 합니다.

달리 지정하지 않는 한, 모든 멤버 IChatClient 는 동시 사용을 위해 스레드로부터 안전합니다. 여러 요청에서 동시에 사용되는 지원의 IChatClient 모든 구현이 필요합니다. 인스턴스가 계속 사용 중인 동안에는 인스턴스를 삭제해서는 안 됩니다.

그러나 구현은 옵션 인스턴스를 IChatClient 구성하는 등 제공된 GetResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken) 인수를 GetStreamingResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken)변경할 수 있습니다. 따라서 인터페이스의 소비자는 동시 호출에 이러한 인수의 공유 인스턴스를 사용하지 않아야 하거나, 그렇지 않으면 생성 시 이러한 변형을 사용할 수 있는 인스턴스가 사용되지 않도록 IChatClient 해야 합니다. 예를 들어 ConfigureOptions 메서드는 제공된 옵션 인수를 변경할 수 있는 콜백과 함께 제공되며 싱글톤 옵션 인스턴스를 사용하는 경우 피해야 합니다.

메서드

Name Description
Dispose()

관리되지 않는 리소스의 해제, 해제 또는 재설정과 관련된 애플리케이션 정의 작업을 수행합니다.

(다음에서 상속됨 IDisposable)
GetResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken)

채팅 메시지를 보내고 응답을 반환합니다.
GetService(Type, Object)

IChatClient 지정된 형식serviceType의 개체를 묻습니다.
GetStreamingResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken)

채팅 메시지를 보내고 응답을 스트리밍합니다.

확장명 메서드

Name Description
AsBuilder(IChatClient)

내부 클라이언트로 사용하여 ChatClientBuilder 새 innerClient 파일을 만듭니다.
GetRequiredService(IChatClient, Type, Object)

IChatClient 지정된 형식 serviceType 의 개체를 요청하고 사용할 수 없는 경우 예외를 throw합니다.
GetRequiredService<TService>(IChatClient, Object)

형식 IChatClient 의 TService 개체를 요청하고 사용할 수 없는 경우 예외를 throw합니다.
GetResponseAsync(IChatClient, ChatMessage, ChatOptions, CancellationToken)

채팅 메시지를 보내고 응답 메시지를 반환합니다.
GetResponseAsync(IChatClient, String, ChatOptions, CancellationToken)

사용자 채팅 문자 메시지를 보내고 응답 메시지를 반환합니다.
GetResponseAsync<T>(IChatClient, ChatMessage, ChatOptions, Nullable<Boolean>, CancellationToken)

형식 T과 일치하는 응답을 요청하는 채팅 메시지를 보냅니다.
GetResponseAsync<T>(IChatClient, ChatMessage, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)

형식 T과 일치하는 응답을 요청하는 채팅 메시지를 보냅니다.
GetResponseAsync<T>(IChatClient, IEnumerable<ChatMessage>, ChatOptions, Nullable<Boolean>, CancellationToken)

채팅 메시지를 보내고 형식 T과 일치하는 응답을 요청합니다.
GetResponseAsync<T>(IChatClient, IEnumerable<ChatMessage>, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)

채팅 메시지를 보내고 형식 T과 일치하는 응답을 요청합니다.
GetResponseAsync<T>(IChatClient, String, ChatOptions, Nullable<Boolean>, CancellationToken)

사용자 채팅 문자 메시지를 보내고 형식 T과 일치하는 응답을 요청합니다.
GetResponseAsync<T>(IChatClient, String, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)

사용자 채팅 문자 메시지를 보내고 형식 T과 일치하는 응답을 요청합니다.
GetService<TService>(IChatClient, Object)

형식IChatClient의 TService 개체를 묻습니다.
GetStreamingResponseAsync(IChatClient, ChatMessage, ChatOptions, CancellationToken)

채팅 메시지를 보내고 응답 메시지를 스트리밍합니다.
GetStreamingResponseAsync(IChatClient, String, ChatOptions, CancellationToken)

사용자 채팅 문자 메시지를 보내고 응답 메시지를 스트리밍합니다.

적용 대상

추가 정보