microsoft / microsoft/agent-framework-durable-extension

Docs: hosting-only Azure Functions apps get no agent routes without an orchestration trigger

Open Beginner friendly
#75 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
16
Forks
10
Avg merge
3d 9h
Merged PRs (30d)
9

Description

In a .NET isolated Azure Functions app that hosts agents only through ConfigureDurableAgents(...) and defines no Durable orchestrator of its own, the built-in agent routes (/api/agents/{agentName}/run) never appear at startup.

The reason: the worker SDK indexes the Durable extension from triggers discovered in the app assembly, and with no [OrchestrationTrigger] in the app there is nothing to index, so the hosting package's routes are never registered. The current READMEs (hosting package and the Azure Functions sample) do not mention this, so a hosting-only app fails silently with an empty route table.

I have a small docs patch ready that adds a short note plus a minimal placeholder trigger to both READMEs: https://github.com/he-yufeng/agent-framework-durable-extension/tree/docs/azurefunctions-trigger-discovery

Happy to open it as a PR once external PRs are enabled for this repo, or feel free to take the text over directly if that is easier.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the hosting package README and the Azure Functions sample README mentioned in the issue, then review the described trigger-discovery behavior. Add the short note and minimal placeholder trigger to both READMEs; done means hosting-only apps have documented guidance for getting the built-in agent routes registered.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.