Руководство по созданию агентного веб-приложения в Службе приложений Azure с помощью LangGraph или Службы агента Foundry (Python)

LangGraphTaskAgent инициализируется в конструкторе в src/agents/langgraph_task_agent.py. Код инициализации выполняет следующие действия:

• Настраивает клиент AzureChatOpenAI с помощью переменных среды.
• Создает предварительно созданный агент ReAct с памятью и набором средств CRUD для управления задачами (см. краткое руководство по LangGraph).

# Initialize Azure OpenAI client
credential = DefaultAzureCredential()
azure_ad_token_provider = get_bearer_token_provider(
    credential, "https://cognitiveservices.azure.com/.default"
)

self.llm = AzureChatOpenAI(
    azure_endpoint=endpoint,
    azure_deployment=deployment_name,
    azure_ad_token_provider=azure_ad_token_provider,
    api_version="2024-10-21"
)

# Define tools
tools = [
    self._create_task_tool(),
    self._get_tasks_tool(),
    self._get_task_tool(),
    self._update_task_tool(),
    self._delete_task_tool()
]

# Create the agent
self.agent = create_react_agent(self.llm, tools, checkpointer=self.memory)
print("LangGraph Task Agent initialized successfully")

При обработке сообщений пользователей агент вызывается с ainvoke() сообщением пользователя и идентификатором потока для непрерывности общения.

result = await self.agent.ainvoke(
    {"messages": [("user", message)]},
    config=config
)

FoundryTaskAgent инициализируется в конструкторе src/agents/foundry_task_agent.py. Код инициализации выполняет следующие действия:

• Создает AIProjectClient с использованием учетных данных Azure.
• Возвращает клиент OpenAI от клиента проекта.
• Извлекает агент из Foundry по имени.
• Создает новую беседу для сеанса.

# Create the project client using Azure credentials
self.project_client = AIProjectClient(
    endpoint=endpoint,
    credential=DefaultAzureCredential()
)

# Get the OpenAI client for conversation operations
self.openai_client = self.project_client.get_openai_client()

# Find the existing agent by name
self.agent = self.project_client.agents.get(agent_name)

if not self.agent:
    print(f"Agent with name '{agent_name}' not found in project.")
    return
            
# Create a conversation for this session
conversation = self.openai_client.conversations.create()
self.conversation_id = conversation.id
print("Foundry agent initialized successfully")

Этот код инициализации не определяет какие-либо функциональные возможности агента, так как обычно создается агент на портале Foundry. В рамках примера сценария он также следует шаблону OpenAPI, показанному в разделе "Добавление приложения службы приложений в качестве инструмента" в Службе агента Foundry (Python) и делает его функциональность CRUD доступной в качестве конечной точки OpenAPI. Это позволит позже добавить его агенту как вызываемый инструмент.

Код OpenAPI определяется в src/routes/api.py. Например, маршрут GET /tasks определяет настраиваемый operation_id параметр, как требуется средству спецификации OpenAPI в Microsoft Foundry, и description помогает агенту определить, как вызвать API:

@router.get(
    "/tasks",
    response_model=List[TaskItem],
    operation_id="getAllTasks",
    description="Retrieve all tasks in the task list."
)
async def get_all_tasks():
    """Get all tasks"""
    try:
        tasks = await task_service.get_all_tasks()
        return tasks
    except Exception as e:
        print(f"Error getting tasks: {e}")
        import traceback
        traceback.print_exc()
        raise HTTPException(status_code=500, detail=f"Failed to get tasks: {str(e)}")

При обработке сообщений пользователей агент вызывается путем добавления сообщения пользователя в беседу и вызова responses.create() со ссылкой на агент:

# Add user message to the conversation
self.openai_client.conversations.items.create(
    conversation_id=self.conversation_id,
    items=[{"type": "message", "role": "user", "content": message}],
)

# Create response using the agent
response = self.openai_client.responses.create(
    conversation=self.conversation_id,
    extra_body={"agent": {"name": self.agent.name, "type": "agent_reference"}},
    input="",
)

1. На портале Foundry убедитесь, что верхний переключатель New Foundry установлен в положение "активный", и затем создайте проект.

2. Разверните модель выбранного варианта (см. краткое руководство по Microsoft Foundry: создание ресурсов).

3. В верхней части игровой площадки модели скопируйте имя модели.

4. Самый простой способ получить конечную точку Azure OpenAI по-прежнему с классического портала. Нажмите переключатель New Foundry, затем выберите Azure OpenAI, а потом скопируйте URL-адрес в Azure OpenAI endpoint на будущее.

   

1. На портале Foundry убедитесь, что верхний переключатель New Foundry установлен в положение "активный", и затем создайте проект.

2. На домашней странице скопируйте конечную точку проекта для последующего использования.

3. Нажмите кнопку "Начать создание> и следуйте запросу.

4. На игровой площадке нового агента создайте средство OpenAPI для вызова вашего веб-приложения, выбрав Инструменты>Добавить>Пользовательское>Средство OpenAPI>Создать. В области установки добавьте действие с помощью средства спецификации OpenAPI. Используйте схему OpenAPI, полученную из развернутого веб-приложения и анонимной проверки подлинности. Подробные инструкции см. в разделе "Использование средства спецификации OpenAPI".

   Код вашего приложения уже настроен на включение url и operationId сервера, необходимых агенту. Дополнительные сведения см. в разделе "Подключение к спецификации OpenAPI".

5. Не забудьте нажать кнопку "Сохранить".

6. Выберите "Попробовать на игровой площадке" и протестируйте агент Foundry с помощью запросов, таких как "Показать мне все задачи" и "Добавьте задачу".

   Если вы получаете корректный ответ, значит агент выполняет вызовы инструментов к конечной точке OpenAPI вашего развернутого веб-приложения.

1. В верхнем меню нового портала Foundry выберите "Работа", а затем выберите "Администратор". В строке проекта Foundry вы увидите две ссылки. Один из столбцов Name — ресурс проекта Foundry, а в столбце "Родительский ресурс" — ресурс Foundry.

   

2. Выберите ресурс Foundry в родительском ресурсе и выберите "Управление этим ресурсом" на портале Azure. На портале Azure можно назначить доступ на основе ролей к ресурсу, относящемуся к развернутому веб-приложению.

3. Добавьте следующую роль для управляемой учетной записи служебного приложения App Service:

   Целевой ресурс	Требуемая роль	Требуется для
   Литейный завод	Пользователь когнитивных сервисов OpenAI	Служба завершения чата в Microsoft Agent Framework.

   Инструкции см. в статье "Назначение ролей Azure" с помощью портала Azure.

1. В верхнем меню нового портала Foundry выберите "Работа", а затем выберите "Администратор". В строке проекта Foundry вы увидите две ссылки. Один из столбцов Name — ресурс проекта Foundry, а в столбце "Родительский ресурс" — ресурс Foundry.

   

2. Выберите ресурс проекта Foundry в столбце "Имя" , а затем выберите "Управление этим ресурсом" на портале Azure. На портале Azure можно назначить доступ на основе ролей к ресурсу, относящемуся к развернутому веб-приложению.

3. Добавьте следующую роль для управляемой учетной записи служебного приложения App Service:

   Целевой ресурс	Требуемая роль	Требуется для
   Проект Foundry	Пользователь Foundry	Чтение и вызов агента Foundry.

   Инструкции см. в статье "Назначение ролей Azure" с помощью портала Azure.