[Docs Agent] Docs Agent release version 0.4.0

- **Multi-modal support:** The Docs Agent CLI supports image, audio,
  and video files as part of a prompt to the Gemini model.
- **Formatted output:** Select the format of Docs Agent CLI's responses
  with the `--response_type json` and `--plaintext` options.
- **Autocomplete script:** The `autocomplete.sh` script is added to
  include Docs Agent CLI commands and options, making it easier and
  faster to use the Docs Agent CLI on a terminal.

Author: kyolee415

examples/gemini/python/docs-agent/docs_agent/models/palm.py

@@ -0,0 +1,99 @@
+_script()
+{
+  local cur preset_list
+
+  preset_list="
+  agent
+  --help
+  backup-chroma
+  benchmark
+  chatbot
+  --hostname
+  --port
+  --debug
+  --app_mode
+  web
+  full
+  widget
+  widget-pro
+  experimental
+  --enable_show_logs
+  --enable_logs_to_markdown
+  --config_file
+  --product
+  chunk
+  cleanup-dev
+  delete-corpus
+  get-all-docs
+  helpme
+  --new
+  --cont
+  --file
+  --allfiles
+  --perfile
+  --response_type
+  json
+  x.enum
+  text
+  list-corpora
+  open-corpus
+  populate
+  posix
+  remove-corpus-permission
+  runtask
+  share-corpus
+  --name
+  --email
+  --role
+  --config_file
+  show-config
+  show-session
+  tellme
+  write-logs-to-csv
+  runtask
+  --task
+  --model
+  --custom_input
+  --plaintext
+  --force
+  --task_config
+  CheckCommitForDocUpdate
+  ExtractWorkflows
+  GenerateDocSet
+  DevSiteYAMLGenerator
+  HelpPolishPrompts
+  DraftReleaseNotes
+  ExamineChangesBetweenTwoCommits
+  ReviseContentStructure
+  IndexPageGenerator
+  DraftFuchsiaReleaseNotes
+  DraftPSA
+  PreparePodcasteFromDir
+  DescribeImages
+  DescribeImagesWithoutMarkdown
+  models/gemini-1.5-flash
+  models/gemini-1.5-flash-latest
+  models/gemini-1.5-flash-001
+  models/gemini-1.5-flash-002
+  models/gemini-1.5-flash-8b
+  models/gemini-1.5-flash-8b-latest
+  models/gemini-1.5-flash-8b-001
+  models/gemini-1.5-pro
+  models/gemini-1.5-pro-latest
+  models/gemini-1.5-pro-001
+  models/gemini-1.5-pro-002
+  models/gemini-1.5-pro-exp-0827
+  models/gemini-1.0-pro
+  models/gemini-1.0-pro-latest
+  models/gemini-1.0-pro-001
+  models/aqa
+  "
+
+  COMPREPLY=()
+  cur="${COMP_WORDS[COMP_CWORD]}"
+  COMPREPLY=( $(compgen -W "${preset_list}" -- ${cur}) )
+
+  return 0
+}
+complete -o filenames -o nospace -o default -F _script agent
+

examples/gemini/python/docs-agent/scripts/autocomplete.sh

@@ -0,0 +1,22 @@
+tasks:
+  - name: "DescribeImagesWithoutMarkdown"
+    model: "models/gemini-1.5-flash"
+    description: "An agent that describes each image in the input directory to help write alt text."
+    preamble: "When describing an image, keep it short and concise, and focus on the essence of the image."
+    steps:
+      - prompt: "Provide a concise, descriptive alt text for this JPEG image that captures its essence and is suitable for users with visual impairments."
+        flags:
+          perfile: "<INPUT>"
+          default_input: "./docs"
+          file_ext: "jpg"
+      - prompt: "Provide a concise, descriptive alt text for this PNG image that captures its essence and is suitable for users with visual impairments."
+        flags:
+          perfile: "<INPUT>"
+          default_input: "./docs"
+          file_ext: "png"
+      - prompt: "Provide a concise, descriptive alt text for this GIF image that captures its essence and is suitable for users with visual impairments."
+        flags:
+          perfile: "<INPUT>"
+          default_input: "./docs"
+          file_ext: "gif"
+

examples/gemini/python/docs-agent/tasks/describe-images-alt-text-no-markdown.yaml

@@ -0,0 +1,27 @@
+tasks:
+  - name: "DescribeImages"
+    model: "models/gemini-1.5-flash"
+    description: "An agent that describes each image in the input directory to help write alt text."
+    preamble: "When describing an image, limit the description to 80 or less characters."
+    steps:
+      - prompt: "Provide a brief description of each Markdown file in this directory, emphasizing the key content and purpose of each file."
+        flags:
+          allfiles: "<INPUT>"
+          default_input: "./docs"
+          file_ext: "md"
+      - prompt: "Using the Markdown descriptions as context, provide a concise, descriptive alt text for this JPEG image that captures its essence and is suitable for users with visual impairments."
+        flags:
+          perfile: "<INPUT>"
+          default_input: "./docs"
+          file_ext: "jpg"
+      - prompt: "Using the Markdown descriptions as context, provide a concise, descriptive alt text for this PNG image that captures its essence and is suitable for users with visual impairments."
+        flags:
+          perfile: "<INPUT>"
+          default_input: "./docs"
+          file_ext: "png"
+      - prompt: "Using the Markdown descriptions as context, provide a concise, descriptive alt text for this GIF image that captures its essence and is suitable for users with visual impairments."
+        flags:
+          perfile: "<INPUT>"
+          default_input: "./docs"
+          file_ext: "gif"
+

examples/gemini/python/docs-agent/tasks/describe-images-for-alt-text-task.yaml

@@ -0,0 +1,19 @@
+tasks:
+  - name: "PreparePodcasteFromDir"
+    model: "models/gemini-1.5-pro-latest"
+    description: "An agent that helps prepare a podcast from a directory of markdown files."
+    preamble: "When writing a prompt, always be direct and concise."
+    steps:
+      - prompt: "Read these documentation files and create a markdown document
+          that highlights the parts that are to the most interesting to talk
+          about in a podcast. Make sure to also include
+          interesting topics to talk about. Most listeners will be software
+          engineers, so make sure to highlight technical topics. Also make sure
+          the conversation flows well and is centered around using tooling
+          when possible. You should list at least 5 high level topics to talk about.
+          At the top of the file include the text: \"Use this script to organize
+          the podcast show that you are about to record.\""
+        flags:
+          allfiles: "<INPUT>"
+          default_input: "~/docs/"
+          file_ext: "md"

examples/gemini/python/docs-agent/tasks/prepare-podcast-from-dir.yaml

@@ -0,0 +1,15 @@
+tasks:
+  - name: "ReviseContentStructure"
+    model: "models/gemini-1.5-flash"
+    description: "An agent that helps revise content structure in a doc for better flow and readability."
+    preamble: "You're an editor specializing in revising technical documents. When generating a Markdown file, limit the number of characters per line to 80 or less, and keep the unchanged content in tact."
+    steps:
+      - prompt: "Summarize the key information and purpose of the content in the provided file."
+        flags:
+          file: "<INPUT>"
+          default_input: "./README.md"
+      - prompt: "Identify the key topics and subjects discussed in the provided file. Present your findings as a numbered list of bullet points, ensuring clarity and conciseness."
+      - prompt: "Based on the extracted key topics and subjects, propose a logical and engaging narrative structure for the provided file. Consider the natural flow of information and prioritize clarity and readability. Present your proposal as a numbered list."
+      - prompt: "Review the section titles in the provided file and suggest any updates for overall clarity and consistency. Present your suggestions as a numbered list with the original title, followed by your proposed title."
+      - prompt: "Rewrite the provided file, incorporating the proposed narrative structure and making necessary adjustments to improve the flow and readability of the document."
+