[DO NOT MERGE] feat(examples): add rest examples from docs

[aleskalfas]

#2008

[gemini-code-assist]

Summary of Changes

Hello @aleskalfas, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly expands the project's example suite by converting existing documentation-based agent descriptions into runnable code examples. This provides developers with practical, testable implementations for agents with detailed configurations and file processing capabilities, enhancing the clarity and usability of the agent development process.

Highlights

• New Agent Examples: Introduced two new agent examples: one demonstrating basic agent configuration (name, skills, tools, author info) and another showcasing file processing capabilities, allowing agents to accept, modify, and return files.
• Documentation Updates: Updated the agent-details.mdx and files.mdx documentation to embed the newly created agent examples, providing clearer and more practical demonstrations.
• Testing Infrastructure Enhancements: Added new end-to-end tests for both the basic configuration and file processing examples, ensuring their correct functionality. The conftest.py was also updated to support these new examples by including agent card information in the running example context.
• Development Environment Configuration: Added new debug configurations to launch.json for VS Code, facilitating easier development and debugging of the new agent examples.
• Dependency Management: New pyproject.toml and uv.lock files were added for the new examples, and existing uv.lock files were updated to reflect the latest agentstack-sdk version.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog

• apps/agentstack-server/tests/e2e/examples/agent-integration/agent-details/test_basic_configuration.py
  • Added new E2E test for the basic agent configuration example.
• apps/agentstack-server/tests/e2e/examples/agent-integration/files/test_example_of_file_processing.py
  • Added new E2E test for the file processing example.
• apps/agentstack-server/tests/e2e/examples/conftest.py
  • Modified RunningExample to include agent_card.
  • Updated run_example to pass the agent card to the running example context.
• docs/development/agent-integration/agent-details.mdx
  • Updated to embed the new basic configuration agent example.
  • Adjusted code formatting within the embedded example.
• docs/development/agent-integration/files.mdx
  • Updated to embed the new file processing agent example.
  • Adjusted code formatting within the embedded example.
• examples/.vscode/launch.json
  • Added new debug configurations for 'example-of-file-processing' and 'basic-configuration' examples.
• examples/agent-integration/agent-details/basic-configuration/pyproject.toml
  • Added new project configuration for the basic configuration example.
• examples/agent-integration/agent-details/basic-configuration/src/basic_configuration/init.py
  • Added new __init__.py for the basic configuration example.
• examples/agent-integration/agent-details/basic-configuration/src/basic_configuration/agent.py
  • Added the source code for the basic configuration agent example.
• examples/agent-integration/agent-details/basic-configuration/uv.lock
  • Added dependency lock file for the basic configuration example.
• examples/agent-integration/files/example-of-file-processing/pyproject.toml
  • Added new project configuration for the file processing example.
• examples/agent-integration/files/example-of-file-processing/src/example_of_file_processing/init.py
  • Added new __init__.py for the file processing example.
• examples/agent-integration/files/example-of-file-processing/src/example_of_file_processing/agent.py
  • Added the source code for the file processing agent example.
• examples/agent-integration/files/example-of-file-processing/uv.lock
  • Added dependency lock file for the file processing example.
• examples/agent-integration/forms/initial-form-rendering/uv.lock
  • Updated agentstack-sdk version from 0.6.1 to 0.6.2.
• examples/agent-integration/multi-turn/advanced-history/uv.lock
  • Updated agentstack-sdk version from 0.6.1 to 0.6.2.

Activity

• The pull request was created by aleskalfas with the title '2008 convert the rest of the agents from the docs into examples'.
• The description '/summary' indicates a request for an automated summary.
• New example files, tests, and documentation updates were added to fulfill the PR's objective.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request is a great step towards improving the project's examples by converting two of them from documentation snippets into standalone, runnable, and tested applications. This ensures that the examples provided to users are always functional and up-to-date. The changes are well-structured, including new e2e tests, project configurations, and updates to the documentation to embed the new example code. I've included a couple of suggestions in the new test files to enhance code clarity and maintainability.