Selain petunjuk umum untuk menggunakan agen, halaman ini menjelaskan fitur yang khusus untuk AG2Agent
.
Sebelum memulai
Tutorial ini mengasumsikan bahwa Anda telah membaca dan mengikuti petunjuk dalam:
- Mengembangkan agen AG2: untuk mengembangkan
agent
sebagai instanceAG2Agent
. - Autentikasi pengguna untuk mengautentikasi sebagai pengguna guna membuat kueri agen.
- Impor dan inisialisasi SDK untuk melakukan inisialisasi klien guna mendapatkan instance yang di-deploy (jika diperlukan).
Operasi yang didukung
Operasi berikut didukung untuk AG2Agent
:
query
: untuk mendapatkan respons terhadap kueri secara sinkron.
Metode query
mendukung argumen:
input
: pesan yang akan dikirim ke agen.max_turns
: jumlah maksimum giliran percakapan yang diizinkan. Saat menggunakan alat, diperlukan minimalmax_turns=2
: satu putaran untuk membuat argumen alat dan yang kedua untuk menjalankan alat.
Membuat kueri agen
Metode query()
menyediakan cara yang lebih sederhana untuk berinteraksi dengan agen. Panggilan umum terlihat seperti ini:
response = agent.query(input="What is the exchange rate from US dollars to Swedish currency?", max_turns=2)
Metode ini menangani komunikasi yang mendasarinya dengan agen dan menampilkan respons akhir agen sebagai kamus. Setara dengan berikut (dalam bentuk lengkap):
from autogen import ConversableAgent
import dataclasses
import json
input_message: str = "What is the exchange rate from US dollars to Swedish currency?"
max_turns: int = 2
with agent._runnable._create_or_get_executor(
tools=agent._ag2_tool_objects, # Use the agent's existing tools
agent_name="user", # Default
agent_human_input_mode="NEVER", # query() enforces this
) as executor:
chat_result = executor.initiate_chat(
agent._runnable,
message=input_message,
max_turns=max_turns,
clear_history=False, # Default
summary_method="last_msg" # Default
)
response = json.loads(
json.dumps(dataclasses.asdict(chat_result)) # query() does this conversion
)
Anda dapat menyesuaikan perilaku agen di luar input
dan max_turns
dengan meneruskan argumen kata kunci tambahan ke query()
.
response = agent.query(
input="What is the exchange rate from US dollars to Swedish currency?",
max_turns=2,
msg_to="user" # Start the conversation with the "user" agent
)
print(response)
Lihat
dokumentasi ConversableAgent.run
untuk mengetahui daftar lengkap parameter yang tersedia. Namun, perlu diingat bahwa
user_input
akan selalu diganti menjadi False
oleh template AG2Agent.