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 di:
- Mengembangkan agen AG2: untuk mengembangkan
agent
sebagai instanceAG2Agent
. - Autentikasi pengguna untuk mengautentikasi sebagai pengguna untuk membuat kueri agen.
Operasi yang didukung
Operasi berikut didukung untuk AG2Agent
:
query
: untuk mendapatkan respons 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 giliran untuk membuat argumen alat dan satu giliran lagi untuk menjalankan alat.
Membuat kueri agen
Metode query()
menyediakan cara yang disederhanakan untuk berinteraksi dengan agen. Panggilan standar 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. Hal ini setara dengan hal 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 dengan False
oleh template AG2Agent.