본문으로 건너뛰기

인터페이스: ChatMCPOptions

정의 위치: packages/ai/src/activities/chat/mcp/types.ts:55

chat() 호출의 MCP 도구 검색 및 수명 주기를 제어하는 옵션입니다.

속성

clients

clients: MCPToolSource[];

정의 위치: packages/ai/src/activities/chat/mcp/types.ts:59

도구를 검색하고 관리할 MCP 클라이언트 또는 클라이언트 풀입니다.


connection?

optional connection?: MCPConnectionPolicy;

정의 위치: packages/ai/src/activities/chat/mcp/types.ts:66

실행이 끝날 때 모든 클라이언트에 적용되는 연결 수명 주기 정책입니다.

기본값은 'close'입니다.


lazyTools?

optional lazyTools?: boolean;

정의 위치: packages/ai/src/activities/chat/mcp/types.ts:74

true이면 도구 스키마를 지연 방식으로 가져옵니다(tools({ lazy: true })로 전달됨).

기본값은 false입니다.


onDiscoveryError?

optional onDiscoveryError?: (error, source) => void | Promise<void>;

정의 위치: packages/ai/src/activities/chat/mcp/types.ts:85

단일 소스의 도구 검색이 실패할 때 호출됩니다.

  • 이 핸들러에서 예외를 발생시키거나 다시 발생시키면 전체 chat 호출이 즉시 실패합니다.
  • 정상적으로 반환하면 해당 소스를 건너뛰고 나머지 클라이언트를 계속 처리합니다.
  • 이 핸들러를 아예 생략하면 오류를 다시 발생시킵니다(기본적으로 즉시 실패).

비동기 핸들러는 완료될 때까지 기다리므로, 거부된 promise도 즉시 실패를 일으킵니다.

매개변수

error

unknown

source

MCPToolSource

반환값

void | Promise&lt;void>