InfoGrab DocsInfoGrab Docs

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

요약

Tools Agent에 연결된 도구1를 구성할 때 많은 매개변수를 AI 모델이 직접 채울 수 있습니다. 이를 수행하는 방법은 두 가지이며, 둘 사이를 전환할 수 있습니다. 도구의 편집 대화 상자에서 각 해당 매개변수 필드에는 끝부분에 추가 버튼이 있습니다.

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

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

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

도구의 편집 대화 상자에서 각 해당 매개변수 필드에는 끝부분에 추가 버튼이 있습니다.

매개변수 필드 오른쪽에 별 아이콘이 표시된 이미지

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

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

Warning

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

$fromAI() 함수 사용하기#

$fromAI() 함수는 AI를 사용하여 Tools AI 에이전트에 연결된 도구의 매개변수를 동적으로 채웁니다.

Note

도구 전용

$fromAI() 함수는 AI Agent node에 연결된 도구에서만 사용할 수 있습니다. $fromAI() 함수는 Code 도구나 다른 도구가 아닌 클러스터 서브 노드에서는 작동하지 않습니다.

$fromAI() 함수를 사용하려면 필수 key 매개변수와 함께 호출하세요.

{{ $fromAI('email') }}

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

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

매개변수#

$fromAI() 함수는 다음 매개변수를 받습니다.

매개변수 유형 필수 여부 설명
key string ✅ 인수의 키 또는 이름을 나타내는 문자열입니다. 이 값은 1자 이상 64자 이하여야 하며 소문자, 대문자, 숫자, 밑줄, 하이픈만 포함할 수 있습니다.
description string ❌ 인수를 설명하는 문자열입니다.
type string ❌ 데이터 유형을 지정하는 문자열입니다. string, number, boolean, json 중 하나일 수 있으며 기본값은 string입니다.
defaultValue any ❌ 인수에 사용할 기본값입니다.

예시#

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

$fromAI("name", "The commenter's name", "string", "Jane Doe")

선택적 매개변수가 필요하지 않다면 다음과 같이 단순화할 수 있습니다.

$fromAI("name")

재고에 있는 항목 수를 동적으로 채우려면 다음과 같은 $fromAI() 표현식을 사용할 수 있습니다.

$fromAI("numItemsInStock", "Number of items in stock", "number", 5)

필드의 일부만 모델에서 얻은 동적 값으로 채우고 싶다면 일반 표현식 안에서도 사용할 수 있습니다. 예를 들어 모델이 이메일의 subject 매개변수를 채우도록 하되 생성된 값 앞에 항상 'Generated by AI:' 문자열을 붙이고 싶다면 다음 표현식을 사용할 수 있습니다.

Generated by AI: {{ $fromAI("subject") }}

템플릿#

다음 템플릿3에서 $fromAI() 함수가 실제로 사용되는 것을 볼 수 있습니다.

Footnotes

  1. AI 맥락에서 도구는 AI가 요청에 응답할 때 특정 정보나 기능을 참조할 수 있는 부가 리소스입니다. AI 모델은 도구를 사용하여 외부 시스템과 상호작용하거나 특정한 집중된 작업을 완료할 수 있습니다. ↩

  2. AI 에이전트는 사용자의 요청에 응답하고, 결정을 내리고, 실제 작업을 수행할 수 있는 인공지능 시스템입니다. 대규모 언어 모델(LLM)을 사용하여 사용자 입력을 해석하고 사용 가능한 정보와 리소스를 활용하여 요청을 가장 잘 처리하는 방법을 결정합니다. ↩

  3. n8n 템플릿은 n8n과 커뮤니티 구성원이 설계한 사전 구축된 워크플로로, n8n 인스턴스로 가져올 수 있습니다. 템플릿을 사용할 때는 필요에 맞게 자격 증명을 입력하고 구성을 조정해야 할 수 있습니다. ↩

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

n8n v2.29
원문 보기
요약

Tools Agent에 연결된 도구1를 구성할 때 많은 매개변수를 AI 모델이 직접 채울 수 있습니다. 이를 수행하는 방법은 두 가지이며, 둘 사이를 전환할 수 있습니다. 도구의 편집 대화 상자에서 각 해당 매개변수 필드에는 끝부분에 추가 버튼이 있습니다.

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

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

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

도구의 편집 대화 상자에서 각 해당 매개변수 필드에는 끝부분에 추가 버튼이 있습니다.

매개변수 필드 오른쪽에 별 아이콘이 표시된 이미지

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

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

Warning

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

$fromAI() 함수 사용하기#

$fromAI() 함수는 AI를 사용하여 Tools AI 에이전트에 연결된 도구의 매개변수를 동적으로 채웁니다.

Note

도구 전용

$fromAI() 함수는 AI Agent node에 연결된 도구에서만 사용할 수 있습니다. $fromAI() 함수는 Code 도구나 다른 도구가 아닌 클러스터 서브 노드에서는 작동하지 않습니다.

$fromAI() 함수를 사용하려면 필수 key 매개변수와 함께 호출하세요.

{{ $fromAI('email') }}

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

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

매개변수#

$fromAI() 함수는 다음 매개변수를 받습니다.

매개변수 유형 필수 여부 설명
key string ✅ 인수의 키 또는 이름을 나타내는 문자열입니다. 이 값은 1자 이상 64자 이하여야 하며 소문자, 대문자, 숫자, 밑줄, 하이픈만 포함할 수 있습니다.
description string ❌ 인수를 설명하는 문자열입니다.
type string ❌ 데이터 유형을 지정하는 문자열입니다. string, number, boolean, json 중 하나일 수 있으며 기본값은 string입니다.
defaultValue any ❌ 인수에 사용할 기본값입니다.

예시#

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

$fromAI("name", "The commenter's name", "string", "Jane Doe")

선택적 매개변수가 필요하지 않다면 다음과 같이 단순화할 수 있습니다.

$fromAI("name")

재고에 있는 항목 수를 동적으로 채우려면 다음과 같은 $fromAI() 표현식을 사용할 수 있습니다.

$fromAI("numItemsInStock", "Number of items in stock", "number", 5)

필드의 일부만 모델에서 얻은 동적 값으로 채우고 싶다면 일반 표현식 안에서도 사용할 수 있습니다. 예를 들어 모델이 이메일의 subject 매개변수를 채우도록 하되 생성된 값 앞에 항상 'Generated by AI:' 문자열을 붙이고 싶다면 다음 표현식을 사용할 수 있습니다.

Generated by AI: {{ $fromAI("subject") }}

템플릿#

다음 템플릿3에서 $fromAI() 함수가 실제로 사용되는 것을 볼 수 있습니다.

Footnotes

  1. AI 맥락에서 도구는 AI가 요청에 응답할 때 특정 정보나 기능을 참조할 수 있는 부가 리소스입니다. AI 모델은 도구를 사용하여 외부 시스템과 상호작용하거나 특정한 집중된 작업을 완료할 수 있습니다. ↩

  2. AI 에이전트는 사용자의 요청에 응답하고, 결정을 내리고, 실제 작업을 수행할 수 있는 인공지능 시스템입니다. 대규모 언어 모델(LLM)을 사용하여 사용자 입력을 해석하고 사용 가능한 정보와 리소스를 활용하여 요청을 가장 잘 처리하는 방법을 결정합니다. ↩

  3. n8n 템플릿은 n8n과 커뮤니티 구성원이 설계한 사전 구축된 워크플로로, n8n 인스턴스로 가져올 수 있습니다. 템플릿을 사용할 때는 필요에 맞게 자격 증명을 입력하고 구성을 조정해야 할 수 있습니다. ↩