Managed Deep Agents를 채널에 연결하기

Managed Deep Agents를 채널에 연결하기

Managed Deep Agents를 실행을 시작하고 응답을 받을 수 있는 외부 메시징 서비스에 연결할 수 있어요.

채널은 관리형 딥 에이전트를 외부 메시징 서비스에서 사용할 수 있게 만듭니다. 서비스의 메시지가 에이전트 실행을 시작할 수 있고, 에이전트의 최종 응답이 같은 서비스를 통해 반환됩니다.

Managed Deep Agents는 공개 베타 상태이며 LangSmith Cloud의 미국 지역에서만 사용할 수 있어요.

출처: 문서

본문

프로젝트 구조 (Project structure)

채널 선언은 프로젝트 수준의 channels/ 디렉터리에 있습니다:

my-agent/
  agent.ts
  channels/
    slack.ts

채널 이해하기 (Understand channels)

채널은 외부 메시징 통합의 세 부분을 결합합니다:

  • 인바운드 이벤트 (Inbound events): 공급자 이벤트를 검증하고 정규화한 다음 에이전트 실행을 시작합니다.
  • 아웃바운드 메시징 (Outbound messaging): 에이전트의 응답을 원래 대화에 다시 보냅니다.
  • 프로비저닝 (Provisioning): 서비스를 배포된 에이전트에 연결하는 공급자 리소스를 만들고 구성합니다.

Managed Deep Agents에서 채널은 배포된 에이전트를 메시징 공급자에 연결합니다.

관리형 런타임이 채널 수명주기를 처리합니다:

flowchart LR
    Provider["Messaging provider"] --> Verify["Verify and normalize event"]
    Verify --> Thread["Resolve identity and thread"]
    Thread --> Run["Run agent"]
    Run --> Reply["Post response"]
    Reply --> Provider

    classDef trigger fill:#F6FFDB,stroke:#6E8900,stroke-width:2px,color:#2E3900;
    classDef process fill:#E5F4FF,stroke:#006DDD,stroke-width:2px,color:#030710;
    classDef output fill:#EBD0F0,stroke:#885270,stroke-width:2px,color:#441E33;
    class Provider trigger;
    class Verify,Thread,Run process;
    class Reply output;

공급자 어댑터는 어떤 이벤트가 허용되는지, 공급자 대화가 Managed Deep Agents 스레드에 어떻게 매핑되는지, 응답이 어떻게 전달되는지를 결정합니다. 채널 선언은 해당 공급자에 대해 지원되는 구성을 노출합니다.

프로젝트에서 채널 선언하기 (Declare channels in a project)

각 채널을 channels/ 아래의 별도 모듈에 넣습니다.

각 파일에서 이름이 channel인 것을 내보냅니다.

파일 이름이 구성된 채널 이름이 되고 배포 내에서 채널을 식별합니다.

선언 이름을 channels/channel.ts로 지정하지 마세요.

채널 이름은 프로젝트 내에서 고유해야 합니다.

공급자 팩토리가 선언을 만듭니다.

예를 들어 channels.slack()은 Slack 채널을 만듭니다.

선언, 앱 구성, 배포 절차는 공급자 가이드를 참고하세요.

채널과 커넥터 구분하기 (Distinguish channels from connectors)

채널은 에이전트 실행을 시작하는 메시지를 받고 응답을 전달합니다. MCP 커넥터는 에이전트에게 원격 MCP 서버의 도구를 제공합니다. 프로젝트는 둘 중 하나 또는 둘 다를 사용할 수 있습니다.

지원되는 채널 (Supported channels)

Slack — Slack 언급, 직접 메시지, 스레드 답변에서 실행을 시작합니다.

참고 (See also)

  • 아이덴티티: 호출자를 인증하고 채널 실행을 해석된 사용자로 범위를 지정합니다.
  • 스케줄: 구성된 채널을 통해 예약된 결과를 전달합니다.
  • 에이전트 배포: 프로젝트 변경 사항을 배포하고 비밀을 구성합니다.
  • CLI 참조: 채널 프로젝트 파일 규칙을 검토합니다.

더 알아보기 (Learn more)