Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Source & Deploy In Amodal

Use Amodal to create an agent, deploy its source, and inspect the result. For a repository you can build yourself, follow the support-agent tutorial.

1. Choose The Source

Select your organization and create an agent. Choose one of these paths:

  • Template: select a template and name the agent. Amodal stores its source and opens Deploys.
  • Git repository: choose Connect a git repository instead, select the repository, and name the agent. GitHub uses the Amodal GitHub App. GitLab is available when enabled for the platform.

For GitHub, the App installation determines which repositories appear. If yours is missing, use Configure GitHub App permissions to grant access.

Template source can be exported to an empty GitHub repository from Settings > Source. You can also keep editing it in Amodal.

2. Configure The Agent

Before deploying, check:

  • Models: choose the model. The hosted default is Gemini 3.5 Flash.
  • Organization settings: configure provider credentials and allowed models when needed.
  • Secrets: set connection credentials and other values referenced with env:NAME.
  • Auth, embed, and domains: configure app access and embedding.
  • Runtime and deploy settings: review runtime resources, source settings, and automatic deployment behavior.

The model choice and secret values are platform settings. Keep secret references in source; keep the values in Amodal.

3. Deploy And Select Production

Open Deploys, select the source version, and deploy it. Wait for the build to finish, then check the deploy's runtime status and URL.

Source versions and deployments have separate histories. One source version can have several deployments. With manual production promotion, the default setting, a completed production build stays inactive. Automatic deployment can start a build without making it production.

Open the deploy URL to test that version, then use Make production and check the production indicator. The persistent agent URL serves the active production deployment. See Deployment API for API activation, promotion, and rollback.

4. Chat And Inspect

Ask a question that exercises one of the agent's connections or tools. In the support tutorial, use:

Triage ticket 1. What should the support operator do next?

Inspect the messages and tool calls in Sessions, and the model, token usage, and timing in Traces. Check Logs for runtime errors. Before the first deployment, runtime pages may have no data.

For a slow or failed turn, inspect the model call and tool-call timing to locate the delay.

5. Edit, Test, And Redeploy

Edit the source files and review the diff before committing. For a connected Git repository, publish the changes to the branch you intend to deploy. For Amodal-hosted source, save a source version in Amodal.

Deploy the changed source, run the agent's evals, and test the deploy URL. Select production after checking the result. Automatic deployment and production activation depend on the agent's deploy settings.

Next Steps