1# ------------------------------------
2# Copyright (c) Microsoft Corporation.
3# Licensed under the MIT License.
4# ------------------------------------
5 
6"""
7DESCRIPTION:
8    This sample demonstrates how to use agent operations with custom functions from
9    the Azure Agents service using a synchronous client.
10 
11USAGE:
12    python sample_agents_functions.py
13 
14    Before running the sample:
15 
16    pip install azure-ai-projects azure-ai-agents azure-identity
17 
18    Set these environment variables with your own values:
19    1) PROJECT_ENDPOINT - The Azure AI Project endpoint, as found in the Overview
20                          page of your Azure AI Foundry portal.
21    2) MODEL_DEPLOYMENT_NAME - The deployment name of the AI model, as found under the "Name" column in
22       the "Models + endpoints" tab in your Azure AI Foundry project.
23"""
24import os, time, sys
25from azure.ai.projects import AIProjectClient
26from azure.identity import DefaultAzureCredential
27from azure.ai.agents.models import (
28    FunctionTool,
29    ListSortOrder,
30    RequiredFunctionToolCall,
31    SubmitToolOutputsAction,
32    ToolOutput,
33)
34 
35current_path = os.path.dirname(__file__)
36root_path = os.path.abspath(os.path.join(current_path, os.pardir, os.pardir))
37if root_path not in sys.path:
38    sys.path.insert(0, root_path)
39from samples.utils.user_functions import user_functions
40 
41project_client = AIProjectClient(
42    endpoint=os.environ["PROJECT_ENDPOINT"],
43    credential=DefaultAzureCredential(),
44)
45 
46# Initialize function tool with user functions
47functions = FunctionTool(functions=user_functions)
48 
49with project_client:
50    agents_client = project_client.agents
51 
52    # Create an agent and run user's request with function calls
53    agent = agents_client.create_agent(
54        model=os.environ["MODEL_DEPLOYMENT_NAME"],
55        name="my-agent",
56        instructions="You are a helpful agent",
57        tools=functions.definitions,
58    )
59    print(f"Created agent, ID: {agent.id}")
60 
61    thread = agents_client.threads.create()
62    print(f"Created thread, ID: {thread.id}")
63 
64    message = agents_client.messages.create(
65        thread_id=thread.id,
66        role="user",
67        content="Hello, send an email with the datetime and weather information in New York?",
68    )
69    print(f"Created message, ID: {message.id}")
70 
71    run = agents_client.runs.create(thread_id=thread.id, agent_id=agent.id)
72    print(f"Created run, ID: {run.id}")
73 
74    while run.status in ["queued", "in_progress", "requires_action"]:
75        time.sleep(1)
76        run = agents_client.runs.get(thread_id=thread.id, run_id=run.id)
77 
78        if run.status == "requires_action" and isinstance(run.required_action, SubmitToolOutputsAction):
79            tool_calls = run.required_action.submit_tool_outputs.tool_calls
80            if not tool_calls:
81                print("No tool calls provided - cancelling run")
82                agents_client.runs.cancel(thread_id=thread.id, run_id=run.id)
83                break
84 
85            tool_outputs = []
86            for tool_call in tool_calls:
87                if isinstance(tool_call, RequiredFunctionToolCall):
88                    try:
89                        print(f"Executing tool call: {tool_call}")
90                        output = functions.execute(tool_call)
91                        tool_outputs.append(
92                            ToolOutput(
93                                tool_call_id=tool_call.id,
94                                output=output,
95                            )
96                        )
97                    except Exception as e:
98                        print(f"Error executing tool_call {tool_call.id}: {e}")
99 
100            print(f"Tool outputs: {tool_outputs}")
101            if tool_outputs:
102                agents_client.runs.submit_tool_outputs(thread_id=thread.id, run_id=run.id, tool_outputs=tool_outputs)
103 
104        print(f"Current run status: {run.status}")
105 
106    print(f"Run completed with status: {run.status}")
107 
108    # Delete the agent when done
109    agents_client.delete_agent(agent.id)
110    print("Deleted agent")
111 
112    # Fetch and log all messages
113    messages = agents_client.messages.list(thread_id=thread.id, order=ListSortOrder.ASCENDING)
114    for msg in messages:
115        if msg.text_messages:
116            last_text = msg.text_messages[-1]
117            print(f"{msg.role}: {last_text.text.value}")