Connection

이 생성기는 웹사이트가 API를 호출하는 것과 같이 프로젝트를 서로 연결하는 데 사용됩니다. 소스 프로젝트(예: API를 호출할 프로젝트)와 대상 프로젝트(예: API 프로젝트)를 선택하기만 하면 이 생성기가 두 프로젝트를 통합하는 작업을 처리합니다.

시각적으로 스케치하기

워크스페이스를 먼저 설계하고 싶으신가요? Graph Builder를 사용하면 프로젝트를 드래그하고 프로젝트 간의 연결을 그린 다음, 전체를 스캐폴딩하는 명령을 제공합니다.

사용법

생성기 실행

이 제너레이터 실행@aws/nx-plugin:connection

CLI

pnpm

$ pnpm nx g @aws/nx-plugin:connection

yarn

$ yarn nx g @aws/nx-plugin:connection

npm

$ npx nx g @aws/nx-plugin:connection

bun

$ bunx nx g @aws/nx-plugin:connection

VSCode

1. 설치 Nx Console VSCode Plugin 아직 설치하지 않았다면
2. VSCode에서 Nx 콘솔 열기
3. 클릭 Generate (UI) "Common Nx Commands" 섹션에서
4. 검색 @aws/nx-plugin - connection
5. 필수 매개변수 입력
6. 클릭 Generate

명령 구성하기5

sourceProject필수

targetProject필수

sourceComponent

targetComponent

preferInstallDependencies

true

--dry-run어떤 파일이 변경될지 확인하기 위해 드라이 런을 수행할 수도 있습니다

옵션

제너레이터 옵션5 옵션

sourceProject필수string

소스 프로젝트

targetProject필수string

연결할 대상 프로젝트

sourceComponentstring

연결할 소스 컴포넌트 (컴포넌트 이름, 소스 프로젝트 루트 기준 상대 경로, 또는 generator id). 프로젝트를 소스로 명시적으로 선택하려면 '.'을 사용하세요.

targetComponentstring

연결할 대상 컴포넌트 (컴포넌트 이름, 대상 프로젝트 루트 기준 상대 경로, 또는 generator id). 프로젝트를 대상으로 명시적으로 선택하려면 '.'을 사용하세요.

preferInstallDependenciesboolean기본값: true

생성기 실행 후 의존성 설치를 선호할지 여부입니다. 여러 생성기를 일괄 처리할 때 설치를 연기하려면 false로 설정하세요 (후속 생성기가 Nx 프로젝트 그래프를 계산할 수 있도록 필요한 경우 설치는 여전히 실행됩니다); 마지막에 한 번만 설치합니다.

지원되는 연결

Connection 생성기는 다음 연결을 지원합니다:

React to tRPCCall a tRPC API from a React website

React to FastAPICall a Python FastAPI from a React website

React to Smithy APICall a Smithy API from a React website

React to Python AgentCall a Python Agent from a React website

React to TypeScript AgentCall a TypeScript Agent from a React website

React to AG-UI AgentCall an Agent exposing the AG-UI protocol from a React website via CopilotKit

Python Agent to MCPConnect a Python Agent to an MCP server

TypeScript Agent to MCPConnect a TypeScript Agent to an MCP server

Python Agent to A2A AgentConnect a Python Agent to a remote A2A agent

TypeScript Agent to A2A AgentConnect a TypeScript Agent to a remote A2A agent

tRPC API to Relational DatabaseConnect a tRPC API to an Aurora relational database

Smithy API to Relational DatabaseConnect a Smithy API to an Aurora relational database

TypeScript Agent to Relational DatabaseConnect a TypeScript Agent to an Aurora relational database

TypeScript MCP Server to Relational DatabaseConnect a TypeScript MCP Server to an Aurora relational database

FastAPI to Python Relational DatabaseConnect a FastAPI to a Python Aurora relational database

Python Agent to Python Relational DatabaseConnect a Python Agent to a Python Aurora relational database

Python MCP Server to Python Relational DatabaseConnect a Python MCP Server to a Python Aurora relational database

tRPC API to TypeScript DynamoDBConnect a tRPC API to a DynamoDB table

Smithy API to TypeScript DynamoDBConnect a Smithy API to a DynamoDB table

TypeScript Agent to TypeScript DynamoDBConnect a TypeScript Agent to a DynamoDB table

MCP Server to TypeScript DynamoDBConnect a TypeScript MCP Server to a DynamoDB table

FastAPI to Python DynamoDBConnect a FastAPI to a DynamoDB table

Python Agent to Python DynamoDBConnect a Python Agent to a DynamoDB table

Python MCP Server to Python DynamoDBConnect a Python MCP Server to a DynamoDB table

AgentCore Gateway to MCP ServerAggregate an MCP server behind an AgentCore Gateway

AgentCore Gateway to AgentCore GatewayAggregate an AgentCore Gateway behind another AgentCore Gateway

TypeScript Agent to AgentCore GatewayConnect a TypeScript Agent to an AgentCore Gateway

Python Agent to AgentCore GatewayConnect a Python Agent to an AgentCore Gateway

AgentCore Gateway to AgentFront an agent with an AgentCore Gateway as a runtime target

React Website to AgentCore GatewayConnect a React website to agents through an AgentCore Gateway

런타임 구성

connection 생성기는 Runtime Configuration을 사용하여 배포 시점 값(예: API URL, Cognito 설정, 에이전트 런타임 ARN)을 생성된 프로젝트와 컴포넌트 간에 런타임에 전달하여 서로를 검색하고 연결할 수 있도록 합니다.

로컬 개발

연결된 프로젝트는 serve 및 dev 타겟을 사용하여 로컬 머신에서 실행할 수 있습니다. 자세한 내용은 Local Development 가이드를 참조하세요.