AI가 도구 매개변수를 지정하도록 하기#

Tools Agent에 연결된 app node tools를 구성할 때, 많은 매개변수를 AI 모델이 자체적으로 채울 수 있습니다. AI 모델은 작업의 맥락과 다른 연결된 도구의 정보를 사용하여 적절한 세부 정보를 채웁니다.

이를 수행하는 방법은 두 가지가 있으며, 둘 사이를 전환할 수 있습니다.

모델이 매개변수를 채우도록 하기#

도구의 편집 대화 상자의 각 적절한 매개변수 필드에는 끝에 추가 버튼이 있습니다:

이 버튼을 활성화하면, AI Agent가 사용자 입력 없이 표현식을 채워줍니다.
필드 자체는 매개변수가 모델에 의해 자동으로 정의되었음을 나타내는 메시지로 채워집니다.

매개변수를 직접 정의하고 싶다면, 이 상자의 'X'를 클릭하여 사용자 정의 값으로 복원할 수 있습니다. 이제 'expression' 필드에는 이 기능에 의해 생성된 표현식이 포함되지만, 이후 추가 세부 정보를 추가하기 위해 추가로 편집할 수 있습니다.

Warning

이 기능을 활성화하면 이미 추가한 수동 정의가 덮어쓰여집니다.

`$fromAI()` 함수 사용하기#

$fromAI() 함수는 Tools AI agent에 연결된 도구에 대한 매개변수를 동적으로 채우기 위해 AI를 사용합니다. 당신은 app nodes 내의 표현식에서 $fromAI() 함수를 사용할 수 있습니다 (예: Gmail, Notion, 또는 Slack)는 AI Agent에 도구로 연결되어 있습니다.

Node Tools 전용

$fromAI() 함수는 Tools Agent에 연결된 app node 도구에만 사용할 수 있습니다. $fromAI() 함수를 Call n8n Workflow, Code, HTTP Request, 또는 other cluster sub-nodes에서 사용할 수 없습니다.

$fromAI() 함수를 사용하려면, 필요한 key 매개변수와 함께 호출합니다:

{{ $fromAI('email') }}

key 매개변수 및 $fromAI() 함수의 다른 인수는 기존 값에 대한 참조가 아닙니다. 대신, 이러한 인수를 AI 모델이 적절한 데이터를 채우는 데 사용할 힌트라고 생각하세요.

예를 들어, email이라는 키를 선택하면 AI 모델은 컨텍스트, 다른 도구 및 입력 데이터에서 이메일 주소를 찾습니다. 채팅 워크플로에서 다른 곳에서 찾을 수 없는 경우 사용자에게 이메일 주소를 요청할 수 있습니다. 필요에 따라 AI 모델에 추가적인 맥락을 제공하기 위해 description과 같은 다른 매개변수를 선택적으로 전달할 수 있습니다.

매개변수#

$fromAI() 함수는 다음 매개변수를 허용합니다:

매개변수	유형	설명
`key`	string	인수를 나타내는 키 또는 이름을 나타내는 문자열입니다. 길이는 1에서 64자 사이여야 하며, 소문자, 대문자, 숫자, 언더스코어 및 하이픈만 포함될 수 있습니다.
`description`	string	인수를 설명하는 문자열입니다.
`type`	string	데이터 유형을 지정하는 문자열입니다. 문자열, 숫자, 불리언 또는 json일 수 있으며(기본값은 문자열입니다).
`defaultValue`	any	인수에 사용할 기본값입니다.

예시#

예를 들어, 다음과 같은 $fromAI() 표현식을 사용하여 동적으로 필드를 이름으로 채울 수 있습니다:

$fromAI("name", "댓글 작성자의 이름", "string", "Jane Doe")

필수 매개변수가 필요하지 않은 경우, 다음과 같이 간단히 작성할 수 있습니다:

$fromAI("name")

재고로 보유하고 있는 항목의 수를 동적으로 채우기 위해 다음과 같은 $fromAI() 표현식을 사용할 수 있습니다:

$fromAI("numItemsInStock", "재고에 있는 항목 수", "number", 5)

템플릿#

다음 템플릿에서 $fromAI() 함수의 동작을 확인할 수 있습니다: