1# pylint: disable=line-too-long,useless-suppression
2# ------------------------------------
3# Copyright (c) Microsoft Corporation.
4# Licensed under the MIT License.
5# ------------------------------------
6
7"""
8DESCRIPTION:
9 This sample demonstrates how to enable automatic function calls by calling `enable_auto_function_calls`
10 using a synchronous client.
11
12USAGE:
13 python sample_agents_auto_function_call.py
14
15 Before running the sample:
16
17 pip install azure-ai-agents azure-identity
18
19 Set these environment variables with your own values:
20 1) PROJECT_ENDPOINT - The Azure AI Project endpoint, as found in the Overview
21 page of your Azure AI Foundry portal.
22 2) MODEL_DEPLOYMENT_NAME - The deployment name of the AI model, as found under the "Name" column in
23 the "Models + endpoints" tab in your Azure AI Foundry project.
24"""
25
26import os, sys
27from azure.ai.projects import AIProjectClient
28from azure.identity import DefaultAzureCredential
29from azure.ai.agents.models import FunctionTool
30from samples.utils.user_functions import user_functions
31
32project_client = AIProjectClient(
33 endpoint=os.environ["PROJECT_ENDPOINT"],
34 credential=DefaultAzureCredential(),
35)
36
37with project_client:
38 agents_client = project_client.agents
39
40 agent = agents_client.create_agent(
41 model=os.environ["MODEL_DEPLOYMENT_NAME"],
42 name="my-agent",
43 instructions="You are helpful agent",
44 )
45
46 # To enable tool calls executed automatically you can pass a functions in one of these types:
47 # Set[Callable[..., Any]], _models.FunctionTool, or _models.ToolSet
48 # Example 1:
49 # agents_client.enable_auto_function_calls(user_functions)
50 # Example 2:
51 # functions = FunctionTool(user_functions)
52 # agents_client.enable_auto_function_calls(functions)
53 # Example 3:
54 # functions = FunctionTool(user_functions)
55 # toolset = ToolSet()
56 # toolset.add(functions)
57 # agents_client.enable_auto_function_calls(toolset)
58 agents_client.enable_auto_function_calls(user_functions)
59 # Notices that `enable_auto_function_calls` can be made at any time.
60
61 functions = FunctionTool(user_functions)
62
63 # Initialize agent.
64 # Whether you would like the functions to be called automatically or not, it is required to pass functions as tools or toolset.
65 # NOTE: To reuse existing agent, fetch it with get_agent(agent_id)
66 agent = agents_client.create_agent(
67 model=os.environ["MODEL_DEPLOYMENT_NAME"],
68 name="my-agent",
69 instructions="You are a helpful agent",
70 tools=functions.definitions,
71 )
72
73 print(f"Created agent, ID: {agent.id}")
74
75 # Create thread for communication
76 thread = agents_client.threads.create()
77 print(f"Created thread, ID: {thread.id}")
78
79 # Create message to thread
80 message = agents_client.messages.create(
81 thread_id=thread.id,
82 role="user",
83 content="Hello, send an email with the datetime and weather information in New York?",
84 )
85 print(f"Created message, ID: {message.id}")
86
87 # Create and process agent run in thread with tools
88 run = agents_client.runs.create_and_process(thread_id=thread.id, agent_id=agent.id)
89 print(f"Run finished with status: {run.status}")
90
91 if run.status == "failed":
92 print(f"Run failed: {run.last_error}")
93
94 # Clean-up and delete the agent once the run is finished.
95 # NOTE: Comment out this line if you plan to reuse the agent later.
96 agents_client.delete_agent(agent.id)
97 print("Deleted agent")
98
99 # Fetch and log all messages
100 messages = agents_client.messages.list(thread_id=thread.id)
101 for msg in messages:
102 if msg.text_messages:
103 last_text = msg.text_messages[-1]
104 print(f"{msg.role}: {last_text.text.value}")
