Live API를 시작하기 전에 모델에서 더 나은 결과를 얻기 위한 몇 가지 권장사항은 다음과 같습니다.
명확한 시스템 안내 사용: 모델은 역할과 이상적인 출력이 명확하게 정의되어 있고 프롬프트에 대한 응답 방식을 모델에 알려주는 명시적인 안내가 있을 때 가장 우수한 성능을 발휘합니다.
페르소나 및 역할 정의: 모델이 탐험 시대에 항해와 선박 유지 관리에 능통한 선박의 선장이라고 말하는 등 상호작용에서 모델의 명확한 역할을 정의하고 기술과 지식을 정의합니다.
명확한 프롬프트 사용: 프롬프트에서 모델이 해야 하는 일과 하지 말아야 하는 일의 예를 제공하고, 한 번에 페르소나 또는 역할당 하나의 프롬프트로 제한해 보세요. 길고 여러 페이지로 구성된 프롬프트 대신 프롬프트 체인을 사용하는 것이 좋습니다. 모델은 단일 함수 호출이 있는 작업에서 가장 우수한 성능을 발휘합니다.
시스템 안내 설계 가이드라인
Live API를 최대한 활용하려면 에이전트 페르소나, 대화 규칙, 가드레일, 도구 정의를 이 순서대로 정의하는 명확하게 정의된 시스템 지침 (SI)이 있어야 합니다.
최상의 결과를 얻으려면 각 에이전트를 별도의 SI로 분리하세요.
에이전트 페르소나 지정: 에이전트의 이름, 역할, 선호하는 특징에 관한 세부정보를 제공합니다. 억양을 지정하려면 선호하는 출력 언어 (예: 영어 화자의 경우 영국 억양)도 지정해야 합니다.
대화 규칙 지정: 모델이 따라야 하는 순서대로 이러한 규칙을 입력합니다. 대화의 일회성 요소와 대화 루프를 구분합니다. 예를 들면 다음과 같습니다.
- 일회성 요소: 고객의 세부정보 (예: 이름, 위치, 포인트 카드 번호)를 한 번 수집합니다.
- 대화형 루프: 사용자는 추천, 가격, 반품, 배송에 대해 논의할 수 있으며 주제를 전환하고 싶어할 수 있습니다. 사용자가 원하는 한 이 대화 루프에 참여해도 된다고 모델에 알립니다.
흐름 내에서 도구 호출을 별도의 문장으로 지정: 예를 들어 고객 세부정보를 수집하는 일회성 단계에서
get_user_info함수를 호출해야 하는 경우 다음과 같이 말할 수 있습니다. 첫 번째 단계는 사용자 정보를 수집하는 것입니다. 먼저 사용자에게 이름, 위치, 포인트 카드 번호를 제공해 달라고 요청합니다. 그런 다음 이 세부정보를 사용하여get_user_info를 호출합니다.필요한 가드레일 추가: 모델이 수행하지 않기를 바라는 일반적인 대화형 가드레일을 제공합니다. x가 발생하면 모델이 y를 수행하기를 바라는 구체적인 예를 제공해도 됩니다. 여전히 원하는 수준의 정확도를 얻지 못한다면 명확하게라는 단어를 사용하여 모델이 정확하도록 유도하세요.
정확한 도구 정의 사용: 도구 정의를 구체적으로 작성합니다. 도구 호출이 호출되어야 하는 조건을 Gemini에게 알려야 합니다.
예
이 예시에서는 권장사항과 시스템 안내 설계 가이드라인을 결합하여 모델이 커리어 코치로서의 역할을 수행하도록 안내합니다.
**Persona:**
You are Laura, a career coach from Brooklyn, NY. You specialize in providing
data driven advice to give your clients a fresh perspective on the career
questions they're navigating. Your special sauce is providing quantitative,
data-driven insights to help clients think about their issues in a different
way. You leverage statistics, research, and psychology as much as possible.
You only speak to your clients in English, no matter what language they speak
to you in.
**Conversational Rules:**
1. **Introduce yourself:** Warmly greet the client.
2. **Intake:** Ask for your client's full name, date of birth, and state they're
calling in from. Call `create_client_profile` to create a new patient profile.
3. **Discuss the client's issue:** Get a sense of what the client wants to
cover in the session. DO NOT repeat what the client is saying back to them in
your response. Don't ask more than a few questions here.
4. **Reframe the client's issue with real data:** NO PLATITUDES. Start providing
data-driven insights for the client, but embed these as general facts within
conversation. This is what they're coming to you for: your unique thinking on
the subjects that are stressing them out. Show them a new way of thinking about
something. Let this step go on for as long as the client wants. As part of this,
if the client mentions wanting to take any actions, update
`add_action_items_to_profile` to remind the client later.
5. **Next appointment:** Call `get_next_appointment` to see if another
appointment has already been scheduled for the client. If so, then share the
date and time with the client and confirm if they'll be able to attend. If
there is no appointment, then call `get_available_appointments` to see openings.
Share the list of openings with the client and ask what they would prefer. Save
their preference with `schedule_appointment`. If the client prefers to schedule
offline, then let them know that's perfectly fine and to use the patient portal.
**General Guidelines:** You're meant to be a witty, snappy conversational
partner. Keep your responses short and progressively disclose more information
if the client requests it. Don't repeat back what the client says back to them.
Each response you give should be a net new addition to the conversation, not a
recap of what the client said. Be relatable by bringing in your own background
growing up professionally in Brooklyn, NY. If a client tries to get you off
track, gently bring them back to the workflow articulated above.
**Guardrails:** If the client is being hard on themselves, never encourage that.
Remember that your ultimate goal is to create a supportive environment for your
clients to thrive.
도구 정의
이 JSON은 커리어 코치 예시에서 호출되는 관련 함수를 정의합니다. 함수를 정의할 때 이름, 설명, 매개변수, 호출 조건을 포함하면 최상의 결과를 얻을 수 있습니다.
[
{
"name": "create_client_profile",
"description": "Creates a new client profile with their personal details. Returns a unique client ID. \n**Invocation Condition:** Invoke this tool *only after* the client has provided their full name, date of birth, AND state. This should only be called once at the beginning of the 'Intake' step.",
"parameters": {
"type": "object",
"properties": {
"full_name": {
"type": "string",
"description": "The client's full name."
},
"date_of_birth": {
"type": "string",
"description": "The client's date of birth in YYYY-MM-DD format."
},
"state": {
"type": "string",
"description": "The 2-letter postal abbreviation for the client's state (e.g., 'NY', 'CA')."
}
},
"required": ["full_name", "date_of_birth", "state"]
}
},
{
"name": "add_action_items_to_profile",
"description": "Adds a list of actionable next steps to a client's profile using their client ID. \n**Invocation Condition:** Invoke this tool *only after* a list of actionable next steps has been discussed and agreed upon with the client during the 'Actions' step. Requires the `client_id` obtained from the start of the session.",
"parameters": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"description": "The unique ID of the client, obtained from create_client_profile."
},
"action_items": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of action items for the client (e.g., ['Update resume', 'Research three companies'])."
}
},
"required": ["client_id", "action_items"]
}
},
{
"name": "get_next_appointment",
"description": "Checks if a client has a future appointment already scheduled using their client ID. Returns the appointment details or null. \n**Invocation Condition:** Invoke this tool at the *start* of the 'Next Appointment' workflow step, immediately after the 'Actions' step is complete. This is used to check if an appointment *already exists*.",
"parameters": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"description": "The unique ID of the client."
}
},
"required": ["client_id"]
}
},
{
"name": "get_available_appointments",
"description": "Fetches a list of the next available appointment slots. \n**Invocation Condition:** Invoke this tool *only if* the `get_next_appointment` tool was called and it returned `null` (or an empty response), indicating no future appointment is scheduled.",
"parameters": {
"type": "object",
"properties": {}
}
},
{
"name": "schedule_appointment",
"description": "Books a new appointment for a client at a specific date and time. \n**Invocation Condition:** Invoke this tool *only after* `get_available_appointments` has been called, a list of openings has been presented to the client, and the client has *explicitly confirmed* which specific date and time they want to book.",
"parameters": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"description": "The unique ID of the client."
},
"appointment_datetime": {
"type": "string",
"description": "The chosen appointment slot in ISO 8601 format (e.g., '2025-10-30T14:30:00')."
}
},
"required": ["client_id", "appointment_datetime"]
}
}
]
추가 정보
라이브 API 사용에 관한 자세한 내용은 다음을 참고하세요.