mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
Peter Ibekwe
f25e81701d
* Add Python parity for HttpRequestAction in declarative workflow * Ran pyupgrade and pright to fix CI issues * Fix conversation ID dot parsing for http executor * Removed unnecessary export command * Initial implementation of invoke mcp tool in python * Update sample to support require approval to be toggled by environment variable. * Fix cache and PR comments * Update python/samples/03-workflows/declarative/invoke_mcp_tool/main.py Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com> --------- Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>
41 lines
1.6 KiB
Markdown
41 lines
1.6 KiB
Markdown
# Declarative Package (agent-framework-declarative)
|
|
|
|
YAML/JSON-based declarative agent and workflow definitions.
|
|
|
|
## Main Classes
|
|
|
|
- **`AgentFactory`** - Creates agents from declarative definitions
|
|
- **`WorkflowFactory`** - Creates workflows from declarative definitions
|
|
- **`WorkflowState`** - State management for declarative workflows
|
|
- **`ProviderTypeMapping`** - Maps provider types to implementations
|
|
- **`HttpRequestHandler`** / **`DefaultHttpRequestHandler`** - Pluggable HTTP transport for the `HttpRequestAction` declarative action (configured via `WorkflowFactory(http_request_handler=...)`)
|
|
- **`MCPToolHandler`** / **`DefaultMCPToolHandler`** - Pluggable MCP transport for the `InvokeMcpTool` declarative action (configured via `WorkflowFactory(mcp_tool_handler=...)`)
|
|
- **`DeclarativeLoaderError`** / **`ProviderLookupError`** / **`DeclarativeWorkflowError`** / **`DeclarativeActionError`** - Error types
|
|
|
|
## External Input Handling
|
|
|
|
- **`ExternalInputRequest`** / **`ExternalInputResponse`** - Human-in-the-loop support
|
|
- **`AgentExternalInputRequest`** / **`AgentExternalInputResponse`** - Agent-level input requests
|
|
|
|
## Usage
|
|
|
|
```python
|
|
from agent_framework.declarative import AgentFactory, WorkflowFactory
|
|
|
|
# Create agent from YAML file
|
|
agent_factory = AgentFactory()
|
|
agent = agent_factory.create_agent_from_yaml_path("agent.yaml")
|
|
|
|
# Create workflow from YAML file
|
|
workflow_factory = WorkflowFactory()
|
|
workflow = workflow_factory.create_workflow_from_yaml_path("workflow.yaml")
|
|
```
|
|
|
|
## Import Path
|
|
|
|
```python
|
|
from agent_framework.declarative import AgentFactory, WorkflowFactory
|
|
# or directly:
|
|
from agent_framework_declarative import AgentFactory
|
|
```
|