circular readme

Author: ianmacartney

README.md

@@ -341,4 +341,30 @@ Read more in [this Stack post](https://stack.convex.dev/ai-agents).
 npm i @convex-dev/agent
 ```
 
+## Troubleshooting
+
+### Circular dependencies
+
+Having the return value of workflows depend on other Convex functions can lead to circular dependencies due to the
+`internal.foo.bar` way of specifying functions. The way to fix this is to explicitly type the return value of the
+workflow. When in doubt, add return types to more `handler` functions, like this:
+
+```ts
+ export const supportAgentWorkflow = workflow.define({
+   args: { prompt: v.string(), userId: v.string(), threadId: v.string() },
++  handler: async (step, { prompt, userId, threadId }): Promise<string> => {
+     // ...
+   },
+ });
+
+ // And regular functions too:
+ export const myFunction = action({
+   args: { prompt: v.string() },
++  handler: async (ctx, { prompt }): Promise<string> => {
+     // ...
+   },
+ });
+```
+
+
 <!-- END: Include on https://convex.dev/components -->